View a markdown version of this page

Mengelola kunci tag yang dipantau - Amazon Elastic Compute Cloud

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 (misalnyaenvironment, 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.

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. EarliestDatapointTimestampReset 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/

  2. Di panel navigasi, pilih Manajer Kapasitas.

  3. Pilih tab Pengaturan.

  4. Di bagian Tombol tag yang dipantau, pilih Kelola kunci tag.

  5. Untuk mengaktifkan kunci tag, masukkan nama kunci tag dan pilih Tambah. Untuk menonaktifkan tombol tag, pilih tombol tag dan pilih Hapus.

  6. 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/

  2. Di panel navigasi, pilih Manajer Kapasitas.

  3. Pilih tab Pengaturan.

  4. 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" } ] }

CapacityManagerProvidedBidang 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. EarliestDatapointTimestampIni 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 danGetCapacityManagerMetricData.

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 menggunakanGetCapacityManagerMonitoredTagKeys.

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 dantag:team. Kolom tag diurutkan menurut abjad.

Ekspor hanya menyertakan tag dalam activated status. Manajer Kapasitas tidak termasuk tag dalamactivating,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. EarliestDatapointTimestampIni 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. EarliestDatapointTimestampReset 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.