Contributor Insights 모드 선택 Contributor Insights 사용(콘솔)Contributor Insights(AWS CLI) 사용

DynamoDB용 CloudWatch Contributor Insights 사용 시작

이 섹션에서는 Amazon DynamoDB 콘솔 또는 AWS Command Line Interface(AWS CLI)를 통해 Amazon CloudWatch Contributor Insights를 다양한 모드로 활성화하고 활용하여 모니터링 요구 사항을 충족하는 방법을 설명합니다.

다음 예에서는 DynamoDB 시작하기 자습서에서 정의한 DynamoDB 테이블을 사용합니다.

Contributor Insights 모드 선택

Contributor Insights를 활성화하기 전에 사용 가능한 두 가지 모드를 이해해야 합니다. 모드 비교를 검토하여 특정 요구 사항에 가장 부합하는 옵션을 선택하세요.

속성	액세스된 키 및 스로틀된 키 모드	스로틀된 키 모드
모니터	모든 요청(성공한 요청 및 스로틀된 요청)	스로틀된 요청만
그래프	가장 많이 액세스한 항목 및 가장 많이 조절된 항목	가장 많이 조절된 항목만
최적의 용도	대상 분석 및 최적화	스로틀링 모니터링
사용 상황	액세스 패턴에 대한 완전한 가시성이 필요합니다. 단기 분석이나 디버깅을 수행하고 있습니다.	주요 관심사가 스로틀링 문제를 식별하고 해결하는 것입니다. 실시간 스로틀링 알림을 위해 Contributor Insights를 지속적으로 활성화하려고 합니다.

Contributor Insights 사용(콘솔)

콘솔은 Contributor Insights를 활성화하고 모니터링 요구 사항에 적합한 모드를 선택할 수 있는 직관적인 방법을 제공합니다.

콘솔에서 Contributor Insights를 사용하려면

AWS Management Console에 로그인하고 https://console.aws.amazon.com/vpc/에서 DynamoDB 콘솔을 엽니다.
콘솔 왼쪽의 탐색 창에서 테이블(Tables)을 선택합니다.
Music 테이블을 선택합니다.
모니터링 탭을 선택합니다.
CloudWatch Contributor Insights 켜기를 선택합니다.
CloudWatch Contributor Insights 설정 관리 대화 상자에서 Music 기본 테이블과 AlbumTitle-index 글로벌 보조 인덱스 모두에 대해 켜기를 전환합니다.
스로틀된 키 전용 모드 토글을 둘 다 끄기 위치로 전환한 다음 변경 사항 저장을 선택합니다.

이렇게 하면 테이블과 GSI 모두에 대해 기본 액세스된 키 및 스로틀된 키 모드를 활성화하여, 액세스한 항목과 조절된 항목 모두를 모니터링할 수 있습니다. 스로틀된 키 전용 모드 토글을 켜기 위치로 전환하면 스로틀된 키 모드가 활성화됩니다.

작업이 실패할 경우 Amazon DynamoDB API 참조의 DescribeContributorInsights FailureException에서 가능한 이유을 확인하세요.
이제 CloudWatch Contributor Insights 그래프가 Music 테이블의 모니터 탭에 표시됩니다. 액세스된 키 및 스로틀된 키 모드를 활성화했으므로 액세스한 항목과 조절된 항목 그래프가 모두 표시됩니다.

모드 간 전환

Contributor Insights를 비활성화하지 않고 언제든지 모드 간에 전환할 수 있습니다.

Contributor Insights 모드를 전환하려면

테이블의 모니터 탭에서 CloudWatch Contributor Insights 관리를 선택합니다.
Contributor Insights 설정 관리 대화 상자에서 각 기본 테이블 또는 GSI에 대해 다음과 같이 설정합니다.
- 스로틀된 키 전용 모드를 켜기 또는 끄기로 전환하여 스로틀된 키 모드를 활성화하거나 기본 모드인 액세스된 키 및 스로틀된 키로 돌아갑니다.
- 테이블 또는 GSI에 대해 CloudWatch Contributor Insight를 비활성화하려면 켜기를 끄기로 전환합니다.
변경 사항 저장을 선택합니다.

