Memecahkan masalah monitor sintetis dan cek uptime

Dokumen ini memberikan informasi tentang cara menemukan data log dan cara memecahkan masalah kegagalan monitor sintetis dan pemeriksaan uptime:

• Menemukan log
• Memecahkan masalah notifikasi
• Memecahkan masalah cek uptime publik
• Memecahkan masalah cek uptime pribadi
• Memecahkan masalah monitor sintetis

Menemukan log

Bagian ini memberikan informasi tentang cara menemukan log untuk pemeriksaan uptime dan monitor sintetis Anda:

1. Di konsol Google Cloud , buka halaman Logs Explorer:

   Buka Logs Explorer

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

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

3. Lakukan salah satu tindakan berikut:

   • Untuk menemukan semua log yang terkait dengan monitor sintetis atau pemeriksaan uptime Anda, lakukan kueri menurut jenis resource. Anda dapat menggunakan menu Resource atau memasukkan kueri.

     Untuk pemeriksaan uptime, di menu Resource, pilih Uptime Check URL, atau masukkan kueri berikut ke editor kueri, lalu klik Run query:

     resource.type="uptime_url"
     

     Untuk monitor sintetis, di menu Resource, pilih Cloud Run Revision, atau masukkan kueri berikut ke editor kueri, lalu klik Run query:

     resource.type="cloud_run_revision"
     

   • Untuk menemukan log yang berisi informasi tentang respons yang diterima selama eksekusi pemeriksaan uptime atau monitor sintetis, lakukan salah satu hal berikut:

     • Untuk membuat kueri menggunakan ID monitor sintetis atau pemeriksaan uptime, gunakan format berikut saat memasukkan ID ke editor kueri, lalu klik Run query

       labels.check_id="my-check-id"
       

     • Untuk membuat kueri log yang berisi data respons untuk permintaan yang dikeluarkan oleh pemantau sintetis dan pemeriksaan uptime, masukkan kueri berikut ke editor kueri, lalu klik Jalankan kueri

       "UptimeCheckResult"
       

       Kueri sebelumnya cocok dengan semua entri log yang menyertakan string "UptimeCheckResult".

     Log ini mencakup hal berikut:

     • ID monitor sintetis atau cek uptime, yang disimpan di kolom labels.check_id.

     • Untuk monitor sintetis, nama fungsi Cloud Run Anda, yang disimpan di kolom resource.labels.service_name.

     • Saat data trace dikumpulkan, ID trace terkait, yang disimpan di kolom trace.

   • Untuk memverifikasi bahwa layanan Anda menerima permintaan dari server, salin kueri berikut ke editor kueri, lalu klik Jalankan kueri: Google Cloud

     "GoogleStackdriverMonitoring-UptimeChecks"
     

     Kolom protoPayload.ip berisi salah satu alamat yang digunakan oleh server pemeriksaan aktif. Untuk mengetahui informasi tentang cara mencantumkan semua alamat IP, lihat Mencantumkan alamat IP.

Memecahkan masalah notifikasi

Bagian ini menjelaskan beberapa error yang mungkin Anda alami saat mengonfigurasi kebijakan pemberitahuan dan memberikan informasi untuk menyelesaikannya.

Satu pemeriksa gagal, tetapi yang lain tidak

Anda sedang meninjau metrik cek uptime dan melihat bahwa satu pemeriksa melaporkan kegagalan saat semua pemeriksa lainnya melaporkan keberhasilan.

Anda tidak perlu melakukan tindakan apa pun untuk menyelesaikan situasi ini.

Jika hanya satu pemeriksa yang melaporkan kegagalan, kegagalan tersebut mungkin merupakan akibat dari waktu tunggu perintah pemeriksa yang habis karena masalah jaringan. Artinya, alih-alih perintah gagal, perintah tidak selesai dalam waktu tunggu yang ditentukan.

