Mengumpulkan metrik dan trace OpenTelemetry Protocol (OTLP)

Dokumen ini menjelaskan cara menggunakan Agen Operasional dan penerima OpenTelemetry Protocol (OTLP) untuk mengumpulkan metrik dan trace yang ditentukan pengguna dari aplikasi yang diinstrumentasikan menggunakan OpenTelemetry dan berjalan di Compute Engine.

Dokumen ini disusun sebagai berikut:

• Ringkasan yang menjelaskan kasus penggunaan untuk penerima OTLP.
• Prasyarat untuk menggunakan penerima OTLP.
• Mengonfigurasi agen untuk menggunakan penerima OTLP.
• Menggunakan penerima untuk mengumpulkan metrik. Bagian ini menjelaskan cara membuat kueri metrik OpenTelemetry di Cloud Monitoring.
• Menggunakan penerima untuk mengumpulkan rekaman aktivitas. Bagian ini menjelaskan cara memberikan otorisasi akun layanan untuk menulis data ke Cloud Trace.

Ringkasan penggunaan penerima OTLP

Dengan penerima OTLP Agen Operasional, Anda dapat melakukan hal berikut:

• Instrumentasikan aplikasi Anda menggunakan salah satu SDK khusus bahasa untuk OpenTelemetry. Untuk mengetahui informasi tentang bahasa yang didukung, lihat Instrumentasi OpenTelemetry. Kombinasi SDK OpenTelemetry dan Agen Operasional melakukan hal berikut untuk Anda:
  • Kumpulkan metrik OTLP dari aplikasi Anda dan kirimkan metrik tersebut ke Cloud Monitoring untuk dianalisis.
  • Kumpulkan rentang OTLP—data trace—dari aplikasi Anda, lalu kirim rentang tersebut ke Cloud Trace untuk dianalisis.
• Kumpulkan rekaman aktivitas dari aplikasi pihak ketiga yang memiliki dukungan bawaan untuk OTLP atau plugin dengan dukungan tersebut, seperti aplikasi Nginx. Penerima OTLP di Agen Operasional dapat mengumpulkan trace tersebut. Sebagai contoh, lihat modul nginx OpenTelemetry.
• Gunakan instrumentasi kustom OpenTelemetry.
• Gunakan instrumentasi otomatis OpenTelemetry.

Anda dapat menggunakan penerima untuk mengumpulkan metrik, rekaman aktivitas, atau keduanya. Setelah Ops Agent mengumpulkan metrik, Anda dapat menggunakan fitur Cloud Monitoring, termasuk diagram, dasbor, dan kebijakan pemberitahuan, untuk memantau metrik Anda. Jika aplikasi Anda juga mengirim data trace, Anda dapat menggunakan Cloud Trace untuk menganalisis data tersebut.

Manfaat

Sebelum ketersediaan plugin OTLP untuk Agen Operasional, cara utama untuk menginstrumentasi aplikasi Anda guna mengumpulkan metrik dan trace yang ditentukan pengguna mencakup hal berikut:

• Menggunakan library klien yang menerapkan Monitoring API atau Trace API.
• Menggunakan library OpenCensus yang lebih lama.

Menggunakan OpenTelemetry dengan penerima OTLP memiliki beberapa manfaat dibandingkan metode ini, termasuk yang berikut:

• OpenTelemetry adalah pengganti OpenCensus. Project OpenCensus diarsipkan. Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan OpenTelemetry?.
• Penyerapan dikontrol di tingkat agen, sehingga Anda tidak perlu men-deploy ulang aplikasi jika konfigurasi agen berubah.
• Aplikasi Anda tidak perlu menyiapkan kredensial Google Cloud ; semua otorisasi ditangani di tingkat agen.
• Kode aplikasi Anda tidak berisi kode pemantauan atau pelacakan khusus Google Cloud. Anda tidak perlu menggunakan Monitoring API atau Trace API secara langsung.
• Aplikasi Anda mengirimkan data ke Ops Agent, dan jika aplikasi Anda error, data apa pun yang telah dikumpulkan oleh Ops Agent tidak akan hilang.

Batasan

