Zabbix - es (traduzir)
- Leonardo Rosa Bittencourt
- Leonardo Brandão
- Suporte
Esta documentación trata sobre el servicio externo Zabbix. El servicio externo se accede a través de la API. Las funcionalidades descritas aquí indican las capacidades y los requisitos de la integración, así como el cuestionario y las funcionalidades relacionadas.
Tipo de Integración
La integración OZmap-Zabbix es del tipo Activa.
Descripción
Zabbix es una herramienta de software de código abierto para monitorear la infraestructura de TI, como redes, servidores, máquinas virtuales, servicios en la nube y equipos de red en general (como las ONUs de los clientes, por ejemplo). Zabbix recopila y muestra métricas básicas.
Las funcionalidades de la integración entre OZmap y Zabbix se basan en los ítems disponibles en el sistema de monitoreo y sus identificadores. Para extraer información de estos identificadores, son utilizadas expresiones regulares, las cuales extraen de un texto la información deseada.
Importante: Actualmente, la integración es compatible solo con versiones de Zabbix hasta la 7.0.12.
Cómo se encuentran los clientes de OZmap en Zabbix
Para la manipulación de la potencia y el estado del cliente OZmap, es posible extraer la información del código del cliente a partir de cualquier campo de la ONU en Zabbix. Ejemplo:
ITEM = JOAODASILVA-05325423605-joao.silvaDado que el campo código del cliente en OZmap es el login PPPoE utilizado por el cliente, la integración aplica una función en los textos anteriores para extraer solo esa información, que sería: "joao.silva".
Para ello, se utiliza expresiones regulares.
Vea aqui ejemplos de cómo puede ser formateado el texto del ítem y expresiones para usar.
Resumen de funcionalidades
Funcionalidad | Descripción | Dirección de la integración |
|---|---|---|
Actualización de estado | Actualización del valor de estado del cliente en OZmap basado en la lectura informada por Zabbix. | Zabbix => OZmap |
Actualización de potencia | Actualización del valor de potencia leída en OZmap basado en la lectura informada por Zabbix. | Zabbix => OZmap |
Funcionalidades
Abajo serán descritas las funcionalidades presentadas en el resumen de forma a entender cómo funciona el flujo de sincronización.
Actualización de estado
Actualización del valor de estado del cliente en OZmap basado en la lectura informada por Zabbix. El campo “estado” es actualizado en OZmap utilizando el ítem de estado definido en las configuraciones y respetando las siguientes reglas:
Se leen todos los ítems con nombre definido en las configuraciones.
Para cada ítem, se extrae el código de identificación que localizará al cliente en OZmap, utilizando la expresión regular definida.
Caso sea encontrado, y el valor presente en OZmap sea diferente del valor traído por Zabbix, el campo de OZmap es actualizado. El valor de estado sigue el siguiente padrón:
Estado en Zabbix | Estado en OZmap |
|---|---|
1 | OK (0) |
Cualquier otro valor | ERROR (1) |
Actualización de potencia
Actualización del valor de potencia leída en OZmap basado en la lectura informada por Zabbix. El campo “Potencia leída” es actualizado en OZmap, utilizando el ítem definido en las configuraciones.
Se leen todos los ítems con el nombre definido en las configuraciones.
Para cada ítem, se extrae el código de identificación que encontrará el cliente en OZmap, utilizando la expresión regular definida.
En caso sea encontado, y el valor presente en OZmap es diferente del valor traído por el ítem de Zabbix, el campo “Potencia leída” de OZmap es actualizado.
Configuraciones Base
Parámetro | Descripción | Estándar |
|---|---|---|
Tempo entre Sincronizaciones | Tiempo esperado entre las sincronizaciones realizadas por la integración | 15 minutos |
Nombre del parámetro de usuario | Nombre del parámetro de usuario pasado en la llamada de autenticación del servidor Zabbix (este parámetro varía dependiendo de la versión de Zabbix utilizada por el cliente). | user |
Configuraciones Específicas - Potencia
Parámetro | Descripción | Estándar |
|---|---|---|
Nombre del Ítem de potencia | Nombre del ítem que guarda la potencia de la ONU en Zabbix (ej: Potencia ONU) | Potency RX |
Atributo de búsqueda del ítem de potencia | Atributo que será utilizado para buscar los ítems de potencia en Zabbix. | name |
Atributo de extracción del código de vínculo para potencia | Atributo que será utilizado para extraer el código que será buscado dentro de OZmap, la extracción ocurre por expresión regular, identificada abajo. (ej: name, key_) | key_ |
Expresión regular para identificación del código de vínculo entre sistemas para potencia | Expresión utilizada para extraer del parámetro de código, el código que será buscado en OZmap.El valor predeterminado es utilizar todo el valor del atributo indicado arriba. |
|
Configuraciones Específicas - Estado
Parámetro | Descripción | Estándar |
|---|---|---|
Nombre del Ítem de estado | Nombre del ítem que guarda el estado de la ONU en Zabbix (ej: Estado ONU) | Status ONU |
Atributo de búsqueda del ítem de estado | Atributo que será utilizado para buscar los ítems de estado en Zabbix. | name |
Atributo de extracción del código de vínculo para estado | Atributo que será utilizado para extraer el código que será buscado dentro de OZmap, la extracción ocurre por expresión regular, identificada abajo. (ej: name, key_) | key_ |
Expresión regular para identificación del código de vínculo entre sistemas para estado | Expresión utilizada para extraer del parámetro de código, el código que será buscado en OZmap, el estándar es utilizar todo el valor del atributo indicado arriba. |
|
Datos de Acceso
Zabbix
Datos de acceso necesarios para buscar información vía API en el sistema Zabbix. (Estos datos deben ser proporcionados en el cuestionario inicial).
Parámetro | Descripción | Ejemplo |
|---|---|---|
URL | Dirección del servidor Zabbix considerando si existe no un “path” para acceder (ej: /zabbix). | https://zabbix.cliente.com.br/zabbix |
Login | Nombre de usuario del sistema creado para la integración. | ozmap |
Contraseña | Contraseña de acceso del usuario | - |
OZmap
Parámetro | Descripción | Ejemplo |
|---|---|---|
Token | Token asociado a la cuenta del usuario de integración registrado en OZmap. (El usuario debe tener acceso a los proyectos en los que trabajará la integración. Tutorial de como generar usuario/clave). | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
Liberación de IPs
Para la validación y ejecución de la integración en el entorno de producción, es necesario que se liberen en el servidor del cliente las IPs utilizados por OZmap:
Servidor OZmap del cliente (ping cliente.ozmap.com.br)
Logs
La integración aún no posee logs.
Cuestionario
Pregunta | Respuesta | Funcionalidad |
|---|---|---|
¿Es posible utilizar solo algunas de las funcionalidades mencionadas? | Si, es posible elegir ejecutar solo una o más de las funcionalidades descritas. | - |
¿Es posible modificar el mapeo de estados definidos? Ej: Estado 3 en Zabbix ser OK en OZmap. | No, hasta la versión actual el mapeo de estados es fijo. Sin embargo, es posible realizarlo mediante una solicitud de mejora. | Actualización de Status |
¿Es posible considerar una potencia menor a un valor predefinido como estado ERROR? | No, actualmente la integración de potencia solo actualiza en OZmap. Sin embargo, se puede desarrollar una aplicación aparte que identifique patrones específicos de la empresa y cambie el estado según las definiciones propias. (OZmatic) | Actualización de Estado |
En la actualización de estado, ¿es posible obtener el código del cliente OZmap en la ONU desde cualquier campo? | Sí, en la versión actual de la integración, el código del cliente OZmap se obtiene desde cualquier campo de la ONU. | Actualización de Estado |
En la actualización de potencia, ¿es posible obtener el código del cliente OZmap en la ONU desde cualquier campo? | Si, en la versión actual de la integración, el código del cliente OZmap se obtiene desde cualquier campo de la ONU. | Actualización de Potencia |
//Anotar las preguntas, posibles respuestas y las funcionalidades relacionadas con cada respuesta.