Melihat telemetri aplikasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Dokumen ini menjelaskan cara melihat dasbor siap pakai (OOTB) untuk aplikasi, layanan, dan beban kerja App Hub Anda. Dasbor ini dapat membantu Anda memahami performa resource aplikasi dan mendiagnosis masalah.

Telemetri yang ditampilkan dasbor bawaan ini mencakup data log dan metrik, serta informasi tentang insiden yang terbuka. Dasbor aplikasi memberikan informasi seperti lokasi, tingkat kritisitas, dan pemilik. Dasbor layanan dan beban kerja menyertakan informasi tentang App Hub dan jenis infrastruktur.

Label khusus aplikasi

Label khusus App Hub memungkinkan Google Cloud Observability membuat hierarki dasbor OOTB dan memfilter telemetri yang ditampilkan ke telemetri untuk layanan atau beban kerja. Anda juga dapat menggunakan label ini untuk memfilter data log dan metrik. Label ini dilampirkan saat aplikasi Anda berjalan di resource Google Cloud yang terintegrasi dengan App Hub. Label ini mungkin dilampirkan saat metrik Google Cloud Managed Service for Prometheus diserap.

Label log

Entri log berisi kolom apphub yang mencantumkan label untuk aplikasi dan untuk layanan atau beban kerja. Berikut ini ilustrasi format data ini:

apphub: {
  application: {
    id: "my-app"
    location: "my-app-location"
  }
  workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
  }
}

Label metrik

Bagian ini menjelaskan cara label khusus aplikasi dilampirkan ke data metrik yang dihasilkan oleh resource Google Cloud dan ke metrik Prometheus yang diserap menggunakan Google Cloud Managed Service for Prometheus. Berikut ini, interpretasikan a.b.{x,y} sebagai a.b.x dan a.b.y.

Label App Hub berikut dilampirkan ke data metrik dari Google Cloud resource yang digunakan oleh aplikasi Anda:

• metadata.system_labels.apphub_application_{container,id,location}
• metadata.system_labels.apphub_{workload,service}_{criticality_type,environment_type,id}

Label aplikasi App Hub dilampirkan ke metrik Google Cloud Managed Service for Prometheus jika salah satu hal berikut berlaku:

• Beban kerja berjalan di cluster Google Kubernetes Engine dengan versi 1.30 atau yang lebih tinggi, dan jenis pengontrol beban kerja adalah salah satu dari berikut:

  • apps.k8s.io/{Deployment,StatefulSet,DaemonSet}
  • batch.k8s.io/CronJob

• Saat Anda menggunakan OpenTelemetry di Cloud Run.

• Saat Anda menggunakan OpenTelemetry di Google Kubernetes Engine dan mengikuti panduan Penautan Kubernetes OTLP.

Managed Service for Prometheus menggunakan App Hub API untuk menentukan apakah aplikasi App Hub ada. Saat aplikasi ditemukan, label khusus aplikasi berikut akan ditambahkan ke data rekaman aktivitas Anda:

• metric.labels.apphub_application_{container,id,location}
• metric.labels.apphub_workload_{criticality_type,environment_type,id}

Label kebijakan pemberitahuan

Label layanan dan beban kerja tidak otomatis dilampirkan ke kebijakan pemberitahuan. Namun, Anda dapat mengaitkan kebijakan pemberitahuan dengan beban kerja atau layanan tertentu dengan melampirkan semua label berikut dengan kunci berikut ke kebijakan pemberitahuan:

• apphub_application_location
• apphub_application_id
• apphub_service_id atau apphub_workload_id

Jika kebijakan pemberitahuan menyertakan kunci sebelumnya, insiden untuk kebijakan tersebut akan ditampilkan di dasbor bawaan.

Untuk mengetahui informasi selengkapnya, lihat Mengaitkan kebijakan pemberitahuan dengan layanan atau beban kerja.

Navigasi konsol Google Cloud

Konsol Google Cloud akan otomatis mereset pemilih resource dari folder yang mengaktifkan aplikasi ke project pengelolaan folder saat halaman Google Cloud Observability dibuka.

