Nesta página
Valores de retorno para net.if.get
Visão geral
Esta seção fornece detalhes sobre os valores de retorno do item net.if.get.
O item é suportado no Linux pelo Zabbix agent e pelo Zabbix agent 2.
Detalhes
Este item retorna informações detalhadas sobre interfaces de rede cujos nomes correspondem à expressão regular fornecida.
A saída é estruturada como um objeto JSON contendo arrays config e values.
A saída contém as seguintes propriedades:
- name - nome da interface, lido de
/proc/net/dev; - ifalias - alias da interface, lido de
/sys/class/net/<name>/ifalias; - mac - endereço MAC da interface, lido de
/sys/class/net/<name>/address; - type - tipo da interface (
physical,virtual,loopback); - speed - velocidade do link em Mbits/s, específica de Ethernet, lida de
/sys/class/net/<name>/speed; - duplex - valor de duplex mais recente ou atual da interface (
half,full), específico de Ethernet, lido de/sys/class/net/<name>/duplex; - administrative_state - estado configurado (
down,up), lido de/sys/class/net/<name>/flags; - operational_state - estado operacional RFC2863 da interface (
unknown,notpresent,down,lowerlayerdown,testing,dormant,up), lido desys/class/net/<name>/operstate; - carrier - presença de link físico (
0- o link físico está down,1- o link físico está up), lido de/sys/class/net/<name>/carrier; - carrier_changes - número total de vezes que o estado do link mudou de up para down e vice-versa, lido de
/sys/class/net/<name>/carrier_changes; - carrier_up_count - número de vezes que o link ficou up, lido de
/sys/class/net/<name>/carrier_up_count; - carrier_down_count - número de vezes que o link ficou down, lido de
/sys/class/net/<name>/carrier_down_count; - in - tráfego de entrada, lido de
/proc/net/dev. Contém contadores da interface:- bytes - número de bytes válidos;
- packets - número de pacotes válidos;
- errors - número total de pacotes inválidos;
- dropped - número de pacotes recebidos, mas não processados + contagem de pacotes perdidos pelo host;
- overruns - número de eventos de overflow;
- frame - número de pacotes com erros de enquadramento;
- compressed - número de pacotes compactados recebidos corretamente;
- multicast - pacotes multicast recebidos.
- out - tráfego de saída, lido de
/proc/net/dev. Contém contadores da interface:- bytes - número de bytes válidos;
- packets - número de pacotes válidos;
- errors - número total de pacotes inválidos;
- dropped - número de pacotes recebidos, mas não processados + contagem de pacotes perdidos pelo host;
- overruns - número de eventos de overflow;
- collisions - número de colisões durante transmissões de pacotes;
- carrier - número de erros de transmissão de quadros devido à perda de carrier durante a transmissão;
- compressed - número de pacotes compactados transmitidos.
Métricas indisponíveis são excluídas da saída JSON.
No exemplo a seguir, nenhum alias está configurado para a interface "lo", portanto a propriedade ifalias é excluída.
Exemplo:
{
"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
}
}
]
}Veja também
Para mais informações sobre a ABI sysfs para dispositivos de rede, consulte: