Servicio NetScaler Console

Crear reglas de eventos

Puede configurar reglas para supervisar eventos específicos. Las reglas facilitan el filtrado de los eventos generados en la infraestructura.

Puede filtrar un conjunto de eventos configurando reglas con condiciones específicas y asignando acciones a las reglas. Cuando los eventos generados cumplen los criterios de filtro de la regla, se ejecuta la acción asociada a la regla.

Puede crear filtros para las siguientes condiciones:

  • Gravedad
  • Instancias de Citrix Application Delivery Controller (NetScaler)
  • Categoría
  • Objetos de error
  • Comandos de configuración
  • Mensajes

Después de crear eventos, puede asignar acciones a los eventos. Para obtener más información, consulte Agregar acciones de reglas de eventos.

Por ejemplo, como administrador, es posible que desee supervisar los eventos de «uso elevado de la CPU» en las instancias de NetScaler que podrían provocar una interrupción. Puede realizar cualquiera de las siguientes acciones para recibir notificaciones:

  • Cree una regla para supervisar las instancias y agregue una acción a la regla para recibir notificaciones cuando se produzcan dichos eventos.

  • Programa una regla para supervisar las instancias en un intervalo específico. Por lo tanto, recibirá notificaciones cuando dichos eventos ocurran dentro de ese intervalo.

La siguiente imagen explica el flujo de trabajo de cómo funcionan las reglas de eventos.

Cómo funcionan los eventos

Configurar una regla de eventos

Para configurar una regla de eventos, vaya a Infraestructura > Eventos > Reglas y haga clic en Agregar. En la página Crear regla , realice las siguientes tareas:

  1. Especifique el nombre y la familia de instancias

  2. Configurar la antigüedad del evento

  3. Elija la gravedad del evento que detecta la regla

  4. Especifique la categoría del evento

  5. Especificar instancias NetScaler a las que se aplica la regla

  6. Seleccionar objetos de error

  7. Especificar filtros avanzados

  8. Especificar las acciones que se deben realizar cuando la regla detecta un evento

Paso 1: Especificar el nombre y la familia de instancias

  1. Nombre. Introduzca un nombre para la regla del evento.

  2. Familiade instancias . Seleccione una familia de instancias en la lista desplegable Familia de instancias.

    Puede filtrar las reglas de eventos por familia de instancias para rastrear la instancia de NetScaler desde la que NetScaler Console recibe un evento.

    Especificar el nombre y la familia de instancias

Paso 2: Configurar la edad del evento

  1. Edad del evento. Especifique el intervalo de tiempo (en segundos) tras el cual NetScaler Console actualiza una regla de evento.

    Por ejemplo, quiere que se envíe un correo electrónico cada vez que la instancia de NetScaler tenga un evento de «uso elevado de la CPU» durante 60 segundos o más. Puede establecer la edad del evento en 60 segundos. Ahora, cada vez que su instancia de NetScaler tenga un evento de “uso elevado de CPU” durante 60 segundos o más, recibirá una notificación por correo electrónico.

    Nota:

    Laedad del evento es un campo obligatorio. El valor mínimo para la antigüedad del evento es de 60 segundos. Si deja el campo Antigüedad del evento en blanco, la regla del evento se aplica inmediatamente después de que se produzca el evento.

  2. Elige una de las siguientes opciones para hacer seguimiento de los eventos:

    • Omitir el registro de eventos hasta que se alcance la antigüedad del evento. Los eventos que se producen antes de la antigüedad especificada no se registran en la base de datos del servidor de NetScaler Console. Cuando se alcanza la antigüedad del evento, los eventos se registran en la base de datos y se activan las acciones de eventos configuradas.

    • Registrar los eventos al instante, independientemente de la antigüedad y duración del evento. Todos los eventos se registran en la base de datos del servidor de NetScaler Console, independientemente de la antigüedad de los eventos especificada. Una vez alcanzada la antigüedad del evento, se activan las acciones del evento configuradas.

    Configurar la antigüedad del evento

  3. Habilitar el filtro avanzado con coincidencia de expresiones regulares. Seleccione esta opción para incluir una expresión regular distinta de la coincidencia con patrón de asterisco (*). Esta opción es aplicable a los objetos de error, los comandos de configuración y los mensajes.

