# Citrix NetScaler monitoring
# Introducción
Este plugin permite monitorizar equipos de balanceo Citrix NetScaler a través de la API REST basada en JSON que provee el dispositivo.
Este plugin recolectará la lista de todos los servicios configurados en el dispositivo, así como la información de los mismos, creando un agente por servicio configurado.
# Matriz de compatibilidad
Sistemas donde se ha probado: NSMPX-10500.
Sistemas donde debería funcionar: API compatible.
# Prerequisitos
Los parámetros necesarios para la monitorización son:
- Nombre de usuario para autenticarse en el la API REST del dispositivo (solo lectura).
- Contraseña de dicho usuario.
- Url completa (FQDN/IP) y ruta de la API del dispositivo (por ejemplo: https://myns.mydomain/nitro/v1/stat/).
# Configuración
El fichero de configuración del plugin Pandora para Citrix NetScaler permite especificar los siguientes parámetros:
```
#================================================================
# Citrix NetScaler Plugin conf file
#================================================================
# Citrix NetScaler API configuration
ns_url = http://mycitrixns/nitro/v1/stat/
ns_user = username
ns_pass = password
# Services to be analized
# ns_services=service_name;value
# value = 0 -> main information
# value = 1 -> child information
ns_services=lbvserver;1
ns_services=system;0
# modules to be gathered
# comment to disable filter
modules_list = state,status,vbshealth,primaryaddress,cpuusage,disk1avail,memusagepcnt,powersupply2status
#,cursrvrconnections,establishedconn,totalrequests,totalrequestbytes,responsesrate,totalresponses,totalresponsebytes,vslbhealth
# NetScaler Agent configuration
agent_name = ns1.gslbi.dexmedia.com
# Agent configuration
agent_interval = 300
agent_group = Load Balancer
# Module interval
module_interval = 1
module_tags = Networking
module_group =
# Pandora API configuration
api_url = http://inna.lab.artica.lan/pandora_console/include/api.php
api_user = admin
api_user_pass = pandora
api_pass = 1234
# Pandora Server configuration
mode = tentacle
tentacle_ip = inna.lab.artica.lan
tentacle_port = 41121
tentacle_opts =
tentacle_client = "C:\Program Files\pandora_agent\util\tentacle_client.exe"
temp = .
```
Grupo de los módulos (clasificación).**ns\_url, ns\_user, ns\_pass**
Información básica (necesaria) para conectar con el NetScaler.
**ns\_services**
Servicios que se van a analizar (0→pertenecerán al agente principal – netscaler, 1→pertenecerán a los agentes de servicio).
**modules\_list**
Lista de módulos que se generarán.
**agent\_interval**
Intervalo de los agentes creados.
**agent\_group**
Grupo de los agentes creados.
**module\_interval**
Intervalo de los módulos.
**module\_tags**
Tags de seguridad para los módulos creados (separado por coma).
**module\_group**
**mode**
Puede ser tentacle o local. Si establecemos local, deberemos especificar una carpeta destino donde se entregarán los ficheros *.data* que contienen la información de los agentes extraída del NetScaler.
# Ejecución Manual
El plugin de Pandora FMS para la monitorización del sistema balanceador Citrix Netscaler se despliega de la siguiente manera:
Ejecución como plugin de servidor/ integración con crontab:
```
# /etc/crontab
# Netscaler Plugin
*/5 * * * * root /usr/bin/perl citrix_netscaler.pl citrix_netscaler.conf
```
Si falla la verificación de certificado, puedes usar PERL\_LWP\_SSL\_VERIFY\_HOSTNAME=0 al ejecutar el plugin, lo que se saltará ese paso.
# Módulos generados por el plugin
Los parámetros que monitoriza el plugin son:
**A nivel de NetScaler**:
- Información general de sistema (temperatura, uso de discos, uso de CPU, uso de RAM, voltajes, velocidad de los ventiladores, estado de la alimentación, etc.).
**A nivel de servicio**:
- Estado del servicio.
- Servidores que lo prestan (IP) y estado en cada uno de ellos.
- Conexiones (activas/totales/establecidas, etc.).
- Paquetes (recibidos/enviados/con fallos).
- Tasas de respuesta.
- Salud del servicio.