Documentation

#14 Complementos

Visión general

Los complementos brindan una opción para ampliar las capacidades de monitoreo de Zabbix. Los complementos están escritos en el lenguaje de programación Go y son compatible solo con el agente 2 de Zabbix.

Los complementos proporcionan una alternativa a loadable módulos (escrito en C), y otros métodos para extender la funcionalidad de Zabbix, como usuario parámetros (métricas de agente), externo comprobaciones (sin agente monitoreo) y system.run[] Zabbix agente artículo.

Las siguientes funciones son específicas del agente 2 y sus complementos:

• soporte de intervalos programados y flexibles tanto para pasivos como para cheques activos;
• gestión de la cola de tareas con respecto a la programación y la concurrencia de tareas;
• tiempos de espera a nivel de complemento.

Desde Zabbix 6.0.0, los complementos no tienen que integrarse directamente en el agente 2 y se pueden agregar como complementos externos separados (complementos cargables), lo que facilita el proceso de creación de complementos adicionales para recopilar nuevas métricas de monitoreo.

Esta página enumera los complementos nativos de Zabbix y describe los principios de configuración de complementos desde la perspectiva del usuario. Para obtener instrucciones sobre cómo escribir sus propios complementos, consulte [Pautas de desarrollo de complementos] (https://www.zabbix.com/documentation/guidelines/en/plugins).

Configuración de complementos

Esta sección proporciona principios comunes de configuración de complementos y las mejores practicas

Todos los complementos se configuran usando el parámetro Plugins.*, que puede ser parte del agente 2 de Zabbix configuración file o el propio complemento archivo de configuración. Si un complemento usa un archivo de configuración separado, la ruta a este archivo debe ser especificado en el parámetro Incluir del archivo de configuración del agente 2 de Zabbix.

Cada parámetro de complemento debe tener la siguiente estructura:

Complementos.<Nombre del complemento>.<Parámetro>=<Valor>

Los nombres de los parámetros deben cumplir los siguientes requisitos:

• se recomienda poner en mayúscula los nombres de sus complementos;
• el parámetro debe estar en mayúscula;
• Caracteres especiales no están permitidos;
• el anidamiento no está limitado por un nivel máximo;
• el número de parámetros no está limitado.

Sesiones con nombre

Las sesiones con nombre representan un nivel adicional de parámetros de complemento y se puede utilizar para definir conjuntos separados de parámetros de autenticación para cada una de las instancias monitoreadas. Cada parámetro de sesión con nombre debe tener la siguiente estructura:

Complementos.<Nombre del complemento>.<Nombre de la sesión>.<Parámetro>=<Valor>

Un nombre de sesión se puede utilizar como un parámetro de clave de elemento connString en lugar de especificando un URI, nombre de usuario y contraseña por separado. En las claves de artículo, el El primer parámetro puede ser connString o Uri. Si la primera clave el parámetro coincide con un nombre de sesión especificado en el archivo de configuración, la comprobación se ejecutará utilizando parámetros de sesión con nombre. si el primero El parámetro clave no coincide con ningún nombre de sesión, se tratará como un uri.

Tenga en cuenta que:

• al proporcionar un connString (nombre de sesión) en parámetros clave, clave los parámetros para el nombre de usuario y la contraseña deben estar vacíos;
• No se admite la transferencia de credenciales de URI incrustadas, considere usar sesiones con nombre en su lugar;
• en caso de que no se especifique un parámetro de autenticación para el nombrado sesión, se utilizará un valor predeterminado codificado.

La lista de parámetros de sesión con nombre disponibles depende del complemento, ver complemento individual configuración archivos para más detalles.

Ejemplo: El monitoreo de dos instancias "MySQL1" y "MySQL2" puede ser configurada de la siguiente manera:

Complementos.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
       Plugins.Mysql.Sessions.MySQL1.User=<Nombre de usuario para MySQL1>
       Plugins.Mysql.Sessions.MySQL1.Password=<ContraseñaParaMySQL1>
       Complementos.Mysql.Sessions.MySQL2.Uri=tcp://127.0.0.1:3307
       Plugins.Mysql.Sessions.MySQL2.User=<Nombre de usuario para MySQL2>
       Plugins.Mysql.Sessions.MySQL2.Password=<ContraseñaParaMySQL2>

Ahora, estos nombres se pueden usar como connStrings en claves en lugar de URI:

mysql.ping[MySQL1]
       mysql.ping[MySQL2]

Example 1

Monitoring of two instances “MySQL1” and “MySQL2”.

Configuration parameters:

Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
       Plugins.Mysql.Sessions.MySQL1.User=mysql1_user
       Plugins.Mysql.Sessions.MySQL1.Password=unique_password
       Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306
       Plugins.Mysql.Sessions.MySQL2.User=mysql2_user
       Plugins.Mysql.Sessions.MySQL2.Password=different_password

Item keys: mysql.ping[MySQL1], mysql.ping[MySQL2]

Example 2

Providing some of the parameters in the item key (supported since Zabbix 6.0.17).

Configuration parameters:

Plugins.Postgres.Sessions.Session1.Uri=tcp://192.0.2.234:5432
       Plugins.Postgres.Sessions.Session1.User=old_username
       Plugins.Postgres.Sessions.Session1.Password=session_password

Item key: pgsql.ping[session1,new_username,,postgres]

As a result of this configuration, the agent will connect to PostgreSQL using the following parameters:

• URI from session parameter: 192.0.2.234:5432
• Username from the item key: new_username
• Password from session parameter (since it is omitted in the item key): session_password
• Database name from the item key: postgres

Valores predeterminados codificados

Si un parámetro requerido para la autenticación no se proporciona en un elemento clave o en los parámetros de sesión nombrados, el complemento utilizará un codificado valor por defecto.

Conexiones

Algunos complementos admiten la recopilación de métricas de múltiples instancias simultaneamente. Tanto las instancias locales como las remotas pueden ser monitoreadas. TCP y se admiten conexiones de socket Unix.

Se recomienda configurar complementos para mantener las conexiones a las instancias. en estado abierto. Los beneficios son la reducción de la congestión de la red, la latencia, y uso de CPU y memoria debido a la menor cantidad de conexiones. los la biblioteca del cliente se encarga de esto.

Plugins supplied out-of-the-box

All metrics supported by Zabbix agent 2 are collected by plugins. The following plugins for Zabbix agent 2 are available out-of-the-box:

Built-in

The following plugins for Zabbix agent 2 are available out-of-the-box. Click on the plugin name to go to the plugin repository with additional information.

Loadable

Click on the plugin name to go to the plugin repository with additional information.

See also: Building loadable plugins.

Footnotes

¹ - Since Zabbix 6.0.13, loadable plugins started using the same versioning system as Zabbix itself. As a result, MongoDB plugin version has changed from 1.2.1 to 6.0.13.