本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理受監控的標籤金鑰
Amazon EC2 Capacity Manager 可讓您從 Amazon EC2 資源 （例如 `environment`或 `team`) 中選取標籤金鑰，以在分析容量資料時用作維度。啟用標籤金鑰後，您可以依該標籤的值來分組和篩選指標，就像使用區域、執行個體類型或可用區域一樣。
每個帳戶最多可監控五個標籤金鑰。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 提供的標籤會在 中顯示`GetCapacityManagerMonitoredTagKeys`，並將 `CapacityManagerProvided` 設定為 `true`，且無法由客戶啟用或停用。第一次啟用容量管理員時，容量管理員提供的標籤會開始處於 `activating` 狀態，並在容量管理員收到包含容量管理員提供的標籤的第一個資料點`activated`之後轉換為 ，通常在一到兩個小時內。
## 標籤生命週期
受監控的標籤金鑰會繼續進行下列狀態：
| 狀態 | Description |
| --- | --- |
| activating | 標籤金鑰已註冊。Capacity Manager 正在準備收集此標籤的資料。您無法使用此狀態的標籤查詢指標。 |
| activated | 正在擷取標籤資料，並可透過指標 APIs 和資料匯出進行查詢。 |
| suspended | 標籤索引鍵已超過 100，000 個唯一標籤值的閾值。標籤仍會計入您的限制，但容量管理員不會再為其擷取資料。如果您的標籤值用量低於持續期間的閾值，則標籤會自動重新啟用。 |
| deactivating | 正在移除標籤金鑰。GetCapacityManagerMonitoredTagKeys 停用完成後，它不會再出現在 中。 |
當標籤處於 `suspended` 狀態時， `GetCapacityManagerMonitoredTagKeys`會傳回下列狀態訊息：「標籤因標籤值太多而暫停。減少標籤用量或停用標籤。」
**注意**
如果您停用標籤金鑰，然後重新啟用相同的金鑰，則只有重新啟用後擷取的資料才能查詢。無法存取先前啟用的歷史資料。會在每次新的啟用時`EarliestDatapointTimestamp`重設 。
## 啟用和停用受監控的標籤金鑰
您可以啟用標籤索引鍵，開始將它們監控為維度，或停用不再需要的標籤索引鍵。啟用是非同步的 — 標籤進入 `activating` 狀態，並在容量管理員開始接收該標籤的資料`activated`之後轉換為 。停用會從受監控的集合中移除標籤金鑰。
**注意**
啟用標籤金鑰時，請僅輸入金鑰名稱 （例如，`environment`)。Capacity Manager 會自動將其用作分組和篩選指標的維度。
------
#### [ Console ]
**啟用或停用受監控的標籤金鑰**
1. 前往 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 開啟 Amazon EC2 主控台。
1. 在導覽窗格中，選擇**容量管理器**。
1. 選擇 **Settings** (設定) 標籤。
1. 在**監控標籤金鑰**區段中，選擇**管理標籤金鑰**。
1. 若要啟用標籤金鑰，請輸入標籤金鑰名稱，然後選擇**新增**。若要停用標籤金鑰，請選取標籤金鑰，然後選擇**移除**。
1. 選擇**儲存變更**。
------
#### [ 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/](https://console.aws.amazon.com/ec2/) 開啟 Amazon EC2 主控台。
1. 在導覽窗格中，選擇**容量管理器**。
1. 選擇 **Settings** (設定) 標籤。
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` 欄位指出標籤是容量管理員提供的標籤 (`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 時數
+ `""` （空字串） — 300 個 vCPU 小時來自沒有 `environment`標籤的資源
這可確保所有儲存貯體的總計計入您的完整用量。您可以透過傳遞空字串做為篩選條件值，明確篩選未標記的資源：
```
--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
```
**注意**
如果您查詢的標籤索引鍵仍處於 `activating` 狀態，則會以 400 錯誤拒絕查詢。等待標籤的狀態變更為 `activated`再查詢。您可以使用 檢查狀態`GetCapacityManagerMonitoredTagKeys`。
**注意**
在任何提供的標籤維度的 之前，具有開始時間`EarliestDatapointTimestamp`的查詢會遭到拒絕。使用 `GetCapacityManagerMonitoredTagKeys`檢查資料何時可供每個標籤使用。
## 資料匯出中的標籤
當您啟用標籤監控時，資料匯出會包含已啟用的標籤金鑰和容量管理員提供的標籤，做為額外的資料欄。標籤欄會出現在具有 `tag:environment`和 等標頭的所有標準欄之後`tag:team`。標籤欄會依字母順序排序。
匯出僅包含`activated`處於 狀態的標籤。Capacity Manager 會排除 `activating`、 `deactivating`或 `suspended` 狀態的標籤。
**注意**
如果您啟用新的標籤金鑰，現有的資料匯出不會自動包含新的標籤。您必須建立新的資料匯出，以包含新啟用的標籤金鑰做為資料欄。
## 組織和委派管理員
當您的帳戶是啟用 AWS 組織層級容量管理員的組織的一部分時，每個帳戶 （組織管理員和委派管理員） 都可以獨立啟用、停用和查詢標籤金鑰。每個帳戶都會維護自己的標籤狀態、 `EarliestDatapointTimestamp`和標籤索引鍵限制。
帳戶只能查詢帳戶本身已啟用之標籤索引鍵的指標資料。如果組織管理員和委派管理員都啟用相同的標籤金鑰 （例如 `environment`)，每個帳戶都會獨立追蹤自己的啟用狀態和資料可用性。
當委派管理員停用標籤金鑰時，委派管理員就無法再查詢該標籤的資料，即使組織管理員仍然啟用相同的標籤金鑰。
## 考量事項
+ **標籤值更新：**新資源的標籤值和新套用至現有資源的標籤可在幾個小時內使用。如果您變更資源上現有標籤的值，更新後的值最多可能需要 24 小時才能反映在容量管理員中。
+ **啟用時間：**啟用標籤金鑰後，最多可能需要 24 小時才能將標籤轉換為`activated`狀態，且資料可查詢。`EarliestDatapointTimestamp` 代表資料何時可用，而不是在標籤啟用時。
+ **標籤金鑰限制：**每個帳戶最多可監控五個標籤金鑰。Capacity Manager 提供的標籤不會計入此限制。
+ **標籤索引鍵字元需求：**標籤索引鍵可包含 Unicode 字母、數字、空格和下列字元：`_ . : / = + @ -`。標籤索引鍵不得超過 128 個字元。
+ **重新啟用：**如果您停用並重新啟用相同的標籤金鑰，則只有新資料可用。會在每次啟用時`EarliestDatapointTimestamp`重設 。
+ **暫停的標籤：**每個標籤索引鍵最多支援 100，000 個唯一標籤值。如果標籤索引鍵超過此閾值，則會移至 `suspended` 狀態。標籤仍會計入您的限制，但不再擷取資料。減少標籤的唯一值數量，或將其停用以釋放另一個標籤索引鍵的空間。