Mengelola pemberitahuan untuk kebijakan pemberitahuan berbasis log

Pemberitahuan adalah catatan tentang kapan kondisi kebijakan pemberitahuan terpenuhi. Biasanya, Cloud Monitoring akan membuka pemberitahuan dan mengirimkan notifikasi saat log diterima yang cocok dengan kondisi kebijakan pemberitahuan Anda. Namun, pemberitahuan tidak dibuat dalam keadaan berikut:

• Kebijakan ditunda atau dinonaktifkan.
• Jumlah kebijakan pemberitahuan atau pemberitahuan melebihi batas untuk pemberitahuan yang ada.
• Entri log lain menyebabkan kondisi yang sama terpenuhi untuk pemberitahuan yang terbuka. Dalam hal ini, Pemantauan hanya mengirim notifikasi lain untuk peringatan yang sama.

Untuk setiap pemberitahuan, Monitoring akan membuat halaman Detail pemberitahuan yang memungkinkan Anda mengelola pemberitahuan, dan yang melaporkan informasi pemberitahuan yang dapat membantu Anda memecahkan masalah kegagalan. Misalnya, halaman Detail notifikasi menampilkan daftar entri log yang cocok dengan kueri kebijakan pemberitahuan berbasis log. Anda juga dapat menemukan link ke pemberitahuan terkait.

Dokumen ini menjelaskan cara menemukan pemberitahuan Anda. Dokumen ini juga menjelaskan cara menggunakan halaman Detail pemberitahuan untuk mengelola pemberitahuan untuk kebijakan pemberitahuan berbasis log, yang mengevaluasi data entri log yang disimpan dalam log individual di Cloud Logging.

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 Anda perlukan untuk melihat dan mengelola pemberitahuan, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

• Melihat pemberitahuan menggunakan Google Cloud CLI atau Cloud Monitoring API: Monitoring Alert Viewer (roles/monitoring.alertViewer)
• Melihat notifikasi menggunakan konsol Google Cloud :
  • Monitoring Cloud Console Incident Viewer (roles/monitoring.cloudConsoleIncidentViewer)
  • Stackdriver Accounts Viewer (roles/stackdriver.accounts.viewer)
• Mengelola pemberitahuan menggunakan konsol Google Cloud :
  • Monitoring Cloud Console Incident Editor (roles/monitoring.cloudConsoleIncidentEditor)
  • Stackdriver Accounts Viewer (roles/stackdriver.accounts.viewer)

Untuk mengetahui informasi selengkapnya tentang pemberian 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.

Lihat pemberitahuan

Untuk melihat pemberitahuan di project Anda, gunakan konsol Google Cloud , gcloud CLI, atau Monitoring API.

Konsol Google Cloud

Untuk mencantumkan pemberitahuan di Google Cloud project Anda, lakukan langkah berikut:

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.

   Halaman Alerting menampilkan informasi tentang kebijakan pemberitahuan, penundaan, dan pemberitahuan Anda:

   • Panel Ringkasan mencantumkan jumlah notifikasi yang belum ditutup.
   • Tabel Peringatan menampilkan peringatan terbuka terbaru. Untuk mencantumkan pemberitahuan terbaru dalam tabel, termasuk yang ditutup, klik Tampilkan pemberitahuan yang ditutup.

3. Untuk melihat detail pemberitahuan tertentu, pilih pemberitahuan dalam daftar.

   Halaman Detail notifikasi akan terbuka. Untuk mengetahui informasi selengkapnya tentang halaman Detail notifikasi, lihat bagian Menyelidiki notifikasi dalam dokumen ini.

Menemukan pemberitahuan lama

Tabel Pemberitahuan di halaman Pemberitahuan menampilkan pemberitahuan terbuka terbaru. Untuk melihat pemberitahuan lama, lakukan salah satu hal berikut:

• Untuk melihat entri di tabel Pemberitahuan, klik  Lebih Baru atau  Lebih Lama.

• Untuk membuka halaman yang memungkinkan Anda mencantumkan dan memfilter notifikasi, klik Lihat semua notifikasi. Halaman Alerts akan terbuka. Dari halaman tersebut, lakukan hal berikut:

  • Menampilkan semua peringatan, termasuk peringatan yang ditutup. Untuk menampilkan semua notifikasi, klik Tampilkan notifikasi yang ditutup.
  • Memfilter pemberitahuan. Untuk mengetahui informasi tentang cara menambahkan filter, lihat Memfilter pemberitahuan.
  • Mengonfirmasi atau menutup pemberitahuan, atau menunda kebijakan pemberitahuannya. Untuk mengakses opsi ini, klik  Opsi lainnya di baris pemberitahuan, lalu pilih dari menu. Untuk mengetahui informasi selengkapnya, lihat Mengelola pemberitahuan.

Memfilter pemberitahuan

Untuk membatasi pemberitahuan yang ditampilkan tabel, tambahkan filter. Jika Anda menambahkan beberapa filter, tabel hanya akan menampilkan pemberitahuan yang memenuhi semua filter.

Untuk memfilter tabel pemberitahuan, lakukan hal berikut:

1. Di halaman Notifikasi, klik  Filter tabel, lalu pilih properti filter. Properti filter mencakup:

   • Status pemberitahuan
   • Nama kebijakan pemberitahuan
   • Saat notifikasi dibuka atau ditutup

2. Pilih nilai dari menu sekunder atau masukkan nilai di kolom filter.

   Tabel Peringatan kemudian mencantumkan filter.

gcloud

Anda dapat menggunakan gcloud untuk mendapatkan pemberitahuan dan mencantumkan pemberitahuan.

Mendapatkan pemberitahuan

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• ALERT_NAME: Nama resource pemberitahuan. Contoh, projects/my-project/alerts/my-alert-id.

Jalankan perintah gcloud alpha monitoring alerts describe:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts describe ALERT_NAME

Perintah ini akan menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label terlampir, dan kebijakan pemberitahuan sumber. Responsnya akan terlihat seperti berikut:

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

Mencantumkan pemberitahuan

Anda dapat membuat daftar pemberitahuan di project dan memfilter hasilnya menggunakan gcloud CLI.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• PROJECT_ID: ID project.

Jalankan perintah gcloud alpha monitoring alerts list:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts list

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts list

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud alpha monitoring alerts list

Perintah ini akan menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label terlampir, dan kebijakan pemberitahuan sumber. Responsnya akan terlihat seperti berikut:

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

Anda juga dapat menggunakan flag opsional berikut untuk memfilter, mengurutkan, atau mengubah output:

• --filter: Berikan ekspresi filter untuk memfilter pemberitahuan menurut waktu atau menurut label. Misalnya, filter menurut waktu dengan --filter='close_time>="2025-09-10T00:00:00Z"', atau filter menurut label dengan --filter='resource.labels.key="value"'.

• --sort-by: Daftar kolom yang dipisahkan koma untuk mengurutkan output. Contoh, --sort-by=open_time.

• --uri: Perintah ini menampilkan daftar URI resource, bukan output default.

• --limit: Setel flag ini ke 2 atau lebih besar untuk membatasi jumlah pemberitahuan yang ditampilkan. Jangan gunakan flag ini bersama dengan flag --filter.

Monitoring API

Anda dapat menggunakan Monitoring API untuk mendapatkan pemberitahuan dan mencantumkan pemberitahuan.

Mendapatkan pemberitahuan

Untuk mendapatkan detail tentang satu pemberitahuan dengan Monitoring API, gunakan metode alerts.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project.
• ALERT_ID: ID pemberitahuan.

Metode HTTP dan URL:

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID" | Select-Object -Expand Content

Perintah ini akan menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label terlampir, dan kebijakan pemberitahuan sumber. Responsnya akan terlihat seperti berikut:

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

Mencantumkan pemberitahuan

Untuk mencantumkan pemberitahuan dalam project Anda dan memfilter hasilnya dengan Monitoring API, gunakan metode alerts.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: ID project.

Metode HTTP dan URL:

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts" | Select-Object -Expand Content

Perintah ini akan menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label terlampir, dan kebijakan pemberitahuan sumber. Responsnya akan terlihat seperti berikut:

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

