Membuat monitor sintetis

Konsol

Saat Anda membuat monitor sintetis menggunakan Konsol Google Cloud, Cloud Function (generasi ke-2) baru akan di-deploy dan monitor untuk Cloud Function tersebut akan dibuat. Anda tidak dapat membuat monitor sintetis yang memantau Cloud Function yang ada.

1. Pastikan Anda telah mengaktifkan API yang diperlukan, dan project Anda berisi akun layanan Compute Engine default, dan akun ini telah diberi peran Editor (roles/editor). Untuk informasi selengkapnya, lihat Sebelum memulai.

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

   Buka Pemantauan sintetis

3. Pilih Create Synthetic Monitor.

4. Pilih template untuk Cloud Function Anda:

   • Monitor sintetis kustom: Gunakan template ini jika Anda ingin mengumpulkan data log atau data trace untuk permintaan HTTP keluar.

   • Monitor sintetis Mocha: Gunakan template ini saat menulis rangkaian pengujian Mocha.

   • Pemeriksa link rusak: Gunakan template ini untuk menguji URI dan jumlah link yang dapat dikonfigurasi yang ada di URI tersebut. Untuk mengetahui informasi tentang kolom pemeriksa ini, lihat Membuat pemeriksa link rusak.

5. Masukkan nama untuk monitor.

6. Opsional: Perbarui Response Timeout, Check Frequency, dan tambahkan label yang ditentukan pengguna.

7. Lakukan salah satu hal berikut:

   • Jika Anda memiliki akses ke Gemini Code Assist dalam project ini dan ingin bantuan dalam menulis kode, klik Bantu saya menulis kode. Fitur ini ada dalam Pratinjau Publik. Untuk panduan tentang perintah, lihat Pelajari cara menulis perintah untuk monitor sintetis.

     Setelah puas dengan kodenya, klik Insert into Cloud Function.

   • Klik Buat fungsi.

8. Dalam dialog Cloud Function, lakukan hal berikut:

   1. Masukkan nama tampilan dan pilih wilayah. Nama harus unik di dalam suatu wilayah.

   2. Di bagian Runtime, build, connections and security settings, lakukan langkah berikut:

      • Di tab Connections, pastikan Allow all traffic dipilih.

      • Tinjau setelan default dan perbarui jika perlu.

      • Di kolom Runtime service account, pilih akun layanan.

      1. Edit kode yang dihasilkan, atau tulis atau upload kode untuk Cloud Function Anda:

         • Untuk mengedit kode yang dihasilkan, masukkan kode Anda sendiri, atau muat fungsi contoh default, lalu pilih Inline Editor. Fungsi contoh, yang bergantung pada template yang Anda pilih sebelumnya, mengirimkan permintaan ke URL tertentu. Anda dapat mengubah fungsi default.

         • Untuk memuat file ZIP dari sistem lokal, pilih Upload ZIP.

         Jika mengupload file zip dari sistem lokal, Anda juga harus menentukan bucket Cloud Storage untuk file ZIP tersebut. Jika Anda belum memiliki bucket Cloud Storage yang sesuai, buatlah bucket Cloud Storage.

         • Untuk memuat file zip dari Cloud Storage Anda, pilih ZIP from Cloud Storage, pilih bucket penyimpanan, lalu pilih file zip yang akan dimuat.

         Anda juga dapat membuat Cloud Function menggunakan halaman Cloud Functions di Konsol Google Cloud. Untuk membuat monitor sintetis yang memantau salinan Cloud Function tersebut, buka tab Source, lalu klik Download zip. Anda kemudian dapat mengupload file ZIP.

      2. Klik Terapkan fungsi.

9. Konfigurasikan kebijakan pemberitahuan:

   1. Opsional: Perbarui nama kebijakan pemberitahuan dan durasi kegagalan sebelum notifikasi dikirim.

   2. Tambahkan saluran notifikasi.

10. Klik Create.

    Cloud Function yang Anda tentukan telah dibuat dan di-deploy sebagai generasi ke-2, dan monitor sintetis dibuat.

gcloud

Saat membuat monitor sintetis menggunakan Google Cloud CLI atau Cloud Monitoring API, Anda akan meneruskan nama fungsi ke panggilan API. Oleh karena itu, Anda hanya dapat membuat monitor sintetis yang memantau Cloud Function yang ada.