Cloud Logging mendukung folder sebagai resource. Misalnya, Anda dapat membuat sink log dan bucket log di resource folder. Demikian pula, folder berisi bucket log _Default dan _Required, dan Anda mungkin ingin melihat kontennya. Untuk mengakses resource folder, gunakan pemilih resource dan pilih folder yang diaktifkan aplikasi secara manual.

Sebelum memulai

Sebelum dapat menggunakan Application Monitoring, pastikan Anda mengonfigurasi project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi. Ini adalah project yang Anda gunakan untuk melihat data telemetri aplikasi:

• Untuk mendapatkan izin yang Anda perlukan guna melihat data log dan metrik, serta membuat kebijakan pemberitahuan dan menyesuaikan dasbor, minta administrator untuk memberi Anda peran IAM berikut:

  • Logs Viewer (roles/logging.viewer) di project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda dan project lain yang mencantumkan cakupan log defaultnya. Peran ini memberikan akses ke sebagian besar entri log di bucket log _Default. Untuk mengetahui informasi selengkapnya, lihat Peran logging.
  • Logs View Accessor (roles/logging.viewAccessor) pada tampilan log yang tercantum dalam cakupan log default project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda. Untuk mempelajari lebih lanjut cara memberikan akses ke tampilan log, lihat Mengontrol akses ke tampilan log.
  • Monitoring Editor (roles/monitoring.editor) di project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi. Untuk akun utama yang tidak perlu membuat atau mengubah dasbor atau kebijakan pemberitahuan, sebaiknya berikan peran Monitoring Viewer (roles/monitoring.viewer).
  • App Hub viewer di project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin App Hub.

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

  Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

• Pastikan Anda telah mengonfigurasi cakupan visibilitas project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan pemantauan aplikasi.

  Cakupan visibilitas mengontrol data yang tersedia untuk project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi. Setelan default untuk cakupan ini mungkin tidak memungkinkan Anda melihat semua data log atau metrik.

• Perbarui kebijakan pemberitahuan yang memantau data aplikasi Anda untuk menyertakan label khusus aplikasi. Untuk mengetahui informasi selengkapnya, lihat Mengaitkan kebijakan pemberitahuan dengan layanan atau beban kerja.

Melihat ringkasan semua aplikasi

Dasbor OOTB tingkat teratas memberikan ringkasan ringkas tentang status aplikasi yang terdaftar. Untuk setiap aplikasi, halaman ini mencantumkan jumlah insiden terbuka dan informasi tentang lokasi, tingkat keparahan, dan lingkungan.

Untuk membuka dasbor OOTB tingkat teratas, yang mencantumkan informasi ringkasan untuk aplikasi yang terdaftar di App Hub, lakukan tindakan berikut:

1. Di konsol Google Cloud, buka halaman Application monitoring:

   Buka Pemantauan aplikasi

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

2. Di toolbar konsol Google Cloud, pilih project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi.

3. Opsional: Untuk membuka aplikasi di App Hub, klik more_vert Lainnya, lalu pilih Kelola di AppHub.

4. Untuk membuka dasbor OOTB untuk aplikasi, pilih aplikasi. Bagian berikutnya memberikan panduan tentang cara menjelajahi atau menafsirkan telemetri.

Menjelajahi insiden dan telemetri aplikasi

Saat Anda memilih aplikasi yang tercantum di halaman Pemantauan aplikasi, dasbor OOTB level teratas untuk aplikasi akan terbuka. Dasbor ini membantu Anda memahami kondisi aplikasi, dengan meringkas jumlah insiden yang terbuka dan mencantumkan nilai untuk beberapa sinyal emas. Misalnya, jika halaman ini menampilkan kegagalan yang meluas, hal itu mungkin menunjukkan bahwa sumber kegagalan adalah infrastruktur, bukan aplikasi Anda.

Untuk membuka dasbor OOTB aplikasi, lakukan tindakan berikut:

1. Di konsol Google Cloud, buka halaman Application monitoring:

   Buka Pemantauan aplikasi

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

2. Di toolbar konsol Google Cloud, pilih project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi.

