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

Parameter	Description
Alias	Establece un alias para una clave de item.
AllowKey	Permite la ejecución de aquellas claves de item que coinciden con un patrón.
BufferSend	No conservar datos durante más de N segundos en el búfer.
BufferSize	El número máximo de valores en el búfer de memoria.
ControlSocket	El socket de control, usado 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 item que coinciden con un patrón.
EnablePersistentBuffer	Habilita el uso de almacenamiento local persistente para items activos.
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 host.
HostInterfaceItem	Un parámetro opcional que define un item usado para obtener la interfaz del host.
HostMetadata	Un parámetro opcional que define los metadatos del host.
HostMetadataItem	Un parámetro opcional que define un item de Zabbix agent usado para obtener los metadatos del host.
Hostname	Un parámetro opcional que define el nombre del host.
HostnameItem	Un parámetro opcional que define un item de Zabbix agent usado para obtener el nombre del host.
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 agent debe escuchar.
ListenPort	El agent escuchará en este puerto las conexiones desde el server.
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 Zabbix agent 2 debe conservar la base de datos SQLite.
PersistentBufferPeriod	El período de tiempo durante el cual deben almacenarse los datos cuando no hay conexión con el server o proxy.
PidFile	El nombre del archivo PID.
Plugins.<PluginName>.System.Capacity	El límite de comprobaciones por plugin que pueden ejecutarse al mismo tiempo.
Plugins.Log.MaxLinesPerSecond	El número máximo de nuevas líneas que el agent enviará por segundo a Zabbix server o proxy al procesar comprobaciones activas 'log' y 'logrt'.
Plugins.SystemRun.LogRemoteCommands	Habilita el registro de los comandos de shell ejecutados como advertencias.
PluginSocket	La ruta del socket UNIX para las comunicaciones de plugins cargables.
PluginTimeout	El tiempo de espera para las 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 Zabbix servers y Zabbix proxies.
ServerActive	La dirección de Zabbix server/proxy o la configuración de clúster desde la que obtener comprobaciones activas.
SourceIP	La dirección IP de origen.
StatusPort	Si se establece, el agent escuchará en este puerto las solicitudes HTTP de estado (http://localhost:<port>/status).
Timeout	Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con Zabbix proxy o server.
TLSAccept	El nivel de cifrado requerido para las conexiones entrantes.
TLSCAFile	La ruta completa de un archivo que contiene los certificados de la CA de nivel superior para la verificación del certificado del par, usado para comunicaciones cifradas entre componentes de Zabbix.
TLSCertFile	La ruta completa de un archivo que contiene el certificado del agent o la cadena de certificados, usado para comunicaciones cifradas entre componentes de Zabbix.
TLSCipherAll	La cadena de cifrado de OpenSSL (TLS 1.2). Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en certificado y PSK.
TLSCipherAll13	La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o posterior. Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en certificado y PSK.
TLSCipherCert	La cadena de cifrado de OpenSSL (TLS 1.2). Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en certificado.
TLSCipherCert13	La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o posterior. Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en certificado.
TLSCipherPSK	La cadena de cifrado de OpenSSL (TLS 1.2). Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en PSK.
TLSCipherPSK13	La cadena de cifrado de OpenSSL (TLS 1.3) para OpenSSL 1.1.1 o posterior. Sustituye los criterios predeterminados de selección de la suite de cifrado para cifrado basado en PSK.
TLSConnect	El nivel de cifrado requerido para las conexiones del agent a Zabbix server o proxy.
TLSCRLFile	La ruta completa de un archivo que contiene certificados revocados. Este parámetro se usa para comunicaciones cifradas entre componentes de Zabbix.
TLSKeyFile	La ruta completa de un archivo que contiene la clave privada del agent, usada para comunicaciones cifradas entre componentes de Zabbix.
TLSPSKFile	La ruta completa de un archivo que contiene la clave precompartida del agent, usada para comunicaciones cifradas con Zabbix server.
TLSPSKIdentity	La cadena de identidad de la clave precompartida, usada para comunicaciones cifradas con Zabbix server.
TLSServerCertIssuer	El emisor del certificado del server (proxy) permitido.
TLSServerCertSubject	El sujeto del certificado del server (proxy) permitido.
UnsafeUserParameters	Permite que todos los caracteres se pasen en los argumentos de parámetros definidos por el usuario.
UserParameter	Un parámetro definido por el usuario para supervisar.
UserParameterDir	La ruta de búsqueda predeterminada para los comandos UserParameter.

Todos los parámetros no son obligatorios, salvo que se indique explícitamente que el parámetro es obligatorio.

Tenga en cuenta que:

Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados.
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 item. Puede usarse para sustituir una clave de item larga y compleja por otra más corta y sencilla.
Puede haber varios parámetros Alias. No se permiten varios parámetros con la misma clave Alias.
Distintas claves Alias pueden hacer referencia a la misma clave de item.
Los alias pueden usarse en HostMetadataItem, pero no en el parámetro HostnameItem.

Ejemplo 1: Obtener el ID del usuario zabbix.

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

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

Ejemplo 2: Obtener la utilización de 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 CPU con parámetros predeterminados, así como usar cpu.util[all, idle, avg15] para obtener datos específicos sobre la utilización de CPU.

Ejemplo 3: Ejecutar varias reglas de descubrimiento de bajo nivel que procesan los mismos elementos descubiertos.

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

Ahora es posible configurar varias reglas de descubrimiento usando vfs.fs.discovery con distintos parámetros para cada regla, por ejemplo, vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc.

AllowKey

Permite la ejecución de aquellas claves de item que 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 varias 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. Véase también: Restricting agent checks.

BufferSend

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

BufferSize

El número máximo de valores en el búfer de memoria. El agent enviará todos los datos recopilados al server 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).

