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.
# Journalisation avec Amazon CloudWatch Logs
FSx for Lustre prend en charge l'enregistrement des événements d'erreur et d'avertissement relatifs aux référentiels de données associés à votre système de fichiers dans Amazon CloudWatch Logs.
**Note**
La journalisation avec Amazon CloudWatch Logs n'est disponible sur Amazon que FSx pour les systèmes de fichiers Lustre créés après 15 h PST le 30 novembre 2021.
**Topics**
+ [Aperçu de la journalisation](#event-log-overview)
+ [Destinations des journaux](#event-log-destinations)
+ [Gestion de la journalisation](#manage-logging)
+ [Affichage des journaux](#view-logs)
## Aperçu de la journalisation
Si vous avez des référentiels de données liés à votre système de fichiers FSx for Lustre, vous pouvez activer l'enregistrement des événements du référentiel de données dans Amazon CloudWatch Logs. Les événements d'erreur et d'avertissement peuvent être enregistrés pour les événements d'importation, d'exportation et de restauration. Pour plus d'informations sur ces opérations et sur les liens vers des référentiels de données, consultez[Utilisation de référentiels de données avec Amazon FSx for Lustre](fsx-data-repositories.md).
Vous pouvez configurer les niveaux de journalisation enregistrés par Amazon FSx , c'est-à-dire déterminer si Amazon FSx enregistrera uniquement les événements d'erreur, uniquement les événements d'avertissement, ou à la fois les événements d'erreur et d'avertissement. Vous pouvez également désactiver la déconnexion des événements à tout moment.
**Note**
Nous vous recommandons vivement d'activer les journaux pour les systèmes de fichiers associés à un niveau quelconque de fonctionnalités critiques.
## Destinations des journaux
Lorsque la journalisation est activée, FSx Lustre doit être configuré avec une destination Amazon CloudWatch Logs. La destination du journal des événements est un groupe de CloudWatch journaux Amazon Logs, et Amazon FSx crée un flux de journal pour votre système de fichiers au sein de ce groupe de journaux. CloudWatch Logs vous permet de stocker, de consulter et de rechercher des journaux d'événements d'audit dans la CloudWatch console Amazon, d'exécuter des requêtes sur les journaux à l'aide CloudWatch de Logs Insights et de déclencher des CloudWatch alarmes ou des fonctions Lambda.
Vous choisissez la destination du journal lorsque vous créez votre système de fichiers FSx for Lustre ou ultérieurement en le mettant à jour. Pour de plus amples informations, veuillez consulter [Gestion de la journalisation](#manage-logging).
Par défaut, Amazon FSx crée et utilise un groupe de CloudWatch journaux Logs par défaut dans votre compte comme destination du journal des événements. Si vous souhaitez utiliser un groupe de journaux de CloudWatch journaux personnalisé comme destination du journal des événements, voici les exigences relatives au nom et à l'emplacement de la destination du journal des événements :
+ Le nom du groupe de CloudWatch journaux Logs doit commencer par le `/aws/fsx/` préfixe.
+ Si vous ne disposez pas d'un groupe de CloudWatch journaux Logs existant lorsque vous créez ou mettez à jour un système de fichiers sur la console, Amazon FSx for Lustre peut créer et utiliser un flux de journaux par défaut dans le groupe de CloudWatch `/aws/fsx/lustre` journaux Logs. Le flux de journal sera créé au format `datarepo_file_system_id` (par exemple,`datarepo_fs-0123456789abcdef0`).
+ Si vous ne souhaitez pas utiliser le groupe de journaux par défaut, l'interface utilisateur de configuration vous permet de créer un groupe de CloudWatch journaux de journaux lorsque vous créez ou mettez à jour votre système de fichiers sur la console.
+ Le groupe de CloudWatch journaux Logs de destination doit se trouver sur la même AWS partition Compte AWS que votre système de fichiers Amazon FSx for Lustre. Région AWS
Vous pouvez modifier la destination du journal des événements à tout moment. Dans ce cas, les nouveaux journaux d'événements sont envoyés uniquement à la nouvelle destination.
## Gestion de la journalisation
Vous pouvez activer la journalisation lorsque vous créez un nouveau système de fichiers FSx pour Lustre ou ultérieurement en le mettant à jour. La journalisation est activée par défaut lorsque vous créez un système de fichiers depuis la FSx console Amazon. Cependant, la journalisation est désactivée par défaut lorsque vous créez un système de fichiers avec l' FSx API Amazon AWS CLI ou Amazon.
Sur les systèmes de fichiers existants sur lesquels la journalisation est activée, vous pouvez modifier les paramètres de journalisation des événements, notamment le niveau de journalisation pour lequel vous souhaitez enregistrer les événements et la destination du journal. Vous pouvez effectuer ces tâches à l'aide de la FSx console Amazon ou de FSx l'API Amazon. AWS CLI
### Pour activer la journalisation lors de la création d'un système de fichiers (console)
1. Ouvrez la FSx console Amazon à l'adresse [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).
1. Suivez la procédure de création d'un nouveau système de fichiers décrite [Étape 1 : Créez votre système de fichiers FSx for Lustre](getting-started.md#getting-started-step1) dans la section Mise en route.
1. Ouvrez la section **Logging - optionnelle**. La journalisation est activée par défaut.
![\[\]](http://docs.aws.amazon.com/fr_fr/fsx/latest/LustreGuide/images/create-fs-logging.png)
1. Passez à la section suivante de l'assistant de création de système de fichiers.
Lorsque le système de fichiers devient **disponible**, la journalisation est activée.
### Pour activer la journalisation lors de la création d'un système de fichiers (CLI)
1. Lorsque vous créez un nouveau système de fichiers, utilisez la `LogConfiguration` propriété avec l'[CreateFileSystem](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystem.html)opération pour activer la journalisation du nouveau système de fichiers.
```
create-file-system --file-system-type LUSTRE \
--storage-capacity 1200 --subnet-id subnet-08b31917a72b548a9 \
--lustre-configuration "LogConfiguration={Level=WARN_ERROR, \
Destination="arn:aws:logs:us-east-1:234567890123:log-group:/aws/fsx/testEventLogging"}"
```
1. Lorsque le système de fichiers devient **disponible**, la fonctionnalité de journalisation est activée.
### Pour modifier la configuration de journalisation (console)
1. Ouvrez la FSx console Amazon à l'adresse [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).
1. Accédez à **Systèmes de fichiers**, puis choisissez le système de Lustre fichiers pour lequel vous souhaitez gérer la journalisation.
1. Choisissez l'onglet **Référentiel de données**.
1. Dans le panneau de **journalisation**, choisissez **Mettre à jour**.
1. Dans la boîte de dialogue **Mettre à jour la configuration de la journalisation**, modifiez les paramètres souhaités.
1. Choisissez **Enregistrer les erreurs** pour enregistrer uniquement les événements d'erreur, ou **Enregistrer les avertissements** pour n'enregistrer que les événements d'avertissement, ou les deux. La journalisation est désactivée si vous n'effectuez aucune sélection.
1. Choisissez une destination de journal CloudWatch Logs existante ou créez-en une nouvelle.
1. Choisissez **Enregistrer**.
### Pour modifier la configuration de journalisation (CLI)
+ Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html)CLI ou l'opération [https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html)API équivalente.
```
update-file-system --file-system-id fs-0123456789abcdef0 \
--lustre-configuration "LogConfiguration={Level=WARN_ERROR, \
Destination="arn:aws:logs:us-east-1:234567890123:log-group:/aws/fsx/testEventLogging"}"
```
## Affichage des journaux
Vous pouvez consulter les journaux une fois qu'Amazon FSx a commencé à les émettre. Vous pouvez consulter les journaux comme suit :
+ Vous pouvez consulter les journaux en accédant à la CloudWatch console Amazon et en choisissant le groupe de journaux et le flux de journaux auxquels vos journaux d'événements sont envoyés. Pour plus d'informations, consultez [Afficher les données de journal envoyées à CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) dans le *guide de l'utilisateur Amazon CloudWatch Logs*.
+ Vous pouvez utiliser CloudWatch Logs Insights pour rechercher et analyser les données de vos journaux de manière interactive. Pour plus d'informations, consultez [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) dans le *guide de l'utilisateur Amazon CloudWatch Logs*.
+ Vous pouvez également exporter des journaux vers Amazon S3. Pour plus d'informations, consultez [Exportation des données de journal vers Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3Export.html) dans le *guide de l'utilisateur d'Amazon CloudWatch Logs*.
Pour en savoir plus sur les causes des défaillances, voir[Journaux d'événements du référentiel de données](data-repo-event-logs.md).