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 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 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,descubrimiento,nodos]

Descubre los nodos del clúster de alta disponibilidad.
Valor de retorno: objeto JSON.

Este elemento se puede utilizar en descubrimiento de bajo nivel.

zabbix[connector_queue]

The count of values enqueued in the connector queue.
Return value: Integer.

This item is supported since Zabbix 6.4.0.

zabbix[discovery_queue]

The count of network checks enqueued in the discovery queue.
Return value: Integer.

zabbix[host,,items]

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

zabbix[host,,items_unsupported]

La cantidad de elementos habilitados 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 controles en el equipo.
Valores de retorno: 0 - no disponible; 1 disponible; 2* - desconocido.

Comentarios:

• Los tipos válidos son: agent, snmp, ipmi, jmx;
• El valor de la métrica se calcula de acuerdo con los parámetros de configuración relacionados con el equipo inalcanzable/indisponible.

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 admitidas.
Valor de retorno: Entero.

zabbix[java,,<param>]

The information about Zabbix Java gateway.
Return values: 1 - if <param> is ping; Java gateway version - if <param> is version (for example: "2.0.0").

Comments:

• Valid values for param are: ping, version;
• This item can be used to check Java gateway availability using the nodata() trigger function;
• The second parameter must be empty and is reserved for future use.

zabbix[lld_queue]

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

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 puestos en cola en la cola de preprocesamiento.
Valor de retorno: Entero.

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

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

The percentage of time a particular Zabbix process or a group of processes (identified by <type> and <mode>) spent in <state>. It is calculated for the last minute only.
Return value: Float.

Parameters:

• type - for server processes: alert manager, alert syncer, alerter, availability manager, configuration syncer, connector manager, connector worker, discoverer, escalator, history poller, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector;
  for proxy processes: availability manager, configuration syncer, data sender, discoverer, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector
• mode - avg - average value for all processes of a given type (default)
  count - returns number of forks for a given process type, <state> should not be specified
  max - maximum value
  min - minimum value
  <process number> - process number (between 1 and the number of pre-forked instances). For example, if 4 trappers are running, the value is between 1 and 4.
• state - busy - process is in busy state, for example, the processing request (default); idle - process is in idle state doing nothing.

Comments:

• If <mode> is a Zabbix process number that is not running (for example, with 5 pollers running the <mode> is specified to be 6), such an item will turn unsupported;
• Minimum and maximum refers to the usage percentage for a single process. So if in a group of 3 pollers usage percentages per process were 2, 18 and 66, min would return 2 and max would return 66.
• Processes report what they are doing in shared memory and the self-monitoring process summarizes that data each second. State changes (busy/idle) are registered upon change - thus a process that becomes busy registers as such and doesn't change or update the state until it becomes idle. This ensures that even fully hung processes will be correctly registered as 100% busy.
• Currently, "busy" means "not sleeping", but in the future additional states might be introduced - waiting for locks, performing database queries, etc.
• On Linux and most other systems, resolution is 1/100 of a second.

Examples:

zabbix[process,poller,avg,busy] #the average time of poller processes spent doing something during the last minute
       zabbix[process,"icmp pinger",max,busy] #the maximum time spent doing something by any ICMP pinger process during the last minute
       zabbix[process,"history syncer",2,busy] #the time spent doing something by history syncer number 2 during the last minute
       zabbix[process,trapper,count] #the amount of currently running trapper processes

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

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

Parámetros:

• name - el nombre del proxy;
• param - delay - cuánto tiempo permanecen sin enviarse los valores recopilados, calculado como "retraso de proxy" (diferencia entre la hora actual del proxy y la marca de tiempo del valor no enviado más antiguo en el proxy) + ("hora actual del servidor" - "último acceso proxy").

zabbix[proxy,discovery]

The list of Zabbix proxies with name, mode, encryption, compression, version, last seen, host count, item count, required values per second (vps) and version status (current/outdated/unsupported).
Return value: JSON object.

zabbix[proxy group,<name>,available]

The number of online proxies in a proxy group.
Return value: Integer.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,pavailable]

The percentage of online proxies in a proxy group.
Return value: Float.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,proxies]

The list of Zabbix proxies in a proxy group with name, mode, encryption, compression, version, last seen, host count, item count, required values per second (vps), version status (current/outdated/unsupported), timeouts, proxy group name, state (unknown/offline/online).
Return value: JSON.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,state]

The state of a proxy group.
Return value: 0 - unknown; 1 - offline; 2 - recovering; 3 - online; 4 - degrading.

Parameters:

• name - the proxy group name.

zabbix[proxy group,discovery]

Returns a list of proxy groups with configuration data and real-time data. Configuration data include the proxy group name, failover delay, and the minimum number of online proxies required. Real-time data include the proxy group state (see comments for details), the number of online proxies, and the percentage of online proxies.
Return value: JSON.

Comments:

• This item does not return groupless proxies;
• If there is an invalid value for "failover_delay" or "min_online", then a special value -1 is reported to indicate that. Invalid values might occur if macros are used for configuration and the macros cannot be expanded to a valid value.
• The proxy group state is reported as an integer: 0 - unknown; 1 - offline; 2 - recovering; 3 - online; 4 - degrading;

Example of return values:

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

The proxy memory buffer usage statistics.
Return values: Integer (for size); Float (for percentage).

Parameters:

• mode:
  total - the total size of buffer (can be used to check if memory buffer is enabled)
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

Comments: - Returns a 'Proxy memory buffer is disabled' error when the memory buffer is disabled;
- This item is not supported on Zabbix server.

zabbix[proxy_buffer,state,changes]

Returns the number of state changes between disk/memory buffer modes since start.
Return values: Integer; 0 - the memory buffer is disabled.

Comments:

• Frequent state changes indicate that either the memory buffer size or age must be increased;
• If the memory buffer state is monitored infrequently (for example, once a minute) then the buffer might flip its state without it being registered.

zabbix[proxy_buffer,state,current]

Returns the current working state where the new data are being stored.
Return values: 0 - disk; 1 - memory.

"0" is also returned when the memory buffer is disabled.

zabbix[proxy_history]

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

Este elemento no es compatible con el servidor Zabbix.

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

The number of monitored items in the queue which are delayed at least by <from> seconds, but less than <to> seconds.
Return value: Integer.

Parameters:

• from - default: 6 seconds;
• to - default: infinity.

Time-unit symbols (s,m,h,d,w) are supported in the parameters.

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 esperados por segundo.
Valor de retorno: Flotador.

Se correlaciona aproximadamente 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,<from>,<to>]

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);
• 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' 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>]

Las estadísticas de efectividad del caché de la función de tendencias de Zabbix.
Valores de retorno: Entero (para tamaño); Flotador (para porcentaje).

Parámetros:

• caché - búfer;
• modo - todos - total de solicitudes de caché (predeterminado)
  hits - aciertos de caché
  phits - porcentaje de aciertos de caché
  misses - errores de caché
  * pmisses* - porcentaje de errores de caché
  items - el número de elementos almacenados en caché
  solicitudes - el número de solicitudes almacenadas en caché
  pitems - porcentaje de elementos almacenados en caché de elementos almacenados en caché + solicitudes. Lo más probable es que un porcentaje bajo signifique que se puede reducir el tamaño de la caché.

Este elemento 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.

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

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

Parámetro:

• 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

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

zabbix[vcache,cache,<parameter>]

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:

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

The version of Zabbix server or proxy.
Return value: String. For example: 6.0.0beta1.

zabbix[vmware,buffer,<modo>]

Las estadísticas de disponibilidad del caché de vmware de Zabbix.
Valores de retorno: Entero (para tamaño); Flotador (para porcentaje).

Parámetros:

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

The total number of history values written to database.
Return value: Integer.

zabbix[wcache,<cache>,<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:

• cache - values, history, index o trend;
• modo - (con valores) 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)
  texto - el número de valores de texto procesados (contador)
  no admitido - 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 historial, índice, tendencia caché) 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.
• La caché del historial se utiliza para almacenar valores de elementos. 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;
• La caché de tendencias almacena el agregado de la hora actual para todos los elementos 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.