As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Registro com Amazon CloudWatch Logs
FSx for Lustre suporta o registro de eventos de erro e aviso para repositórios de dados associados ao seu sistema de arquivos no Amazon CloudWatch Logs.
**nota**
O registro com o Amazon CloudWatch Logs só está disponível nos sistemas de arquivos Amazon FSx for Lustre criados após as 15h PST de 30 de novembro de 2021.
**Topics**
+ [Visão geral do registro em log](#event-log-overview)
+ [Destinos de logs](#event-log-destinations)
+ [Como gerenciar registros em log](#manage-logging)
+ [Visualizar logs](#view-logs)
## Visão geral do registro em log
Se você tiver repositórios de dados vinculados ao seu sistema de arquivos FSx for Lustre, você pode habilitar o registro de eventos do repositório de dados no Amazon Logs. CloudWatch Eventos de erros e de avisos podem ser registrados em log para eventos de importação, exportação e restauração. Para obter mais informações sobre essas operações e sobre a vinculação a repositórios de dados, consulte [Usando repositórios de dados com o Amazon FSx for Lustre](fsx-data-repositories.md).
Você pode configurar os níveis de log que a Amazon FSx registra; ou seja, se a Amazon FSx registrará somente eventos de erro, somente eventos de aviso ou eventos de erro e aviso. Você também pode desativar o registro em log de eventos a qualquer momento.
**nota**
É altamente recomendável habilitar logs para sistemas de arquivos que tenham qualquer nível de funcionalidade crítica associada a eles.
## Destinos de logs
Quando o registro está ativado, FSx o Lustre deve ser configurado com um destino Amazon CloudWatch Logs. O destino do registro de eventos é um grupo de CloudWatch registros do Amazon Logs, e a Amazon FSx cria um fluxo de registros para seu sistema de arquivos dentro desse grupo de registros. CloudWatch O Logs permite que você armazene, visualize e pesquise registros de eventos de auditoria no CloudWatch console da Amazon, execute consultas nos CloudWatch registros usando o Logs Insights e acione CloudWatch alarmes ou funções Lambda.
Você escolhe o destino do log ao criar seu sistema de arquivos FSx para o Lustre ou depois atualizando-o. Para obter mais informações, consulte [Como gerenciar registros em log](#manage-logging).
Por padrão, a Amazon FSx criará e usará um grupo padrão de CloudWatch registros de registros em sua conta como destino do registro de eventos. Se você quiser usar um grupo de registros de CloudWatch registros personalizado como destino do registro de eventos, aqui estão os requisitos para o nome e a localização do destino do registro de eventos:
+ O nome do grupo de CloudWatch registros de registros deve começar com o `/aws/fsx/` prefixo.
+ Se você não tiver um grupo de registros de CloudWatch registros existente ao criar ou atualizar um sistema de arquivos no console, o Amazon FSx for Lustre poderá criar e usar um fluxo de registros padrão no grupo de CloudWatch registros de `/aws/fsx/lustre` registros. O fluxo de logs será criado com o formato `datarepo_file_system_id` (por exemplo, `datarepo_fs-0123456789abcdef0`).
+ Se você não quiser usar o grupo de registros padrão, a interface de configuração permite criar um grupo de CloudWatch registros de registros ao criar ou atualizar seu sistema de arquivos no console.
+ O grupo de CloudWatch registros de registros de destino deve estar na mesma AWS partição e Conta da AWS em seu sistema de arquivos Amazon FSx for Lustre. Região da AWS
É possível alterar o destino do log de eventos a qualquer momento. Ao fazer isso, novos logs de eventos serão enviados somente para o novo destino.
## Como gerenciar registros em log
Você pode ativar o registro ao criar um novo sistema de arquivos FSx para o Lustre ou depois atualizando-o. O registro é ativado por padrão quando você cria um sistema de arquivos a partir do FSx console da Amazon. No entanto, o registro é desativado por padrão quando você cria um sistema de arquivos com a AWS CLI FSx API da Amazon.
Em sistemas de arquivos existentes que têm o registro em log habilitado, é possível alterar as configurações de registro em log de eventos, incluindo o nível de log em que os eventos serão registrados em log e o destino do log. Você pode realizar essas tarefas usando o FSx console da Amazon ou AWS CLI a FSx API da Amazon.
### Como habilitar o registro em log ao criar um sistema de arquivos (console)
1. Abra o FSx console da Amazon em [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).
1. Siga o procedimento para a criação de um novo sistema de arquivos descrito na [Etapa 1: criar o sistema de arquivos do FSx para Lustre](getting-started.md#getting-started-step1) na seção de Conceitos básicos.
1. Abra a seção **Registro em log (opcional)**. Por padrão, o registro em log está habilitado.
![\[\]](http://docs.aws.amazon.com/pt_br/fsx/latest/LustreGuide/images/create-fs-logging.png)
1. Prossiga para a próxima seção do assistente de criação do sistema de arquivos.
Quando o sistema de arquivos se tornar **Disponível**, o registro em log será habilitado.
### Como habilitar o registro em log ao criar um sistema de arquivos (CLI)
1. Ao criar um novo sistema de arquivos, use a `LogConfiguration` propriedade com a [CreateFileSystem](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystem.html)operação para habilitar o registro para o novo sistema de arquivos.
```
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. Quando o sistema de arquivos se tornar **Disponível**, o recurso de registro em log será habilitado.
### Como alterar a configuração de registro em log (console)
1. Abra o FSx console da Amazon em [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).
1. Acesse **Sistemas de arquivos** e escolha o sistema de arquivos do Lustre para o qual deseja gerenciar o registro em log.
1. Escolha a guia **Repositório de dados**.
1. No painel **Registro em log**, escolha **Atualizar**.
1. Na caixa de diálogo **Atualizar a configuração de registro em log**, altere as configurações desejadas.
1. Escolha **Registro em log de erros** para registrar somente eventos de erros, **Registro em log de avisos** para registrar somente eventos de aviso, ou ambos. O registro em log será desabilitado se você não realizar uma seleção.
1. Escolha um destino de registro de CloudWatch registros existente ou crie um novo.
1. Escolha **Salvar**.
### Como alterar a configuração de registro em log (CLI)
+ Use o comando [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) da CLI ou a operação de API [https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html) equivalente.
```
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"}"
```
## Visualizar logs
Você pode ver os registros depois que a Amazon começar FSx a emiti-los. Você pode visualizar os logs da seguinte forma:
+ Você pode visualizar os registros acessando o CloudWatch console da Amazon e escolhendo o grupo de registros e o stream de registros para os quais seus registros de eventos são enviados. Para obter mais informações, consulte [Exibir dados de log enviados para CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) no *Guia do usuário do Amazon CloudWatch Logs*.
+ Você pode usar o CloudWatch Logs Insights para pesquisar e analisar interativamente seus dados de registro. Para obter mais informações, consulte [Análise de dados de log com o CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html), no *Guia do usuário do Amazon CloudWatch Logs*.
+ Você também pode exportar logs para o Amazon S3. Para obter mais informações, consulte [Exportação de dados de log para o Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3Export.html) S3, no Guia do usuário do * CloudWatch Amazon Logs*.
Para saber mais sobre os motivos das falhas, consulte [Registros em log de eventos de repositório de dados](data-repo-event-logs.md).