Dokumen ini menjelaskan cara mempelajari histori eksekusi monitor sintetis Anda, dan juga menjelaskan cara melihat metrik dan log yang dikumpulkan.
Sebelum memulai
Untuk mendapatkan izin yang Anda perlukan guna melihat hasil eksekusi pemantauan sintetis menggunakan Konsol Google Cloud, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:
-
Monitoring Viewer (
roles/monitoring.viewer
) -
Developer Cloud Functions (
roles/cloudfunctions.developer
) -
Viewer Log (
roles/logging.viewer
)
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Melihat histori eksekusi monitor sintetis
Untuk memahami histori eksekusi yang lulus dan gagal, lihat halaman Detail monitor sintetis untuk monitor sintetis:
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Synthetic Monitoring:
- Untuk membuka halaman Detail monitor sintetis, cari monitor sintetis yang ingin Anda lihat, lalu klik namanya.
Halaman Detail monitor sintetis mencantumkan informasi ringkasan, seperti tingkat keberhasilan dan durasi, serta status terbaru. Halaman ini juga membuat diagram 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 saat ini serta mencatat log yang relevan dengan eksekusi tersebut.
Melihat log dan rekaman aktivitas untuk eksekusi
Untuk melihat log, trace, dan informasi ringkasan eksekusi, di halaman Detail monitor sintetik, klik link ke eksekusi. Dari halaman ini, Anda dapat melakukan hal berikut:
- Melihat data log.
- Melihat data rekaman aktivitas.
Lihat kode saat ini.
Mengakses Cloud Function.
Untuk pengujian Mocha, lihat hasil untuk setiap pengujian. Misalnya, jika monitor sintetis Anda berisi empat pengujian Mocha, panel Test results akan berisi empat entri. Setiap entri dalam daftar dianotasi 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 Cloud Function Anda. Misalnya, jika Anda menggunakan Mocha, log akan menyertakan informasi tentang apakah pengujian lulus atau gagal, durasi pengujian, dan, jika gagal, stack trace lengkap. Pelacakan tumpukan mencakup baris kode yang gagal, jenis error, dan pesan error.
Untuk melihat detail log terkait, di panel Execution logs, luaskan entri log.
Entri log ditampilkan dalam format JSON. Jika Anda ingin melihat log dengan Logs Explorer, klik Open in Logs Explorer. Logs Explorer terbuka dan kueri telah dikonfigurasi sebelumnya.
Melihat data trace
Data rekaman aktivitas dikumpulkan secara otomatis saat Cloud Function Anda dijalankan. Screenshot berikut menunjukkan jenis data yang diambil rekaman aktivitas 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 winston logger, dan menampilkan permintaan HTTP keluar yang dikeluarkan oleh panggilan get
axios.
Di trace flyout, jika mengklik View in trace, Anda dapat melihat data trace menggunakan penjelajah Cloud Trace. Rekaman aktivitas Anda sudah diperluas untuk menampilkan detail. Saat
rekaman aktivitas atau span menampilkan lingkaran, Anda dapat mengklik lingkaran tersebut untuk menampilkan
entri log. Cloud Function dapat diidentifikasi dengan melihat kolom resource.labels.service_name
.
Konsol
Untuk melihat data trace, lakukan salah satu langkah berikut:
Untuk melihat informasi ringkasan trace, di toolbar halaman detail eksekusi, klik Lihat detail rekaman aktivitas.
Sebuah {i>flyout<i} akan terbuka dan menampilkan ringkasan data latensi. Untuk mengetahui informasi lebih lanjut tentang trace dan spannya, lihat data di Cloud Trace. Untuk membuka Cloud Trace, klik View in trace.
Melihat trace Anda di Cloud Trace:
-
Di panel navigasi konsol Google Cloud, pilih Trace, lalu pilih Trace explorer:
- Di diagram sebar atau di tabel, pilih sebuah 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 cara menjelajahi data trace, lihat Menemukan dan menjelajahi trace.
API
Sebaiknya gunakan konsol Google Cloud untuk melihat data trace.
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 Cloud Function
Log dan metrik memberikan informasi tentang tindakan yang dilakukan Cloud Function Anda. Misalnya, log yang berisi kolom bernama userAgent
dengan nilai GoogleStackdriverMonitoring-UptimeChecks
, menunjukkan bahwa layanan Anda menerima permintaan dari layanan cek uptime.
Bagian selanjutnya akan menjelaskan cara melihat log dan metrik yang dikumpulkan oleh Cloud Functions.
Melihat log fungsi
Konsol
Untuk melihat log Cloud Function, lakukan hal berikut:
- Di panel dengan nama monitor sintetis Anda, klik nama Cloud Function.
- Di halaman Function details, pilih tab Logs.
Untuk mempelajari 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 Cloud Function secara terprogram, lihat Menulis, Menampilkan, dan Merespons Log.
Melihat metrik fungsi
Untuk monitor sintetis, metrik dikumpulkan oleh Cloud Monitoring dan Cloud Functions:
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, baca Melihat histori eksekusi untuk monitor sintetis.
Cloud Functions mengumpulkan metrik tentang setiap Cloud Function. Metrik ini mencatat waktu eksekusi, penggunaan memori, jumlah instance, dan jumlah pemanggilan per bagian. Bagian selanjutnya akan menjelaskan cara melihat metrik tersebut.
Konsol
Untuk melihat metrik Cloud Function, lakukan hal berikut:
- Di panel dengan nama monitor sintetis Anda, klik nama Cloud Function.
- Di halaman Function details, pilih tab Metrics.
Untuk memperbesar rentang waktu tertentu, lakukan langkah berikut:
- Pada diagram, tempatkan kursor di salah satu ujung rentang waktu, lalu klik kiri pointer Anda.
- Tarik pointer secara horizontal ke ujung rentang waktu lainnya, lalu lepaskan tombol pointer.
Untuk mempelajari data yang ditampilkan dalam diagram secara lebih mendetail, di toolbar diagram, pilih more_vert More chart options, lalu tentukan pilihan. Opsinya meliputi:
- Download diagram sebagai PNG atau CSV
- Menyimpan diagram ke dasbor kustom
- Buka Metrics Explorer
- Luaskan atau ciutkan legenda diagram
- Reset zoom
API
Untuk mengetahui informasi tentang cara membaca metrik Cloud Function secara terprogram, lihat Melihat metrik yang dipantau.