Listener OTLP yang diekspos oleh penerima Agen Operasional mendukung transportasi gRPC. HTTP, yang digunakan terutama untuk klien JavaScript, tidak didukung. Untuk mengetahui informasi selengkapnya tentang Protokol OpenTelemetry, lihat Detail Protokol.

Penerima OTLP tidak mengumpulkan log. Anda dapat mengumpulkan log menggunakan Ops Agent dan penerima lainnya serta menyertakan informasi log dalam rentang OTLP, tetapi penerima OTLP tidak mendukung pengumpulan log secara langsung. Untuk mengetahui informasi tentang penggunaan Agen Operasi untuk mengumpulkan log, lihat Konfigurasi logging.

Prasyarat

Untuk mengumpulkan metrik dan rekaman aktivitas OTLP menggunakan penerima OTLP dan Agen Operasional, Anda harus menginstal Agen Operasional versi 2.37.0 atau yang lebih tinggi.

Dokumen ini mengasumsikan bahwa Anda sudah memiliki aplikasi berbasis OpenTelemetry yang ditulis menggunakan salah satu OpenTelemetry SDK. Dokumen ini tidak membahas penggunaan SDK OpenTelemetry. Untuk mengetahui informasi tentang SDK dan bahasa yang didukung, lihat Instrumentasi OpenTelemetry.

Mengonfigurasi Agen Operasional

Untuk mengonfigurasi Agen Operasional agar menggunakan penerima OTLP, lakukan hal berikut:

1. Ubah file konfigurasi pengguna untuk Ops Agent agar menyertakan penerima OTLP.
2. Mulai ulang Agen Operasional.

Bagian berikut menjelaskan setiap langkah.

Ubah file konfigurasi pengguna Agen Operasional

Tambahkan elemen konfigurasi untuk penerima OTLP ke file konfigurasi pengguna untuk Agen Operasional:

• Untuk linux: /etc/google-cloud-ops-agent/config.yaml
• Untuk Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Untuk informasi umum tentang cara mengonfigurasi agen, lihat Model konfigurasi.

Penerima OTLP memperkenalkan bagian konfigurasi combined untuk Agen Operasional. Penggunaan penerima mengharuskan Anda mengonfigurasi layanan untuk metrik dan rekaman aktivitas, meskipun Anda tidak menggunakan keduanya.

Bagian berikut menjelaskan langkah-langkah konfigurasi untuk penerima OTLP.

Tambahkan bagian penerima combined

Anda menempatkan penerima untuk metrik dan rekaman aktivitas OTLP di bagian combined. Tidak ada pemroses atau layanan yang diizinkan di bagian combined. Anda tidak boleh mengonfigurasi penerima lain dengan nama yang sama dengan penerima di bagian combined. Contoh berikut menggunakan otlp sebagai nama penerima.

Konfigurasi combined minimal untuk OTLP terlihat seperti berikut:

combined:
  receivers:
    otlp:
      type: otlp

Penerima otlp memiliki opsi konfigurasi berikut:

• type: Wajib diisi. Harus otlp
• grpc_endpoint: Opsional. Endpoint gRPC tempat penerima OTLP memproses. Nilai defaultnya adalah 0.0.0.0:4317.

• metrics_mode: Opsional. Nilai defaultnya adalah googlemanagedprometheus, yang berarti penerima mengirimkan metrik OTLP sebagai metrik berformat Prometheus dengan menggunakan Prometheus API yang juga digunakan oleh Managed Service for Prometheus.

  Untuk mengirim metrik sebagai metrik kustom Cloud Monitoring menggunakan Monitoring API, tetapkan opsi metrics_mode ke nilai googlecloudmonitoring.

  Pilihan ini memengaruhi cara metrik Anda dimasukkan dan cara metrik tersebut diukur untuk penagihan. Untuk mengetahui informasi selengkapnya tentang format metrik, lihat Format penyerapan untuk metrik OTLP.

Menambahkan pipeline OTLP ke layanan Anda

Penerima OTLP dapat mengumpulkan metrik dan trace, jadi Anda harus menentukan layanan untuk metrik dan untuk trace. Jika tidak akan mengumpulkan metrik atau rekaman aktivitas, Anda dapat membuat layanan kosong. Jika sudah memiliki layanan dengan pipeline lain, Anda dapat menambahkan pipeline OTLP ke layanan tersebut.

Berikut menunjukkan layanan metrics dan traces dengan penerima OTLP yang disertakan dalam pipeline:

combined:
  receivers:
    otlp:
      type: otlp
metrics:
  service:
    pipelines:
      otlp:
        receivers: [otlp]
traces:
  service:
    pipelines:
      otlp:
        receivers: [otlp]

Jika Anda tidak ingin menggunakan layanan metrics atau traces untuk pengumpulan OTLP, maka jangan sertakan penerima OTLP dalam pipeline untuk layanan tersebut. Layanan harus ada, meskipun tidak memiliki pipeline. Jika aplikasi Anda mengirim data dari jenis tertentu dan tidak ada pipeline yang sesuai yang menyertakan penerima, maka Ops Agent akan menghapus data tersebut.

Mulai ulang Agen Operasional

Untuk menerapkan perubahan konfigurasi, Anda harus memulai ulang Agen Operasi.

Mengumpulkan metrik OTLP

Saat Anda menggunakan penerima OTLP untuk mengumpulkan metrik dari aplikasi OpenTelemetry, pilihan konfigurasi utama untuk penerima adalah API yang ingin Anda gunakan untuk menyerap metrik.

Anda dapat membuat pilihan ini dengan mengubah opsi metrics_mode dalam konfigurasi penerima otlp atau menggunakan nilai default. Pilihan ini memengaruhi cara metrik OTLP Anda dimasukkan ke Cloud Monitoring dan cara data tersebut diukur untuk tujuan penagihan.

Pilihan metrics_mode tidak memengaruhi kemampuan Anda untuk membuat diagram, dasbor, dan kebijakan pemberitahuan di Monitoring.

• Untuk mengetahui informasi tentang cara membuat diagram dan dasbor, lihat Ringkasan dasbor dan diagram.
• Untuk mengetahui informasi tentang kebijakan pemberitahuan, lihat Ringkasan pemberitahuan.

Bagian berikut menjelaskan perbedaan format yang digunakan oleh mode metrik dan cara membuat kueri data yang di-ingest untuk digunakan dalam Pemantauan.

Format penyerapan untuk metrik OTLP

Penerima OTLP menyediakan opsi metrics_mode, yang menentukan API yang digunakan untuk menyerap data metrik Anda. Secara default, penerima menggunakan Prometheus API; nilai default untuk opsi metrics_mode adalah googlemanagedprometheus. Metrik diserap menggunakan API yang sama dengan yang digunakan oleh Managed Service for Prometheus.

Anda dapat mengonfigurasi penerima untuk mengirim data metrik ke Cloud Monitoring API. Untuk mengirim data ke Monitoring API, tetapkan nilai opsi metrics_mode ke googlecloudmonitoring, seperti yang ditunjukkan dalam contoh berikut:

combined:
  receivers:
    otlp:
      type: otlp
      metrics_mode: googlecloudmonitoring

Format penyerapan yang Anda gunakan menentukan cara pemetaan metrik OTLP ke Cloud Monitoring. Anda dapat membuat diagram, dasbor, dan kebijakan pemberitahuan di Monitoring untuk metrik dengan format metrik apa pun, tetapi Anda merujuk metrik secara berbeda dalam kueri.

Format penyerapan juga menentukan model harga yang digunakan untuk penyerapan data.

Bagian berikut menjelaskan harga, perbedaan struktural antara metrik yang diserap oleh Prometheus API dan metrik yang sama yang diserap oleh Monitoring API, serta cara merujuk ke metrik dalam kueri.

Harga dan kuota

Format penyerapan yang Anda gunakan menentukan cara penagihan metrik OTLP:

• Prometheus API: Saat Anda menggunakan Prometheus API untuk menyerap metrik aplikasi, data tunduk pada harga berbasis sampel, seolah-olah metrik tersebut masuk menggunakan Managed Service for Prometheus.

  • Untuk mengetahui harga saat ini, lihat ringkasan harga Cloud Monitoring.
  • Untuk mengetahui informasi selengkapnya tentang penghitungan sampel dan perkiraan biaya, lihat Metrik yang dikenai biaya berdasarkan sampel yang diserap.

