El agente Zabbix 2 es una nueva generación del agente Zabbix y puede utilizarse en lugar del agente Zabbix.
En esta sección se enumeran los parámetros admitidos por el archivo de configuración del agente Zabbix 2 (zabbix_agent2.conf).
Los parámetros se enumeran sin información adicional. Haga clic en el parámetro para ver los detalles completos.
Parámetro | Descripción |
---|---|
Alias | Establece un alias para una clave de métrica. |
AllowKey | Permite la ejecución de aquellas claves de métrica que coincidan con un patrón. |
BufferSend | No mantener los datos en el búfer más de N segundos. |
BufferSize | El número máximo de valores en el búfer de memoria. |
ControlSocket | El socket de control, utilizado para enviar comandos en tiempo de ejecución con la opción '-R'. |
DebugLevel | El nivel de depuración. |
DenyKey | Deniega la ejecución de aquellas claves de métrica que coincidan con un patrón. |
EnablePersistentBuffer | Habilita el uso de almacenamiento persistente local para métricas activas. |
ForceActiveChecksOnStart | Realiza comprobaciones activas inmediatamente después del reinicio para la primera configuración recibida. |
HeartbeatFrequency | La frecuencia de los mensajes de latido en segundos. |
HostInterface | Un parámetro opcional que define la interfaz del equipo. |
HostInterfaceItem | Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo. |
HostMetadata | Un parámetro opcional que define los metadatos del equipo. |
HostMetadataItem | Un parámetro opcional que define una métrica del agente Zabbix utilizada para obtener los metadatos del equipo. |
Hostname | Un parámetro opcional que define el nombre del equipo. |
HostnameItem | Un parámetro opcional que define una métrica del agente Zabbix utilizada para obtener el nombre del equipo. |
Include | Puede incluir archivos individuales o todos los archivos de un directorio en el archivo de configuración. |
ListenIP | Una lista de direcciones IP separadas por comas en las que el agente debe escuchar. |
ListenPort | El agente escuchará en este puerto las conexiones desde el servidor. |
LogFile | El nombre del archivo de registro. |
LogFileSize | El tamaño máximo del archivo de registro. |
LogType | El tipo de salida del registro. |
PersistentBufferFile | El archivo donde el agente Zabbix 2 debe mantener la base de datos SQLite. |
PersistentBufferPeriod | El período de tiempo durante el cual se deben almacenar los datos cuando no hay conexión con el servidor o proxy. |
PidFile | El nombre del archivo PID. |
Plugins.<PluginName>.System.Capacity | El límite de comprobaciones por plugin que se pueden ejecutar al mismo tiempo. |
Plugins.Log.MaxLinesPerSecond | El número máximo de nuevas líneas que el agente enviará por segundo al servidor o proxy Zabbix al procesar comprobaciones activas 'log' y 'logrt'. |
Plugins.SystemRun.LogRemoteCommands | Habilita el registro de los comandos de shell ejecutados como advertencias. |
PluginSocket | La ruta al socket UNIX para comunicaciones de plugin cargables. |
PluginTimeout | El tiempo de espera para conexiones con plugins cargables, en segundos. |
RefreshActiveChecks | Con qué frecuencia se actualiza la lista de comprobaciones activas. |
Server | Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix y proxies Zabbix. |
ServerActive | La dirección del servidor/proxy Zabbix o configuración de clúster desde la que obtener comprobaciones activas. |
SourceIP | La dirección IP de origen. |
StatusPort | Si se establece, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<port>/status). |
Timeout | Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con el proxy o servidor Zabbix. |
TLSAccept | Qué conexiones entrantes aceptar. |
TLSCAFile | La ruta completa de un archivo que contiene los certificados de CA de nivel superior para la verificación de certificados de pares, utilizado para comunicaciones cifradas entre componentes de Zabbix. |
TLSCertFile | La ruta completa de un archivo que contiene el certificado del agente o la cadena de certificados, utilizado para comunicaciones cifradas entre componentes de Zabbix. |
TLSCipherAll | La cadena de cifrado OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificado y PSK. |
TLSCipherAll13 | La cadena de cifrado OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o superior. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificado y PSK. |
TLSCipherCert | La cadena de cifrado OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificado. |
TLSCipherCert13 | La cadena de cifrado OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o superior. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificado. |
TLSCipherPSK | La cadena de cifrado OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en PSK. |
TLSCipherPSK13 | La cadena de cifrado OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o superior. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en PSK. |
TLSConnect | Cómo debe conectarse el agente al servidor o proxy Zabbix. |
TLSCRLFile | La ruta completa de un archivo que contiene certificados revocados. Este parámetro se utiliza para comunicaciones cifradas entre componentes de Zabbix. |
TLSKeyFile | La ruta completa de un archivo que contiene la clave privada del agente, utilizada para comunicaciones cifradas entre componentes de Zabbix. |
TLSPSKFile | La ruta completa de un archivo que contiene la clave precompartida del agente, utilizada para comunicaciones cifradas con el servidor Zabbix. |
TLSPSKIdentity | La cadena de identidad de la clave precompartida, utilizada para comunicaciones cifradas con el servidor Zabbix. |
TLSServerCertIssuer | El emisor de certificado de servidor (proxy) permitido. |
TLSServerCertSubject | El sujeto de certificado de servidor (proxy) permitido. |
UnsafeUserParameters | Permite que se pasen todos los caracteres en los argumentos a los parámetros definidos por el usuario. |
UserParameter | Un parámetro definido por el usuario para monitorizar. |
UserParameterDir | La ruta de búsqueda predeterminada para los comandos UserParameter. |
Todos los parámetros son opcionales a menos que se indique explícitamente que el parámetro es obligatorio.
Tenga en cuenta que:
Establece un alias para una clave de métrica. Puede usarse para sustituir una clave de métrica larga y compleja por una más corta y sencilla.
Pueden estar presentes múltiples parámetros Alias. No se permiten múltiples parámetros con la misma clave Alias.
Diferentes claves Alias pueden hacer referencia a la misma clave de métrica.
Los alias pueden usarse en HostMetadataItem pero no en el parámetro HostnameItem.
Ejemplo 1: Recuperar el ID del usuario 'zabbix'.
Ahora se puede usar la clave abreviada zabbix.userid para recuperar datos.
Ejemplo 2: Obtener la utilización de CPU con parámetros por defecto y personalizados.
Esto permite usar la clave cpu.util para obtener el porcentaje de utilización de CPU con parámetros por defecto, así como usar cpu.util[all, idle, avg15] para obtener datos específicos sobre la utilización de CPU.
Ejemplo 3: Ejecutar múltiples reglas de descubrimiento de bajo nivel procesando los mismos elementos de descubrimiento.
Ahora es posible configurar varias reglas de descubrimiento usando vfs.fs.discovery con diferentes parámetros para cada regla, por ejemplo, vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc.
Permitir la ejecución de aquellas métricas cuyas claves coincidan con un patrón. El patrón de clave es una expresión comodín que admite el carácter "*" para hacer coincidir cualquier número de cualquier carácter.
Se pueden definir múltiples reglas de coincidencia de claves en combinación con DenyKey. Los parámetros se procesan uno por uno según su orden de aparición. Consulte también: Restringir comprobaciones del agente.
El intervalo de tiempo en segundos que determina con qué frecuencia se envían los valores desde el búfer al servidor Zabbix. Tenga en cuenta que si el búfer está lleno, los datos se enviarán antes.
Por defecto: 5
Rango: 1-3600
El número máximo de valores en el búfer de memoria. El agente enviará todos los datos recopilados al servidor o proxy de Zabbix si el búfer está lleno. Este parámetro solo debe usarse si el búfer persistente está deshabilitado (EnablePersistentBuffer=0).
Por defecto: 1000
Rango: 2-65535
El socket de control, utilizado para enviar comandos en tiempo de ejecución con la opción '-R'.
Por defecto: /tmp/agent.sock
Especifica el nivel de depuración:
0 - información básica sobre el inicio y la detención de los procesos de Zabbix
1 - información crítica;
2 - información de errores;
3 - advertencias;
4 - para depuración (genera mucha información);
5 - depuración extendida (genera aún más información).
Por defecto: 3
Rango: 0-5
Deniega la ejecución de aquellas métricas cuyas claves coincidan con un patrón. El patrón de clave es una expresión comodín que admite el carácter "*" para coincidir con cualquier número de caracteres.
Se pueden definir múltiples reglas de coincidencia de claves en combinación con AllowKey. Los parámetros se procesan uno por uno según su orden de aparición. Véase también: Restringir comprobaciones del agente.
Habilita el uso de almacenamiento persistente local para métricas activas. Si el almacenamiento persistente está deshabilitado, se utilizará el búfer de memoria.
Por defecto: 0
Valores: 0 - deshabilitado, 1 - habilitado
Realiza comprobaciones activas inmediatamente después del reinicio para la primera configuración recibida. También está disponible como un parámetro de configuración por plugin, por ejemplo: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Por defecto: 0
Valores: 0 - deshabilitado, 1 - habilitado
La frecuencia de los mensajes de latido en segundos. Se utiliza para monitorizar la disponibilidad de comprobaciones activas.
0 - mensajes de latido deshabilitados.
Por defecto: 60
Rango: 0-3600
Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de autoregistro del equipo. Si no se define, el valor se obtendrá de HostInterfaceItem.
El agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres.
Rango: 0-255 caracteres
Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo.
La interfaz del equipo se utiliza en el proceso de autoregistro del equipo. Esta opción solo se utiliza cuando HostInterface no está definido.
La métrica system.run[] es compatible independientemente de los valores AllowKey/DenyKey.
Durante una solicitud de autoregistro, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.
Un parámetro opcional que define los metadatos del equipo. Los metadatos del equipo se utilizan solo en el proceso de autorregistro del equipo. Si no se define, el valor se obtendrá de HostMetadataItem.
El agente generará un error y no se iniciará si el valor especificado supera el límite de 2034 bytes o es una cadena que no es UTF-8.
Rango: 0-2034 bytes
Un parámetro opcional que define una métrica utilizada para obtener los metadatos del equipo. Esta opción solo se utiliza cuando HostMetadata no está definido. Se admiten parámetros de usuario y alias. La métrica system.run[] es compatible independientemente de los valores AllowKey/DenyKey.
El valor de HostMetadataItem se recupera en cada intento de autorregistro y solo se utiliza durante el proceso de autorregistro del equipo.
Durante una solicitud de autorregistro, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 65535 puntos de código UTF-8. El valor devuelto por la métrica debe ser una cadena UTF-8, de lo contrario será ignorado.
Una lista de nombres de equipo únicos, sensibles a mayúsculas y minúsculas, separados por comas. Requerido para comprobaciones activas y debe coincidir con los nombres de equipo configurados en el servidor. El valor se obtiene de HostnameItem si no está definido.
Caracteres permitidos: alfanuméricos, '.', ' ', '_' y '-'. Longitud máxima: 128 caracteres por nombre de equipo, 2048 caracteres para toda la línea.
Por defecto: Establecido por HostnameItem
Un parámetro opcional que define una métrica utilizada para obtener el nombre del equipo. Esta opción solo se utiliza cuando Hostname no está definido. No se admiten parámetros de usuario ni alias, pero la métrica system.run[] es compatible independientemente de los valores de AllowKey/DenyKey.
Por defecto: system.hostname
Puede incluir archivos individuales o todos los archivos de un directorio en el archivo de configuración. Durante la instalación, Zabbix creará el directorio de inclusión en /usr/local/etc, a menos que se modifique durante la compilación. La ruta puede ser relativa a la ubicación del archivo zabbix_agent2.conf.
Para incluir solo los archivos relevantes en el directorio especificado, se admite el carácter comodín asterisco para la coincidencia de patrones.
Consulte las notas especiales sobre las limitaciones.
Ejemplo:
Una lista de direcciones IP separadas por comas en las que el agente debe escuchar. La primera dirección IP se envía al servidor Zabbix, si se conecta a él, para recuperar la lista de comprobaciones activas.
Por defecto: 0.0.0.0
El agente escuchará en este puerto las conexiones desde el servidor.
Por defecto: 10050
Rango: 1024-32767
El nombre del archivo de registro.
Por defecto: /tmp/zabbix_agent2.log
Obligatorio: Sí, si LogType está configurado como file; de lo contrario, no
El tamaño máximo de un archivo de registro en MB.
0 - deshabilita la rotación automática de registros.
Nota: Si se alcanza el límite de tamaño del archivo de registro y la rotación de archivos falla, por cualquier motivo, el archivo de registro existente se trunca y se inicia de nuevo.
Por defecto: 1
Rango: 0-1024
El tipo de salida del registro:
file - escribe el registro en el archivo especificado por el parámetro LogFile;
system - escribe el registro en syslog;
console - escribe el registro en la salida estándar
Por defecto: file
El archivo donde el agente Zabbix 2 debe mantener la base de datos SQLite. Debe ser un nombre de archivo completo. Este parámetro solo se utiliza si el búfer persistente está habilitado (EnablePersistentBuffer=1).
El período de tiempo durante el cual los datos deben almacenarse cuando no hay conexión con el servidor o proxy. Los datos más antiguos se perderán. Los datos de registro se conservarán. Este parámetro solo se utiliza si el búfer persistente está habilitado (EnablePersistentBuffer=1).
Por defecto: 1h
Rango: 1m-365d
El nombre del archivo PID.
Por defecto: /tmp/zabbix_agent2.pid
El límite de comprobaciones por plugin <PluginName>
que se pueden ejecutar al mismo tiempo.
Por defecto: 1000
Rango: 1-1000
El número máximo de nuevas líneas que el agente enviará por segundo al servidor o proxy de Zabbix al procesar comprobaciones activas 'log' y 'logrt'. El valor proporcionado será sobrescrito por el parámetro 'maxlines', proporcionado en la clave de la métrica 'log' y 'logrt'.
Nota: Zabbix procesará 10 veces más nuevas líneas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en las métricas de log.
Por defecto: 20
Rango: 1-1000
Habilita el registro de los comandos de shell ejecutados como advertencias. Los comandos solo se registrarán si se ejecutan de forma remota. No se crearán entradas de registro si system.run[] se lanza localmente mediante los parámetros HostMetadataItem, HostInterfaceItem o HostnameItem.
Por defecto: 0
Valores: 0 - deshabilitado, 1 - habilitado
La ruta al socket UNIX para las comunicaciones de plugin cargables.
Por defecto: /tmp/agent.plugin.sock
El tiempo de espera para las conexiones con plugins cargables, en segundos.
Por defecto: Timeout
Rango: 1-30
Con qué frecuencia se actualiza la lista de comprobaciones activas, en segundos. Tenga en cuenta que, después de no poder actualizar las comprobaciones activas, el siguiente intento de actualización se realizará en 60 segundos.
Por defecto: 5
Rango: 1-86400
Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix o proxies Zabbix. Solo se aceptarán conexiones entrantes de los equipos listados aquí. Si el soporte para IPv6 está habilitado, entonces '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' se tratan por igual y '::/0' permitirá cualquier dirección IPv4 o IPv6. '0.0.0.0/0' puede usarse para permitir cualquier dirección IPv4. Se permiten espacios. Si este parámetro no se especifica, deshabilita las comprobaciones pasivas y el agente no escuchará en ningún puerto TCP.
Ejemplo:
La dirección del servidor/proxy de Zabbix o la configuración del clúster desde la que obtener comprobaciones activas. La dirección del servidor/proxy es una dirección IP o un nombre DNS y un puerto opcional separado por dos puntos.
La configuración del clúster es una o más direcciones de servidor separadas por punto y coma. Se pueden especificar varios servidores/clústeres de Zabbix y proxies de Zabbix, separados por coma. No se debe especificar más de un proxy de Zabbix desde cada servidor/clúster de Zabbix. Si se especifica un proxy de Zabbix, entonces no se debe especificar el servidor/clúster de Zabbix para ese proxy.
Se pueden proporcionar varias direcciones separadas por comas para utilizar varios servidores de Zabbix independientes en paralelo. Se permiten espacios.
Si no se especifica el puerto, se utiliza el puerto por defecto.
Las direcciones IPv6 deben ir entre corchetes si se especifica el puerto para ese equipo. Si no se especifica el puerto, los corchetes para las direcciones IPv6 son opcionales.
Si este parámetro no se especifica, las comprobaciones activas están deshabilitadas.
Ejemplo para proxy de Zabbix:
Ejemplo para múltiples servidores:
Ejemplo para alta disponibilidad:
Ejemplo para alta disponibilidad con dos clústeres y un servidor:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
La dirección IP de origen para:
Si se establece, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<puerto>/status).
Rango: 1024-32767
Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con el proxy o servidor Zabbix.
Este parámetro define la duración de varias operaciones, incluyendo:
vfs.*
;Por defecto: 3
Rango: 1-30
Las conexiones entrantes a aceptar. Se utiliza para comprobaciones pasivas. Se pueden especificar varios valores, separados por comas:
unencrypted - aceptar conexiones sin cifrado (por defecto)
psk - aceptar conexiones con TLS y una clave precompartida (PSK)
cert - aceptar conexiones con TLS y un certificado
Obligatorio: sí, si se definen parámetros de certificado TLS o PSK (incluso para conexiones unencrypted); en caso contrario, no
La ruta completa del archivo que contiene los certificados de la(s) CA(s) raíz para la verificación del certificado del par, utilizado para comunicaciones cifradas entre los componentes de Zabbix.
La ruta completa del archivo que contiene el certificado del agente o la cadena de certificados, utilizada para comunicaciones cifradas con los componentes de Zabbix.
La cadena de cifrado de OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados y PSK.
Ejemplo:
La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o más reciente. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados y PSK.
Ejemplo:
La cadena de cifrado de OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados.
Ejemplo:
Tenga en cuenta que este parámetro no puede usarse junto con TLSAccept=cert,psk
; para la conexión por certificado (TLSConnect=cert
) utilice TLSCipherAll en su lugar.
La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o superior. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados.
Tenga en cuenta que este parámetro no puede usarse junto con TLSAccept=cert,psk
; para la conexión por certificado (TLSConnect=cert
) utilice TLSCipherAll13 en su lugar.
La cadena de cifrado de OpenSSL (TLS 1.2). Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en PSK.
Ejemplo:
La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o superior. Sobrescribe los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en PSK.
Ejemplo:
Cómo debe conectarse el agente al servidor o proxy de Zabbix. Se utiliza para comprobaciones activas. Solo se puede especificar un valor:
unencrypted - conectarse sin cifrado (por defecto)
psk - conectarse usando TLS y una clave precompartida (PSK)
cert - conectarse usando TLS y un certificado
Obligatorio: sí, si se definen parámetros de certificado TLS o PSK (incluso para la conexión unencrypted); de lo contrario, no
La ruta completa del archivo que contiene los certificados revocados. Este parámetro se utiliza para las comunicaciones cifradas entre los componentes de Zabbix.
La ruta completa del archivo que contiene la clave privada del agente, utilizada para comunicaciones cifradas entre los componentes de Zabbix.
La ruta completa del archivo que contiene la clave precompartida del agente, utilizada para comunicaciones cifradas con el servidor Zabbix.
La cadena de identidad de clave precompartida, utilizada para comunicaciones cifradas con el servidor Zabbix.
El emisor permitido del certificado del servidor (proxy).
El sujeto permitido del certificado del servidor (proxy).
Permitir que se pasen todos los caracteres en los argumentos a los parámetros definidos por el usuario. No se permiten los siguientes caracteres: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Además, no se permiten caracteres de nueva línea.
Por defecto: 0
Valores: 0 - no permitir, 1 - permitir
Un parámetro definido por el usuario para monitorizar. Puede haber varios parámetros definidos por el usuario.
Formato: UserParameter=<clave>,<comando shell>
Tenga en cuenta que el comando shell no debe devolver una cadena vacía o solo EOL. Los comandos shell pueden tener rutas relativas, si se especifica el parámetro UserParameterDir.
Ejemplo:
La ruta de búsqueda predeterminada para los comandos UserParameter. Si se utiliza, el agente cambiará su directorio de trabajo al especificado aquí antes de ejecutar un comando. De este modo, los comandos UserParameter pueden tener un prefijo relativo ./
en lugar de una ruta completa.
Solo se permite una entrada.
Ejemplo: