Kelola monitor sintetis

Dokumen ini menjelaskan cara mengelola monitor sintetis Anda. 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 Cloud Monitoring API.

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

Sebelum memulai

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

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

  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.

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

Mencantumkan monitor sintetis

Konsol

Untuk mencantumkan monitor sintetis di project Google Cloud, lakukan langkah berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Synthetic Monitoring:

   Buka Pemantauan sintetis

2. Opsional: Untuk membatasi monitor sintetis yang tercantum, tambahkan filter.

   Setiap filter terdiri dari nama dan nilai. Anda dapat menetapkan nilai ke pencocokan persis untuk nama monitor sintetis atau kecocokan sebagian. Kecocokan tidak peka huruf besar/kecil. Misalnya, untuk menampilkan daftar 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 yang logis, kecuali jika Anda menyisipkan filter OR. Contoh sebelumnya menggunakan filter OR sehingga cek uptime akan dicantumkan jika namanya cocok dengan default atau Testing check.

Halaman Synthetic monitors menampilkan hal berikut untuk setiap monitor sintetis:

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

gcloud

Untuk mencantumkan cek 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 dipantau.
• Periode di antara pemeriksaan.

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

API

Untuk mencantumkan monitor sintetis dalam project Google Cloud, termasuk cek uptime, panggil metode projects.uptimeCheckConfigs.list:

1. Klik projects.uptimeCheckConfigs.list.

2. Menggunakan APIs Explorer.

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

   projects/PROJECT_ID
   

   Di 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, lakukan langkah berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Synthetic Monitoring:

   Buka Pemantauan sintetis

2. Untuk membuka halaman Detail monitor sintetis, cari monitor sintetis yang ingin Anda lihat, lalu klik namanya.

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

gcloud

Untuk mencantumkan detail cek uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID

Sebelum menjalankan perintah sebelumnya, ganti CHECK_ID dengan ID cek uptime 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 cek uptime mencakup hal berikut:

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

API

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

1. Klik projects.uptimeCheckConfigs.get.

2. Menggunakan APIs Explorer.

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

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Di 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 Cloud Function

Konsol

Catatan: Jika hanya ingin mengubah Cloud Function, Anda dapat menggunakan halaman Detail Function atau halaman Detail monitor sintetis. Pada kedua kasus tersebut, Anda harus memilih opsi edit, melakukan perubahan, lalu men-deploy Cloud Function yang telah diubah.

Untuk mengedit monitor sintetis atau Cloud Function-nya menggunakan halaman Detail monitor sintetis, lakukan tindakan berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Synthetic Monitoring:

   Buka Pemantauan sintetis

2. Temukan monitor sintetis yang ingin Anda edit, klik Opsi lainnya, lalu pilih Edit.

3. Opsional: Untuk mengedit Cloud Function, klik Edit function, buat perubahan, lalu klik Apply function.

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

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

gcloud

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

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS

Sebelum Anda menjalankan perintah sebelumnya, lakukan hal berikut:

• Ganti CHECK_ID dengan ID cek uptime 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 cek uptime.

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

  • Periode
  • Nama tampilan
  • Timeout
  • 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 terdapat di 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 mengetahui informasi selengkapnya, lihat Mengelola kebijakan pemberitahuan dengan API.

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

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

1. Klik projects.uptimeCheckConfigs.patch.

2. Menggunakan APIs Explorer.

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

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Di 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 diubah. Misalnya, untuk mengupdate nilai displayName, parameter kuerinya adalah sebagai berikut:

      updateMask=displayName
      

Menyalin monitor sintetis

Konsol

Untuk menyalin monitor sintetis di project Google Cloud, lakukan langkah berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Synthetic Monitoring:

   Buka Pemantauan sintetis

2. Temukan monitor sintetis yang ingin Anda edit, klik Opsi lainnya, lalu pilih Salin.

   Dialog Copy Synthetic Check akan terbuka dengan kolom yang telah diisi otomatis, termasuk salinan Cloud Function.

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

4. Untuk menyimpan perubahan, klik Buat. Jika tidak, klik Batal.

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

gcloud

Tidak ada metode Google Cloud CLI yang dapat digunakan untuk 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 responsnya. Untuk informasi selengkapnya, baca Melihat detail monitor sintetis.
2. Edit respons.
3. Panggil metode projects.uptimeCheckConfigs.create dan teruskan respons yang diedit ke metode tersebut.

Menghapus monitor sintetis

Konsol

Catatan: Jika Anda menghapus cek uptime atau monitor sintetis menggunakan Konsol Google Cloud, Anda juga akan menghapus kebijakan pemberitahuan terkait. Namun, menghapus monitor sintetis tidak akan menghapus Cloud Function.

Untuk menghapus monitor sintetis dan kebijakan pemberitahuan terkait, lakukan langkah berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Synthetic Monitoring:

   Buka Pemantauan sintetis

2. Temukan monitor sintetis yang ingin dihapus, lalu klik namanya.

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

4. Di halaman Synthetic monitor details, klik Delete, lalu selesaikan dialog.

   Sekarang Anda telah menghapus monitor sintetis.

5. Untuk menghapus Cloud Function, buka halaman Functions details, klik Delete, lalu selesaikan dialog.

gcloud

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

Untuk menghapus cek 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 cek uptime 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 cek uptime atau monitor sintetis menggunakan Google Cloud CLI atau Cloud Monitoring API jika ada kebijakan pemberitahuan yang terkait dengan cek uptime atau monitor sintetis tersebut. Anda harus menghapus kebijakan pemberitahuan terlebih dahulu. Menghapus monitor sintetis tidak akan menghapus Cloud Function.

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

1. Klik projects.uptimeCheckConfigs.delete.

2. Menggunakan APIs Explorer.

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

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Di 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 menetapkannya sebagai ID. ID ini disematkan dalam nama resource untuk monitor sintetis dan berbentuk:

projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

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

Langkah selanjutnya

• Membuat monitor sintetis
• Menjelajahi hasil monitor sintetis