Documentation
Table of Contents
5 Agente Zabbix (Windows)
Descripción general
Esta sección enumera los parámetros admitidos en el archivo de configuración del agente Zabbix (Windows) (zabbix_agentd.conf).
Tenga en cuenta que:
- Los valores predeterminados reflejan los valores predeterminados del demonio, no los valores en los 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 | Defecto | Descripción |
|---|---|---|---|---|
| Alias | no | Establece un alias para una clave de métrica. Se puede utilizar para sustituir la 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 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 las mismas métricas 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 | 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 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. |
||
| EnableRemoteCommands | 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[*]. |
|
| HostInterface | no | 0-255 caracteres | Parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza 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 la métrica especificada 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 una métrica Zabbix agent utilizada para obtener metadatos del equipo. 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 la métrica especificado supera el límite de 255 caracteres. El valor devuelto por la métrica debe ser una cadena UTF-8; de lo contrario, se ignorará. |
||
| Hostname | no | Establecido por HostnameItem | Lista de nombres del 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 | Parámetro opcional que define una métrica Zabbix agent utilizado para obtener el nombre del equipo. Esta opción solo se usa cuando el nombre de equipo 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. |
|
| Include | 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'. |
| ListenIP | 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. |
| LogType | 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. |
|
| LogRemoteCommands | 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 métrica '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 de registro. |
| PerfCounter | 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 métrica cuando creando una métrica. 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 métrica al crear una métrica. 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. |
| Server | 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. |
||
| ServerActive | 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 |
|
| SourceIP | no | Dirección IP de origen para: - conexiones salientes al servidor Zabbix o al proxy Zabbix; - establecer conexiones mientras se ejecutan algunos métricas (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. |
| Timeout | 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. |
||
| TLSCRLFile | 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. |
||
| TLSPSKFile | 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. |
| 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 |
(*) 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 ser menor que 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).