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.

Fitur ini hanya didukung untuk project Google Cloud.

Sebelum memulai

Selesaikan langkah-langkah berikut di project Google Cloud yang menyimpan monitor sintetis Anda:

  • 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:

    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.

  • Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init

    Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.

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. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. 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 --project=PROJECT_ID

Sebelum menjalankan perintah sebelumnya, ganti hal berikut:

  • PROJECT_ID: ID project.

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.

REST

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. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. 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 --project=PROJECT_ID

Sebelum menjalankan perintah sebelumnya, ganti hal berikut:

  • PROJECT_ID: ID project.
  • CHECK_ID: 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.

REST

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 ID project Google Cloud Anda.
    • 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

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. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.
  3. Cari monitor sintetis yang ingin diedit, klik More options, lalu pilih Edit.

  4. 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.

  5. 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 --project=PROJECT_ID

Sebelum menjalankan perintah sebelumnya, ganti hal berikut:

  • PROJECT_ID: ID project.

  • CHECK_ID: ID pemeriksaan waktu aktif atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs dan memeriksa kolom name. Untuk 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 --project=PROJECT_ID

REST

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

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

  1. Klik projects.uptimeCheckConfigs.patch.

  2. Gunakan API Explorer.

    1. Tetapkan induk metode ke ID monitor sintetis, ID memiliki format berikut:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID

      Dalam ekspresi sebelumnya:

      • PROJECT_ID adalah project ID Anda.
      • 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, 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 project Google Cloud Anda.

  3. 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.

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

  5. 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.

REST

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

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. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda.

  3. Cari monitor sintetis yang ingin Anda hapus, lalu klik namanya.

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

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

    Sekarang Anda telah menghapus monitor sintetis.

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

gcloud

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

gcloud monitoring uptime delete CHECK_ID  --project=PROJECT_ID

Sebelum menjalankan perintah sebelumnya, ganti hal berikut:

  • PROJECT_ID: ID project.
  • CHECK_ID: 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.

REST

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 Anda.
    • 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