• Monitoring API: Saat Anda menggunakan Monitoring API untuk menyerap metrik aplikasi, data tunduk pada harga berbasis volume, seperti data dari integrasi lain dengan Agen Operasi.

  • Untuk mengetahui harga saat ini, lihat ringkasan harga Cloud Monitoring.
  • Untuk mengetahui informasi selengkapnya tentang volume penyerapan dan perkiraan biaya, lihat Metrik yang dikenakan biaya berdasarkan byte yang diserap.

Metrik yang diserap menggunakan penerima OTLP dianggap sebagai jenis metrik "kustom" saat diserap ke Cloud Monitoring dan tunduk pada kuota dan batas untuk metrik kustom.

Struktur metrik

Cloud Monitoring menjelaskan format data metrik menggunakan skema yang disebut deskriptor metrik. Deskripsi metrik mencakup nama metrik, jenis data nilai metrik, cara setiap nilai terkait dengan nilai sebelumnya, dan label apa pun yang terkait dengan nilai. Jika Anda mengonfigurasi penerima OTLP untuk menyerap metrik menggunakan Prometheus API, maka deskriptor metrik yang dibuat akan berbeda dengan deskriptor metrik yang dibuat saat Anda menggunakan Monitoring API.

Prometheus API: Saat Anda menggunakan Prometheus API untuk menyerap metrik aplikasi, setiap metrik diubah menggunakan transformasi OpenTelemetry-ke-Prometheus standar dan dipetakan ke jenis resource yang dipantau Cloud Monitoring.

• Transformasi ini mencakup perubahan berikut:
  • Nama metrik OTLP diawali dengan string prometheus.googleapis.com/.
  • Karakter non-alfanumerik, seperti titik (.), dalam nama metrik OTLP diganti dengan garis bawah (_).
  • Nama metrik OTLP diberi akhiran string yang menunjukkan jenis metrik, seperti /gauge atau /counter.
• Label berikut, yang diisi dengan nilai dari resource OTLP, ditambahkan ke metrik:
  • instance_name: Nilai atribut resource host.name.
  • machine_type: Nilai atribut resource host.type.

• Resource yang dipantau yang dicatat dengan pengukuran metrik adalah jenis prometheus_target generik. Deret waktu Prometheus yang dihasilkan mencakup label berikut dari resource prometheus_target, yang diisi dengan nilai dari resource OTLP:

  • location: Nilai atribut resource cloud.availability_zone.
  • namespace: Nilai atribut resource host.id.

  Jenis resource prometheus_target juga mencakup label berikut:

  • project_id: ID Google Cloud project, seperti my-project, tempat Agen Operasional berjalan.
  • cluster: Nilainya selalu __gce__ saat metrik dikumpulkan oleh Agen Operasional.

Jika data OTLP yang masuk tidak memiliki atribut resource yang digunakan untuk nilai label, nilai tersebut akan diambil dari informasi tentang VM yang menjalankan Ops Agent. Perilaku ini berarti data OTLP tanpa atribut resource ini akan muncul dengan label yang sama seperti data yang dikumpulkan oleh penerima Prometheus Ops Agent.

Monitoring API: Saat Anda menggunakan Monitoring API untuk memproses metrik aplikasi Anda, setiap metrik ditangani sebagai berikut:

• Nama metrik OTLP diawali dengan string workload.googleapis.com/, kecuali jika nama metrik OTLP sudah berisi string ini atau domain metrik valid lainnya, seperti custom.googleapis.com. Sebaiknya gunakan domain "workload".
• Resource yang dipantau dan dicatat dengan pengukuran metrik adalah jenis virtual machine Compute Engine gce_instance.

Contoh berikut menunjukkan deskripsi metrik untuk sepasang metrik OpenTelemetry. Metrik dibuat oleh aplikasi yang menggunakan library metrik Go OpenTelemetry. Tab Prometheus API menampilkan deskriptor metrik yang dibuat saat penerima OTLP menggunakan mode metrik Prometheus default. Tab Monitoring API menampilkan deskriptor metrik yang dibuat saat penerima OTLP menggunakan mode metrik googlecloudmonitoring.

