6 Agente Zabbix 2 (Windows)

Resumen

Zabbix agent 2 es una nueva generación de Zabbix agent y puede utilizarse en lugar de Zabbix agent.

Los parámetros admitidos por el archivo de configuración de Zabbix agent 2 para Windows (zabbix_agent2.conf) se enumeran en esta sección.

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 no 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 utilizarse para sustituir una clave de item larga y compleja por una 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 utilizarse en HostMetadataItem, pero no en el parámetro HostnameItem.

Ejemplo 1: Recuperar el uso del archivo de paginación en porcentaje desde el server.

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

Ahora se puede usar la clave abreviada pg_usage para recuperar datos.

Ejemplo 2: Obtener la carga de CPU con parámetros predeterminados y personalizados.

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

Esto permite usar la clave cpu.load para obtener la carga de CPU con parámetros predeterminados, así como usar cpu.load[percpu,avg15] para obtener datos específicos sobre la carga de CPU.

Ejemplo 3: Ejecutar varias reglas de low-level discovery procesando los mismos elementos de discovery.

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

Ahora es posible configurar varias reglas de discovery usando vfs.fs.discovery con diferentes 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 coinciden 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 el orden en que aparecen. Consulte también: Restricting agent checks.

BufferSend

El intervalo de tiempo en segundos que determina la frecuencia con la que 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.

Predeterminado: 5
Rango: 1-3600

BufferSize

Establece 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: \\.\pipe\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 error;
• 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 su orden de aparición. 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 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 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 (agent activo). 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 no 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 no sean IP 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 utiliza cuando HostMetadata no está definido.

El valor de HostMetadataItem se recupera en cada intento de autoregistro y solo se usa en el proceso de autoregistro del host (agent activo). HostMetadataItem permite distinguir entre hosts más allá del nombre de 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, los valores que sean UTF-8 válidos pero no sean IP ni nombres DNS válidos también se rechazarán y se informarán como invá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 y 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 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[] es compatible 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 (ubicado en C:\Program Files\Zabbix Agent 2 de forma predeterminada si Zabbix agent se instala mediante los paquetes del instalador MSI de Windows; ubicado en la carpeta especificada durante la instalación si Zabbix agent se instala como un archivo zip). Todos los archivos incluidos deben tener una sintaxis correcta; de lo contrario, agent no se iniciará. La ruta puede ser relativa a la ubicación del archivo zabbix_agent2.conf (por ejemplo, Include=.\zabbix_agent2.d\plugins.d\*.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 notas especiales sobre las limitaciones.

Ejemplo:

Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.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 del agent.

Predeterminado: c:\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;
• 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 se deben almacenar los datos cuando no hay conexión con el server o el 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

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

Establece 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, logrt y eventlog. El valor proporcionado se sobrescribirá con el parámetro maxlines, especificado en la clave del item log, logrt o eventlog.
Nota: Zabbix procesará 10 veces más nuevas líneas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en los 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 a la canalización con nombre de Windows para las comunicaciones de plugins cargables.

Predeterminado: \\.\pipe\agent.plugin.sock

PluginTimeout

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

Valor predeterminado: Timeout
Rango: 1-30

PerfCounter

Define un nuevo parámetro <parameter_name> que es el valor promedio del contador de rendimiento del sistema <perf_counter_path> para el período de tiempo especificado <period> (en segundos).
Sintaxis: <parameter_name>,"<perf_counter_path>",<period>

Por ejemplo, si desea obtener el número promedio de interrupciones del procesador por segundo durante el último minuto, puede definir un nuevo parámetro "interrupts" de la siguiente manera:

PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60

Tenga en cuenta las comillas dobles alrededor de la ruta del contador de rendimiento. El nombre del parámetro (interrupts) se usará como la clave del item al crear un item. Las muestras para calcular el valor promedio se tomarán cada segundo.
Puede ejecutar typeperf -qx para obtener la lista de todos los contadores de rendimiento disponibles en Windows.

PerfCounterEn

Define un nuevo parámetro <parameter_name> que es el valor promedio para el contador de rendimiento del sistema <perf_counter_path> durante el período de tiempo especificado <period> (en segundos). En comparación con PerfCounter, las rutas de los contadores de rendimiento deben estar en inglés. Soportado solo en Windows Server 2008/Vista y posteriores.
Sintaxis: <parameter_name>,"<perf_counter_path>",<period>

Por ejemplo, si desea recibir el número promedio de interrupciones del procesador por segundo durante el último minuto, puede definir un nuevo parámetro "interrupts" de la siguiente manera:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

Tenga en cuenta las comillas dobles alrededor de la ruta del contador de rendimiento. El nombre del parámetro (interrupts) debe usarse como clave del elemento al crear un elemento. Las muestras para calcular el valor promedio se tomarán cada segundo.
Puede encontrar la lista de cadenas en inglés viendo la siguiente clave del registro: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

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 servers 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 puede usarse 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 donde 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 a Zabbix server o Zabbix proxy;
• 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 elementos y datos de elementos en comprobaciones activas;
• recuperar datos de registros a través del monitoreo de archivos de registro o del registro de eventos de Windows;
• 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 elemento).

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.

TLSCipherAll13

La cadena de cifrado de OpenSSL (TLS 1.3). 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

Este parámetro es compatible desde Zabbix 7.0.4.

TLSCipherCert13

La cadena de cifrado de OpenSSL (TLS 1.3). Anula los criterios de selección predeterminados de la suite de cifrado para el cifrado basado en certificados.

Tenga en cuenta que este parámetro no se puede usar junto con TLSAccept=cert,psk; para una conexión con certificado (TLSConnect=cert), use TLSCipherAll13 en su lugar.

Este parámetro es compatible desde Zabbix 7.0.4.

TLSCipherPSK13

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

Ejemplo:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

Este parámetro es compatible desde Zabbix 7.0.4.

TLSConnect

El nivel de cifrado requerido para las conexiones del agent con el server o proxy de Zabbix. Se usa para comprobaciones activas. Solo se puede especificar un valor:

• unencrypted - conectar sin cifrado (predeterminado);
• psk - conectar usando TLS y una clave precompartida (PSK);
• cert - conectar usando 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

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 todos los caracteres se pasen como argumentos a 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

UserParameter

Un parámetro definido por el usuario para supervisar. Puede haber varios parámetros definidos por el usuario.
Formato: UserParameter=<key>,<shell command>
Tenga en cuenta que el comando de shell no debe devolver una cadena vacía ni solo EOL. Los comandos de shell pueden tener rutas relativas, si se especifica el parámetro UserParameterDir.

Ejemplo:

UserParameter=system.test,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat

UserParameterDir

La ruta de búsqueda predeterminada para los comandos UserParameter. Si se utiliza, el agent 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=C:\opt\myscripts