Menandai aturan dan grup pengambilan sampel X-Ray

Tanda adalah kata atau frasa yang dapat Anda gunakan untuk mengidentifikasi dan mengatur sumber daya AWS Anda. Anda dapat menambahkan beberapa tanda pada setiap sumber daya. Setiap tanda mencakup kunci dan nilai opsional yang Anda tentukan. Misalnya, kunci tanda mungkin domain, dan nilai tanda mungkin example.com. Anda dapat mencari dan memfilter sumber daya Anda berdasarkan tanda yang Anda tambahkan. Untuk informasi selengkapnya tentang cara menggunakan tanda, lihat Penandaan sumber daya AWS di Referensi Umum AWS.

Gunakan tanda untuk memberlakukan izin berbasis tanda pada distribusi CloudFront. Untuk informasi selengkapnya, lihat Mengontrol Akses ke Sumber Daya AWS Menggunakan Tanda Sumber Daya.

catatan

Editor Tanda dan Resource Groups AWS saat ini tidak mendukung sumber daya X-Ray. Anda menambahkan dan mengelola tanda dengan menggunakan konsol AWS X-Ray tersebut atau API.

Anda juga dapat menerapkan tanda ke sumber daya dengan menggunakan konsol X-Ray, API, AWS CLI, SDK, dan AWS Tools for Windows PowerShell. Untuk informasi selengkapnya, lihat dokumentasi berikut ini:

• API X-Ray – Lihat operasi berikut di Referensi API AWS X-Ray:

  • ListTagsForResource

  • CreateSamplingRule

  • CreateGroup

  • TagResource

  • UntagResource

• AWS CLI – Lihat xray di Referensi Perintah AWS CLI

• SDK – Lihat dokumentasi SDK yang berlaku di halaman Dokumentasi AWS

catatan

Jika Anda tidak dapat menambahkan atau mengubah tanda pada sumber daya X-Ray, atau Anda tidak dapat menambahkan sumber daya yang memiliki tanda tertentu, Anda mungkin tidak memiliki izin untuk melakukan operasi ini. Untuk meminta akses, hubungi pengguna AWS di korporasi Anda yang memiliki izin Administrator di X-Ray.

Pembatasan tanda

Batasan berikut berlaku untuk tanda.

• Jumlah maksimum tanda per sumber daya – 50

• Panjang kunci maksimum – 128 karakter Unicode

• Panjang nilai maksimum – 256 karakter Unicode

• Nilai yang valid untuk kunci dan nilai – a-z, A-Z, 0-9, spasi, dan karakter berikut: _ . : / = + - dan @

• Kunci dan nilai tag peka huruf besar dan kecil.

• Jangan gunakan aws: sebagai prefiks untuk kunci; ini disimpan untuk penggunaan AWS.

catatan

Anda tidak dapat mengedit atau menghapus tanda sistem.

Mengelola tanda di konsol tersebut

Anda dapat menambahkan tanda opsional saat membuat grup X-Ray atau aturan pengambilan sampel. Tanda juga dapat diubah atau dihapus di konsol tersebut nanti.

Prosedur berikut menjelaskan cara menambahkan, mengedit, dan menghapus tanda untuk grup dan aturan pengambilan sampel Anda di konsol X-Ray.

Topik

• Tambahkan tanda ke grup baru (konsol)
• Tambahkan tanda ke aturan pengambilan sampel baru (konsol)
• Edit atau hapus tanda untuk grup (konsol)
• Edit atau hapus tanda untuk aturan pengambilan sampel (konsol)

Tambahkan tanda ke grup baru (konsol)

Saat membuat grup X-Ray baru, Anda dapat menambahkan tanda opsional di halaman Buat grup.

1. Masuk ke AWS Management Console dan buka konsol X-Ray di https://console.aws.amazon.com/xray/home.

2. Di panel navigasi, luaskan Konfigurasi, dan pilih Grup.

3. Pilih Buat grup.

4. Pada halaman Buat grup, tentukan nama dan ekspresi filter untuk grup. Untuk informasi selengkapnya tentang properti ini, lihat Mengkonfigurasi grup.

5. Di Tanda, masukkan kunci tanda dan, secara opsional, nilai tanda. Misalnya, Anda dapat memasukkan kunci tanda Stage, dan nilai tanda Production, untuk menunjukkan bahwa grup ini digunaan untuk produksi. Saat Anda menambahkan tanda, baris baru akan muncul bagi Anda untuk menambahkan tanda lain, jika diperlukan. Lihat Pembatasan tanda di topik ini untuk keterbatasan pada tanda.

6. Setelah Anda selesai menambahkan tanda, pilih Buat grup.

Tambahkan tanda ke aturan pengambilan sampel baru (konsol)

Saat membuat aturan pengambilan sampel X-Ray baru, Anda dapat menambahkan tanda di halaman Buat aturan pengambilan sampel.

1. Masuk ke AWS Management Console dan buka konsol X-Ray di https://console.aws.amazon.com/xray/home.

2. Di panel navigasi, luaskan Konfigurasi, dan pilih Pengambilan Sampel.

3. Pilih Buat aturan pengambilan sampel.

4. Pada Buat aturan pengambilan sampel, tentukan nama, prioritas, batas, kriteria pencocokan, dan atribut yang cocok. Untuk informasi selengkapnya tentang properti ini, lihat Mengonfigurasi aturan pengambilan sampel.

5. Di Tanda, masukkan kunci tanda dan, secara opsional, nilai tanda. Misalnya, Anda dapat memasukkan kunci tanda Stage, dan nilai tanda Production, untuk menunjukkan bahwa aturan pengambilan sampel ini digunaan untuk produksi. Saat Anda menambahkan tanda, baris baru akan muncul untuk menambahkan tanda lain, jika diperlukan. Lihat Pembatasan tanda di topik ini untuk keterbatasan pada tanda.

6. Setelah Anda selesai menambahkan tanda, pilih Buat aturan pengambilan sampel.

Edit atau hapus tanda untuk grup (konsol)

Anda dapat mengubah atau menghapus tanda pada grup X-Ray di halaman Edit grup.

1. Masuk ke AWS Management Console dan buka konsol X-Ray di https://console.aws.amazon.com/xray/home.

2. Di panel navigasi, luaskan Konfigurasi, dan pilih Grup.

3. Di tabel Grup, pilih nama grup.

4. Pada halaman Edit grup, di Tanda, edit kunci dan nilai tanda. Anda tidak dapat memiliki kunci tanda duplikat. Nilai tanda bersifat opsional; Anda dapat menghapus nilai jika diinginkan. Untuk informasi selengkapnya tentang properti lain di halaman Edit grup, lihat Mengkonfigurasi grup. Lihat Pembatasan tanda di topik ini untuk keterbatasan pada tanda.

5. Untuk menghapus tanda, pilih X di sebelah kanan tanda.

6. Setelah selesai mengedit atau menghapus tanda, pilih Perbarui grup.

Edit atau hapus tanda untuk aturan pengambilan sampel (konsol)

Anda dapat mengubah atau menghapus tanda pada aturan pengambilan sampel X-Ray di halaman Edit aturan pengambilan sampel.

1. Masuk ke AWS Management Console dan buka konsol X-Ray di https://console.aws.amazon.com/xray/home.

2. Di panel navigasi, luaskan Konfigurasi, dan pilih Pengambilan Sampel.

3. Di tabel Aturan pengambilan sampel, pilih nama aturan pengambilan sampel.

4. Di Tanda, edit kunci dan nilai tanda. Anda tidak dapat memiliki kunci tanda duplikat. Nilai tanda bersifat opsional; Anda dapat menghapus nilai jika diinginkan. Untuk informasi selengkapnya tentang properti lain di halaman Edit aturan pengambilan sampel, lihat Mengonfigurasi aturan pengambilan sampel. Lihat Pembatasan tanda di topik ini untuk keterbatasan pada tanda.

5. Untuk menghapus tanda, pilih X di sebelah kanan tanda.

6. Setelah selesai mengedit atau menghapus tanda, pilih Perbarui aturan pengambilan sampel.

Mengelola Tanda di AWS CLI

Anda dapat menambahkan tanda saat membuat grup X-Ray atau aturan pengambilan sampel. Anda juga dapat menggunakan AWS CLI untuk membuat dan mengelola tanda. Untuk memperbarui tanda pada grup yang ada atau aturan pengambilan sampel, gunakan konsol AWS X-Ray tersebut, atau API TagResource atau UntagResource.

Topik

• Tambahkan tanda ke grup X-Ray atau aturan pengambilan sampel baru (CLI)
• Tambahkan tanda ke sumber daya yang ada (CLI)
• Daftar tanda pada sumber daya (CLI)
• Hapus tanda pada sumber daya (CLI)

Tambahkan tanda ke grup X-Ray atau aturan pengambilan sampel baru (CLI)

Untuk menambahkan tanda opsional saat Anda membuat grup X-Ray atau aturan pengambilan sampel baru, gunakan salah satu perintah berikut.

• Untuk menambahkan tanda ke grup baru, jalankan perintah berikut, ganti grup Dengan nama grup Anda, mydomain.com dengan titik akhir layanan Anda, nama_kunci dengan tanda kunci, dan secara opsional, nilai dengan nilai tanda. Untuk informasi selengkapnya tentang cara membuat grup, lihat Grup.

  aws xray create-group \
     --group-name "group_name" \
     --filter-expression "service(\"mydomain.com\") {fault OR error}" \
     --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

  Berikut adalah contohnya.

  aws xray create-group \
     --group-name "AdminGroup" \
     --filter-expression "service(\"mydomain.com\") {fault OR error}" \
     --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

