Trace dan rentang

Di Cloud Trace, detail migrasi dan rentang membentuk model data yang digunakan untuk melacak jalur dan latensi permintaan melalui aplikasi terdistribusi Anda. Detail migrasi menangkap cara permintaan berjalan secara menyeluruh di seluruh layanan Anda. Detail migrasi terdiri dari rentang, yang mencatat operasi individual panggilan fungsi, dan RPC yang terjadi selama permintaan tersebut.

Model data detail migrasi

Detail migrasi terdiri dari hal berikut:

  • ID detail migrasi: ID unik operasi menyeluruh. ID detail migrasi diterapkan dalam konteks permintaan di seluruh batas layanan.

  • Koleksi rentang: Kumpulan rentang yang memiliki ID detail migrasi yang sama. Rentang ini membentuk pohon atau grafik asiklik terarah yang mewakili hierarki panggilan permintaan.

Cloud Trace menggunakan ID detail migrasi untuk mengidentifikasi rentang mana di repositorinya yang terkait dengan detail migrasi yang sama.

Model data rentang

Rentang mewakili satu operasi yang terjadi dalam jangka waktu tertentu. Setiap rentang berisi kolom yang memberikan informasi tentang rentang dan status operasi:

  • ID mencakup kolom berikut:

    • ID detail migrasi: ID unik permintaan atau detail migrasi keseluruhan yang menjadi tempat rentang berada.
    • ID rentang: ID unik untuk rentang. Jika operasi dipanggil beberapa kali dalam satu detail migrasi, setiap pemanggilan akan menghasilkan rentang terpisah dengan nama yang sama, tetapi ID rentang yang unik.
    • ID rentang induk: Mengidentifikasi operasi induk yang memanggil rentang ini. Rentang "root" memiliki ID rentang induk yang ditetapkan ke null.
    • Nama: Nama operasi yang dilakukan.
    • Jenis: Jenis rentang memberikan informasi kepada alat pelacakan, seperti Trace Explorer, tentang hubungan antar-rentang. Untuk mengetahui informasi selengkapnya, lihat OpenTelemetry SpanKind.

  • Informasi eksekusi diberikan di kolom berikut:

    • Status: Mencatat status penyelesaian operasi. Nilai kolom ini adalah Unset (default), Error, atau Ok. Nilai default tidak menunjukkan error.
    • Waktu mulai: Waktu mulai operasi.
    • Waktu berakhir: Waktu berakhir operasi.

Rentang dapat berisi kolom lain, seperti peristiwa, atribut, dan link:

  • Peristiwa mencatat pesan terstruktur yang diberi stempel waktu dalam rentang.
  • Atribut menyimpan informasi tambahan tentang operasi menggunakan key-value pair. Saat menulis atribut, sebaiknya ikuti Konvensi Semantik OpenTelemetry jika memungkinkan.
  • Link memungkinkan Anda menghubungkan satu rentang dengan rentang lainnya.

Untuk mengetahui informasi selengkapnya, lihat OpenTelemetry: Spans.

Resource

Resource OpenTelemetry:

Langkah berikutnya