Documentation

#8 Comprobaciones internas

Descripción general

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

Las comprobaciones internas se calculan:

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

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

Para usar esta métrica, elija el tipo de métrica Zabbix interno.

Rendimiento

El uso de algunas métricas internas puede afectar negativamente el 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 de Información del sistema y la Cola en la interfaz también se ven afectadas.

Comprobaciones soportadas

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

Detalles de la clave de la métrica

• Los parámetros sin paréntesis angulares son constantes; por ejemplo, 'host' y 'available' en zabbix[host,<tipo>,available]. Úselos en la clave de la métrica tal cual.
• Los parámetros con corchetes angulares < > deben reemplazarse por un valor válido. Si un parámetro tiene un valor predeterminado, se puede omitir.
• Los valores de métricas y parámetros de métricas que "no son compatibles con el proxy" solo se pueden recuperar si el servidor supervisa el equipo. Y viceversa, los valores "no admitidos en el servidor" sólo se pueden recuperar si el equipo es monitoreado por un proxy.

zabbix[boottime]

El tiempo de inicio del servidor Zabbix o del proceso proxy Zabbix 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 se puede utilizar en el descubrimiento de bajo nivel.

zabbix[conector_queue]

El recuento de valores en cola en la cola del conector.
Valor de retorno: Entero.

zabbix[discovery_queue]

El recuento de comprobaciones de red puestas en cola en la cola de descubrimiento.
Valor de retorno: Entero.

zabbix[host,,métricas]

La cantidad de métricas habilitados (compatibles y no compatibles) en el equipo.
Valor de retorno: Entero.

zabbix[host,,items_unsupported]

La cantidad de métricas habilitadas no compatibles en el equipo.
Valor de retorno: Entero.

zabbix[host,,maintenance]

El estado de mantenimiento actual 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 en los datos de configuración.
• El segundo parámetro debe estar vacío y está reservado para uso futuro.

zabbix[host,active_agent,available]

La disponibilidad de comprobaciones de agentes activos en el equipo.
Valores de retorno: 0 - desconocido; 1 disponible; 2* - no disponible.

zabbix[host,discovery,interfaces]

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

Comentarios:

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

zabbix[host,<type>,available]

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:

• type - agent, snmp, ipmi o jmx.

Comentarios:

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

zabbix[hosts]

La cantidad de equipos monitoreados.
Valor de retorno: Entero.

zabbix[items]

El número de métricas habilitadas (compatibles y no compatibles).
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 la puerta de enlace Java de Zabbix.
Valores de retorno: 1 - si <param> es ping; Versión de la puerta de enlace Java - si <param> es version (por ejemplo: "7.0.0").

Parámetros:

• param - ping o version.

Comentarios:

• Esta métrica se puede utilizar para comprobar la disponibilidad de la puerta de enlace Java mediante la función de activación nodata().
• El segundo parámetro debe estar vacío y está reservado para uso futuro.

zabbix[lld_queue]

El recuento de valores en la cola de procesamiento de descubrimiento de bajo nivel.
Valor de retorno: Entero.

Comentarios:

• Esta métrica se puede utilizar para monitorear la longitud de la cola de procesamiento de descubrimiento de bajo nivel.

zabbix[preprocessing_queue]

El recuento de valores en la cola de preprocesamiento.
Valor de retorno: Entero.

Comentarios:

• Esta métrica se puede utilizar para monitorear la longitud de la cola de preprocesamiento.

zabbix[process,<tipo>,<modo>,<estado>]

El porcentaje de tiempo que un proceso Zabbix particular o un grupo de procesos (identificados por <tipo> y <modo>) pasó en <estado>. Se calcula sólo para el último minuto. Especificar el <tipo> es obligatorio.
Valor de retorno: Flotante.

Parámetros:

• tipo - para procesos del servidor: agent poller, alert manager, alert syncer, alerter, availability manager, 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, 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 proxy: agent poller, availability manager, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, 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
• modo - avg - valor promedio para todos los procesos de un tipo determinado (predeterminado)
  count - devuelve el número de bifurcaciones para un tipo de proceso determinado, <estado> 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 previamente bifurcadas). Por ejemplo, si hay 4 capturadores en ejecución, el valor está entre 1 y 4.
• estado - busy - el proceso está en estado ocupado, por ejemplo, la solicitud de procesamiento (predeterminado); idle: el proceso está en estado inactivo y no hace nada.

Comentarios:

• Si <modo> es un número de proceso de Zabbix que no se está ejecutando (por ejemplo, con 5 sondeadores ejecutándose, <modo> se especifica como 6), dicho elemento dejará de ser compatible;
• Mínimo y máximo se refiere al porcentaje de uso para un solo proceso. Entonces, si en un grupo de 3 encuestadores los porcentajes de uso por proceso fueran 2, 18 y 66, el mínimo devolvería 2 y el máximo devolvería 66.
• Los procesos informan lo que están haciendo en la memoria compartida y el proceso de autocontrol resume esos datos cada segundo. Los cambios de estado (ocupado/inactivo) se registran al momento del cambio; por lo tanto, un proceso que se vuelve ocupado se registra como tal y no cambia ni actualiza el estado hasta que queda inactivo. Esto garantiza que incluso los procesos completamente colgados se registrarán correctamente como 100 % ocupados.
• Actualmente, "ocupado" significa "no dormido", pero en el futuro podrían introducirse estados adicionales: esperando bloqueos, realizando consultas a la base de datos, etc.
• 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 de los procesos de sondeo dedicados a hacer algo durante el último minuto
       zabbix[process,"icmp pinger",max,busy] #el tiempo máximo dedicado a hacer algo por cualquier proceso de pinger ICMP durante el último minuto
       zabbix[process,"history syncer",2,busy] #el tiempo dedicado a hacer algo por el sincronizador de historial número 2 durante el último minuto
       zabbix[process,trapper,count] #la cantidad de procesos de captura actualmente en ejecución

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

La información sobre el proxy 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 no se envían los valores recopilados; calculado como "retraso del proxy" + ("hora actual del servidor" - "último acceso del proxy"), donde "retraso 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 lo procesa el servidor Zabbix independientemente de la ubicación del equipo (en el servidor o en el proxy).
• La función fuzzytime() se puede utilizar para verificar 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 servidores proxy de Zabbix con nombre, modo, cifrado, compresión, versión, visto por última vez, recuento de equipos, recuento de métricas, valores requeridos por segundo (vps), estado de la versión (actual/obsoleta/no compatible), tiempos de espera por tipo de métrica, grupo de proxy nombre (si el proxy pertenece al grupo), estado (desconocido/fuera de línea/en línea).
Valor de retorno: objeto JSON.

zabbix[proxy group,<nombre>,available]

La cantidad de proxies en línea en un grupo de proxy.
Valor de retorno: Entero.

Parámetros:

• nombre: el nombre del grupo de proxy.

zabbix[proxy group,<nombre>,pavailable]

El porcentaje de representantes en línea en un grupo de representantes.
Valor de retorno: Flotante.

Parámetros:

• nombre: el nombre del grupo de proxy.

zabbix[proxy group,<nombre>,proxies]

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

Parámetros:

• nombre: el nombre del grupo de proxy.

zabbix[proxy group,<nombre>,state]

El estado de un grupo de proxy.
Valor de retorno: 0 - desconocido; 1 - fuera de línea; 2 - recuperándose; 3 - en línea; 4 - degradado.

Parámetros:

• nombre: el nombre del grupo de proxy.

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 retraso de conmutación por error y la cantidad mínima de servidores proxy en línea necesarios. Los datos en tiempo real incluyen el estado del grupo de proxy (consulte los comentarios para obtener más detalles), la cantidad de servidores proxy en línea y el porcentaje de servidores proxy en línea.
Valor de retorno: JSON.

Comentarios:

• Esta métrica no devuelve servidores proxy sin grupo;
• Si hay un valor no válido para "failover_delay" o "min_online", se informa un valor especial -1 para indicarlo. Pueden aparecer valores no válidos si se utilizan macros para la configuración y las macros no se pueden expandir a un valor válido.
• El estado del grupo de proxy se informa como un entero: 0 - desconocido; 1 - fuera de línea; 2 - en recuperación; 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>]

Estadísticas de uso del búfer de memoria del proxy.
Valores de retorno: Entero (para el tamaño); Flotante (para el porcentaje).

Parámetros:

• mode: total - el tamaño total del búfer (se puede utilizar para comprobar si el búfer de memoria está habilitado);
  free - el tamaño del búfer libre;
  pfree - el porcentaje del búfer libre;
  used - el tamaño del búfer usado;
  pused - el porcentaje del 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 con el servidor Zabbix.

zabbix[proxy_buffer,state,changes]

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

Comentarios:

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

zabbix[proxy_buffer,state,current]

Devuelve el estado de trabajo actual donde se almacenan 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]

La cantidad de valores en la tabla del historial de proxy esperando a ser enviados al servidor.
Valores de retorno: Entero.

Comentarios:

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

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

La cantidad de métricas monitoreadas en la cola que tienen un retraso de al menos <from> segundos, pero menos de <to> segundos.
Valor de retorno: Entero.

