Citrix NetScaler monitoring

Este plugin coge metricas desde distintos orígenes.

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:

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:

A nivel de servicio: