Membuat dan mengelola saluran notifikasi

Dokumen ini menjelaskan cara mengonfigurasi saluran notifikasi menggunakan Konsol Google Cloud. Cloud Monitoring menggunakan saluran ini untuk memberi tahu Anda, atau tim siaga, saat kebijakan pemberitahuan diaktifkan. Saat membuat kebijakan pemberitahuan, Anda memilih siapa yang akan menerima notifikasi dengan menentukan pilihan dari daftar saluran notifikasi yang dikonfigurasi. Misalnya, Anda dapat mengonfigurasi kebijakan pemberitahuan yang memantau instance Compute Engine untuk memublikasikan topik Pub/Sub dan memberi tahu saluran Slack untuk tim siaga.

Untuk mengetahui informasi selengkapnya, lihat Latensi notifikasi dan Notifikasi per insiden.

Dokumen ini menjelaskan cara menggunakan konsol Google Cloud. Jika Anda menggunakan Cloud Monitoring API, lihat Membuat dan mengelola saluran notifikasi dengan API.

Catatan: Data yang dikirimkan ke penerima channel mungkin berisi informasi sensitif. Tinjau praktik peraturan Anda sebelum membuat saluran notifikasi.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna melihat dan mengonfigurasi saluran notifikasi menggunakan Konsol Google Cloud, minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya tentang peran Cloud Monitoring, baca artikel Mengontrol akses dengan Identity and Access Management.

Membuat saluran notifikasi

Saat membuat kebijakan pemberitahuan, Anda dapat memilih saluran notifikasi yang dikonfigurasi dan menambahkannya ke kebijakan Anda. Anda dapat mengonfigurasi saluran notifikasi di awal, atau mengonfigurasinya sebagai bagian dari proses pembuatan kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Membuat channel on demand.

Catatan: Sebaiknya Anda membuat beberapa saluran notifikasi untuk tujuan redundansi. Google tidak memiliki kontrol atas berbagai sistem pengiriman setelah kami meneruskan notifikasi ke sistem tersebut. Selain itu, satu layanan Google mendukung Cloud Mobile App, PagerDuty, Webhooks, dan Slack. Jika Anda menggunakan salah satu saluran notifikasi ini, gunakan email, SMS, atau Pub/Sub sebagai saluran redundan.

Untuk membuat saluran notifikasi menggunakan Konsol Google Cloud, ikuti petunjuk khusus saluran yang ada dalam tabel berikut:

Email

Untuk menambahkan saluran notifikasi email, lakukan langkah-langkah berikut:

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

   Buka Alerting

2. Klik Edit saluran notifikasi.
3. Di bagian Email, klik Tambahkan baru.
4. Masukkan satu alamat email dan deskripsi.
5. Klik Save.

Jika Anda menggunakan alamat email grup sebagai saluran notifikasi untuk kebijakan pemberitahuan, konfigurasikan grup untuk menerima email dari [e-mail].

Anda dapat membuat saluran email saat membuat kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Membuat channel on demand.

Apl Seluler

Gunakan Aplikasi Seluler Konsol Google Cloud untuk memantau resource Konsol Google Cloud dan informasi Monitoring dari mana saja. Notifikasi Aplikasi Seluler Google Cloud Console dikirim ke perangkat tertentu atau ke pengguna tertentu:

• Perangkat menunjukkan bahwa notifikasi hanya dikirim ke perangkat tertentu yang membuat saluran notifikasi. Untuk saluran notifikasi cakupan perangkat, kolom Nama tampilan menyertakan informasi perangkat.
• Pengguna menunjukkan bahwa notifikasi dikirim ke semua perangkat Anda yang telah menginstal Aplikasi Seluler Konsol Google Cloud.

Cloud Monitoring menentukan cakupan notifikasi saat saluran dibuat. Anda tidak dapat memilih atau mengubah cakupan.

Untuk mengonfigurasi saluran notifikasi Aplikasi Seluler konsol Google Cloud untuk project Google Cloud tertentu, lakukan langkah berikut:

1. Instal Aplikasi Seluler Konsol Google Cloud dari app store perangkat seluler Anda.

2. Pilih project untuk dilihat di Aplikasi Seluler konsol Google Cloud.

   Setelah Anda memilih project, akan terjadi pertukaran data antara aplikasi dan project Google Cloud yang dipilih. Saluran notifikasi dibuat ketika tidak ada, dan setelah beberapa menit, saluran ini akan dicantumkan di bagian Perangkat Seluler di halaman Notification channels.

Untuk menambahkan perangkat seluler sebagai saluran notifikasi untuk kebijakan pemberitahuan, di bagian Notifications pemberitahuan, pilih Google Cloud Console (seluler), lalu pilih perangkat seluler Anda dari daftar.

PagerDuty

Integrasi dengan PagerDuty memungkinkan sinkronisasi satu arah atau dua arah dengan Monitoring. Terlepas dari konfigurasi Anda, hal berikut berlaku:

• Jika insiden dibuat di Monitoring, insiden akan dibuka di PagerDuty.
• Anda tidak dapat menggunakan PagerDuty untuk menutup insiden di Monitoring.

Jika Anda menggunakan sinkronisasi satu arah dan menyelesaikan insiden di PagerDuty, status insiden di PagerDuty dipisahkan dari status insiden di Monitoring. Intinya, jika Anda menyelesaikan insiden di PagerDuty, insiden tersebut akan ditutup secara permanen di PagerDuty dan tidak dapat dibuka kembali.

Jika Anda menggunakan sinkronisasi dua arah, Monitoring akan mengontrol status yang ditampilkan oleh PagerDuty. Jika Anda menyelesaikan insiden di PagerDuty dan jika Monitoring membuka insiden, insiden tersebut akan dibuka kembali di PagerDuty.

Untuk menyiapkan notifikasi PagerDuty, lakukan hal berikut:

1. Di akun PagerDuty Anda, konfigurasikan integrasi di layanan baru atau tambahkan integrasi ke layanan yang ada.
   1. Buat akun atau login ke akun yang sudah ada.
   2. Buka halaman Layanan.
   • Untuk membuat layanan, lakukan hal berikut:
     1. Klik + Layanan Baru.
     2. Masukkan nama dan deskripsi layanan, lalu klik Berikutnya.
     3. Konfigurasikan kebijakan eskalasi, lalu klik Berikutnya.
     4. Jika akun PagerDuty Anda mendukung pengelompokan pemberitahuan dan pemberitahuan sementara, konfigurasikan, lalu klik Berikutnya.
     5. Di halaman penyiapan integrasi, di toolbar Search for an integration(s), masukkan Events API v1, lalu klik Create Service. Anda kemudian akan kembali ke panel Integrations di layanan baru.
   • Untuk mengedit layanan yang ada, lakukan tindakan berikut:
     1. Pilih layanan dari direktori layanan Anda.
     2. Di halaman layanan, pilih panel Integrations.
     3. Klik + Tambahkan integrasi lain untuk membuka halaman penyiapan integrasi.
     4. Pada halaman penyiapan integrasi, di toolbar Search for an integration(s), masukkan Events API v1, lalu klik Add. Anda kemudian akan kembali ke panel Integrations dari layanan yang telah diedit.
   3. Pada panel Integrations untuk layanan, temukan listingan untuk integrasi baru Anda, luaskan menunya, lalu salin kunci integrasi.
2. Di Cloud Monitoring, tambahkan saluran notifikasi PagerDuty:

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

      Buka Alerting

   2. Klik Edit saluran notifikasi.
   3. Di bagian PagerDuty, klik Add new.
   4. Masukkan Nama Tampilan. Nama ini harus sama dengan nama layanan PagerDuty tempat Anda mengonfigurasi integrasi baru pada Langkah 1.
   5. Masukkan kunci integrasi yang Anda salin di Langkah 1 ke kolom Service Key.
   6. Klik Save.
3. Opsional: Jika Anda ingin mengonfigurasi sinkronisasi dua arah, lakukan hal berikut:
   1. Buka akun PagerDuty Anda.
   2. Pilih Services, lalu pilih nama layanan yang Anda masukkan saat mengonfigurasi integrasi.
   3. Pilih panel Integrations untuk layanan Anda.
   4. Buka bagian Alert and Incident Settings, lalu klik Edit.
   5. Pilih Buat insiden dan pemberitahuan, lalu simpan perubahan Anda.

Saat Anda membuat kebijakan pemberitahuan, pilih PagerDuty di bagian Notifications, lalu pilih konfigurasi PagerDuty Anda.

Paket JSON untuk PagerDuty memiliki format berikut:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Untuk melihat contoh dan skema untuk kolom details, luaskan bagian berikut.

Contoh JSON

Secara default, backend pemberitahuan mencoba membuat paket JSON dengan format versi 1.2. Untuk mengetahui informasi selengkapnya tentang format ini, lihat bagian berikutnya.

Berikut adalah contoh paket tersebut:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Struktur skema, versi 1.2

Bagian ini menjelaskan versi 1.2 dari skema payload. Beberapa kolom mungkin tidak muncul di semua paket yang ditampilkan atau mungkin memiliki nilai kosong, bergantung pada konfigurasi kebijakan pemberitahuan, status insiden, atau resource yang dipantau. Beberapa kolom mengambil struktur tersemat sebagai nilai; struktur ini dijelaskan melalui acuan karena isinya juga dapat bervariasi.

Dalam paket yang ditampilkan, kolom dapat muncul dalam urutan apa pun. Dalam deskripsi berikut, mereka diatur ke dalam grup terkait.

{
  "version": "1.2",
  "incident": {
    
    Informasi tentang insiden.
    
    "incident_id": string, ID yang dihasilkan untuk insiden ini.
    "scoping_project_id": string, project ID yang menghosting cakupan metrik.
    "scoping_project_number": angka, nomor project dari project pencakupan.
    "url": string, URL konsol Google Cloud untuk insiden ini.
    "started_at": angka, waktu (dalam detik Unix epoch) saat insiden dibuka.
    "ended_at": angka, waktu (dalam detik Unix epoch) saat insiden ditutup. Hanya diisi jika state adalah closed.
    "state": string, status insiden: open atau closed. Jika open, maka ended_at adalah null.
    "summary": string, yang menghasilkan ringkasan tekstual dari insiden.
    "apigee_url": string, URL Apigee untuk insiden ini, hanya untuk jenis resource Apigee Environment dan Proxy*.
    "observed_value": string, nilai yang diamati yang memicu/menyelesaikan pemberitahuan, mungkin kosong jika kondisi sudah berakhir.
    
    Informasi tentang referensi yang dipantau tempat insiden dibuka.
    
    "resource": {
      "type": string, ID jenis resource yang dimonitor yang menerima pemberitahuan, misalnya, gce_instance; lihat Daftar resource yang dipantau.
      "labels": pasangan nilai kunci objek untuk label yang terkait dengan resource yang dimonitor.
    },
    "resource_type_display_name": string, nama tampilan jenis resource yang dimonitor.
    "resource_id": string, ID instance resource yang dimonitor, nilai yang sama dengan resource.labels.instance_id.
    "resource_display_name": string, nama tampilan resource yang dimonitor.
    "resource_name": string, nama yang dihasilkan dari resource yang dimonitor ini; terdiri dari nilai dari kolom lain.
    
    Informasi tentang jenis metrik dari data deret waktu.
    
    "metric": {
      "type": string, ID jenis metrik yang menerima pemberitahuan, misalnya, compute.googleapis.com/instance/cpu/utilization; lihat Daftar metrik.
      "displayName": string, nama tampilan jenis metrik.
      "labels": objek, pasangan nilai kunci untuk label yang terkait dengan metrik.
    },
    "metadata": {
      "system_labels": objek, key-value pair untuk label metadata sistem.
      "user_labels": objek, key-value pair untuk label metadata pengguna.
    },
    
    Informasi tentang kondisi dan kebijakan pemberitahuan yang membuka/menyelesaikan insiden.
    Nilainya diambil dari objek AlertPolicy yang relevan.
    
    "policy_name": string, nama tampilan untuk kebijakan pemberitahuan.
    "policy_user_labels": objek, key-value pair untuk setiap label pengguna yang dilampirkan pada kebijakan.
    "documentation": objek, struktur tersemat dari bentuk Documentation.
    "condition": objek, struktur tersemat dari bentuk Condition.
    "condition_name": string, nama tampilan kondisi, nilai yang sama dengan condition.displayName.
    "severity": string, tingkat keparahan insiden. Jika kolom ini tidak ditentukan selama pembuatan kebijakan pemberitahuan, Cloud Monitoring akan menetapkan tingkat keparahan kebijakan pemberitahuan ke No Severity.
    "threshold_value": string, nilai minimum kondisi ini, boleh kosong jika kondisi bukan merupakan kondisi nilai minimum.
  },
}

Kebijakan penghentian penggunaan

Skema payload tunduk pada kebijakan penghentian layanan Google Cloud yang diuraikan dalam Pasal 1.4(d) dari Persyaratan Layanan Google Cloud Platform. Perhatikan bahwa skema tidak mengontrol format nilai kolom yang dihasilkan, dan format ini dapat berubah tanpa pemberitahuan. Misalnya, incident.summary, incident.documentation.content, dan incident.url dimaksudkan untuk menyertakan data yang berkaitan dengan kolomnya, tetapi skema tersebut tidak memiliki batasan untuk menjamin penguraian yang akurat untuk kolom tersebut. Anda dapat menggunakan nilai secara keseluruhan dan mematuhi kebijakan penghentian, tetapi tidak mengandalkan penguraian kolom yang dihasilkan.

SMS

Untuk mengonfigurasi notifikasi SMS, lakukan hal berikut:

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

   Buka Alerting

2. Klik Edit saluran notifikasi.
3. Di bagian SMS, klik Tambahkan baru.
4. Selesaikan dialog, lalu klik Simpan.

Saat menyiapkan kebijakan pemberitahuan, pilih jenis notifikasi SMS dan pilih nomor telepon terverifikasi dari daftar.

Slack

Catatan: Untuk menyelesaikan langkah-langkah ini, Anda harus menjadi Pemilik atau Admin Workspace Slack. Untuk informasi selengkapnya, lihat Mengelola permintaan undangan.

Integrasi Monitoring Slack memungkinkan kebijakan pemberitahuan Anda untuk diposting ke saluran Slack saat insiden baru dibuat. Untuk menyiapkan notifikasi Slack, lakukan hal berikut:

1. Di Slack: Buat saluran dan ruang kerja Slack di situs Slack. Catat URL channel.

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

   Buka Alerting

3. Klik Edit saluran notifikasi.

4. Di bagian Slack, klik Add new untuk membuka halaman login Slack:

   1. Pilih ruang kerja Slack Anda.
   2. Klik Allow untuk mengaktifkan akses Cloud Monitoring ke ruang kerja Slack Anda. Tindakan ini akan membawa Anda kembali ke halaman konfigurasi Monitoring untuk saluran notifikasi.
   3. Di kolom Slack Channel Name, masukkan nama saluran Slack yang ingin Anda gunakan untuk notifikasi.
   4. Di kolom Cloud Alerting Display Name, masukkan pernyataan deskriptif singkat. Monitoring menampilkan nilai kolom ini di halaman Saluran notifikasi.
   5. (Opsional) Untuk menguji koneksi antara Cloud Monitoring dan ruang kerja Slack Anda, klik Send test notifikasi. Jika koneksi berhasil, Anda akan melihat pesan This is a test alert notification... di saluran notifikasi Slack yang Anda tentukan. Periksa saluran notifikasi untuk mengonfirmasi tanda terima.

5. Jika saluran Slack yang ingin Anda gunakan untuk notifikasi adalah saluran pribadi, Anda harus mengundang aplikasi Monitoring secara manual ke saluran tersebut:

   1. Buka Slack.

   2. Buka saluran yang ditetapkan sebagai saluran notifikasi Monitoring.

   3. Undang aplikasi Monitoring ke saluran dengan memasukkan dan mengirim pesan berikut di saluran:

      /invite @Google Cloud Monitoring

      Pastikan Anda mengundang aplikasi Monitoring ke saluran pribadi yang Anda tentukan saat membuat saluran notifikasi di Monitoring. Mengundang aplikasi Monitoring ke saluran publik bersifat opsional.

   Saat membuat kebijakan pemberitahuan, pilih Slack di bagian Notifications, lalu pilih konfigurasi Slack Anda.

Webhook

Catatan: Webhook hanya mendukung endpoint publik. Jika Anda memerlukan notifikasi yang dikirim ke endpoint yang tidak bersifat publik, buat saluran notifikasi Pub/Sub dan konfigurasi langganan ke topik Pub/Sub. Untuk mengetahui informasi selengkapnya, lihat Notifikasi webhook gagal saat dikonfigurasi untuk endpoint pribadi.