Tidak ada perubahan pada aplikasi yang membuat metrik; satu-satunya perubahan adalah mode metrik yang digunakan oleh penerima OTLP.

Aplikasi membuat metrik pengukur OTLP, otlp.test.gauge, yang mencatat nilai floating point 64-bit. Tab berikut menampilkan deskriptor metrik yang dibuat oleh setiap API penyerapan:

{
  "name": "projects/PROJECT_ID/metricDescriptors/prometheus.googleapis.com/otlp_test_gauge/gauge",
  "labels": [
    {
      "key": "instance_name"
    },
    {
      "key": "machine_type"
    }
  ],
  "metricKind": "GAUGE",
  "valueType": "DOUBLE",
  "type": "prometheus.googleapis.com/otlp_test_gauge/gauge",
  "monitoredResourceTypes": [
    "prometheus_target"
  ]
}

{
  "name": "projects/PROJECT_ID/metricDescriptors/workload.googleapis.com/otlp.test.gauge",
  "labels": [
    {
      "key": "instrumentation_source"
    }
  ],
  "metricKind": "GAUGE",
  "valueType": "DOUBLE",
  "type": "workload.googleapis.com/otlp.test.gauge",
  "monitoredResourceTypes": [
    "gce_instance",
    ...many other types deleted...
  ]
}

Aplikasi membuat metrik penghitung OTLP, otlp.test.cumulative, yang mencatat nilai floating point 64-bit yang meningkat. Tab berikut menampilkan deskriptor metrik yang dibuat oleh setiap API penyerapan:

{
  "name": "projects/PROJECT_ID/metricDescriptors/prometheus.googleapis.com/otlp_test_cumulative/counter",
  "labels": [
    {
      "key": "instance_name"
    },
    {
      "key": "machine_type"
    }
  ],
  "metricKind": "CUMULATIVE",
  "valueType": "DOUBLE",
  "type": "prometheus.googleapis.com/otlp_test_cumulative/counter",
  "monitoredResourceTypes": [
    "prometheus_target"
  ]
}

{
  "name": "projects/PROJECT_ID/metricDescriptors/workload.googleapis.com/otlp.test.cumulative",
  "labels": [
    {
      "key": "instrumentation_source"
    }
  ],
  "metricKind": "CUMULATIVE",
  "valueType": "DOUBLE",
  "type": "workload.googleapis.com/otlp.test.cumulative",
  "monitoredResourceTypes": [
    "gce_instance",
    ...many other types deleted...
  ]
}

Tabel berikut merangkum beberapa perbedaan format yang diberlakukan oleh API yang digunakan untuk memproses metrik OTLP:

Format dan kueri penyerapan

Mode metrik yang digunakan di penerima OTLP memengaruhi cara Anda membuat kueri metrik yang dihasilkan di Cloud Monitoring saat Anda membuat diagram, dasbor, dan kebijakan pemberitahuan.

Saat Anda mengonfigurasi diagram, dasbor, atau kebijakan pemberitahuan di Cloud Monitoring, konfigurasi tersebut mencakup kueri untuk data yang digunakan oleh diagram, dasbor, atau kebijakan pemberitahuan.

Cloud Monitoring mendukung alat berikut untuk membuat kueri data metrik:

• Antarmuka berbasis pembuat kueri yang dibuat ke dalam alat seperti Metrics Explorer, antarmuka pembuat dasbor, dan antarmuka konfigurasi kebijakan pemberitahuan.
• Bahasa Kueri Prometheus (PromQL): Bahasa kueri berbasis teks yang digunakan oleh Prometheus open source.

Untuk mengetahui informasi tentang membuat kueri metrik OTLP menggunakan alat ini, lihat artikel berikut:

• Membuat kueri metrik OTLP yang diserap menggunakan Prometheus API
• Membuat kueri metrik OTLP yang di-ingest menggunakan Monitoring API

Membuat kueri metrik OTLP yang diserap menggunakan Prometheus API

