3 Agente Zabbix (UNIX)

Descripción general

En esta sección se enumeran los parámetros admitidos por el archivo de configuración del agente Zabbix (zabbix_agentd.conf).

Los parámetros se enumeran sin información adicional. Haga clic en el parámetro para ver los detalles completos.

Todos los parámetros son opcionales a menos que se indique explícitamente que el parámetro es obligatorio.

Tenga en cuenta que:

• Los valores predeterminados reflejan los valores por defecto del demonio, no los valores en los archivos de configuración proporcionados;
• Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM;
• Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

Detalles del parámetro

Alias

Establece un alias para una clave de elemento. Se puede utilizar para sustituir una clave de elemento 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 elemento.
Los alias pueden usarse en HostMetadataItem pero no en el parámetro HostnameItem.

Ejemplo 1: Recuperar el ID del usuario 'zabbix'.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Ahora se puede utilizar la clave abreviada zabbix.userid para recuperar datos.

Ejemplo 2: Obtener la utilización de la CPU con parámetros predeterminados y personalizados.

Alias=cpu.util:system.cpu.util
       Alias=cpu.util[*]:system.cpu.util[*]

Esto permite usar la clave cpu.util para obtener el porcentaje de utilización de la CPU con parámetros predeterminados, así como usar cpu.util[all, idle, avg15] para obtener datos específicos sobre la utilización de la CPU.

Ejemplo 3: Ejecutar varias reglas de descubrimiento de bajo nivel procesando los mismos elementos de descubrimiento.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

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.

AllowKey

Permitir la ejecución de aquellas claves de ítem que coincidan con un patrón. El patrón de clave es una expresión con comodines 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.

AllowRoot

Permitir que el agente se ejecute como 'root'. Si está deshabilitado y el agente es iniciado por 'root', el agente intentará cambiar al usuario 'zabbix' en su lugar. No tiene efecto si se inicia bajo un usuario normal.

Por defecto: 0
Valores: 0 - no permitir; 1 - permitir

BufferSend

No guarde datos por más de N segundos en el búfer.

Predeterminado: 5
Rango: 1-3600

BufferSize

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.

Por defecto: 100
Rango: 2-65535

DebugLevel

Especifique el nivel de depuración:
0 - información básica sobre el inicio y la parada de procesos de Zabbix
1 - información crítica;
2 - información de error;
3 - advertencias;
4 - para depuración (produce mucha información);
5 - depuración extendida (produce aún más información).

Predeterminado: 3
Rango: 0-5

DenyKey

Deniega la ejecución de aquellas claves de ítem que coincidan con un patrón. El patrón de clave es una expresión con comodines que admite el carácter "*" para hacer coincidir cualquier cantidad de cualquier carácter.
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 el orden en que aparecen. Consulte también: Restringir comprobaciones del agente.

EnableRemoteCommands

Indica si se permiten comandos remotos desde el servidor Zabbix. Este parámetro está obsoleto, utilice AllowKey=system.run[*] o DenyKey=system.run[*] en su lugar.
Es un alias interno para los parámetros AllowKey/DenyKey dependiendo del valor:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

Por defecto: 0
Valores: 0 - no permitir, 1 - permitir

HeartbeatFrequency

La frecuencia de los mensajes de latido en segundos. Se utiliza para monitorizar la disponibilidad de las comprobaciones activas.
0: los mensajes de latido están deshabilitados.

Por defecto: 60
Rango: 0-3600

HostInterface

Un parámetro opcional que define la interfaz del host (dirección IP o nombre DNS) utilizada durante el proceso de autoregistro del host. Este valor se utilizará para rellenar la interfaz en el host recién creado y permite configurar explícitamente una dirección IP o DNS. Para más detalles, consulte Usar DNS como interfaz predeterminada.

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

HostInterfaceItem

Un parámetro opcional que define un ítem utilizado para determinar la interfaz del host (dirección IP o nombre DNS) durante el proceso de autoregistro del host. Este valor solo se utiliza si HostInterface no está definido. Para más detalles, consulte Uso de DNS como interfaz predeterminada.

Durante una solicitud de autoregistro, el agente registrará un mensaje de advertencia si el valor devuelto por el ítem especificado supera el límite de 255 caracteres.

El ítem system.run[] es compatible independientemente de la configuración de AllowKey/DenyKey.

HostMetadata

Un parámetro opcional que define los metadatos utilizados para identificar o distinguir el equipo durante el proceso de autoregistro del equipo (agente activo). HostMetadata permite distinguir entre equipos más allá del nombre de host.

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. Cuando un parámetro espera una dirección IP o un nombre DNS, los valores que sean UTF-8 válidos pero que no sean IPs o nombres DNS válidos también serán rechazados y reportados como inválidos.

