Valeurs de retour pour net.if.get
Vue d'ensemble
Cette section fournit des détails sur les valeurs de retour pour l'élément net.if.get.
L'élément est pris en charge sous Linux par Zabbix agent et Zabbix agent 2.
Détails
Cet élément renvoie des informations détaillées sur les interfaces réseau dont les noms correspondent à l'expression régulière donnée.
La sortie est structurée comme un objet JSON contenant les tableaux config et values.
La sortie contient les propriétés suivantes :
- name - nom de l'interface, lu depuis
/proc/net/dev; - ifalias - alias de l'interface, lu depuis
/sys/class/net/<name>/ifalias; - mac - adresse MAC de l'interface, lue depuis
/sys/class/net/<name>/address; - type - type d'interface (
physical,virtual,loopback) ; - speed - vitesse du lien en Mbits/sec, spécifique à Ethernet, lue depuis
/sys/class/net/<name>/speed; - duplex - dernière valeur duplex ou valeur duplex actuelle de l'interface (
half,full), spécifique à Ethernet, lue depuis/sys/class/net/<name>/duplex; - administrative_state - état configuré (
down,up), lu depuis/sys/class/net/<name>/flags; - operational_state - état opérationnel RFC2863 de l'interface (
unknown,notpresent,down,lowerlayerdown,testing,dormant,up), lu depuissys/class/net/<name>/operstate; - carrier - présence du lien physique (
0- le lien physique est désactivé,1- le lien physique est activé), lue depuis/sys/class/net/<name>/carrier; - carrier_changes - nombre total de changements d'état du lien de up à down et inversement, lu depuis
/sys/class/net/<name>/carrier_changes; - carrier_up_count - nombre de fois où le lien est devenu up, lu depuis
/sys/class/net/<name>/carrier_up_count; - carrier_down_count - nombre de fois où le lien est devenu down, lu depuis
/sys/class/net/<name>/carrier_down_count; - in - trafic entrant, lu depuis
/proc/net/dev. Contient les compteurs de l'interface :- bytes - nombre d'octets valides ;
- packets - nombre de paquets valides ;
- errors - nombre total de paquets erronés ;
- dropped - nombre de paquets reçus mais non traités + nombre de paquets manqués par l'hôte ;
- overruns - nombre d'événements de dépassement ;
- frame - nombre de paquets avec erreurs de trame ;
- compressed - nombre de paquets compressés correctement reçus ;
- multicast - paquets multicast reçus.
- out - trafic sortant, lu depuis
/proc/net/dev. Contient les compteurs de l'interface :- bytes - nombre d'octets valides ;
- packets - nombre de paquets valides ;
- errors - nombre total de paquets erronés ;
- dropped - nombre de paquets reçus mais non traités + nombre de paquets manqués par l'hôte ;
- overruns - nombre d'événements de dépassement ;
- collisions - nombre de collisions pendant les transmissions de paquets ;
- carrier - nombre d'erreurs de transmission de trame dues à une perte de porteuse pendant la transmission ;
- compressed - nombre de paquets compressés transmis.
Les métriques non disponibles sont exclues de la sortie JSON.
Dans l'exemple suivant, aucun alias n'est configuré pour l'interface "lo", la propriété ifalias est donc exclue.
Exemple :
{
"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
}
}
]
}Voir aussi
Pour plus d'informations sur l'ABI sysfs pour les périphériques réseau, voir :