• Untuk menambahkan tanda ke aturan pengambilan sampel baru, jalankan perintah berikut, ganti nama_kunci dengan kunci tanda, dan secara opsional, nilaidengan nilai tanda. Perintah ini menentukan nilai dalam parameter --sampling-rule sebagai file JSON. Untuk informasi selengkapnya tentang cara membuat aturan pengambilan sampel, lihat Aturan pengambilan sampel.

  aws xray create-sampling-rule \
     --cli-input-json file://file_name.json

  Berikut ini adalah kandungan file JSON file_name.json yang ditentukan oleh parameter --cli-input-json.

  {
      "SamplingRule": {
          "RuleName": "rule_name",
          "RuleARN": "string",
          "ResourceARN": "string",
          "Priority": integer,
          "FixedRate": double,
          "ReservoirSize": integer,
          "ServiceName": "string",
          "ServiceType": "string",
          "Host": "string",
          "HTTPMethod": "string",
          "URLPath": "string",
          "Version": integer,
          "Attributes": {"attribute_name": "value","attribute_name": "value"...}
      }
      "Tags": [
             {
                 "Key":"key_name",
                 "Value":"value"
             },
             {
                 "Key":"key_name",
                 "Value":"value"
             }
            ]
  }

  Berikut adalah contoh perintah tersebut.

  aws xray create-sampling-rule \
     --cli-input-json file://9000-base-scorekeep.json

  Berikut ini adalah isi dari contoh file 9000-base-scorekeep.json yang ditentukan oleh parameter --cli-input-json.

  {
      "SamplingRule": {
          "RuleName": "base-scorekeep",
          "ResourceARN": "*",
          "Priority": 9000,
          "FixedRate": 0.1,
          "ReservoirSize": 5,
          "ServiceName": "Scorekeep",
          "ServiceType": "*",
          "Host": "*",
          "HTTPMethod": "*",
          "URLPath": "*",
          "Version": 1
      }
      "Tags": [
             {
                 "Key":"Stage",
                 "Value":"Prod"
             },
             {
                 "Key":"Department",
                 "Value":"QA"
             }
            ]
  }

Tambahkan tanda ke sumber daya yang ada (CLI)

Anda dapat menjalankan perintah tag-resource untuk menambahkan tanda ke grup X-Ray atau aturan pengambilan sampel yang ada. Metode ini mungkin lebih sederhana daripada menambahkan tanda dengan menjalankan update-group atau update-sampling-rule.

Untuk menambahkan tanda ke grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya, dan tentukan kunci dan nilai opsional tanda yang ingin Anda tambahkan.

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

Berikut adalah contohnya.

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

Daftar tanda pada sumber daya (CLI)

Anda dapat menjalankan perintah list-tags-for-resource untuk daftar tanda dari grup X-Ray atau aturan pengambilan sampel.

Untuk mendaftarkan tanda yang terkait dengan grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya.

aws xray list-tags-for-resource \
   --resource-arn "ARN"

Berikut adalah contohnya.

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

Hapus tanda pada sumber daya (CLI)

Anda dapat menjalankan perintah untag-resource untuk menghapus tanda dari grup X-Ray atau aturan pengambilan sampel.

Untuk menghapus tanda dari grup atau aturan pengambilan sampel, jalankan perintah berikut, ganti ARN dengan ARN sumber daya, dan tentukan kunci tanda yang ingin Anda hapus.

Anda hanya dapat menghapus seluruh tanda dengan perintah untag-resource. Untuk menghapus nilai tanda, gunakan konsol X-Ray, atau hapus tanda dan tambahkan tanda baru dengan kunci yang sama, tetapi nilai yang berbeda atau kosong.

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

Berikut adalah contohnya.

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

Kontrol akses ke sumber daya X-Ray berdasarkan tanda

Anda dapat melampirkan tanda ke grup X-Ray atau aturan pengambilan sampel, atau meneruskan tanda dalam permintaan ke X-Ray. Untuk mengontrol akses berdasarkan tanda, Anda memberikan informasi tanda di elemen syarat kebijakan menggunakan kunci syarat xray:ResourceTag/key-name, aws:RequestTag/key-name, atau aws:TagKeys. Untuk mempelajari selengkapnya tentang kunci syarat ini, lihat Mengontrol akses ke sumber daya AWS menggunakan tanda sumber daya.

Untuk melihat contoh kebijakan berbasis identitas untuk membatasi akses ke sumber daya berdasarkan tag pada sumber daya tersebut, lihat Mengelola akses ke grup X-Ray dan aturan pengambilan sampel berdasarkan tanda.