Rango: 0-2034 bytes

HostMetadataItem

Un parámetro opcional que define un elemento del agente Zabbix utilizado para obtener metadatos del host. Esta opción solo se utiliza cuando no se define HostMetadata.

El valor de HostMetadataItem se recupera en cada intento de autorregistro y solo se utiliza en el proceso de autorregistro del host (agente activo). HostMetadataItem permite distinguir entre hosts más allá del nombre de host.

Se admiten parámetros de usuario y alias. El elemento system.run[] es compatible independientemente de la configuración de AllowKey/DenyKey.

Durante una solicitud de autorregistro, el agente registrará un mensaje de advertencia si el valor devuelto por el elemento especificado supera el límite de 65535 puntos de código UTF-8. El valor devuelto por el elemento debe ser una cadena UTF-8, de lo contrario será ignorado. Cuando un parámetro espera una dirección IP o un nombre DNS, los valores que sean UTF-8 válidos pero no sean IPs o nombres DNS válidos también serán rechazados e informados como no válidos.

Nombre de host

Una lista de nombres de host únicos, sensibles a mayúsculas y minúsculas, separados por comas. Obligatorio para comprobaciones activas y debe coincidir con los nombres de host 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 host, 2048 caracteres para toda la línea.

Por defecto: Establecido por HostnameItem

HostnameItem

Un parámetro opcional que define un elemento del agente Zabbix utilizado para obtener el nombre del host. Esta opción solo se utiliza cuando no se define Hostname. No se admiten parámetros de usuario ni alias, pero el elemento system.run[] es compatible independientemente de los valores de AllowKey/DenyKey.

Por defecto: system.hostname

Incluir

Puede incluir archivos individuales o todos los archivos de un directorio en el archivo de configuración. 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:

