AWS DynamoDB¶
AWS DynamoDB의 표시 메트릭에는 처리량 용량 단위, 지연 시간, 동시 연결 수 및 읽기/쓰기 처리량 등이 포함되며, DynamoDB 의 대규모 데이터 저장 및 접근 성능과 확장성을 보여 줍니다.
설정¶
Func 설치¶
Guance 통합 - 확장 - 호스팅 Func를 활성화하는 것을 권장합니다. 모든 사전 요구 사항이 자동으로 설치되므로 스크립트 설치를 진행하세요.
Func를 직접 배포하려면 자체 호스팅 Func를 참조하세요.
스크립트 설치¶
안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 주세요. (간단히 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
호스팅 버전 스크립트 활성화¶
- Guance 콘솔에 로그인합니다
- [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 설정되어 있다면 이 단계를 건너뜁니다
- [테스트]를 클릭하고, 테스트에 성공하면 [저장]을 클릭합니다. 테스트에 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
- [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 이동합니다
- 클라우드 계정 상세 페이지에서 [통합]을 클릭하고
미설치목록에서 다음을 찾으세요:AWS DynamoDB. [설치]를 클릭하고 표시된 화면에서 설치를 완료하세요.
수동 스크립트 활성화¶
-
Func 콘솔에 로그인하고 [스크립트 마켓]을 클릭하여Guance스크립트 마켓에서 검색하세요::
integration_aws_dynamodb -
[설치]를 클릭한 뒤 다음 파라미터를 입력합니다. AWS AK ID, AK Secret, 계정명.
-
[시작 스크립트 배포]를 클릭하면 시스템이
Startup스크립트 집합을 만들고 해당 시작 스크립트를 자동으로 설정합니다。 -
활성화 후 관리 / 자동 트리거 설정에서 해당 설정을 확인합니다. [실행]을 클릭하면 예약 시간을 기다리지 않고 즉시 실행할 수 있습니다. 잠시 후 실행 기록과 로그를 확인할 수 있습니다。
검증¶
- [관리 / 자동 트리거 구성]에서 해당 작업의 자동 트리거 구성이 있는지 확인하고 작업 기록과 로그에서 이상 여부를 점검합니다.
- Guance의 [인프라 / 사용자 정의]에서 자산 정보가 있는지 확인합니다.
- Guance의 [메트릭]에서 해당 모니터링 데이터가 있는지 확인합니다.
메트릭¶
Amazon 클라우드 모니터링을 설정하면 다음 메트릭이 기본 수집됩니다. 설정을 통해 추가 메트릭을 수집할 수 있습니다. Amazon 클라우드 모니터링 메트릭 상세
ConditionalCheckFailedRequests¶
조건부 쓰기 시도 실패 횟수입니다.
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
| ConditionalCheckFailedRequests_Average | 실패한 요청 수 평균 | Count | TableName |
| ConditionalCheckFailedRequests_Maximum | 실패한 요청 수 최댓값 | Count | TableName |
| ConditionalCheckFailedRequests_Minimum | 실패한 요청 수 최솟값 | Count | TableName |
| ConditionalCheckFailedRequests_SampleCount | 실패한 요청 수 | Count | TableName |
| ConditionalCheckFailedRequests_Sum | 실패한 요청 총수 | Count | TableName |
ConsumedReadCapacityUnits¶
지정 기간에 소비된 읽기 용량 단위 수로, 프로비저닝된 처리량 사용량을 추적할 수 있습니다.
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
| ConsumedReadCapacityUnits_Average | 요청당 평균 소비 읽기 용량 | Count | TableName |
| ConsumedReadCapacityUnits_Maximum | 테이블 또는 인덱스 요청에서 소비한 읽기 용량 단위 최댓값 | Count | TableName |
| ConsumedReadCapacityUnits_Minimum | 테이블 또는 인덱스 요청에서 소비한 읽기 용량 단위 최솟값 | Count | TableName |
| ConsumedReadCapacityUnits_SampleCount | 읽기 용량을 소비하지 않은 요청을 포함한 DynamoDB 읽기 요청 수 | Count | TableName |
| ConsumedReadCapacityUnits_Sum | 소비된 읽기 용량 단위 합계 | Count | TableName |
ConsumedWriteCapacityUnits¶
지정 기간에 소비된 쓰기 용량 단위 수로, 프로비저닝된 처리량 사용량을 추적할 수 있습니다.
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
| ConsumedWriteCapacityUnits_Average | 요청당 평균 소비 쓰기 용량 | Count | TableName |
| ConsumedWriteCapacityUnits_Maximum | 테이블 또는 인덱스 요청에서 소비한 쓰기 용량 단위 최댓값 | Count | TableName |
| ConsumedWriteCapacityUnits_Minimum | 테이블 또는 인덱스 요청에서 소비한 쓰기 용량 단위 최솟값 | Count | TableName |
| ConsumedWriteCapacityUnits_SampleCount | 읽기 용량을 소비하지 않은 요청을 포함한 DynamoDB 쓰기 요청 수 | Count | TableName |
| ConsumedWriteCapacityUnits_Sum | 소비된 쓰기 용량 단위 합계 | Count | TableName |
ProvisionedReadCapacityUnits¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
ProvisionedReadCapacityUnits_Average |
테이블 또는 글로벌 보조 인덱스의 평균 프로비저닝된 읽기 용량입니다. | Count | TableName;인덱스에는 추가로 포함: GlobalSecondaryIndexName |
ProvisionedWriteCapacityUnits¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
ProvisionedWriteCapacityUnits_Average |
테이블 또는 글로벌 보조 인덱스의 평균 프로비저닝된 쓰기 용량입니다. | Count | TableName;인덱스에는 추가로 포함: GlobalSecondaryIndexName |
ReadThrottleEvents¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
ReadThrottleEvents_Sum |
프로비저닝된 용량 초과로 제한된 읽기 이벤트 수입니다. | Count | TableName;인덱스에는 추가로 포함: GlobalSecondaryIndexName |
SuccessfulRequestLatency¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
SuccessfulRequestLatency_Average |
성공한 요청의 평균 서버 처리 시간으로 네트워크 및 클라이언트 시간은 제외합니다. | ms | TableName, Operation;스트림 요청에는 추가로 포함: StreamLabel |
ThrottledRequests¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
ThrottledRequests_Sum |
처리량 제한 초과로 제한된 요청 수입니다. | Count | TableName, Operation |
UserErrors¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
UserErrors_Sum |
현재 계정 및 리전의 HTTP 400 오류 수로, 처리량 초과와 조건 검사 실패는 제외합니다. | Count | - |
WriteThrottleEvents¶
| 메트릭이름 | 설명 | 단위 | 차원 |
|---|---|---|---|
WriteThrottleEvents_Sum |
프로비저닝된 용량 초과로 제한된 쓰기 이벤트 수입니다. | Count | TableName;인덱스에는 추가로 포함: GlobalSecondaryIndexName |
객체¶
수집된 AWS DynamoDB 객체 구조입니다. 인프라 / 사용자 정의에서 객체 데이터를 확인할 수 있습니다.
{
"measurement": "aws_dynamodb",
"tags": {
"RegionId" : "cn-north-1",
"TableArn" : "arn:aws-cn:dynamodb:cn-north-1:",
"TableId" : "0ce8d4f9b35",
"TableName" : "eks-tflock",
"TableStatus" : "ACTIVE",
"name" : "eks-tflock"
},
"fields": {
"AttributeDefinitions" : "[{\"AttributeName\": \"LockID\", \"AttributeType\": \"S\"}]",
"BillingModeSummary" : "{}",
"CreationDateTime" : "2023-03-22T23:39:42.352000+08:00",
"ItemCount" : "1",
"KeySchema" : "[{\"AttributeName\": \"LockID\", \"KeyType\": \"HASH\"}]",
"LocalSecondaryIndexes" : "{}",
"TableSizeBytes" : "96",
"message" : "{인스턴스 json 정보}"
}
}
주의:
tags와fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다안내 1:
tags.name값은 인스턴스 ID이며, 고유 식별자로 사용됩니다안내 2:
fields.message,fields.Endpoint는 모두 JSON 직렬화 후의 문자열입니다