# Registro em log e monitoramento para Tabelas do S3
O monitoramento é uma parte importante para manter a confiabilidade, a disponibilidade e o desempenho da funcionalidade Tabelas do Amazon S3. Recomendamos coletar dados de monitoramento de suas tabelas em buckets de tabela para que possa depurar mais facilmente uma falha multiponto, caso ocorra.
A AWS oferece várias ferramentas para monitorar os recursos da funcionalidade Tabelas do S3 e responder a possíveis incidentes.
**Alarmes do Amazon CloudWatch**
Com o uso de alarmes do Amazon CloudWatch, você observa uma única métrica durante um período especificado. Se a métrica ultrapassar um limite especificado, uma notificação será enviada para um tópico do Amazon SNS ou para uma política do AWS Auto Scaling. Os alarmes do CloudWatch não invocam ações só porque estão em um determinado estado. O estado deve ter sido alterado e mantido por uma quantidade especificada de períodos. Para obter mais informações, consulte [Monitoramento de métricas com o Amazon CloudWatch](cloudwatch-monitoring.md).
**AWS CloudTrailLogs do **
O CloudTrail fornece um registro de ações executadas por um usuário, uma função ou um serviço da AWS no Amazon S3. Usando as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita para o Amazon S3, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais. Para obter mais informações, consulte [Registrar chamadas de API do Amazon S3 em log usando AWS CloudTrail](cloudtrail-logging.md).
**Topics**
+ [Registro em log com o AWS CloudTrail para a funcionalidade Tabelas do S3](s3-tables-logging.md)
+ [Monitoramento de métricas com o Amazon CloudWatch](s3-tables-cloudwatch-metrics.md)
# Registro em log com o AWS CloudTrail para a funcionalidade Tabelas do S3
O Amazon S3 é integrado ao AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, um perfil ou um serviço da AWS. O CloudTrail captura todas as chamadas de API para o Amazon S3 como eventos. Ao fazer uso das informações coletadas pelo CloudTrail, é possível determinar a solicitação feita ao Amazon S3, o endereço IP que a realizou, quando ela foi feita e detalhes adicionais. Quando ocorre alguma atividade de evento aceita no Amazon S3, essa atividade é registrada em um evento do CloudTrail. É possível usar a trilha do AWS CloudTrail para registrar eventos de gerenciamento e de dados em log para a funcionalidade Tabelas do S3. Para ter mais informações, consulte [Eventos do CloudTrail no Amazon S3](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html) e [What is AWS CloudTrail?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) no *Guia do usuário do AWS CloudTrail*.
## Eventos de gerenciamento do CloudTrail para a funcionalidade Tabelas do S3
Os eventos de gerenciamento fornecem informações sobre operações de gerenciamento executadas em recursos na sua conta da AWS.
Por padrão, o CloudTrail registra eventos de gerenciamento em log para a funcionalidade Tabelas do S3. O `eventsource` para eventos de gerenciamento do CloudTrail para a funcionalidade Tabelas do S3 é ` s3tables.amazonaws.com`. Quando você configura a conta AWS, os eventos de gerenciamento do CloudTrail são habilitados por padrão. As ações de API a seguir são rastreadas pelo CloudTrail e registradas em log como eventos de gerenciamento.
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateNamespace.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateNamespace.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateTable.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateTable.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateTableBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_CreateTableBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteNamespace.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteNamespace.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTable.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTableBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTablePolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_DeleteTablePolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetNamespace.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetNamespace.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTable.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTable.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucket.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucket.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucketMaintenanceConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMaintenanceConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMaintenanceJobStatus.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMaintenanceJobStatus.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMetadataLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTableMetadataLocation.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTablePolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_GetTablePolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListNamespaces.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListNamespaces.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListTableBuckets.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListTableBuckets.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListTables.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_ListTables.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTableBucketMaintenanceConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTableMaintenanceConfiguration.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutBucketPolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutBucketPolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTablePolicy.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_PutTablePolicy.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_RenameTable.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_RenameTable.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_UpdateTableMetadataLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3TableBuckets_UpdateTableMetadataLocation.html)
Para ter mais informações sobre eventos de gerenciamento do CloudTrail, consulte [Logging management events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html) no *Guia do usuário do AWS CloudTrail*.
## Eventos de gerenciamento do CloudTrail para manutenção da funcionalidade Tabelas do S3
O S3 registra em log as operações de manutenção automática como eventos `TablesMaintenanceEvent` de gerenciamento no CloudTrail. Esses eventos ocorrem durante determinadas operações, como compactação e expiração de snapshots. Para ter mais informações sobre a manutenção de tabelas do S3, consulte [Manutenção de tabelas](s3-tables-maintenance.md).
### Como identificar eventos de manutenção
É possível identificar eventos de manutenção da funcionalidade Tabelas do S3 em logs do CloudTrail por meio dos seguintes valores de atributo:
+ `eventSource: s3tables.amazonaws.com`
+ `eventType: AwsServiceEvent`
+ `eventName: TablesMaintenanceEvent`
+ `userAgent: maintenance.s3tables.amazonaws.com`
+ `activityType:`
+ `IcebergCompaction` (para compactação).
+ `IcebergSnapshotManagement` (para expiração de snapshot).
Para ver um exemplo de evento de manutenção de compactação, consulte [Exemplo: arquivo de log do CloudTrail para evento de gerenciamento de manutenção de tabelas](s3-tables-log-files.md#example-ct-log-s3tables-3).
## Eventos de dados do CloudTrail para a funcionalidade Tabelas do S3
Os eventos de dados fornecem informações sobre as operações realizadas em um recurso ou dentro dele. Por padrão, as trilhas do CloudTrail não registram eventos de dados em log, mas é possível configurar as trilhas para que façam isso.
Ao registrar eventos de dados em log para uma trilha no CloudTrail, você escolherá ou especificará o tipo de recurso. A funcionalidade Tabelas do S3 tem dois tipos de recurso, `AWS::S3Tables::Table` e `AWS::S3Tables::TableBucket`.
Os eventos de dados a seguir são registrados em log no CloudTrail.
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html)
Para ter mais informações sobre os eventos de dados do CloudTrail, consulte [Logging data events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html) no *Guia do usuário do AWS CloudTrail*.
Para ter mais informações sobre os eventos do CloudTrail para a funcionalidade Tabelas do S3, consulte os seguintes tópicos:
**Topics**
+ [Eventos de gerenciamento do CloudTrail para a funcionalidade Tabelas do S3](#s3-tables-management-events)
+ [Eventos de gerenciamento do CloudTrail para manutenção da funcionalidade Tabelas do S3](#s3-tables-maintenance-events)
+ [Eventos de dados do CloudTrail para a funcionalidade Tabelas do S3](#s3-tables-data-events)
+ [Exemplos de arquivos de log de eventos de dados do AWS CloudTrail para a funcionalidade Tabelas do S3](s3-tables-log-files.md)
# Exemplos de arquivos de log de eventos de dados do AWS CloudTrail para a funcionalidade Tabelas do S3
O arquivo de log do AWS CloudTrail inclui informações sobre a operação de API solicitada, a data e a hora da operação, os parâmetros de solicitação etc. Este tópico fornece exemplos de arquivos de log para eventos de dados do CloudTrail para a funcionalidade Tabelas do S3.
**Topics**
+ [Exemplo: arquivo de log do CloudTrail para evento de dados de `GetObject`](#example-ct-log-s3tables)
+ [Exemplo: arquivo de log do CloudTrail para evento de gerenciamento de manutenção de tabelas](#example-ct-log-s3tables-3)
+ [Exemplo: arquivo de log do CloudTrail para evento de dados de `PutObject`](#example-ct-log-s3tables-2)
## Exemplo: arquivo de log do CloudTrail para evento de dados de `GetObject`
Veja a seguir um exemplo de arquivo de log do CloudTrail que demonstra a operação de API [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html).
```
{
"eventVersion": "1.11",
"userIdentity": {
"type": "IAMUser",
"principalId": "123456789012",
"arn": "arn:aws:iam::111122223333:user/"myUserName",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName":"myUserName"
},
"eventTime": "2024-11-22T17:12:25Z",
"eventSource": "s3tables.amazonaws.com",
"eventName": "GetObject",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "[aws-cli/2.18.5]",
"requestParameters": {
"Host": "tableWarehouseLocation.s3.us-east-1.amazonaws.com",
"key": "product-info.json"
},
"responseElements": null,
"additionalEventData": {
"SignatureVersion": "SigV4",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"bytesTransferredIn": 0,
"AuthenticationMethod": "AuthHeader",
"xAmzId2": "q6xhNJYmhg",
"bytesTransferredOut": 28441
},
"requestID": "07D681123BD12AED",
"eventID": "f2b287f3-0df1-1234-a2f4-c4bdfed47657",
"readOnly": true,
"resources": [{
"accountId": "111122223333",
"type": "AWS::S3Tables::TableBucket",
"ARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1"
}, {
"accountId": "111122223333",
"type": "AWS::S3Tables::Table",
"ARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket/table/111aa1111-22bb-33cc-44dd-5555eee66ffff"
}],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "444455556666",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "tableWarehouseLocation.s3.us-east-1.amazonaws.com"
}
}
```
## Exemplo: arquivo de log do CloudTrail para evento de gerenciamento de manutenção de tabelas
Veja a seguir um exemplo de arquivo de log do CloudTrail que demonstra um evento de manutenção para compactação de tabelas realizado pelo S3 como parte da manutenção automática de tabelas. Para ter mais informações sobre eventos de manutenção de tabelas, consulte [Eventos de gerenciamento do CloudTrail para manutenção da funcionalidade Tabelas do S3](s3-tables-logging.md#s3-tables-maintenance-events).
```
{
"eventVersion": "1.11",
"userIdentity": {
"type": "AWSService",
"invokedBy": "maintenance.s3tables.amazonaws.com"
},
"eventTime": "2025-09-18T20:13:14Z",
"eventSource": "s3tables.amazonaws.com",
"eventName": "TablesMaintenanceEvent",
"awsRegion": "us-east-1",
"sourceIPAddress": "maintenance.s3tables.amazonaws.com",
"userAgent": "maintenance.s3tables.amazonaws.com",
"requestParameters": null,
"responseElements": null,
"eventID": "b8f96329-ef5c-32b5-94f6-eeed9061ea32",
"readOnly": false,
"resources": [
{
"accountId": "111122223333",
"type": "AWS::S3Tables::TableBucket",
"ARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket"
},
{
"accountId": "111122223333",
"type": "AWS::S3Tables::Table",
"ARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/7ff7750e-23b3-481e-a90a-7d87d423d336"
}
],
"eventType": "AwsServiceEvent",
"managementEvent": true,
"recipientAccountId": "111122223333",
"sharedEventID": "62a57826-a66e-479b-befa-0e65663ee9e8",
"serviceEventDetails": {
"activityType": "icebergCompaction"
},
"eventCategory": "Management"
}
```
## Exemplo: arquivo de log do CloudTrail para evento de dados de `PutObject`
Veja a seguir um exemplo de arquivo de log do CloudTrail que demonstra a operação de API [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html).
```
{
"eventVersion": "1.11",
"userIdentity": {
"type": "IAMUser",
"principalId": "123456789012",
"arn": "arn:aws:iam::444455556666:user/"myUserName",
"accountId": "444455556666",
"accessKeyId": "AKIAI44QH8DHBEXAMPLE",
"userName":"myUserName"
},
"eventTime": "2024-11-22T17:12:25Z",
"eventSource": "s3tables.amazonaws.com",
"eventName": "PutObject",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "[aws-cli/2.18.5]",
"requestParameters": {
"Host": "tableWarehouseLocation.s3.us-east-1.amazonaws.com",
"key": "product-info.json"
},
"responseElements": {
"x-amz-server-side-encryption": "AES256",
"x-amz-version-id": "13zAFMdccAjt3MWd6ehxgCCCDRdkAKDw"
},
"additionalEventData": {
"SignatureVersion": "SigV4",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"bytesTransferredIn": 28441,
"AuthenticationMethod": "AuthHeader",
"xAmzId2": "q6xhCJYmhg",
"bytesTransferredOut": 0
},
"requestID": "28d2faaf-1234-4649-997d-EXAMPLE72818",
"eventID": "694d604a-d190-1234-0dd1-EXAMPLEe20c1",
"readOnly": false,
"resources": [{
"accountId": "444455556666",
"type": "AWS::S3Tables::TableBucket",
"ARN": "arn:aws:s3tables:us-east-1:444455556666:bucket/amzn-s3-demo-bucket1"
}, {
"accountId": "444455556666",
"type": "AWS::S3Tables::Table",
"ARN": "arn:aws:s3tables:us-east-1:444455556666:bucket/amzn-s3-demo-bucket1/table/b89ec883-b1d9-4b37-9cd7-b86f590123f4"
}],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "111122223333",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "tableWarehouseLocation.s3.us-east-1.amazonaws.com"
}
}
```
# 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
```