View a markdown version of this page

Utilisation des journaux de fonction Lambda - 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.

Utilisation des journaux de fonction Lambda

Pour vous aider à résoudre les problèmes, surveille AWS Lambda automatiquement les fonctions Lambda pour vous. Vous pouvez consulter les journaux des fonctions Lambda à l'aide de la console Lambda, de la CloudWatch console, du AWS Command Line Interface (AWS CLI) et de l' CloudWatch API. Vous pouvez également configurer Lambda pour envoyer les journaux à Amazon S3 et Firehose.

Tant que le rôle d'exécution de votre fonction dispose des autorisations nécessaires, Lambda capture les journaux de toutes les demandes traitées par votre fonction et les envoie à Amazon CloudWatch Logs, qui est la destination par défaut. Vous pouvez également laisser la console Lambda configurer Amazon S3 ou Firehose comme destinations de journalisation.

  • CloudWatch Logs est la destination de journalisation par défaut pour les fonctions Lambda. CloudWatch Logs fournit des fonctionnalités de visualisation et d'analyse des journaux en temps réel, ainsi que la prise en charge de la création de mesures et d'alarmes en fonction des données de vos journaux.

  • Amazon S3 est économique pour le stockage à long terme, et des services comme Athena peuvent être utilisés pour analyser les journaux. La latence est généralement plus élevée.

  • Firehose propose une diffusion en continu gérée des journaux vers différentes destinations. Si vous devez envoyer des journaux à d'autres AWS services (par exemple, OpenSearch Service ou API Redshift Data) ou à des plateformes tierces (telles que Datadog, New Relic ou Splunk), Firehose simplifie ce processus en proposant des intégrations prédéfinies. Vous pouvez également diffuser vers des points de terminaison HTTP personnalisés sans configurer d’infrastructure supplémentaire.

Choix d’une destination de service à laquelle envoyer les journaux

Tenez compte des facteurs clés suivants lorsque vous choisissez un service comme destination pour les journaux de fonction :

  • La gestion des coûts varie selon le service. Amazon S3 fournit généralement l'option la plus économique pour le stockage à long terme, tandis que CloudWatch Logs permet de consulter les journaux, de les traiter et de configurer des alertes en temps réel. Les coûts de Firehose incluent à la fois le service de diffusion en continu et le coût associé à la destination vers laquelle vous diffusez.

  • Les capacités d'analyse varient selon les services. CloudWatch Logs excelle dans la surveillance en temps réel et s'intègre de manière native à d'autres CloudWatch fonctionnalités, telles que Logs Insights et Live Tail. Amazon S3 fonctionne bien avec des outils d'analyse tels qu'Athena et peut s'intégrer à divers services, même s'il peut nécessiter une configuration supplémentaire. Firehose simplifie le streaming direct vers des AWS services spécifiques (tels que OpenSearch Service et l'API Redshift Data) et vers des plateformes tierces prises en charge (telles que Datadog et Splunk) en fournissant des intégrations prédéfinies, ce qui peut réduire le travail de configuration.

  • La configuration et la facilité d'utilisation varient selon le service. CloudWatch Logs est la destination par défaut des journaux. Il fonctionne immédiatement, sans configuration supplémentaire, et permet de visualiser et d'analyser facilement les journaux via la CloudWatch console. Si vous avez besoin d’envoyer les journaux à Amazon S3, vous devez effectuer une configuration initiale dans la console Lambda et configurer les autorisations du compartiment. Si vous avez besoin que les journaux soient envoyés directement à des services tels que OpenSearch Service ou à des plateformes d'analyse tierces, Firehose peut simplifier ce processus.

Configuration des destinations de journal

AWS Lambda prend en charge plusieurs destinations pour vos journaux de fonctions. Ce guide explique les destinations de journalisation disponibles et vous aide à choisir l’option adaptée à vos besoins. Quelle que soit la destination choisie, Lambda propose des options pour contrôler le format, le filtrage et la diffusion des journaux.

Lambda prend en charge les formats JSON et texte brut pour les journaux de votre fonction. Les journaux structurés JSON offrent une meilleure facilité de recherche et permettent une analyse automatisée, tandis que les journaux en texte brut offrent une simplicité et des coûts de stockage potentiellement réduits. Vous pouvez contrôler les journaux que Lambda envoie à la destination que vous avez choisie en configurant les niveaux de journal pour les journaux du système et des applications. Le filtrage vous aide à gérer les coûts de stockage et trouver plus facilement les entrées de journal pertinentes lors du débogage.

Pour obtenir des instructions de configuration détaillées pour chaque destination, consultez les sections suivantes :

Configuration de commandes de journalisation avancées pour votre fonction Lambda

Pour vous permettre de mieux contrôler la manière dont les journaux de votre fonction sont capturés, traités et consommés, Lambda propose les options de configuration de journalisation suivantes :

  • Format de journal  : choisissez entre le format texte brut et le format JSON structuré pour les journaux de votre fonction.

  • Niveau de journalisation  : pour les journaux structurés JSON, choisissez le niveau de détail des journaux que Lambda envoieFATAL, par exemple ERRORWARN,, INFODEBUG, etTRACE. CloudWatch

  • Groupe de journaux  : choisissez le groupe de CloudWatch journaux auquel votre fonction envoie les journaux.

Pour en savoir plus sur la configuration des contrôles de journalisation avancés, consultez les sections suivantes :