# Monitoramento de métricas com o Amazon CloudWatch
É possível usar métricas do Amazon CloudWatch para monitorar o desempenho, detectar anomalias e monitorar a integridade operacional das tabelas. Existem vários conjuntos de métricas do CloudWatch que você pode usar com a funcionalidade Tabelas do S3.
**Métricas diárias de armazenamento para tabelas e buckets de tabela**
Monitore a quantidade de dados armazenados em tabelas e buckets de tabela, como o tamanho total em bytes e o número de arquivos. Essas métricas rastreiam o total de bytes de armazenamento por nível de acesso e contagens de arquivos em nível de bucket de tabela, de tabela e de namespace. As métricas de armazenamento para a funcionalidade Tabelas do S3 são relatadas uma vez por dia e fornecidas para todos os clientes sem nenhum custo adicional.
**Métricas de manutenção de tabelas**
Monitore as operações de manutenção automatizada realizadas pelo Amazon S3 em suas tabelas, como compactação. Essas métricas rastreiam o número de bytes e arquivos processados durante as atividades de manutenção. As métricas de armazenamento para a funcionalidade Tabelas do S3 são relatadas uma vez por dia e fornecidas para todos os clientes sem nenhum custo adicional.
**Métricas de solicitação**
Monitore as solicitações funcionalidade Tabelas do S3 para identificar e agir rapidamente em caso de problemas operacionais. Essas métricas do CloudWatch podem ser habilitadas opcionalmente para buckets de tabela individuais. As métricas de solicitação da funcionalidade Tabelas do S3 são relatadas uma vez a cada minuto e são cobradas com base na mesma taxa das métricas personalizadas do CloudWatch. As métricas da solicitação incluem:
+ contagens de operações do plano de dados (GET, PUT, HEAD e POST)
+ bytes transferidos
+ medidas de latência
+ taxas de erro
**nota**
**Entrega de métricas do CloudWatch com o melhor esforço**
As métricas do CloudWatch são entregues com base em melhor esforço. A maioria de solicitações para um objeto do Amazon S3 que tenha métricas de solicitações resulta no envio de um ponto de dados ao CloudWatch.
A integridade e pontualidade das métricas não são garantidas. O ponto de dados para uma solicitação específica pode ser retornado com um timestamp posterior à solicitação processada. O ponto de dados de um minuto pode ser atrasado antes de ser disponibilizado pelo CloudWatch ou pode nem ser entregue. As métricas de solicitação do CloudWatch lhe dão uma ideia da natureza do tráfego em seu bucket em tempo quase real. Não se trata de uma contabilidade completa de todas as solicitações. Devido à natureza de melhor esforço deste recurso, os relatórios disponíveis no Painel de faturamento e de gerenciamento de custo podem incluir uma ou mais solicitações de acesso que não aparecem nas métricas do bucket.
# Métricas e dimensões
As métricas e dimensões que o Amazon S3 envia ao Amazon CloudWatch estão listadas nas tabelas a seguir.
**nota**
**Entrega de métricas do CloudWatch com o melhor esforço**
As métricas do CloudWatch são entregues com base em melhor esforço. A maioria de solicitações para um objeto do Amazon S3 que tenha métricas de solicitações resulta no envio de um ponto de dados ao CloudWatch.
A integridade e pontualidade das métricas não são garantidas. O ponto de dados para uma solicitação específica pode ser retornado com um timestamp posterior à solicitação processada. O ponto de dados de um minuto pode ser atrasado antes de ser disponibilizado pelo CloudWatch ou pode nem ser entregue. As métricas de solicitação do CloudWatch lhe dão uma ideia da natureza do tráfego em seu bucket em tempo quase real. Não se trata de uma contabilidade completa de todas as solicitações. Devido à natureza de melhor esforço deste recurso, os relatórios disponíveis no Painel de faturamento e de gerenciamento de custo podem incluir uma ou mais solicitações de acesso que não aparecem nas métricas do bucket.
## Métricas diárias de armazenamento para buckets de tabela no CloudWatch
O namespace `AWS/S3/Tables` inclui as métricas diárias de armazenamento a seguir, que estão sempre disponíveis sem custo adicional. É possível filtrar essas métricas por bucket de tabela, tabela ou nome de namespace.
**Métricas diárias de armazenamento**
| Nome da métrica | Descrição | Unidades | Statistics | Granularity |
| --- | --- | --- | --- | --- |
| Total Bucket Storage | A quantidade de armazenamento em bytes usada por todas as tabelas em um bucket de tabela. | Bytes | Soma | Por dia |
| Total number of files | A contagem total de todos os arquivos armazenados em um bucket de tabela. | Contagem | Soma | Por dia |
## Métricas de manutenção de tabelas
O namespace `AWS/S3/Tables` inclui as métricas de manutenção de tabelas a seguir, que estão sempre disponíveis sem custo adicional. É possível filtrar essas métricas por bucket de tabela, tabela ou nome de namespace.
**Métricas de manutenção de tabelas**
| Nome da métrica | Descrição | Unidades | Statistics | Granularity |
| --- | --- | --- | --- | --- |
| CompactionBytesProcessed | O número de bytes processados durante as operações de compactação de tabela. | Bytes | Soma | Por dia |
| CompactionObjectsCount | O número de objetos processados durante as operações de compactação de tabela. | Contagem | Soma | Por dia |
## Solicitar métricas para tabelas e buckets de tabela no CloudWatch
O namespace `AWS/S3/Tables` inclui as métricas de solicitação a seguir, que são cobradas usando a mesma taxa das métricas personalizadas do CloudWatch. É possível filtrar essas métricas por bucket de tabela, tabela ou nome de namespace.
**Métricas de solicitação**
| Nome da métrica | Descrição | Unidades | Statistics | Granularity |
| --- | --- | --- | --- | --- |
| All requests count | O número de solicitações HTTP feitas a um bucket de tabela. | Contagem | Soma | 1 minuto |
| Get requests count | O número de solicitações HTTP GET feitas para recuperar objetos de tabelas. | Contagem | Soma | 1 minuto |
| Put requests count | O número de solicitações HTTP PUT feitas para recuperar objetos de tabelas. | Contagem | Soma | 1 minuto |
| Head requests count | O número de solicitações HTTP HEAD feitas para recuperar objetos de tabelas. | Contagem | Soma | 1 minuto |
| Post requests counts | O número de solicitações HTTP POST feitas para tabelas. | Contagem | Soma | 1 minuto |
| UpdateTableMetadataLocation requests count | O número de solicitações feitas para atualizar locais de metadados de tabela. | Contagem | Soma | 1 minuto |
| GetTableMetadataLocation requests count | O número de solicitações feitas para recuperar locais de metadados de tabela. | Contagem | Soma | 1 minuto |
| BytesDownloaded | O número de bytes baixados para solicitações de tabela. | Bytes | Soma | 1 minuto |
| BytesUploaded | O número de bytes carregados para solicitações de tabela. | Bytes | Soma | 1 minuto |
| 4xxErros | A contagem de códigos de status de erro do cliente HTTP 4xx exibidos. | Contagem | Soma | 1 minuto |
| 5xxErros | A contagem de códigos de status de erro do servidor HTTP 5xx exibidos. | Contagem | Soma | 1 minuto |
| FirstByteLatency | O tempo por solicitação desde o recebimento da solicitação completa até o momento em que a resposta começa a ser exibida. | Milissegundos | Soma | 1 minuto |
| TotalRequestLatency | O tempo por solicitação decorrido do primeiro byte recebido até o último byte enviado. | Milissegundos | Soma | 1 minuto |
## Dimensões da funcionalidade Tabelas do S3 no CloudWatch
As dimensões a seguir são usadas para filtrar métricas da funcionalidade Tabelas do S3.
**Dimensões da funcionalidade Tabelas do S3**
| Nome da dimensão | Descrição | Valor de exemplo |
| --- | --- | --- |
| TableBucketName | O nome do bucket de tabela do Amazon S3 | my-table-bucket |
| Namespace | O namespace dentro do bucket de tabela que contém uma ou mais tabelas | my-department |
| TableName | O nome de uma tabela específica em um namespace | transactions |
# Acessar métricas do CloudWatch
Você pode monitorar essas métricas da funcionalidade Tabelas do S3 usando o console do CloudWatch, a AWS CLI ou a API do CloudWatch. Esta seção explica como acessar suas métricas usando esses diferentes métodos.
## Usar o console do S3
1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de tabela**.
1. Na lista de buckets, selecione o nome do bucket que contém as tabelas para as quais você deseja ver métricas.
1. Escolha a guia **Métricas**.
1. Escolha a opção **Visualizar no CloudWatch** em qualquer painel de métricas para navegar até o console do CloudWatch e ver as métricas disponíveis no namespace `AWS/S3/Tables`.
## Como usar o AWS CLI
Para listar métricas para a funcionalidade Tabelas do S3 usando a AWS CLI, use o comando `list-metrics` com o parâmetro `--namespace` definido como `AWS/S3/Tables`:
```
aws cloudwatch list-metrics --namespace AWS/S3/Tables
```
Para obter estatísticas de uma métrica específica da funcionalidade Tabelas do S3, use o comando `get-metric-statistics`. Por exemplo:
```
aws cloudwatch get-metric-statistics \
--namespace AWS/S3/Tables \
--metric-name TotalBucketStorage \
--dimensions Name=TableBucketName,Value=MyTableBucket \
--start-time 2025-03-01T00:00:00 \
--end-time 2025-03-02T00:00:00 \
--period 86400 \
--statistics Average
```
## Práticas recomendadas
+ Ao recuperar métricas, defina o valor do período com base na granularidade da métrica. Para métricas diárias (como métricas de armazenamento), use 86.400 segundos (24 horas). Para métricas de minutos (como métricas de solicitação), use 60 segundos.
+ Use as dimensões adequadamente para filtrar as métricas de acordo com o escopo desejado (bucket de tabela, namespace ou nível de tabela individual).
+ Considere a possibilidade de usar matemática métrica para criar métricas derivadas que atendam melhor às suas necessidades de monitoramento.
## Recursos relacionados
+ [Conceitos do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)
+ [Usar painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)
# Gerenciar métricas do CloudWatch
As métricas de armazenamento estão habilitadas por padrão para todas as tabelas e buckets de tabela do Amazon S3. É possível habilitar ou desabilitar métricas adicionais de solicitação por meio do console, da AWS Command Line Interface (AWS CLI) ou de SDKs da AWS.
## Pré-requisitos
+ Requer a permissão `s3table:PutTableBucketMetricsConfiguration` do IAM
**nota**
As métricas de solicitação da funcionalidade Tabelas do S3 são cobradas usando a mesma taxa das métricas personalizadas do CloudWatch.
## Usar do o Console do Gerenciamento da AWS
Como habilitar ou desabilitar métricas adicionais
1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de tabela**.
1. Na lista de buckets, selecione o nome do bucket de tabela que contém as tabelas para as quais você deseja solicitar métricas.
1. Escolha a guia **Métricas**.
1. No painel “Métricas da solicitação”, escolha **Editar**.
1. Escolha **Habilitar** ou **Desabilitar** e selecione **Salvar alterações**.
## Como usar o AWS CLI
Estes exemplos mostram como habilitar ou desabilitar métricas de solicitação para buckets de tabela usando a AWS CLI. Para usar esses comandos, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
**Example : habilitar as métricas de solicitação para um bucket de tabela**
```
aws s3tables put-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```
**Example : desabilitar as métricas de solicitação para um bucket de tabela**
```
aws s3tables delete-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```