Catatan: Jika Cloud Function dikonfigurasi sebagai endpoint webhook untuk saluran notifikasi, pastikan pengguna yang memanggil fungsi memiliki izin autentikasi yang diperlukan. Untuk mengetahui informasi selengkapnya, baca artikel Mengautentikasi fungsi ke panggilan fungsi dan Mengaktifkan akses ke fungsi.

Untuk mengonfigurasi notifikasi Webhook, lakukan hal berikut:

1. Pengendali webhook: Mengidentifikasi URL endpoint publik untuk menerima data webhook dari Monitoring.

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

   Buka Alerting

3. Klik Edit saluran notifikasi.
4. Di bagian Webhook, klik Add new.
5. Lengkapi dialog.
6. Klik Test Connection untuk mengirim payload pengujian ke endpoint Webhook. Anda dapat membuka endpoint penerima untuk memverifikasi pengiriman.
7. Klik Save.

Saat membuat kebijakan pemberitahuan, pilih Webhook di bagian Notifications, lalu pilih konfigurasi webhook Anda. Notifikasi yang dikirim oleh Error Reporting mengikuti skema 1.0, sedangkan notifikasi yang dikirim oleh Monitoring mengikuti skema 1.2:

Contoh JSON

Secara default, backend pemberitahuan mencoba membuat paket JSON dengan format versi 1.2. Untuk mengetahui informasi selengkapnya tentang format ini, lihat bagian berikutnya.

Berikut adalah contoh paket tersebut:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Struktur skema, versi 1.2

Bagian ini menjelaskan versi 1.2 dari skema payload. Beberapa kolom mungkin tidak muncul di semua paket yang ditampilkan atau mungkin memiliki nilai kosong, bergantung pada konfigurasi kebijakan pemberitahuan, status insiden, atau resource yang dipantau. Beberapa kolom mengambil struktur tersemat sebagai nilai; struktur ini dijelaskan melalui acuan karena isinya juga dapat bervariasi.

Dalam paket yang ditampilkan, kolom dapat muncul dalam urutan apa pun. Dalam deskripsi berikut, mereka diatur ke dalam grup terkait.

{
  "version": "1.2",
  "incident": {
    
    Informasi tentang insiden.
    
    "incident_id": string, ID yang dihasilkan untuk insiden ini.
    "scoping_project_id": string, project ID yang menghosting cakupan metrik.
    "scoping_project_number": angka, nomor project dari project pencakupan.
    "url": string, URL konsol Google Cloud untuk insiden ini.
    "started_at": angka, waktu (dalam detik Unix epoch) saat insiden dibuka.
    "ended_at": angka, waktu (dalam detik Unix epoch) saat insiden ditutup. Hanya diisi jika state adalah closed.
    "state": string, status insiden: open atau closed. Jika open, maka ended_at adalah null.
    "summary": string, yang menghasilkan ringkasan tekstual dari insiden.
    "apigee_url": string, URL Apigee untuk insiden ini, hanya untuk jenis resource Apigee Environment dan Proxy*.
    "observed_value": string, nilai yang diamati yang memicu/menyelesaikan pemberitahuan, mungkin kosong jika kondisi sudah berakhir.
    
    Informasi tentang referensi yang dipantau tempat insiden dibuka.
    
    "resource": {
      "type": string, ID jenis resource yang dimonitor yang menerima pemberitahuan, misalnya, gce_instance; lihat Daftar resource yang dipantau.
      "labels": pasangan nilai kunci objek untuk label yang terkait dengan resource yang dimonitor.
    },
    "resource_type_display_name": string, nama tampilan jenis resource yang dimonitor.
    "resource_id": string, ID instance resource yang dimonitor, nilai yang sama dengan resource.labels.instance_id.
    "resource_display_name": string, nama tampilan resource yang dimonitor.
    "resource_name": string, nama yang dihasilkan dari resource yang dimonitor ini; terdiri dari nilai dari kolom lain.
    
    Informasi tentang jenis metrik dari data deret waktu.
    
    "metric": {
      "type": string, ID jenis metrik yang menerima pemberitahuan, misalnya, compute.googleapis.com/instance/cpu/utilization; lihat Daftar metrik.
      "displayName": string, nama tampilan jenis metrik.
      "labels": objek, pasangan nilai kunci untuk label yang terkait dengan metrik.
    },
    "metadata": {
      "system_labels": objek, key-value pair untuk label metadata sistem.
      "user_labels": objek, key-value pair untuk label metadata pengguna.
    },
    
    Informasi tentang kondisi dan kebijakan pemberitahuan yang membuka/menyelesaikan insiden.
    Nilainya diambil dari objek AlertPolicy yang relevan.
    
    "policy_name": string, nama tampilan untuk kebijakan pemberitahuan.
    "policy_user_labels": objek, key-value pair untuk setiap label pengguna yang dilampirkan pada kebijakan.
    "documentation": objek, struktur tersemat dari bentuk Documentation.
    "condition": objek, struktur tersemat dari bentuk Condition.
    "condition_name": string, nama tampilan kondisi, nilai yang sama dengan condition.displayName.
    "severity": string, tingkat keparahan insiden. Jika kolom ini tidak ditentukan selama pembuatan kebijakan pemberitahuan, Cloud Monitoring akan menetapkan tingkat keparahan kebijakan pemberitahuan ke No Severity.
    "threshold_value": string, nilai minimum kondisi ini, boleh kosong jika kondisi bukan merupakan kondisi nilai minimum.
  },
}

Autentikasi dasar

