Journaux des fonctions Edge

Vous pouvez utiliser Amazon CloudWatch Logs pour obtenir les journaux de vos fonctions périphériques, à la fois Lambda @Edge et CloudFront Functions. Vous pouvez accéder aux journaux à l'aide de la CloudWatch console ou de l'API CloudWatch Logs.

Important

Nous vous recommandons d'utiliser les journaux pour comprendre la nature des demandes concernant votre contenu, et non comme un compte rendu complet de toutes les demandes. CloudFront fournit des journaux des fonctions de pointe dans les meilleures conditions. L’entrée du journal pour une demande particulière peut être fournie bien après le traitement réel de la demande et, dans de rares cas, une entrée du journal peut ne pas être fournie du tout. Quand une entrée de journal est omise des journaux de fonctions de périphérie, le nombre d'entrées des journaux de fonctions de périphérie ne correspond pas à l'utilisation qui apparaît dans les rapports d'utilisation et de facturation AWS .

Journaux Lambda@Edge

Lambda @Edge envoie automatiquement les journaux des fonctions à Logs, créant ainsi des flux de CloudWatch journaux dans l' Régions AWS endroit où les fonctions sont exécutées. Le nom du groupe de journaux est formaté comme /aws/lambda/us-east-1.function-name suit : où function-name est le nom que vous avez donné à la fonction lorsque vous l'avez créée et où us-east-1 est le code de région Région AWS où la fonction a été créée. Le nom du groupe de journaux contient toujoursus-east-1, même pour les groupes de journaux des autres régions dans lesquelles votre fonction s'exécute.

Note

Lambda@Edge limite les journaux en fonction du volume de la demande et de la taille des journaux.

Vous devez examiner correctement les fichiers CloudWatch journaux Région AWS pour voir les fichiers journaux de vos fonctions Lambda @Edge. Pour voir les régions dans lesquelles votre fonction Lambda @Edge est exécutée, consultez les graphiques des métriques de la fonction dans la CloudFront console. Les métriques sont affichées pour chaque Région AWS. Sur la même page, vous pouvez choisir une région et afficher les fichiers journaux pour cette région afin de pouvoir rechercher des problèmes.

Pour en savoir plus sur l'utilisation des CloudWatch journaux avec les fonctions Lambda @Edge, consultez les rubriques suivantes :

• Pour plus d'informations sur l'affichage des graphiques dans la section Surveillance de la CloudFront console, consultezSurveillez CloudFront les métriques avec Amazon CloudWatch.

• Pour plus d'informations sur les autorisations requises pour envoyer des données à CloudWatch Logs, consultezConfiguration des autorisations et des rôles IAM pour Lambda @Edge.

• Pour plus d'informations sur l'ajout de la journalisation à une fonction Lambda, consultez Journalisation des fonctions AWS Lambda dans Node.js ou Journalisation des fonctions AWS Lambda dans Python dans le Guide du développeur AWS Lambda .

• Pour plus d'informations sur CloudWatch les quotas de journaux (anciennement appelés limites), consultez la section Quotas de CloudWatch journaux dans le guide de l'utilisateur Amazon CloudWatch Logs.

CloudFront Journaux de fonctions

Si le code d'une CloudFront fonction contient des console.log() instructions, CloudFront Functions envoie automatiquement ces lignes de journal à CloudWatch Logs. S'il n'y a aucune console.log() déclaration, rien n'est envoyé à CloudWatch Logs.

CloudFront Functions crée toujours des flux de journaux dans la région de l'est des États-Unis (Virginie du Nord) (us-east-1), quel que soit l'emplacement périphérique sur lequel la fonction a été exécutée. Le nom du groupe de journaux est au format /aws/cloudfront/function/FunctionName, où FunctionName est le nom que vous avez donné à la fonction lors de sa création. Le nom du flux de journal est au format YYYY/M/D/UUID.

Voici un exemple de message de journal envoyé à CloudWatch Logs. Chaque ligne commence par un identifiant qui identifie de manière unique une CloudFront demande. Le message commence par une START ligne qui inclut l'ID CloudFront de distribution et se termine par une END ligne. Entre les lignes START et END se trouvent les lignes de journal générées par les instructions console.log() de la fonction.

U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== START DistributionID: E3E5D42GADAXZZ
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== Example function log output
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== END

Note

CloudFront Functions envoie des journaux CloudWatch uniquement pour les fonctions de la LIVE phase qui s'exécutent en réponse aux demandes et réponses de production. Lorsque vous testez une fonction, CloudFront elle n'envoie aucun journal à CloudWatch. Le résultat du test contient des informations sur les erreurs, l'utilisation du calcul et les journaux de fonctionnement (console.log()instructions), mais ces informations ne sont pas envoyées à CloudWatch.

CloudFront Functions utilise un rôle lié à un service AWS Identity and Access Management (IAM) pour envoyer les journaux aux CloudWatch journaux de votre compte. Un rôle lié à un service est un rôle IAM directement associé à un service AWS . Les rôles liés au service sont prédéfinis par le service et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom. CloudFront Functions utilise un rôle lié à un service appelé. AWSServiceRoleForCloudFrontLogger Pour plus d'informations sur ce rôle, consultez Rôles liés à un service pour Lambda@Edge (Lambda@Edge utilise le même rôle lié au service).

Lorsqu'une fonction échoue en raison d'une erreur de validation ou d'exécution, les informations sont enregistrées dans les CloudFront journaux standard et les journaux en temps réel. Les informations relatives à l'erreur sont consignées dans les champs x-edge-result-type, x-edge-response-result-type et x-edge-detailed-result-type.