Capacity Manager 提供的標籤標籤生命週期啟用和停用受監控的標籤金鑰檢視受監控的標籤索引鍵使用標籤維度查詢指標資料匯出中的標籤組織和委派管理員考量事項

管理受監控的標籤金鑰

Amazon EC2 Capacity Manager 可讓您從 Amazon EC2 資源（例如 environment或 team) 中選取標籤金鑰，以在分析容量資料時用作維度。啟用標籤金鑰後，您可以依該標籤的值來分組和篩選指標，就像使用區域、執行個體類型或可用區域一樣。

每個帳戶最多可監控五個標籤金鑰。Capacity Manager 提供的標籤不會計入此限制。

主題

Capacity Manager 提供的標籤
標籤生命週期
啟用和停用受監控的標籤金鑰
檢視受監控的標籤索引鍵
使用標籤維度查詢指標
資料匯出中的標籤
組織和委派管理員
考量事項

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

啟用或停用受監控的標籤金鑰

前往 https://console.aws.amazon.com/ec2/ 開啟 Amazon EC2 主控台。
在導覽窗格中，選擇容量管理器。
選擇 Settings (設定) 標籤。
在監控標籤金鑰區段中，選擇管理標籤金鑰。
若要啟用標籤金鑰，請輸入標籤金鑰名稱，然後選擇新增。若要停用標籤金鑰，請選取標籤金鑰，然後選擇移除。
選擇儲存變更。

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"

檢視受監控的標籤索引鍵

您可以檢視您帳戶的所有受監控標籤金鑰，包括其目前狀態和可用的資料的最早時間戳記。

使用標籤維度查詢指標

標籤金鑰達到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 狀態。標籤仍會計入您的限制，但不再擷取資料。減少標籤的唯一值數量，或將其停用以釋放另一個標籤索引鍵的空間。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

分組及篩選資料

在主控台導覽容量管理器