Network Interface Detail (PI_NIND)
- Organization of this page
Function
The Network Interface Detail (PI_NIND) record stores the performance data per unit time on a network interface. The available network interfaces include a loopback adapter, a local Token Ring adapter, and an Ethernet adapter, multiple network interfaces can be installed on a single machine. Each interface can have multiple IP addresses. Every time performance data is collected, a record is created for each network interface, but only the first IP address that is found is used. This is a multi-instance record.
- Notes:
-
-
The interface flags that are set in the Flags (FLAGS) field and that can be judged are listed below:
• In AIX
UP, BROADCAST, DEBUG, LOOPBACK, POINTOPOINT, NOTRAILERS, RUNNING, NOARP, PROMISC, ALLMULTI, OACTIVE, SIMPLEX, MULTICAST
• In HP-UX
UP, LOOPBACK
• In Solaris
UP, BROADCAST, DEBUG, LOOPBACK, POINTOPOINT, NOTRAILERS, RUNNING, NOARP, PROMISC, ALLMULTI, INTELLIGENT, MULTICAST, MULTI_BCAST, UNNUMBERED, PRIVATE
• In Linux
UP, BROADCAST, DEBUG, LOOPBACK, POINTOPOINT, NOTRAILERS, RUNNING, NOARP, PROMISC, ALLMULTI, MULTICAST, MASTER, SLAVE, PORTSEL, AUTOMEDIA, DYNAMIC
-
If the DR function of Solaris is used to modify a system resource while a PFM - Agent for Platform service is running, some types of performance data cannot be correctly collected. The table below shows the types of system resources that are affected and the actions that you can take to correctly display reports after the modification.
System resource type
Report type
Actions to be taken after modification
LAN board
Real-time
Display the report again.
Historical
Specify the display period such that it does not include the date and time when the system resources were modified.
Fields other than those listed below are affected by a system resource modification:
• Interval (INTERVAL)
• Record Time (RECORD_TIME)
• Record Type (INPUT_RECORD_TYPE)
• Fields that are added only when data is recorded in the Store database
For details about modifying system resources, see Notes on performance information when modifying system resources in Notes on records
-
In Linux, only performance data on the network interface for which either an IPv4 address or an IPv6 address has been set is collected.
-
This record cannot be used in Solaris shared-IP non-global zones, but can be used in exclusive-IP non-global zones. Note that no reports can be displayed in shared-IP non-global zones.
-
In PFM - Agent for Platform 09-00 or later, IPv6 is supported. The following table shows the fields whose values are affected in an environment that contains both IPv4 and IPv6.
PFM-View name
OS environment
Obtained IP information
IPv4 environment
IPv6 environment
Coexisting environment
Broadcast Address
All
IPv4
Blank
IPv4
Flags
HP-UX, AIX
--
--
--
Solaris, Linux
IPv4
IPv6
IPv4
IP Address
All
IPv4
Blank
IPv4
IP6 Address
All
Blank
IPv6
IPv6
Interface
All
IPv4
IPv6
IPv4
Interval
All
--
--
--
Max Transmission Unit
HP-UX, Solaris, Linux
IPv4
IPv6
IPv4
AIX
--
--
--
Network Mask
All
IPv4
Blank
IPv4
Network Name
All
IPv4
Blank
IPv4
Pkt Collisions
HP-UX
IPv4
0
IPv4
AIX, Solaris, Linux
IPv4
IPv6
Sum of the values for IPv4 and IPv6
Pkt Receive Errors
HP-UX
IPv4
0
IPv4
AIX, Solaris, Linux
IPv4
IPv6
Sum of the values for IPv4 and IPv6
Pkt Xmit Errors
HP-UX
IPv4
0
IPv4
AIX, Solaris, Linux
IPv4
IPv6
Sum of the values for IPv4 and IPv6
Pkts Rcvd
All
IPv4
IPv6
Sum of the values for IPv4 and IPv6
Pkts Rcvd/sec
All
IPv4/Interval
IPv6/Interval
(Sum of the values for IPv4 and IPv6)/Interval
Pkts Xmitd
All
IPv4
IPv6
Sum of the values for IPv4 and IPv6
Pkts Xmitd/sec
All
IPv4/Interval
IPv6/Interval
(Sum of the values for IPv4 and IPv6)/Interval
Record Time
All
--
--
--
Record Type
All
--
--
--
Total Pkt Errors
HP-UX
Sum of the values of Pkt Receive Errors, Pkt Xmit Errors, and Pkt Collisions in IPv4
0
Sum of the values of Pkt Receive Errors, Pkt Xmit Errors, and Pkt Collisions in IPv4
AIX, Solaris, Linux
Sum of the values of Pkt Receive Errors, Pkt Xmit Errors, and Pkt Collisions for IPv4
Sum of the values of Pkt Receive Errors, Pkt Xmit Errors, and Pkt Collisions for IPV6
Sum of the values of Pkt Receive Errors, Pkt Xmit Errors, and Pkt Collisions for IPV4 and IPV6
Total Pkts
All
Sum of the values of pkts received and Pkts Xmitd for IPv4
Sum of the values of pkts received and Pkts Xmitd for IPv6
Sum of the values of pkts received and Pkts Xmitd for IPv4 and IPv6
Total Xmit Receive Errors
HP-UX
Sum of the values of Pkt Receive Errors and Pkt Xmit Errors for IPv4
0
Sum of the values of Pkt Receive Errors and Pkt Xmit Errors for IPv4
AIX, Solaris, Linux
Sum of the values of Pkt Receive Errors and Pkt Xmit Errors for IPv4
Sum of the values of Pkt Receive Errors and Pkt Xmit Errors for IPv6
Sum of the values of Pkt Receive Errors and Pkt Xmit Errors for IPv4 and IPv6
Type
All
--
--
--
-
- Legend:
-
--: Information that is not affected by the IPv4 or IPv6 environment is collected.
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Collection Interval |
60 |
Yes |
Collection Offset# |
0 |
Yes |
Log |
No |
Yes |
LOGIF |
Blank |
Yes |
Over 10 Sec Collection Time |
No |
No |
Realtime Report Data Collection Mode |
Reschedule |
Yes |
- #
-
A value between 0 and 32,767 seconds can be specified (a value within the range specified for Collection Interval). Use this item to distribute the collection load, because executing data collection all at once results in concentration of the processing workload. Note that the data collection duration to be recorded is the same as the Collection Interval, regardless of the value specified for Collection Offset.
When changing the Collection Offset value, specify a value that takes into account the impact of the collection processing load.
ODBC key fields
-
PI_NIND_INTERFACE_NAME
-
PI_NIND_IP_ADDRESS
-
PI_NIND_IP6_ADDRESS
Lifetime
None
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 670 bytes
Fields
PFM-View name (PFM-Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd in |
Data source |
---|---|---|---|---|---|---|
Broadcast Address(BROADCAST_ADDRESS) |
The first broadcast address that was found. Displayed in the Internet address format. In HP-UX and Solaris, the broadcast address of a loopback instance is not displayed. |
COPY |
string(20) |
No |
-- |
-- |
Flags(FLAGS) |
Interface flag setting. If it is 80 bytes or longer, the last character becomes >. In HP-UX, all flags that indicate interface statuses are included in the value in this field (the ifconfig command displays only some of the flags). |
COPY |
string(80) |
No |
-- |
-- |
IP Address(IP_ADDRESS) |
IP address of IPv4. Displayed in the Internet address format. |
COPY |
string(20) |
No |
-- |
-- |
IP6 Address(IP6_ADDRESS) |
IP address of IPv6. Displayed in the Internet address format. |
COPY |
string(50) |
No |
-- |
-- |
Interface(INTERFACE_NAME) |
Interface name |
COPY |
string(40) |
No |
-- |
-- |
Interval(INTERVAL) |
Interval at which the Network Interface Detail (PI_NIND) record was stored (seconds) |
COPY |
ulong |
Yes |
-- |
• When delta values are not checked in real time, RECORD_TIME - Last-boot-time • Other cases, RECORD_TIME - previous-record-time |
Max Transmission Unit(MAX_TRANSMISSION_UNIT) |
Maximum packet size (bytes) |
COPY |
ulong |
No |
-- |
-- |
Network Mask(NETWORK_MASK) |
Subnet mask of the first IP address that was found. Displayed in the Internet address format. |
COPY |
string(20) |
No |
-- |
-- |
Network Name(NETWORK_NAME) |
Network name. A network name that is 1,028 bytes or longer cannot be handled. The network name is displayed up to the size defined in the data model. In AIX and HP-UX, if NIS is active and there is no entry in the NIS database for network addresses, the first IP address of the interface that is found is masked and the result is displayed. |
COPY |
string(256) |
No |
-- |
-- |
Pkt Collisions(PACKET_COLLISIONS) |
Number of packet collisions that occurred |
AVG |
ulong |
Yes |
-- |
-- |
Pkt Receive Errors(PACKET_RECEIVE_ERRORS) |
Number of packet receive errors |
AVG |
ulong |
Yes |
-- |
-- |
Pkt Xmit Errors(PACKET_TRANSMIT_ERRORS) |
Number of packet transmission errors |
AVG |
ulong |
Yes |
-- |
-- |
Pkts Rcvd(PACKETS_RECEIVED) |
Number of packets received |
AVG |
ulong |
Yes |
-- |
-- |
Pkts Rcvd/sec(PACKETS_RECEIVED_PER_SECOND) |
Frequency at which packets were received (number of packets per second) |
R |
float |
Yes |
-- |
PACKETS_RECEIVED ÷ INTERVAL |
Pkts Xmitd(PACKETS_TRANSMITTED) |
Number of packets transmitted |
AVG |
ulong |
Yes |
-- |
-- |
Pkts Xmitd/sec(PACKETS_TRANSMITTED_PER_SECOND) |
Frequency at which packets were transmitted (number of packets per second) |
R |
float |
Yes |
-- |
PACKETS_TRANSMITTED ÷ INTERVAL |
Record Time(RECORD_TIME) |
Time at which the record was created (Greenwich Mean Time) |
COPY |
time_t |
No |
-- |
-- |
Record Type(INPUT_RECORD_TYPE) |
Record type. Always NIND. |
COPY |
char(8) |
No |
-- |
-- |
Total Pkt Errors(TOTAL_PACKET_ERRORS) |
Number of packet transmission and receiving errors (including the number of packet collisions) |
AVG |
ulong |
Yes |
-- |
PACKET_TRANSMIT_ERRORS + PACKET_RECEIVE_ERRORS + PACKET_COLLISIONS |
Total Pkts(TOTAL_PACKETS) |
Number of packets transmitted and received |
AVG |
ulong |
Yes |
-- |
PACKETS_RECEIVED + PACKETS_TRANSMITTED |
Total Xmit Receive Errors(TOTAL_TRANS_RECEIVE_ERRORS) |
Number of packet transmission and receiving errors (excluding the number of packet collisions) |
AVG |
ulong |
Yes |
-- |
PACKET_TRANSMIT_ERRORS + PACKET_RECEIVE_ERRORS |
Type(INTERFACE_TYPE) |
Interface type |
COPY |
string(20) |
No |
-- |
-- |