Paso 3: Elegir la gravedad del evento

  • En la sección Gravedad, seleccione una gravedad para la regla de evento.

    Puede definir los siguientes niveles de gravedad: Crítico, Mayor, Menor, Advertencia, Borrar e Información.

    Nota:

    Puede configurar la gravedad para eventos genéricos y específicos de Advanced. Para modificar la gravedad de los eventos de las instancias de NetScaler administradas en NetScaler Console, vaya a Infraestructura > Eventos > Configuración de eventos. Elija la categoría para la que quiere configurar la gravedad del evento y haga clic en Configurar gravedad. Asigne un nuevo nivel de gravedad y haga clic en Aceptar.

    Especificar la gravedad del evento

Paso 4: Especificar la categoría del evento

Puede especificar la categoría o las categorías de los eventos generados por las instancias NetScaler. Todas las categorías se crean en instancias de NetScaler. A continuación, estas categorías se asignan con la consola de NetScaler, que se puede utilizar para definir las reglas de eventos.

  • Seleccione la categoría que quiera considerar y muévala de la tabla Disponible a la tabla Configurada.

    En el ejemplo, debe elegir “cpuUtilization” como categoría de eventos en la tabla que se muestra.

    Especificar categoría de evento

Paso 5: Especificar instancias de NetScaler

En la sección Instancias, haga lo siguiente:

  1. Haga clic en Seleccionar instancias. En la página Seleccionar instancias, seleccione las direcciones IP de las instancias de NetScaler para las que quiere definir la regla de eventos.

  2. Haga clic en Seleccionar.

    Seleccione instancias de NetScaler

Paso 6: Seleccione objetos de error

Los objetos de error son instancias de entidad o contadores para los que se ha generado un evento.

  1. Haga clic en Seleccionar objetos de error.

  2. En la página Objetos de error, seleccione un objeto de error de la lista. Haga clic en Seleccionar.

  3. Para agregar un objeto de error, introduzca una expresión regular en Agregar objetos de error. Según la expresión regular especificada, los objetos de error se agregan automáticamente a la lista.

    Importante:

    Para enumerar los objetos fallidos mediante expresiones regulares, seleccione Habilitar filtro avanzado con coincidencia de expresiones regulares en el paso1.

    El filtro avanzado le permite realizar un seguimiento rápido de los problemas en los objetos de error e identificar la causa de un problema. Por ejemplo, si un usuario tiene problemas para iniciar sesión, el objeto de error es el nombre de usuario o la contraseña, como nsroot.

  4. Para agregar entidades, elija una entidad de Seleccionar entidades.

    Esta lista puede incluir nombres de contador para todos los eventos relacionados con los umbrales, nombres de entidades para todos los eventos relacionados con la entidad, nombres de certificados para los eventos relacionados con los certificados, etc.

    Seleccionar objetos de error

Paso 7: Especificar filtros avanzados

Puede filtrar aún más una regla de evento con filtros avanzados. Seleccione uno de los siguientes filtros:

  • Comandos de configuración: Especifique el comando de configuración completo o especifique una expresión regular para filtrar los eventos.

    También puede filtrar las reglas de eventos según el estado de autenticación del comando y su estado de ejecución. Por ejemplo, para a NetscalerConfigChange event, escriba [.]*bind system global policy_name[.]*.

    Filtro de comandos de configuración avanzada

  • Mensajes: Especifique la descripción completa del mensaje o especifique una expresión regular para filtrar los eventos.

    Por ejemplo, para un evento NetscalerConfigChange, escriba [.]*ns_client_ipaddress :10.122.132.142[.]* or ns_client_ipaddress :^([.]*10.122.132.142[.]*).

    Filtros de mensajes avanzados

Importante:

Para filtrar los comandos y mensajes de configuración mediante expresiones regulares distintas de la coincidencia de patrones con asterisco (*), seleccione Habilitar filtro avanzado con coincidencia de expresiones regulares en el paso 1.

Paso 8: Agregar acciones de reglas de eventos

Puede agregar acciones de regla de evento para asignar acciones de notificación a un evento. Estas notificaciones se envían o se realizan cuando un evento cumple los criterios de filtro definidos que estableciste en el paso 7.

  1. Haga clic en Agregar acción.

  2. En la página Agregar acción de evento, puede agregar las siguientes acciones de evento:

Acción de envío de correo electrónico

Al elegir Enviar acción de correo electrónico, se activa un correo electrónico cuando los eventos cumplen los criterios de filtro definidos.

  1. Lista de distribución de correo electrónico. Seleccione una lista de distribución de correo electrónico. Para agregar una lista de distribución, haga clic en Agregar.

    1. En la página Crear lista de distribución de correo electrónico, haga lo siguiente:

      1. Nombre. Agregue un nombre para la lista de distribución.

      2. Servidores de correo electrónico. Seleccione un servidor de correo electrónico. También puede agregar un servidor o modificar uno existente.

      3. De. Agregue la dirección de correo electrónico del remitente.

      4. Para. Agregue las direcciones de correo electrónico de los destinatarios. También puede especificar las direcciones de correo electrónico que se incluirán en la lista CC y Bcc.

      5. Haga clic en Crear.

  2. Asunto. Agregue una línea de asunto para sus correos electrónicos, como el nombre de la entidad afectada, es decir, el nombre del objeto de error. Esta línea de asunto proporciona información sobre el servidor virtual en el que se producen estos eventos.

    Nota:

    Si no agrega una línea de asunto, se muestra una línea de asunto predeterminada. La línea de asunto predeterminada solo proporciona información sobre la gravedad del evento, la categoría del evento y el objeto de error. El nombre del servidor virtual en el que se produjo el evento no está disponible.

  3. Adjunto. Cargue un adjunto al correo electrónico. Este adjunto se envía cuando un evento entrante coincide con la regla configurada.

  4. Prueba. Haga clic en este botón para enviar un correo electrónico de prueba después de configurar un servidor de correo electrónico, las listas distribuidas asociadas y otros parámetros. Esta opción le permite probar los parámetros configurados

  5. Repita la notificación por correo electrónico hasta que se borre el evento. Seleccione esta opción para asegurarse de que no se pierdan las notificaciones por correo electrónico en caso de eventos críticos. Esta opción envía correos electrónicos repetidos para las reglas de evento que cumplen los criterios seleccionados. Por ejemplo, ha creado una regla de evento para las instancias que implican errores de disco. Si quiere recibir una notificación hasta que se resuelva el problema, opte por recibir notificaciones repetidas por correo electrónico sobre esos eventos.

    Agregar acción de evento

  6. Haga clic en Aceptar.

Nota:

También puede agregar listas de distribución de correo electrónico si va a Parámetros > Notificaciones > Correo electrónico. Haga clic en Agregar y cree la lista.

Acción de captura de envío

Al elegir el tipo de acción de evento Enviar acción de captura, las capturas SNMP se envían o reenvían a un destino de captura externo. Los mensajes de captura se envían a la escucha de capturas específica cuando los eventos cumplen los criterios de filtro definidos.

  1. Lista de distribución de captura. Seleccione una lista de distribución de captura (o el destino de captura y los detalles del perfil de captura). Para crear una lista de distribución de captura, haga clic en Agregar.

  2. En la página Crear lista de distribución de captura, haga lo siguiente:

    1. Nombre del perfil. Introduzca el nombre del perfil.

    2. Destino de la captura. Introduzca el nombre o la dirección IP de la instancia que debe recibir los mensajes de captura.

    3. Número de puerto de la captura SNMP. Introduzca el número de puerto.

    4. Comunidad de captura. Introduzca el grupo al que pertenece la instancia.

      Agregar lista de distribución de captura

    5. Haga clic en Crear.

  3. Haga clic en Aceptar.

Ejecutar acción de comando

Al elegir la acción de evento Run Command Action, puede crear un comando o un script que se pueda ejecutar en NetScaler Console para los eventos que coincidan con un criterio de filtro determinado.

También puede establecer los siguientes parámetros para el script Run Command Action :

   
Parámetro Descripción
$fuente Este parámetro corresponde a la dirección IP de origen del evento recibido.
$categoría Este parámetro corresponde al tipo de trampas definidas en la categoría del filtro
$entidad Este parámetro corresponde a las instancias o contadores de entidades para los que se ha generado un evento. Puede incluir los nombres de los contadores de todos los eventos relacionados con el umbral, los nombres de las entidades de todos los eventos relacionados con la entidad y los nombres de los certificados de todos los eventos relacionados con los certificados.
$gravedad Este parámetro corresponde a la gravedad del evento.
$failure.obj El objeto de error afecta a la forma en que se procesa un evento y garantiza que el objeto de error muestre el problema exacto tal como se notificó. Esto se puede usar para rastrear problemas rápidamente e identificar el motivo de la falla, en lugar de simplemente informar eventos sin procesar.

Nota:

Durante la ejecución del comando, estos parámetros se reemplazan con valores reales.

Por ejemplo, considere que quiere establecer una acción de comando de ejecución cuando el estado de un servidor virtual de equilibrio de carga es Inactivo. Como administrador, puede que quiera ofrecer una solución rápida agregando otro servidor virtual. En NetScaler Console, puede:

  • Escriba un archivo de script (.sh).

    A continuación se muestra un archivo de script (.sh) de ejemplo:

     #!/bin/sh
     source=$1
     failureobj=$2
     payload='{"params":{"warning":"YES"},"lbvserver":{"name":"'$failureobj'","servicetype":"HTTP","ipv46":"x.x.x.x","port":"80","td":"","m":"IP","state":"ENABLED","rhistate":"PASSIVE","appflowlog":"ENABLED","
     bypassaaaa":"NO","retainconnectionsoncluster":"NO","comment":""}}'
     url="http://$source/nitro/v1/config/lbvserver"
     curl --insecure -basic -u nsroot:nsroot -H "Content-type: application/json" -X POST -d $payload $url
    
     <!--NeedCopy-->
    
  • Guarde el archivo.sh en cualquier ubicación persistente del agente. Por ejemplo, /var.

  • Proporcione la ubicación del archivo.sh en NetScaler Console para que se ejecute cuando se cumplan los criterios de la regla.

  1. En Lista de ejecución de comandos, haga clic en Agregar.

    Aparece la página Crear lista de distribución de comandos.

    1. Nombre del perfil. Especifique un nombre de su elección

    2. Ejecute el comando. Especifique la ubicación del agente en la que debe ejecutarse el script. Por ejemplo: sh/var/demo.sh $source $failureobj.

    3. Seleccione Anexar salida y Anexar errores

      Nota:

      Puede habilitar las opciones Anexar salida y Anexar errores si desea almacenar la salida y los errores generados (si los hay) al ejecutar un script de comandos en los archivos de registro del servidor de NetScaler Console. Si no habilita estas opciones, NetScaler Console descarta todos los resultados y errores generados al ejecutar el script de comandos.

    4. Haga clic en Crear.

  2. En la página Agregar acción de evento, haga clic en Aceptar.

    Establecer acción de comando de ejecución

    Nota:

    Puede habilitar las opciones Anexar salida y Anexar errores si desea almacenar la salida y los errores generados (si los hay) al ejecutar un script de comandos en los archivos de registro del servidor de NetScaler Console. Si no habilita estas opciones, NetScaler Console descarta todos los resultados y errores generados al ejecutar el script de comandos.

Ejecutar acción de trabajo

Al crear un perfil con trabajos de configuración, un trabajo se ejecuta como un trabajo integrado o personalizado para NetScaler, y las instancias SDX de NetScaler para eventos y alarmas que coinciden con los criterios de filtro que ha especificado.

  1. En Lista de perfiles de trabajo, seleccione un perfil de trabajo. Para agregar una lista, haga clic en Agregar.

  2. En la página Crear trabajo, haga lo siguiente:

    1. Seleccione Trabajo. Cree un perfil con un trabajo que quiera ejecutar cuando los eventos cumplan con los criterios de filtro definidos. Especifique un nombre de perfil, el tipo de instancia, la plantilla de configuración y la acción que quiere realizar si los comandos del trabajo fallan.

    2. Especifique los valores de las variables. En función del tipo de instancia seleccionado y de la plantilla de configuración elegida, especifique los valores de las variables.

    3. Haga clic en Finalizar para crear el trabajo.

    Especificar los valores de las variables

  3. Haga clic en Aceptar.

Acción de supresión

  • En Tiempo de supresión, introduzca un período de tiempo, en minutos, para el que se suprime o descarta un evento. Puede suprimir el evento durante un mínimo de 1 minuto.

    Suprimir evento

    Nota:

    También puede configurar el tiempo de supresión como 0 minutos y significa tiempo infinito. Si no especifica ninguna duración, NetScaler Console considera que el tiempo de supresión es cero y nunca caduca.

Enviar notificaciones de Slack

Cuando configura un canal de Slack, las notificaciones del evento se envían a este canal. Puede configurar muchos canales de Slack para recibir estas notificaciones

  1. En la Lista de perfiles de Slack, seleccione un perfil de Slack. Para agregar un perfil de Slack, haga clic en Agregar.

  2. En la página Crear perfil de Slack , haga lo siguiente:

    1. Nombre del perfil. Escriba un nombre para la lista de perfiles que se configurará en NetScaler Console.

    2. Nombre del canal. Escribe el nombre del canal de Slack al que se van a enviar las notificaciones de eventos.

    3. URL del webhook. Escriba la URL del webhook del canal que ha introducido. Los webhooks entrantes son una forma sencilla de publicar mensajes de fuentes externas en Slack. La URL está vinculada internamente al nombre del canal. Todas las notificaciones de eventos se envían a esta URL y, a continuación, se publican en el canal de Slack elegido. Un ejemplo de webhook es el siguiente: https://hooks.slack.com/services/T0******E/B9X55DUMQ/c4tewWAiGVTT51Fl6oEOVirK

    4. Haga clic en Crear.

  3. Haga clic en Aceptar.

Nota:

También puede agregar los perfiles de Slack desde Parámetros > Notificaciones > Perfiles de Slack. Haga clic en Agregar y cree el perfil.

Enviar notificaciones de PagerDuty

Puede añadir un perfil de PagerDuty como opción en NetScaler Console para supervisar las notificaciones de incidentes en función de sus configuraciones de PagerDuty. PagerDuty le permite configurar notificaciones a través de correo electrónico, SMS, notificaciones push y llamadas telefónicas en un número registrado.

  1. En la lista de perfiles de PagerDuty, seleccione un perfil de PagerDuty. Para agregar un perfil, haga clic en Agregar.

  2. En la página Crear perfil de PagerDuty:

    1. Nombre del perfil. Introduzca un nombre de perfil de su elección.

    2. Clave de integración. Introduzca la clave de integración.

      Puede obtener la clave de integración en su portal de PagerDuty.

    3. Haga clic en Crear.

Antes de agregar un perfil de PagerDuty en NetScaler Console, asegúrese de haber completado las configuraciones necesarias en PagerDuty. Para obtener más información, consulte la documentación de PagerDuty.

Puede seleccionar su perfil de PagerDuty como una de las opciones para recibir notificaciones de las siguientes funciones:

  • Eventos: lista de eventos que se generan para las instancias de NetScaler.

  • Licencias: lista de licencias que están actualmente activas, a punto de caducar, etc.

  • Certificados SSL: Lista de certificados SSL que se agregan a instancias NetScaler.

Caso de uso:

Considere un escenario en el que quiera:

  • Enviar notificaciones a su perfil de PagerDuty.

  • Configurar una llamada telefónica como una opción en PagerDuty para recibir notificaciones.

  • Recibir alertas de llamadas telefónicas para eventos de NetScaler.

Cree la configuración de PagerDuty. Una vez finalizada la configuración, cada vez que se genere un nuevo evento para la instancia de NetScaler, recibirá una llamada telefónica. Desde la llamada telefónica, puede decidir:

  • Reconoce el evento

  • Marcarlo como resuelto

  • Escalar a otro miembro del equipo

Enviar notificaciones de ServiceNow

Puede generar automáticamente incidentes de ServiceNow para los eventos de NetScaler Console seleccionando el perfil de ServiceNow en la GUI de NetScaler Console. Debe elegir el perfil de ServiceNow en NetScaler Console para configurar una regla de eventos.

Antes de configurar una regla de eventos para generar automáticamente los incidentes de ServiceNow, integre la consola de NetScaler con la instancia de ServiceNow. Para obtener más información, consulte Configurar el adaptador ITSM para ServiceNow.

  1. En el perfil de ServiceNow, seleccione el perfil Citrix_Workspace_SN de la lista.

  2. Haga clic en Aceptar.