Bagian ini menggambarkan cara Anda membuat kueri metrik OTLP yang di-ingest menggunakan Prometheus API, yang merupakan mode metrik default untuk penerima OTLP.

Kueri didasarkan pada metrik OTLP yang dijelaskan dalam Struktur metrik:

• otlp.test.gauge: Metrik pengukur OTLP yang mencatat nilai floating point 64-bit.
• otlp.test.cumlative: Metrik penghitung OTLP yang mencatat nilai floating point 64-bit yang meningkat.

Metrik ini diserap ke Cloud Monitoring dengan jenis metrik berikut, yang berfungsi sebagai nama:

• prometheus.googleapis.com/otlp_test_gauge/gauge
• prometheus.googleapis.com/otlp_test_cumulative/counter

Metrik yang diserap menggunakan Prometheus API ditulis terhadap jenis monitored-resource prometheus_target.

Tab menunjukkan tampilan kueri dasar saat mengkueri metrik dengan menggunakan konsol Google Cloud . Contoh ini menggunakan Metrics Explorer, tetapi prinsipnya sama untuk dasbor dan kebijakan pemberitahuan.

Membuat kueri metrik OTLP yang diserap menggunakan Monitoring API

Bagian ini menggambarkan cara Anda membuat kueri metrik OTLP yang di-ingest menggunakan Monitoring API. Anda memilih Cloud Monitoring API dengan menyetel kolom metrics_mode penerima OTLP ke nilai googlecloudmonitoring.

Kueri didasarkan pada metrik OTLP yang dijelaskan dalam Struktur metrik:

• otlp.test.gauge: Metrik pengukur OTLP yang mencatat nilai floating point 64-bit.
• otlp.test.cumlative: Metrik penghitung OTLP yang mencatat nilai floating point 64-bit yang meningkat.

Metrik ini diserap ke Cloud Monitoring dengan jenis metrik berikut, yang berfungsi sebagai nama:

• workload.googleapis.com/otlp.test.gauge
• workload.googleapis.com/otlp.test.cumulative

Metrik yang di-ingest menggunakan Monitoring API ditulis terhadap jenis monitored-resource gce_instance.

Tab menunjukkan tampilan kueri dasar saat mengkueri metrik dengan menggunakan konsol Google Cloud . Contoh ini menggunakan Metrics Explorer, tetapi prinsipnya sama untuk dasbor dan kebijakan pemberitahuan.

Melihat penggunaan dan diagnostik metrik di Cloud Monitoring

Halaman Pengelolaan Metrik Cloud Monitoring memberikan informasi yang dapat membantu Anda mengontrol jumlah yang Anda belanjakan untuk metrik yang dapat ditagih tanpa memengaruhi kemampuan pengamatan. Halaman Pengelolaan Metrik melaporkan informasi berikut:

• Volume penyerapan untuk penagihan berbasis byte dan sampel, di seluruh domain metrik dan untuk setiap metrik.
• Data tentang label dan kardinalitas metrik.
• Jumlah pembacaan untuk setiap metrik.
• Penggunaan metrik dalam kebijakan pemberitahuan dan dasbor kustom.
• Rasio error penulisan metrik.

Anda juga dapat menggunakan halaman Pengelolaan Metrik untuk mengecualikan metrik yang tidak diperlukan, sehingga menghilangkan biaya penyerapan metrik tersebut.

Untuk melihat halaman Pengelolaan Metrik, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman query_stats Metrics management:

   Buka Pengelolaan metrik

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar, pilih rentang waktu Anda. Secara default, halaman Pengelolaan Metrik menampilkan informasi tentang metrik yang dikumpulkan dalam satu hari sebelumnya.

Untuk mengetahui informasi selengkapnya tentang halaman Pengelolaan Metrik, lihat Melihat dan mengelola penggunaan metrik.

Mengumpulkan rekaman aktivitas OTLP

Jika Anda telah mengonfigurasi Agen Ops untuk mengumpulkan rekaman aktivitas, tetapi Anda tidak mendapatkan rekaman aktivitas di Cloud Trace saat menjalankan aplikasi, Anda mungkin perlu memberikan peran tambahan ke akun layanan Compute Engine yang digunakan agen. Secara default, akun layanan mendapatkan peran yang diperlukan untuk menulis metrik dan log, tetapi tidak untuk menulis rekaman aktivitas.

