Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola kunci tag yang dipantau
Amazon EC2 Capacity Manager memungkinkan Anda memilih kunci tag dari sumber daya Amazon EC2 Anda (misalnya`environment`, `team` atau) untuk digunakan sebagai dimensi saat menganalisis data kapasitas Anda. Setelah kunci tag diaktifkan, Anda dapat mengelompokkan dan memfilter metrik berdasarkan nilai tag tersebut — seperti halnya dengan Region, Instance Type, atau Availability Zone.
Setiap akun dapat memantau hingga lima kunci tag. Tag yang disediakan oleh Manajer Kapasitas tidak dihitung dalam batas ini.
**Topics**
+ [Tag yang disediakan Manajer Kapasitas](#cm-provided-tags)
+ [Tag siklus hidup](#tag-lifecycle)
+ [Aktifkan dan nonaktifkan kunci tag yang dipantau](#activate-deactivate-tag-keys)
+ [Lihat kunci tag yang dipantau](#view-monitored-tag-keys)
+ [Metrik kueri menggunakan dimensi tag](#query-metrics-tag-dimensions)
+ [Tag dalam ekspor data](#tags-in-data-exports)
+ [Organizations dan administrator yang didelegasikan](#tag-keys-organizations)
+ [Pertimbangan-pertimbangan](#tag-keys-considerations)
## Tag yang disediakan Manajer Kapasitas
Capacity Manager menyertakan satu set tag default untuk setiap akun. Ini tidak dihitung terhadap batas kunci tag Anda. Tag yang disediakan Manajer Kapasitas mewakili dimensi pengelompokan yang umum digunakan dan meliputi:
+ `aws:autoscaling:groupName`- Grup Penskalaan Otomatis EC2
+ `aws:eks:cluster-name`— Nama cluster EKS
+ `eks:kubernetes-node-pool-name`— Kumpulan simpul EKS Kubernetes
+ `karpenter.sh/nodepool`— Kolam simpul Karpenter
Tag yang disediakan Manajer Kapasitas muncul `GetCapacityManagerMonitoredTagKeys` dengan `CapacityManagerProvided` disetel ke `true` dan tidak dapat diaktifkan atau dinonaktifkan oleh pelanggan. Saat Manajer Kapasitas pertama kali diaktifkan, tag yang disediakan Manajer Kapasitas mulai dalam `activating` status dan beralih ke `activated` setelah Manajer Kapasitas menerima titik data pertama yang menyertakan tag yang disediakan Manajer Kapasitas, biasanya dalam satu hingga dua jam.
## Tag siklus hidup
Kunci tag yang dipantau berkembang melalui status berikut:
| Status | Deskripsi |
| --- | --- |
| activating | Kunci tag terdaftar. Manajer Kapasitas sedang mempersiapkan untuk mengumpulkan data untuk tag ini. Anda tidak dapat melakukan kueri metrik menggunakan tag dalam status ini. |
| activated | Data tag sedang dicerna dan dapat ditanyakan melalui metrik APIs dan ekspor data. |
| suspended | Kunci tag telah melampaui ambang batas 100.000 nilai tag unik. Tag masih diperhitungkan terhadap batas Anda, tetapi Manajer Kapasitas tidak lagi menyerap data untuk itu. Jika penggunaan nilai tag Anda berkurang di bawah ambang batas untuk periode berkelanjutan, tag diaktifkan kembali secara otomatis. |
| deactivating | Kunci tag sedang dihapus. Itu tidak akan lagi muncul GetCapacityManagerMonitoredTagKeys setelah penonaktifan selesai. |
Ketika tag dalam `suspended` status, `GetCapacityManagerMonitoredTagKeys` mengembalikan pesan status berikut: “Tag ditangguhkan karena terlalu banyak nilai tag. Kurangi penggunaan tag atau nonaktifkan.”
**catatan**
Jika Anda menonaktifkan kunci tag dan kemudian mengaktifkan kembali kunci yang sama, hanya data yang tertelan setelah aktivasi ulang yang dapat dikueri. Data historis dari aktivasi sebelumnya tidak dapat diakses. `EarliestDatapointTimestamp`Reset dengan setiap aktivasi baru.
## Aktifkan dan nonaktifkan kunci tag yang dipantau
Anda dapat mengaktifkan kunci tag untuk mulai memantaunya sebagai dimensi, atau menonaktifkan kunci tag yang tidak lagi Anda perlukan. Aktivasi adalah asinkron — tag memasuki `activating` status dan transisi ke `activated` setelah Manajer Kapasitas mulai menerima data untuk tag tersebut. Penonaktifan menghapus kunci tag dari set yang dipantau.
**catatan**
Saat mengaktifkan kunci tag, masukkan hanya nama kunci (misalnya,`environment`). Capacity Manager secara otomatis membuatnya tersedia sebagai dimensi untuk mengelompokkan dan memfilter metrik Anda.
------
#### [ Console ]
**Untuk mengaktifkan atau menonaktifkan kunci tag yang dipantau**
1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Di panel navigasi, pilih **Manajer Kapasitas**.
1. Pilih tab **Pengaturan**.
1. Di bagian **Tombol tag yang dipantau**, pilih **Kelola kunci tag**.
1. Untuk mengaktifkan kunci tag, masukkan nama kunci tag dan pilih **Tambah**. Untuk menonaktifkan tombol tag, pilih tombol tag dan pilih **Hapus**.
1. Pilih **Simpan perubahan**.
------
#### [ AWS CLI ]
**Untuk mengaktifkan kunci tag**
Gunakan perintah berikut untuk mengaktifkan satu atau beberapa tombol tag:
```
aws ec2 update-capacity-manager-monitored-tag-keys \
--activate-tag-keys "environment" "teamId"
```
Output menunjukkan kunci tag dan status awalnya:
```
{
"CapacityManagerTagKeys": [
{
"TagKey": "environment",
"Status": "activating"
},
{
"TagKey": "teamId",
"Status": "activating"
}
]
}
```
**Untuk menonaktifkan kunci tag**
Gunakan perintah berikut untuk menonaktifkan satu atau beberapa kunci tag:
```
aws ec2 update-capacity-manager-monitored-tag-keys \
--deactivate-tag-keys "project"
```
Output menunjukkan status yang diperbarui:
```
{
"CapacityManagerTagKeys": [
{
"TagKey": "project",
"Status": "deactivating"
}
]
}
```
Anda dapat mengaktifkan dan menonaktifkan kunci tag dalam permintaan yang sama:
```
aws ec2 update-capacity-manager-monitored-tag-keys \
--activate-tag-keys "environment" "teamId" \
--deactivate-tag-keys "project"
```
------
## Lihat kunci tag yang dipantau
Anda dapat melihat semua kunci tag yang dipantau untuk akun Anda, termasuk statusnya saat ini dan stempel waktu paling awal dari mana data tersedia.
------
#### [ Console ]
**Untuk melihat kunci tag yang dipantau**
1. Buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Di panel navigasi, pilih **Manajer Kapasitas**.
1. Pilih tab **Pengaturan**.
1. Di bagian **Tombol tag yang dipantau, lihat kunci** tag Anda, statusnya, dan apakah itu tag yang disediakan oleh Manajer Kapasitas.
------
#### [ AWS CLI ]
**Untuk melihat kunci tag yang dipantau**
Jalankan perintah berikut:
```
aws ec2 get-capacity-manager-monitored-tag-keys
```
Output mencantumkan semua kunci tag, termasuk tag yang disediakan Manajer Kapasitas dan tag yang dikelola pelanggan:
```
{
"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`Bidang menunjukkan apakah tag adalah tag () yang disediakan oleh Manajer Kapasitas atau tag yang dikelola pelanggan (`true`). `false` Tag yang disediakan oleh Manajer Kapasitas tidak dihitung terhadap batas kunci tag Anda. `EarliestDatapointTimestamp`Ini menunjukkan titik waktu paling awal dari mana data tersedia untuk kunci tag itu.
------
## Metrik kueri menggunakan dimensi tag
Setelah kunci tag mencapai `activated` status, Anda dapat menggunakannya sebagai dimensi dalam `GetCapacityManagerMetricDimensions` dan`GetCapacityManagerMetricData`.
**Untuk menanyakan metrik yang dikelompokkan berdasarkan dimensi tag**
Gunakan perintah berikut ini.
```
aws ec2 get-capacity-manager-metric-dimensions \
--group-by tag:environment account-id \
--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[prod]}'
```
Saat Anda mengelompokkan berdasarkan dimensi tag, hasilnya mencakup semua sumber daya di akun Anda — tidak hanya yang memiliki tag. Sumber daya yang tidak memiliki nilai untuk tag dikelompokkan ke dalam bucket terpisah dengan nilai string kosong. Misalnya, jika akun Anda menggunakan 800 jam vCPU dalam periode tertentu dan hanya beberapa sumber daya yang memiliki `environment` tag, pengelompokan berdasarkan kunci `environment` tag mungkin akan menghasilkan:
+ `prod`- 300 jam vCPU
+ `staging`- 200 jam vCPU
+ `""`(string kosong) - 300 jam vCPU dari sumber daya tanpa tag `environment`
Ini memastikan bahwa total di semua bucket memperhitungkan penggunaan penuh Anda. Anda dapat secara eksplisit memfilter sumber daya yang tidak ditandai dengan meneruskan string kosong sebagai nilai filter:
```
--filter-by 'DimensionCondition={Dimension=tag:environment,Comparison=equals,Values=[""]}'
```
**catatan**
Jika Anda melakukan kueri dengan kunci tag yang masih dalam `activating` status, kueri ditolak dengan kesalahan 400. Tunggu status tag berubah `activated` sebelum melakukan kueri. Anda dapat memeriksa status menggunakan`GetCapacityManagerMonitoredTagKeys`.
**catatan**
Kueri dengan waktu mulai sebelum dimensi tag yang disediakan ditolak. `EarliestDatapointTimestamp` Gunakan `GetCapacityManagerMonitoredTagKeys` untuk memeriksa kapan data tersedia untuk setiap tag.
## Tag dalam ekspor data
Saat Anda mengaktifkan pemantauan tag, ekspor data Anda menyertakan kunci tag yang diaktifkan dan tag yang disediakan Manajer Kapasitas sebagai kolom tambahan. Kolom tag muncul setelah semua kolom standar dengan header seperti `tag:environment` dan`tag:team`. Kolom tag diurutkan menurut abjad.
Ekspor hanya menyertakan tag dalam `activated` status. Manajer Kapasitas tidak termasuk tag dalam`activating`,`deactivating`, atau `suspended` status.
**catatan**
Jika Anda mengaktifkan kunci tag baru, ekspor data yang ada tidak secara otomatis menyertakan tag baru. Anda harus membuat ekspor data baru untuk menyertakan kunci tag yang baru diaktifkan sebagai kolom.
## Organizations dan administrator yang didelegasikan
Jika akun Anda merupakan bagian dari AWS Organisasi dengan Pengelola Kapasitas tingkat organisasi diaktifkan, setiap akun (administrator organisasi dan administrator yang didelegasikan) dapat mengaktifkan, menonaktifkan, dan menanyakan kunci tag secara independen. Setiap akun mempertahankan status tag sendiri,`EarliestDatapointTimestamp`, dan batas kunci tag.
Akun hanya dapat menanyakan data metrik untuk kunci tag yang telah diaktifkan oleh akun itu sendiri. Jika administrator organisasi dan administrator yang didelegasikan mengaktifkan kunci tag yang sama (misalnya,`environment`), setiap akun melacak status aktivasi dan ketersediaan datanya sendiri secara independen.
Ketika administrator yang didelegasikan menonaktifkan kunci tag, administrator yang didelegasikan tidak dapat lagi melakukan kueri data untuk tag tersebut, meskipun administrator organisasi masih mengaktifkan kunci tag yang sama.
## Pertimbangan-pertimbangan
+ **Pembaruan nilai tag:** Nilai tag untuk sumber daya baru dan tag yang baru diterapkan ke sumber daya yang ada tersedia dalam beberapa jam. Jika Anda mengubah nilai tag yang ada pada sumber daya, nilai yang diperbarui dapat memakan waktu hingga 24 jam untuk ditampilkan di Manajer Kapasitas.
+ **Waktu aktivasi:** Setelah Anda mengaktifkan kunci tag, itu bisa memakan waktu hingga 24 jam sebelum transisi tag ke `activated` status dan data menjadi queryable. `EarliestDatapointTimestamp`Ini mewakili kapan data tersedia, bukan saat tag diaktifkan.
+ **Batas kunci tag:** Setiap akun dapat memantau hingga lima kunci tag. Tag yang disediakan oleh Manajer Kapasitas tidak dihitung dalam batas ini.
+ **Persyaratan karakter kunci tag:** Tombol tag dapat berisi huruf Unicode, digit, spasi putih, dan karakter berikut:. `_ . : / = + @ -` Tombol tag tidak boleh melebihi 128 karakter.
+ **Aktivasi ulang:** Jika Anda menonaktifkan dan mengaktifkan kembali kunci tag yang sama, hanya data baru yang tersedia. `EarliestDatapointTimestamp`Reset dengan setiap aktivasi.
+ **Tag yang ditangguhkan:** Setiap kunci tag mendukung hingga 100.000 nilai tag unik. Jika kunci tag melebihi ambang batas ini, kunci tersebut dipindahkan ke `suspended` status. Tag masih diperhitungkan terhadap batas Anda tetapi data tidak lagi tertelan. Kurangi jumlah nilai unik untuk tag atau nonaktifkan untuk mengosongkan ruang untuk kunci tag lain.