Tambahkan anotasi dan metadata ke segmen dengan X-Ray for. SDK NET - AWS X-Ray
Merekam anotasi dengan X-Ray SDK untuk. NETMerekam metadata dengan SDK X-Ray untuk. NET

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tambahkan anotasi dan metadata ke segmen dengan X-Ray for. SDK NET

Anda dapat mencatat informasi tambahan tentang permintaan, lingkungan, atau aplikasi Anda dengan anotasi dan metadata. Anda dapat menambahkan anotasi dan metadata ke segmen yang SDK dibuat X-Ray, atau ke subsegmen kustom yang Anda buat.

Anotasi adalah pasangan kunci-nilai dengan string, nomor, atau nilai-nilai Boolean. Anotasi diindekskan untuk digunakan dengan Ekspresi filter. Gunakan anotasi untuk merekam data yang ingin Anda gunakan untuk mengelompokkan jejak di konsol, atau saat memanggil. GetTraceSummariesAPI

Metadata adalah pasangan kunci-nilai yang dapat memiliki nilai dari setiap tipe, termasuk objek dan daftar, tetapi tidak diindekskan untuk digunakan dengan ekspresi filter. Gunakan metadata untuk mencatat data tambahan yang ingin Anda simpan di pelacakan tetapi tidak perlu digunakan dengan pencarian.

Merekam anotasi dengan X-Ray SDK untuk. NET

Gunakan anotasi untuk mencatat informasi pada segmen atau subsegmen yang ingin diindeks untuk pencarian.

Berikut ini diperlukan untuk semua anotasi dalam X-Ray:

Persyaratan Anotasi

  • Tombol — Kunci untuk anotasi X-Ray dapat memiliki hingga 500 karakter alfanumerik. Anda tidak dapat menggunakan spasi atau simbol selain titik atau titik (.)

  • Nilai — Nilai untuk anotasi X-Ray dapat memiliki hingga 1.000 karakter Unicode.

  • Jumlah Anotasi — Anda dapat menggunakan hingga 50 anotasi per jejak.

Untuk merekam anotasi di luar fungsi AWS Lambda

  1. Dapatkan instans dari AWSXRayRecorder.

    using Amazon.XRay.Recorder.Core;
...
AWSXRayRecorder recorder = AWSXRayRecorder.Instance;

  2. Panggil addAnnotation dengan kunci String dan Boolean, Int32, Int64, Double, atau nilai String.

    recorder.AddAnnotation("mykey", "my value");

    Contoh berikut menunjukkan cara memanggil putAnnotation dengan kunci String yang mencakup titik, dan nilai Boolean, Number, atau String.

    document.putAnnotation("testkey.test", "my value");
Untuk merekam anotasi di dalam fungsi AWS Lambda

Segmen dan subsegmen di dalam fungsi Lambda dikelola oleh lingkungan runtime Lambda. Jika Anda ingin menambahkan anotasi ke segmen atau subsegmen di dalam fungsi Lambda, Anda harus melakukan hal berikut:

  1. Buat segmen atau subsegmen di dalam fungsi Lambda.

  2. Tambahkan anotasi ke segmen atau subsegmen.

  3. Akhiri segmen atau subsegmen.

Contoh kode berikut menunjukkan cara menambahkan anotasi ke subsegmen di dalam fungsi Lambda:

#Create the subsegment
AWSXRayRecorder.Instance.BeginSubsegment("custom method");
#Add an annotation
AWSXRayRecorder.Instance.AddAnnotation("My", "Annotation");
try
{
  YourProcess(); #Your function
}
catch (Exception e)
{
  AWSXRayRecorder.Instance.AddException(e);
}
finally #End the subsegment
{
  AWSXRayRecorder.Instance.EndSubsegment();
}

X-Ray SDK mencatat anotasi sebagai pasangan kunci-nilai dalam suatu annotations objek dalam dokumen segmen. Memanggil addAnnotation operasi dua kali dengan kunci yang sama menimpa nilai yang direkam sebelumnya pada segmen atau subsegmen yang sama.

Untuk menemukan pelacakan yang memiliki anotasi dengan nilai-nilai tertentu, gunakan annotation[key] kata kunci dalam Ekspresi filter.

Merekam metadata dengan SDK X-Ray untuk. NET

Gunakan metadata untuk merekam informasi pada segmen atau subsegmen yang tidak perlu diindeks untuk digunakan di dalam penelusuran. Nilai metadata dapat berupa string, angka, boolean, atau objek lain yang dapat diserialisasi menjadi objek atau array. JSON

Untuk mencatat metadata

  1. Dapatkan instance dariAWSXRayRecorder, seperti yang ditunjukkan dalam contoh kode berikut:

    using Amazon.XRay.Recorder.Core;
...
AWSXRayRecorder recorder = AWSXRayRecorder.Instance;

  2. Panggil AddMetadata dengan namespace string, kunci string, dan nilai objek, seperti yang ditunjukkan pada contoh kode berikut:

    recorder.AddMetadata("my namespace", "my key", "my value");

    Anda juga dapat memanggil AddMetadata operasi hanya menggunakan pasangan kunci dan nilai, seperti yang ditunjukkan pada contoh kode berikut:

    recorder.AddMetadata("my key", "my value");

Jika Anda tidak menentukan nilai untuk namespace, SDK X-Ray menggunakan. default Memanggil AddMetadata operasi dua kali dengan kunci yang sama menimpa nilai yang direkam sebelumnya pada segmen atau subsegmen yang sama.