Selain permintaan webhook yang dikirim oleh Cloud Monitoring, autentikasi dasar menggunakan spesifikasi HTTP untuk nama pengguna dan sandi. Cloud Monitoring mengharuskan server Anda menampilkan respons 401 dengan header WWW-Authenticate yang tepat. Untuk mengetahui informasi selengkapnya tentang autentikasi dasar, lihat referensi berikut:

• Spesifikasi RFC
• Autentikasi dasar

Autentikasi token

Autentikasi Token memerlukan parameter string kueri di URL endpoint dan kunci yang diharapkan server bersifat rahasia antara server itu sendiri dan Monitoring. Berikut adalah contoh URL yang menyertakan token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Jika Monitoring memposting insiden ke URL endpoint, server Anda dapat memvalidasi token yang dilampirkan. Metode autentikasi ini akan paling efektif ketika digunakan dengan SSL/TLS untuk mengenkripsi permintaan HTTP untuk mencegah pengintai mempelajari token tersebut.

Untuk server contoh di Python, lihat server contoh ini.

Kebijakan penghentian penggunaan

Skema payload tunduk pada kebijakan penghentian layanan Google Cloud yang diuraikan dalam Pasal 1.4(d) dari Persyaratan Layanan Google Cloud Platform. Perhatikan bahwa skema tidak mengontrol format nilai kolom yang dihasilkan, dan format ini dapat berubah tanpa pemberitahuan. Misalnya, incident.summary, incident.documentation.content, dan incident.url dimaksudkan untuk menyertakan data yang berkaitan dengan kolomnya, tetapi skema tersebut tidak memiliki batasan untuk menjamin penguraian yang akurat untuk kolom tersebut. Anda dapat menggunakan nilai secara keseluruhan dan mematuhi kebijakan penghentian, tetapi tidak mengandalkan penguraian kolom yang dihasilkan.

Pub/Sub

Bagian ini menjelaskan cara mengonfigurasi saluran notifikasi Pub/Sub. Untuk redundansi, sebaiknya buat beberapa saluran notifikasi. Menyambungkan Pub/Sub dengan Aplikasi Seluler Konsol Google Cloud, PagerDuty, Webhook, atau Slack direkomendasikan, karena Pub/Sub menggunakan mekanisme pengiriman yang berbeda.

Untuk mengonfigurasi saluran notifikasi Pub/Sub:

1. Mengaktifkan API yang diperlukan dan membuat topik
2. Mengonfigurasi saluran notifikasi untuk topik
3. Mengizinkan akun layanan
4. Menetapkan saluran notifikasi dalam kebijakan pemberitahuan

Untuk memahami skema data, lihat Contoh skema.

Untuk menerima notifikasi pemberitahuan, Anda juga harus membuat salah satu langganan berikut: pull, push, atau BigQuery.

Jika langganan berada di project yang berbeda dengan topik, buat akun layanan di project pelanggan, dan beri peran roles/pubsub.subscriber.

Sebelum memulai

Saat Anda menambahkan saluran notifikasi pertama untuk project Google Cloud, Cloud Monitoring akan membuat akun layanan untuk project tersebut. API ini juga memberikan peran Identity and Access Management Monitoring Notification Service Agent untuk akun layanan. Akun layanan ini memungkinkan Monitoring mengirimkan notifikasi ke saluran notifikasi berbasis Pub/Sub dalam project ini.

Akun layanan memiliki format berikut:

[e-mail]

Nama akun layanan notifikasi mencakup nomor unik project Google Cloud. Anda dapat menemukan nama, ID, dan nomor project di dasbor project di Konsol Google Cloud, atau Anda dapat mengambilnya dengan perintah berikut:

gcloud projects describe PROJECT_ID --format="value(project_number)"

Anda dapat melihat dan mengedit akun layanan menggunakan Google Cloud Console atau Google Cloud CLI.

Mengaktifkan API yang diperlukan dan membuat topik

Di project Google Cloud tempat Anda berencana membuat saluran notifikasi dan topik Pub/Sub, lakukan hal berikut:

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan API Pub/Sub and Cloud Monitoring.

   Mengaktifkan API

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

7. Aktifkan API Pub/Sub and Cloud Monitoring.

   Mengaktifkan API

8. Buat topik Pub/Sub. Untuk mengetahui informasi tentang cara membuat topik, lihat Membuat topik. Misalnya, untuk membuat topik bernama notificationTopic dengan menggunakan Google Cloud CLI, jalankan perintah berikut:

   gcloud pubsub topics create notificationTopic

Catatan: Jika Anda berencana untuk membuat saluran notifikasi dan topik Pub/Sub di project Google Cloud yang berbeda, pastikan untuk mengaktifkan Pub/Sub dan Monitoring API di kedua project.

Selanjutnya, konfigurasikan saluran notifikasi Pub/Sub Anda.

Mengonfigurasi notifikasi untuk suatu topik

Untuk membuat saluran notifikasi Pub/Sub, Anda dapat menggunakan Monitoring API, Google Cloud CLI, atau Konsol Google Cloud. Setelah Anda membuat saluran notifikasi, izinkan akun layanan notifikasi untuk memublikasikan setiap topik yang Anda gunakan sebagai saluran notifikasi.

Untuk informasi tentang cara menggunakan Monitoring API atau Google Cloud CLI untuk membuat saluran notifikasi, lihat Membuat saluran.

Untuk menggunakan konsol Google Cloud guna membuat saluran notifikasi, lakukan langkah-langkah berikut:

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

   Buka Alerting

2. Pilih project Google Cloud yang berisi topik Pub/Sub yang Anda buat.
3. Klik Edit saluran notifikasi.

4. Di bagian Pub/Sub, klik Add new.

   Dialog Created Pub/Sub Channel menampilkan nama akun layanan yang dibuat Monitoring.

5. Izinkan akun layanan. Akun layanan Anda dapat memublikasikan semua topik atau topik tertentu:

   • Untuk memublikasikan semua topik, pilih Manage roles, dan tambahkan peran Pub/Sub Publisher.

     Setelah Anda menyelesaikan langkah-langkah yang mengonfigurasi saluran notifikasi, lewati bagian berikutnya yang berjudul Otorisasi akun layanan, lalu lanjutkan ke bagian Menyetel saluran notifikasi dalam kebijakan pemberitahuan.

   • Untuk memublikasikan topik tertentu, lanjutkan ke langkah berikutnya dan izinkan akun layanan untuk memublikasikan topik tertentu setelah Anda selesai mengonfigurasi saluran notifikasi. Untuk petunjuk cara memberikan otorisasi pada akun layanan, lihat Mengizinkan akun layanan.
6. Masukkan nama tampilan untuk channel Anda dan nama topik Pub/Sub.
7. (Opsional) Untuk memverifikasi bahwa saluran sudah dikonfigurasi dengan benar, klik Kirim notifikasi pengujian.
8. Pilih Tambahkan saluran.

Selanjutnya, otorisasi akun layanan.

Izinkan akun layanan

Catatan: Selesaikan langkah ini saat Anda membuat saluran notifikasi menggunakan API atau Google Cloud CLI, dan setelah Anda melewati langkah otorisasi saat menggunakan Konsol Google Cloud.

Dengan otorisasi, akun layanan notifikasi dapat memublikasikan setiap topik Pub/Sub yang Anda gunakan sebagai saluran notifikasi. Bagian ini menjelaskan cara melakukan hal berikut:

• Izinkan akun layanan untuk topik tertentu.
• Izinkan akun layanan untuk semua topik.

Mengizinkan akun layanan untuk topik tertentu

Anda dapat mengizinkan akun layanan untuk memublikasikan topik tertentu menggunakan Konsol Google Cloud dan Google Cloud CLI. Bagian ini menjelaskan kedua pendekatan tersebut.

Untuk mengizinkan akun layanan Anda untuk topik tertentu dengan menggunakan Konsol Google Cloud, lakukan hal berikut:

1. Di panel navigasi konsol Google Cloud, pilih Pub/Sub, lalu pilih Topics:

   Buka Topik

2. Pilih topik.
3. Dalam tab Permissions, pilih Add principal.
4. Di kolom New principal, masukkan nama akun layanan notifikasi. Akun layanan memiliki konvensi penamaan berikut:

   [e-mail]

5. Pilih peran Pub/Sub Publisher, lalu pilih Save.

Guna memberikan otorisasi ke akun layanan Anda untuk topik tertentu dengan menggunakan Google Cloud CLI, berikan peran IAM pubsub.publisher untuk topik tersebut ke akun layanan. Misalnya, perintah berikut mengonfigurasi peran IAM untuk topik notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:[e-mail]
 

Respons terhadap keberhasilan eksekusi perintah add-iam-policy-binding adalah seperti berikut:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:[e-mail]
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1
 

Untuk informasi selengkapnya, lihat halaman referensi pubsub topics add-iam-policy-binding.

Izinkan akun layanan untuk semua topik

Guna mengizinkan akun layanan Anda untuk semua topik, lakukan hal berikut:

1. Pada panel navigasi Konsol Google Cloud, pilih IAM:

   Buka IAM

2. Pilih Sertakan pemberian peran yang disediakan Google seperti yang ditunjukkan dalam gambar berikut:
   
3. Telusuri akun layanan yang memiliki format berikut:

   [e-mail]

   Muat ulang halaman jika akun layanan tidak tercantum.

4. Pilih Edit untuk akun layanan notifikasi, pilih Add another role, lalu tambahkan peran Pub/Sub Publisher.

Berikutnya, setel saluran notifikasi dalam kebijakan pemberitahuan.

Menyetel saluran notifikasi dalam kebijakan pemberitahuan

Untuk menggunakan saluran notifikasi Pub/Sub dalam kebijakan pemberitahuan, pilih Pub/Sub sebagai jenis saluran, lalu pilih topik.

Contoh skema

Untuk melihat contoh paket JSON dan skemanya, luaskan bagian berikut.

Contoh JSON

Secara default, backend pemberitahuan mencoba membuat paket JSON dengan format versi 1.2. Untuk mengetahui informasi selengkapnya tentang format ini, lihat bagian berikutnya.

Berikut adalah contoh paket tersebut:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Struktur skema, versi 1.2

Bagian ini menjelaskan versi 1.2 dari skema payload. Beberapa kolom mungkin tidak muncul di semua paket yang ditampilkan atau mungkin memiliki nilai kosong, bergantung pada konfigurasi kebijakan pemberitahuan, status insiden, atau resource yang dipantau. Beberapa kolom mengambil struktur tersemat sebagai nilai; struktur ini dijelaskan melalui acuan karena isinya juga dapat bervariasi.

Dalam paket yang ditampilkan, kolom dapat muncul dalam urutan apa pun. Dalam deskripsi berikut, mereka diatur ke dalam grup terkait.

{
  "version": "1.2",
  "incident": {
    
    Informasi tentang insiden.
    
    "incident_id": string, ID yang dihasilkan untuk insiden ini.
    "scoping_project_id": string, project ID yang menghosting cakupan metrik.
    "scoping_project_number": angka, nomor project dari project pencakupan.
    "url": string, URL konsol Google Cloud untuk insiden ini.
    "started_at": angka, waktu (dalam detik Unix epoch) saat insiden dibuka.
    "ended_at": angka, waktu (dalam detik Unix epoch) saat insiden ditutup. Hanya diisi jika state adalah closed.
    "state": string, status insiden: open atau closed. Jika open, maka ended_at adalah null.
    "summary": string, yang menghasilkan ringkasan tekstual dari insiden.
    "apigee_url": string, URL Apigee untuk insiden ini, hanya untuk jenis resource Apigee Environment dan Proxy*.
    "observed_value": string, nilai yang diamati yang memicu/menyelesaikan pemberitahuan, mungkin kosong jika kondisi sudah berakhir.
    
    Informasi tentang referensi yang dipantau tempat insiden dibuka.
    
    "resource": {
      "type": string, ID jenis resource yang dimonitor yang menerima pemberitahuan, misalnya, gce_instance; lihat Daftar resource yang dipantau.
      "labels": pasangan nilai kunci objek untuk label yang terkait dengan resource yang dimonitor.
    },
    "resource_type_display_name": string, nama tampilan jenis resource yang dimonitor.
    "resource_id": string, ID instance resource yang dimonitor, nilai yang sama dengan resource.labels.instance_id.
    "resource_display_name": string, nama tampilan resource yang dimonitor.
    "resource_name": string, nama yang dihasilkan dari resource yang dimonitor ini; terdiri dari nilai dari kolom lain.
    
    Informasi tentang jenis metrik dari data deret waktu.
    
    "metric": {
      "type": string, ID jenis metrik yang menerima pemberitahuan, misalnya, compute.googleapis.com/instance/cpu/utilization; lihat Daftar metrik.
      "displayName": string, nama tampilan jenis metrik.
      "labels": objek, pasangan nilai kunci untuk label yang terkait dengan metrik.
    },
    "metadata": {
      "system_labels": objek, key-value pair untuk label metadata sistem.
      "user_labels": objek, key-value pair untuk label metadata pengguna.
    },
    
    Informasi tentang kondisi dan kebijakan pemberitahuan yang membuka/menyelesaikan insiden.
    Nilainya diambil dari objek AlertPolicy yang relevan.
    
    "policy_name": string, nama tampilan untuk kebijakan pemberitahuan.
    "policy_user_labels": objek, key-value pair untuk setiap label pengguna yang dilampirkan pada kebijakan.
    "documentation": objek, struktur tersemat dari bentuk Documentation.
    "condition": objek, struktur tersemat dari bentuk Condition.
    "condition_name": string, nama tampilan kondisi, nilai yang sama dengan condition.displayName.
    "severity": string, tingkat keparahan insiden. Jika kolom ini tidak ditentukan selama pembuatan kebijakan pemberitahuan, Cloud Monitoring akan menetapkan tingkat keparahan kebijakan pemberitahuan ke No Severity.
    "threshold_value": string, nilai minimum kondisi ini, boleh kosong jika kondisi bukan merupakan kondisi nilai minimum.
  },
}

Kebijakan penghentian penggunaan

Skema payload tunduk pada kebijakan penghentian layanan Google Cloud yang diuraikan dalam Pasal 1.4(d) dari Persyaratan Layanan Google Cloud Platform. Perhatikan bahwa skema tidak mengontrol format nilai kolom yang dihasilkan, dan format ini dapat berubah tanpa pemberitahuan. Misalnya, incident.summary, incident.documentation.content, dan incident.url dimaksudkan untuk menyertakan data yang berkaitan dengan kolomnya, tetapi skema tersebut tidak memiliki batasan untuk menjamin penguraian yang akurat untuk kolom tersebut. Anda dapat menggunakan nilai secara keseluruhan dan mematuhi kebijakan penghentian, tetapi tidak mengandalkan penguraian kolom yang dihasilkan.

Google Chat

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Aplikasi Google Cloud Monitoring memungkinkan ruang Google Chat Anda menerima notifikasi.

Sebelum memulai

Jika Anda berada di organisasi, maka untuk menginstal aplikasi Google Cloud Monitoring, Anda harus memiliki akses ke aplikasi Google Cloud Monitoring. Jika tidak memiliki akses, minta administrator Google Workspace untuk melakukan hal berikut:

1. Tambahkan aplikasi ke daftar aplikasi Marketplace yang diizinkan dan aktifkan akses di unit organisasi teratas.
2. Mengonfigurasi setelan penginstalan pengguna aplikasi Marketplace agar pengguna dapat menginstal aplikasi.

Menginstal aplikasi Google Cloud Monitoring

Anda harus menggunakan prosedur berikut untuk menginstal aplikasi Google Cloud Monitoring. Penginstalan dari listingan Google Workspace Marketplace tidak didukung.

Untuk menginstal aplikasi dan mengonfigurasi ruang sebagai saluran notifikasi, lakukan hal berikut:

1. Di Google Chat, buka atau buat ruang tempat Anda ingin menerima notifikasi.

2. Instal aplikasi Google Cloud Monitoring:

   1. Pilih nama ruang Anda, lalu pilih Apps and Integrations.

   2. Jika aplikasi Google Cloud Monitoring tidak muncul dalam daftar Aplikasi, kembali ke ruang Anda, masukkan @Google Cloud Monitoring, lalu tekan Enter.

   3. Klik Tambahkan ke ruang.

3. Salin ID ruang chat ke papan klip.

   Jika Anda menginstal aplikasi Google Cloud Monitoring, ID ruang chat akan disertakan dalam konfirmasi penginstalan. Jika tidak, Anda dapat menemukan ID ruang chat sebagai rangkaian angka dan huruf setelah space/ di akhir URL ruang chat.

