View a markdown version of this page

Surveillez les performances des applications avec Amazon CloudWatch Application Signals - AWS Lambda

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 performances des applications avec Amazon CloudWatch Application Signals

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 métriques 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.

Mode d’intégration de la vigie applicative à Lambda

Application Signals instrumente automatiquement vos fonctions Lambda à l'aide de bibliothèques AWS Distro for OpenTelemetry (ADOT) améliorées, fournies via une couche Lambda. La vigie applicative lit les données collectées par la couche et génère des tableaux de bord contenant des indicateurs de performance clés pour vos applications.

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 aux groupes de CloudWatch journaux utilisés pour les signaux d'application AWS X-Ray et fournit un accès en écriture.

  • 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 des signaux d'application, supprimez tout code d'instrumentation du X-Ray SDK existant de votre fonction. Le code d'instrumentation du X-Ray SDK personnalisé 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 pour utiliser la couche Application Signals et 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 prix, consultez la section CloudWatch Tarification d'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 18x

  • Node.js 20x

  • Node.js 22x

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
  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez votre fonction.

  3. Choisissez l'onglet Configuration.

  4. Dans le menu de gauche, sélectionnez Outils de surveillance et d’exploitation.

  5. Dans le volet Outils de surveillance supplémentaires, choisissez Modifier.

  6. Sous Signaux CloudWatch d'application et sous Signaux d'application, choisissez Activer. AWS X-Ray

  7. Choisissez 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 invoqué 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 statistiques 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
  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez votre fonction.

  3. Choisissez l’onglet Surveiller.

  4. Cliquez sur le bouton Afficher la vigie applicative. Cela vous amène 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.

Tableau de bord des signaux d'application pour une fonction Lambda illustrant la latence, les demandes, la disponibilité, le taux de défaillance et le taux d'erreur.

Pour tirer le meilleur parti de votre intégration à la vigie applicative, vous pouvez créer des objectifs de niveau de service (SLO) pour votre application. Par exemple, vous pouvez créer des SLO de latence pour garantir que votre application répond rapidement aux requêtes des utilisateurs, et des SLO de disponibilité pour suivre la durée de fonctionnement. Les SLO peuvent 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 (SLO) dans le Guide de CloudWatch l'utilisateur Amazon.