Kebijakan pemberitahuan yang menggunakan konfigurasi default memerlukan kegagalan dari setidaknya dua pemeriksa sebelum membuat insiden dan mengirim pemberitahuan. Kegagalan yang dilaporkan oleh satu pemeriksa tidak akan menghasilkan notifikasi.

Anda menerima notifikasi dan ingin men-debug kegagalan

1. Untuk mengidentifikasi kapan kegagalan dimulai, lakukan salah satu hal berikut:

   • Untuk pemeriksaan uptime, guna menentukan kapan kegagalan terjadi, lihat halaman Detail uptime:

     1. Di konsol Google Cloud , buka halaman  Pemeriksaan uptime:

        Buka Cek uptime

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

     2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

     3. Cari dan pilih pemeriksaan uptime.

        Diagram Pemeriksaan lulus menampilkan histori pemeriksaan. Untuk mengidentifikasi kapan pemeriksaan uptime pertama kali gagal, Anda mungkin perlu mengubah rentang waktu untuk diagram. Pemilih rentang waktu berada di toolbar halaman Detail uptime.

   • Untuk monitor sintetis, guna menentukan kapan kegagalan terjadi, lihat halaman Detail uptime:

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

        Buka Pemantauan sintetis

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

     2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
     3. Cari dan pilih monitor sintetis.

2. Untuk mengetahui informasi tentang cara menemukan data log terkait, lihat bagian di halaman ini yang berjudul Menemukan log.

Anda tidak menerima notifikasi bahwa cek uptime gagal

Anda telah mengonfigurasi cek uptime dan sedang melihat halaman Detail uptime untuk cek tersebut. Anda melihat bahwa grafik Pemeriksaan lulus menunjukkan bahwa setidaknya satu pemeriksa gagal. Namun, Anda tidak menerima notifikasi.

Secara default, kebijakan pemberitahuan dikonfigurasi untuk membuat insiden dan mengirim notifikasi saat pemeriksa di setidaknya dua region gagal menerima respons terhadap cek uptime. Kegagalan ini harus terjadi secara bersamaan.

Anda dapat mengedit kondisi kebijakan pemberitahuan sehingga Anda akan diberi tahu jika satu region gagal menerima respons. Namun, sebaiknya Anda menggunakan konfigurasi default, yang mengurangi jumlah notifikasi yang mungkin Anda terima karena kegagalan sementara.

Untuk melihat atau mengedit kebijakan pemberitahuan, lakukan langkah berikut:

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

   Buka Alerting

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

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Klik Lihat semua kebijakan di panel Kebijakan.

4. Temukan kebijakan yang ingin Anda lihat atau edit, lalu klik nama kebijakan.

   Anda dapat melihat dan mengedit kebijakan dari halaman Detail kebijakan.

Memecahkan masalah cek uptime publik

Bagian ini menjelaskan beberapa error yang mungkin Anda temui saat menggunakan pemeriksaan waktu aktif publik dan memberikan informasi untuk menyelesaikannya.

Cek uptime publik Anda gagal

Anda mengonfigurasi cek uptime publik, tetapi Anda menerima error saat melakukan langkah verifikasi.

Berikut adalah beberapa kemungkinan penyebab kegagalan pemeriksaan waktu aktif:

• Error Koneksi - Ditolak: Jika Anda menggunakan jenis koneksi HTTP default, periksa apakah Anda telah menginstal server web yang merespons permintaan HTTP. Error koneksi dapat terjadi pada instance baru jika Anda belum menginstal server web; lihat Panduan memulai Compute Engine. Jika Anda menggunakan jenis koneksi HTTPS, Anda mungkin harus melakukan langkah-langkah konfigurasi tambahan. Untuk masalah firewall, lihat Mencantumkan alamat IP server cek uptime.
• Nama atau layanan tidak ditemukan: Nama host mungkin salah.
• 403 Forbidden: Layanan menampilkan kode error ke pemeriksa uptime. Misalnya, konfigurasi server web Apache default menampilkan kode ini di Amazon Linux, tetapi menampilkan kode 200 (Berhasil) di beberapa versi Linux lainnya. Lihat tutorial LAMP untuk Amazon Linux atau dokumentasi server web Anda.
• 404 Tidak ditemukan: Jalur mungkin salah.
• 408 Waktu tunggu permintaan habis, atau tidak ada respons: Nomor port mungkin salah, layanan mungkin tidak berjalan, layanan mungkin tidak dapat diakses, atau waktu tunggu mungkin terlalu rendah. Pastikan firewall Anda mengizinkan traffic dari server uptime; lihat Mencantumkan alamat IP server cek uptime. Batas waktu ditentukan sebagai bagian dari opsi Validasi Respons.

Untuk membantu Anda memecahkan masalah kegagalan cek uptime publik, Anda dapat mengonfigurasi cek uptime untuk mengirim hingga 3 ping ICMP selama pemeriksaan. Ping dapat membantu Anda membedakan antara kegagalan yang disebabkan, misalnya, oleh masalah konektivitas jaringan dan oleh waktu tunggu di aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan ping ICMP.

Memecahkan masalah cek uptime pribadi

Bagian ini menjelaskan beberapa error yang mungkin Anda alami saat menggunakan pemeriksaan uptime pribadi dan memberikan informasi untuk menyelesaikannya.

Pembuatan cek uptime gagal

Setelan project Google Cloud Anda mungkin mencegah modifikasi peran yang ditetapkan ke akun layanan yang digunakan pemeriksaan uptime untuk mengelola interaksi dengan layanan Service Directory. Dalam situasi ini, pembuatan cek uptime akan gagal.

Bagian ini menjelaskan cara memberikan peran yang diperlukan akun layanan:

Akses ditolak

Pemeriksaan uptime Anda gagal dengan hasil VPC_ACCESS_DENIED. Hasil ini berarti ada aspek konfigurasi jaringan atau otorisasi akun layanan yang salah.

Periksa otorisasi akun layanan Anda untuk menggunakan project cakupan atau project yang dipantau seperti yang dijelaskan dalam Pembuatan pemeriksaan uptime gagal.

Untuk mengetahui informasi selengkapnya tentang cara mengakses jaringan pribadi, lihat Mengonfigurasi project jaringan.

Hasil anomali dari cek uptime pribadi

Anda memiliki layanan Service Directory dengan beberapa VM, dan konfigurasi layanan Anda berisi beberapa endpoint. Saat Anda mematikan salah satu VM, pemeriksaan uptime Anda tetap menunjukkan keberhasilan.

Jika konfigurasi layanan Anda berisi beberapa endpoint, salah satunya akan dipilih secara acak. Jika VM yang terkait dengan endpoint yang dipilih sedang berjalan, pemeriksaan uptime akan berhasil meskipun salah satu VM tidak aktif.

Header default

Pemeriksaan uptime Anda menampilkan error atau hasil yang tidak terduga. Hal ini dapat terjadi jika Anda telah mengganti nilai header default.

Saat permintaan dikirim untuk pemeriksaan uptime pribadi ke endpoint target, permintaan menyertakan header dan nilai berikut:

Jika Anda mencoba mengganti nilai ini, hal berikut dapat terjadi:

• Pemeriksaan uptime melaporkan error
• Nilai penggantian dihilangkan dan diganti dengan nilai dalam tabel

Tidak ada data yang terlihat

Anda tidak melihat data apa pun di dasbor pemeriksaan waktu aktif saat pemeriksaan waktu aktif Anda berada di project Google Cloud yang berbeda dengan layanan Service Directory.

Pastikan Google Cloud project yang berisi pemeriksaan uptime memantau Google Cloud project yang berisi layanan Service Directory.

Untuk mengetahui informasi selengkapnya tentang cara mencantumkan project yang dipantau dan menambahkan project lainnya, lihat Mengonfigurasi cakupan metrik untuk beberapa project.

