Sidebar

5 Agente Zabbix (Windows)

Resumen

Esta sección enumera los parámetros soportados en un archivo de configuración del agente Zabbix (Windows) (zabbix_agent.conf). Tenga en cuenta que:

  • · Los valores por defecto reflejan los valores por defecto del demonio, no los valores de los archivos de configuración enviados;
  • · Zabbix soporta archivos de configuración sólo 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 Mandatory Rango Defecto Descripción
Alias no Establece un alias para una clave de elemento. Se puede utilizar para sustituir la clave de elemento 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 elemento.
Los alias se pueden usar en HostMetadataItem pero no en los parámetros HostnameItem o PerfCounter.

Ejemplos:

1. Recuperando el uso del archivo de paginación en porcentajes del servidor.
Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]
Ahora clave abreviada pg_usage* * se puede utilizar para recuperar datos.

2. Obtener carga de CPU con parámetros predeterminados y personalizados.
Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]< br>Esto permite usar la clave
cpu.load** para obtener el porcentaje de utilización 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.

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 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 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 No mantenga 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< br>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.
Habilitar comandos remotos 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[*].
Interfaz de host no 0-255 caracteres Parámetro opcional que define la interfaz del host.
La interfaz del host se utiliza en el proceso de registro automático 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 adquirirá de HostInterfaceItem.
Soportado desde Zabbix 4.4.0.
Elemento de interfaz de host no Parámetro opcional que define un elemento utilizado para obtener la interfaz del host.
La interfaz del host se utiliza en el proceso de registro automático del host.
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 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, contadores de rendimiento y alias. Admite system.run[] independientemente del valor de EnableRemoteCommands.
El valor de HostMetadataItem se recupera en cada intento de registro automático y se usa solo en el proceso de registro automático del host (agente activo).
Durante un registro automático, solicite 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á.
Nombre de host 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.
Nombre de hostItem 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, contadores de rendimiento o alias, pero admite system.run[] independientemente del valor de EnableRemoteCommands.
La longitud de salida es limitado a 512 KB.
Consulte también una descripción más detallada.
Incluir 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.
Ver notas especiales sobre 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'.
EscucharIP no 0.0.0.0 Lista de direcciones IP delimitadas por comas en las que el agente debe escuchar.
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
C:\zabbix_agentd.log Nombre del archivo de registro del agente.
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.
Tipo de registro no archivo Tipo de salida de registro:
archivo: escribe el registro en el archivo especificado por el parámetro LogFile,
sistema: escribe el registro Registro de eventos de Windows,
consola: escribe el registro en la salida estándar.< br>Este parámetro es compatible desde Zabbix 3.0.0.
Registrar comandos remotos no 0 Habilitar registro de comandos de shell ejecutados como advertencias.
0 - deshabilitado
1 - habilitado
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 que procesa las comprobaciones activas 'log', 'logrt' y 'eventlog'.
La proporcionada el valor será anulado por el parámetro 'maxlines',
proporcionado en las claves 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 los elementos de registro.
Contador de rendimiento no Define un nuevo parámetro <parámetro_nombre> que es un valor promedio para el contador de rendimiento del sistema <rendimiento_contador_ruta> para el período de tiempo especificado <período> (en segundos).
Sintaxis: <parámetro_nombre>, "<perf_counter_path>",<period>
Por ejemplo, si desea recibir el número promedio de interrupciones del procesador por segundo para el último minuto, puede definir un nuevo parámetro "interrupciones" de la siguiente manera:<br >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 (interrupciones) se utilizará como clave de elemento cuando creando un elemento.
Se tomarán muestras para calcular el valor promedio cada segundo.
Puede ejecutar "typeperf -qx" para obtener una lista de todos los contadores de rendimiento disponibles en Windows.
PerfCounterEn no Define un nuevo parámetro <parámetro_nombre> que es un valor promedio para el contador de rendimiento del sistema <rendimiento_contador_ruta> para el período de tiempo especificado <período> (en segundos).
Sintaxis: <parámetro_nombre>, "<perf_counter_path>",<period>
En comparación con PerfCounter, las rutas de perfcounter deben estar en inglés.
Compatible solo con Windows Server 2008/Vista y superior.
Por ejemplo , si desea recibir el número promedio de interrupciones del procesador por segundo para el último minuto, puede definir un nuevo parámetro "interrupciones" 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 (interrupciones) se utilizará como clave de 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 consultando la siguiente clave de registro: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.
Este parámetro es compatible desde Zabbix 4.0.13 y 4.2.7.
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.
Servidor 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.
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.
'0.0.0.0/0' se puede usar 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.
ServidorActivo no (*) Lista de direcciones IP delimitadas por comas o nombres DNS (dirección:puerto) pares o clústeres (dirección:puerto;dirección2:puerto) de servidores Zabbix y proxies Zabbix para verificaciones activas.
Los nodos del clúster deben estar separados por un punto y coma.
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 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 para 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
FuenteIP 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-63 (*) 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 TCP puerto.
Tiempo de espera no 1-30 3 No gaste más de segundos de tiempo de espera 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.
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
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:< br>\ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Además, los caracteres de nueva línea no están permitidos.
ParámetroUsuario 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

::: nota clásica (*) El número de servidores activos enumerados en ServerActive más el número de instancias previamente bifurcadas para comprobaciones pasivas especificadas en StartAgents debe tener menos de 64. :::

Ver también

    • [Diferencias en la configuración del agente Zabbix para las comprobaciones activas y comprobaciones pasivas a partir de la versión - 2.0.0] http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858).