1. Pastikan Anda telah mengaktifkan API yang diperlukan, dan project Anda berisi akun layanan Compute Engine default, dan akun ini telah diberi peran Editor (roles/editor). Untuk informasi selengkapnya, lihat Sebelum memulai.
2. Tulis dan deploy Cloud Function generasi ke-2.

   Misalnya, untuk men-deploy contoh synthetics-sdk-nodejs di repositori Google Cloud/synthetics-sdk-nodejs, lakukan hal berikut:

   1. Clone repositori dan buka lokasi kode sumber:

      git clone https://github.com/GoogleCloudPlatform/synthetics-sdk-nodejs.git
      cd synthetics-sdk-nodejs/samples/generic-synthetic-nodejs
      

   2. Deploy Cloud Function menggunakan perintah gcloud functions deploy:

      gcloud functions deploy FUNCTION_NAME \
      --gen2 --region="us-west2" --source="." \
      --entry-point=SyntheticFunction --trigger-http --runtime=nodejs18
      

      Dalam perintah gcloud functions deploy, lakukan hal berikut:

      • Pastikan nilai kolom FUNCTION_NAME unik di region deployment-nya.

      • Sertakan flag --gen2 dan tetapkan region deployment.

      • Tetapkan kolom --entry-point sebagai berikut:

        • Moka: SyntheticMochaSuite
        • Bukan Mocha: SyntheticFunction.

      • Tetapkan kolom --runtime ke nodejs18.

      • Menyertakan flag --trigger-http.

      • Kolom --ingress-settings harus dibiarkan tidak ditentukan atau ditetapkan ke all.

      Cloud Functions membangun lalu men-deploy Cloud Function Anda. Hasil perintah Google Cloud CLI mencakup informasi tentang fungsi, termasuk nama yang sepenuhnya memenuhi syarat:

      name: projects/PROJECT_ID/locations/REGION/functions/FUNCTION_NAME
      

      Untuk informasi selengkapnya tentang men-deploy fungsi, lihat Men-deploy Cloud Function.

   Untuk menampilkan daftar Cloud Functions di project Google Cloud, gunakan perintah gcloud functions list:

   gcloud functions list
   

   Respons panggilan ini adalah entri daftar, setiap entri mencantumkan Cloud Function:

   NAME: function-1
   STATE: ACTIVE
   TRIGGER: HTTP Trigger
   REGION: us-west2
   ENVIRONMENT: 2nd gen
   

   Agar dapat menemukan nama yang sepenuhnya memenuhi syarat untuk Cloud Function tertentu, jalankan perintah gcloud monitoring uptime describe.

3. Untuk membuat monitor sintetis, jalankan perintah gcloud monitoring uptime create:

   gcloud monitoring uptime create DISPLAY_NAME --synthetic-target=TARGET
   

   Sebelum Anda menjalankan perintah sebelumnya, lakukan hal berikut:

   • Ganti DISPLAY_NAME dengan nama monitor sintetis Anda.
   • Ganti TARGET dengan nama Cloud Function Anda yang sepenuhnya memenuhi syarat.

4. Buat kebijakan pemberitahuan.

   Karena kompleksitas konfigurasi kebijakan pemberitahuan, sebaiknya buka halaman Synthetic monitors di Google Cloud Console, dan gunakan opsi untuk membuat kebijakan pemberitahuan. Dengan pendekatan ini, sebagian besar kolom kebijakan pemberitahuan diisi untuk Anda. Untuk membuat kebijakan pemberitahuan menggunakan Konsol Google Cloud, klik Create policy dari halaman Synthetic monitor.

   Jika Anda berencana menggunakan Google Cloud CLI atau Cloud Monitoring API, konfigurasikan filter kondisi sebagai berikut:

   "filter": "resource.type = \"cloud_run_revision\" AND
               metric.type = \"monitoring.googleapis.com/uptime_check/check_passed\" AND
               metric.labels.check_id = \"CHECK_ID\"",
   

   Kondisi ini memantau seri waktu uptime_check/check_passed yang ditulis oleh monitor sintetis Anda. Pastikan untuk mengganti CHECK_ID dengan ID monitor sintetis, dan yang disertakan dalam data respons perintah create.

   Untuk mengetahui informasi tentang cara membuat kebijakan pemberitahuan, lihat Membuat kebijakan pemberitahuan menggunakan API.

API

Saat membuat monitor sintetis menggunakan Google Cloud CLI atau Cloud Monitoring API, Anda akan meneruskan nama fungsi ke panggilan API. Oleh karena itu, Anda hanya dapat membuat monitor sintetis yang memantau Cloud Function yang ada.

