Introduction
Ce document décrit comment configurer des événements personnalisés dans AppDynamics à l'aide de l'API REST et comment les connecter aux règles d'intégrité pour les alertes automatisées.
Conditions préalables
- Accès à une instance AppDynamics SaaS ou à une instance de contrôleur sur site
- Autorisations de créer et de gérer des événements, des règles d'intégrité et des stratégies
- Contrôleur version 21.x ou ultérieure
- Canaux de notification (e-mail, SMS ou intégrations tierces) configurés
- Compréhension de base des API REST et de l'interface utilisateur AppDynamics
Exigences
Assurez-vous de respecter les conditions suivantes avant de commencer :
- AppDynamics Controller version 21.x ou ultérieure (pour les dernières fonctionnalités d'événement et d'alerte)
- Accès à l'API REST activé pour votre contrôleur
- Canaux de notification (e-mail, sms ou intégrations) configurés pour la remise des alertes
Composants utilisés
- Contrôleur AppDynamics
- Agents AppDynamics
- Canaux de notification
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
Dans un monde où les architectures natives du cloud sont de plus en plus dynamiques, la surveillance proactive est essentielle pour garantir la résilience du système et réduire le temps moyen de résolution (MTTR). AppDynamics offre des fonctionnalités d'observabilité robustes, notamment la possibilité de créer des événements et des alertes personnalisés qui aident les équipes d'exploitation à détecter les anomalies plus rapidement et à y répondre avec précision.
Les mesures prêtes à l'emploi sont essentielles, mais les systèmes modernes nécessitent souvent une observabilité spécifique au contexte. Que vous intégriez des pipelines CI/CD, des outils d'automatisation personnalisés ou des systèmes externes, l'injection d'événements personnalisés dans AppDynamics garantit :
- Visibilité unifiée sur les indicateurs système et métier
- Détection en temps réel des anomalies spécifiques aux applications
- Intervention manuelle réduite grâce à des actions automatisées
Il est parfois judicieux de créer des événements personnalisés pour surveiller des aspects spécifiques de votre application. Cet article a pour but de vous guider sur la façon de créer des événements personnalisés via l'API REST dans AppDynamics controller et sur la façon de configurer une alerte basée sur l'événement personnalisé.
Configurer
Cette section couvre le processus détaillé de création d'événements personnalisés et de configuration d'alertes dans AppDynamics Controller.
Configurations
Étape 1 : Créer des événements personnalisés via l'API REST
Des événements personnalisés peuvent être générés à l'aide de l'API REST AppDynamics. Cela est utile pour intégrer des systèmes externes, des scripts personnalisés, une structure d'automatisation ou un outil tiers :
Exemple d'appel API :
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
Paramètres clés :
- Remplacez <controller-url> et <application_id> par les détails de votre contrôleur.
- Paramètres requis :
- gravité (INFO, WARN, ERROR)
- résumé (brève description)
- eventtype (doit être PERSONNALISÉ)
- customeventtype (votre étiquette de type d'événement personnalisé)
- commentaire (message détaillé facultatif)
Une demande réussie renvoie un ID d'événement confirmant la création
Exemple : "L'ID d'événement :550346816 a été créé."
Conseil de visibilité : N'oubliez pas d'activer le filtre Personnalisé dans l'interface des événements pour afficher les événements injectés.

Étape 2 : Filtrage et surveillance des événements personnalisés
- Dans l'interface utilisateur du contrôleur, accédez à la section Événements.
- Utilisez Filtrer par événements personnalisés pour ajouter votre type d'événement ou vos propriétés.
- Vous pouvez spécifier des paires clé/valeur pour un filtrage plus granulaire.
- Utilisez All pour la logique AND (toutes les propriétés doivent correspondre) ou Any pour la logique OR (au moins une propriété correspond)
Cela permet un suivi et une investigation ciblés des événements injectés dans votre application.
Étape 3 : Configuration des alertes : Actions et stratégies
Actions:
- Spécifiez ce qui se produit lorsqu'un événement personnalisé est déclenché (comme l'envoi d'e-mails, de sms ou l'appel d'un webhook) :

Politiques :
- Créer une nouvelle stratégie ou modifier une stratégie existante :

- Dans la stratégie, configurez le filtre d'événement personnalisé pour qu'il corresponde à l'événement personnalisé que vous avez défini.


- Dans l'onglet Actions de stratégie, ajoutez une nouvelle action et sélectionnez l'action personnalisée que vous avez créée :

- Enregistrez l'alerte : Après avoir configuré l'alerte, cliquez sur Save pour la créer :

Une fois que vous avez créé l'alerte, elle se déclenche chaque fois qu'un événement personnalisé correspondant aux critères spécifiés est généré dans le contrôleur.
Vérifier
- Publier un événement personnalisé de test via l'API REST :

- Confirmez la visibilité dans l'interface utilisateur Événements (vérifiez les filtres) :

- Vérifiez que l'action est déclenchée pour l'événement personnalisé :

- Validez la livraison via le canal de notification configuré :


Dépannage
Problème |
Étapes de dépannage |
Événement non visible
|
- Assurez-vous que le filtre personnalisé est eventtype activé dans l'interface utilisateur Events
- Vérifiez à nouveau les paramètres eventtype et customeventtype dans votre appel API.
|
Erreurs API
|
- Erreur courante : «Le résumé de l'événement n'est pas spécifié.» Toujours fournir un résumé dans votre demande
- Vérifiez l'authentification et l'ID d'application dans l'appel API.
|
Alerte non déclenchée
|
- Vérifiez que la règle et la stratégie d'intégrité sont correctement configurées.
- Vérifiez la configuration du canal de notification (configuration du serveur e-mail/sms).
|
Limites d'événements personnalisées
|
- Le contrôleur a des limites sur le nombre de schémas d'événements personnalisés et la taille des événements.
- Consultez la documentation si vous enregistrez des volumes importants ou des schémas complexes
|
Conclusion
Les événements personnalisés et les alertes dans AppDynamics offrent un moyen puissant d'enrichir votre stratégie d'observabilité. Que vous intégriez des outils CI/CD, des services externes ou que vous vous contentiez d'étendre la visibilité dans les flux de travail clés, ces fonctionnalités garantissent une détection et une résolution plus rapides des problèmes avant qu'ils n'affectent les utilisateurs. Commencez par tirer parti de l'intelligence d'observabilité personnalisée pour élever votre surveillance de réactive à prédictive.
Besoin d'une assistance supplémentaire
Si vous avez une question ou rencontrez des problèmes, veuillez contacter le support AppDynamics et inclure des détails tels que des messages d'erreur, des informations de configuration ou des journaux pertinents pour aider à accélérer le dépannage.
Informations connexes