# Monitorar o S3 Files com o Amazon CloudWatch
<a name="s3-files-monitoring-cloudwatch"></a>

É possível monitorar sistemas de arquivos do S3 Files usando o [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html), que coleta e processa dados brutos do Amazon S3 Files e os transforma em métricas legíveis. Como essas métricas são mantidas por 15 meses, você pode acessar informações históricas e ter uma perspectiva melhor do desempenho de seus sistemas de arquivos.

Os dados de métrica do S3 Files são enviados automaticamente ao CloudWatch. A maioria das métricas é enviada em intervalos de 1 minuto, enquanto as métricas de armazenamento são enviadas a cada 15 minutos. É possível criar [alarmes do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) que enviam notificações quando uma métrica excede um limite especificado por você. Também é possível usar painéis do CloudWatch, que são páginas iniciais personalizáveis no console do CloudWatch que podem ser usadas para monitorar recursos em uma única visualização. Para ter mais informações, consulte [Criação de um painel personalizado no CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html).

## Métricas do CloudWatch para o S3 Files
<a name="s3-files-monitoring-cloudwatch-metrics"></a>

As métricas do S3 Files usam o namespace `AWS/S3/Files`. Todas as métricas são relatadas para uma única dimensão `FileSystemId`. O namespace `AWS/S3/Files` inclui as métricas a seguir:


| Métrica | Descrição | Unidades e estatísticas válidas | 
| --- | --- | --- | 
| StorageBytes | O tamanho total do sistema de arquivos em bytes, que inclui dados e metadados. Essa métrica é emitida a cada 15 minutos para o CloudWatch. | Unidade: bytes. Mínimo, máximo e médio | 
| Inodes | O número total de inodes (como arquivos, diretórios e links simbólicos) em um sistema de arquivos do S3 Files. Essa métrica é emitida a cada 15 minutos para o CloudWatch. | Unidades: contagem. Soma | 
| PendingExports | O número total de arquivos e diretórios pendentes de exportação para o bucket do S3. | Unidades: contagem. Soma | 
| ImportFailures | O número total de objetos cuja importação para o sistema de arquivos falhou após novas tentativas (por exemplo, permissões incorretas do IAM). | Unidades: contagem. Soma | 
| ExportFailures | O número total de arquivos e diretórios cuja exportação falhou e não será repetida. Essa métrica ajuda a identificar falhas na exportação do terminal para que seja possível solucionar problemas e agir (por exemplo, atualizar as permissões do IAM). | Unidades: contagem. Soma | 
| DataReadBytes | O número de bytes lidos no sistema de arquivos. SampleCount fornece o número de operações de leitura de dados. É possível calcular o throughput de leitura de dados visualizando essa métrica por unidade de tempo. | Unidades: bytes (mínimo, máximo, média e soma), contagem (SampleCount) | 
| DataWriteBytes | O número de bytes gravados no sistema de arquivos. SampleCount fornece o número de operações de gravação de dados. É possível calcular o throughput de gravação de dados visualizando essa métrica por unidade de tempo. | Unidades: bytes (mínimo, máximo, média e soma), contagem (SampleCount) | 
| MetadataReadBytes | O número de bytes de metadados lidos no sistema de arquivos. SampleCount fornece o número de operações de leitura de metadados. | Unidades: bytes (mínimo, máximo, média e soma), contagem (SampleCount) | 
| MetadataWriteBytes | O número de bytes de metadados gravados no sistema de arquivos. SampleCount fornece o número de operações de gravação de metadados. | Unidades: bytes (mínimo, máximo, média e soma), contagem (SampleCount) | 
| LostAndFoundFiles | O número total de arquivos no diretório de achados e perdidos. O diretório de achados e perdidos está localizado no diretório raiz do sistema de arquivos, abaixo do nome .s3files-lost\+found-{{file-system-id}}. Os arquivos no diretório de achados e perdidos não são copiados para o bucket do S3. Quando ocorre um conflito devido a alterações simultâneas nos mesmos dados no sistema de arquivos e no bucket do S3, o S3 Files trata o bucket do S3 como a fonte de referência e move o arquivo conflitante para o diretório de achados e perdidos. | Unidades: contagem. Soma | 
| ClientConnections | O número de conexões de cliente com um sistema de arquivos. | Unidades: contagem. Soma | 

## Métricas de conectividade de clientes
<a name="s3-files-monitoring-cloudwatch-client-metrics"></a>

O S3 Files pode otimizar o desempenho de leitura ao permitir que os clientes leiam os dados do arquivo diretamente do bucket de vinculado do S3. Para permitir isso, o cliente do S3 Files emite métricas de conectividade que monitoram se o cliente pode estabelecer as conexões necessárias.

Essas métricas são emitidas pelo cliente do S3 Files (amazon-efs-utils) e publicadas no namespace `efs-utils/S3Files` do CloudWatch. A emissão de métricas é está habilitada por padrão como parte da experiência do S3 Files.


| Métrica | Descrição | Unidades e estatísticas válidas | 
| --- | --- | --- | 
| NFSConnectionAccessible | Indica se o cliente pode se conectar ao sistema de arquivos por meio da montagem do NFS. O valor 1 significa que a conexão está acessível. O valor 0 significa que a conexão não está acessível. | Unidades: nenhuma. Mínimo, máximo e médio | 
| S3BucketAccessible | Indica se o cliente tem as permissões necessárias para ler dados do bucket vinculado do S3. O valor 1 significa que o cliente tem as permissões necessárias. O valor 0 significa que o cliente não tem as permissões necessárias. | Unidades: nenhuma. Mínimo, máximo e médio | 
| S3BucketReachable | Indica se o bucket vinculado do S3 e o prefixo existem e podem ser acessados pelo cliente. O valor 1 significa que o bucket e o prefixo estão acessíveis. O valor 0 significa que o bucket e o prefixo não estão acessíveis. | Unidades: nenhuma. Mínimo, máximo e médio | 

## Acessar métricas do CloudWatch
<a name="s3-files-monitoring-cloudwatch-access"></a>

É possível visualizar métricas do S3 Files usando o console do CloudWatch, a AWS CLI ou a API do CloudWatch.

### Como exibir métricas usando o console do CloudWatch
<a name="s3-files-monitoring-cloudwatch-access-console"></a>

1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Metrics** e, em seguida, **All metrics**.

1. Escolha o namespace **S3Files**.

1. Escolha **Métricas do sistema de arquivos**.

1. Escolha as métricas que você deseja visualizar.

1. Escolha a guia **Métricas em gráficos** para configurar a exibição do grafo.

### Como visualizar métricas usando a AWS CLI
<a name="s3-files-monitoring-cloudwatch-access-cli"></a>

Use o comando `get-metric-statistics`. Por exemplo, para visualizar `DataReadBytes`:

```
aws cloudwatch get-metric-statistics \
  --namespace AWS/S3/Files \
  --metric-name DataReadBytes \
  --dimensions Name=FileSystemId,Value={{file-system-id}} \
  --start-time 2025-01-20T00:00:00Z \
  --end-time 2025-01-20T23:59:59Z \
  --period 3600 \
  --statistics Sum
```