5 Zabbix internal

Descripción general

Las comprobaciones internas permiten monitorizar los procesos internos de Zabbix. En otras palabras, puede monitorizar lo que ocurre con el servidor Zabbix o el proxy Zabbix.

Las comprobaciones internas se calculan:

• en el servidor Zabbix - si el host es monitorizado por el servidor
• en el proxy Zabbix - si el host es monitorizado por el proxy

Las comprobaciones internas son procesadas por el servidor o el proxy independientemente del estado de mantenimiento del host.

Para utilizar este item, elija el tipo de item Zabbix internal.

Rendimiento

El uso de algunos items internos puede afectar negativamente al rendimiento. Estos items son:

• zabbix[host,,items]
• zabbix[host,,items_unsupported]
• zabbix[hosts]
• zabbix[items]
• zabbix[items_unsupported]
• zabbix[queue,,]
• zabbix[requiredperformance]
• zabbix[stats,,,queue,,]
• zabbix[triggers]

Las secciones del frontend Información del sistema y Cola también se ven afectadas.

Checks compatibles

Las claves de item se enumeran sin parámetros personalizables ni información adicional. Haga clic en la clave de item para ver los detalles completos.

Detalles de la clave del item

• Los parámetros sin corchetes angulares son obligatorios y deben usarse tal cual (por ejemplo, "host" y "available" en zabbix[host,<type>,available]).
• Los parámetros con corchetes angulares < > deben ser reemplazados por un valor válido. Si un parámetro tiene un valor por defecto, puede omitirse.
• Los valores de los items y parámetros de item etiquetados como "no soportado en proxy" sólo pueden recuperarse si el host es monitorizado por el server. Por el contrario, los valores "no soportados en server" sólo pueden recuperarse si el host es monitorizado por el proxy.

zabbix[boottime]

El tiempo de inicio del proceso Zabbix server o Zabbix proxy en segundos.
Valor de retorno: Entero.

zabbix[cluster,discovery,nodes]

Descubre los nodos del cluster de alta disponibilidad.
Valor de retorno: objeto JSON.

Comentarios:

• Este item puede ser utilizado en el descubrimiento de bajo nivel.
• Los campos devueltos coinciden en su mayoría con las propiedades del objeto de nodo de alta disponibilidad.
• Campos adicionales:
  • db_timestamp — hora actual del server (timestamp Unix) incluida en la respuesta
  • lastaccess_age — segundos desde el último latido del nodo (db_timestamp - lastaccess)
  • status — estado del nodo:
    • 0 — standby
    • 1 — detenido manualmente
    • 2 — no disponible
    • 3 — activo

Ejemplo de valores de retorno:

[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]

zabbix[connector_queue]

El número de valores encolados en la cola del conector.
Valor de retorno: Entero.

zabbix[discovery_queue]

El número de comprobaciones de red encoladas en la cola de descubrimiento.
Valor de retorno: Entero.

zabbix[equipo,,métricas]

El número de métricas habilitadas (soportadas y no soportadas) en el equipo.
Valor de retorno: Entero.

zabbix[equipo,,items_unsupported]

El número de métricas habilitadas no soportadas en el equipo.
Valor de retorno: Entero.

zabbix[host,,maintenance]

El estado de mantenimiento actual del host.
Valores devueltos: 0 - estado normal; 1 - mantenimiento con recolección de datos; 2 - mantenimiento sin recolección de datos.

Comentarios:

• Este item siempre es procesado por el Zabbix server independientemente de la ubicación del host (en el server o en el proxy). El proxy no recibirá este item con los datos de configuración.
• El segundo parámetro debe estar vacío y está reservado para uso futuro.

zabbix[equipo,active_agent,available]

La disponibilidad de comprobaciones de agente activo en el equipo.
Valores de retorno: 0 - desconocido; 1 - disponible; 2 - no disponible.

zabbix[equipo,descubrimiento,interfaces]

Los detalles de todas las interfaces configuradas del equipo en el frontend de Zabbix.
Valor de retorno: objeto JSON.

Comentarios:

• Esta métrica puede utilizarse en el descubrimiento de bajo nivel.
• Esta métrica no es compatible con el proxy de Zabbix.

zabbix[host,<type>,available]

La disponibilidad de la interfaz principal de un tipo concreto de comprobaciones en el host.
Valores devueltos: 0 - no disponible; 1 - disponible; 2 - desconocido.

Parámetros:

• type - agent, snmp, ipmi o jmx.

Comentarios:

• El valor del item se calcula de acuerdo con los parámetros de configuración relativos a la inaccesibilidad/no disponibilidad del host.

zabbix[hosts]

