모니터링되는 태그 키 관리

Amazon EC2 Capacity Manager를 사용하면 Amazon EC2 리소스(예: environment 또는 team)에서 용량 데이터를 분석할 때 차원으로 사용할 태그 키를 선택할 수 있습니다. 태그 키가 활성화되면 리전, 인스턴스 유형 또는 가용 영역에서와 마찬가지로 해당 태그의 값을 기준으로 지표를 그룹화 및 필터링할 수 있습니다.

각 계정에서 최대 5개의 태그 키를 모니터링할 수 있습니다. Capacity Manager 제공 태그는 이 제한에 포함되지 않습니다.

Capacity Manager 제공 태그

Capacity Manager에는 모든 계정에 대한 기본 태그 세트가 포함되어 있습니다. 이는 태그 키 제한에 포함되지 않습니다. Capacity Manager 제공 태그는 일반적으로 사용되는 그룹화 차원을 나타내며, 여기에는 다음이 포함됩니다.

Capacity Manager 제공 태그는 CapacityManagerProvided가 true로 설정된 GetCapacityManagerMonitoredTagKeys로 표시되며, 고객이 이를 활성화하거나 비활성화할 수 없습니다. Capacity Manager가 처음 활성화된 경우 Capacity Manager 제공 태그는 activating 상태로 시작되고 Capacity Manager가 Capacity Manager 제공 태그를 포함하는 첫 번째 데이터 포인트를 수신한 후 일반적으로 1~2시간 이내에 activated 상태로 전환됩니다.

태그 수명 주기

모니터링되는 태그 키는 다음 상태를 거치며 진행됩니다.

태그가 suspended 상태인 경우 GetCapacityManagerMonitoredTagKeys는 다음과 같은 상태 메시지를 반환합니다. "태그 값이 너무 많아 태그가 일시 중지되었습니다. 태그 사용을 줄이거나 비활성화하세요."

모니터링되는 태그 키 활성화 및 비활성화

태그 키를 활성화하여 차원으로 모니터링을 시작하거나 더 이상 필요하지 않은 태그 키를 비활성화할 수 있습니다. 활성화는 비동기식입니다. 태그는 activating 상태가 되고 Capacity Manager가 해당 태그에 대한 데이터 수신을 시작한 후에는 activated 상태로 전환됩니다. 비활성화하면 모니터링되는 세트에서 태그 키가 제거됩니다.

Console

모니터링되는 태그 키를 활성화 또는 비활성화하는 방법

1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

2. 탐색 창에서 용량 관리자를 선택합니다.

3. 설정 탭을 선택합니다.

4. 모니터링되는 태그 키 섹션에서 태그 키 관리를 선택하세요.

5. 태그 키를 활성화하려면 태그 키 이름을 입력하고 추가를 선택하세요. 태그 키를 비활성화하려면 태그 키를 선택하고 제거를 선택하세요.

6. 변경 사항 저장을 선택합니다.

AWS CLI

태그 키를 활성화하는 방법

다음 명령을 사용하여 하나 이상의 태그 키를 활성화하세요.

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId"
                

출력에는 다음과 같이 태그 키 및 해당 초기 상태가 표시됩니다.

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "environment",
            "Status": "activating"
        },
        {
            "TagKey": "teamId",
            "Status": "activating"
        }
    ]
}

태그 키를 비활성화하는 방법

다음 명령을 사용하여 하나 이상의 태그 키를 비활성화하세요.

aws ec2 update-capacity-manager-monitored-tag-keys \
    --deactivate-tag-keys "project"
                

출력에는 다음과 같이 업데이트된 상태가 표시됩니다.

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "project",
            "Status": "deactivating"
        }
    ]
}

동일한 요청에서 태그 키를 활성화 및 비활성화할 수 있습니다.

aws ec2 update-capacity-manager-monitored-tag-keys \
    --activate-tag-keys "environment" "teamId" \
    --deactivate-tag-keys "project"
                

모니터링되는 태그 키 보기

현재 상태 및 데이터를 사용할 수 있는 가장 빠른 타임스탬프를 포함하여 계정에 대해 모니터링되는 모든 태그 키를 볼 수 있습니다.

Console

모니터링되는 태그 키를 보는 방법

