18 Valori restituiti per net.if.get

Panoramica

Questa sezione fornisce i dettagli sui valori restituiti per l'item net.if.get. L'item è supportato su Linux da Zabbix agent e Zabbix agent 2.

Dettagli

Questo item restituisce informazioni dettagliate sulle interfacce di rete i cui nomi corrispondono alla data espressione regolare. L'output è strutturato come un oggetto JSON contenente gli array config e values.

L'output contiene le seguenti proprietà:

  • name - nome dell'interfaccia, letto da /proc/net/dev;
  • ifalias - alias dell'interfaccia, letto da /sys/class/net/<name>/ifalias;
  • mac - indirizzo MAC dell'interfaccia, letto da /sys/class/net/<name>/address;
  • type - tipo di interfaccia (physical, virtual, loopback);
  • speed - velocità del collegamento in Mbit/sec, specifica per Ethernet, letta da /sys/class/net/<name>/speed;
  • duplex - valore duplex più recente o corrente dell'interfaccia (half, full), specifico per Ethernet, letto da /sys/class/net/<name>/duplex;
  • administrative_state - stato configurato (down, up), letto da /sys/class/net/<name>/flags;
  • operational_state - stato operativo RFC2863 dell'interfaccia (unknown, notpresent, down, lowerlayerdown, testing, dormant, up), letto da sys/class/net/<name>/operstate;
  • carrier - presenza del collegamento fisico (0 - il collegamento fisico è inattivo, 1 - il collegamento fisico è attivo), letto da /sys/class/net/<name>/carrier;
  • carrier_changes - numero totale di volte in cui lo stato del collegamento è passato da attivo a inattivo e viceversa, letto da /sys/class/net/<name>/carrier_changes;
  • carrier_up_count - numero di volte in cui il collegamento è diventato attivo, letto da /sys/class/net/<name>/carrier_up_count;
  • carrier_down_count - numero di volte in cui il collegamento è diventato inattivo, letto da /sys/class/net/<name>/carrier_down_count;
  • in - traffico in ingresso, letto da /proc/net/dev. Contiene i contatori dell'interfaccia:
    • bytes - numero di byte validi;
    • packets - numero di pacchetti validi;
    • errors - numero totale di pacchetti non validi;
    • dropped - numero di pacchetti ricevuti ma non elaborati + conteggio dei pacchetti persi dal host;
    • overruns - numero di eventi di overflow;
    • frame - numero di pacchetti con errori di framing;
    • compressed - numero di pacchetti compressi ricevuti correttamente;
    • multicast - pacchetti multicast ricevuti.
  • out - traffico in uscita, letto da /proc/net/dev. Contiene i contatori dell'interfaccia:
    • bytes - numero di byte validi;
    • packets - numero di pacchetti validi;
    • errors - numero totale di pacchetti non validi;
    • dropped - numero di pacchetti ricevuti ma non elaborati + conteggio dei pacchetti persi dal host;
    • overruns - numero di eventi di overflow;
    • collisions - numero di collisioni durante la trasmissione dei pacchetti;
    • carrier - numero di errori di trasmissione dei frame dovuti alla perdita del carrier durante la trasmissione;
    • compressed - numero di pacchetti compressi trasmessi.

Le metriche non disponibili sono escluse dall'output JSON. Nell'esempio seguente, non è configurato alcun alias per l'interfaccia "lo", quindi la proprietà ifalias è esclusa.

Esempio:

{
    "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
            }
        }
    ]
}

Vedi anche

Per ulteriori informazioni sull'ABI sysfs per i dispositivi di rete, vedere: