Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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 Anda, saat kebijakan pemberitahuan diaktifkan. Saat membuat kebijakan pemberitahuan, Anda memilih siapa yang akan diberi tahu dengan membuat pilihan dari daftar saluran notifikasi yang dikonfigurasi. Misalnya, Anda dapat mengonfigurasi kebijakan pemberitahuan yang memantau instance Compute Engine untuk dipublikasikan ke topik Pub/Sub dan untuk memberi tahu saluran Slack tim yang bertugas.

Untuk mengetahui informasi selengkapnya, lihat Latensi notifikasi dan Kapan Monitoring mengirim notifikasi dan membuat pemberitahuan.

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

Fitur ini hanya didukung untuk project Google Cloud . Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk melihat dan mengonfigurasi saluran notifikasi menggunakan Google Cloud konsol, 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 ke project, folder, dan organisasi.

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

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

Tentukan saluran notifikasi yang akan dibuat

Sebaiknya Anda membuat beberapa jenis saluran notifikasi untuk tujuan redundansi karena alasan berikut:

Google Cloud tidak memiliki kontrol atas banyak sistem pengiriman setelah meneruskan notifikasi ke sistem tersebut.
Notifikasi Cloud Mobile App, PagerDuty, webhook, dan Slack semuanya didukung oleh layanan internal Google Cloud yang sama sehingga memiliki satu titik kegagalan. Jika Anda menggunakan salah satu saluran notifikasi ini, maka gunakan email atau Pub/Sub sebagai saluran redundan.
SMS bukan jenis saluran notifikasi yang sepenuhnya andal, dan mungkin tidak tersedia di wilayah tertentu. Setiap kali Anda menggunakan saluran notifikasi SMS, gunakan juga jenis saluran notifikasi lain sebagai cadangan.

Jika Anda berencana menggunakan alat otomatisasi untuk membaca, mengalihkan, mengubah, atau melakukan tindakan lain pada notifikasi, gunakan webhook atau saluran Pub/Sub. Sebaiknya jangan gunakan jenis channel lain dengan alat otomatisasi karena format notifikasi dapat berubah.

Membuat saluran notifikasi

Saat membuat kebijakan pemberitahuan, Anda dapat memilih saluran notifikasi yang dikonfigurasi dan menambahkannya ke kebijakan Anda. Anda dapat mengonfigurasi saluran notifikasi terlebih dahulu, atau mengonfigurasinya sebagai bagian dari proses pembuatan kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Membuat channel sesuai permintaan.

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

Email

Untuk menambahkan saluran notifikasi email, lakukan hal berikut:

Di konsol Google Cloud , buka halaman Pemberitahuan:
Buka Pemberitahuan

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
Klik Edit saluran notifikasi.
Di bagian Email, klik Tambahkan Baru.
Masukkan satu alamat email dan deskripsi.
Klik Simpan.

Jika Anda menggunakan alamat email grup sebagai saluran notifikasi untuk kebijakan pemberitahuan, konfigurasi grup agar menerima email dari alerting-noreply@google.com.

Anda dapat membuat saluran email selama pembuatan kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Membuat channel sesuai permintaan.

Aplikasi Seluler

Gunakan Aplikasi SelulerGoogle Cloud console untuk memantau resource Google Cloud console dan informasi Pemantauan dari mana saja.Notifikasi Aplikasi Seluler Google Cloud console dikirim ke perangkat tertentu atau pengguna tertentu:

$Daftar saluran notifikasi Aplikasi Seluler konsol Google Cloud .$

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

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 hal berikut:

Instal Aplikasi Seluler Google Cloud konsol dari app store perangkat seluler Anda.
Pilih project untuk dilihat di Aplikasi Seluler konsol Google Cloud .

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

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

PagerDuty

PagerDuty mendukung sinkronisasi dua arah dengan Monitoring. Akibatnya, hal berikut berlaku:

Jika pemberitahuan dibuat di Monitoring, maka pemberitahuan akan dibuka di PagerDuty.
Anda tidak dapat menggunakan PagerDuty untuk menutup pemberitahuan di Monitoring.
Jika Anda menyelesaikan pemberitahuan di PagerDuty dan jika Monitoring membuka pemberitahuan, maka pemberitahuan akan dibuka kembali di PagerDuty.

Untuk menyiapkan notifikasi PagerDuty, lakukan hal berikut:

Di akun PagerDuty Anda, konfigurasi integrasi di layanan baru atau tambahkan integrasi ke layanan yang ada.
1. Buat akun atau login ke akun yang ada.
2. Buka halaman Layanan.
3. Di panel Integrasi layanan Anda, temukan listingan untuk integrasi baru Anda, perluas menunya, lalu salin kunci integrasi.
4. Opsional: Konfigurasi PagerDuty untuk memetakan nilai tingkat keparahan pemberitahuan secara akurat dari Monitoring.
Di Cloud Monitoring, tambahkan saluran notifikasi PagerDuty:
1. Di konsol Google Cloud , buka halaman Pemberitahuan:
  Buka Pemberitahuan
  
  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. Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
3. Klik Edit saluran notifikasi.
4. Di bagian PagerDuty, klik Add New.
5. Masukkan Nama Tampilan. Nama ini harus cocok dengan nama layanan PagerDuty tempat Anda mengonfigurasi integrasi baru pada Langkah 1.
6. Tempelkan kunci integrasi yang Anda salin pada Langkah 1 ke kolom Service Key.
7. Klik Simpan.

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

Paket JSON untuk PagerDuty memiliki format berikut:

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

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

Contoh JSON

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

Berikut adalah contoh paket tersebut:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "renotify": true,
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "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",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "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 skema payload versi 1.2. 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 menggunakan struktur sematan sebagai nilai; struktur ini dijelaskan berdasarkan referensi karena isinya juga dapat bervariasi.

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

{
  "version": "1.2",
  "incident": {

    Informasi tentang insiden.

    "incident_id": string, ID yang dibuat untuk insiden ini.
    "renotify": bool, opsional. Disetel ke true saat pesan adalah notifikasi berulang.
    "scoping_project_id": string, project ID yang menghosting cakupan metrik.
    "scoping_project_number": number, nomor project dari project cakupan.
    "url": string, Google Cloud URL konsol untuk insiden ini.
    "started_at": angka, waktu (dalam detik epoch Unix) saat insiden dibuka.
    "ended_at": angka, waktu (dalam detik epoch Unix) saat insiden ditutup. Diisi hanya jika state adalah closed.
    "state": string, status insiden: open atau closed. Jika open, maka ended_at adalah null.
    "summary": string, ringkasan tekstual insiden yang dihasilkan.
    "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 telah berakhir.

    Informasi tentang resource yang dipantau yang insidennya dibuka.

    "resource": {
      "type": string, ID jenis resource yang dipantau yang memicu pemberitahuan, misalnya, gce_instance; lihat Daftar resource yang dipantau.
      "labels": objek, key-value pair untuk label yang terkait dengan resource yang dimonitor.
    },
    "resource_type_display_name": string, nama tampilan jenis resource yang dipantau.
    "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 dibuat untuk resource yang dimonitor ini; terdiri dari nilai dari kolom lain.

    Informasi tentang jenis metrik data deret waktu.

    "metric": {
      "type": string, ID jenis metrik yang akan diberi tahu, 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, pasangan nilai kunci untuk label metadata sistem.
      "user_labels": objek, pasangan nilai kunci untuk label metadata pengguna.
    },

    Informasi tentang kebijakan pemberitahuan dan kondisi yang membuka/menyelesaikan insiden.
    Nilai diambil dari objek AlertPolicy yang relevan.

    "policy_name": string, nama tampilan untuk kebijakan pemberitahuan.
    "policy_user_labels": objek, pasangan nilai kunci untuk label pengguna yang dilampirkan ke kebijakan.
    "documentation": objek, struktur sematan dalam bentuk Documentation.
    "condition": objek, struktur sematan dalam 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, maka Cloud Monitoring akan menyetel tingkat keparahan kebijakan pemberitahuan ke no severity.
    "threshold_value": string, nilai minimum kondisi ini, dapat kosong jika kondisi bukan merupakan kondisi nilai minimum.
  },
}

Kebijakan penghentian penggunaan

Skema payload tunduk pada Google Cloud kebijakan penghentian penggunaan yang diuraikan dalam Pasal 1.4(d) 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 tidak memiliki batasan untuk menjamin penguraian yang akurat dari kolom ini. Anda dapat menggunakan nilai secara keseluruhan dan mengharapkan nilai tersebut mematuhi kebijakan penghentian penggunaan, tetapi jangan mengandalkan penguraian kolom yang dihasilkan.

Mengonfigurasi PagerDuty untuk memetakan tingkat keparahan

Secara default, notifikasi PagerDuty menampilkan semua tingkat keparahan pemberitahuan sebagai "kritis". Anda dapat mengonfigurasi aturan orkestrasi peristiwa di PagerDuty sehingga tingkat keparahan pemberitahuan PagerDuty cocok dengan tingkat keparahan pemberitahuan Monitoring:

Di akun PagerDuty Anda, buka halaman Services.
Pilih layanan PagerDuty tempat Anda menerima Google Cloud notifikasi.
Klik Setelan.
Buka bagian Pengelolaan Peristiwa, lalu klik Lihat Aturan Pengelolaan.
Klik Aturan Baru.
Untuk setiap nilai tingkat keparahan Pemantauan yang ingin Anda konversi, buat aturan bersyarat yang memetakan nilai tingkat keparahan ke nilai PagerDuty yang setara:
1. Di menu pada bagian Langkah 1: Kapan aturan ini harus diterapkan?, pilih Jika peristiwa cocok dengan kondisi tertentu.
2. Pilih editor kode.
3. Di bagian If, masukkan event.custom_details.incident.severity matches part 'VALUE', dengan VALUE adalah nama Nilai tingkat keparahan pemantauan, lalu klik Berikutnya.
4. Di bagian Langkah 2: Tindakan apa yang harus diterapkan?, Pilih Data Pemberitahuan.
5. Tetapkan tingkat keparahan pemberitahuan ke nilai yang cocok dengan nilai Pemantauan yang Anda masukkan di Langkah C, lalu simpan perubahan Anda.
Opsional: Untuk menambahkan aturan tambahan, klik Aturan lainnya.

SMS

Untuk mengonfigurasi notifikasi SMS, lakukan hal berikut:

Di konsol Google Cloud , buka halaman Pemberitahuan:
Buka Pemberitahuan

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
Klik Edit saluran notifikasi.
Di bagian SMS, klik Tambahkan Baru.
Selesaikan dialog, lalu klik Kirim Kode Verifikasi.

Kode verifikasi akan dikirim ke nomor kontak yang Anda berikan.
Masukkan kode, lalu klik Verifikasi.

Jika Anda tidak menerima kode, lihat Pesan notifikasi SMS atau kode verifikasi tidak diterima.

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