View a markdown version of this page

Informations sur CloudWatch les journaux d'accès - Générateur d'applications d'IA générative sur AWS

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.

Informations sur CloudWatch les journaux d'accès

Cette solution enregistre les messages d'erreur, d'avertissement, d'information et de débogage pour les fonctions Lambda. Pour choisir le type de messages à enregistrer :

  1. Recherchez la fonction applicable dans la console AWS Lambda.

  2. Ajoutez une variable d'environnement POWERTOOLS_LOG_LEVEL.

  3. Définissez la variable sur le type de message applicable.

Pour obtenir des instructions supplémentaires, consultez la section Création de variables d'environnement Lambda dans le guide du développeur AWS Lambda.

Le tableau suivant répertorie les types de niveaux de journalisation parmi lesquels vous pouvez choisir.

Niveau Description

ERREUR

Les journaux contiennent des informations sur tout ce qui entraîne l'échec d'une opération.

WARNING

Les journaux contiennent des informations sur tout élément susceptible de provoquer des incohérences dans la fonction, mais pas nécessairement de provoquer l'échec de l'opération. Les journaux incluent également des messages d'erreur.

INFOS

Les journaux contiennent des informations de haut niveau sur le fonctionnement de la fonction. Les journaux contiennent également des messages d'erreur et d'avertissement.

DÉBOGAGE

Les journaux contiennent des informations qui peuvent être utiles lors du débogage d'un problème lié à la fonction. Les journaux incluent également des messages d'erreur, d'avertissement et d'information.

Utilisez la procédure suivante pour ajouter CloudWatch Logs Insights à cette solution.

  1. Identifiez les groupes de journaux pertinents :

    1. Connectez-vous à la CloudFormation console AWS.

    2. Choisissez votre pile cible.

    3. Sélectionnez l'onglet Ressources et recherchez vos fonctions Lambda cibles.

    4. Connectez-vous à la console AWS Lambda et choisissez chacune de vos fonctions Lambda cibles.

    5. Pour chacune de vos fonctions Lambda cibles, sélectionnez l'onglet Monitor et choisissez View CloudWatch Logs.

    6. Copiez les noms des groupes de journaux dont vous souhaitez extraire des informations.

  2. Accédez à la CloudWatch console Amazon.

  3. Dans le menu de navigation, sous Logs, sélectionnez Logs Insights.

  4. Sur la page Logs Insights, choisissez l'onglet Logs.

  5. Recherchez les noms des groupes de journaux à partir de l'étape 1.

  6. Copiez l'un des exemples de requêtes suivants et collez-le dans le champ de requête :

    1. Pour identifier toutes les exceptions du client :

      fields @message
|filter @message like /(?i)Exception/|stats count(*) as exceptionCount by @message

    2. Pour récupérer le nombre d'appels par nom de fonction :

      stats count(*) by function_name

    3. Pour récupérer le nombre d'invocations sur des intervalles de cinq minutes, procédez comme suit :

      stats count(*) as invocations by bin(5m)

    4. Pour récupérer toutes les traces d'AWS X-Ray, procédez comme IDs suit :

      filter @message like "XRAY TraceId"
|parse @message "XRAY TraceId: * " as traceId|stats count(*) by traceId

    5. Pour récupérer les journaux relatifs à un X-Ray Trace ID spécifique, procédez comme suit :

      filter @message like "your-traceid-here"

    6. Pour récupérer des WebSocket erreurs non autorisées :

      fields
@ingestionTime,
@log,
@logStream,
@message,
@requestId,
@timestamp,
errorMessage,
errorType
|filter @message like /Unauthorized/ and @message like /websocket/|sort @timestamp desc

    7. Pour récupérer le nombre de métriques publiées :

      filter @message like "CloudWatchMetrics"
|parse @message /"Metrics":\s*\[(?<metrics>.*?)\]/|stats count(*) as metric_count by metrics