Predeterminado: 1000
Rango: 2-65535

ControlSocket

El socket de control, utilizado para enviar comandos en tiempo de ejecución con la opción -R.

Predeterminado: /tmp/agent.sock

DebugLevel

Especifique 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).

Predeterminado: 3
Rango: 0-5

DenyKey

Deniega la ejecución de aquellas claves de item que 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 cualquier carácter.
Se pueden definir varias 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. Véase también: Restricting agent checks.

EnablePersistentBuffer

Habilita el uso de almacenamiento persistente local para elementos activos. Si el almacenamiento persistente está deshabilitado, se utilizará el búfer de memoria.

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

ForceActiveChecksOnStart

Realiza comprobaciones activas inmediatamente después del reinicio para la primera configuración recibida. También disponible como un parámetro de configuración por complemento, por ejemplo: Plugins.Uptime.System.ForceActiveChecksOnStart=1

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

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 autoregistration del host. Este valor se usará para completar la interfaz en el host recién creado y permite configurar explícitamente una dirección IP o DNS. Para más detalles, consulte Using DNS as default interface.

Si no se define, el valor se obtendrá de HostInterfaceItem.

El agent 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 item utilizado para determinar la interfaz del host (dirección IP o nombre DNS) durante el proceso de autoregistro del host. Este valor se usa solo si HostInterface no está definido. Para más detalles, consulte Uso de DNS como interfaz predeterminada.

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

El item 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 host durante el proceso de autoregistro del host. HostMetadata permite distinguir entre hosts más allá del nombre de host.

Si no se define, el valor se obtendrá de HostMetadataItem.

El agent generará un error y no se iniciará si el valor especificado supera el límite de 2034 bytes o si es una cadena que no sea UTF-8. Cuando un parámetro espera una dirección IP o un nombre DNS, también se rechazarán y se informarán como inválidos los valores que sean UTF-8 válidos pero que no sean IPs ni nombres DNS válidos.

No se admite metadatos de varias líneas: la salida se truncará en el primer salto de línea.

Rango: 0-2034 bytes

HostMetadataItem

Un parámetro opcional que define un item de Zabbix agent utilizado para obtener metadatos del host. Esta opción solo se usa cuando HostMetadata no está definido.

El valor de HostMetadataItem se recupera en cada intento de autoregistro y solo se utiliza durante el proceso de autoregistro del host. HostMetadataItem permite distinguir entre hosts más allá del nombre del host.

Se admiten parámetros de usuario y alias. Se admite el item system.run[] independientemente de la configuración de AllowKey/DenyKey.

Durante una solicitud de autoregistro, el agent registrará un mensaje de advertencia si el valor devuelto por el item especificado supera el límite de 65535 puntos de código UTF-8. El valor devuelto por el item debe ser una cadena UTF-8; de lo contrario, se ignorará. Cuando un parámetro espera una dirección IP o un nombre DNS, también se rechazarán y se informarán como inválidos los valores que sean UTF-8 válidos pero no sean IP ni nombres DNS válidos.

No se admite metadato de varias líneas: la salida se truncará en el primer salto de línea.

Nombre de host

Una lista de nombres de host únicos, sensibles a mayúsculas y minúsculas, delimitados por comas. Requerido para comprobaciones activas y debe coincidir con los nombres de host configurados en el server. 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.

Predeterminado: establecido por HostnameItem

HostnameItem

