モニタリングされているタグキーの管理

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. Amazon EC2 コンソールの https://console.aws.amazon.com/ec2/ を開いてください。

2. ナビゲーションペインで [Capacity Manager] を選択します。

3. [設定] タブを選択します。

4. [モニタリングされているタグキー] セクションで、[タグキーを管理] を選択します。

5. タグキーをアクティブ化するには、タグキー名を入力し、[追加] を選択します。タグキーを非アクティブ化するには、タグキーを選択し、[削除] を選択します。

6. [Save changes] (変更の保存) をクリックします。

AWS CLI

タグキーをアクティブ化するには

次のコマンドを使用して、1 つまたは複数のタグキーをアクティブ化します。

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

出力には、タグキーとその初期ステータスが表示されます:

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

タグキーを非アクティブ化するには

次のコマンドを使用して、1 つまたは複数のタグキーを非アクティブ化します。

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. Amazon EC2 コンソールの https://console.aws.amazon.com/ec2/ を開いてください。

2. ナビゲーションペインで [Capacity Manager] を選択します。

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 など) をアクティブ化すると、各アカウントは独自のアクティブ化ステータスとデータの可用性を個別に追跡します。

委任管理者がタグキーを非アクティブ化すると、組織管理者が同じタグキーをアクティブ化している場合でも、委任管理者はそのタグのデータをクエリできなくなります。

考慮事項