Pengguna Curl dapat menambahkan tanda --data-urlencode yang diikuti dengan ekspresi filter untuk memfilter pemberitahuan menurut waktu atau label. Lihat contoh berikut:

Mencantumkan pemberitahuan yang dibuka dalam satu jam terakhir:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Mencantumkan & memfilter pemberitahuan yang terbuka dari hari terakhir:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Mencantumkan & memfilter notifikasi yang dibuka dalam dua periode:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Mencantumkan & memfilter notifikasi menurut label pengguna. Dalam contoh ini, filter menurut label pengguna dengan nama app dan nilai my-gke-app:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"

Pengguna Powershell dapat menggunakan contoh berikut untuk menambahkan filter berbasis waktu ke URL permintaan mereka:

$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Catatan: Notifikasi tidak selalu dibuat saat kondisi terpenuhi. Untuk mengetahui informasi selengkapnya, lihat Pemberitahuan tidak dibuat saat kondisi terpenuhi.

Menyelidiki pemberitahuan

Halaman Detail notifikasi berisi informasi yang dapat membantu Anda mengidentifikasi penyebab notifikasi.

Perhatian: Jika Anda bekerja sama dengan Google Cloud dukungan untuk menyelidiki penyebab pemberitahuan, jangan ubah kebijakan pemberitahuan terkait. Memodifikasi kebijakan pemberitahuan akan menyebabkan Cloud Monitoring menghapus data yang telah dihitung sebelumnya yang digunakan sistem untuk menentukan kapan harus membuat pemberitahuan. Menghapus data ini akan menyebabkan hilangnya catatan historis pemberitahuan.

Menjelajahi entri log

Jelajahi entri log untuk menemukan pola dan masalah berulang yang terkait dengan penyelidikan Anda. Panel Logs menampilkan entri log yang cocok dengan kueri kebijakan pemberitahuan berbasis log Anda.

• Untuk melihat entri log di Logs Explorer, klik View in Logs Explorer, lalu pilih project cakupan.
• Untuk melihat Panel Log di Metrics Explorer, klik Jelajahi Data.

Melihat informasi tambahan

Bagian Label menampilkan label dan nilai untuk resource yang dimonitor yang disertakan dalam entri log yang menyebabkan pemberitahuan. Informasi ini dapat membantu Anda mengidentifikasi resource yang dipantau tertentu yang menyebabkan notifikasi. Untuk mengetahui informasi selengkapnya, lihat Anotasi pemberitahuan dengan label.

Bagian Dokumentasi menampilkan template dokumentasi untuk notifikasi yang Anda berikan saat membuat kebijakan pemberitahuan. Informasi ini dapat mencakup deskripsi tentang apa yang dipantau oleh kebijakan pemberitahuan serta tips untuk mitigasi. Untuk mengetahui informasi selengkapnya, lihat Memberikan anotasi pada notifikasi dengan dokumentasi yang ditentukan pengguna.

Jika Anda tidak mengonfigurasi dokumentasi untuk kebijakan pemberitahuan, panel Dokumentasi akan menampilkan "Tidak ada dokumentasi yang dikonfigurasi".

Menjelajahi notifikasi terkait

Untuk membantu Anda menemukan masalah mendasar di seluruh aplikasi, Anda dapat menjelajahi pemberitahuan yang terkait dengan kondisi kebijakan pemberitahuan lainnya.

Bagian Notifikasi terkait menampilkan daftar notifikasi yang cocok dengan salah satu hal berikut:

• Pemberitahuan dibuat saat kondisi kebijakan pemberitahuan yang sama terpenuhi.
• Notifikasi berbagi label dengan notifikasi yang ditampilkan di halaman Detail notifikasi.

Kelola notifikasi

Pemberitahuan berada dalam salah satu status berikut:

•  Terbuka: Kondisi kebijakan pemberitahuan berbasis log terpenuhi, dan pemberitahuan masih terbuka. Jika kondisi yang sama terpenuhi lagi dan sudah ada pemberitahuan yang terbuka, maka pemberitahuan baru tidak akan dibuka.

•  Dikonfirmasi: Peringatan terbuka dan telah ditandai sebagai dikonfirmasi secara manual. Biasanya, status ini menunjukkan bahwa pemberitahuan sedang diselidiki.

•  Ditutup: Anda telah menutup notifikasi secara manual, atau notifikasi ditutup secara otomatis setelah periode tutup otomatis berakhir.

Mengonfirmasi pemberitahuan

Sebaiknya Anda menandai pemberitahuan sebagai sudah dibaca saat Anda mulai menyelidiki penyebab pemberitahuan.

Untuk menandai pemberitahuan sebagai sudah dikonfirmasi, lakukan hal berikut:

1. Di tabel Alerts pada halaman Alerting, klik See all alerts.

2. Di halaman Pemberitahuan, temukan pemberitahuan yang ingin Anda konfirmasi, lalu lakukan salah satu tindakan berikut:

   • Klik  Opsi lainnya, lalu pilih Setuju.
   • Buka halaman detail untuk notifikasi, lalu klik Konfirmasi notifikasi.

Menunda kebijakan pemberitahuan

Untuk mencegah Monitoring membuat pemberitahuan dan mengirim notifikasi selama jangka waktu tertentu, tunda kebijakan pemberitahuan terkait. Saat Anda menunda kebijakan pemberitahuan, pemberitahuan yang terkait dengan kebijakan pemberitahuan tetap terbuka, tetapi tidak menyebabkan notifikasi lebih lanjut. Pemberitahuan ditutup berdasarkan durasi penutupan otomatis kebijakan pemberitahuan.

Untuk membuat tunda pemberitahuan yang sedang Anda lihat, lakukan langkah berikut:

1. Di halaman Alert details, klik Snooze Policy.

2. Pilih durasi tunda. Setelah Anda memilih durasi tunda, penundaan akan segera dimulai.

Anda juga dapat menunda kebijakan pemberitahuan dari halaman Pemberitahuan dengan menemukan pemberitahuan yang ingin Anda tunda, mengklik  Opsi lainnya, lalu memilih Tunda. Anda dapat menunda kebijakan pemberitahuan selama gangguan untuk mencegah notifikasi lebih lanjut selama proses pemecahan masalah.

Menutup pemberitahuan

Anda dapat mengizinkan Monitoring menutup pemberitahuan untuk Anda, atau Anda dapat menutup pemberitahuan.

Monitoring akan otomatis menutup pemberitahuan saat durasi penutupan otomatis untuk kebijakan pemberitahuan berakhir. Secara default, durasi tutup otomatis adalah 7 hari. Durasi tutup otomatis minimum adalah 30 menit.

Durasi tutup otomatis menentukan waktu yang harus berlalu, tanpa pengulangan penyebab pemberitahuan, sebelum pemberitahuan ditutup. Untuk alasan ini, saat pemberitahuan terbuka dan penyebabnya muncul kembali, pemberitahuan dapat tetap terbuka lebih lama daripada durasi tutup otomatis.

Untuk menutup pemberitahuan, lakukan langkah-langkah berikut:

1. Di tabel Alerts pada halaman Alerting, klik See all alerts.

2. Di halaman Peringatan, temukan peringatan yang ingin Anda tutup, lalu lakukan salah satu tindakan berikut:

   • Klik  Lihat lainnya, lalu pilih Tutup pemberitahuan
   • Buka halaman Detail notifikasi untuk notifikasi tersebut, lalu klik Tutup notifikasi.

Jika Anda melihat pesan Unable to close alert, coba lagi dalam beberapa menit. Anda tidak dapat langsung menutup pemberitahuan baru karena kondisi yang menyebabkan pemberitahuan masih dianggap aktif oleh sistem pemberitahuan.

Retensi dan batas data

Untuk mengetahui informasi tentang batas dan periode retensi pemberitahuan, lihat Batas untuk pemberitahuan.

Langkah berikutnya

• Untuk membuat dan mengelola kebijakan pemberitahuan dengan Monitoring API atau dari command line, lihat Mengelola kebijakan pemberitahuan menurut API.