View a markdown version of this page

Débogage à l'aide des journaux des applications publiées dans Amazon CloudWatch Logs - AWS App Studio
Utilisation CloudWatch des requêtes Logs Insights pour filtrer et trier les journaux

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.

Débogage à l'aide des journaux des applications publiées dans Amazon CloudWatch Logs

Amazon CloudWatch Logs surveille vos AWS ressources et les applications que vous exécutez AWS en temps réel. Vous pouvez utiliser CloudWatch les journaux pour collecter et suivre des métriques, qui sont des variables que vous pouvez mesurer pour vos ressources et vos applications.

Pour le débogage des applications App Studio, CloudWatch Logs est utile pour suivre les erreurs qui se produisent lors de l'exécution d'une application, auditer les informations et fournir un contexte sur les actions des utilisateurs et les interactions propriétaires. Les journaux fournissent des données historiques, que vous pouvez utiliser pour auditer l'utilisation des applications et les modèles d'accès, ainsi que pour examiner les erreurs rencontrées par les utilisateurs.

Note

CloudWatch Les journaux ne fournissent pas de traces en temps réel des valeurs de paramètres transmises depuis l'interface utilisateur d'une application.

Suivez la procédure suivante pour accéder aux journaux de vos applications App Studio dans CloudWatch Logs.

  1. Dans le studio d'applications App Studio correspondant à votre application, localisez et notez l'identifiant de votre application en consultant l'URL. L'identifiant de l'application peut ressembler à ceci :802a3bd6-ed4d-424c-9f6b-405aa42a62c5.

  2. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  3. Dans le panneau de navigation, choisissez Groupes de journaux.

  4. Vous trouverez ici cinq groupes de journaux par application. Selon le type d'informations qui vous intéresse, sélectionnez un groupe et rédigez une requête pour les données que vous souhaitez découvrir.

    La liste suivante contient les groupes de journaux et indique quand utiliser chacun d'eux :

    1. /aws/appstudio/teamId/appId/TEST/app: permet de déboguer les réponses d'automatisation, les erreurs de composants ou le JavaScript code lié à la version de votre application actuellement publiée dans l'environnement de test.

    2. /aws/appstudio/teamId/appId/TEST/audit: permet de déboguer les erreurs de JavaScript code, telles que la visibilité ou la transformation conditionnelle, les échecs de requête et les erreurs utilisateur de connexion ou d'autorisations liées à la version de votre application actuellement publiée dans l'environnement de test.

    3. /aws/appstudio/teamId/setup: permet de surveiller les actions du créateur ou de l'administrateur.

    4. /aws/appstudio/teamId/appId/PRODUCTION/app: permet de déboguer les réponses automatisées, les échecs de requêtes, les erreurs de composants ou le JavaScript code lié à la version de votre application actuellement publiée dans l'environnement de production.

    5. /aws/appstudio/teamId/appId/PRODUCTION/audit: permet de déboguer les erreurs de JavaScript code, telles que la visibilité conditionnelle ou la transformation, ainsi que les erreurs utilisateur de connexion ou d'autorisations liées à la version de votre application actuellement publiée dans l'environnement de production.

    Note

    La plupart des journaux à utiliser pour le débogage sont classés dans l'espace de DebugLogClient noms.

  5. Une fois que vous êtes dans un groupe de journaux, vous pouvez soit sélectionner les flux de journaux les plus récents, soit un flux dont l'heure du dernier événement est la plus proche de l'heure qui vous intéresse, soit choisir de rechercher tous les flux de journaux pour rechercher tous les événements de ce groupe de journaux. Pour plus d'informations sur l'affichage des données de journal dans CloudWatch les journaux, voir Afficher les données de journal envoyées aux CloudWatch journaux.

Utilisation CloudWatch des requêtes Logs Insights pour filtrer et trier les journaux

Vous pouvez utiliser CloudWatch Logs Insights pour interroger plusieurs groupes de journaux à la fois. Une fois que vous avez identifié une liste de groupes de journaux contenant des informations de session, accédez à CloudWatch Logs Insights et sélectionnez les groupes de journaux. Ensuite, affinez davantage les entrées de journal cibles en personnalisant la requête. Voici quelques exemples de requêtes :

Liste des journaux contenant le mot clé : error 

fields @timestamp, @message
| filter @message like 'error'
| sort @timestamp desc

Journaux de débogage depuis l'environnement de test : 

fields @timestamp, @message
| filter namespace = "DebugLogClient"
| sort @timestamp desc

Nombre d'erreurs global de 504/404 /500 sur des intervalles de 5 minutes : 

filter @message like '/api/automation' and (@message like ': 404' or @message like ': 500' or @message like ': 504') 
| fields @timestamp, method, path, statusCode  
| stats count(*) as errorCount by bin(5m)

Pour plus d'informations sur CloudWatch Logs Insights, consultez l'article Analyser les données des CloudWatch journaux avec Logs Insights dans le guide de l'utilisateur Amazon CloudWatch Logs.