# S3 表类数据存储服务的日志记录和监控
监控是维护 Amazon S3 表类数据存储服务的可靠性、可用性和性能的重要组成部分。我们建议从表存储桶的表中收集监控数据，以便更轻松地调试出现的多点故障。
AWS 提供了多种工具来监控 S3 表类数据存储服务资源并对潜在的事件作出响应。
**Amazon CloudWatch 警报**
使用 Amazon CloudWatch 警报，您可以在指定时间段内监控某个指标。如果指标超过给定阈值，则会向 Amazon SNS 主题或 AWS Auto Scaling 策略发送通知。CloudWatch 警报将不会调用操作，因为这些操作处于特定状态。而是必须在状态已改变并在指定的若干个时间段内保持不变后才调用。有关更多信息，请参阅 [使用 Amazon CloudWatch 监控指标](cloudwatch-monitoring.md)。
**AWS CloudTrail 日志**
CloudTrail 提供了用户、角色或 AWS 服务在 Amazon S3 中所执行操作的记录。使用 CloudTrail 收集的信息，您可以确定向 Amazon S3 发出了什么请求、发出请求的 IP 地址、何人发出的请求、请求的发出时间以及其他详细信息。有关更多信息，请参阅 [使用 AWS CloudTrail 记录 Amazon S3 API 调用](cloudtrail-logging.md)。
**Topics**
+ [使用 AWS CloudTrail 对 S3 表类数据存储服务进行日志记录](s3-tables-logging.md)
+ [使用 Amazon CloudWatch 监控指标](s3-tables-cloudwatch-metrics.md)
# 使用 AWS CloudTrail 对 S3 表类数据存储服务进行日志记录
Amazon S3 与 AWS CloudTrail 集成，后者是一项提供由用户、角色或 AWS 服务所采取操作的记录的服务。CloudTrail 将 Amazon S3 的所有 API 调用作为事件捕获。借助通过 CloudTrail 收集的信息，您可以确定向 Amazon S3 发出哪些请求、发出请求的 IP 地址、请求的发出时间以及其它详细信息。当 Amazon S3 中发生受支持的事件活动时，该活动将记录在 CloudTrail 事件中。可以使用 AWS CloudTrail 跟踪来记录 S3 表类数据存储服务的管理事件和数据事件。有关更多信息，请参阅《AWS CloudTrail User Guide》**中的 [Amazon S3 CloudTrail events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html) 和 [What is AWS CloudTrail?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)
## S3 表类数据存储服务的 CloudTrail 管理事件
管理事件提供对您 AWS 账户内的资源所执行管理操作的相关信息。
默认情况下，CloudTrail 会记录 S3 表类数据存储服务的管理事件。S3 表类数据存储服务的 CloudTrail 管理事件的 `eventsource` 为 ` s3tables.amazonaws.com`。当您设置 AWS 账户时，CloudTrail 管理事件默认处于启用状态。以下 API 操作由 CloudTrail 跟踪并记录为管理事件。
+ [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)
有关 CloudTrail 管理事件的更多信息，请参阅《AWS CloudTrail User Guide》**中的 [Logging management events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html)。
## S3 表类数据存储服务维护的 CloudTrail 管理事件
S3 将自动维护操作作为 `TablesMaintenanceEvent` 管理事件记录到 CloudTrail 中。这些事件发生在诸如压缩和快照到期之类的操作期间。有关 S3 表维护的更多信息，请参阅[表维护](s3-tables-maintenance.md)。
### 如何识别维护事件
您可以通过以下属性值识别 CloudTrail 日志中的 S3 表类数据存储服务维护事件：
+ `eventSource: s3tables.amazonaws.com`
+ `eventType: AwsServiceEvent`
+ `eventName: TablesMaintenanceEvent`
+ `userAgent: maintenance.s3tables.amazonaws.com`
+ `activityType:`
+ `IcebergCompaction`（对于压缩）
+ `IcebergSnapshotManagement`（对于快照到期）
有关压缩维护事件的示例，请参阅[示例 - 表维护管理事件的 CloudTrail 日志文件](s3-tables-log-files.md#example-ct-log-s3tables-3)。
## S3 表类数据存储服务的 CloudTrail 数据事件
数据事件提供对资源或在资源中执行的资源操作的信息。默认情况下，CloudTrail 跟踪不记录数据事件，但您可以将跟踪配置为记录数据事件。
在 CloudTrail 中记录跟踪的数据事件时，您将选择或指定资源类型。S3 表类数据存储服务有两种资源类型：`AWS::S3Tables::Table` 和 `AWS::S3Tables::TableBucket`。
以下数据事件记录到 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)
有关 CloudTrail 数据事件的更多信息，请参阅《AWS CloudTrail User Guide》**中的 [Logging data events](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)。
有关 S3 表类数据存储服务的 CloudTrail 事件的更多信息，请参阅以下主题：
**Topics**
+ [S3 表类数据存储服务的 CloudTrail 管理事件](#s3-tables-management-events)
+ [S3 表类数据存储服务维护的 CloudTrail 管理事件](#s3-tables-maintenance-events)
+ [S3 表类数据存储服务的 CloudTrail 数据事件](#s3-tables-data-events)
+ [S3 表类数据存储服务的 AWS CloudTrail 数据事件日志文件示例](s3-tables-log-files.md)
# S3 表类数据存储服务的 AWS CloudTrail 数据事件日志文件示例
AWS CloudTrail 日志文件包括有关所请求 API 操作的信息、操作的日期和时间和请求参数等。本主题为 S3 表类数据存储服务的 CloudTrail 数据事件提供示例日志文件。
**Topics**
+ [示例 - `GetObject` 数据事件的 CloudTrail 日志文件](#example-ct-log-s3tables)
+ [示例 - 表维护管理事件的 CloudTrail 日志文件](#example-ct-log-s3tables-3)
+ [示例 - `PutObject` 数据事件的 CloudTrail 日志文件](#example-ct-log-s3tables-2)
## 示例 - `GetObject` 数据事件的 CloudTrail 日志文件
下面的示例显示了一个 CloudTrail 日志文件示例，该示例演示了 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) API 操作。
```
{
"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"
}
}
```
## 示例 - 表维护管理事件的 CloudTrail 日志文件
以下是 CloudTrail 日志文件示例，该示例演示了 S3 在自动表维护过程中执行的表压缩的维护事件。有关表维护事件的更多信息，请参阅 [S3 表类数据存储服务维护的 CloudTrail 管理事件](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"
}
```
## 示例 - `PutObject` 数据事件的 CloudTrail 日志文件
下面的示例显示了一个 CloudTrail 日志文件示例，该示例演示了 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) API 操作。
```
{
"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"
}
}
```
# 使用 Amazon CloudWatch 监控指标
您可以使用 Amazon CloudWatch 指标来跟踪表的性能、检测表的异常情况和监控表的运行状况。有几组 CloudWatch 指标可以与 S3 表类数据存储服务结合使用。
**表和表存储桶的每日存储指标**
监控存储在表和表存储桶中的数据量，包括总大小（以字节为单位）和文件数。这些指标跟踪每个访问层的总存储字节数以及表存储桶、表和命名空间级别的文件计数。适用于 S3 表类数据存储服务的存储指标每天报告一次并提供给所有客户，无需额外费用。
**表维护指标**
监控 Amazon S3 对您的表执行的自动维护操作，例如压缩。这些指标跟踪在维护活动期间处理的字节数和文件数。适用于 S3 表类数据存储服务的维护指标每天报告一次并提供给所有客户，无需额外费用。
**请求指标**
监控 S3 表类数据存储服务请求，以快速识别运行问题并对其采取措施。可以选择为各个表存储桶启用这些 CloudWatch 指标。S3 表类数据存储服务的请求指标每分钟报告一次，费率与 CloudWatch 自定义指标的相同。请求指标包括：
+ 数据面板操作计数（GET、PUT、HEAD、POST）
+ 传输的字节数
+ 延迟测量值
+ 错误率
**注意**
**最大努力 CloudWatch 指标传输**
系统将以最大努力传输 CloudWatch 指标。大多数具有请求指标的针对 Amazon S3 对象的请求会导致将数据点发送到 CloudWatch。
无法保证指标的完整性和及时性。可能返回特定请求的数据点，其时间戳晚于实际处理请求的时间。1 分钟的数据点在通过 CloudWatch 提供之前可能会延迟，或者根本不会提供该数据点。您可以通过 CloudWatch 请求指标近乎实时地了解有关存储桶流量性质方面的信息。这并不意味着会完整记录所有请求。根据此特征的最大努力性质，在账单和成本管理控制面板提供的报告中可能有一个或多个访问请求不会出现在存储桶指标中。
# 指标与维度
以下各表列出了 S3 表类数据存储服务发送到 Amazon CloudWatch 的存储指标和维度。
**注意**
**最大努力 CloudWatch 指标传输**
系统将以最大努力传输 CloudWatch 指标。大多数具有请求指标的针对 Amazon S3 对象的请求会导致将数据点发送到 CloudWatch。
无法保证指标的完整性和及时性。可能返回特定请求的数据点，其时间戳晚于实际处理请求的时间。1 分钟的数据点在通过 CloudWatch 提供之前可能会延迟，或者根本不会提供该数据点。您可以通过 CloudWatch 请求指标近乎实时地了解有关存储桶流量性质方面的信息。这并不意味着会完整记录所有请求。根据此特征的最大努力性质，在账单和成本管理控制面板提供的报告中可能有一个或多个访问请求不会出现在存储桶指标中。
## CloudWatch 中表存储桶的每日存储指标
`AWS/S3/Tables` 命名空间包括以下每日存储指标，这些指标免费提供，无需额外费用。您可以按表存储桶、表或命名空间名称筛选这些指标。
**每日存储指标**
| 指标名称 | 说明 | 单位 | 统计数据 | 粒度 |
| --- | --- | --- | --- | --- |
| 总存储桶存储空间 | 表存储桶中的所有表使用的存储空间量（以字节为单位） | 字节 | 总和 | 每天 |
| 总文件数 | 存储在表存储桶中的所有文件的总数 | 计数 | 总和 | 每天 |
## 表维护指标
`AWS/S3/Tables` 命名空间包括以下表维护指标，这些指标免费提供，无需额外费用。您可以按表存储桶、表或命名空间名称筛选这些指标。
**表维护指标**
| 指标名称 | 说明 | 单位 | 统计数据 | 粒度 |
| --- | --- | --- | --- | --- |
| CompactionBytesProcessed | 表压缩操作期间处理的字节数 | 字节 | 总和 | 每天 |
| CompactionObjectsCount | 表压缩操作期间处理的对象数量 | 计数 | 总和 | 每天 |
## CloudWatch 中表和表存储桶的请求指标
`AWS/S3/Tables` 命名空间包括以下请求指标，这些指标的费率与 CloudWatch 自定义指标的相同。您可以按表存储桶、表或命名空间名称筛选这些指标。
**请求指标**
| 指标名称 | 说明 | 单位 | 统计数据 | 粒度 |
| --- | --- | --- | --- | --- |
| 所有请求计数 | 向表存储桶发出的 HTTP 请求的总数。 | 计数 | 总和 | 1 分钟 |
| Get 请求计数 | 为从表中检索对象而发出的 HTTP GET 请求的数量 | 计数 | 总和 | 1 分钟 |
| Put 请求计数 | 为向表中添加对象而发出的 HTTP PUT 请求的数量 | 计数 | 总和 | 1 分钟 |
| Head 请求计数 | 为从表中检索元数据而发出的 HTTP HEAD 请求的数量 | 计数 | 总和 | 1 分钟 |
| Post 请求计数 | 对表发出的 HTTP POST 请求的数量 | 计数 | 总和 | 1 分钟 |
| UpdateTableMetadataLocation 请求计数 | 为更新表元数据位置而发出的请求的数量 | 计数 | 总和 | 1 分钟 |
| GetTableMetadataLocation 请求计数 | 为检索表元数据位置而发出的请求的数量 | 计数 | 总和 | 1 分钟 |
| BytesDownloaded | 为表请求下载的字节数 | 字节 | 总和 | 1 分钟 |
| BytesUploaded | 为表请求上传的字节数 | 字节 | 总和 | 1 分钟 |
| 4xxErrors | 返回的 HTTP 4xx 客户端错误状态代码的计数 | 计数 | 总和 | 1 分钟 |
| 5xxErrors | 返回的 HTTP 5xx 服务器错误状态代码的计数 | 计数 | 总和 | 1 分钟 |
| FirstByteLatency | 从收到完整请求到开始返回响应的每请求时间。 | 毫秒 | 总和 | 1 分钟 |
| TotalRequestLatency | 从收到第一个字节到发送最后一个字节的已用每请求时间。 | 毫秒 | 总和 | 1 分钟 |
## CloudWatch 中的 S3 表类数据存储服务维度
下列维度用于筛选 S3 表类数据存储服务指标。
**S3 表类数据存储服务维度**
| 维度名称 | 说明 | 示例值 |
| --- | --- | --- |
| TableBucketName | Amazon S3 表存储桶的名称 | my-table-bucket |
| Namespace | 表存储桶中包含一个或多个表的命名空间 | my-department |
| TableName | 命名空间中特定表的名称 | transactions |
# 访问 CloudWatch 指标
可以使用 CloudWatch 控制台、AWS CLI 或 CloudWatch API 来监控 S3 表类数据存储服务指标。本节介绍如何使用这些不同的方法访问指标。
## 使用 S3 控制台
1. 登录 AWS 管理控制台并在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 中打开 Amazon S3 控制台。
1. 在左侧导航窗格中，选择**表存储桶**。
1. 在存储桶列表中，选择存储桶的名称，该存储桶包含您要查看其指标的表。
1. 选择**指标**选项卡。
1. 在任意指标窗格中选择**在 CloudWatch 中查看**，以导航到 CloudWatch 控制台并查看 `AWS/S3/Tables` 命名空间中的可用指标。
## 使用 AWS CLI
要使用 AWS CLI 列出 S3 表类数据存储服务的指标，请使用 `list-metrics` 命令并将 `--namespace` 参数设置为 `AWS/S3/Tables`：
```
aws cloudwatch list-metrics --namespace AWS/S3/Tables
```
要获取特定 S3 表类数据存储服务指标的统计数据，请使用 `get-metric-statistics` 命令。例如：
```
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
```
## 最佳实践
+ 检索指标时，请根据指标的粒度设置期间值。对于每日指标（如存储指标），请使用 86400 秒（24 小时）。对于分钟级指标（如请求指标），请使用 60 秒。
+ 适当地使用维度将指标筛选到所需范围（表存储桶、命名空间或单个表级别）。
+ 考虑使用指标数学来创建更符合您的监控需求的派生指标。
## 相关资源
+ [Amazon CloudWatch 概念](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)
+ [使用 Amazon CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)
# 管理 CloudWatch 指标
默认情况下，对所有 Amazon S3 表和表存储桶启用存储指标。您可以通过控制台、AWS Command Line Interface（AWS CLI）或 AWS SDK 启用或禁用其他请求指标。
## 先决条件
+ 需要 `s3table:PutTableBucketMetricsConfiguration` IAM 权限
**注意**
S3 表类数据存储服务请求指标的费率与 CloudWatch 自定义指标的费率相同。
## 使用 AWS 管理控制台
启用或禁用其它指标
1. 登录 AWS 管理控制台并在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 中打开 Amazon S3 控制台。
1. 在左侧导航窗格中，选择**表存储桶**。
1. 在存储桶列表中，选择表存储桶的名称，该存储桶包含您要请求其指标的表。
1. 选择**指标**选项卡。
1. 从“请求指标”面板中，选择**编辑**。
1. 选择**已启用**或**已禁用**，然后选择**保存更改**。
## 使用 AWS CLI
这些示例说明如何使用 AWS CLI 为表存储桶启用或禁用请求指标。要使用这些命令，请将*用户输入占位符*替换为您自己的信息。
**Example ：为表存储桶启用请求指标：**
```
aws s3tables put-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```
**Example ：为表存储桶禁用请求指标：**
```
aws s3tables delete-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```