Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Surveiller les événements de service

Service Events fournit une observabilité approfondie automatisée pour les services surveillés à CloudWatch l'aide de signaux d'application. Il capture les mesures d'erreur, les données de performances au niveau des fonctions, les instantanés des incidents (lorsque les demandes dépassent les seuils de latence ou génèrent des exceptions) et les événements de déploiement, sans modification de code supplémentaire.

Comment fonctionnent les événements de service

Service Events collecte les types de signaux suivants provenant de vos services instrumentés :

Les événements de service sont automatiquement activés lorsque vous activez les signaux CloudWatch d'application pour votre service. Les mesures d'erreur et le suivi des exceptions sont actifs immédiatement. Function-call les métriques nécessitent une configuration supplémentaire : vous devez configurer les packages à instrumenter avant que les données d'appel de fonction ne soient collectées (voirActiver l'instrumentation fonctionnelle). Les événements de service peuvent être désactivés par réglageOTEL_AWS_SERVICE_EVENTS_ENABLED=false. Les données circulent depuis le SDK ADOT vers l' CloudWatch agent. L'agent publie les événements dans les CloudWatch journaux (groupes de /aws/service-events/service-name journaux) et CloudWatch les métriques.

Langages pris en charge : Java, Python et Node.js.

Stockage de données

Service Events stocke les données dans CloudWatch des journaux. CloudWatch publie les données des événements de service dans un groupe de journaux avec le préfixe/aws/application-signals/service-name, où service-name est la valeur de votre variable d'OTEL_SERVICE_NAMEenvironnement. Un groupe de journaux est créé par service.

L'ingestion et le stockage des journaux vous sont facturés aux tarifs standard CloudWatch des journaux.

Afficher les erreurs dans la console

Dans la CloudWatch console, accédez à Application Signals, choisissez votre service, puis choisissez l'onglet Erreurs. Cet onglet affiche les mesures relatives aux exceptions pour votre service.

L'onglet affiche :

Sélectionnez une exception pour accéder aux détails, notamment la trace de la pile, le message d'exception et un lien vers la trace associée.

Les erreurs sont regroupées par opération, type d'exception et cadres de la pile supérieure. Seul le représentant le plus récent de chaque groupe est indiqué.

Afficher les événements de service dans les journaux

Les données des événements de service sont stockées dans CloudWatch les journaux sous des groupes de journaux avec le préfixe/aws/service-events/service-name. Vous pouvez interroger ces données directement à l'aide de CloudWatch Logs Insights pour créer des vues personnalisées, créer des tableaux de bord ou enquêter sur des incidents spécifiques.

Pour interroger les événements de service :

Événements de service sur le serveur CloudWatch Application Signals MCP (Model Context Protocol)

Les données relatives aux événements de service sont accessibles via le serveur CloudWatch Application Signals MCP (Model Context Protocol), ce qui permet aux assistants de codage IA et aux agents d'interroger directement le comportement d'exécution de votre service.

Résolution des problèmes

Amélioration des performances

Pour les instructions de configuration et d'utilisation, consultez le serveur Application Signals MCP sur le GitHub site Web.

Configuration des événements de service

Conditions préalables

Pour utiliser les événements de service, assurez-vous de disposer des versions minimales requises des composants suivants :

Si vous utilisez Amazon EKS, consultez les instructions Activation de vos applications sur des clusters Amazon EKS de configuration du module complémentaire.

Fonctionnalités activées par défaut

Si vous utilisez CloudWatch Application Signals, les signaux d'événements de service suivants sont activés par défaut et aucune configuration supplémentaire n'est requise :

Les fonctionnalités suivantes sont facultatives et nécessitent la définition de variables d'environnement pour produire des données :

Paramètres généraux

Activer l'instrumentation fonctionnelle

L'instrumentation des fonctions est activée par défaut, mais elle ne produit aucune métrique tant que vous n'avez pas configuré les packages à instrumenter. Fournissez une liste d'autorisations de packages pour commencer à collecter la télémétrie par fonction :

Filtrage des terminaux

Le filtrage des terminaux contrôle les terminaux qui génèrent des mesures d'erreur sur les terminaux et des instantanés des incidents. Ces paramètres n'ont aucune incidence sur l'instrumentation des fonctions.

Seuils de latence

Utilisez les variables d'environnement suivantes pour configurer les seuils de latence pour les déclencheurs d'instantanés d'incidents.

Limitation de débit

Utilisez les variables d'environnement suivantes pour contrôler la vitesse à laquelle les données relatives aux événements de service sont collectées et rapportées.

Configuration des événements de déploiement

Les événements de déploiement sont toujours émis au démarrage de l'application et toutes les 24 heures. La fourniture de métadonnées de déploiement enrichit ces événements afin que vous puissiez corréler les incidents et les changements de performances avec des déploiements de code spécifiques.

Définissez les variables d'environnement suivantes sur les conteneurs ou les processus de votre application afin de fournir des métadonnées de déploiement :

Configurer les événements de déploiement avec GitHub Actions

Dans votre flux de travail GitHub Actions, utilisez les variables d'environnement intégrées pour renseigner les métadonnées de déploiement. Ajoutez les éléments suivants à votre étape de déploiement ou à votre environnement de conteneurs :

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Si vous déployez des images de conteneur, transmettez ces valeurs en tant que variables d'environnement dans la définition de votre tâche ou dans la spécification de votre pod. Vous pouvez les intégrer à l'image au moment de la génération ou les injecter au moment du déploiement via votre configuration de déploiement.

Configurez les événements de déploiement avec GitLab CI/CD

Dans votre GitLab CI/CD pipeline, utilisez les CI/CD variables prédéfinies pour renseigner les métadonnées de déploiement. Ajoutez les éléments suivants à votre tâche de déploiement :

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

Transmettez ces variables à vos conteneurs d'applications au moment du déploiement via votre plateforme d'orchestration de conteneurs (par exemple, en tant que variables d'environnement dans votre définition de tâche Amazon ECS ou dans le manifeste de déploiement Kubernetes).