1. Pastikan Anda telah mengaktifkan API yang diperlukan, dan project Anda berisi akun layanan Compute Engine default, dan akun ini telah diberi peran Editor (roles/editor). Untuk informasi selengkapnya, lihat Sebelum memulai.
2. Tulis dan deploy Cloud Function generasi ke-2.

   Misalnya, untuk men-deploy contoh synthetics-sdk-nodejs di repositori Google Cloud/synthetics-sdk-nodejs, lakukan hal berikut:

   1. Clone repositori dan buka lokasi kode sumber:

      git clone https://github.com/GoogleCloudPlatform/synthetics-sdk-nodejs.git
      cd synthetics-sdk-nodejs/samples/generic-synthetic-nodejs
      

   2. Deploy Cloud Function menggunakan perintah gcloud functions deploy:

      gcloud functions deploy FUNCTION_NAME \
      --gen2 --region="us-west2" --source="." \
      --entry-point=SyntheticFunction --trigger-http --runtime=nodejs18
      

      Dalam perintah gcloud functions deploy, lakukan hal berikut:

      • Pastikan nilai kolom FUNCTION_NAME unik di region deployment-nya.

      • Sertakan flag --gen2 dan tetapkan region deployment.

      • Tetapkan kolom --entry-point sebagai berikut:

        • Moka: SyntheticMochaSuite
        • Bukan Mocha: SyntheticFunction.

      • Tetapkan kolom --runtime ke nodejs18.

      • Menyertakan flag --trigger-http.

      • Kolom --ingress-settings harus dibiarkan tidak ditentukan atau ditetapkan ke all.

      Cloud Functions membangun lalu men-deploy Cloud Function Anda. Hasil perintah Google Cloud CLI mencakup informasi tentang fungsi, termasuk nama yang sepenuhnya memenuhi syarat:

      name: projects/PROJECT_ID/locations/REGION/functions/FUNCTION_NAME
      

      Untuk informasi selengkapnya tentang men-deploy fungsi, lihat Men-deploy Cloud Function.

   Untuk menampilkan daftar Cloud Functions di project Google Cloud, gunakan perintah gcloud functions list:

   gcloud functions list
   

   Respons panggilan ini adalah entri daftar, setiap entri mencantumkan Cloud Function:

   NAME: function-1
   STATE: ACTIVE
   TRIGGER: HTTP Trigger
   REGION: us-west2
   ENVIRONMENT: 2nd gen
   

   Agar dapat menemukan nama yang sepenuhnya memenuhi syarat untuk Cloud Function tertentu, jalankan perintah gcloud monitoring uptime describe.

3. Untuk membuat monitor sintetis, lakukan hal berikut:

   1. Klik projects.uptimeCheckConfigs.create untuk membuka halaman referensi API untuk metode tersebut.
   2. Klik Try it untuk membuka APIs Explorer.

   3. Tetapkan kolom berikut, lalu jalankan perintah.

      • Kolom induk: projects/PROJECT_ID.

      • Dalam isi permintaan, tentukan hal berikut:

        • displayName: Menyetel ke nama tampilan monitor sintetis Anda.
        • syntheticMonitor: Tetapkan ke nama Cloud Function Anda yang sepenuhnya memenuhi syarat.

      Jika berhasil, respons panggilan API serupa dengan berikut ini:

      {
      "name": "projects/myproject/uptimeCheckConfigs/17272586127463315332",
      "displayName": "MyMonitor",
      ...
      "syntheticMonitor": {
       "cloudFunctionV2": {
          "name": "projects/myproject/locations/us-west2/functions/function-1",
          "cloudRunRevision": {
          "type": "cloud_run_revision",
          "labels": {
             "project_id": "myproject",
             "configuration_name": "",
             "location": "us-west2",
             "revision_name": "",
             "service_name": "function-1"
          }
          }
       }
      }
      }
      

4. Buat kebijakan pemberitahuan.

   Karena kompleksitas konfigurasi kebijakan pemberitahuan, sebaiknya buka halaman Synthetic monitors di Google Cloud Console, dan gunakan opsi untuk membuat kebijakan pemberitahuan. Dengan pendekatan ini, sebagian besar kolom kebijakan pemberitahuan diisi untuk Anda. Untuk membuat kebijakan pemberitahuan menggunakan Konsol Google Cloud, klik Create policy dari halaman Synthetic monitor.

   Jika Anda berencana menggunakan Google Cloud CLI atau Cloud Monitoring API, konfigurasikan filter kondisi sebagai berikut:

   "filter": "resource.type = \"cloud_run_revision\" AND
               metric.type = \"monitoring.googleapis.com/uptime_check/check_passed\" AND
               metric.labels.check_id = \"CHECK_ID\"",
   

   Kondisi ini memantau seri waktu uptime_check/check_passed yang ditulis oleh monitor sintetis Anda. Pastikan untuk mengganti CHECK_ID dengan ID monitor sintetis, dan yang disertakan dalam data respons perintah create.

   Untuk mengetahui informasi tentang cara membuat kebijakan pemberitahuan, lihat Membuat kebijakan pemberitahuan menggunakan API.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.