Memecahkan masalah monitor sintetis

Bagian ini memberikan informasi yang dapat Anda gunakan untuk membantu memecahkan masalah monitor sintetis.

Pesan error setelah mengaktifkan API

Anda membuka alur pembuatan untuk monitor sintetis dan diminta untuk mengaktifkan setidaknya satu API. Setelah Anda mengaktifkan API, pesan yang mirip dengan berikut ini akan ditampilkan:

An error occurred during fetching available regions: Cloud Functions API has
not been used in project PROJECT_ID before or it is disabled.

Pesan error merekomendasikan agar Anda memverifikasi bahwa API diaktifkan, lalu menyarankan agar Anda menunggu dan mencoba lagi tindakan tersebut.

Untuk memverifikasi bahwa API sudah diaktifkan, buka halaman API & Layanan untuk project Anda:

Buka API & Layanan

Setelah memverifikasi bahwa API diaktifkan, Anda dapat melanjutkan dengan alur pembuatan. Kondisi ini akan diselesaikan secara otomatis setelah pengaktifan API diterapkan melalui backend.

Permintaan HTTP keluar tidak dilacak

Anda mengonfigurasi monitor sintetis untuk mengumpulkan data rekaman aktivitas untuk permintaan HTTP output. Data rekaman aktivitas Anda hanya menampilkan satu rentang, mirip dengan screenshot berikut:

Untuk mengatasi situasi ini, pastikan akun layanan Anda telah diberi peran Cloud Trace Agent (roles/cloudtrace.agent). Peran Editor (roles/editor) juga sudah cukup.

Untuk melihat peran yang diberikan ke akun layanan Anda, lakukan hal berikut:

1. Di Google Cloud konsol, buka halaman IAM:

   Buka IAM

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

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Pilih Sertakan pemberian peran yang disediakan Google.

4. Jika akun layanan yang digunakan oleh monitor sintetis Anda tidak tercantum, atau jika akun layanan tersebut belum diberi peran yang mencakup izin dalam peran Agen Cloud Trace (roles/cloudtrace.agent), maka berikan peran ini ke akun layanan Anda.

   Jika Anda tidak mengetahui nama akun layanan Anda, pilih Service Accounts di menu navigasi.

Status dalam proses

Halaman Monitor sintetis mencantumkan monitor sintetis dengan status In progress. Status In progress berarti monitor sintetis baru saja dibuat dan tidak ada data untuk ditampilkan, atau fungsi gagal di-deploy.

Untuk menentukan apakah fungsi gagal di-deploy, coba hal berikut:

• Pastikan nama fungsi Cloud Run Anda tidak berisi garis bawah. Jika ada garis bawah, hapus garis bawah dan deploy ulang fungsi Cloud Run.

• Buka halaman Detail monitor sintetis untuk monitor sintetis.

  Jika Anda melihat pesan berikut, hapus monitor sintetis.

  Cloud Function not found for this Synthetic monitor. Please confirm it exists or delete this monitor.
  

  Pesan error menunjukkan bahwa fungsi telah dihapus dan oleh karena itu, monitor sintetis tidak dapat menjalankan fungsi.

• Buka halaman Cloud Run functions untuk fungsi tersebut. Untuk membuka halaman ini dari halaman Detail monitor sintetis, klik Kode, lalu klik nama fungsi.

  Jika Anda melihat pesan yang mirip dengan berikut ini, berarti fungsi gagal di-deploy.

  This function has failed to deploy and will not work correctly. Please edit and redeploy
  

  Untuk mengatasi kegagalan ini, tinjau kode fungsi dan perbaiki error yang mencegah fungsi di-build atau di-deploy.

Saat Anda membuat monitor sintetis, mungkin perlu waktu beberapa menit agar fungsi di-deploy dan dieksekusi.

Status peringatan

