# Travailler avec CloudWatch Logs en utilisant AWS Toolkit for JetBrains
Amazon CloudWatch Logs vous permet de centraliser les journaux de tous vos systèmes, ainsi que les applications et les services AWS que vous utilisez au sein d'un seul service hautement évolutif. Vous pouvez ensuite les afficher facilement, y effectuer des recherches de codes d'erreur ou des modèles, les filtrer en fonction de champs spécifiques ou les archiver en toute sécurité pour procéder à une analyse ultérieure. Pour plus d'informations, veuillez consulter [Qu'est-ce qu'Amazon CloudWatch Logs ?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatchLogs.html) dans le *Guide de l'utilisateur Amazon CloudWatch*.
Les rubriques suivantes expliquent comment utiliser AWS Toolkit for JetBrains pour travailler avec CloudWatch Logs dans un compte AWS.
**Topics**
+ [Affichage des groupes de journaux et des flux de journaux CloudWatch Logs](viewing-CloudWatch-logs.md)
+ [Utilisation des événements CloudWatch Logs](working-CloudWatch-log-events.md)
+ [Travailler avec CloudWatch Logs Insights](cloudwatch-log-insights.md)
# Affichage des groupes de journaux et des flux de journaux de CloudWatch à l'aide d'AWS Toolkit for JetBrains
Un *flux de journaux* est une séquence d'événements de journaux qui partagent la même source. Chaque source différente de journaux dans CloudWatch Logs constitue un flux de journaux distinct.
Un *groupe de journaux* est un groupe de flux de journaux qui partagent les mêmes paramètres de conservation, de surveillance et de contrôle d'accès. Vous pouvez définir des groupes de journaux et spécifier les flux à placer dans chaque groupe. Le nombre de flux de journaux pouvant appartenir à un groupe de journaux est illimité.
Pour plus d'informations, veuillez consulter [Gestion des groupes de journaux et des flux de journaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Working-with-log-groups-and-streams.html) dans le *guide de l'utilisateur Amazon CloudWatch*.
**Topics**
+ [Affichage des groupes de journaux et des flux de journaux avec le nœud **CloudWatch Logs**](#viewing-log-groups)
+ [Affichage des flux de journaux avec le nœud **Lambda**](#viewing-lamba-log-groups)
+ [Affichage des flux de journaux avec le nœud **Amazon ECS**](#viewing-ecs-log-groups)
## Affichage des groupes de journaux et des flux de journaux avec le nœud **CloudWatch Logs**
1. Ouvrez AWS Explorer, s'il n'est pas déjà ouvert.
1. Cliquez sur le nœud **CloudWatch Logs** pour développer la liste des groupes de journaux.
Les groupes de journaux de la région [AWS actuelle](setup-region.md#setup-region-current-region) s'affichent sous le nœud **CloudWatch Logs**.
1. Pour afficher les flux de journaux d'un groupe de journaux, effectuez l'une des opérations suivantes :
+ Double-cliquez sur le nom du groupe de journaux.
+ Cliquez avec le bouton droit de la souris sur le nom du groupe de journaux, puis choisissez **Afficher les flux de journaux**.
Le contenu du groupe de journaux s'affiche dans le panneau **Flux de journaux**. Pour plus d'informations sur l'interaction avec les événements de journaux dans chaque flux, consultez [Utilisation des événements CloudWatch LogsTravailler avec CloudWatch Logs Insights](working-CloudWatch-log-events.md).
![\[Affichage des flux de journaux dans un groupe de journaux CloudWatch dans AWS Explorer\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-view-log-streams.png)
## Affichage des flux de journaux avec le nœud **Lambda**
Vous pouvez afficher les journaux CloudWatch pour les fonctions AWS Lambda en utilisant le nœud **Lambda** dans AWS Explorer.
**Remarque**
Vous pouvez également consulter les flux de journaux pour tous les services AWS, y compris les fonctions Lambda, en utilisant le nœud **CloudWatch Logs** dans AWS Explorer. Nous vous recommandons toutefois d'utiliser le nœud **Lambda** pour avoir une vue d'ensemble des données de journal spécifiques aux fonctions Lambda.
1. Ouvrez AWS Explorer, s'il n'est pas déjà ouvert.
1. Cliquez sur le nœud **Lambda** pour développer la liste des fonctions Lambda.
Les fonctions Lambda de la [région AWS actuelle](setup-region.md#setup-region-current-region) sont affichées sous le nœud **Lambda**.
1. Cliquez avec le bouton droit de la souris sur une fonction Lambda, puis choisissez **Afficher les flux de journaux**.
Les flux de journaux de la fonction s'affichent dans le panneau **Flux de journaux**. Pour plus d'informations sur l'interaction avec les événements de journaux dans chaque flux, consultez [Utilisation des événements CloudWatch LogsTravailler avec CloudWatch Logs Insights](working-CloudWatch-log-events.md).
## Affichage des flux de journaux avec le nœud **Amazon ECS**
Vous pouvez afficher les journaux CloudWatch pour les clusters et les conteneurs qui sont exécutés et maintenus dans Amazon Elastic Container Service en utilisant le nœud **Amazon ECS** dans AWS Explorer
**Remarque**
Vous pouvez également afficher les groupes de journaux pour tous les services AWS, y compris Amazon ECS, en utilisant le nœud **CloudWatch Logs** dans AWS Explorer. Nous vous recommandons toutefois d'utiliser le nœud **Amazon ECS** pour avoir une vue d'ensemble des données de journal spécifiques aux clusters et conteneurs Amazon ECS.
1. Ouvrez AWS Explorer, s'il n'est pas déjà ouvert.
1. Cliquez sur le nœud **Amazon ECS** pour développer la liste des clusters Amazon ECS.
Les clusters Amazon ECS pour la [région AWS actuelle](setup-region.md#setup-region-current-region) sont affichés sous le nœud **Amazon ECS**.
1. Cliquez avec le bouton droit de la souris sur un cluster, puis choisissez **Afficher les flux de journaux**.
Les flux de journaux du cluster s'affichent dans le panneau **Flux de journaux**.
1. Pour afficher les flux de journaux d'un conteneur spécifique, cliquez sur un cluster pour développer sa liste de conteneurs enregistrés.
Les conteneurs enregistrés pour le cluster s'affichent en dessous.
1. Cliquez avec le bouton droit de la souris sur un conteneur, puis choisissez **Afficher le flux de journaux du conteneur**.
Les flux de journaux du conteneur s'affichent dans le panneau **Flux de journaux**. Pour plus d'informations sur l'interaction avec les événements du journal pour les clusters et les conteneurs, consultez [Utilisation des événements CloudWatch LogsTravailler avec CloudWatch Logs Insights](working-CloudWatch-log-events.md).
# Travailler avec les événements du journal CloudWatch dans les flux de journaux en utilisant AWS Toolkit for JetBrains
Une fois que vous avez ouvert le panneau **Flux de journaux**, vous pouvez accéder aux événements du journal dans chaque flux. Les événements de journaux sont des enregistrements de l'activité enregistrée par l'application ou la ressource contrôlée.
**Topics**
+ [Affichage et filtrage des événements du journal dans un flux](#viewing-log-events)
+ [Utilisation des actions du journal](#working-with-log-actions)
+ [Exportation des événements du journal CloudWatch vers un fichier ou un éditeur](#exporting-CW-logs)
## Affichage et filtrage des événements du journal dans un flux
Lorsque vous ouvrez un flux de journaux, le panneau **Événements du journal** affiche la séquence des événements du journal de ce flux.
1. Pour trouver un flux de journaux à afficher, ouvrez le panneau **Flux de journaux** (consultez [Affichage des groupes de journaux et des flux de journaux CloudWatch Logs](viewing-CloudWatch-logs.md)).
**Remarque**
Vous pouvez utiliser la recherche par motif pour localiser un flux dans une liste. Cliquez sur le panneau **Flux de journaux** et commencez à saisir du texte. Le premier nom de flux de journaux dont le texte correspond au vôtre est mis en évidence. Vous pouvez également réorganiser la liste en cliquant sur le haut de la colonne **Heure du dernier événement**.
1. Double-cliquez sur un flux de journaux pour afficher sa séquence d'événements du journal.
Le panneau **Événements du journal** affiche les événements du journal qui composent le flux de journaux.
1. Pour filtrer les événements du journal en fonction de leur contenu, saisissez du texte dans le champ **Filtrer le flux de journaux** et appuyez sur **Retour**.
Les résultats sont des événements du journal contenant du texte qui correspond à votre texte de filtrage en respectant la casse. Le filtre recherche le flux de journaux complet, y compris les événements qui ne s'affichent pas à l'écran.
**Note**
Vous pouvez également utiliser la recherche par motif pour localiser un événement du journal dans le panneau. Cliquez sur le panneau **Événements du journal** et commencez à saisir du texte. Le premier événement du journal dont le texte correspond au vôtre est mis en évidence. Contrairement à la recherche **Filtrer le flux de journaux**, seuls les événements à l'écran sont cochés.
1. Pour filtrer les événements du journal en fonction de l'heure, cliquez avec le bouton droit de la souris sur un événement du journal, puis choisissez **Afficher les journaux autour**.
Vous pouvez sélectionner **Une minute**, **Cinq minutes** ou **Dix minutes**. Par exemple, si vous sélectionnez **Cinq minutes**, la liste filtrée n'affiche que les événements du journal survenus cinq minutes avant et après l'entrée sélectionnée.
![\[Affichage et filtrage des actions du journal dans le panneau Événements du journal.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-filter-log-events.png)
Sur la gauche du panneau **Événements du journal**, les [actions du journal](#working-with-log-actions) offrent d'autres moyens d'interagir avec les événements du journal.
## Utilisation des actions du journal
Sur la gauche du panneau **Événements du journal**, quatre actions de journal vous permettent d'actualiser, de modifier, de mettre en queue et d'envelopper les événements du journal CloudWatch.
![\[Affichage des actions de journal dans le panneau Événements du journal.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/images/cloudwatch-log-actions.png)
1. Pour trouver des événements du journal avec lesquels interagir, [ouvrez le panneau **Flux de journaux**](#viewing-log-events).
1. Choisissez l'une des actions de journal suivantes :
+ **Actualiser** : met à jour la liste avec les événements du journal qui se sont produits après l'ouverture du panneau **Événements du journal**.
+ **Ouvrir dans l'Éditeur** : ouvre les événements du journal à l'écran dans l'éditeur par défaut de l'IDE.
**Note**
Cette action exporte uniquement les événements du journal à l'écran vers l'éditeur de l'IDE. Pour afficher tous les événements du flux dans l'éditeur, choisissez l'option [**Exporter le flux de journaux**](#exporting-CW-logs).
+ **Mettre les journaux en queue** : envoie de nouveaux journaux dans le panneau **Événements du journal**. C'est une fonctionnalité utile pour les mises à jour continues sur les services à long terme tels que les instances Amazon EC2 et les versions AWS CodeBuild.
+ **Envelopper les journaux** : affiche le texte des événements du journal sur plusieurs lignes si la taille du panneau masque les entrées plus longues.
## Exportation des événements du journal CloudWatch vers un fichier ou un éditeur
L'exportation d'un flux de journaux CloudWatch vous permet d'ouvrir ses événements du journal dans l'éditeur par défaut de l'IDE ou de les télécharger dans un dossier local.
1. Pour trouver un flux de journaux auquel accéder, [ouvrez le panneau **Flux de journaux**](#viewing-log-events).
1. Cliquez avec le bouton droit de la souris sur un flux de journaux, puis choisissez **Exporter le flux de journaux**, **Ouvrir dans l'éditeur** ou **Exporter le flux de journaux**, **Enregistrer dans un fichier**.
+ **Ouvrir dans l'éditeur** : ouvre les événements du journal qui composent le flux sélectionné dans l'éditeur par défaut de l'IDE.
**Note**
Cette option exporte tous les événements du flux de journaux dans l'éditeur de l'IDE.
+ **Enregistrer dans un fichier** : ouvre la boîte de dialogue **Télécharger le flux de journaux**. Cela vous permet de sélectionner un dossier de téléchargement et de renommer le fichier contenant les événements du journal.
# Travailler avec CloudWatch Logs Insights en utilisant AWS Toolkit for JetBrains
Vous pouvez utiliser AWS Toolkit for JetBrains pour travailler avec CloudWatch Logs Insights. CloudWatch Logs Insights vous permet de rechercher et d'analyser de façon interactive les données de vos journaux dans Amazon CloudWatch Logs. Pour plus d'informations, consultez [Analyse des données de journal avec CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) dans le *Guide de l'utilisateur Amazon CloudWatch Logs*.
## Autorisations IAM pour CloudWatch Logs Insights
Vous avez besoin des autorisations suivantes pour exécuter et afficher les résultats de la requête CloudWatch Logs Insights :
```
{
"Version": "2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"logs:StartQuery",
"logs:GetQueryResults",
"logs:GetLogRecord",
"logs:describeLogGroups",
"logs:describeLogStreams"
],
"Resource" : "*"
}
]
}
```
L'autorisation suivante n'est pas requise, mais permettra à AWS Toolkit for JetBrains d'arrêter automatiquement toute requête en cours d'exécution lorsque vous fermez le panneau de résultats associé ou l'IDE.
```
{
"Version": "2012-10-17",
"Statement" : [
{
"Effect" : "Allow",
"Action" : [
"logs:StopQuery"
],
"Resource" : "*"
}
]
}
```
## Travailler avec CloudWatch Logs Insights
**Pour ouvrir l'éditeur de requêtes CloudWatch Logs Insights**
1. Ouvrez AWS Explorer.
1. Double-cliquez sur le nœud **CloudWatch Logs** pour développer la liste des groupes de journaux.
1. Cliquez avec le bouton droit de la souris sur le groupe de journaux que vous voulez ouvrir, puis choisissez **Ouvrir l'Éditeur de requêtes**.
**Pour lancer une requête CloudWatch Logs Insights**
1. Dans la fenêtre **Interroger les groupes de journaux**, modifiez les paramètres de la requête comme vous le souhaitez.
Vous pouvez choisir une plage de temps par date ou par temps relatif.
Le champ **Interroger les groupes de journaux** accepte la syntaxe de requête de CloudWatch Logs Insights. Pour plus d'informations, consultez [Syntaxe de requête de CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) dans le *Guide de l'utilisateur Amazon CloudWatch Logs*.
1. Sélectionnez **Exécuter** pour lancer la requête.
**Pour enregistrer une requête CloudWatch Logs Insights**
1. Saisissez un nom de requête.
1. Choisissez **Enregistrer la requête**.
Les groupes de journaux et la requête sélectionnés sont enregistrés dans votre compte AWS. Les plages horaires ne sont pas enregistrées.
Vous pouvez récupérer et réutiliser les journaux enregistrés à partir de la page de la AWS Management Console CloudWatch Logs Insights.
**Pour récupérer une requête CloudWatch Logs Insights enregistrée**
1. Dans la fenêtre **Interroger les groupes de journaux**, sélectionnez **Récupérer les requêtes enregistrées**.
1. Choisissez la requête souhaitée et cliquez sur **OK**.
Les groupes de journaux et la requête sélectionnés remplacent tout ce qui se trouve dans la boîte de dialogue existante.
**Pour naviguer dans les résultats de la requête**
+ Dans la fenêtre **Résultats de la requête** de CloudWatch Logs Insights, dans le coin supérieur droit, choisissez **Ouvrir l'Éditeur de requêtes**.
**Pour afficher un enregistrement de journal individuel**
+ Dans le panneau des résultats de la requête, double-cliquez sur une ligne pour ouvrir un nouvel onglet contenant des détails sur cet enregistrement de journal.
Vous pouvez également accéder au flux de journaux associé à l'enregistrement de journal en sélectionnant **Afficher le flux de journaux** dans le coin supérieur droit.