Untuk membuat monitor sintetis dan kebijakan pemberitahuan untuk memantau pemeriksaan tersebut, lakukan langkah berikut:

1. Pastikan Anda telah mengaktifkan API yang diperlukan, dan project Anda berisi akun layanan Compute Engine default, dan akun ini telah diberi peran Editor (roles/editor). Untuk informasi selengkapnya, lihat Sebelum memulai.

2. Edit file konfigurasi Terraform dan tambahkan resource google_storage_bucket, lalu terapkan perubahan Anda.

   Kode berikut menentukan bucket Cloud Storage di lokasi US:

   resource "google_storage_bucket" "gcf_source" {
      name = "gcf-v2-source-9948673986912-us"
      location = "US"
      uniform_bucket_level_access = true
   }
   

3. Edit file konfigurasi Terraform dan tambahkan resource google_storage_bucket_object, lalu terapkan perubahan Anda.

   Resource ini menentukan nama objek di bucket Anda, dan lokasi file ZIP di sistem lokal Anda. Misalnya, saat Anda menerapkan kode berikut, file dengan nama example-function.zip akan ditambahkan ke bucket penyimpanan Anda:

   resource "google_storage_bucket_object" "object" {
      name = "example-function.zip"
      bucket = google_storage_bucket.gcf_source.name
      source = "generic-synthetic-node.js.zip"
   }
   

4. Edit file konfigurasi Terraform dan tambahkan resource google_cloudfunctions2_function, lalu terapkan perubahan Anda.

   Pastikan resource google_cloudfunctions2_function Anda menentukan runtime Node.js dan titik entri yang digunakan oleh monitor sintetis. Misalnya, saat Anda menerapkan kode berikut, fungsi dengan nama sm-central1 akan di-deploy:

   resource "google_cloudfunctions2_function" "central1" {
      name = "sm-central1"
      location = "us-central1"
   
      build_config {
         runtime = "nodejs20"
         entry_point = "SyntheticFunction"
         source {
               storage_source {
                  bucket = google_storage_bucket.gcf_source.name
                  object = google_storage_bucket_object.object.name
               }
         }
      }
   
      service_config {
         max_instance_count = 1
         available_memory = "256Mi"
         timeout_seconds  = 60
      }
   }
   

5. Untuk membuat monitor sintetis, edit file konfigurasi Terraform dan tambahkan resource google_monitoring_uptime_check_config, lalu terapkan perubahan Anda.

   Untuk resource ini, tentukan blok synthetic_monitor:

   resource "google_monitoring_uptime_check_config" "synthetic" {
      display_name = "sm-central1"
      timeout = "30s"
   
      synthetic_monitor {
         cloud_function_v2 {
               name = google_cloudfunctions2_function.central1.id
         }
      }
   }
   

6. Opsional: Buat saluran notifikasi dan kebijakan pemberitahuan.

   Langkah-langkah berikut menggunakan konsol Google Cloud untuk membuat saluran notifikasi dan kebijakan pemberitahuan. Pendekatan ini memastikan bahwa kebijakan pemberitahuan hanya memantau data yang dihasilkan oleh monitor sintetis Anda.

   1. Untuk membuat saluran notifikasi, lakukan hal berikut:

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

         Buka Alerting

      2. Pilih Kelola saluran notifikasi.
      3. Buka jenis saluran yang ingin ditambahkan, klik Add, lalu selesaikan dialog.

   2. Untuk membuat kebijakan pemberitahuan, lakukan langkah berikut:

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

         Buka Pemantauan sintetis

      2. Temukan monitor sintetis Anda, pilih more_vert Lainnya, lalu pilih Tambahkan kebijakan pemberitahuan.
      3. Pada dialog yang muncul, buka bagian Notifikasi dan nama, luaskan Saluran Notifikasi, lalu tentukan pilihan Anda.
      4. Beri nama kebijakan pemberitahuan, lalu klik Create policy.