8 Comprobaciones internas

Descripción general

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

Las comprobaciones internas se calculan:

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

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

Para utilizar esta métrica, elija el tipo de métrica Zabbix internal.

Rendimiento

El uso de algunas métricas internas puede afectar negativamente al rendimiento. Estas métricas 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.

Comprobaciones soportadas

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

Detalles de la clave de la métrica

• 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 para métricas y parámetros de métricas etiquetados como "no soportado en proxy" solo pueden recuperarse si el equipo es monitorizado por el servidor. Por el contrario, los valores "no soportado en servidor" solo pueden recuperarse si el equipo 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 clúster de alta disponibilidad.
Valor de retorno: objeto JSON.

Comentarios:

• Esta métrica puede usarse en el descubrimiento de bajo nivel.

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[equipo,,mantenimiento]

El estado actual de mantenimiento del equipo.
Valores de retorno: 0 - estado normal; 1 - mantenimiento con recopilación de datos; 2 - mantenimiento sin recopilación de datos.

Comentarios:

• Esta métrica siempre es procesada por el servidor Zabbix independientemente de la ubicación del equipo (en el servidor o proxy). El proxy no recibirá esta métrica 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[equipo,<tipo>,disponible]

La disponibilidad de la interfaz principal de un tipo particular de comprobaciones en el equipo.
Valores de retorno: 0 - no disponible; 1 - disponible; 2 - desconocido.

Parámetros:

• tipo - agent, snmp, ipmi o jmx.

Comentarios:

• El valor de la métrica se calcula de acuerdo con los parámetros de configuración relativos a la inaccesibilidad/indisponibilidad del equipo.

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>]

La información sobre el Java gateway de Zabbix.
Valores de retorno: 1 - si <param> es ping; versión del Java gateway - si <param> es version (por ejemplo: "8.0.0").

Parámetros:

• param - ping o version.

Comentarios:

• Esta métrica puede utilizarse para comprobar la disponibilidad del Java gateway usando la función de disparador 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 de retorno: JSON.

Ejemplo de valores de retorno:

{"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 Zabbix en particular o un grupo de procesos (identificados por <type> y <mode>) pasaron en el estado <state>. Se calcula solo para el último minuto.
Valor de retorno: Float.

Parámetros:

• type - para procesos del servidor: 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 procesos del proxy: 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 (por defecto);
  count - devuelve el número de forks para un tipo de proceso dado, <state> no debe especificarse;
  max - valor máximo;
  min - valor mínimo;
  <número de proceso> - número de proceso (entre 1 y el número de instancias pre-forked; por ejemplo, si hay 4 trappers en ejecución, el valor está entre 1 y 4);
• state - busy - el proceso está en estado ocupado, por ejemplo, procesando una solicitud (por defecto);
  idle - el proceso está en estado inactivo sin hacer nada.

Comentarios:

• Si <mode> es un número de proceso Zabbix que no está en ejecución (por ejemplo, con 5 pollers en ejecución y se especifica <mode> como 6), dicha métrica se volverá no soportada.
• Mínimo y máximo se refieren al porcentaje de uso para un solo proceso. Así, si en un grupo de 3 pollers los porcentajes de uso por proceso fueron 2, 18 y 66, min devolvería 2 y max devolvería 66.
• Los procesos informan lo que están haciendo en la memoria compartida y el proceso de auto-monitoreo resume esos datos cada segundo. Los cambios de estado (ocupado/inactivo) se registran al cambiar: así, un proceso que se vuelve ocupado se registra como tal y no cambia ni actualiza el estado hasta que se vuelve inactivo. Esto asegura que incluso los procesos completamente colgados se registren correctamente como 100% ocupados.
• Actualmente, "busy" significa "no durmiendo", pero en el futuro se podrían introducir estados adicionales: esperando bloqueos, realizando consultas a la base de datos, etc. Tenga en cuenta que los pollers asíncronos se consideran ocupados si han alcanzado el límite establecido por el parámetro de configuración MaxConcurrentChecksPerPoller de servidor/proxy.
• En Linux y la mayoría de los demás sistemas, la resolución es 1/100 de segundo.

Ejemplos:

zabbix[process,poller,avg,busy] #el tiempo promedio que los procesos poller pasaron 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 history syncer número 2 pasó haciendo algo durante el último minuto
       zabbix[process,trapper,count] #la cantidad de procesos trapper actualmente en ejecución

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

La información sobre el proxy de Zabbix.
Valor de retorno: Entero.

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 los valores recopilados no se han enviado; calculado como "retardo del proxy" + ("hora actual del servidor" - "último acceso del proxy"), donde "retardo del proxy" 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:

• Esta métrica siempre es procesada por el servidor Zabbix independientemente de la ubicación del equipo (en el servidor o en el proxy).
• La función fuzzytime() puede usarse 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 proxies con datos de configuración y datos en tiempo real. Los datos de configuración incluyen el nombre del grupo de proxies, el retardo de conmutación por error y el número mínimo de proxies en línea requeridos. Los datos en tiempo real incluyen el estado del grupo de proxies (consulte los comentarios para más detalles), el número de proxies en línea y el porcentaje de proxies en línea.
Valor de retorno: JSON.

Comentarios:

• Este elemento no devuelve proxies sin grupo.
• Si hay un valor no válido para "failover_delay" o "min_online", entonces se informa un valor especial -1 para indicar eso. Los valores no válidos pueden ocurrir si se utilizan macros para la configuración y las macros no pueden expandirse a un valor válido.
• El estado del grupo de proxies se informa como un entero: 0 - desconocido; 1 - fuera de línea; 2 - recuperando; 3 - en línea; 4 - degradando.

Ejemplo de valores de retorno:

{
           "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 de retorno: Entero (para tamaño); Flotante (para 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 'El búfer de memoria del proxy está deshabilitado' cuando el búfer de memoria está deshabilitado;
  
• Esta métrica no es compatible en el servidor Zabbix.

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 trabajo actual donde se están almacenando los nuevos datos.
Valores de retorno: 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 métricas monitorizadas en la cola que se retrasan al menos <from> segundos, pero menos de <to> segundos.
Valor devuelto: Entero.

Parámetros:

• from - retrasado al menos (el valor por defecto es 6 segundos);
• to - retrasado como máximo (el valor por defecto 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 de retorno: Entero (para tamaño); Flotante (para porcentaje).

Parámetros:

• cache - buffer;
• 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.

zabbix[requiredperformance]

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

Comentarios:

• Se correlaciona aproximadamente con "Rendimiento requerido del servidor, nuevos valores por segundo" en Informes → Información del sistema.

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

Las métricas internas de un servidor o proxy Zabbix remoto.
Valores de retorno: objeto JSON.

Parámetros:

• ip: la lista de IP/DNS/máscaras de red de los servidores/proxies a consultar remotamente (por defecto es 127.0.0.1);
• puerto: el puerto del servidor/proxy a consultar remotamente (por defecto es 10051).

Comentarios:

• La solicitud de estadísticas solo será aceptada desde las direcciones listadas en el parámetro 'StatsAllowedIP' de servidor/proxy en la instancia de destino.
• Esta métrica devuelve un conjunto seleccionado de métricas internas. Para más detalles, consulte Monitorización remota de estadísticas de Zabbix.

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

Las métricas internas de la cola (ver zabbix[queue,<from>,<to>]) de un servidor o proxy Zabbix remoto.
Valores de retorno: objeto JSON.

Parámetros:

• ip: la lista de IP/DNS/máscaras de red de los servidores/proxies a consultar remotamente (por defecto es 127.0.0.1);
• port: el puerto del servidor/proxy a consultar remotamente (por defecto es 10051);
• from: retrasado al menos (por defecto son 6 segundos);
• to: retrasado como máximo (por defecto es infinito).

Comentarios:

• La solicitud de estadísticas solo será aceptada desde las direcciones listadas en el parámetro 'StatsAllowedIP' de servidor/proxy en la instancia de destino.
• Un conjunto seleccionado de métricas internas es devuelto por esta métrica. Para más detalles, consulte Monitorización remota de estadísticas de Zabbix.

zabbix[tcache,<cache>,<parameter>]

Las estadísticas de efectividad de la caché de funciones de tendencias de Zabbix.
Valores de retorno: Entero (para tamaño); Flotante (para porcentaje).

Parámetros:

• cache - buffer;
• parameter - all - solicitudes totales a la caché (por defecto);
  hits - aciertos de caché;
  phits - porcentaje de aciertos de caché;
  misses - fallos de caché;
  pmisses - porcentaje de fallos de caché;
  items - número de métricas en caché;
  requests - número de solicitudes en caché;
  pitems - porcentaje de métricas en caché respecto a métricas en caché + solicitudes. Un porcentaje bajo probablemente significa que el tamaño de la caché puede reducirse.

Comentarios:

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

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 de retorno: Entero (para tamaño); Flotante (para porcentaje).

Parámetros:

• mode - total - el tamaño total del búfer;
  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:

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

zabbix[vcache,cache,<parámetro>]

Las estadísticas de efectividad de la caché de valores de Zabbix.
Valores de retorno: Entero. Con el parámetro mode devuelve: 0 - modo normal; 1 - modo de baja memoria.

Parámetros:

• parámetro - 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 que se activa el modo de baja memoria, la caché de valores permanecerá en este estado durante 24 horas, incluso si el problema que activó este modo se resuelve antes.
• Puede utilizar esta clave con el paso de preprocesamiento Cambio por segundo para obtener estadísticas de valores por segundo.
• Esta métrica no es compatible en el proxy de Zabbix.

zabbix[version]

La versión del servidor o proxy de Zabbix.
Valor de retorno: Cadena. Por ejemplo: 8.0.0.

zabbix[vmware,buffer,<mode>]

Las estadísticas de disponibilidad de la caché vmware de Zabbix.
Valores de retorno: Entero (para tamaño); Flotante (para 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.

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 disponibilidad de la caché de escritura de Zabbix.
Valores de retorno: Entero (para número/tamaño); Flotante (para porcentaje).

Parámetros:

• cache - values, history, index o trend;
• mode - (con values) all (por defecto): el número total de valores procesados por el servidor/proxy de Zabbix, excepto las métricas no soportadas (contador);
  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/cadenas procesados (contador);
  log: el número de valores de registro procesados (contador);
  text: el número de valores de texto procesados (contador);
  not supported: el número de veces que el procesamiento de la métrica resultó en que la métrica se volviera no soportada o mantuviera ese estado (contador);
  (con caché history, index, trend) pfree (por defecto): el porcentaje de búfer libre;
  total: el tamaño total del búfer;
  free: el tamaño del búfer libre;
  used: el tamaño del búfer usado;
  pused: el porcentaje del búfer usado.

Comentarios:

• Es obligatorio especificar <cache>. El parámetro de caché trend no es compatible con el proxy de Zabbix.
• La caché de historial se utiliza para almacenar los valores de las métricas. Un número bajo indica problemas de rendimiento en la base de datos.
• La caché de índice de historial se utiliza para indexar los valores almacenados en la caché de historial.
• Después de que la caché de historial se llena y luego se vacía, la caché de índice de historial seguirá manteniendo algunos datos. Este comportamiento es esperado y ayuda a que el sistema funcione de manera más eficiente al evitar el procesamiento adicional requerido para redimensionar constantemente la memoria.
• La caché de tendencias almacena el agregado para la hora actual de todas las métricas que reciben datos.
• Puede utilizar la clave zabbix[wcache,values] con el paso de preprocesamiento Cambio por segundo para obtener estadísticas de valores por segundo.