Parámetros:

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

Comentarios:

• Los sufijos de tiempo (s,m,h,d,w) son compatibles con los parámetros.

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

Las estadísticas de disponibilidad del caché de configuración de Zabbix.
Valores de retorno: Entero (para tamaño); flotante (para porcentaje).

Parámetros:

• cache - búfer;
• 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 de 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: Flotante.

Comentarios:

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

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

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áscara de red de servidores/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port: el puerto del servidor/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' servidor/proxy en la instancia de destino;
• Esta métrica devuelve un conjunto seleccionado de métricas internas. Para obtener más información, consulte Monitoreo remoto de las estadísticas de Zabbix.

zabbix[stats,<ip>,<port>,queue,<desde>,<hasta>]

Las métricas de la cola interna (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áscara de red de servidores/proxies que se consultarán de forma remota (el valor predeterminado es 127.0.0.1);
• port: el puerto del servidor/proxy que se consultará de forma remota (el valor predeterminado es 10051);
• desde - retrasado al menos (el valor predeterminado es 6 segundos);
• hasta: 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' servidor/proxy en la instancia de destino;
• Esta métrica devuelve un conjunto seleccionado de métricas internas. Para obtener más información, consulte Monitoreo remoto de las estadísticas de Zabbix.

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

Estadísticas de efectividad de la caché de la función de tendencia de Zabbix.
Valores de retorno: Entero (para el tamaño); Flotante (para el porcentaje).

Parámetros:

• cache - buffer;
• mode - all - solicitudes de caché totales (predeterminado);
  hits - aciertos de caché;
  phits - porcentaje de aciertos de caché;
  misses - errores de caché;
  pmisses - porcentaje de errores de caché;
  items - la cantidad de elementos almacenados en caché;
  requests - la cantidad de solicitudes almacenadas en caché;
  pitems - porcentaje de elementos almacenados en caché de elementos almacenados en caché + solicitudes. Un porcentaje bajo probablemente significa que se puede reducir el tamaño de la caché.

Comentarios:

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

zabbix[triggers]

La cantidad de iniciadores habilitados en la base de datos de Zabbix, con todos las métricas habilitadas en equipos habilitados.
Valor de retorno: Entero.

Comentarios:

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

zabbix[uptime]

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

zabbix[vcache,buffer,<mode>]

Estadísticas de disponibilidad de la caché de valores de Zabbix.
Valores de retorno: Entero (para el tamaño); Flotante (para el porcentaje).

Parámetros:

• mode - total - el tamaño total del búfer;
  free - el tamaño del búfer libre;
  pfree - el porcentaje del búfer libre;
  used - el tamaño del búfer usado;
  pused - el porcentaje del búfer usado.

Comentarios:

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

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

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

Parámetros:

• parámetro - requests - el número total de solicitudes
  hits - el número de aciertos de caché (valores históricos tomados del caché)
  misses - el número de errores de caché (historial valores 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 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 con el proxy Zabbix.

zabbix[version]

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

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

Las estadísticas de disponibilidad del caché de configuración de Zabbix.
Valores de retorno: Entero (para tamaño); Flotante (para porcentaje).

Parámetros:

• cache - búfer;
• modo - 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 de 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,<caché>,<modo>]

Las estadísticas y disponibilidad del caché de escritura de Zabbix.
Valores de retorno: Entero (para número/tamaño); Flotante (para porcentaje).

Parámetros:

• caché - values, history, index o trend;
• modo - (con values) all (predeterminado) - el número total de valores procesados por el servidor/proxy Zabbix, excepto los elementos no admitidos (contador)
  float - el número de flotantes procesados valores (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 procesados valores de registro (contador)
  text - el número de valores de texto procesados (contador)
  not supported - el número de veces que el procesamiento del elemento dio como resultado que el elemento dejara de ser compatible o mantuviera ese estado (contador)
  (con history, index, trend cache) pfree (predeterminado) - el porcentaje de buffer libre
  total - el tamaño total del buffer
  free - el tamaño de buffer libre buffer
  used - el tamaño del buffer usado
  pused - el porcentaje del buffer usado

Comentarios:

• Es obligatorio especificar <cache>. El parámetro de caché trend no es compatible con el proxy Zabbix;
• El caché del historial se utiliza para almacenar valores de métricas. Un número bajo indica problemas de rendimiento en el lado de la base de datos;
• La caché de índice histórico se utiliza para indexar los valores almacenados en la caché histórica;
• Después de llenar y borrar el caché del historial, el caché del índice del historial aún conservará 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 cambiar constantemente el tamaño de la memoria;
• El caché de tendencias almacena el agregado de la hora actual para 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.