1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

2. 탐색 창에서 용량 관리자를 선택합니다.

3. 설정 탭을 선택합니다.

4. 모니터링된 태그 키 섹션에서 태그 키, 해당 상태 및 Capacity Manager 제공 태그인지를 확인하세요.

AWS CLI

모니터링되는 태그 키를 보는 방법

다음 명령을 실행합니다.

aws ec2 get-capacity-manager-monitored-tag-keys
                

출력에는 Capacity Manager 제공 태그 및 고객 관리형 태그를 포함한 모든 태그 키가 나열됩니다.

{
    "CapacityManagerTagKeys": [
        {
            "TagKey": "aws:autoscaling:groupName",
            "Status": "activated",
            "CapacityManagerProvided": true,
            "earliestDatapointTimestamp": "2026-04-08T00:00:00"
        },
        {
            "TagKey": "environment",
            "Status": "activated",
            "CapacityManagerProvided": false,
            "earliestDatapointTimestamp": "2025-08-11T22:00:00"
        }
    ]
}

CapacityManagerProvided 필드는 태그가 Capacity Manager 제공 태그(true)인지 고객 관리형 태그(false)인지를 나타냅니다. Capacity Manager 제공 태그는 태그 키 제한에 포함되지 않습니다. EarliestDatapointTimestamp는 해당 태그 키에 대해 데이터를 사용할 수 있는 가장 빠른 시점을 나타냅니다.

태그 차원을 사용하여 지표 쿼리

태그 키가 activated 상태에 도달하면 GetCapacityManagerMetricDimensions 및 GetCapacityManagerMetricData에서 차원으로 사용할 수 있습니다.

태그 차원별로 그룹화된 지표를 쿼리하는 방법

다음 명령을 사용합니다.

aws ec2 get-capacity-manager-metric-dimensions \
    --group-by tag:environment account-id \
    --filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[prod]}'
          

태그 차원별로 그룹화하면 태그가 있는 리소스뿐만 아니라 계정의 모든 리소스가 결과에 포함됩니다. 태그에 대한 값이 없는 리소스는 문자열 값이 비어 있는 별도의 버킷으로 그룹화됩니다. 예를 들어 계정에서 지정된 기간에 800 vCPU 시간을 사용했고 이러한 리소스 중 일부에만 environment 태그가 있는 경우 environment 태그 키별로 그룹화하면 다음이 반환될 수 있습니다.

그러면 모든 버킷의 합계에서 전체 사용량을 고려합니다. 빈 문자열을 필터 값으로 전달하여 태그가 지정되지 않은 리소스를 명시적으로 필터링할 수 있습니다.

--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
          

데이터 내보내기의 태그

태그 모니터링을 활성화하면 데이터 내보내기에 활성화된 태그 키 및 Capacity Manager 제공 태그가 추가 열로 포함됩니다. 태그 열은 tag:environment 및 tag:team과 같은 헤더가 있는 모든 표준 열 뒤에 나타납니다. 태그 열은 사전순으로 정렬됩니다.

내보내기에는 activated 상태의 태그만 포함됩니다. Capacity Manager는 activating, deactivating 또는 suspended 상태의 태그를 제외합니다.

조직 및 위임된 관리자

계정이 조직 수준 Capacity Manager가 활성화된 AWS 조직의 일부인 경우 각 계정(조직 관리자 및 위임된 관리자)은 독립적으로 태그 키를 활성화, 비활성화 및 쿼리할 수 있습니다. 각 계정에서는 자체 태그 상태, EarliestDatapointTimestamp 및 태그 키 제한을 유지 관리합니다.

계정은 계정 자체에서 활성화한 태그 키에 대해서만 지표 데이터를 쿼리할 수 있습니다. 조직 관리자와 위임된 관리자가 모두 동일한 태그 키(예: environment)를 활성화하는 경우 각 계정에서는 자체 활성화 상태 및 데이터 가용성을 독립적으로 추적합니다.

위임된 관리자가 태그 키를 비활성화하는 경우 조직 관리자가 여전히 동일한 태그 키를 활성화했더라도 위임된 관리자는 더 이상 해당 태그에 대한 데이터를 쿼리할 수 없습니다.

고려 사항