3. Di halaman Application monitoring, pilih nama aplikasi.

   Dasbor OOTB untuk aplikasi akan terbuka dengan tab Ringkasan yang dipilih. Tab ini mencantumkan setiap layanan dan beban kerja, beserta jumlah insiden terbuka dan nilai untuk sinyal emas:

   • Traffic: Rasio permintaan masuk pada resource selama jangka waktu yang dipilih.
   • Rasio error server: Persentase rata-rata permintaan masuk yang menghasilkan atau memetakan ke kode error HTTP seri 5xx selama periode waktu yang dipilih.
   • Latensi P95: Persentil ke-95 latensi untuk permintaan layanan yang digabungkan selama jangka waktu yang dipilih, dalam milidetik.
   • Saturasi: Mengukur seberapa "penuh" layanan atau beban kerja Anda. Untuk layanan dan beban kerja yang mengandalkan resource berbasis komputasi seperti deployment grup instance terkelola (MIG), Cloud Run, dan Google Kubernetes Engine, kolom ini menunjukkan penggunaan CPU.

   Di tab Ringkasan, Anda dapat melakukan semua hal berikut:

   • Reset rentang waktu. Saat Anda membuka dasbor, rentang waktu akan ditetapkan ke satu jam terakhir.
   • Melihat informasi tentang aplikasi, seperti operator, developer, dan pemilik bisnis.
   • Buka aplikasi, layanan, atau beban kerja di App Hub.
   • Buka dasbor untuk layanan atau beban kerja.

4. Untuk melihat telemetri aplikasi dan informasi tentang insiden yang terbuka, pilih tab Dasbor.

   Tab Dasbor menampilkan informasi log, metrik, dan insiden. Tab ini juga berisi filter, yang dapat Anda gunakan untuk membatasi data yang ditampilkan tab. Untuk mengetahui informasi tentang cara menjelajahi tab ini, lihat bagian berikut dalam dokumen ini:

   • Memfilter dasbor.
   • Menjelajahi data log.
   • Pelajari data metrik.
   • Jelajahi insiden.

Memfilter dasbor

Tab Dasbor menampilkan data untuk layanan dan beban kerja dalam aplikasi. Namun, Anda dapat memfilter dasbor ini ke layanan tertentu atau ke sekumpulan layanan.

Misalnya, toolbar di tab Dasbor berisi filter seperti apphub_service_id: *. Jika Anda ingin melihat data untuk layanan tertentu, klik arrow_drop_down Menu, lalu pilih layanan tersebut dari daftar.

Menjelajahi data log

Jika Anda melihat tab Dasbor di dasbor aplikasi, data log Anda akan ditampilkan di bagian Log Aplikasi. Jika tidak, data log Anda akan ditampilkan di bagian Log.

Bagian Log Aplikasi dan Log di dasbor menampilkan entri log yang cocok dengan filter dan disimpan oleh resource yang tercantum dalam cakupan log default dari project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda. Untuk aplikasi, filternya mirip dengan berikut ini:

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

Untuk layanan dan beban kerja, filter berisi klausa tambahan. Untuk melihat filter yang diterapkan ke data log, klik Tampilkan kueri.

Jika ingin menulis kueri, Anda dapat membuka flyout atau membuka halaman Logs Explorer. Kedua opsi ini memungkinkan Anda menulis dan menjalankan kueri, serta mengubah cakupan. Namun, flyout mempertahankan konteks saat ini dan memungkinkan Anda menyimpan hasil eksplorasi ke dasbor kustom:

• Untuk membuka flyout, klik query_stats Jelajahi data.

  Setelah eksplorasi selesai, klik Batal untuk menutup flyout dan menghapus perubahan Anda. Jika Anda ingin menyimpan perubahan ke dasbor kustom, klik Simpan ke dasbor dan selesaikan dialog. Anda tidak dapat menyimpan perubahan ke dasbor yang Anda lihat saat membuka flyout.

  Flyout tidak mencantumkan filter yang ditampilkan oleh tombol Tampilkan kueri. Filter tersebut diterapkan di tingkat dasbor dan tidak dapat dihapus.

