Documentation
Table of Contents
3 Agente Zabbix (UNIX)
Descripción general
Esta sección enumera los parámetros admitidos en el archivo de configuración del agente Zabbix (zabbix_agentd.conf).
Tenga en cuenta que:
- Los valores predeterminados reflejan los valores predeterminados del demonio, no los valores de los archivos de configuración enviados;
- Zabbix admite archivos de configuración solo en codificación UTF-8 sin BOM;
- Los comentarios que empiezan por "#" sólo se admiten al principio de la línea.
Parámetros
| Parámetro | Obligatorio | Rango | Predeterminado | Descripción |
|---|---|---|---|---|
| Alias | no | Establece un alias para una clave de métrica. Se puede utilizar para sustituir una clave de métrica larga y compleja por una más pequeña y sencilla. Pueden estar presentes varios parámetros Alias. Se permiten varios parámetros con la misma clave Alias. Diferentes claves Alias pueden hacer referencia a la misma clave de métrica. Los alias se pueden usar en HostMetadataItem pero no en los parámetros HostnameItem. Ejemplos: 1. Recuperando el ID del usuario 'zabbix'. Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",, ,,\1] Ahora se puede usar la tecla abreviada zabbix.userid para recuperar datos. 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. 3. Ejecución de varias reglas de descubrimiento de bajo nivel que procesan 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 [barra], etc. |
||
| AllowKey | no | Permite la ejecución de aquellas claves de métricas que coincidan con un patrón. El patrón de clave es una expresión comodín que admite el carácter "*" para que coincida con cualquier número de caracteres. Se pueden definir varias reglas de coincidencia de clave en combinación con DenyKey. Los parámetros se procesan uno por uno según su orden de aparición. Este parámetro es compatible desde Zabbix 5.0.0. Consulte también: Restricción de comprobaciones de agentes. |
||
| AllowRoot | no | 0 | Permite 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 con un usuario normal. 0 - no permitir 1 - permitir |
|
| BufferSend | no | 1-3600 | 5 | No mantener los datos más de N segundos en el búfer. |
| BufferSize | no | 2-65535 | 100 | Número máximo de valores en un búfer de memoria. El agente enviará todos los datos recopilados al servidor Zabbix o proxy si el búfer está lleno. |
| DebugLevel | no | 0-5 | 3 | 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 error 3 - advertencias 4 - para depuración (produce mucha información) 5 - depuración extendida (produce aún más información) |
| DenyKey | no | Denegar la ejecución de aquellas claves de elementos que coincidan con un patrón. El patrón de clave es una expresión comodín que admite el carácter "*" para que coincida con cualquier número de caracteres. Se pueden definir varias reglas de coincidencia de clave en combinación con AllowKey. Los parámetros se procesan uno por uno según su orden de aparición. Este parámetro es compatible desde Zabbix 5.0.0. Consulte también: Restricción de comprobaciones de agentes. |
||
| EnableRemoteCommands | no | 0 | Si se permiten los comandos remotos del servidor Zabbix. Este parámetro está obsoleto, use 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[*] |
|
| HostInterface | no | 0-255 caracteres | Parámetro opcional que define la interfaz del host. La interfaz del host se usa en el proceso autoregistration del host. Un agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres. Si no se define, el valor se obtendrá de HostInterfaceItem. Compatible desde Zabbix 4.4.0. |
|
| HostInterfaceItem | no | Parámetro opcional que define un elemento que se usa para obtener la interfaz del host. La interfaz del host se usa en el proceso autoregistration del host. Durante una solicitud de registro automático, un agente registrará una advertencia mensaje si el valor devuelto por el elemento especificado supera el límite de 255 caracteres. Esta opción solo se usa cuando HostInterface no está definido. Compatible desde Zabbix 4.4.0. |
||
| HostMetadata | no | 0-255 caracteres | Parámetro opcional que define los metadatos del host. Los metadatos del host se utilizan solo en el proceso de registro automático del host (agente activo). Si no se define, el valor se obtendrá de HostMetadataItem. Un agente emitirá un error y no se iniciará si el valor especificado supera el límite o una cadena no UTF-8. |
|
| HostMetadataItem | no | Parámetro opcional que define un elemento Zabbix agent utilizado para obtener metadatos del host. Esta opción solo se usa cuando HostMetadata no está definido. Admite parámetros de usuario y alias. Admite system.run[] independientemente de los valores de AllowKey/DenyKey. El valor de HostMetadataItem se recupera en cada intento de registro automático y se utiliza para solo en el proceso de registro automático del host (agente activo). Durante una solicitud de registro automático, un agente registrará un mensaje de advertencia si el valor devuelto por el elemento especificado supera el límite de 255 caracteres. El valor devuelto por el elemento debe ser una cadena UTF-8; de lo contrario, se ignorará. |
||
| Hostname | no | Establecido por HostnameItem | Lista de nombres de host exclusivos, separados por comas y sensibles a mayúsculas y minúsculas. Requerido para comprobaciones activas y debe coincidir con los nombres de host configurados en el servidor. El valor se adquiere 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. |
|
| HostnameItem | no | system.hostname | Parámetro opcional que define un elemento Zabbix agent utilizado para obtener el nombre del host. Esta opción solo se usa cuando el nombre de host no está definido. No admite parámetros de usuario ni alias, pero admite system.run[] independientemente de los valores de AllowKey/DenyKey. La longitud de salida está limitada a 512 KB . |
|
| Include | no | Puede incluir archivos individuales o todos los archivos en un directorio en el archivo de configuración. Para incluir solo archivos relevantes en el directorio especificado, se admite el carácter comodín de asterisco para la coincidencia de patrones. Por ejemplo: /absolute/path/to/config/files/*.conf.Consulte notas especiales acerca de las limitaciones. |
||
| ListenBacklog | no | 0 - INT_MAX | SOMAXCONN | El número máximo de conexiones pendientes en la cola de TCP. El valor predeterminado es una constante codificada, que depende del sistema. El valor máximo admitido depende de el sistema, los valores demasiado altos pueden truncarse silenciosamente al 'máximo especificado por la implementación'. |
| ListenIP | no | 0.0.0.0 | Lista de direcciones IP delimitadas por comas en las que el agente debe escuchar. Se admiten varias direcciones IP en la versión 1.8.3 y posteriores. |
|
| ListenPort | no | 1024-32767 | 10050 | El agente escuchará en este puerto las conexiones del servidor. |
| LoadModule | no | Módulo a cargar al inicio del agente. Los módulos se utilizan para ampliar la funcionalidad del agente. Formatos: LoadModule=<module.so> LoadModule=<path/module.so> LoadModule=</abs_path/module. so> 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 anterior es absoluta (comienza con '/'), se ignora LoadModulePath. Se permite incluir varios parámetros de LoadModule. |
||
| LoadModulePath | no | Ruta completa a la ubicación de los módulos del agente. El valor predeterminado depende de las opciones de compilación. |
||
| LogFile | sí, si LogType está establecido en archivo, de lo contrario no |
Nombre del archivo de registro. | ||
| LogFileSize | no | 0-1024 | 1 | Tamaño máximo del archivo de registro en MB. 0: deshabilite la rotación automática de registros. Nota: si se alcanza el límite de tamaño del archivo de registro y falla la rotación de archivos, por cualquiera que sea el motivo, el archivo de registro existente se trunca y se inicia de nuevo. |
| LogType | no | archivo | Tipo de salida de registro: archivo: escribe el registro en el archivo especificado por el parámetro LogFile, sistema: escribe el registro en syslog, consola: escribe el registro en la salida estándar.<br >Este parámetro es compatible desde Zabbix 3.0.0. |
|
| LogRemoteCommands | no | 0 | Habilite el registro de los comandos de shell ejecutados como advertencias. 0: deshabilitado 1: habilitado Los comandos se registrarán solo 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. |
|
| MaxLinesPerSecond | no | 1-1000 | 20 | Número máximo de líneas nuevas que el agente enviará por segundo al servidor de Zabbix o al proxy al procesar comprobaciones activas de 'registro' y 'registro de eventos'. El valor proporcionado será anulado por el parámetro 'maxlines', proporcionado en la clave de elemento 'log' o 'eventlog'. Nota: Zabbix procesará 10 veces más líneas nuevas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en los elementos de registro. |
| PidFile | no | /tmp/zabbix_agentd.pid | Nombre del archivo PID. | |
| RefreshActiveChecks | no | 60-3600 | 120 | 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, la próxima actualización se intentará después de 60 segundos. |
| Server | sí, si StartAgents no se establece explícitamente en 0 | Lista de direcciones IP delimitadas por comas, opcionalmente en notación CIDR, o nombres de host de servidores Zabbix y proxies Zabbix. Las conexiones entrantes se aceptarán solo desde los hosts enumerados aquí. Si la compatibilidad con IPv6 está habilitada, 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 por RFC4291. Ejemplo: Servidor=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.dominio Se permiten espacios. |
||
| ServerActive | no | Servidor Zabbix/dirección proxy o configuración de clúster para obtener comprobaciones activas. La dirección del servidor/proxy es la dirección IP o el nombre DNS y el puerto opcional separados por dos puntos. La configuración del clúster es una o más direcciones de servidor ses separados 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 para cada servidor/clúster de Zabbix. Si el proxy de Zabbix es especificado, entonces no se debe especificar el servidor/clúster Zabbix para ese proxy. Se pueden proporcionar múltiples direcciones delimitadas por comas para usar varios servidores Zabbix independientes en paralelo. Se permiten espacios. Si no se especifica el puerto, se utiliza el puerto predeterminado. Las direcciones IPv6 deben estar entre corchetes si se especifica el puerto para ese equipo. Si no se especifica el puerto, se utilizan corchetes para IPv6 las direcciones son opcionales. Si no se especifica este parámetro, las comprobaciones activas están deshabilitadas. Ejemplo para el proxy Zabbix: ServerActive=127.0.0.1:10051 Ejemplo para varios servidores: ServerActive= 127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1] Ejemplo de alta disponibilidad: ServerActive=zabbix.cluster.node1 ;zabbix.cluster.node2:20051;zabbix.cluster.node3 Ejemplo de alta disponibilidad con dos clústeres y un servidor: ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2 .nodo1;zabbix.cluster2.nodo2,zabbix.dominio |
||
| SourceIP | no | Dirección IP de origen para: - conexiones salientes al servidor Zabbix o al proxy Zabbix; - establecer conexiones mientras se ejecutan algunos elementos (web.page.get, net.tcp.port, etc.) |
||
| StartAgents | no | 0-100 | 3 | Número de instancias previamente bifurcadas de zabbix_agentd que procesan comprobaciones pasivas. Si se establece en 0, desactiva las comprobaciones pasivas y el agente no escuchará en ningún puerto TCP. |
| Timeout | no | 1-30 | 3 | No gaste más de Timeout segundos en el procesamiento. |
| TLSAccept | sí, si el certificado TLS o los parámetros PSK están definidos (incluso para conexiones sin cifrar), de lo contrario, no | Qué conexiones entrantes aceptar. Se utiliza para controles pasivos. Se pueden especificar varios valores, separados por comas: sin cifrar: acepta conexiones sin cifrar (predeterminado) psk: acepta conexiones con TLS y una clave precompartida (PSK) cert - aceptar conexiones con TLS y un certificado Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSCAFile | no | Nombre de ruta completo de un archivo que contiene los certificados de CA(s) de nivel superior para la verificación de certificados de pares, que se utiliza para las comunicaciones cifradas entre los componentes de Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSCertFile | no | Nombre de ruta completo de un archivo que contiene el certificado del agente o la cadena de certificados, que se utiliza para las comunicaciones cifradas con los componentes de Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSCipherAll | no | Cadena de prioridad GnuTLS o cadena de cifrado OpenSSL (TLS 1.2). Anule los criterios de selección de conjuntos 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 Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSCipherAll13 | no | Cadena de cifrado para OpenSSL 1.1.1 o posterior en TLS 1.3. Anule los criterios de selección predeterminados del conjunto de cifrado 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 Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSCipherCert | no | Cadena de prioridad GnuTLS o cadena de cifrado OpenSSL (TLS 1.2). Anule los criterios de selección de conjuntos de cifrado predeterminados 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<br >Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSCipherCert13 | no | Cadena de cifrado para OpenSSL 1.1.1 o posterior en TLS 1.3. Anule los criterios de selección de conjuntos de cifrado predeterminados para el cifrado basado en certificados. Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSCipherPSK | no | Cadena de prioridad GnuTLS o cadena de cifrado OpenSSL (TLS 1.2). Anule los criterios de selección predeterminados del conjunto de cifrado 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 Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSCipherPSK13 | no | Cadena de cifrado para OpenSSL 1.1.1 o posterior en TLS 1.3. Anule los criterios de selección predeterminados del conjunto de cifrado para el cifrado basado en PSK. Ejemplo: TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 Este parámetro es compatible desde Zabbix 4.4.7. |
||
| TLSConnect | sí, si el certificado TLS o los parámetros PSK están definidos (incluso para conexiones sin cifrar), de lo contrario, no | Cómo debe conectarse el agente al servidor o proxy de Zabbix. Se utiliza para cheques activos. Solo se puede especificar un valor: sin cifrar - conectar sin cifrar (predeterminado) psk - conectar usando TLS y una clave precompartida (PSK) cert: conexión mediante TLS y un certificado Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSCRLArchivo | no | Nombre de ruta completo de un archivo que contiene certificados revocados. Este parámetro se usa para comunicaciones encriptadas con componentes de Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSKeyFile | no | Nombre de ruta completo de un archivo que contiene la clave privada del agente utilizada para comunicaciones cifradas con componentes de Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSPSKArchivo | no | Nombre de ruta completo de un archivo que contiene la clave precompartida del agente utilizada para comunicaciones cifradas con componentes de Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSPSKIdentity | no | Cadena de identidad de clave precompartida, utilizada para comunicaciones cifradas con el servidor Zabbix. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSServerCertIssuer | no | Emisor de certificado de servidor (proxy) permitido. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| TLSServerCertSubject | no | Sujeto de certificado de servidor (proxy) permitido. Este parámetro es compatible desde Zabbix 3.0.0. |
||
| UnsafeUserParameters | no | 0,1 | 0 | Permitir que todos los caracteres se pasen en argumentos a parámetros definidos por el usuario. 0 - no permitir 1 - permitir Los siguientes caracteres no están permitidos: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Además, no se permiten caracteres de nueva línea. |
| User | no | zabbix | Otorga privilegios a un usuario específico existente en el sistema. Solo tiene efecto si se ejecuta como 'root' y AllowRoot está deshabilitado. |
|
| UserParameter | no | Parámetro definido por el usuario para monitorear. Puede haber varios parámetros definidos por el usuario. Formato: UserParameter=<clave>,<comando de shell> Tenga en cuenta que el comando de shell no debe devolver una cadena vacía o solo EOL. Los comandos de shell pueden tener rutas relativas, si se especifica el parámetro UserParameterDir. Ejemplos: UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh |
||
| UserParameterDir | no | Ruta de búsqueda predeterminada para los comandos UserParameter. Si se usa, el agente cambiará su directorio de trabajo al especificado aquí antes de ejecutar un comando. Por lo tanto, los comandos de UserParameter pueden tener un prefijo ./ relativo en lugar de una ruta completa.Solo se permite una entrada. Ejemplo: UserParameterDir=/opt/myscripts |