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.
Amazon CloudWatch Application Signals est une solution de surveillance des performances des applications (APM) qui permet aux développeurs et aux opérateurs de surveiller l'état et les performances de leurs applications sans serveur créées à l'aide de Lambda. Vous pouvez activer la vigie applicative en un clic depuis la console Lambda, et vous n’avez pas besoin d’ajouter de code d’instrumentation ou de dépendances externes à votre fonction Lambda. Après avoir activé Application Signals, vous pouvez consulter toutes les mesures et traces collectées dans la CloudWatch console. Cette page explique comment activer et afficher les données de télémétrie de la vigie applicative pour vos applications.
Rubriques
Mode d’intégration de la vigie applicative à Lambda
Application Signals instrumente automatiquement vos fonctions Lambda à l'aide des bibliothèques AWS Distro for OpenTelemetry (ADOT)
Vous pouvez attacher cette couche en un clic en activant la vigie applicative dans la console Lambda. Lorsque vous activez la vigie applicative à partir de la console, Lambda effectue les opérations suivantes en votre nom :
-
Mise à jour du rôle d’exécution de la fonction pour inclure
CloudWatchLambdaApplicationSignalsExecutionRolePolicy
. Cette politique fournit un accès en écriture AWS X-Ray et aux groupes de CloudWatch journaux utilisés pour les signaux d'application. -
Ajout d’une couche à votre fonction qui instrument automatiquement la fonction pour capturer les données de télémétrie telles que les requêtes, la disponibilité, la latence, les erreurs et les défauts. Pour garantir le bon fonctionnement de la vigie applicative, supprimez tout code d’instrumentation du kit SDK X-Ray existant de votre fonction. Le code d’instrumentation personnalisé du kit SDK X-Ray peut interférer avec l’instrumentation fournie par la couche.
-
Ajout de la variable d’environnement
AWS_LAMBDA-EXEC_WRAPPER
à votre fonction et définition de sa valeur sur/opt/otel-instrument
. Cette variable d’environnement modifie le comportement de démarrage de votre fonction afin d’utiliser la couche de la vigie applicative. Elle est requise pour une instrumentation appropriée. Si cette variable d’environnement existe déjà, assurez-vous qu’elle est définie sur la valeur adéquate.
Tarification
L’utilisation de la vigie applicative pour vos fonctions Lambda entraîne des coûts. Pour plus d'informations sur les tarifs, consultez CloudWatch les tarifs Amazon
Environnements d'exécution pris en charge
L’intégration de la vigie applicative à Lambda fonctionne avec les environnements d’exécution suivants :
.NET 8
Java 11
Java 17
Java 21
Python 3.10
Python 3.11
Python 3.12
Python 3.13
Node.js 18.x
Node.js 20.x
Node.js 22.x
Activation de la vigie applicative dans la console Lambda
Vous pouvez activer la vigie applicative sur n’importe quelle fonction Lambda existante à l’aide d’un environnement d’exécution compatible. Les étapes suivantes expliquent comment activer la vigie applicative en un clic dans la console Lambda.
Pour activer la vigie applicative dans la console Lambda
-
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Choisissez votre fonction.
-
Choisissez l'onglet Configuration.
-
Dans le menu de gauche, sélectionnez Outils de surveillance et d’exploitation.
-
Dans le volet Outils de surveillance supplémentaires, choisissez Modifier.
-
Sous Signaux CloudWatch d'application et sous Signaux d'application, sélectionnez Activer. AWS X-Ray
-
Choisissez Save (Enregistrer).
Si c'est la première fois que vous activez les signaux d'application pour votre fonction, vous devez également effectuer une configuration unique de découverte de service pour les signaux d'application dans la CloudWatch console. Une fois que vous avez terminé cette configuration unique de découverte de service, la vigie applicative découvre automatiquement toutes les fonctions Lambda supplémentaires pour lesquelles vous activez la vigie applicative, dans toutes les régions.
Note
Une fois que vous avez appelé votre fonction mise à jour, les données de service peuvent prendre jusqu'à 10 minutes pour commencer à apparaître dans le tableau de bord des signaux d'application de la CloudWatch console.
Utilisation du tableau de bord de la vigie applicative
Après avoir activé les signaux d'application pour votre fonction, vous pouvez visualiser les métriques de votre application dans la CloudWatch console. Vous pouvez rapidement consulter le tableau de bord de la vigie applicative associé depuis la console Lambda en procédant comme suit :
Pour consulter le tableau de bord de la vigie applicative de votre fonction
-
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Choisissez votre fonction.
-
Choisissez l’onglet Surveiller.
-
Cliquez sur le bouton Afficher la vigie applicative. Vous accédez ainsi directement à la vue d'ensemble des signaux d'application pour votre service dans la CloudWatch console.
Par exemple, la capture d’écran suivante montre les métriques relatives à la latence, au nombre de requêtes, à la disponibilité, au taux de défaillance et au taux d’erreur pour une fonction sur une période de dix minutes.

Pour tirer le meilleur parti de votre intégration avec Application Signals, vous pouvez créer des objectifs de niveau de service (SLOs) pour votre application. Par exemple, vous pouvez créer de la latence SLOs pour garantir que votre application répond rapidement aux demandes des utilisateurs, ainsi que de la disponibilité SLOs pour suivre le temps de disponibilité. SLOs peut vous aider à détecter la dégradation des performances ou les pannes avant qu'elles n'affectent vos utilisateurs. Pour plus d'informations, consultez la section Objectifs de niveau de service (SLOs) dans le guide de CloudWatch l'utilisateur Amazon.