En esta sección se enumeran los parámetros admitidos por el archivo de configuración del agente de Zabbix para Windows (zabbix_agentd.conf).
Los parámetros se enumeran sin información adicional. Haga clic en el parámetro para ver los detalles completos.
Parámetro | Descripción |
---|---|
Alias | Establece un alias para una clave de elemento. |
AllowKey | Permite la ejecución de aquellas claves de elemento que coincidan con un patrón. |
BufferSend | No mantener los datos en el búfer más de N segundos. |
BufferSize | El número máximo de valores en el búfer de memoria. |
DebugLevel | El nivel de depuración. |
DenyKey | Deniega la ejecución de aquellas claves de elemento que coincidan con un patrón. |
EnableRemoteCommands | Indica si se permiten los comandos remotos desde el servidor Zabbix. |
HeartbeatFrequency | La frecuencia de los mensajes de latido en segundos. |
HostInterface | Parámetro opcional que define la interfaz del host. |
HostInterfaceItem | Parámetro opcional que define un elemento utilizado para obtener la interfaz del host. |
HostMetadata | Parámetro opcional que define los metadatos del host. |
HostMetadataItem | Parámetro opcional que define un elemento del agente Zabbix utilizado para obtener los metadatos del host. |
Hostname | Parámetro opcional que define el nombre del host. |
HostnameItem | Parámetro opcional que define un elemento del agente Zabbix utilizado para obtener el nombre del host. |
Include | Puede incluir archivos individuales o todos los archivos de un directorio en el archivo de configuración. |
ListenBacklog | El número máximo de conexiones pendientes en la cola TCP. |
ListenIP | Una lista de direcciones IP separadas por comas en las que el agente debe escuchar. |
ListenPort | El agente escuchará en este puerto las conexiones desde el servidor. |
LogFile | El nombre del archivo de registro. |
LogFileSize | El tamaño máximo del archivo de registro. |
LogRemoteCommands | Habilita el registro de los comandos de shell ejecutados como advertencias. |
LogType | El tipo de salida del registro. |
MaxLinesPerSecond | El número máximo de nuevas líneas que el agente enviará por segundo al servidor o proxy Zabbix al procesar comprobaciones activas 'log' y 'logrt'. |
PerfCounter | Define un nuevo parámetro <nombre_parámetro> que es el valor promedio para el contador de rendimiento del sistema <ruta_contador_rendimiento> para el período de tiempo especificado <período> (en segundos). |
PerfCounterEn | Define un nuevo parámetro <nombre_parámetro> que es el valor promedio para el contador de rendimiento del sistema <ruta_contador_rendimiento> para el período de tiempo especificado <período> (en segundos). En comparación con PerfCounter, las rutas de los contadores de rendimiento deben estar en inglés. |
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 servidores Zabbix y proxies Zabbix. |
ServerActive | La dirección del servidor/proxy Zabbix o la configuración de clúster desde la que obtener comprobaciones activas. |
SourceIP | La dirección IP de origen. |
StartAgents | El número de instancias pre-forked de zabbix_agentd que procesan comprobaciones pasivas. |
Timeout | Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con el proxy o servidor Zabbix. |
TLSAccept | Qué conexiones entrantes aceptar. |
TLSCAFile | La ruta completa de un archivo que contiene los certificados de CA de nivel superior para la verificación de certificados de pares, utilizado para comunicaciones cifradas entre componentes de Zabbix. |
TLSCertFile | La ruta completa de un archivo que contiene el certificado del agente o la cadena de certificados, utilizado para comunicaciones cifradas entre componentes de Zabbix. |
TLSConnect | Cómo debe conectarse el agente al servidor o proxy Zabbix. |
TLSCRLFile | La ruta completa de un archivo que contiene certificados revocados. Este parámetro se utiliza para comunicaciones cifradas entre componentes de Zabbix. |
TLSKeyFile | La ruta completa de un archivo que contiene la clave privada del agente, utilizada para comunicaciones cifradas entre componentes de Zabbix. |
TLSPSKFile | La ruta completa de un archivo que contiene la clave precompartida del agente, utilizada para comunicaciones cifradas con el servidor Zabbix. |
TLSPSKIdentity | La cadena de identidad de la clave precompartida, utilizada para comunicaciones cifradas con el servidor Zabbix. |
TLSServerCertIssuer | El emisor de certificado de servidor (proxy) permitido. |
TLSServerCertSubject | El sujeto de certificado de servidor (proxy) permitido. |
UnsafeUserParameters | Permitir que se pasen todos los caracteres en los argumentos a los parámetros definidos por el usuario. |
UserParameter | Un parámetro definido por el usuario para monitorizar. |
UserParameterDir | La ruta de búsqueda predeterminada para los comandos UserParameter. |
Todos los parámetros son opcionales a menos que se indique explícitamente que el parámetro es obligatorio.
Tenga en cuenta que:
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 corta y sencilla.
Es posible que estén presentes varios 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 métrica.
Los alias se pueden utilizar en HostMetadataItem pero no en el parámetro HostnameItem o PerfCounter.
Ejemplo 1: Recuperar el uso del archivo de paginación en porcentaje del servidor.
Ahora se puede utilizar la clave abreviada pg_usage para recuperar los datos.
Ejemplo 2: Obtener la carga de la CPU con parámetros predeterminados y personalizados.
Esto permite usar la clave cpu.load para obtener la carga de la CPU con parámetros predeterminados, así como usar cpu.load[percpu,avg15] para obtener datos específicos sobre la carga de la CPU.
Ejemplo 3: ejecutar varias reglas de descubrimiento de bajo nivel que procesan las mismas métricas de descubrimiento.
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.
Permitir la ejecución de aquellas claves de métrica 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 claves en combinación con DenyKey. Los parámetros se procesan uno por uno según su orden de aparición. Consulte también: Restricción de comprobaciones de agentes.
No guarde datos por más de N segundos en el búfer.
Predeterminado: 5
Rango: 1-3600
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.
Predeterminado: 100
Rango: 2-65535
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
Denegar la ejecución de aquellas claves de métrica 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 claves en combinación con AllowKey. Los parámetros se procesan uno por uno según su orden de aparición. Consulte también: Restricción de comprobaciones de agentes.
Si se permiten comandos remotos del 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 de valor:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]
Predeterminado: 0
Valores: 0 - no permitir, 1 - permitir
La frecuencia de los mensajes de latidos del corazón en segundos. Se utiliza para monitorear la disponibilidad de comprobaciones activas.
0: mensajes de latido deshabilitados.
Predeterminado: 60
Rango: 0-3600
Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de autorregistro del equipo. Si no se define, el valor se adquirirá 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
Un 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 autorregistro del equipo.
Durante una solicitud de registro automático, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.
La métrica system.run[] se admite independientemente de los valores de AllowKey/DenyKey.
Esta opción solo se usa cuando HostInterface no está definido.
Un parámetro opcional que define los metadatos del host. Los metadatos del host se utilizan solo en el proceso de autorregistro del host (agente activo). Si no se define, el valor se obtendrá de HostMetadataItem.
El agente emitirá 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.
No se admiten metadatos de varias líneas: la salida se truncará en el primer salto de línea.
Rango: 0-2034 bytes
Un parámetro opcional que define un elemento del agente Zabbix utilizado para obtener los metadatos del host. Esta opción solo se utiliza cuando HostMetadata no está definido. Se admiten parámetros de usuario, contadores de rendimiento y alias. El elemento system.run[] es compatible independientemente de los valores AllowKey/DenyKey.
El valor de HostMetadataItem se recupera en cada intento de autorregistro y solo se utiliza durante el proceso de autorregistro del host (agente activo).
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.
No se admiten metadatos de varias líneas: la salida se truncará en el primer salto de línea.
Una lista de nombres de equipo únicos, delimitados por comas y que distinguen entre 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 equipo, 2048 caracteres para toda la línea.
Valor predeterminado: establecido por HostnameItem
Un parámetro opcional que define una métrica del agente Zabbix utilizada para obtener el nombre del equipo. Esta opción sólo se utiliza cuando el nombre de equipo no está definido. Los parámetros de usuario, contadores de rendimiento o alias no son compatibles, pero la métrica system.run[] sí se admite independientemente de los valores AllowKey/DenyKey.
Consulte también una descripción más detallada.
Valor predeterminado: system.hostname
Puede incluir archivos individuales o todos los archivos en un directorio en el archivo de configuración (ubicado en C:\Program Files\Zabbix Agent
de forma predeterminada si el agente Zabbix se instala usando los paquetes de instalación MSI de Windows; ubicado en la carpeta especificada durante la instalación si Zabbix El agente se instala como un archivo zip). Todos los archivos incluidos deben tener sintaxis correcta; de lo contrario, el agente no se iniciará.
Para incluir solo 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:
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
Una lista de direcciones IP delimitadas por comas que el agente debe escuchar.
Predeterminado: 0.0.0.0
El agente escuchará en este puerto las conexiones del servidor.
Predeterminado: 10050
Rango: 1024-32767
El nombre del archivo de registro del agente.
Por defecto: c:\zabbix_agentd.log
Obligatorio: Sí, si LogType está configurado como file; de lo contrario, no
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
Habilite el registro como advertencias de los comandos de shell ejecutados. Los comandos se registrarán sólo si se ejecutan de forma remota. Las entradas de registro no se crearán si system.run[] se inicia localmente mediante los parámetros HostMetadataItem, HostInterfaceItem o HostnameItem.
Predeterminado: 0
Valores: 0 - deshabilitado, 1 - habilitado
El tipo de salida del registro:
file - escribe el registro en el archivo especificado por el parámetro LogFile;
system - escribe el registro en el registro de eventos de Windows;
console - escribe el registro en la salida estándar .
Predeterminado: file
El número máximo de líneas nuevas que el agente enviará por segundo al servidor o proxy de Zabbix al procesar las comprobaciones activas 'log', 'logrt' y 'eventlog'. El valor proporcionado será anulado por el parámetro 'maxlines', proporcionado en la clave de elemento 'log', 'logrt' o 'eventlog'.
Nota: Zabbix procesará 10 veces más líneas nuevas que las establecidas en MaxLinesPerSecond para buscar la cadena requerida en las métricas del registro.
Predeterminado: 20
Rango: 1-1000
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>",<período>
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 "interrupciones" como el siguiente:
Tenga en cuenta las comillas dobles alrededor de la ruta del contador de rendimiento. El nombre del parámetro (interrupciones) se utilizará como clave del elemento al crear un elemento. Cada segundo se tomarán muestras para calcular el valor promedio.
Puede ejecutar "typeperf -qx" para obtener la lista de todos los contadores de rendimiento disponibles en Windows.
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). En comparación con PerfCounter, las rutas de perfcounter deben estar en inglés. Compatible únicamente con Windows Server 2008/Vista y versiones 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" como el siguiente:
Tenga en cuenta las comillas dobles alrededor de la ruta del contador de rendimiento. El nombre del parámetro (interrupciones) se utilizará como clave del elemento al crear un elemento. Se tomarán muestras para calcular el valor promedio cada segundo.
Puede encontrar la lista de cadenas en inglés viendo la siguiente clave de registro: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009
.
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 siguiente actualización se intentará en 60 segundos.
Predeterminado: 5
Rango: 1-86400
Una lista de direcciones IP delimitadas por comas, opcionalmente en notación CIDR, o nombres DNS de servidores Zabbix o proxies Zabbix. Se aceptarán conexiones entrantes únicamente desde los equipos 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 de la misma manera y '::/0' permitirá cualquier dirección IPv4 o IPv6. '0.0.0.0/0' se puede utilizar para permitir cualquier dirección IPv4.Tenga en cuenta que las " direcciones IPv6 IPv4-compatible" (0000::/96 prefijo) están soportadas pero están obsoletas en [RFC4291(https://tools.ietf.org/html/rfc4291#section-2.5.5). Se permiten espacios.
Ejemplo:
Obligatorio: sí
La dirección del servidor/proxy de Zabbix o la configuración del clúster para obtener comprobaciones activas. La dirección del servidor/proxy es una dirección IP o nombre DNS y un 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/clústeres de Zabbix y proxies de Zabbix, separados por comas. No se debe especificar más de un proxy Zabbix desde cada servidor/clúster Zabbix. Si se especifica el proxy Zabbix, entonces no se debe especificar el servidor/clúster Zabbix para ese proxy.
Se pueden proporcionar varias direcciones delimitadas por comas para utilizar 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, los corchetes para las direcciones IPv6 son opcionales.
Si no se especifica este parámetro, las comprobaciones activas están deshabilitadas.
Ejemplo de proxy Zabbix:
Ejemplo para múltiples servidores:
Ejemplo de alta disponibilidad:
Ejemplo de 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
Rango: (*)
La dirección IP de origen para:
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 (*)
Especifica cuánto tiempo esperar (en segundos) para establecer la conexión e intercambiar datos con el proxy o servidor Zabbix.
Este parámetro se utiliza para definir la duración de varias operaciones:
vfs.*
;Por defecto: 3
Rango: 1-30
Las conexiones entrantes a aceptar. Se utiliza para controles pasivos. Se pueden especificar varios valores, separados por coma:
unencrypted: acepta conexiones sin cifrado (predeterminado)
psk: acepta conexiones con TLS y una clave previamente compartida (PSK)
cert - aceptar conexiones con TLS y un certificado
Obligatorio: sí, si se definen el certificado TLS o los parámetros PSK (incluso para una conexión no cifrada); De otra manera no
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.
La ruta completa del archivo que contiene el certificado del agente o la cadena de certificados utilizado para comunicaciones cifradas con componentes de Zabbix.
Cómo debe conectarse el agente al servidor o proxy de Zabbix. Se utiliza para controles activos. 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 el certificado TLS o los parámetros PSK (incluso para una conexión no cifrada); De otra manera no
La ruta completa del archivo que contiene los certificados revocados. Este parámetro se utiliza para comunicaciones cifradas entre componentes de Zabbix.
La ruta completa del archivo que contiene la clave privada del agente, utilizada para las comunicaciones cifradas entre los componentes de Zabbix.
La ruta completa del archivo que contiene la clave precompartida del agente, utilizada para las comunicaciones cifradas con el servidor Zabbix.
La cadena de identidad de clave previamente compartida, utilizada para comunicaciones cifradas con el servidor Zabbix.
El emisor del certificado de servidor (proxy) permitido.
El asunto del certificado del servidor (proxy) permitido.
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.
Predeterminado: 0
Valores: 0 - no permitir, 1 - permitir
Un parámetro definido por el usuario para monitorizar. 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 un EOL. Los comandos de shell pueden tener rutas relativas, si se especifica el parámetro UserParameterDir.
Ejemplo:
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:
(*) El número de servidores activos enumerados en ServerActive más el número de instancias prebifurcadas para comprobaciones pasivas especificadas en StartAgents debe ser menor que 64.