4. Buka tab browser baru, lalu konfigurasikan saluran notifikasi:

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

      Buka Alerting

   2. Klik Edit saluran notifikasi.

   3. Buka bagian Google Chat, lalu klik Add New.

   4. Masukkan ID ruang chat Anda di kolom Chat Space ID, lalu klik Save.

Catatan: Anda tidak dapat melihat atau mengelola insiden menggunakan aplikasi Google Cloud Monitoring. Untuk mengonfirmasi insiden atau menunda kebijakan pemberitahuan terkait, gunakan konsol Google Cloud, Google Cloud CLI, atau Cloud Monitoring API.

Membuat channel on demand

Saat menambahkan saluran notifikasi ke kebijakan pemberitahuan, Anda harus memilih saluran dari daftar. Untuk memperbarui daftar opsi saat Anda membuat kebijakan pemberitahuan, gunakan proses berikut:

1. Pada dialog notifikasi, klik Manage Notification Channels. Anda akan diarahkan ke jendela Notification channels di tab browser baru.
2. Untuk menambahkan saluran notifikasi baru, cari jenis saluran, klik Add new, lalu ikuti petunjuk khusus saluran yang terdapat dalam tabel sebelumnya.

3. Kembali ke tab asli, dan pada dialog notifikasi, klik Refresh.

   

4. Pilih saluran notifikasi dari daftar yang diperbarui.

Mendapatkan notifikasi dari channel yang tidak didukung

Jika saluran notifikasi pilihan Anda tidak didukung, pertimbangkan untuk membuat pipeline yang mengandalkan pengiriman notifikasi Anda ke Pub/Sub. Untuk contoh Python yang menggunakan Flask, lihat Membuat notifikasi kustom dengan Cloud Monitoring dan Cloud Run. Untuk contoh lain, lihat repositori Git cloud-alerting-notification-forwarding.

Menguji saluran notifikasi

Cloud Monitoring tidak mendukung opsi pengujian untuk saluran notifikasi. Namun, Anda dapat memverifikasi bahwa saluran notifikasi telah dikonfigurasi dengan benar dengan membuat kebijakan pemberitahuan dan mengonfigurasi kondisi untuk dipicu.

Untuk menguji saluran notifikasi secara manual, Anda dapat membuat kebijakan pemberitahuan yang memantau pemakaian CPU instance virtual machine (VM) Anda:

1. Di panel navigasi Konsol Google Cloud, pilih Compute Engine, lalu pilih VM instances:

   Buka instance VM

2. Pilih instance VM atau buat instance.

3. Buat kebijakan pemberitahuan untuk memantau pemakaian CPU instance tersebut.

   Jika project Google Cloud Anda berisi beberapa instance, tambahkan filter untuk memilih satu instance.

4. Konfigurasikan kolom Pemicu kondisi sebagai berikut:

   1. Pilih Nilai minimum untuk kolom Jenis kondisi.
   2. Pilih Di bawah nilai minimum untuk kolom Posisi nilai minimum.
   3. Pilih nilai yang lebih besar dari pemakaian CPU untuk instance Anda. Misalnya, jika diagram menampilkan pemakaian CPU sekitar 5%, tetapkan batas ke 10%.
   4. Luaskan Advanced Options, lalu pilih No retest untuk kolom Retest window.

   Setelan ini mengonfigurasi kondisi yang akan dipicu saat penggunaan CPU instance VM kurang dari batas yang ditentukan. Kondisi akan terpicu karena Anda memilih nilai minimum yang lebih besar dari penggunaan CPU instance VM.

5. Tambahkan saluran notifikasi ke kebijakan Anda.

6. Luaskan Insiden autoclose duration, lalu pilih 30 min.

7. Masukkan nama kebijakan, lalu klik Create policy.

8. Setelah kondisi terpicu, pastikan Anda menerima notifikasi di setiap saluran notifikasi.

9. Hapus kebijakan pemberitahuan. Insiden ditutup secara otomatis setelah durasi penutupan otomatis berakhir.

10. Jika Anda sudah membuat instance VM untuk pengujian ini, hapus instance tersebut.

Mengedit dan menghapus saluran notifikasi

Untuk mengedit atau menghapus saluran notifikasi menggunakan Konsol Google Cloud, lakukan langkah berikut:

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

   Buka Alerting

2. Klik Edit saluran notifikasi.

   Dasbor Notification channels berisi bagian untuk setiap jenis saluran notifikasi. Setiap bagian mencantumkan semua konfigurasi untuk jenis tersebut:

   • Untuk mengubah entri, klik Edit. Klik Save setelah perubahan selesai.
   • Untuk menghapus entri, klik Hapus. Klik Delete di dialog konfirmasi.

Catatan: Anda tidak dapat menghapus saluran notifikasi menggunakan Konsol Google Cloud jika saluran tersebut dikaitkan dengan kebijakan pemberitahuan. Namun, Anda dapat menghapus saluran dengan menggunakan Google Cloud CLI atau Cloud Monitoring API. Untuk informasi selengkapnya, lihat Membuat dan mengelola saluran notifikasi dengan API.

Lihat log saluran notifikasi

Anda dapat menggunakan Logs Explorer untuk melihat error saluran notifikasi:

1. Di panel navigasi konsol Google Cloud, pilih Logging, lalu pilih Logs Explorer:

   Buka Logs Explorer

2. Masukkan dan jalankan kueri Anda. Untuk kueri khusus error saluran notifikasi, lihat Kueri Cloud Monitoring.

Langkah selanjutnya

Untuk mengetahui informasi tentang insiden, lihat dokumen berikut:

• Insiden untuk kebijakan pemberitahuan berbasis metrik
• Insiden untuk kebijakan pemberitahuan berbasis log.