# モニタリングされているタグキーの管理
Amazon EC2 Capacity Manager では、Amazon EC2 リソース (`environment` や `team` など) からタグキーを選択して、キャパシティデータを分析するときにディメンションとして使用できます。タグキーがアクティブ化されたら、リージョン、インスタンスタイプ、またはアベイラビリティーゾーンで行えるのと同様に、そのタグの値でメトリクスをグループ化してフィルタリングできます。
各アカウントは、最大 5 つのタグキーをモニタリングできます。Capacity Manager が提供するタグは、この制限にはカウントされません。
**Topics**
+ [Capacity Manager 提供のタグ](#cm-provided-tags)
+ [タグのライフサイクル](#tag-lifecycle)
+ [モニタリングされているタグキーをアクティブ化または非アクティブ化する](#activate-deactivate-tag-keys)
+ [モニタリングされているタグキーを表示する](#view-monitored-tag-keys)
+ [タグディメンションを使用してメトリクスをクエリする](#query-metrics-tag-dimensions)
+ [データエクスポートのタグ](#tags-in-data-exports)
+ [組織および委任管理者](#tag-keys-organizations)
+ [考慮事項](#tag-keys-considerations)
## Capacity Manager 提供のタグ
Capacity Manager には、アカウントごとに一連のデフォルトタグが含まれています。これらはタグキーの制限にはカウントされません。Capacity Manager 提供のタグは、一般的に使用されるグループ化ディメンションを表し、以下が含まれます:
+ `aws:autoscaling:groupName` — EC2 Auto Scaling グループ
+ `aws:eks:cluster-name` — EKS クラスター名
+ `eks:kubernetes-node-pool-name` — EKS Kubernetes ノードプール
+ `karpenter.sh/nodepool` — Karpenter ノードプール
Capacity Manager 提供のタグは、`CapacityManagerProvided` が `true` に 設定されている状態で `GetCapacityManagerMonitoredTagKeys` に表示され、お客様が有効化または無効化することはできません。Capacity Manager が最初に有効になると、Capacity Manager 提供のタグは `activating` ステータスで始まり、Capacity Manager が Capacity Manager 提供のタグを含む最初のデータポイントを受け取った後、通常は 1～2 時間以内に `activated` に移行します。
## タグのライフサイクル
モニタリングされているタグキーは、次のステータスで進行します:
| ステータス | 説明 |
| --- | --- |
| activating | タグキーが登録されています。Capacity Manager は、このタグのデータを収集する準備をしています。このステータスのタグを使用してメトリクスをクエリすることはできません。 |
| activated | タグデータは取り込み中であり、メトリクス API およびデータエクスポートを介してクエリできます。 |
| suspended | タグキーが 100,000 個の一意のタグ値のしきい値を超えています。タグは引き続き制限にカウントされますが、Capacity Manager はそのタグのデータを取り込みません。タグ値の使用量が一定期間しきい値を下回ると、タグは自動的に再アクティブ化されます。 |
| deactivating | タグキーは削除中です。非アクティブ化が完了すると、GetCapacityManagerMonitoredTagKeys に表示されなくなります。 |
タグが `suspended` ステータスの場合、`GetCapacityManagerMonitoredTagKeys` は次のステータスメッセージを返します:「タグ値が多すぎるためタグが中断されました。タグの使用を減らすか、非アクティブ化してください。」
**注記**
タグキーを非アクティブ化し、後で同じキーを再アクティブ化した場合、再アクティブ化後に取り込まれたデータのみがクエリ可能です。前回のアクティブ化の履歴データにはアクセスできません。`EarliestDatapointTimestamp` は、新しいアクティブ化のたびにリセットされます。
## モニタリングされているタグキーをアクティブ化または非アクティブ化する
タグキーをアクティブ化してディメンションとしてモニタリングを開始するか、不要になったタグキーを非アクティブ化できます。アクティベーションが非同期です — そのため、タグは `activating` 状態になり、Capacity Manager がそのタグのデータを受け取り始めた後に `activated` に移行します。非アクティブ化すると、モニタリングされているセットからタグキーが削除されます。
**注記**
タグキーをアクティブ化するときは、キー名 (例: `environment`) のみを入力します。Capacity Manager は、それをグループ化およびフィルタリングするためのディメンションとして自動的に利用できるようにします。
------
#### [ Console ]
**モニタリングされているタグキーをアクティブ化または非アクティブ化するには**
1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。
1. ナビゲーションペインで **[Capacity Manager]** を選択します。
1. **[設定]** タブを選択します。
1. [**モニタリングされているタグキー**] セクションで、[**タグキーを管理**] を選択します。
1. タグキーをアクティブ化するには、タグキー名を入力し、[**追加**] を選択します。タグキーを非アクティブ化するには、タグキーを選択し、[**削除**] を選択します。
1. **[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/](https://console.aws.amazon.com/ec2/) を開いてください。
1. ナビゲーションペインで **[Capacity Manager]** を選択します。
1. **[設定]** タブを選択します。
1. [**モニタリングされているタグキー**] セクションで、タグキー、ステータス、およびそれらが 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` タグキーでグループ化すると以下が返される場合があります:
+ `prod` — 300 vCPU 時間
+ `staging` — 200 vCPU 時間
+ `""` (空の文字列) — `environment` タグのないリソースから 300 vCPU 時間
これにより、すべてのバケット全体で合計がフル使用量を占めるようになります。空の文字列をフィルター値として渡すことで、タグ付けされていないリソースを明示的にフィルタリングできます。
```
--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
```
**注記**
まだ `activating` ステータスのタグキーを使用してクエリを実行すると、クエリは 400 エラーで拒否されます。タグのステータスが `activated` に変わるのを待ってからクエリを実行します。`GetCapacityManagerMonitoredTagKeys` を使用してステータスを確認できます。
**注記**
指定されたタグディメンションの `EarliestDatapointTimestamp` より前の開始時刻のクエリは拒否されます。`GetCapacityManagerMonitoredTagKeys` を使用して、各タグでデータがいつ利用可能になったかを確認します。
## データエクスポートのタグ
タグモニタリングを有効にすると、データエクスポートには、アクティブ化されたタグキーと Capacity Manager 提供のタグが追加の列として含まれます。タグ列は、`tag:environment` や `tag:team` などのヘッダーを持つすべての標準列の後に表示されます。タグ列はアルファベット順にソートされます。
エクスポートには、`activated` ステータスのタグのみが含まれます。Capacity Manager は、`activating`、`deactivating`、または `suspended` ステータスのタグを除外します。
**注記**
新しいタグキーをアクティブ化した場合、既存のデータエクスポートには新しいタグが自動的に含まれることはありません。新しくアクティブ化されたタグキーを列として含めるには、新しいデータエクスポートを作成する必要があります。
## 組織および委任管理者
アカウントが組織レベルの Capacity Manager が有効になっている AWS 組織の一部である場合、各アカウント (組織管理者と委任管理者) はタグキーを個別にアクティブ化、非アクティブ化、およびクエリできます。各アカウントは、独自のタグステータス、`EarliestDatapointTimestamp`、およびタグキーの制限を維持します。
アカウントは、アカウント自体がアクティブ化したタグキーのメトリクスデータのみをクエリできます。組織管理者と委任管理者の両方が同じタグキー (`environment` など) をアクティブ化すると、各アカウントは独自のアクティブ化ステータスとデータの可用性を個別に追跡します。
委任管理者がタグキーを非アクティブ化すると、組織管理者が同じタグキーをアクティブ化している場合でも、委任管理者はそのタグのデータをクエリできなくなります。
## 考慮事項
+ **タグ値の更新:** 新しいリソースのタグ値と、既存のリソースに新しく適用されたタグは、数時間以内に利用可能になります。リソースの既存のタグの値を変更すると、更新された値が Capacity Manager に反映されるまでに最大 24 時間かかることがあります。
+ **アクティブ化時間:** タグキーをアクティブ化すると、タグが `activated` ステータスに移行し、データがクエリ可能になるまでに最大 24 時間かかることがあります。`EarliestDatapointTimestamp` は、タグがアクティブ化されたときではなく、データが利用可能になったときを表します。
+ **タグキーの制限:** 各アカウントは、最大 5 つのタグキーをモニタリングできます。Capacity Manager が提供するタグは、この制限にはカウントされません。
+ **タグキー文字の要件:** タグキーには、Unicode 文字、数字、空白、および次の文字を含めることができます: `_ . : / = + @ -`。タグキーは 128 文字を超えてはなりません。
+ **再アクティブ化:** 同じタグキーを非アクティブ化して再アクティブ化すると、新しいデータのみが利用可能になります。`EarliestDatapointTimestamp` はアクティブ化のたびにリセットされます。
+ **停止されたタグ:** 各タグキーは、最大 100,000 個の一意のタグ値をサポートしています。タグキーがこのしきい値を超えると、`suspended` ステータスに移行します。タグは引き続き制限にカウントされますが、データは取り込まれなくなります。タグの一意の値の数を減らすか、非アクティブ化して、別のタグキーのスペースを解放します。