18 Wartości zwracane dla net.if.get

Przegląd

Ta sekcja zawiera szczegóły dotyczące wartości zwracanej dla pozycji net.if.get. Ta pozycja jest obsługiwana w systemie Linux przez agent Zabbix oraz agent Zabbix 2.

Szczegóły

Ta pozycja zwraca szczegółowe informacje o interfejsach sieciowych, których nazwy pasują do podanego wyrażenia regularnego. Dane wyjściowe mają strukturę obiektu JSON zawierającego tablice config i values.

Dane wyjściowe zawierają następujące właściwości:

  • name - nazwa interfejsu, odczytywana z /proc/net/dev;
  • ifalias - alias interfejsu, odczytywany z /sys/class/net/<name>/ifalias;
  • mac - adres MAC interfejsu, odczytywany z /sys/class/net/<name>/address;
  • type - typ interfejsu (physical, virtual, loopback);
  • speed - prędkość łącza w Mbit/s, specyficzna dla Ethernet, odczytywana z /sys/class/net/<name>/speed;
  • duplex - ostatnia lub bieżąca wartość dupleksu interfejsu (half, full), specyficzna dla Ethernet, odczytywana z /sys/class/net/<name>/duplex;
  • administrative_state - skonfigurowany stan (down, up), odczytywany z /sys/class/net/<name>/flags;
  • operational_state - stan operacyjny interfejsu RFC2863 (unknown, notpresent, down, lowerlayerdown, testing, dormant, up), odczytywany z sys/class/net/<name>/operstate;
  • carrier - obecność fizycznego łącza (0 - fizyczne łącze jest wyłączone, 1 - fizyczne łącze jest włączone), odczytywana z /sys/class/net/<name>/carrier;
  • carrier_changes - całkowita liczba zmian stanu łącza z up na down i odwrotnie, odczytywana z /sys/class/net/<name>/carrier_changes;
  • carrier_up_count - liczba przypadków, gdy łącze przeszło do stanu up, odczytywana z /sys/class/net/<name>/carrier_up_count;
  • carrier_down_count - liczba przypadków, gdy łącze przeszło do stanu down, odczytywana z /sys/class/net/<name>/carrier_down_count;
  • in - ruch przychodzący, odczytywany z /proc/net/dev. Zawiera liczniki interfejsu:
    • bytes - liczba poprawnych bajtów;
    • packets - liczba poprawnych pakietów;
    • errors - całkowita liczba błędnych pakietów;
    • dropped - liczba odebranych, ale nieprzetworzonych pakietów + liczba pakietów pominiętych przez host;
    • overruns - liczba zdarzeń przepełnienia;
    • frame - liczba pakietów z błędami ramek;
    • compressed - liczba poprawnie odebranych skompresowanych pakietów;
    • multicast - odebrane pakiety multicast.
  • out - ruch wychodzący, odczytywany z /proc/net/dev. Zawiera liczniki interfejsu:
    • bytes - liczba poprawnych bajtów;
    • packets - liczba poprawnych pakietów;
    • errors - całkowita liczba błędnych pakietów;
    • dropped - liczba odebranych, ale nieprzetworzonych pakietów + liczba pakietów pominiętych przez host;
    • overruns - liczba zdarzeń przepełnienia;
    • collisions - liczba kolizji podczas transmisji pakietów;
    • carrier - liczba błędów transmisji ramek spowodowanych utratą nośnej podczas transmisji;
    • compressed - liczba wysłanych skompresowanych pakietów.

Niedostępne metryki są wykluczane z danych wyjściowych JSON. W poniższym przykładzie dla interfejsu „lo” nie skonfigurowano aliasu, dlatego właściwość ifalias jest wykluczona.

Przykład:

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

Zobacz także

Aby uzyskać więcej informacji o ABI sysfs dla urządzeń sieciowych, zobacz: