Introducción
Este documento describe cómo configurar eventos personalizados en AppDynamics mediante la API REST y conectarlos a reglas de estado para alertas automatizadas.
Prerequisites
- Acceso a una instancia de AppDynamics SaaS o del controlador en las instalaciones
- Permisos para crear y administrar eventos, reglas de mantenimiento y directivas
- Controller versión 21.x o posterior
- Canales de notificación (correo electrónico, SMS o integraciones de terceros) configurados
- Comprensión básica de las API REST y la interfaz de usuario de AppDynamics
Requirements
Asegúrese de cumplir estos requisitos antes de comenzar:
- AppDynamics Controller versión 21.x o posterior (para las últimas características de eventos y alertas)
- Acceso a la API REST habilitado para el controlador
- Canales de notificación (correo electrónico, SMS o integraciones) configurados para la entrega de alertas
Componentes Utilizados
- Controlador AppDynamics
- Agentes de AppDynamics
- Canales de notificación
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
Antecedentes
En un mundo de arquitecturas nativas de la nube cada vez más dinámicas, la supervisión proactiva es esencial para garantizar la resistencia del sistema y reducir el tiempo medio de resolución (MTTR). AppDynamics ofrece sólidas capacidades de observación, incluida la capacidad de crear eventos y alertas personalizados que ayudan a los equipos de operaciones a detectar anomalías más rápidamente y responder con precisión.
Las métricas inmediatas son fundamentales, pero los sistemas modernos a menudo requieren una observabilidad específica del contexto. Tanto si está integrando canalizaciones CI/CD, herramientas de automatización personalizadas o sistemas externos, la inyección de eventos personalizados en AppDynamics garantiza:
- Visibilidad unificada de los indicadores empresariales y del sistema
- Detección en tiempo real de anomalías específicas de las aplicaciones
- Reducción de la intervención manual mediante acciones automatizadas
A veces tiene sentido crear eventos personalizados para supervisar aspectos específicos de la aplicación. En este artículo se explica cómo crear eventos personalizados a través de la API REST en el controlador de AppDynamics y cómo configurar una alerta basada en el evento personalizado.
Configurar
Esta sección trata el proceso paso a paso para crear eventos personalizados y configurar alertas en AppDynamics Controller.
Configuraciones
Paso 1: Crear eventos personalizados a través de la API REST
Los eventos personalizados se pueden generar mediante la API REST de AppDynamics. Esto resulta útil para integrar sistemas externos, scripts personalizados, marco de automatización o herramientas de terceros:
Ejemplo de llamada API:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
Parámetros clave:
- Reemplace <controller-url> y <application_id> por sus detalles de Controller.
- Parámetros necesarios:
- gravedad (INFO, ADVERTENCIA, ERROR)
- resumen (breve descripción)
- eventtype (debe ser CUSTOM)
- customeventtype (su etiqueta de tipo de evento personalizado)
- comentario (mensaje detallado opcional)
Una solicitud correcta devuelve un ID de evento que confirma la creación
Ejemplo: "Se ha creado correctamente el ID de evento:550346816"
Sugerencia de visibilidad: No olvide habilitar el filtro personalizado en la interfaz de usuario de eventos para ver los eventos insertados.

Paso 2: Filtrado y supervisión de eventos personalizados
- En la interfaz de usuario del controlador, desplácese a la sección Eventos.
- Utilice Filtrar por eventos personalizados para agregar el tipo o las propiedades de evento.
- Puede especificar pares clave/valor para un filtrado más granular.
- Utilice All para la lógica AND (todas las propiedades deben coincidir) o Any para la lógica OR (al menos una propiedad coincide)
Esto permite realizar un seguimiento e investigación dirigidos de los eventos inyectados en toda la aplicación.
Paso 3: Configuración de alertas: Acciones y políticas
Acciones:
- Especifique qué ocurre cuando se activa un evento personalizado (como enviar correo electrónico, SMS o invocar un webhook):

Políticas:
- Cree una nueva política o edite una existente:

- En la directiva, configure el filtro de eventos personalizados para que coincida con el evento personalizado definido.


- En la ficha Acciones de directiva, agregue una nueva acción y seleccione la acción personalizada que ha creado:

- Guardar la alerta: Una vez configurada la alerta, haga clic en Guardar para crearla:

Una vez creada la alerta, se desencadena siempre que se genera en el controlador un evento personalizado que coincide con los criterios especificados.
Verificación
- Publica un evento personalizado de prueba a través de la API REST:

- Confirme la visibilidad en la interfaz de usuario de Events (verifique los filtros):

- Validar que Action se desencadene para el evento personalizado:

- Validar la entrega a través del canal de notificación configurado:


Troubleshoot
Problema |
Pasos para la resolución de problemas |
Evento no visible
|
- Asegúrese de que el filtro personalizado esté habilitado como tipo de evento en la interfaz de usuario de eventos
- Compruebe dos veces los parámetros eventtype y customeventtype en la llamada a la API.
|
Errores de API
|
- Error común: "No se ha especificado el resumen del evento." Proporcione siempre un resumen en su solicitud
- Verifique la autenticación y el ID de aplicación en la llamada API.
|
Alerta no desencadenada
|
- Confirme que la regla y la directiva de mantenimiento están configuradas correctamente.
- Verifique la configuración del canal de notificación (configuración del servidor de correo electrónico/sms).
|
Límites de eventos personalizados
|
- El controlador tiene límites en el número de esquemas de eventos personalizados y en el tamaño del evento.
- Revisar la documentación si se registran grandes volúmenes o esquemas complejos
|
Conclusión
Los eventos personalizados y las alertas en AppDynamics ofrecen una poderosa manera de enriquecer su estrategia de observabilidad. Tanto si está integrando herramientas de CI/CD, servicios externos o simplemente ampliando la visibilidad en flujos de trabajo clave, estas capacidades garantizan una detección y resolución de problemas más rápida antes de que afecten a los usuarios. Comience a aprovechar la inteligencia de observabilidad personalizada para elevar su supervisión de reactiva a predictiva.
Necesita más ayuda
Si tiene alguna pregunta o tiene problemas, póngase en contacto con AppDynamics Support e incluya detalles como mensajes de error, información de configuración o registros relevantes para ayudar a acelerar la solución de problemas.
Información Relacionada