Un parámetro opcional que define un item utilizado para obtener el nombre del host. Esta opción solo se usa cuando Hostname no está definido. No se admiten parámetros de usuario ni alias, pero el item system.run[] sí se admite independientemente de los valores de AllowKey/DenyKey.

Predeterminado: system.hostname

Incluir

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 include en /usr/local/etc, a menos que se modifique durante el tiempo de 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:

Include=/absolute/path/to/config/files/*.conf

ListenIP

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

ListenPort

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

Predeterminado: 10050
Rango: 1024-32767

LogFile

El nombre del archivo de registro.

Predeterminado: /tmp/zabbix_agent2.log
Obligatorio: Sí, si LogType está establecido en file; de lo contrario, 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

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

PersistentBufferFile

El archivo donde Zabbix agent 2 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

El período de tiempo durante el cual los datos deben almacenarse cuando no hay conexión con el server 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).

Predeterminado: 1h
Rango: 1m-365d

PidFile

El nombre del archivo PID.

Valor predeterminado: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

El límite de comprobaciones por complemento <PluginName> que se pueden ejecutar al mismo tiempo.

Predeterminado: 1000 Rango: 1-1000

Plugins.Log.MaxLinesPerSecond

El número máximo de nuevas líneas que el agent enviará por segundo a Zabbix server o proxy al procesar comprobaciones activas log y logrt. El valor proporcionado se sobrescribirá mediante el parámetro maxlines, incluido en la clave del item log y logrt.
Nota: Zabbix procesará 10 veces más nuevas líneas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en items de log.

Predeterminado: 20
Rango: 1-1000

Plugins.SystemRun.LogRemoteCommands

Habilita el registro de los comandos de shell ejecutados como advertencias.
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.

Predeterminado: 0
Valores: 0 - deshabilitado, 1 - habilitado

PluginSocket

La ruta al socket UNIX para comunicaciones de complementos cargables.

Valor predeterminado: /tmp/agent.plugin.sock

PluginTimeout

El tiempo de espera para conexiones con complementos cargables, en segundos.

Valor predeterminado: Timeout
Rango: 1-30

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

Server

Una lista de direcciones IP separadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores de Zabbix o proxies de Zabbix. Solo se aceptarán conexiones entrantes 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. 0.0.0.0/0 se puede usar para permitir cualquier dirección IPv4. Se permiten espacios. Si no se especifica este parámetro, se deshabilitan las comprobaciones pasivas y el agent no escuchará en ningún puerto TCP.

Ejemplo:

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

ServerActive

La dirección del Zabbix server/proxy o la configuración del clúster desde la que obtener comprobaciones activas. La dirección del server/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 miembros del grupo de server o proxy separadas por punto y coma. Se pueden especificar varios Zabbix servers/clústeres y Zabbix proxies, separados por comas. A menos que se utilicen grupos de proxies, no se debe especificar más de un Zabbix proxy desde cada Zabbix server/clúster. Si se especifica un Zabbix proxy, entonces no se debe especificar el Zabbix server/clúster para ese proxy.
Se pueden proporcionar varias direcciones separadas por comas para utilizar varios Zabbix servers 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 no se especifica este parámetro, las comprobaciones activas están deshabilitadas.

Ejemplo para Zabbix proxy:

ServerActive=127.0.0.1:10051

Ejemplo para grupo de Zabbix proxy:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Ejemplo para múltiples servers:

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 server:

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 server de Zabbix o al proxy de Zabbix.
realizar conexiones al ejecutar algunos items (web.page.get, net.tcp.port, etc.).

StatusPort

Si está configurado, el agente escuchará en este puerto las solicitudes de estado HTTP (http://localhost:<puerto>/status).

Rango: 1024-32767

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 de comunicación, incluyendo:

esperar una respuesta del servidor Zabbix;
enviar solicitudes al servidor Zabbix, incluidas solicitudes de configuración de ítems y datos de ítems en comprobaciones activas;
recuperar datos de registro a través de logfile;
enviar mensajes de latido;
duración máxima para comprobaciones vfs.*;
servir como respaldo en escenarios donde un servidor o proxy anterior a la versión 7.0 envía comprobaciones sin tiempos de espera.

Este tiempo de espera no se utilizará para aquellas comprobaciones del agente que tengan configuraciones de tiempo de espera ajustables en la interfaz (a nivel global, de proxy o por ítem).

Por defecto: 3
Rango: 1-30

TLSAccept

El nivel de cifrado requerido para las conexiones entrantes. Se usa para comprobaciones pasivas. Se pueden especificar varios valores, separados por comas:

unencrypted - aceptar conexiones sin cifrado (predeterminado);
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 una conexión 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 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:

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