Bagian berikut menjelaskan cara memberikan otorisasi Cloud Trace yang diperlukan kepada akun layanan.

Menentukan peran yang diberikan ke akun layanan

Untuk melihat peran yang diberikan ke akun layanan, jalankan perintah gcloud projects get-iam-policy berikut:

gcloud projects get-iam-policy PROJECT_ID --format="table(bindings.role)" --flatten="bindings[].members" --filter="bindings.members:SERVICE_ACCT_NAME@PROJECT_ID."

Anda mungkin akan melihat output seperti berikut:

ROLE
roles/logging.logWriter
roles/monitoring.metricWriter

Jika output menyertakan roles/cloudtrace.agent atau roles/cloudtrace.admin, berarti akun layanan memiliki izin yang memadai untuk menulis rekaman aktivitas. Untuk memberikan salah satu peran ini ke akun layanan, lihat bagian berikut.

Memberikan peran Cloud Trace ke akun layanan

Untuk akun layanan, peran Agen Cloud Trace, roles/cloudtrace.agent, biasanya sudah sesuai. Untuk memberikan peran ini ke akun layanan, jalankan perintah gcloud projects add-iam-policy-binding berikut:

gcloud projects add-iam-policy-binding PROJECT_ID --member "serviceAccount:SERVICE_ACCT_NAME@PROJECT_ID." --role="roles/cloudtrace.agent"

Kemudian, Anda dapat menjalankan perintah gcloud projects get-iam-policy untuk memverifikasi bahwa perubahan telah dilakukan:

gcloud projects get-iam-policy PROJECT_ID --format="table(bindings.role)" --flatten="bindings[].members" --filter="bindings.members:SERVICE_ACCT_NAME@PROJECT_ID."

Output sekarang menyertakan roles/cloudtrace.agent:

ROLE
roles/cloudtrace.agent
roles/logging.logWriter
roles/monitoring.metricWriter

Untuk mengetahui informasi selengkapnya tentang cara mengelola peran IAM, lihat Mengelola akses ke project, folder, dan organisasi.

Setelah Anda mengizinkan akun layanan yang digunakan oleh Agen Operasi untuk menulis data ke Cloud Trace, saat Anda menjalankan aplikasi berbasis OpenTelemetry, trace akan muncul di Cloud Trace.

Menonaktifkan penerima OTLP

Jika Anda mengumpulkan metrik dan trace OTLP menggunakan Agen Operasional, dan Anda ingin menonaktifkan pengumpulan metrik atau trace, tetapi tidak keduanya, lakukan tindakan berikut:

1. Nonaktifkan pengumpulan metrik atau rekaman aktivitas dengan membuat salah satu perubahan berikut pada file konfigurasi pengguna, config.yaml:

   • Hapus pipeline otlp dari layanan metrics.
   • Hapus pipeline otlp dari layanan traces.

2. Mulai ulang Agen Operasional.

Untuk menonaktifkan pengumpulan metrik dan trace OTLP oleh Agen Operasional, lakukan hal berikut:

1. Hapus konfigurasi OTLP dari file konfigurasi pengguna:

   • Hapus seluruh bagian combined, yang mencakup penerima otlp.
   • Hapus pipeline otlp dari layanan metrics.
   • Hapus seluruh layanan traces.

2. Mulai ulang Agen Operasional.

Langkah berikutnya

Setelah metrik dan rekaman aktivitas aplikasi Anda diserap, Anda dapat menggunakan konsol Google Cloud untuk memantau dan menganalisis data Anda.

• Untuk mengetahui informasi tentang dasbor dan jenis diagram yang dapat Anda buat, lihat Dasbor dan diagram.
• Untuk mengetahui informasi tentang kebijakan pemberitahuan, lihat Menggunakan kebijakan pemberitahuan.
• Untuk mengetahui informasi tentang cara menganalisis data rekaman aktivitas, lihat Menemukan dan menjelajahi rekaman aktivitas.