완료되면 그래프에 새 모드가 반영됩니다.

CloudWatch 경보 생성

CloudWatch 경보를 생성하고 파티션 키가 50,000개 이상의 ConsumedThroughputUnits를 소비하거나 스로틀링을 경험하는 경우에 알림을 받으려면 다음 단계를 따르세요.

AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.
콘솔 왼쪽의 탐색 창에서 Contributor Insights를 선택합니다.
다음과 같이 모드와 모니터링하려는 항목에 따라 적절한 규칙을 선택합니다.
- 액세스한 항목 모니터링(액세스 및 제한된 키 모드만 해당): DynamoDBContributorInsights-PKC-Music을 선택합니다.
- 조절된 항목 모니터링(두 모드 모두): DynamoDBContributorInsights-PKT-Music을 선택합니다.
작업 드롭다운 메뉴를 선택합니다.
지표에서 보기를 선택합니다.
최대 기고자 값을 선택합니다.

참고
Max Contributor Value 및 Maximum만 유용한 통계를 반환합니다. 이 목록에 있는 다른 통계는 의미 있는 값을 반환하지 않습니다.
작업 열에서 경보 생성을 선택합니다.
적절한 임계값을 입력하고 다음을 선택합니다.
- 액세스한 항목(PKC 규칙): ConsumedThroughputUnits에 50000을 입력합니다.
- 조절된 항목(PKT 규칙): 스로틀링 발생 시 알림을 받으려면 ThrottleCount에 1을 입력합니다.
경보에 대한 알림을 구성하는 방법에 대한 자세한 내용은 Amazon CloudWatch 경보 사용을 참조하세요.

Contributor Insights(AWS CLI) 사용

AWS CLI는 두 모드 모두를 완벽하게 지원하며 Contributor Insights에 대한 프로그래밍 방식 액세스를 제공합니다. Contributor Insights를 활성화할 때 모드를 지정하거나 나중에 모드를 전환할 수 있습니다.

기본 모드를 사용한 기본 작업

Contributor Insights를 기본 설정으로 사용하려면

Music 기본 테이블에서 CloudWatch Contributor Insights for DynamoDB를 액세스된 키 및 스로틀된 키 모드로 활성화합니다. ACCESSED_AND_THROTTLED_KEYS가 기본 모드이므로 --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS 파라미터는 생략할 수 있습니다.
```
aws dynamodb update-contributor-insights \
                    --table-name Music \
                    --contributor-insights-action=ENABLE
```

AlbumTitle-index 글로벌 보조 인덱스에 있는 DynamoDB에 대한 Contributor Insights를 활성화합니다.


aws dynamodb update-contributor-insights \
                    --table-name Music \
                    --index-name AlbumTitle-index \
                    --contributor-insights-action=ENABLE

Music 테이블과 모든 인덱스에 대한 상태와 규칙을 확인합니다.
```
aws dynamodb describe-contributor-insights 
                    --table-name Music
```
응답에는 ACCESSED_AND_THROTTLED_KEYS가 표시된 ContributorInsightsMode 필드가 포함됩니다.
Music 테이블과 모든 인덱스에 대한 상태를 나열합니다.
```
aws dynamodb list-contributor-insights --table-name Music
```

스로틀된 키 모드 활성화

스로틀된 키 모드로 Contributor Insights를 활성화하려면

Music 기본 테이블에서 CloudWatch Contributor Insights for DynamoDB를 스로틀된 키 모드로 활성화합니다.


aws dynamodb update-contributor-insights \
    --table-name Music \
    --contributor-insights-action=ENABLE \
    --contributor-insights-mode=THROTTLED_KEYS

AlbumTitle-index 글로벌 보조 인덱스에 대해 스로틀된 키 모드로 Contributor Insights를 활성화합니다.


aws dynamodb update-contributor-insights \
    --table-name Music \
    --index-name AlbumTitle-index \
    --contributor-insights-action=ENABLE \
    --contributor-insights-mode=THROTTLED_KEYS

