Dokumen ini menjelaskan cara menjelajahi histori eksekusi monitor sintetis, dan juga menjelaskan cara melihat metrik dan log yang dikumpulkan.
Sebelum memulai
Untuk mendapatkan izin yang diperlukan agar dapat melihat hasil eksekusi monitor sintetis menggunakan konsol Google Cloud, minta administrator untuk memberi Anda peran IAM berikut di project Anda:
-
Monitoring Viewer (
roles/monitoring.viewer
) -
Cloud Functions Developer (
roles/cloudfunctions.developer
) -
Logs Viewer (
roles/logging.viewer
)
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.
Melihat histori eksekusi untuk monitor sintetis
Untuk memahami histori eksekusi yang berhasil dan gagal, lihat halaman Detail monitor sintetis untuk monitor sintetis:
-
Di konsol Google Cloud, buka halaman Synthetic monitoring:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Untuk membuka halaman Synthetic monitor details, temukan monitor sintetis yang ingin Anda lihat, lalu klik namanya.
Halaman Detail monitor sintetis mencantumkan informasi ringkasan, seperti rasio keberhasilan dan durasi serta status terbaru. Halaman ini juga memetakan durasi eksekusi yang direkam dan berisi tabel yang menampilkan satu baris untuk setiap eksekusi.
Setiap baris dalam tabel mencantumkan status, tanggal, durasi, dan ditautkan ke halaman yang menampilkan kode dan log saat ini yang relevan dengan eksekusi tersebut.
Melihat log dan rekaman aktivitas untuk eksekusi
Untuk melihat log, rekaman aktivitas, dan informasi ringkasan untuk eksekusi, di halaman Synthetic monitor details, klik link ke eksekusi. Dari halaman ini, Anda dapat melakukan hal berikut:
- Melihat data log.
- Melihat data rekaman aktivitas.
Lihat kode saat ini.
Akses fungsi Cloud Run.
Untuk pengujian Mocha, lihat hasil untuk setiap pengujian. Misalnya, jika monitor sintetis Anda berisi empat pengujian Mocha, panel Hasil pengujian akan berisi empat entri. Setiap entri dalam daftar dianotasikan sebagai lulus atau gagal.
Jika Anda memilih entri yang ditandai sebagai gagal, kode yang gagal akan ditampilkan dan ditandai.
Lihat data log
Log dikumpulkan secara otomatis oleh Cloud Monitoring. Log ini berisi informasi tentang detail pengujian dan kegagalan. Log yang tersedia bergantung pada fungsi Cloud Run Anda. Misalnya, jika Anda menggunakan Mocha, log akan menyertakan informasi tentang apakah pengujian lulus atau gagal, durasi pengujian, dan, jika terjadi kegagalan, stack trace lengkap. Pelacakan stack menyertakan baris kode yang gagal, jenis error, dan pesan error.
Untuk melihat detail log terkait, di panel Execution logs, perluas entri log.
Entri log ditampilkan dalam format JSON. Jika Anda lebih suka melihat log dengan Logs Explorer, klik Buka di Logs Explorer. Logs Explorer akan terbuka dan kueri telah dikonfigurasi sebelumnya.
Melihat data rekaman aktivitas
Data trace dikumpulkan secara otomatis saat fungsi Cloud Run Anda dijalankan. Screenshot berikut menunjukkan jenis data yang direkam pelacakan saat Anda menggunakan template umum:
Pada screenshot sebelumnya, baris pertama diagram gantt menampilkan
permintaan HTTP yang dimulai oleh Cloud Monitoring. Data rekaman aktivitas menampilkan
teks yang diteruskan ke logger winston, dan menampilkan permintaan HTTP
keluar yang dikeluarkan oleh panggilan axios get
.
Pada flyout trace, jika Anda mengklik Lihat di trace, Anda dapat melihat data trace menggunakan Cloud Trace Explorer. Trace Anda sudah diluaskan untuk menampilkan detail. Saat
trace atau span menampilkan lingkaran, Anda dapat mengklik lingkaran untuk menampilkan
entri log. Fungsi Cloud Run dapat diidentifikasi dengan melihat kolom resource.labels.service_name
.
Konsol
Untuk melihat data rekaman aktivitas, lakukan salah satu hal berikut:
Untuk melihat informasi ringkasan rekaman aktivitas, di toolbar halaman detail untuk eksekusi, klik Lihat detail rekaman aktivitas.
Flyout akan terbuka dan menampilkan ringkasan data latensi. Untuk mengetahui informasi lengkap tentang trace dan span-nya, lihat data di Cloud Trace. Untuk membuka Cloud Trace, klik View in trace.
Lihat trace Anda di Cloud Trace:
-
Di konsol Google Cloud, buka halaman Trace Explorer:
Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.
- Pada diagram pencar atau di tabel, pilih rekaman aktivitas.
- Untuk setiap log atau peristiwa yang terkait dengan span, span dianotasi dengan lingkaran. Untuk mendapatkan detail tentang peristiwa atau log, pilih lingkaran.
-
Untuk mengetahui informasi selengkapnya tentang menjelajahi data trace, lihat Menemukan dan menjelajahi trace.
API
Sebaiknya gunakan konsol Google Cloud untuk melihat data rekaman aktivitas.
Namun, jika Anda ingin menggunakan Cloud Trace API, gunakan
metode traces.list
untuk mencantumkan trace yang tersedia,
lalu gunakan
metode traces.get
untuk mendapatkan detail trace.
Melihat log dan metrik untuk fungsi Cloud Run
Log dan metrik memberi Anda informasi tentang tindakan yang dilakukan fungsi Cloud Run Anda. Misalnya, log yang berisi
kolom bernama userAgent
dengan nilai
GoogleStackdriverMonitoring-UptimeChecks
, menunjukkan bahwa layanan Anda
menerima permintaan dari layanan pemeriksaan waktu aktif.
Bagian selanjutnya dari bagian ini menjelaskan cara melihat log dan metrik yang dikumpulkan oleh fungsi Cloud Run.
Melihat log fungsi
Konsol
Untuk melihat log fungsi Cloud Run, lakukan hal berikut:
- Di panel dengan nama monitor sintetis, klik nama fungsi Cloud Run.
- Di halaman Detail fungsi, pilih tab Log.
Untuk menjelajahi data log dalam diagram secara lebih mendetail, luaskan entri log, lalu pilih Open in Logs Explorer. Dari Logs Explorer, Anda dapat melakukan tindakan seperti menyaring kueri, membuat metrik berbasis log, atau membuat pemberitahuan berbasis log.
API
Untuk mengetahui informasi tentang cara membaca dan menulis log fungsi Cloud Run secara terprogram, lihat Menulis, Melihat, dan Merespons Log.
Melihat metrik fungsi
Untuk monitor sintetis, metrik dikumpulkan oleh Cloud Monitoring dan fungsi Cloud Run:
Cloud Monitoring mengumpulkan metrik tentang setiap eksekusi monitor sintetis. Metrik ini mencakup latensi eksekusi kode dan histori keberhasilan. Untuk informasi tentang cara melihat metrik ini, lihat Melihat histori eksekusi untuk monitor sintetis.
Fungsi Cloud Run mengumpulkan metrik tentang setiap fungsi Cloud Run. Metrik ini mencatat waktu eksekusi, penggunaan memori, jumlah instance, dan jumlah pemanggilan per bagian. Bagian selanjutnya dari bagian ini menjelaskan cara melihat metrik ini.
Konsol
Untuk melihat metrik fungsi Cloud Run, lakukan hal berikut:
- Di panel dengan nama monitor sintetis, klik nama fungsi Cloud Run.
- Di halaman Detail fungsi, pilih tab Metrik.
Untuk memperbesar rentang waktu tertentu, lakukan hal berikut:
- Pada diagram, tempatkan kursor di salah satu ujung rentang waktu, lalu klik kiri kursor.
- Tarik kursor secara horizontal ke ujung rentang waktu lainnya, lalu lepaskan tombol kursor.
Untuk menjelajahi data yang ditampilkan dalam diagram secara lebih mendetail, di toolbar diagram, pilih more_vert Opsi diagram lainnya, lalu buat pilihan. Opsi tersebut meliputi:
- Mendownload diagram sebagai PNG atau CSV
- Menyimpan diagram ke dasbor kustom
- Membuka Metrics Explorer
- Luaskan atau ciutkan legenda diagram
- Mereset zoom
API
Untuk mengetahui informasi tentang cara membaca metrik fungsi Cloud Run secara terprogram, lihat Melihat metrik yang dipantau.