• Untuk membuka halaman Logs Explorer di tab browser baru, klik Lihat di Logs Explorer.

  Kueri telah dikonfigurasi sebelumnya untuk menampilkan entri log yang cocok dengan label aplikasi tertentu dan berada dalam rentang waktu yang ditentukan oleh dasbor. Saat Anda menutup tab browser, perubahan Anda akan dihapus.

Untuk mengetahui informasi selengkapnya tentang cara menjelajahi log, lihat dokumen berikut:

• Membuat dan menyimpan kueri menggunakan bahasa kueri Logging.
• Melihat log menggunakan Logs Explorer.

Menjelajahi data metrik

Diagram dan tabel di dasbor menampilkan sinyal emas dan data metrik lainnya yang relevan untuk resource yang digunakan oleh aplikasi, layanan, atau beban kerja Anda. Data yang ditampilkan dapat disimpan di project apa pun yang tercantum berdasarkan cakupan metrik project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda.

Untuk diagram atau tabel yang menampilkan data metrik, Anda dapat melihat detail seperti jenis metrik dan opsi agregasi. Untuk melihat informasi ini, buka toolbar diagram atau tabel, lalu klik infoInformasi.

Untuk mempelajari diagram atau tabel secara lebih mendetail, Anda dapat membuka flyout atau membuka halaman Metrics Explorer. Kedua opsi ini memungkinkan Anda mencoba berbagai setelan diagram dan menyimpan hasilnya ke dasbor kustom. Namun, flyout mempertahankan konteks Anda saat ini:

• Untuk membuka flyout, klik query_stats Jelajahi data.

  Setelah eksplorasi selesai, klik Batal untuk menutup flyout dan menghapus perubahan Anda. Jika Anda ingin menyimpan perubahan ke dasbor kustom, klik Simpan ke dasbor dan selesaikan dialog. Anda tidak dapat menyimpan perubahan ke dasbor yang Anda lihat saat membuka flyout.

• Untuk melihat diagram atau tabel di Metrics Explorer, buka toolbar, klik more_vert Lainnya, lalu pilih Lihat di Metrics Explorer.

  Sekarang Anda memiliki diagram sementara yang dapat diubah dan dieksplorasi. Misalnya, Anda dapat mengubah opsi agregasi atau mengubah gaya tampilan. Untuk menyimpan diagram ke dasbor kustom, klik Simpan ke dasbor dan selesaikan

Menjelajahi insiden

Bagian Notifikasi di dasbor mencantumkan insiden terbaru untuk kebijakan pemberitahuan yang terkait dengan layanan atau beban kerja. Kebijakan pemberitahuan ini harus disimpan di project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi Anda.

Jika tidak melihat entri apa pun di bagian Notifikasi, berarti Anda tidak memiliki kebijakan pemberitahuan yang terkait dengan layanan atau beban kerja. Untuk membuat asosiasi ini, tambahkan label ke kebijakan. Untuk mengetahui informasi selengkapnya, lihat Mengaitkan kebijakan pemberitahuan dengan layanan atau beban kerja.

Untuk mendapatkan informasi selengkapnya tentang insiden dan kebijakan pemberitahuan, lakukan hal berikut:

• Untuk menemukan detail tentang kebijakan pemberitahuan yang menyebabkan insiden, klik nama kebijakan. Dasbor yang terbuka akan menampilkan informasi mendetail tentang kebijakan pemberitahuan, termasuk diagram yang menampilkan data dan label yang dipantau.

• Untuk melihat semua kebijakan pemberitahuan yang terkait dengan aplikasi, buka toolbar, lalu klik query_stats Data penjelajah. Flyout akan terbuka yang mencantumkan semua kebijakan. Untuk kembali ke dasbor, klik Batal.

Menjelajahi insiden dan telemetri layanan atau beban kerja

Dasbor OOTB disediakan untuk setiap layanan dan beban kerja. Dasbor ini menampilkan informasi log, metrik, dan insiden, serta dapat membantu Anda memahami kondisi layanan atau beban kerja tertentu. Anda dapat menjelajahi data di dasbor bawaan ini secara serupa dengan menjelajahi data yang ditampilkan di tab Dasbor aplikasi.

Untuk membuka dasbor bawaan untuk layanan atau beban kerja, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Application monitoring:

   Buka Pemantauan aplikasi

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

2. Di toolbar konsol Google Cloud, pilih project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi.

3. Di halaman Pemantauan aplikasi, pilih nama aplikasi, lalu pilih layanan atau beban kerja.

   Dasbor menampilkan informasi log, metrik, dan insiden untuk layanan atau beban kerja yang Anda pilih. Untuk informasi tentang cara menjelajahi data ini, lihat bagian berikut dalam dokumen ini:

   • Menjelajahi data log.
   • Pelajari data metrik.
   • Jelajahi insiden.

Membuat dasbor kustom

Google Cloud Observability mendukung pembuatan dasbor kustom, yang memungkinkan Anda memiliki kontrol penuh atas konten dasbor. Dasbor kustom tercantum di halaman Dasbor di konsol Google Cloud, dan dapat disalin, diedit, dan dihapus. Laporan juga dapat menjadi tujuan tempat Anda menyimpan widget dasbor yang telah dikonfigurasi. Misalnya, jika Anda menjelajahi diagram di dasbor aplikasi, Anda dapat menyimpan diagram tersebut ke dasbor kustom dengan membuka toolbar dan memilih Simpan ke dasbor.

Jika Anda berencana membuat dasbor kustom untuk aplikasi, layanan, atau beban kerja, hal berikut mungkin berguna:

• Dokumen Ringkasan dasbor memberikan ringkasan jenis widget dan menyertakan link ke panduan berbasis tugas.

• Anda dapat menambahkan filter tingkat dasbor ke dasbor kustom. Menggunakan filter ini mungkin lebih efisien, dan lebih fleksibel, daripada menambahkan filter ke setiap widget. Filter didasarkan pada label. Untuk mengetahui daftar label, lihat bagian Label khusus aplikasi dalam dokumen ini.

• Pertimbangkan apakah template yang ada mungkin memiliki sebagian besar konten yang Anda inginkan. Untuk mengetahui informasi selengkapnya, termasuk link ke repositori GitHub yang menyimpan template, lihat Menginstal template dasbor.

Mengaitkan kebijakan pemberitahuan dengan aplikasi App Hub

Anda mengaitkan kebijakan pemberitahuan dengan layanan atau beban kerja dengan menambahkan label khusus aplikasi ke kebijakan pemberitahuan. Saat Anda menambahkan label ini, label tersebut akan tercantum dalam kebijakan pemberitahuan dan juga disertakan dalam insiden apa pun. Untuk mempelajari label lebih lanjut, lihat artikel Menambahkan anotasi pada insiden dengan label.

Untuk mengaitkan kebijakan pemberitahuan dengan beban kerja atau layanan menggunakan konsol Google Cloud, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman notifications Alerting:

   Buka Pemberitahuan

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

2. Di toolbar konsol Google Cloud, pilih project host App Hub atau project pengelolaan untuk folder yang mengaktifkan aplikasi.
3. Temukan kebijakan pemberitahuan, klik more_vert Lihat lainnya, pilih Edit, lalu buka bagian Notifikasi dan nama.
4. Di bagian Application labels, pilih aplikasi, lalu pilih beban kerja atau layanan Anda.
5. Klik Save policy.

Setelah Anda menyelesaikan langkah-langkah ini, label dengan kunci berikut akan dilampirkan ke kebijakan pemberitahuan Anda. Label ini mengidentifikasi aplikasi dan layanan atau beban kerja Anda:

• apphub_application_location
• apphub_application_id
• apphub_service_id atau apphub_workload_id

Anda juga dapat menambahkan label pengguna ke kebijakan pemberitahuan menggunakan Google Cloud CLI, Terraform, atau Cloud Monitoring API. Namun, Anda harus menggunakan kunci label yang ditampilkan dalam contoh sebelumnya. Untuk informasi selengkapnya, lihat referensi berikut:

• Mengelola kebijakan pemberitahuan menurut API.
• Mengelola kebijakan pemberitahuan dengan Terraform.

Memecahkan masalah

Untuk informasi yang dapat membantu Anda memahami data yang Anda lihat, atau alasan dasbor tidak menampilkan data, lihat Memecahkan Masalah Application Monitoring.