本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon CloudWatch 日志进行登录
<a name="cw-event-logging"></a>

FSx for Lustre 支持将与您的文件系统关联的数据存储库的错误和警告事件记录到 Amazon L CloudWatch ogs 中。

**注意**  
使用亚马逊 CloudWatch 日志记录仅适用于太平洋标准时间 2021 年 11 月 30 日下午 3 点之后创建的 Lustre 文件系统。 FSx 

**Topics**
+ [日志记录概述](#event-log-overview)
+ [日志目的地](#event-log-destinations)
+ [管理日志记录](#manage-logging)
+ [查看日志](#view-logs)

## 日志记录概述
<a name="event-log-overview"></a>

如果您有与 for Lustre 文件系统关联的数据存储库，则可以启用将数据存储库事件记录到 Amazon L CloudWatch ogs 中。 FSx 可针对导入、导出和恢复事件对错误和警告事件进行日志记录。有关这些操作以及链接到数据存储库的更多信息，请参阅[在 Amazon 上使用数据存储库 for Lu FSx stre](fsx-data-repositories.md)。

您可以配置 Amazon 记录的 FSx 日志级别；也就是说，Amazon 是 FSx 只记录错误事件、仅记录警告事件，还是同时记录错误和警告事件。您还可以随时关闭事件日志记录。

**注意**  
我们强烈建议您为具有任何级别关键功能的文件系统启用日志。

## 日志目的地
<a name="event-log-destinations"></a>

启用日志记录后，必须 FSx 为 Lustre 配置亚马逊 CloudWatch 日志目标。事件日志的目标是一个 Amazon Log CloudWatch s 日志组，Amazon FSx 会在此日志组中为您的文件系统创建一个日志流。 CloudWatch 日志允许您在 Amazon CloudWatch 控制台中存储、查看和搜索审计事件日志，使用 CloudWatch Logs Insights 对日志进行查询，以及触发 CloudWatch警报或 Lambda 函数。

您可以在创建 for Lustre 文件系统时或之后通过更新来选择日志目标。 FSx 有关更多信息，请参阅 [管理日志记录](#manage-logging)。

默认情况下，Amazon FSx 将在您的账户中创建并使用默认 CloudWatch 日志组作为事件日志目标。如果要使用自定义 Log CloudWatch s 日志组作为事件日志目标，则对事件日志目标的名称和位置有以下要求：
+  CloudWatch 日志日志组的名称必须以`/aws/fsx/`前缀开头。
+ 如果您在控制台上创建或更新文件系统时没有现有的 CloudWatch 日志日志组，Amazon FSx for Lustre 可以在日志组中创建和使用默认 CloudWatch `/aws/fsx/lustre`日志流。使用格式 `datarepo_file_system_id` 创建日志流（例如，`datarepo_fs-0123456789abcdef0`）。
+ 如果您不想使用默认日志组，则配置用户界面允许您在控制台上创建或更新文件系统时创建 CloudWatch 日志日志组。
+ 目标 CloudWatch 日志组必须与您的 Amazon FSx for Lustre 文件系统位于同一个 Amazon 分区 Amazon Web Services 区域、和 Amazon Web Services 账户 中。

您可以随时更改事件日志目标。更改后，新的事件日志只会发送到新目标。

## 管理日志记录
<a name="manage-logging"></a>

您可以在 FSx 为 Lustre 文件系统创建新文件系统时启用日志记录，也可以在之后通过更新来启用日志记录。当您从 Amazon FSx 控制台创建文件系统时，日志记录功能默认处于开启状态。但是，当您使用 Amazon CLI 或 Amazon FSx API 创建文件系统时，日志记录默认处于关闭状态。

在启用了日志记录的现有文件系统上，您可以更改事件日志记录设置，包括记录事件的日志级别和日志目标。您可以使用亚马逊 FSx 控制台或亚马逊 FSx API 执行这些任务。 Amazon CLI

### 在创建文件系统时启用日志记录（控制台）
<a name="create-enable-event-logs"></a>

1. 打开亚马逊 FSx 控制台，网址为[https://console.aws.amazon.com/fsx/](https://console.amazonaws.cn/fsx/)。

1. 按照“入门”部分的[步骤 1：创建 FSx for Lustre 文件系统](getting-started.md#getting-started-step1)中所述的步骤创建新文件系统。

1. 打开**日志记录 – 可选**部分。默认情况下，日志记录处于启用状态。  
![\[\]](http://docs.amazonaws.cn/fsx/latest/LustreGuide/images/create-fs-logging.png)

1. 继续执行文件系统创建向导的下一部分。

当文件系统变为**可用**时，将启用日志记录。

### 在创建文件系统时启用日志记录（CLI）
<a name="create-enable-event-logs-cli"></a>

1. 创建新文件系统时，使用带有[CreateFileSystem](https://docs.amazonaws.cn/fsx/latest/APIReference/API_CreateFileSystem.html)操作的`LogConfiguration`属性来启用新文件系统的日志记录。

   ```
   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. 当文件系统变为**可用**时，将启用日志功能。

### 更改日志记录配置（控制台）
<a name="change-event-logs-console"></a>

1. 打开亚马逊 FSx 控制台，网址为[https://console.aws.amazon.com/fsx/](https://console.amazonaws.cn/fsx/)。

1. 导航到**文件系统**，然后选择要管理日志记录的 Lustre 文件系统。

1. 选择**数据存储库**选项卡。

1. 在**日志记录**面板上，选择**更新**。

1. 在**更新日志记录配置**对话框中，更改所需的设置。

   1. 选择**日志错误**，仅记录错误事件；或者选择**日志警告**，仅记录警告事件；或者两项全选。如果您未选择任何一项，则将禁用日志记录。

   1. 选择现有的 CloudWatch 日志日志目标或创建一个新的日志目标。

1. 选择**保存**。

### 更改日志记录配置（CLI）
<a name="change-event-logs-cli"></a>
+ 使用 [https://docs.amazonaws.cn/cli/latest/reference/fsx/update-file-system.html](https://docs.amazonaws.cn/cli/latest/reference/fsx/update-file-system.html) CLI 命令或等效 [https://docs.amazonaws.cn/fsx/latest/APIReference/API_UpdateFileSystem.html](https://docs.amazonaws.cn/fsx/latest/APIReference/API_UpdateFileSystem.html) API 操作。

  ```
  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"}"
  ```

## 查看日志
<a name="view-logs"></a>

在 Amazon 开始发布日志之后 FSx ，您可以查看日志。您可以按照以下步骤查看日志：
+ 您可以前往 Amazon CloudWatch 控制台并选择事件日志发送到的日志组和日志流来查看日志。有关更多信息，请参阅 *Amazon Logs 用户指南中的查看发送到 CloudWatch CloudWatch 日志*[的日志数据](https://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。
+ 您可以使用 CloudWatch Logs Insights 以交互方式搜索和分析您的日志数据。有关更多信息，请参阅 *Amazon CloudWatch 日志用户指南中的使用日志见解分析 CloudWatch 日志*[数据](https://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。
+ 您还可以将日志导出到 Amazon S3。有关更多信息，请参阅《[亚马逊日志用户指南》中的将日志数据导出到](https://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/S3Export.html) *Amazon CloudWatch * S3。

要了解失败原因，请参阅[数据存储库事件日志](data-repo-event-logs.md)。