On this page
18 net.if.get 的返回值
概述
本节提供 net.if.get 监控项的返回值详细信息。
该监控项在 Linux 上受 Zabbix agent 和 Zabbix agent 2 支持。
详细信息
此监控项返回名称与给定正则表达式匹配的网络接口的详细信息。
输出采用 JSON 对象结构，包含 config 和 values 数组。
输出包含以下属性：
- name - 接口名称，从
/proc/net/dev读取； - ifalias - 接口别名，从
/sys/class/net/<name>/ifalias读取； - mac - 接口 MAC 地址，从
/sys/class/net/<name>/address读取； - type - 接口类型（
physical、virtual、loopback）； - speed - 链路速度，单位为 Mbits/sec，仅适用于以太网，从
/sys/class/net/<name>/speed读取； - duplex - 接口最近或当前的双工值（
half、full），仅适用于以太网，从/sys/class/net/<name>/duplex读取； - administrative_state - 配置状态（
down、up），从/sys/class/net/<name>/flags读取； - operational_state - 接口 RFC2863 运行状态（
unknown、notpresent、down、lowerlayerdown、testing、dormant、up），从sys/class/net/<name>/operstate读取； - carrier - 物理链路是否存在（
0- 物理链路关闭，1- 物理链路开启），从/sys/class/net/<name>/carrier读取； - carrier_changes - 链路状态从 up 变为 down 以及从 down 变为 up 的总次数，从
/sys/class/net/<name>/carrier_changes读取； - carrier_up_count - 链路变为 up 的次数，从
/sys/class/net/<name>/carrier_up_count读取； - carrier_down_count - 链路变为 down 的次数，从
/sys/class/net/<name>/carrier_down_count读取； - in - 入站流量，从
/proc/net/dev读取。包含接口计数器：- bytes - 正常字节数；
- packets - 正常数据包数；
- errors - 错误数据包总数；
- dropped - 已接收但未处理的数据包数 + 主机遗漏的数据包数；
- overruns - 溢出事件数；
- frame - 帧错误数据包数；
- compressed - 正确接收的压缩数据包数；
- multicast - 已接收的多播数据包数。
- out - 出站流量，从
/proc/net/dev读取。包含接口计数器：- bytes - 正常字节数；
- packets - 正常数据包数；
- errors - 错误数据包总数；
- dropped - 已接收但未处理的数据包数 + 主机遗漏的数据包数；
- overruns - 溢出事件数；
- collisions - 数据包传输期间的冲突次数；
- carrier - 由于传输期间载波丢失而导致的帧传输错误次数；
- compressed - 已发送的压缩数据包数。
不可用的指标不会包含在 JSON 输出中。
在以下示例中，"lo" 接口未配置别名，因此不包含 ifalias 属性。
示例：
{
"config": [
{
"name": "lo",
"mac": "00:00:00:00:00:00",
"type": "loopback",
"administrative_state": "up",
"operational_state": "unknown",
"carrier": 1
},
{
"name": "enp3s0",
"ifalias": "Wired Ethernet connection",
"mac": "8c:16:45:e3:1d:58",
"type": "physical",
"duplex": "unknown",
"administrative_state": "up",
"operational_state": "down",
"carrier": 0
},
{
"name": "wlp5s0",
"ifalias": "Wi-Fi network adapter",
"mac": "34:e1:2d:72:67:c6",
"type": "physical",
"administrative_state": "up",
"operational_state": "up",
"carrier": 1
}
],
"values": [
{
"name": "lo",
"mac": "00:00:00:00:00:00",
"carrier": 1,
"carrier_changes": 0,
"carrier_up_count": 0,
"carrier_down_count": 0,
"in": {
"bytes": 1040047,
"packets": 10784,
"errors": 0,
"dropped": 0,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 1040047,
"packets": 10784,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
},
{
"name": "enp3s0",
"ifalias": "Wired Ethernet connection",
"mac": "8c:16:45:e3:1d:58",
"carrier": 0,
"carrier_changes": 1,
"carrier_up_count": 0,
"carrier_down_count": 1,
"in": {
"bytes": 0,
"packets": 0,
"errors": 0,
"dropped": 0,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 0,
"packets": 0,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
},
{
"name": "wlp5s0",
"ifalias": "Wi-Fi network adapter",
"mac": "34:e1:2d:72:67:c6",
"carrier": 1,
"carrier_changes": 6,
"carrier_up_count": 3,
"carrier_down_count": 3,
"in": {
"bytes": 165537298,
"packets": 216182,
"errors": 0,
"dropped": 291,
"overruns": 0,
"frame": 0,
"compressed": 0,
"multicast": 0
},
"out": {
"bytes": 252574347,
"packets": 246607,
"errors": 0,
"dropped": 0,
"overruns": 0,
"collisions": 0,
"carrier": 0,
"compressed": 0
}
}
]
}另请参阅
有关网络设备 sysfs ABI 的更多信息，请参见：