# Plugin Zevenet
# Introducción
Version: **1.0 ESP Build (01062021)**
Tipo: **Plug-in de servidor**
Con el plug-in se obtendrán métricas sobre el estado del balanceador y las granjas utilizando la API Rest (Zapi) disponible en el equipo.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624920672126.png)
Este plug-in esta fue desarrollado en conjunto con [Zevenet.com](https://zevenet.com)
[SIGUIENTE >](https://pandorafms.com/guides/public/books/plugin-zevenet/page/matriz-de-compatibilidad)
# Matriz de compatibilidad
| **Sistemas donde se ha probado** | CentOS 7
|
| **Sistemas donde debería funcionar** | Cualquier servidor de PandoraFMS Version 7.0NG
|
| **Balanceador** | Zevenet con acceso a API Rest (Zapi)
|
[< ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/introduccion) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/pre-requisitos)
# Pre requisitos
Se requiere :
- Balanceador **Zevenet 6.x**
- Generar **ZAPI Key** desde el balanceador **ZAPI V4.0**
- Tener el **Data Server** de Pandora FMS habilitado
- Tener el **Plugin Server** de Pandora FMS habilitado
[< ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/matriz-de-compatibilidad) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/configuracion-zevenet)
# Configuración Zevenet
Desde el balanceador es necesario crear un nuevo usuario y crear una **ZAPI Key,** para esto desde la GUI del Balanceador
Para entrar en el balanceador desde nuestro navegador entramos a la gestión del equipo utilizando [https://ip-zevenet:444](https://ip-zevenet:444)
Validamos nuestro usuario en este ejemplo es **root**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625601035141.png)
Buscamos **Sistema -> RBAC -> Usuarios**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625601519993.png)
Hacemos click en **CREATE USER**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625601626414.png)
Completamos los datos como se ve en la siguiente pantalla:
Nombre: **Nombre de usuario**
Perfil: **Local (Validación local)** Contraseña: **clave de acceso al usuario**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625601711402.png)
En unos segundos el usuario se creo en forma exitosa
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602002411.png)
Para la utilizar el plugin en PandoraFMS es necesario tener permisos de consulta a la ZAPI de Zevenet vamos a ajustar los permisos para tener un perfil de solo lectura que nos permita leer la información del balanceador lo hacemos con los siguientes ajustes vamos a crear un nuevo grupo **PandoraFMS** y al mismo le vamos a otorgar permisos de **monitoring** un rol existente en el balanceador
**Vamos a Sistema -> RBAC -> Grupos**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602383698.png)
Selecionamos **CREAR GRUPO**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602436644.png)
Le damos un nombre al grupo **PandoraFMS** y seleccionamos **APLICAR**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602539256.png)
Luego de crear el grupo sumamos al usuario **pandorafms** y el rol **monitoring** le seleccionamos **APLICAR**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602852653.png)
Vamos a **Recursos** para definir que acceso le vamos a dar el usuario
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625611868028.png)
Si queremos que el usuario tenga acceso a todas las granjas y las interfaces seleccionamos **todas las granjas** y **todas las interfaces**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625611963640.png)
Nuevamente vamos a **Sistema -> RBAC -> Usuarios**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625602999004.png)
Hacemos click en el nombre de usuario que creamos en los paso anteriores
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625603083799.png)
Seleccionamos P**ermisos de ZAPI -> GENERAR CLAVE ALTEATORIA**, copiamos los datos en Clave para ZAPI es el valor necesario para el Plug-in de servidor lo copiamos y guardamos para poder copiar y pegar y luego le damos **APLICAR**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625603196284.png)
**Nota: es importante copiar la clave ahora ya que luego no será visible para copiar y pegar y se deberá generar una nueva**
[< ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/pre-requisitos) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/configuracion-pandorafms)
# Configuracion PandoraFMS
Para poder utilizar este plug-in es indispensable contar con Python3 conectados por ssh ejecutamos los siguientes comandos
```shell
yum -y install python3 python3-pip
```
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625606150631.png)
Descagarmos el archivo para la instalación de los requerimientos con el siguiente comando
```shell
wget https://pandorafms.com/library/wp-content/uploads/2021/07/zevenet.txt
```
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625610193920.png)
Importamos el modulo request con con comando
```shell
pip3 install -r zevenet.txt
```
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625606293872.png)
Descargamos el plugin en nuestro equipo desde este [enlace](http://pandorafms.com/library/wp-content/uploads/2021/06/zevenet_plugin.pspz2)
Importamos el modulo en nuestro servidor de pandora desde el menú **Servidores -> Registro plugin**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624921763841.png)
Presionamos el botón **Selecionar archivo**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624922043434.png)
Buscamos el archivo [**zevenet\_plugin.pspz2**](http://pandorafms.com/library/wp-content/uploads/2021/06/zevenet_plugin.pspz2) que descargamos en el paso anterior, si aun no lo ha descargado lo puede hacer presionando el nombre y presionamos el botón **subir**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624922251397.png)
Validamos que el proceso funciono en forma correcta
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624922335754.png)
[<ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/configuracion-zevenet) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/primera-ejecucion-manual)
# Primera Ejecución Manual
Para poder utilizar el plug-in la primera vez vamos a ejecutarlo en forma manual para crear el agente y luego automatizar la ejecución periódica para teniendo la Zapi Key generada en el paso anterior nos conectamos a nuestro servidor de PandroaFMS via ssh y ejecutamos el siguientes comando
Ajustar los parámetros a su entorno
-i IP DNS del balanceador
-k Zapi Key
-n Agente en PandoraFMS
-v 1 (ejecutar en modo diagnostico)
```shell
/var/www/html/pandora_console/attachment/plugin/zevenet.py -i 192.168.110.231 -k JoTUW0a1SLX4BHHZvqEXTPplpEa7bbfb2tST1KctAGWhYncWVITVddj5bRK6iH0bV -n Zevenet01 -v 1
```
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625612774946.png)
**Si el valor es 1, la configuración es correcta si se produce un error será 0 y se deben revisar los pasos anteriores**
**[< ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/configuracion-pandorafms) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/agregar-monitor-para-ejecucion-plug-in)**
# Agregar Monitor para Ejecución Plug-in
Buscamos el agente creado en el paso anterior lo encontraremos en el grupo **Servers,** vamos a Monitorización -> Vista -> Vista de Grupo
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613137486.png)
Buscamos el agente **Zevenet01** creado en nuestra ejecución Manual, hacemos click en el nombre para editarlo
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613235348.png)
Desde el icono del engranaje -> **Gestionar**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613379959.png)
Seleccionamos -> **Modulos**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613553798.png)
Seleccionamos **Crear un nuevo modulo del servidor de complementos** y luego **Crear**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625611074679.png)
Nota: si no disponemos de esta opción es necesario activar el modulo de complementos en PandoraFMS
Nombre: **Zevenet01**
Tipo: **Generic boolean** Plugin: **Zevenet\_Zapi**[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624923784293.png)
Luego de Seleccionar el plugin vamos a tener disponible las opciones de configuración del plug-in
IP: **Dirección IP o nombre DNS del Balanceador**
Zapi Key: **Clave de acceso a API Rest generada en el Balanceador**
Agent Name: **Nombre del Agente en nuestro Servidor de PandoraFMS, el mismo que creamos en el paso anterior**
Cluster Data: **Si tiene un balanceador con HA configurado poner el valor en 1**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613696210.png)
Completando los datos correspondientes a su entorno seleccionar el botón Crear
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924173066.png)
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924160035.png)
Con este modulo se ejecuta el plug-in de servidor cada 6 minutos
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625613807907.png)
Finalizada la creación si todo es correcto en veremos que se genero un nuevo monitor con el nombre ZevenetRUN que devuelve un 1 si la ejecución es correcta, en el siguiente ejemplo vemos el resultado de tomar datos de 3 Balanceadores 2 en HA y uno independiente
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924362683.png)
[< ANTERIOR](https://pandorafms.com/guides/public/books/plugin-zevenet/page/primera-ejecucion-manual) [SIGUIENTE>](https://pandorafms.com/guides/public/books/plugin-zevenet/page/modulos-generados-por-el-plug-in)
# Modulos Generados por el Plug-in
Se toman los datos de aplicación del balanceador, los mismos que podemos ver en la GUI del producto
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924687226.png)GUI Zevenet
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924727433.png)
PandoraFMS
Se muestran los datos de las granjas (farms) de todas las que tenga configurada el equipo
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924809040.png)
**Ejemplo granja ReverseProxy**
También se ven todas las placas de red y los datos de trafico de las mismas
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924891654.png)
**Ejemplo con una placa de red eth0**
Si se activa el valor Cluster Data en 1 se obtienen estas métricas adicionales
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-06/image-1624924951980.png)
**Ejemplo de un Cluster en modo master**
Todos los datos generados son dinámicos y se ven reflejados si se realiza cualquier cambio en el balanceador como crear una nueva granja (Farm), agregar una nueva placa de red, etc.
[< ANTERIOR ](https://pandorafms.com/guides/public/books/plugin-zevenet/page/agregar-monitor-para-ejecucion-plug-in)