Mengelola monitor sintetis

Dokumen ini menjelaskan cara mengelola monitor sintetis. Anda dapat melihat daftar monitor sintetis, dan untuk setiap monitor sintetis, Anda dapat melihat dan mengubah konfigurasi, melihat histori eksekusi, dan melihat detail tentang setiap eksekusi. Anda dapat mengelola monitor sintetis menggunakan konsol Google Cloud atau menggunakan Cloud Monitoring API.

Untuk informasi tentang cara menjelajahi hasil eksekusi serta metrik dan log untuk monitor sintetis, lihat Menjelajahi hasil monitor sintetis.

Sebelum memulai

• Untuk mendapatkan izin yang diperlukan guna melihat dan mengubah monitor sintetis menggunakan konsol Google Cloud, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

  • Monitoring Editor (roles/monitoring.editor)
  • Cloud Functions Developer (roles/cloudfunctions.developer)

  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.

• Petunjuk API di halaman ini ditujukan untuk API Explorer. Namun, Anda juga dapat mengeluarkan perintah curl. API Explorer menyediakan sintaksis curl.

Mencantumkan monitor sintetis

Konsol

Untuk mencantumkan monitor sintetis di project Google Cloud Anda, 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. Opsional: Untuk membatasi monitor sintetis yang tercantum, tambahkan filter.

   Setiap filter terdiri dari nama dan nilai. Anda dapat menetapkan nilai agar cocok persis dengan nama monitor sintetis atau pencocokan sebagian. Pencocokan tidak peka huruf besar/kecil. Misalnya, untuk mencantumkan semua monitor sintetis yang namanya berisi default, lakukan hal berikut:

   • Klik Filter tabel, lalu pilih Nama tampilan.
   • Masukkan default, lalu tekan tombol kembali.

   Jika Anda memiliki beberapa filter, filter akan otomatis digabungkan oleh AND logis kecuali jika Anda menyisipkan filter OR. Contoh sebelumnya menggunakan filter OR sehingga pemeriksaan waktu aktif tercantum jika namanya cocok dengan default atau Testing check.

Halaman Monitor sintetis menampilkan hal berikut untuk setiap monitor sintetis:

• Status eksekusi terbaru.
• Link ke informasi mendetail tentang monitor sintetis tersebut.
• Rasio keberhasilan dan waktu eksekusi rata-rata.
• Jumlah kebijakan pemberitahuan.
• Untuk mengedit, menyalin, atau menghapus monitor sintetis, dan membuat kebijakan pemberitahuan, gunakan menu Opsi lainnya .

gcloud

Untuk menampilkan daftar pemeriksaan uptime dan monitor sintetis, jalankan perintah gcloud monitoring uptime list-configs:

gcloud monitoring uptime list-configs

Data yang ditampilkan mencakup hal berikut:

• Nama dan nama tampilan.
• Periksa ID.
• Resource yang dimonitor.
• Periode antara pemeriksaan.

Anda dapat mengonfigurasi perintah Google Cloud CLI untuk memfilter dan mengurutkan hasil.

API

Untuk mencantumkan monitor sintetis di project Google Cloud Anda, termasuk pemeriksaan waktu aktif, panggil metode projects.uptimeCheckConfigs.list:

1. Klik projects.uptimeCheckConfigs.list.

2. Gunakan API Explorer.

   Tetapkan induk metode ke nama project, pastikan Anda menggunakan format berikut:

   projects/PROJECT_ID
   

   Dalam ekspresi sebelumnya, PROJECT_ID adalah project ID Google Cloud Anda.

Untuk monitor sintetis, hasilnya berisi kolom berlabel syntheticMonitor.

Melihat detail monitor sintetis

Konsol

Untuk melihat detail monitor sintetis di project Google Cloud Anda, 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. Untuk membuka halaman Synthetic monitor details, temukan monitor sintetis yang ingin Anda lihat, lalu klik namanya.

   Jika Anda ingin melihat fungsi Cloud Run dari halaman Detail fungsi yang disediakan oleh fungsi Cloud Run, pilih tab Kode, lalu klik nama fungsi. Halaman Detail fungsi akan terbuka di jendela baru. Tab di halaman ini memungkinkan Anda melihat metrik dan log, serta informasi konfigurasi.

gcloud

Untuk mencantumkan detail pemeriksaan waktu aktif atau monitor sintetis, jalankan perintah gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID

Sebelum menjalankan perintah sebelumnya, ganti CHECK_ID dengan ID pemeriksaan waktu aktif atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat Menemukan ID unik monitor sintetis.

Data yang ditampilkan untuk pemeriksaan waktu aktif mencakup hal berikut:

