Crear reglas de eventos
Puede configurar reglas para supervisar eventos específicos. Las reglas facilitan la supervisión de un gran número de 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. Las condiciones para las que puede crear filtros son: Gravedad, instancias de Citrix Application Delivery Controller (Citrix ADC), categoría, objetos de error, comandos de configuración y mensajes.
Puede asignar las siguientes acciones a los eventos:
-
Enviar correo electrónico Acción: Envíe un correo electrónico para los eventos que coincidan con los criterios de filtro.
-
Enviar acción de captura: Enviar o reenviar capturas SNMP a un destino de captura externo
-
Ejecutar acción de comando: Ejecute un comando cuando un evento entrante cumpla con la regla configurada.
-
Ejecutar acción de trabajo: Ejecutar un trabajo es para eventos que coinciden con los criterios de filtro especificados.
-
Suprimir acción: Suprime la eliminación de un evento durante un período de tiempo específico.
-
Enviar notificaciones de demora: Envíe notificaciones en el canal de Slack configurado para los eventos que coincidan con los criterios de filtro.
-
Enviar notificaciones de PageDuty: Envíe notificaciones de eventos basadas en las configuraciones de PageDuty para los eventos que coincidan con los criterios de filtro.
-
Enviar notificaciones de ServiceNow: Generar automáticamente incidentes de ServiceNow para un evento que coincida con los criterios de filtro.
Para obtener más información, consulte Agregar acciones de reglas de eventos
También puede hacer que las notificaciones se reenvíen en un intervalo especificado hasta que se borre un evento. Además, puede personalizar el correo electrónico con una línea de asunto específica, un mensaje de usuario y un archivo adjunto.
Por ejemplo, como administrador, puede que quiera supervisar los eventos de “alto uso de CPU” para instancias específicas de Citrix ADC si esos eventos pueden provocar una interrupción de las instancias de Citrix ADC. Puede hacer lo siguiente:
-
Cree una regla para supervisar las instancias y especifique una acción que le envíe una notificación por correo electrónico cuando se produzca un evento en la categoría “alto uso de CPU”.
-
Programe la regla para que se ejecute a una hora específica, como entre las 11 AM y las 11 PM, de modo que no se le notifique cada vez que se genere un evento.
La configuración de una regla de evento implica las siguientes tareas:
-
Especificar instancias Citrix ADC a las que se aplica la regla
-
Especificar las acciones que se deben realizar cuando la regla detecta un evento
Paso 1: Definir una regla de evento
Vaya a Redes > Eventos > Reglas y haga clic en Agregar. Si quiere habilitar la regla, active la casilla de verificación Habilitar regla.
Puede establecer la opción Edad del evento para especificar el intervalo de tiempo (en segundos) después del cual Citrix ADM actualiza una regla de evento.
Nota:
El valor mínimo para la edad del evento es 60 segundos. Si mantiene el campo Edad del evento en blanco, la regla de evento se aplica inmediatamente después de que se produzca el evento.
Según el ejemplo anterior, es posible que quiera recibir una notificación por correo electrónico cada vez que su instancia de Citrix ADC tenga un evento de “alto uso de CPU” durante 60 segundos o más. Puede establecer la antigüedad del evento en 60 segundos, de modo que cada vez que su instancia de Citrix ADC tenga un evento de “alto uso de CPU” durante 60 segundos o más, reciba una notificación por correo electrónico con los detalles del evento.
También puede filtrar las reglas de eventos por familia de instancias para realizar un seguimiento de la instancia de Citrix ADC desde la que Citrix ADM recibe un evento.
Si quiere incluir una expresión regular distinta de la coincidencia de patrones de asterisco (*), seleccione Habilitar filtro avanzado con coincidencia de expresiones regulares.
Paso 2: Elija la gravedad del evento
Puede crear reglas de evento que utilicen la configuración de gravedad predeterminada. Severidad especifica la gravedad actual de los eventos que quiere agregar 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 Citrix ADC administradas en Citrix ADM, vaya a Redes > 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.
Paso 3: Especifique la categoría del evento
Puede especificar la categoría o las categorías de los eventos generados por las instancias Citrix ADC. Todas las categorías se crean en instancias de Citrix ADC. A continuación, estas categorías se asignan con Citrix ADM que se puede utilizar para definir reglas de eventos. Seleccione la categoría que quiera considerar y muévalo de la tabla Disponible a la tabla Configurada.
En el ejemplo anterior, deberá elegir “CPUusageHigh” como categoría de evento de la tabla mostrada.
Paso 4: Especificar instancias de Citrix ADC
Seleccione las direcciones IP de las instancias Citrix ADC para las que quiere definir la regla de evento. En la sección Instancias, haga clic en Seleccionar instancias. En la página Seleccionar Instancias, elija las instancias y haga clic en Seleccionar.
Paso 5: Seleccione objetos de error
Puede seleccionar un objeto de error de la lista proporcionada o agregar un objeto de error para el que se ha generado un evento. También puede especificar una expresión regular para agregar objetos de error. Dependiendo de la expresión regular especificada, los objetos de error se agregan automáticamente a la lista. Los objetos de error son instancias de entidad o contadores para los que se ha generado un evento.
Importante
Para enumerar objetos con errores mediante expresiones regulares, seleccione Habilitar filtro avanzado con coincidencia de expresiones regulares en el paso 1.
El objeto de error afecta a la forma en que se procesa un evento y garantiza que refleje el problema exacto tal como se notifica. Con este filtro, puede realizar un seguimiento rápido de los problemas de los objetos con errores e identificar la causa de un problema. Por ejemplo, si un usuario tiene problemas de inicio de sesión, el objeto de error aquí es el nombre de usuario o la contraseña, comonsroot
.
Esta lista puede contener nombres de contador para todos los eventos relacionados con umbrales, nombres de entidades para todos los eventos relacionados con entidades, nombres de certificados para eventos relacionados con certificados, etc.
Paso 6: Especificar filtros avanzados
Puede filtrar aún más una regla de evento por:
-
Comandos de configuración: Puede especificar el comando de configuración completo o especificar una expresión regular para filtrar eventos.
Puede filtrar aún más la regla de evento por el estado de autenticación del comando y/ o su estado de ejecución. Por ejemplo, para un
NetscalerConfigChange event
, escriba[.]*bind system global policy_name[.]*
. -
Mensajes: Puede especificar la descripción completa del mensaje o especificar una expresión regular para filtrar los eventos.
Por ejemplo, para unNetscalerConfigChange
evento, escriba[.]*ns_client_ipaddress :10.122.132.142[.]* or ns_client_ipaddress :^([.]*10.122.132.142[.]*)
.
Paso 7: Agregue acciones de regla 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 anteriormente. Puede agregar las siguientes acciones de evento:
-
Enviar correo electrónico Acción
-
Acción de captura de envío
-
Ejecutar acción de comando
-
Ejecutar acción de trabajo
-
Acción de supresión
-
Enviar notificaciones de Slack
-
Enviar notificaciones de PagerDuty
-
Enviar notificaciones de ServiceNow
Para establecer la acción de regla de evento de correo electrónico
Al elegir el tipo de acción de evento Enviar acción de correo electrónico, se activa un correo electrónico cuando los eventos cumplen los criterios de filtro definidos. Tendrá que crear una lista de distribución de correo electrónico proporcionando los detalles del servidor de correo o del perfil de correo o puede seleccionar una lista de distribución de correo electrónico que haya creado previamente.
Debido a la gran cantidad de servidores virtuales que se configuran en Citrix ADM, es posible que reciba un gran número de correos electrónicos cada día. Los correos electrónicos tienen una línea de asunto predeterminada que proporciona información sobre la gravedad del evento, la categoría del evento y el objeto de error. Pero la línea de asunto no contiene ninguna información sobre el nombre del servidor virtual del que se originan estos eventos. Ahora tiene la opción de incluir información adicional como el nombre de la entidad afectada, que es el nombre del objeto de error.
También puede agregar una línea de asunto personalizada y un mensaje de usuario, y cargar un archivo adjunto al correo electrónico cuando un evento entrante coincida con la regla configurada.
Al enviar correos electrónicos para notificaciones de eventos, es posible que quiera enviar un correo electrónico de prueba para probar la configuración configurada. El botón “Probar” ahora le permite enviar un correo electrónico de prueba después de configurar un servidor de correo electrónico, listas distribuidas asociadas y otros ajustes. Esta función garantiza que la configuración funcione bien.
También puede asegurarse de que se abordan todos los eventos críticos y que no se pierdan las notificaciones de correo electrónico importantes, activando la casilla de verificación Repetir notificación de correo electrónico hasta que se desactive el evento para enviar notificaciones de correo electrónico repetidas para las reglas de evento que cumplan los criterios seleccionados. Por ejemplo, si ha creado una regla de evento para las instancias que implican errores de disco y quiere recibir una notificación hasta que se resuelva el problema, puede optar por recibir notificaciones por correo electrónico repetidas sobre esos eventos.
Para establecer la acción de regla de evento de reventado
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. Al definir una lista de distribución de capturas (o un destino de captura y detalles de perfil de captura), los mensajes de captura se envían a detectores de capturas específicos cuando los eventos cumplen los criterios de filtro definidos.
Para establecer la acción Ejecutar comando
Al elegir la acción de evento Ejecutar acción de comando, puede crear un comando o un script que se puede ejecutar en Citrix ADM para eventos que coincidan con un criterio de filtro determinado.
También puede establecer los siguientes parámetros para el script Ejecutar acción de comando :
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 definido en la categoría del filtro |
$entidad | Este parámetro corresponde a las instancias de entidad o contadores para los que se ha generado un evento. Puede incluir los nombres de contador para todos los eventos relacionados con el umbral, nombres de entidad para todos los eventos relacionados con la entidad y nombres de certificado para todos los eventos relacionados con el certificado. |
$severidad | Este parámetro corresponde a la gravedad del evento. |
$failureobj | El objeto de error afecta a la forma en que se procesa un evento y garantiza que el objeto de error refleja el problema exacto tal como se ha notificado. 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, tenga en cuenta que quiere establecer una acción de comando ejecutar cuando el estado del servidor virtual de equilibrio de carga sea Desactivo. Como administrador, es posible que quiera considerar la posibilidad de proporcionar una solución rápida agregando otro servidor virtual. En Citrix ADM, 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 Citrix ADM. Por ejemplo,
/var
. -
Proporcione la ubicación del archivo.sh en Citrix ADM que se ejecutará cuando se cumplan los criterios de regla.
Para establecer la acción Ejecutar comando para crear un servidor virtual:
-
Definir la regla
-
Seleccione la gravedad del evento
-
Seleccione la entidadde categoría de eventos
-
Seleccione la instancia que tiene configurado el servidor virtual
-
Seleccionar o crear un objeto de error para el servidor virtual
-
En Acciones de regla de evento, haga clic en Agregar accióny seleccione Ejecutar acción de comandoen la lista Tipo de acción.
-
En Lista de ejecución de comandos, haga clic en Agregar.
Aparecerá la página Crear Lista de Distribución de Comandos.
-
En Nombre del perfil, especifique un nombre de su elección
-
En Ejecutar comando, especifique la ubicación del agente de Citrix ADM, donde debe ejecutarse el script. Por ejemplo:
/sh/var/demo.sh $source $failureobj
. -
Seleccione Anexar salida y Anexar errores
Nota
Puede habilitar las opciones Anexar salida y Anexar errores si quiere almacenar la salida y los errores generados (si los hay) al ejecutar un script en los archivos de registros del servidor Citrix ADM. Si no habilita estas opciones, Citrix ADM descarta todas las salidas y errores generados al ejecutar el script.
-
Haga clic en Crear.
-
-
En la página Agregar acción de evento, haga clic en Aceptar.
Nota
Puede habilitar las opciones Anexar salida y Anexar errores si quiere almacenar la salida y los errores generados (si los hay) al ejecutar un script en los archivos de registros del servidor Citrix ADM. Si no habilita estas opciones, Citrix ADM descarta todas las salidas y errores generados al ejecutar el script.
Para establecer la acción de trabajo Execute
Al crear un perfil con trabajos de configuración, un trabajo se ejecuta como un trabajo integrado o un trabajo personalizado para las instancias de Citrix ADC, Citrix ADC SDX y Citrix SD-WAN WO, para eventos y alarmas que coincidan con los criterios de filtro especificados.
-
En Acciones de regla de evento, haga clic en Agregar acción y seleccione Ejecutar acción de trabajo en la lista desplegable Tipo de acción.
-
Cree un perfil con un trabajo que quiera ejecutar cuando los eventos cumplan los criterios de filtro definidos.
-
Al crear un trabajo, 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.
-
En función del tipo de instancia seleccionado y de la plantilla de configuración elegida, especifique los valores de las variables y haga clic en Finalizar para crear el trabajo.
Para establecer la acción de supresión
Al elegir la acción de evento Suprimir acción, puede configurar un período de tiempo, en minutos, para el que se suprime o elimina un evento. Puede suprimir el evento durante un mínimo de 1 minuto.
Para configurar notificaciones de Slack desde Citrix ADM
Configure el canal de Slack requerido proporcionando el nombre del perfil y la URL de webhook en la GUI de Citrix ADM. Las notificaciones de eventos se envían a este canal. Puede configurar varios canales de Slack para recibir estas notificaciones
-
En Citrix ADM, vaya aRedes>Eventos>Reglas y haga clic enAgregarpara crear una regla.
-
En la página Crear regla, defina los parámetros de regla como gravedad y categoría. Seleccione instancias y también objetos de error que deban supervisarse.
-
EnAcciones de regla de evento, haga clic enAgregar acción. A continuación, seleccione Enviar notificaciones de Slack en la lista Tipo de acción y seleccione Lista de perfiles de Slack.
-
También puede agregar una lista de perfiles de Slack haciendo clic en Agregar junto al campo Lista de perfiles de Slack.
-
Escriba los siguientes parámetros para crear una lista de perfiles:
-
Nombre del perfil. Escriba un nombre para la lista de perfiles que se va a configurar en Citrix ADM
-
Nombre del canal. Escriba el nombre del canal de Slack al que se van a enviar las notificaciones de eventos.
-
URL de Webhook. Escriba la URL de Webhook del canal que ha introducido anteriormente. Los Webhooks entrantes son una forma sencilla de publicar mensajes de fuentes externas en Slack. La URL está vinculada internamente al nombre del canal y todas las notificaciones de eventos se envían a esta URL para que se publiquen en el canal de Slack designado. Un ejemplo de webhook es el siguiente:https://hooks.slack.com/services/T0******E/B9X55DUMQ/c4tewWAiGVTT51Fl6oEOVirK
-
-
Haga clic en Crear y haga clic en Aceptar en la ventana Agregar acción de evento.
NotaTambién
puede agregar los perfiles de Slack navegando a Sistema > Notificaciones > Perfiles de Slack. Haga clic en Agregar y cree el perfil como se describe en la sección anterior.
Puede ver el estado de los perfiles de Slack que ha creado.
La regla de evento se crea ahora con filtros apropiados y acciones de regla de evento bien definidas.
Para establecer notificaciones de PagerDuty desde Citrix ADM
Puede agregar un perfil de PagerDuty como opción en Citrix ADM para supervisar las notificaciones de incidentes en función de las configuraciones de PagerDuty. PagerDuty le permite configurar notificaciones a través de correo electrónico, SMS, notificaciones push y llamadas telefónicas en el número registrado.
Antes de agregar un perfil de PagerDuty en Citrix ADM, 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 Citrix ADC.
-
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 Citrix ADC.
Para agregar un perfil de PagerDuty en ADM:
-
Inicie sesión en Citrix ADM mediante credenciales de administrador.
-
Vaya a Sistema > Notificaciones > Perfiles de PagerDuty.
-
Haga clic en Agregar para crear un nuevo perfil.
-
En la página Crear Perfil de PagerDuty:
-
Proporcione un nombre de perfil de su elección.
-
Introduzca la clave de integración.
Puede obtener la clave de integración desde su portal PagerDuty.
-
Haga clic en Crear.
Caso de uso:
Considere un caso que:
-
quiere enviar notificaciones a su perfil de PagerDuty.
-
han configurado la llamada telefónica como una opción en PagerDuty para recibir notificaciones.
-
quiere recibir alertas de llamadas telefónicas para eventos Citrix ADC.
Para llevar a cabo la configuración:
-
Vaya a Eventos > Reglas
-
En la página Crear regla, configure todos los demás parámetros para crear una regla.
-
En Crear acciones de regla, haga clic en Agregar acción.
Aparecerá la página Agregar acción de evento.
-
En Tipo de acción, seleccione Enviar notificaciones de tareas de pager.
-
Seleccione su perfil de PagerDuty y haga clic en Aceptar.
-
Una vez completada la configuración, cada vez que se genere un nuevo evento para la instancia de Citrix ADC, recibirá una llamada telefónica. Desde la llamada telefónica, puede decidir:
-
Reconocer el evento
-
Marcarlo como resuelto
-
Escalar a otro miembro del equipo
-
Para generar automáticamente incidentes de ServiceNow desde Citrix ADM
Puede generar automáticamente incidentes de ServiceNow para eventos Citrix ADM seleccionando el perfil ServiceNow en la GUI de Citrix ADM. Debe elegir el perfil ServiceNow en Citrix ADM para configurar una regla de evento.
Antes de configurar una regla de evento para generar automáticamente incidentes de ServiceNow, integre Citrix ADM con una instancia de ServiceNow. Para obtener más información, consulte Configurar el adaptador ITSM para ServiceNow.
Para configurar una regla de evento, vaya a Eventos > Reglas.
-
En la página Crear regla, configure todos los demás parámetros para crear una regla.
-
En Crear acciones de regla, haga clic en Agregar acción.
Aparecerá la página Agregar acción de evento.
-
En Tipo de acción, seleccione Enviar notificaciones de ServiceNow.
-
En ServiceNow Profile, seleccione el perfilCitrix_Workspace_SNde la lista.
-
Haga clic en Aceptar.
-