Contributor Insights 구성을 설명하여 모드를 확인합니다.
```
aws dynamodb describe-contributor-insights --table-name Music
```
응답에는 ContributorInsightsMode가 THROTTLED_KEYS로 표시되며 기본 모드에 비해 규칙 수가 줄어듭니다.

모드 간 전환

Contributor Insights 모드를 전환하려면

스로틀된 키 모드에서 액세스한 키 및 스로틀된 키 모드로 전환합니다.


aws dynamodb update-contributor-insights \
    --table-name Music \
    --contributor-insights-action=ENABLE \
    --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS

액세스한 키 및 스로틀된 키 모드에서 스로틀된 키 모드로 전환합니다.


aws dynamodb update-contributor-insights \
    --table-name Music \
    --contributor-insights-action=ENABLE \
    --contributor-insights-mode=THROTTLED_KEYS

전환 중에 상태를 확인합니다.
```
aws dynamodb describe-contributor-insights --table-name Music
```
모드 전환 중에는 ContributorInsightsStatus가 ENABLING으로 표시됩니다. 완료되면 새 모드가 ENABLED으로 표시됩니다.

Contributor Insights 관리

Contributor Insights 설정을 관리하려면

AlbumTitle-index 글로벌 보조 인덱스에 있는 CloudWatch Contributor Insights for DynamoDB를 비활성화합니다.


aws dynamodb update-contributor-insights \
                    --table-name Music --index-name AlbumTitle-index \
                    --contributor-insights-action=DISABLE

계정 내 모든 Contributor Insights 구성을 나열합니다.
```
aws dynamodb list-contributor-insights
```
여기에는 Contributor Insights가 활성화된 모든 테이블과 인덱스가 해당 모드와 함께 표시됩니다.

특정 구성에 대한 자세한 정보를 확인합니다.


aws dynamodb describe-contributor-insights \
                    --table-name Music \
                    --index-name AlbumTitle-index

예제 응답

다음은 모드 간 차이를 보여주는 예제 응답입니다.

액세스된 키 및 스로틀된 키 모드 응답


{
    "TableName": "Music",
    "ContributorInsightsRuleList": [
        "DynamoDBContributorInsights-PKC-Music-1234567890123",
        "DynamoDBContributorInsights-PKT-Music-1234567890123",
        "DynamoDBContributorInsights-SKC-Music-1234567890123",
        "DynamoDBContributorInsights-SKT-Music-1234567890123"
    ],
    "ContributorInsightsStatus": "ENABLED",
    "ContributorInsightsMode": "ACCESSED_AND_THROTTLED_KEYS",
    "LastUpdateDateTime": "2024-01-15T10:30:00.000Z"
}

스로틀된 키 모드 응답


{
    "TableName": "Music",
    "ContributorInsightsRuleList": [
        "DynamoDBContributorInsights-PKT-Music-1234567890123",
        "DynamoDBContributorInsights-SKT-Music-1234567890123"
    ],
    "ContributorInsightsStatus": "ENABLED",
    "ContributorInsightsMode": "THROTTLED_KEYS",
    "LastUpdateDateTime": "2024-01-15T10:35:00.000Z"
}

스로틀된 키 모드에는 규칙이 더 적으며(PKT 및 SKT만 해당), 이는 보다 집중적인 모니터링에 부합합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

작동 방법

IAM 사용

DynamoDB용 CloudWatch Contributor Insights 사용 시작

주제

Contributor Insights 모드 선택

Contributor Insights 사용(콘솔)

콘솔에서 Contributor Insights를 사용하려면

모드 간 전환

Contributor Insights 모드를 전환하려면

CloudWatch 경보 생성

참고

Contributor Insights(AWS CLI) 사용

기본 모드를 사용한 기본 작업

Contributor Insights를 기본 설정으로 사용하려면

스로틀된 키 모드 활성화

스로틀된 키 모드로 Contributor Insights를 활성화하려면

모드 간 전환

Contributor Insights 모드를 전환하려면

Contributor Insights 관리

Contributor Insights 설정을 관리하려면

예제 응답

액세스된 키 및 스로틀된 키 모드 응답

스로틀된 키 모드 응답