• Nama dan nama tampilan.
• Periksa ID.
• Resource yang dimonitor.
• Periode antara pemeriksaan.

API

Untuk mencantumkan detail monitor sintetis tertentu di project Google Cloud Anda, panggil metode projects.uptimeCheckConfigs.get:

1. Klik projects.uptimeCheckConfigs.get.

2. Gunakan API Explorer.

   Tetapkan parent metode ke ID monitor sintetis, pastikan Anda menggunakan format berikut:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Dalam ekspresi sebelumnya, PROJECT_ID adalah project ID Google Cloud Anda dan CHECK_ID adalah ID monitor sintetis.

   Misalnya, nilai kolom induk mungkin:

   projects/my-project/uptimeCheckConfigs/10863117100295372627
   

   Untuk menemukan nilai CHECK_ID, Anda dapat mengeluarkan metode projects.uptimeCheckConfigs.list. Untuk mengurangi jumlah hasil yang ditampilkan, sertakan filter. Misalnya, tambahkan filter displayName="MySyntheticMonitor".

Mengedit monitor sintetis atau fungsi Cloud Run

Konsol

Catatan: Jika hanya ingin mengubah fungsi Cloud Run, Anda dapat menggunakan halaman Detail fungsi atau halaman Detail monitor sintetis. Dalam kedua kasus tersebut, Anda harus memilih opsi edit, membuat perubahan, lalu men-deploy fungsi Cloud Run yang diubah.

Untuk mengedit monitor sintetis atau fungsi Cloud Run-nya menggunakan halaman Detail monitor sintetis, 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. Cari monitor sintetis yang ingin diedit, klik More options, lalu pilih Edit.

3. Opsional: Untuk mengedit fungsi Cloud Run, klik Edit function, lakukan perubahan, lalu klik Apply function.

   Untuk pemeriksa link rusak, guna mengubah URI asal atau opsi yang menentukan link mana yang diuji, edit fungsi Cloud Run, lalu perbarui objek options dalam file index.js. Untuk mengetahui informasi tentang kolom dan sintaksis untuk objek ini, lihat broken-links-ok/index.js.

4. Untuk mempertahankan modifikasi, klik Simpan. Jika tidak, klik Batal.

gcloud

Untuk mengubah pemeriksaan uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime update:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS

Sebelum menjalankan perintah sebelumnya, lakukan hal berikut:

• Ganti CHECK_ID dengan ID pemeriksaan waktu aktif atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat Menemukan ID unik pemeriksaan uptime.

• Tentukan kolom yang ingin Anda ubah. Untuk monitor sintetis, Anda hanya dapat memperbarui kolom berikut:

  • Periode
  • Nama tampilan
  • Waktu habis
  • Label pengguna

Misalnya, untuk menetapkan periode monitor sintetis menjadi 10 menit, jalankan perintah berikut:

gcloud monitoring uptime update CHECK_ID --period=10

API

Kebijakan dan fungsi pemberitahuan tidak disertakan dalam monitor sintetis, sehingga tidak dapat diedit dengan prosedur yang dijelaskan di bagian ini:

• Untuk mengubah kebijakan pemberitahuan, gunakan konsol Google Cloud atau panggil metode alertPolicies.patch. Untuk informasi selengkapnya, lihat Mengelola kebijakan pemberitahuan menurut API.

• Untuk mengubah fungsi Cloud Run, setelah memperbarui sumber fungsi, Anda harus men-deploy ulang fungsi tersebut. Untuk informasi selengkapnya, lihat Men-deploy fungsi Cloud Run.

Untuk mengedit monitor sintetis, panggil metode projects.uptimeCheckConfigs.patch:

1. Klik projects.uptimeCheckConfigs.patch.

2. Gunakan API Explorer.

   1. Tetapkan parent metode ke ID monitor sintetis, pastikan Anda menggunakan format berikut:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Dalam ekspresi sebelumnya, PROJECT_ID adalah project ID Google Cloud Anda dan CHECK_ID adalah ID monitor sintetis.

      Untuk menemukan nilai CHECK_ID, Anda dapat mengeluarkan metode projects.uptimeCheckConfigs.list. Untuk mengurangi jumlah hasil yang ditampilkan, sertakan filter. Misalnya, tambahkan filter displayName="MySyntheticMonitor".

   2. Tetapkan parameter kueri metode, updateMask, untuk mengidentifikasi kolom mana dalam objek yang sedang diubah. Misalnya, untuk memperbarui nilai displayName, parameter kueri adalah sebagai berikut:

      updateMask=displayName
      

Menyalin monitor sintetis

Konsol