Include=/ruta/absoluta/a/archivos/de/configuración/*.conf

ListenBacklog

El número máximo de conexiones pendientes en la cola TCP.
El valor predeterminado es una constante codificada, que depende del sistema.
El valor máximo admitido depende del sistema; los valores demasiado altos pueden truncarse silenciosamente a el 'máximo especificado por la implementación'.

Predeterminado: SOMAXCONN
Rango: 0 - INT_MAX

ListenIP

Una lista de direcciones IP delimitadas por comas que el agente debe escuchar.

Predeterminado: 0.0.0.0

ListenPort

El agente escuchará en este puerto las conexiones del servidor.

Predeterminado: 10050
Rango: 1024-32767

LoadModule

El módulo que se cargará al iniciar el agente. Los módulos se utilizan para ampliar la funcionalidad del agente. El módulo debe estar ubicado en el directorio especificado por LoadModulePath o la ruta debe preceder al nombre del módulo. Si la ruta precedente es absoluta (comienza con '/') entonces se ignora LoadModulePath.
Formatos:
LoadModule=<módulo.so>
LoadModule=<ruta/módulo.so>
LoadModule=</ruta_abs/módulo.so>
Se permite incluir varios parámetros LoadModule.

LoadModulePath

La ruta completa a la ubicación de los módulos del agente. El valor predeterminado depende de las opciones de compilación.

LogFile

El nombre del archivo de registro.

Obligatorio: Sí, si LogType está configurado en archivo; De otra manera no

LogFileSize

El tamaño máximo del 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 del archivo falla, por cualquier motivo, el archivo de registro existente se trunca y empieza de nuevo.

Predeterminado: 1
Rango: 0-1024

LogRemoteCommands

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 inicia localmente mediante los parámetros HostMetadataItem, HostInterfaceItem o HostnameItem.

Por defecto: 0
Valores: 0 - deshabilitado, 1 - habilitado

LogType

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

Predeterminado: file

MaxLinesPerSecond

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 del elemento 'log' o 'logrt'.
Nota: Zabbix procesará 10 veces más nuevas líneas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en los elementos de registro.

Por defecto: 20
Rango: 1-1000

PidFile

El nombre del archivo PID.

Valor predeterminado: /tmp/zabbix_agent.pid

RefreshActiveChecks

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

Servidor

Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix y 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. Se puede usar '0.0.0.0/0' para permitir cualquier dirección IPv4. Tenga en cuenta que las "direcciones IPv6 compatibles con IPv4" (prefijo 0000::/96) son compatibles pero están obsoletas según RFC4291. Se permiten espacios.

Ejemplo:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Obligatorio: sí, si StartAgents no se establece explícitamente en 0

ServerActive

La dirección del servidor/proxy de Zabbix o la configuración de 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 de 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 comas. 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 host. 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:

ServerActive=127.0.0.1:10051

Ejemplo para múltiples servidores:

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

Ejemplo para alta disponibilidad:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

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

SourceIP

La dirección IP de origen para:

• conexiones salientes al servidor Zabbix o al proxy Zabbix;
• realizar conexiones al ejecutar algunos elementos (web.page.get, net.tcp.port, etc.).

StartAgents

El número de instancias pre-forked de zabbix_agentd que procesan comprobaciones pasivas. Si se establece en 0, las comprobaciones pasivas se deshabilitan y el agente no escuchará en ningún puerto TCP.

Por defecto: 10
Rango: 0-100

Tiempo de espera

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:

• esperar una respuesta del servidor Zabbix;
• enviar solicitudes al servidor Zabbix, incluidas las solicitudes de configuración de chequeos activos y datos de elementos;
• recuperar datos de registros a través de la monitorización de archivos de registro o del registro de eventos de Windows;
• enviar mensajes de latido;
• duración máxima para las comprobaciones vfs.*;
• ser utilizado por los módulos del agente Zabbix;
• servir como alternativa en escenarios donde un servidor o proxy anterior a la versión 7.0 envía comprobaciones sin tiempos de espera.

Por defecto: 3
Rango: 1-30

TLSAccept

Qué conexiones entrantes 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

TLSCAFile

La ruta completa del archivo que contiene los certificados de CA de nivel superior para la verificación de certificados de pares, que se utiliza para las comunicaciones cifradas entre los componentes de Zabbix.

TLSCertFile

La ruta completa del archivo que contiene el certificado del agente o la cadena de certificados utilizado para comunicaciones cifradas con componentes de Zabbix.

TLSCipherAll

La cadena de prioridad de GnuTLS o la cadena de cifrado de OpenSSL (TLS 1.2). Anula los criterios de selección de la suite de cifrado predeterminados para el cifrado basado en certificados y PSK.

Ejemplo:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherAll13

La cadena de cifrado para OpenSSL 1.1.1 o más reciente en TLS 1.3. Anula los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados y PSK.

Ejemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509

Ejemplo para OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128

TLSCipherCert

La cadena de prioridad de GnuTLS o la cadena de cifrado de OpenSSL (TLS 1.2). Anula los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados.

Ejemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509

Ejemplo para OpenSSL:

EECDH+aRSA+AES128:RSA+aRSA+AES128

TLSCipherCert13

La cadena de cifrado para OpenSSL 1.1.1 o más reciente en TLS 1.3. Anula los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en certificados.

TLSCipherPSK

La cadena de prioridad de GnuTLS o la cadena de cifrado de OpenSSL (TLS 1.2). Anula los criterios de selección de la suite de cifrado predeterminados para el cifrado basado en PSK.

Ejemplo para GnuTLS:

NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

Ejemplo para OpenSSL:

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

La cadena de cifrado para OpenSSL 1.1.1 o más reciente en TLS 1.3. Anula los criterios de selección de la suite de cifrado predeterminada para el cifrado basado en PSK.

Ejemplo:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSConnect

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); en caso contrario, no

TLSCRLFile

La ruta completa del archivo que contiene los certificados revocados. Este parámetro se utiliza para las comunicaciones cifradas entre los componentes de Zabbix.

TLSKeyFile

La ruta completa del archivo que contiene la clave privada del agente, utilizada para las comunicaciones cifradas entre los componentes de Zabbix.

TLSPSKFile

La ruta completa del archivo que contiene la clave precompartida del agente, utilizada para las comunicaciones cifradas con el servidor Zabbix.

TLSPSKIdentity

La cadena de identidad de clave previamente compartida, utilizada para comunicaciones cifradas con el servidor Zabbix.

TLSServerCertIssuer

El emisor del certificado de servidor (proxy) permitido.

TLSServerCertSubject

El asunto del certificado del servidor (proxy) permitido.

UnsafeUserParameters

Permitir que se pasen todos los caracteres en los argumentos de los parámetros definidos por el usuario. No se permiten los siguientes caracteres: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Además, no se permiten los caracteres de nueva línea.

Por defecto: 0
Valores: 0 - no permitir, 1 - permitir

User

Otorgue privilegios a un usuario específico existente en el sistema.
Solo tiene efecto si se ejecuta como 'root' y AllowRoot está deshabilitado.

Predeterminado: zabbix

UserParameter

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 un EOL. Los comandos shell pueden tener rutas relativas, si se especifica el parámetro UserParameterDir.

Ejemplo:

UserParameter=system.test,who|wc -l
       UserParameter=check_cpu,./custom_script.sh

UserParameterDir

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:

UserParameterDir=/opt/myscripts

Véase también

1. Diferencias en la configuración del agente Zabbix para comprobaciones activas y pasivas a partir de la versión 2.0.0