# Amazon CloudWatch를 사용한 지표 모니터링
Amazon CloudWatch 지표를 사용하여 성능을 추적하고, 이상을 감지하고, 테이블의 운영 상태를 모니터링할 수 있습니다. S3 Tables와 함께 사용할 수 있는 몇 가지 CloudWatch지표 세트가 있습니다.
**테이블 및 테이블 버킷의 일별 스토리지 지표**
총 바이트 크기 및 파일 수를 포함하여 테이블 및 테이블 버킷에 저장된 데이터의 양을 모니터링합니다. 이러한 지표는 테이블 버킷, 테이블 및 네임스페이스 수준에서 액세스 계층당 총 스토리지 바이트 수와 파일 수를 추적합니다. S3 Tables 스토리지 지표는 하루에 한 번 보고되고 추가 비용 없이 모든 고객에게 제공됩니다.
**테이블 유지 관리 지표**
압축과 같이 Amazon S3가 테이블에서 수행하는 자동 유지 관리 작업을 모니터링합니다. 이러한 지표는 유지 관리 활동 중에 처리된 바이트 및 파일 수를 추적합니다. S3 Tables 유지 관리 지표는 하루에 한 번 보고되고 추가 비용 없이 모든 고객에게 제공됩니다.
**요청 지표**
S3 Tables 요청을 모니터링하여 운영 문제를 신속하게 식별하고 조치합니다. 이러한 CloudWatch 지표는 개별 테이블 버킷에 대해 선택적으로 활성화할 수 있습니다. S3 Tables에 대한 요청 지표는 1분마다 보고되고 CloudWatch 사용자 지정 지표와 동일한 요금으로 청구됩니다. 요청 지표에는 다음이 포함됩니다.
+ 데이터 플레인 작업 수(GET, PUT, HEAD, POST)
+ 전송된 바이트
+ 지연 시간 측정
+ 오류율
**참고**
**CloudWatch 지표 전송은 보장되지 않음**
CloudWatch 지표를 전송하고자 최선을 다할 것입니다. 요청 지표가 있는 Amazon S3 객체에 대한 요청은 대개 CloudWatch로 데이터 요소를 전송하게 됩니다.
모든 지표가 제때 전송될 것이라고 보장할 수는 없습니다. 특정 요청에 대한 데이터 요소는 그 요청이 실제로 처리되었을 때보다 더 늦은 타임스탬프와 함께 반환될 수도 있습니다. 어떤 시점의 데이터 요소는 CloudWatch를 통해 제공되기 전에 지연될 수도 있으며 어떤 경우에는 아예 전송되지 않을 수도 있습니다. CloudWatch 요청 지표는 버킷에 대한 트래픽의 특성을 거의 실시간으로 파악할 수 있도록 합니다. 모든 요청의 완벽한 기록을 제공할 목적으로 개발된 것이 아닙니다. 완벽한 전송을 보장할 수 없는 그 특성에 따라 결제 및 비용 관리 대시보드에 제공되는 보고서에는 버킷 지표에 나타나지 않는 액세스 요청이 하나 이상 포함될 수 있습니다.
# 지표 및 차원
다음 테이블에는 S3 Tables에서 Amazon CloudWatch로 전송하는 스토리지 지표와 차원이 나열되어 있습니다.
**참고**
**CloudWatch 지표 전송은 보장되지 않음**
CloudWatch 지표를 전송하고자 최선을 다할 것입니다. 요청 지표가 있는 Amazon S3 객체에 대한 요청은 대개 CloudWatch로 데이터 요소를 전송하게 됩니다.
모든 지표가 제때 전송될 것이라고 보장할 수는 없습니다. 특정 요청에 대한 데이터 요소는 그 요청이 실제로 처리되었을 때보다 더 늦은 타임스탬프와 함께 반환될 수도 있습니다. 어떤 시점의 데이터 요소는 CloudWatch를 통해 제공되기 전에 지연될 수도 있으며 어떤 경우에는 아예 전송되지 않을 수도 있습니다. CloudWatch 요청 지표는 버킷에 대한 트래픽의 특성을 거의 실시간으로 파악할 수 있도록 합니다. 모든 요청의 완벽한 기록을 제공할 목적으로 개발된 것이 아닙니다. 완벽한 전송을 보장할 수 없는 그 특성에 따라 결제 및 비용 관리 대시보드에 제공되는 보고서에는 버킷 지표에 나타나지 않는 액세스 요청이 하나 이상 포함될 수 있습니다.
## CloudWatch의 테이블 버킷에 대한 일별 스토리지 지표
`AWS/S3/Tables` 네임스페이스에는 추가 비용 없이 항상 사용할 수 있는 다음과 같은 일별 스토리지 지표가 포함되어 있습니다. 테이블 버킷, 테이블 또는 네임스페이스 이름을 기준으로 이러한 지표를 필터링할 수 있습니다.
**일별 스토리지 지표**
| 지표 이름 | 설명 | 단위 | 통계 | Granularity |
| --- | --- | --- | --- | --- |
| 총 버킷 스토리지 | 테이블 버킷의 모든 테이블에서 사용하는 바이트 단위의 스토리지 양 | 바이트 | Sum | 일별 |
| 총 파일 수 | 테이블 버킷에 저장된 모든 파일의 총 수 | 개수 | 합계 | 일별 |
## 테이블 유지 관리 지표
`AWS/S3/Tables` 네임스페이스에는 추가 비용 없이 사용할 수 있는 다음 테이블 유지 관리 지표가 포함되어 있습니다. 테이블 버킷, 테이블 또는 네임스페이스 이름을 기준으로 이러한 지표를 필터링할 수 있습니다.
**테이블 유지 관리 지표**
| 지표 이름 | 설명 | 단위 | 통계 | Granularity |
| --- | --- | --- | --- | --- |
| CompactionBytesProcessed | 테이블 압축 작업 중에 처리된 바이트 수 | 바이트 | Sum | 일별 |
| CompactionObjectsCount | 테이블 압축 작업 중에 처리된 객체 수 | 개수 | 합계 | 일별 |
## CloudWatch의 테이블 및 테이블 버킷에 대한 요청 지표
`AWS/S3/Tables` 네임스페이스에는 CloudWatch 사용자 지정 지표와 동일한 요금으로 청구되는 다음과 같은 요청 지표가 포함됩니다. 테이블 버킷, 테이블 또는 네임스페이스 이름을 기준으로 이러한 지표를 필터링할 수 있습니다.
**요청 지표**
| 지표 이름 | 설명 | 단위 | 통계 | Granularity |
| --- | --- | --- | --- | --- |
| 모든 요청 수 | 테이블 버킷에 대해 실행된 HTTP 요청의 총 수 | 개수 | 합계 | 1분 |
| Get 요청 수 | 테이블에서 객체를 검색하기 위해 실행된 HTTP GET 요청 수 | 개수 | 합계 | 1분 |
| Put 요청 수 | 테이블에 객체를 추가하기 위해 실행된 HTTP PUT 요청 수 | 개수 | 합계 | 1분 |
| Head 요청 수 | 테이블에서 메타데이터를 검색하기 위해 실행된 HTTP HEAD 요청 수 | 개수 | 합계 | 1분 |
| Post 요청 수 | 테이블에 실행된 HTTP POST 요청 수 | 개수 | 합계 | 1분 |
| UpdateTableMetadataLocation 요청 수 | 테이블 메타데이터 위치를 업데이트하기 위해 실행된 요청 수 | 개수 | 합계 | 1분 |
| GetTableMetadataLocation 요청 수 | 테이블 메타데이터 위치를 검색하기 위해 실행된 요청 수 | 개수 | 합계 | 1분 |
| BytesDownloaded | 테이블 요청을 위해 다운로드한 바이트 수 | 바이트 | Sum | 1분 |
| BytesUploaded | 테이블 요청을 위해 업로드한 바이트 수 | 바이트 | Sum | 1분 |
| 4xxErrors | 반환된 HTTP 4xx 클라이언트 오류 상태 코드 수 | 개수 | 합계 | 1분 |
| 5xxErrors | 반환된 HTTP 5xx 서버 오류 상태 코드 수 | 개수 | 합계 | 1분 |
| FirstByteLatency | 전체 요청을 수신한 때부터 응답이 반환되기 시작하는 때까지의 요청당 시간 | 밀리초 | Sum | 1분 |
| TotalRequestLatency | 최초 수신된 바이트부터 전송된 마지막 바이트까지의 요청당 경과 시간 | 밀리초 | Sum | 1분 |
## CloudWatch의 S3 Tables 차원
다음 차원은 S3 Tables 지표 필터링에 사용됩니다.
**S3 Tables 차원**
| 차원 이름 | 설명 | 예제 값 |
| --- | --- | --- |
| TableBucketName | Amazon S3 Tables 버킷 이름 | my-table-bucket |
| Namespace | 하나 이상의 테이블이 포함된 테이블 버킷 내 네임스페이스 | my-department |
| TableName | 네임스페이스 내 특정 테이블의 이름 | transactions |
# CloudWatch 지표 액세스
CloudWatch 콘솔, AWS CLI 또는 CloudWatch API를 사용하여 S3 Tables 지표를 모니터링할 수 있습니다. 이 섹션에서는 이러한 다양한 방법을 사용하여 지표에 액세스하는 방법을 설명합니다.
## S3 콘솔 사용
1. AWS Management Console에 로그인하고 [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 Tables에 대한 지표를 나열하려면 `--namespace` 파라미터가 `AWS/S3/Tables`로 설정된 `list-metrics` 명령을 사용합니다.
```
aws cloudwatch list-metrics --namespace AWS/S3/Tables
```
특정 S3 Tables 지표에 대한 통계를 가져오려면 `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
```
## 모범 사례
+ 지표를 검색할 때 지표의 세부 수준을 기반으로 기간 값을 설정합니다. 일별 지표(예: 스토리지 지표)의 경우 86,400초(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 Tables 및 테이블 버킷에 대해 활성화됩니다. 콘솔, AWS Command Line Interface(AWS CLI) 또는 AWS SDK를 통해 추가 요청 지표를 활성화하거나 비활성화할 수 있습니다.
## 사전 조건
+ `s3table:PutTableBucketMetricsConfiguration` IAM 권한 필요
**참고**
S3 Tables 요청 지표는 CloudWatch 사용자 지정 지표와 동일한 요금으로 청구됩니다.
## AWS 관리 콘솔에서 사용
추가 지표를 활성화 또는 비활성화하는 방법
1. AWS Management Console에 로그인하고 [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
```