18 Valores devueltos para net.if.get

Resumen

Esta sección proporciona detalles sobre los valores devueltos para el item net.if.get. El item es compatible en Linux con Zabbix agent y Zabbix agent 2.

Detalles

Este item devuelve información detallada sobre las interfaces de red cuyos nombres coinciden con la expresión regular proporcionada. La salida está estructurada como un objeto JSON que contiene los arrays config y values.

La salida contiene las siguientes propiedades:

  • name - nombre de la interfaz, leído de /proc/net/dev;
  • ifalias - alias de la interfaz, leído de /sys/class/net/<name>/ifalias;
  • mac - dirección MAC de la interfaz, leída de /sys/class/net/<name>/address;
  • type - tipo de interfaz (physical, virtual, loopback);
  • speed - velocidad del enlace en Mbits/s, específica de Ethernet, leída de /sys/class/net/<name>/speed;
  • duplex - valor más reciente o actual de dúplex de la interfaz (half, full), específico de Ethernet, leído de /sys/class/net/<name>/duplex;
  • administrative_state - estado configurado (down, up), leído de /sys/class/net/<name>/flags;
  • operational_state - estado operativo RFC2863 de la interfaz (unknown, notpresent, down, lowerlayerdown, testing, dormant, up), leído de sys/class/net/<name>/operstate;
  • carrier - presencia de enlace físico (0 - el enlace físico está caído, 1 - el enlace físico está activo), leído de /sys/class/net/<name>/carrier;
  • carrier_changes - número total de veces que el estado del enlace cambió de activo a caído y viceversa, leído de /sys/class/net/<name>/carrier_changes;
  • carrier_up_count - número de veces que el enlace ha pasado a estar activo, leído de /sys/class/net/<name>/carrier_up_count;
  • carrier_down_count - número de veces que el enlace ha pasado a estar caído, leído de /sys/class/net/<name>/carrier_down_count;
  • in - tráfico entrante, leído de /proc/net/dev. Contiene contadores de la interfaz:
    • bytes - número de bytes correctos;
    • packets - número de paquetes correctos;
    • errors - número total de paquetes erróneos;
    • dropped - número de paquetes recibidos pero no procesados + cantidad de paquetes perdidos por el host;
    • overruns - número de eventos de desbordamiento;
    • frame - número de paquetes con errores de trama;
    • compressed - número de paquetes comprimidos recibidos correctamente;
    • multicast - paquetes multicast recibidos.
  • out - tráfico saliente, leído de /proc/net/dev. Contiene contadores de la interfaz:
    • bytes - número de bytes correctos;
    • packets - número de paquetes correctos;
    • errors - número total de paquetes erróneos;
    • dropped - número de paquetes recibidos pero no procesados + cantidad de paquetes perdidos por el host;
    • overruns - número de eventos de desbordamiento;
    • collisions - número de colisiones durante la transmisión de paquetes;
    • carrier - número de errores de transmisión de tramas debidos a la pérdida de portadora durante la transmisión;
    • compressed - número de paquetes comprimidos transmitidos.

Las métricas no disponibles se excluyen de la salida JSON. En el siguiente ejemplo, no hay ningún alias configurado para la interfaz "lo", por lo que la propiedad ifalias se excluye.

Ejemplo:

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

Véase también

Para obtener más información sobre la ABI de sysfs para dispositivos de red, consulte: