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.

Surveillez 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 performance 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 à partir 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 pour 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 en configurantOTEL_AWS_SERVICE_EVENTS_ENABLED=false. Les données circulent du 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 cliquez sur l'onglet Erreurs. Cet onglet affiche les statistiques d'exception pour votre service.

L'onglet affiche :

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

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

Afficher les événements de service dans les journaux

Les données relatives aux événements de service sont stockées dans CloudWatch des 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 du service :

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

Les données des événements de service sont accessibles via le serveur CloudWatch Application Signals MCP (Model Context Protocol), ce qui permet aux assistants de codage et aux agents d'intelligence artificielle 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 des modules complémentaires.

Fonctionnalités activées par défaut

Si vous utilisez les signaux CloudWatch d'application, les signaux d'événements de service suivants sont activés par défaut sans qu'aucune configuration supplémentaire ne soit 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 points de terminaison contrôle les points de terminaison qui génèrent des mesures d'erreur sur les terminaux et des instantanés d'incidents. Ces paramètres n'affectent pas l'instrumentation des fonctions.

Seuils de latence

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

Limitation du 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 signalé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 des 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 ce qui suit à votre étape de déploiement ou à votre environnement de conteneur :

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 du pod. Vous pouvez les intégrer dans l'image au moment de la création 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 ce qui suit à 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).