Monitor sintetis mencantumkan monitor sintetis dengan status Warning. Status Warning berarti hasil eksekusi tidak konsisten. Hal ini mungkin menunjukkan masalah desain pada pengujian Anda, atau mungkin menunjukkan bahwa apa yang sedang diuji memiliki perilaku yang tidak konsisten.

Status gagal

Monitor sintetis mencantumkan monitor sintetis dengan status Failing. Untuk mendapatkan informasi selengkapnya tentang alasan kegagalan, lihat histori eksekusi terbaru.

• Jika pesan error Request failed with status code 429 ditampilkan, berarti target permintaan HTTP menolak perintah. Untuk mengatasi kegagalan ini, Anda harus mengubah target monitor sintetis.

  Endpoint https://www.google.com menolak permintaan yang dibuat oleh monitor sintetis.

• Jika kegagalan menampilkan waktu eksekusi 0ms, fungsi Cloud Run mungkin kehabisan memori. Untuk mengatasi kegagalan ini, edit fungsi Cloud Run Anda, lalu tingkatkan memori menjadi minimal 2 GiB dan tetapkan kolom CPU ke 1.

Penghapusan gagal untuk monitor sintetis

Anda menggunakan Cloud Monitoring API untuk menghapus monitor sintetis, tetapi panggilan API gagal dengan respons yang mirip dengan berikut ini:

{
  "error": {
    "code": 400,
    "message": "Request contains an invalid argument.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "[ORIGINAL ERROR] generic::invalid_argument: Cannot delete check 1228258045726183344. One or more alerting policies is using it.Delete the alerting policy with id projects/myproject/alertPolicies/16594654141392976482 and any other policies using this uptime check and try again."
      }
    ]
  }
}

Untuk mengatasi kegagalan, hapus kebijakan pemberitahuan yang memantau hasil monitor sintetis, lalu hapus monitor sintetis.

Tidak dapat mengedit konfigurasi pemeriksa link rusak

Anda membuat pemeriksa link rusak menggunakan konsol Google Cloud , dan Anda ingin mengubah elemen HTML yang diuji, atau Anda ingin mengubah waktu tunggu URI, percobaan ulang, tunggu pemilih, dan opsi per link. Namun, saat Anda mengedit pemeriksa link rusak, konsol Google Cloud tidak menampilkan kolom konfigurasi.

Untuk mengatasi kegagalan ini, lakukan hal berikut:

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

   Buka Pemantauan sintetis

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

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Cari monitor sintetis yang ingin Anda edit, klik more_vert Opsi lainnya, lalu pilih Edit.
4. Klik Edit function.

5. Edit objek options dalam file index.js, lalu klik Terapkan fungsi.

   Untuk mengetahui informasi tentang kolom dan sintaksis untuk objek ini, lihat broken-links-ok/index.js.

6. Klik Simpan.

KonsolGoogle Cloud menampilkan bahwa penyimpanan screenshot gagal

Anda telah membuat pemeriksa link rusak dan mengonfigurasinya untuk menyimpan screenshot. Namun, konsol Google Cloud menampilkan salah satu pesan peringatan berikut beserta informasi yang lebih mendetail:

• InvalidStorageLocation
• StorageValidationError
• BucketCreationError
• ScreenshotFileUploadError

Untuk mengatasi kegagalan ini, coba langkah-langkah berikut:

• Jika Anda melihat pesan InvalidStorageLocation, verifikasi keberadaan bucket Cloud Storage yang ditentukan di kolom bernama options.screenshot_options.storage_location.

• Lihat log yang terkait dengan fungsi Cloud Run Anda. Untuk mengetahui informasi selengkapnya, lihat Menemukan log.

• Pastikan akun layanan yang digunakan dalam fungsi Cloud Run yang sesuai memiliki peran Identity and Access Management yang memungkinkannya membuat, mengakses, dan menulis ke bucket Cloud Storage.