Documentation
Table of Contents
4 Zabbix agente 2 (UNIX)
Visión general
Zabbix agent 2 es una nueva generación de Zabbix agent y se puede usar en lugar del agente de Zabbix.
Esta sección enumera los parámetros admitidos en un agente Zabbix 2 archivo de configuración (zabbix_agent2.conf). Tenga en cuenta que:
- Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores en el archivos de configuración enviados;
- Zabbix admite archivos de configuración solo en codificación UTF-8 sin BOM;
- Los comentarios que comienzan con "#" solo 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. < br>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[*]< br>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.< br> 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 | Permitir 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. |
|||
| BufferSend | no | 1-3600 | 5 | El intervalo de tiempo en segundos que determina la frecuencia con la que se envían valores desde el búfer al servidor Zabbix. Tenga en cuenta que si el búfer está lleno, los datos se enviarán antes . |
|
| 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 al proxy si el búfer está lleno. Este parámetro solo debe usarse si el búfer persistente está deshabilitado (EnablePersistentBuffer=0). |
|
| ControlSocket | no | /tmp/agent.sock | El socket de control, utilizado para enviar comandos de tiempo de ejecución con la opción '-R'. | ||
| 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 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 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. |
|||
| EnablePersistentBuffer | no | 0-1 | 0 | Habilitar el uso del almacenamiento persistente local para métricas activas. 0 - deshabilitado 1 - habilitado Si el almacenamiento persistente está deshabilitado, se usará el búfer de memoria . |
|
| ForceActiveChecksOnStart | no | 0-1 | 0 | Realice comprobaciones activas inmediatamente después del reinicio para la primera configuración recibida. 0 - deshabilitado 1 - habilitado También disponible según el parámetro de configuración del complemento, por ejemplo : Plugins.Uptime.System.ForceActiveChecksOnStart=1 Compatible desde Zabbix 6.0.2. |
|
| HostInterface | no | 0-255 caracteres | Parámetro opcional que define la interfaz del equipo. La interfaz del equipo se usa en el proceso de registro automático del equipo. 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 adquirirá de HostInterfaceItem. Soportado desde Zabbix 4.4.0. |
||
| HostInterfaceItem | no | 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 registro automático del equipo. 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. 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 equipo se utilizan en el proceso de registro automático del equipo. Un agente emitirá un error y no se iniciará si el valor especificado supera el límite o es una cadena que no es UTF-8. Si no se define, se adquirirá el valor de HostMetadataItem. |
||
| HostMetadataItem | no | Parámetro opcional que define un elemento utilizado para obtener metadatos del equipo. El valor del elemento de metadatos del equipo se recupera en cada auto intento de registro para el proceso de registro automático del equipo. 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. 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 devuelto por el elemento debe ser una cadena UTF-8; de lo contrario, se ignorará. |
|||
| Hostname | no | Establecido por HostnameItem | Lista de nombres de equipo exclusivos, separados por comas y sensibles a mayúsculas y minúsculas. Requerido para comprobaciones activas y debe coincidir con los nombres de equipo 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 | Elemento utilizado para generar el nombre de equipo si no está definido. Se ignora si se define el nombre de equipo. 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. Durante la instalación, Zabbix creará el directorio de inclusión en /usr/local/etc, a menos que se modifique durante el tiempo de compilació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.Desde Zabbix 6.0.0, una ruta puede ser relativa a la ubicación del archivo zabbix_agent2.conf. Consulte special notes sobre limitaciones. |
|||
| ListenIP | no | 0.0.0.0 | Lista de direcciones IP delimitadas 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. |
||
| ListenPort | no | 1024-32767 | 10050 | El agente escuchará en este puerto las conexiones del servidor. | |
| LogFile | sí, si LogType está establecido en archivo, de lo contrario no |
/tmp/zabbix_agent2.log | Nombre del archivo de registro si LogType es 'file'. | ||
| 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 la rotación falla , por el motivo que sea, el archivo de registro existente se trunca y se inicia de nuevo. |
|
| LogType | no | archivo | Especifica dónde se escriben los mensajes de registro: sistema - syslog, archivo - archivo especificado por el parámetro LogFile, consola - salida estándar. |
||
| PersistentBufferFile | no | El archivo, donde Zabbix Agent2 debe mantener la base de datos SQLite. Debe ser un nombre de archivo completo. Este parámetro solo se usa si el búfer persistente está habilitado (EnablePersistentBuffer=1). |
|||
| PersistentBufferPeriod | no | 1m-365d | 1h | El período de tiempo durante el cual se deben almacenar los datos, 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 usa si el búfer persistente está habilitado (EnablePersistentBuffer=1). |
|
| PidFile | no | /tmp/zabbix_agent2.pid | Nombre del archivo PID. | ||
| Plugin | no | Desde Zabbix 6.0.0, la mayoría de los complementos tienen sus propios archivos de configuración. El archivo de configuración del agente contiene los parámetros del complemento que se enumeran a continuación. | |||
| Plugins.Log.MaxLinesPerSecond | no | 1-1000 | 20 | Número máximo de líneas nuevas que el agente enviará por segundo al servidor 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 elementos de registro. Este parámetro es compatible desde 4.4.2 y reemplaza a MaxLinesPerSecond. |
|
| Plugins.SystemRun.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. Este parámetro es compatible desde 4.4.2 y reemplaza a LogRemoteCommands. |
||
| PluginSocket | no | /tmp/agent.plugin.sock | Ruta al socket de Unix para comunicaciones de complementos cargables. | ||
| PluginTimeout | no | 1-30 | Tiempo de espera global | Tiempo de espera para conexiones con complementos cargables. | |
| 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í | Lista de direcciones IP delimitadas por comas, opcionalmente en notación CIDR, o nombres DNS 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', '::ffff:127.0.0.1' se tratan por igual y '::/0' permitirá cualquier dirección IPv4 o IPv6. '0.0.0.0/0' se puede usar para permitir cualquier Dirección IPv4. Ejemplo: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com 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 separadas por punto y coma. Se pueden especificar varios servidores/clusters Zabbix y proxies Zabbix, separados por comas. No se debe especificar más de un proxy Zabbix para cada servidor/cluster Zabbix. Si se especifica el proxy Zabbix, entonces Zabbix server/ no se debe especificar el clúster 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 host. 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.) |
|||
| StatusPort | no | 1024-32767 | Si se establece, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<puerto>/estado). | ||
| 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 |
|||
| 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. | |||
| TLSCertFile | no | Ruta de acceso completa 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. | |||
| 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: conexión sin cifrado (predeterminado) psk: conexión mediante TLS y una clave precompartida (PSK) cert: conexión mediante TLS y un certificado |
|||
| TLSCRLFichero | no | Nombre de ruta completo de un archivo que contiene certificados revocados. Este parámetro se utiliza para comunicaciones cifradas con componentes de Zabbix. | |||
| TLSKeyFile | no | Nombre de ruta completo de un archivo que contiene la clave privada del agente utilizada para las comunicaciones cifradas con los componentes de Zabbix. | |||
| TLSPSKFile | no | Nombre de ruta completo de un archivo que contiene la clave precompartida del agente utilizada para las comunicaciones cifradas con los componentes de Zabbix. | |||
| TLSPSKIdentity | no | Cadena de identidad de clave precompartida, utilizada para comunicaciones cifradas con el servidor Zabbix. | |||
| TLSServerCertIssuer | no | Emisor de certificado de servidor (proxy) permitido. | |||
| TLSServerCertSubject | no | Asunto del certificado del servidor (proxy) permitido. | |||
| UnsafeUserParameters | no | 0,1 | 0 | Permitir que todos los caracteres se pasen en argumentos a parámetros definidos por el usuario. Los siguientes caracteres no están permitidos: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Además, no se permiten caracteres de nueva línea. |
|
| 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 |
|||