Untuk menyalin monitor sintetis di project Google Cloud Anda, 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. Cari monitor sintetis yang ingin Anda edit, klik Opsi lainnya, lalu pilih Salin.

   Dialog Copy Synthetic Check akan terbuka dengan kolom yang telah diisi sebelumnya, termasuk salinan fungsi Cloud Run.

3. Klik Create function, perbarui fungsi sesuai kebutuhan, lalu klik Apply function.

4. Untuk mempertahankan modifikasi, klik Create. Jika tidak, klik Batal.

   Saat Anda mengklik Create, fungsi Cloud Run akan dibuat dan di-deploy, lalu monitor sintetis akan dibuat.

gcloud

Tidak ada metode Google Cloud CLI yang memungkinkan Anda menyalin monitor sintetis.

API

Tidak ada metode API yang memungkinkan Anda menyalin monitor sintetis. Namun, Anda dapat membuat salinan dengan melakukan langkah-langkah berikut:

1. Panggil metode projects.uptimeCheckConfigs.get dan simpan respons. Untuk mengetahui informasi selengkapnya, lihat Melihat detail monitor sintetis.
2. Edit respons.
3. Panggil metode projects.uptimeCheckConfigs.create dan teruskan respons yang diedit ke metode.

Menghapus monitor sintetis

Konsol

Catatan: Saat menghapus pemeriksaan waktu aktif atau monitor sintetis menggunakan Konsol Google Cloud, Anda juga akan menghapus kebijakan pemberitahuan terkait. Namun, menghapus monitor sintetis tidak akan menghapus fungsi Cloud Run.

Untuk menghapus monitor sintetis dan kebijakan pemberitahuan terkait, lakukan langkah 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. Cari monitor sintetis yang ingin Anda hapus, lalu klik namanya.

3. Opsional: Jika Anda ingin menghapus fungsi Cloud Run, pilih tab Code, lalu klik nama fungsi. Halaman Detail fungsi akan terbuka di jendela baru.

4. Di halaman Detail monitor sintetis, klik Hapus, lalu selesaikan dialog.

   Anda sekarang telah menghapus monitor sintetis.

5. Untuk menghapus fungsi Cloud Run, buka halaman Detail fungsi, klik Hapus, lalu selesaikan dialog.

gcloud

Catatan: Anda tidak dapat menghapus pemeriksaan uptime atau monitor sintetis menggunakan Google Cloud CLI atau Cloud Monitoring API jika ada kebijakan pemberitahuan yang terkait dengan pemeriksaan uptime atau monitor sintetis tersebut. Anda harus menghapus kebijakan pemberitahuan terlebih dahulu. Menghapus monitor sintetis tidak akan menghapus fungsi Cloud Run.

Untuk menghapus pemeriksaan uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime delete:

gcloud monitoring uptime delete CHECK_ID

Sebelum menjalankan perintah sebelumnya, ganti CHECK_ID dengan ID pemeriksaan waktu aktif atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat Menemukan ID unik monitor sintetis.

API

Catatan: Anda tidak dapat menghapus pemeriksaan uptime atau monitor sintetis menggunakan Google Cloud CLI atau Cloud Monitoring API jika ada kebijakan pemberitahuan yang terkait dengan pemeriksaan uptime atau monitor sintetis tersebut. Anda harus menghapus kebijakan pemberitahuan terlebih dahulu. Menghapus monitor sintetis tidak akan menghapus fungsi Cloud Run.

Untuk menghapus monitor sintetis dan kebijakan pemberitahuan terkait, panggil metode projects.uptimeCheckConfigs.delete:

1. Klik projects.uptimeCheckConfigs.delete.

2. Gunakan API Explorer.

   Tetapkan parent metode ke ID monitor sintetis, pastikan Anda menggunakan format berikut:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Dalam ekspresi sebelumnya, PROJECT_ID adalah project ID Google Cloud Anda dan CHECK_ID adalah ID monitor sintetis.

   Untuk menemukan nilai CHECK_ID, Anda dapat mengeluarkan metode projects.uptimeCheckConfigs.list. Untuk mengurangi jumlah hasil yang ditampilkan, sertakan filter. Misalnya, tambahkan filter displayName="MySyntheticMonitor".

Menemukan ID unik monitor sintetis

Saat monitor sintetis dibuat, Monitoring akan menetapkan ID ke monitor tersebut. ID ini disematkan dalam nama resource untuk monitor sintetis dan memiliki bentuk:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

CHECK_ID disertakan dalam respons metode Google Cloud CLI dan Cloud Monitoring API yang membuat atau mencantumkan monitor sintetis.

Langkah selanjutnya

• Membuat monitor sintetis
• Menjelajahi hasil monitor sintetis