El número de equipos monitorizados.
Valor de retorno: Entero.

zabbix[items]

El número de métricas habilitadas (soportadas y no soportadas).
Valor de retorno: Entero.

zabbix[items_unsupported]

El número de métricas no soportadas.
Valor de retorno: Entero.

zabbix[java,,<param>]

Información sobre Zabbix Java gateway.
Valores devueltos: 1 - si <param> es ping; versión de Java gateway - si <param> es version (por ejemplo: "7.4.0").

Parámetros:

• param - ping o version.

Comentarios:

• Este item se puede usar para comprobar la disponibilidad de Java gateway mediante la función de trigger nodata().
• El segundo parámetro debe estar vacío y está reservado para uso futuro.

zabbix[lld_queue]

El número de valores encolados en la cola de procesamiento de bajo nivel de descubrimiento.
Valor de retorno: Entero.

Comentarios:

• Esta métrica puede usarse para monitorizar la longitud de la cola de procesamiento de bajo nivel de descubrimiento.

zabbix[preprocessing]

Estadísticas de los valores recibidos por el gestor de preprocesamiento:

• queued - el número y tamaño de los valores en cola que requieren preprocesamiento (contador)
• direct - el número y tamaño de los valores en cola que no requieren preprocesamiento (contador)
• queue - el número de valores encolados en la cola de preprocesamiento (igual que zabbix[preprocessing_queue])

Valor devuelto: JSON.

Ejemplo de valores devueltos:

{"data":
    {
    "queued": {
        "count": 106,
        "size": 58620
    },
    "direct": {
        "count": 395,
        "size": 33843
    },
    "queue": 0
    }
}

zabbix[preprocessing_queue]

El número de valores encolados en la cola de preprocesamiento.
Valor devuelto: Entero.

Comentarios:

• Esta métrica puede usarse para monitorizar la longitud de la cola de preprocesamiento.

zabbix[process,<type>,<mode>,<state>]

El porcentaje de tiempo que un proceso de Zabbix concreto o un grupo de procesos (identificados por <type> y <mode>) pasó en <state>. Se calcula solo para el último minuto.
Valor devuelto: Float.

Parámetros:

• type:
  • para server processes: agent poller, alert manager, alert syncer, alerter, availability manager, browser poller, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager, history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy group manager, proxy poller, self-monitoring, service manager, snmp poller, snmp trapper, task manager, timer, trapper, trigger housekeeper, unreachable poller, vmware collector;
  • para proxy processes: agent poller, availability manager, browser poller, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp poller, snmp trapper, task manager, trapper, unreachable poller, vmware collector;
• mode:
  • avg - valor promedio para todos los procesos de un tipo dado (predeterminado);
  • count - devuelve el número de forks para un tipo de proceso dado, no se debe especificar <state>;
  • max - valor máximo;
  • min - valor mínimo;
  • <process number> - número de proceso (entre 1 y el número de instancias pre-fork; por ejemplo, si se están ejecutando 4 trappers, el valor está entre 1 y 4);
• state:
  • busy - el proceso está en estado ocupado, por ejemplo, procesando una solicitud (predeterminado);
  • idle - el proceso está en estado inactivo, sin hacer nada.

Comentarios:

• Si <mode> es un número de proceso de Zabbix que no se está ejecutando (por ejemplo, con 5 pollers en ejecución, se especifica <mode> como 6), ese item pasará a no compatible.
• El mínimo y el máximo se refieren al porcentaje de uso de un solo proceso. Así, si en un grupo de 3 pollers los porcentajes de uso por proceso fueran 2, 18 y 66, min devolvería 2 y max devolvería 66.
• Los procesos informan de lo que están haciendo en memoria compartida y el proceso de self-monitoring resume esos datos cada segundo. Los cambios de estado (busy/idle) se registran cuando ocurren; por lo tanto, un proceso que pasa a busy se registra como tal y no cambia ni actualiza el estado hasta que pasa a idle. Esto garantiza que incluso los procesos completamente bloqueados se registren correctamente como 100% busy.
• Actualmente, "busy" significa "no durmiendo", pero en el futuro podrían introducirse estados adicionales: esperando bloqueos, realizando consultas a la base de datos, etc. Tenga en cuenta que los pollers asíncronos se consideran busy si han alcanzado el límite establecido por el parámetro de configuración MaxConcurrentChecksPerPoller server/proxy.
• En Linux y en la mayoría de los demás sistemas, la resolución es de 1/100 de segundo.

Ejemplos:

zabbix[process,poller,avg,busy] #el tiempo promedio que los procesos poller pasan haciendo algo durante el último minuto
zabbix[process,"icmp pinger",max,busy] #el tiempo máximo que cualquier proceso ICMP pinger pasó haciendo algo durante el último minuto
zabbix[process,"history syncer",2,busy] #el tiempo que el proceso history syncer número 2 pasó haciendo algo durante el último minuto
zabbix[process,trapper,count] #la cantidad de procesos trapper que se están ejecutando actualmente

zabbix[proxy,<name>,<param>]

La información sobre el proxy de Zabbix.
Valor devuelto: Integer.

Parámetros:

• name - el nombre del proxy;
• param:
  • lastaccess - la marca de tiempo del último mensaje de latido recibido del proxy;
  • delay - cuánto tiempo llevan sin enviarse los valores recopilados; se calcula como "proxy delay" + ("current server time" - "proxy lastaccess"), donde "proxy delay" es la diferencia entre la hora actual del proxy y la marca de tiempo del valor no enviado más antiguo en el proxy.

Comentarios:

• Este item siempre es procesado por Zabbix server independientemente de la ubicación del host (en server o proxy).
• La función fuzzytime() se puede usar para comprobar la disponibilidad del proxy.

Ejemplo:

zabbix[proxy,"Germany",lastaccess] #la marca de tiempo del último mensaje de latido recibido del proxy "Germany"

zabbix[proxy,discovery]

La lista de proxies de Zabbix con nombre, modo, cifrado, compresión, versión, última vez visto, número de equipos, número de métricas, valores requeridos por segundo (vps), estado de la versión (actual/obsoleta/no soportada), tiempos de espera por tipo de métrica, nombre del grupo de proxies (si el proxy pertenece a un grupo), estado (desconocido/desconectado/conectado).
Valor de retorno: objeto JSON.

zabbix[proxy group,<nombre>,available]

El número de proxies en línea en un grupo de proxies.
Valor de retorno: Entero.

Parámetros:

• nombre - el nombre del grupo de proxies.

zabbix[proxy group,<name>,pavailable]

El porcentaje de proxies en línea en un grupo de proxies.
Valor de retorno: Float.

Parámetros:

• name - el nombre del grupo de proxies.

zabbix[proxy group,<nombre>,proxies]

La lista de proxies de Zabbix en un grupo de proxies con nombre, modo, cifrado, compresión, versión, última vez visto, número de equipos, número de métricas, valores requeridos por segundo (vps), estado de la versión (actual/obsoleta/no soportada), tiempos de espera, nombre del grupo de proxies, estado (desconocido/desconectado/conectado).
Valor de retorno: JSON.

Parámetros:

• nombre - el nombre del grupo de proxies.

zabbix[proxy group,<name>,state]

El estado de un grupo de proxies.
Valor de retorno: 0 - desconocido; 1 - desconectado; 2 - recuperando; 3 - conectado; 4 - degradando.

Parámetros:

• name - el nombre del grupo de proxies.

zabbix[proxy group,discovery]

Devuelve una lista de grupos de proxy con datos de configuración y datos en tiempo real. Los datos de configuración incluyen el nombre del grupo de proxy, el retardo de failover y el número mínimo de proxies en línea requerido. Los datos en tiempo real incluyen el estado del grupo de proxy (consulte los comentarios para obtener detalles), el número de proxies en línea y el porcentaje de proxies en línea.
Valor devuelto: JSON.

Comentarios:

• Este item no devuelve proxies sin grupo.
• Si hay un valor no válido para failover_delay o min_online, se informa un valor especial -1 para indicarlo. Los valores no válidos pueden producirse si se usan macros para la configuración y las macros no pueden expandirse a un valor válido.
• El estado del grupo de proxy se informa como un entero: 0 - desconocido; 1 - desconectado; 2 - recuperándose; 3 - en línea; 4 - degradándose.

Ejemplo de valores devueltos:

{
    "groups": [
       { "name": "Riga", "failover_delay": 60, "min_online": 1 },
       { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
       { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
    ],
    "details": {
        "Riga": { "state": 3, "available": 10, "pavailable": 20 },
        "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
        "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
    }
}

zabbix[proxy_buffer,buffer,<mode>]

Las estadísticas de uso del búfer de memoria del proxy.
Valores devueltos: Integer (para el tamaño); Float (para el porcentaje).

Parámetros:

• mode:
  • total - el tamaño total del búfer (puede usarse para comprobar si el búfer de memoria está habilitado);
  • free - el tamaño del búfer libre;
  • pfree - el porcentaje de búfer libre;
  • used - el tamaño del búfer usado;
  • pused - el porcentaje de búfer usado.

Comentarios:

• Devuelve un error 'Proxy memory buffer is disabled' cuando el búfer de memoria está deshabilitado;
• Este item no es compatible con Zabbix server.

zabbix[proxy_buffer,state,changes]

Devuelve el número de cambios de estado entre los modos de buffer de disco/memoria desde el inicio.
Valores de retorno: Entero; 0 - el buffer de memoria está deshabilitado.

Comentarios:

• Los cambios de estado frecuentes indican que se debe aumentar el tamaño o la antigüedad del buffer de memoria.
• Si el estado del buffer de memoria se monitoriza con poca frecuencia (por ejemplo, una vez por minuto), entonces el buffer podría cambiar de estado sin que se registre.

zabbix[proxy_buffer,state,current]

Devuelve el estado de funcionamiento actual donde se están almacenando los nuevos datos.
Valores devueltos: 0 - disco; 1 - memoria.

Comentarios:

• 0 también se devuelve cuando el búfer de memoria está deshabilitado.

zabbix[proxy_history]

El número de valores en la tabla de historial del proxy que esperan ser enviados al servidor.
Valores devueltos: Entero.

Comentarios:

• Esta métrica no es compatible en el servidor Zabbix.

zabbix[queue,<from>,<to>]

El número de items monitorizados en la cola que tienen un retraso de al menos <from> segundos, pero inferior a <to> segundos.
Valor devuelto: Integer.

Parámetros:

• from - retrasado al menos por (el valor predeterminado es 6 segundos);
• to - retrasado como máximo por (el valor predeterminado es infinito).

Comentarios:

• Se admiten sufijos de tiempo (s,m,h,d,w) en los parámetros.

zabbix[rcache,<cache>,<mode>]

Las estadísticas de disponibilidad de la caché de configuración de Zabbix.
Valores devueltos: Integer (para el tamaño); Float (para el porcentaje).

Parámetros:

• cache - buffer;
• mode:
  • total - el tamaño total del buffer;
  • free - el tamaño del buffer libre;
  • pfree - el porcentaje del buffer libre;
  • used - el tamaño del buffer usado;
  • pused - el porcentaje del buffer usado.

zabbix[requiredperformance]

El rendimiento requerido del server o del proxy de Zabbix, en nuevos valores por segundo esperados.
Valor devuelto: Float.

Comentarios:

• Correlaciona aproximadamente con "Required server performance, new values per second" en Reports > System information.

zabbix[stats,<ip>,<port>]

Devuelve las métricas internas de un server o proxy de Zabbix. Si se especifican <ip> y <port>, las métricas se obtienen de la instancia remota; de lo contrario, de la instancia local.
Valores devueltos: objeto JSON.

Parámetros:

• ip - la lista de IP/DNS/máscara de red de servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051).

Comentarios:

• La solicitud de estadísticas solo se aceptará desde las direcciones enumeradas en el parámetro StatsAllowedIP server/proxy de la instancia de destino.
• Este item devuelve un conjunto seleccionado de métricas internas. Para más detalles, consulte Monitoreo remoto de estadísticas de Zabbix.

zabbix[stats,<ip>,<port>,queue,<from>,<to>]

Devuelve las métricas internas de la cola (consulte zabbix[queue,<from>,<to>]) de un server o proxy de Zabbix. Si se especifican <ip> y <port>, las métricas se obtienen de la instancia remota; de lo contrario, de la instancia local.
Valores devueltos: objeto JSON.

Parámetros:

• ip - la lista de direcciones IP/DNS/máscaras de red de los servers/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port - el puerto del server/proxy que se consultará de forma remota (el valor predeterminado es 10051);
• from - retrasado al menos (el valor predeterminado es 6 segundos);
• to - retrasado como máximo (el valor predeterminado es infinito).

Comentarios:

• La solicitud de estadísticas solo se aceptará desde las direcciones enumeradas en el parámetro StatsAllowedIP de server/proxy de la instancia de destino.
• Este item devuelve un conjunto seleccionado de métricas internas. Para obtener más detalles, consulte Monitoreo remoto de estadísticas de Zabbix.

zabbix[tcache,cache,<parameter>]

Las estadísticas de eficacia de la caché de la función de tendencias de Zabbix.
Valores devueltos: Integer (para el tamaño); Float (para el porcentaje).

Parámetros:

• parameter:
  • all - solicitudes totales de caché (predeterminado);
  • hits - aciertos de caché;
  • phits - porcentaje de aciertos de caché;
  • misses - fallos de caché;
  • pmisses - porcentaje de fallos de caché;
  • items - el número de elementos en caché;
  • requests - el número de solicitudes en caché;
  • pitems - porcentaje de elementos en caché respecto a elementos en caché + solicitudes. Un porcentaje bajo probablemente significa que el tamaño de la caché se puede reducir.

Comentarios:

• Este item no es compatible con Zabbix proxy.

zabbix[triggers]

El número de disparadores habilitados en la base de datos de Zabbix, con todas las métricas habilitadas en los equipos habilitados.
Valor de retorno: Entero.

Comentarios:

• Esta métrica no es compatible con el proxy de Zabbix.

zabbix[uptime]

El tiempo de actividad del proceso del servidor o proxy de Zabbix en segundos.
Valor devuelto: Entero.

zabbix[vcache,buffer,<mode>]

Las estadísticas de disponibilidad de la caché de valores de Zabbix.
Valores devueltos: Integer (para el tamaño); Float (para el porcentaje).

Parámetros:

• mode:
  • total - el tamaño total del buffer;
  • free - el tamaño del buffer libre;
  • pfree - el porcentaje de buffer libre;
  • used - el tamaño del buffer usado;
  • pused - el porcentaje de buffer usado.

Comentarios:

• Este item no es compatible con Zabbix proxy.

zabbix[vcache,cache,<parameter>]

Las estadísticas de eficacia de la caché de valores de Zabbix.
Valor devuelto: Integer. Si <parameter> se establece en mode, el valor devuelto es: 0 - modo normal; 1 - modo de memoria baja.

Parámetros:

• parameter:
  • requests - el número total de solicitudes;
  • hits - el número de aciertos de caché (valores históricos tomados de la caché);
  • misses - el número de fallos de caché (valores históricos tomados de la base de datos);
  • mode - el modo de funcionamiento de la caché de valores.

Comentarios:

• Una vez activado el modo de memoria baja, la caché de valores permanecerá en este estado durante 24 horas, incluso si el problema que activó este modo se resuelve antes.
• Puede usar esta clave con el paso de preprocesamiento Change per second para obtener estadísticas de valores por segundo.
• Este item no es compatible con Zabbix proxy.

zabbix[version]

La versión del server o proxy de Zabbix.
Valor devuelto: String. Por ejemplo: 7.4.0.

zabbix[vmware,buffer,<mode>]

Las estadísticas de disponibilidad de la caché vmware de Zabbix.
Valores devueltos: Integer (para el tamaño); Float (para el porcentaje).

Parámetros:

• mode:
  • total - el tamaño total del buffer;
  • free - el tamaño del buffer libre;
  • pfree - el porcentaje del buffer libre;
  • used - el tamaño del buffer usado;
  • pused - el porcentaje del buffer usado.

zabbix[vps,written]

El número total de valores históricos escritos en la base de datos.
Valor de retorno: Entero.

zabbix[wcache,<cache>,<mode>]

Las estadísticas y la disponibilidad de la write cache de Zabbix.
Valores de retorno: Integer (para número/tamaño); Float (para porcentaje).

Parámetros:

• cache - values, history, index o trend;
• mode:
  • con el parámetro de cache values:
    • all - el número total de valores procesados por el server/proxy de Zabbix, excepto los items no soportados (contador) (predeterminado);
    • float - el número de valores flotantes procesados (contador);
    • uint - el número de valores enteros sin signo procesados (contador);
    • str - el número de valores de caracteres/cadena procesados (contador);
    • log - el número de valores de log procesados (contador);
    • text - el número de valores de texto procesados (contador);
    • bin - el número de valores binarios procesados (contador);
    • json - el número de valores JSON procesados (contador);
    • not supported - el número de veces que el procesamiento del item dio como resultado que el item pasara a no soportado o mantuviera ese estado (contador);
  • con los parámetros de cache history, index, trend:
    • pfree - el porcentaje de buffer libre (predeterminado);
    • total - el tamaño total del buffer;
    • free - el tamaño del buffer libre;
    • used - el tamaño del buffer usado;
    • pused - el porcentaje del buffer usado.

Comentarios:

• El parámetro de cache trend no es compatible con Zabbix proxy.
• La history cache se usa para almacenar los valores de los items. Un número bajo indica problemas de rendimiento en la base de datos.
• La history index cache se usa para indexar los valores almacenados en la history cache.
• Después de que la history cache se llena y luego se vacía, la history index cache seguirá conservando algunos datos. Este comportamiento es esperado y ayuda a que el sistema funcione de forma más eficiente al evitar el procesamiento adicional que requeriría redimensionar constantemente la memoria.
• La trend cache almacena el agregado de la hora actual para todos los items que reciben datos.
• Puede usar la clave zabbix[wcache,values] con el paso de preprocesamiento Change per second para obtener estadísticas de valores por segundo.