Mengelola pemberitahuan untuk kebijakan pemberitahuan berbasis SQL

Pemberitahuan Cloud Monitoring memungkinkan Anda melacak dan menyelidiki masalah saat hasil kueri SQL atas entri log yang dikelompokkan memenuhi kondisi kebijakan pemberitahuan berbasis SQL. Untuk setiap pemberitahuan, Monitoring mengirimkan notifikasi dan membuat halaman Alert details untuk membantu Anda memecahkan masalah kegagalan dan mengelola siklus proses pemberitahuan.

Di halaman Detail notifikasi, Anda dapat melihat ringkasan hasil kueri SQL dan link ke notifikasi terkait. Monitoring tidak akan membuat pemberitahuan jika kebijakan ditunda atau dinonaktifkan, atau jika jumlah kebijakan pemberitahuan atau pemberitahuan melebihi batas untuk pemberitahuan.

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

Sebelum memulai

Untuk mendapatkan izin yang Anda perlukan untuk melihat dan mengelola pemberitahuan, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

• Melihat pemberitahuan menggunakan Google Cloud CLI atau Cloud Monitoring API: Monitoring Alert Viewer (roles/monitoring.alertViewer)
• Melihat pemberitahuan 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 menampilkan daftar pemberitahuan di project Google Cloud Anda, lakukan tindakan 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 App Hub, pilih project host atau project pengelolaan App Hub.

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

   • Panel Ringkasan mencantumkan jumlah notifikasi terbuka.
   • Tabel Alerts menampilkan pemberitahuan terbuka terbaru. Untuk mencantumkan pemberitahuan terbaru dalam tabel, termasuk pemberitahuan 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 pemberitahuan, lihat bagian Menyelidiki pemberitahuan dalam dokumen ini.

Menemukan peringatan lama

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

• Untuk melihat halaman entri di tabel Alerts, klik  Newer atau  Older.

• Untuk membuka halaman yang memungkinkan Anda mencantumkan dan memfilter pemberitahuan, klik See all alerts. Halaman Notifikasi akan terbuka. Dari halaman tersebut, lakukan hal berikut:

  • Tampilkan semua pemberitahuan, termasuk pemberitahuan 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 buat pilihan 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 tindakan berikut:

1. Di halaman Alerts, klik  Filter table, lalu pilih properti filter. Properti filter mencakup hal berikut:

   • Status pemberitahuan
   • Nama kebijakan pemberitahuan
   • Kapan pemberitahuan dibuka atau ditutup

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

   Tabel Notifikasi kemudian akan mencantumkan filter.

gcloud

Anda dapat menggunakan gcloud untuk mendapatkan pemberitahuan dan membuat daftar pemberitahuan.

Dapatkan 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 menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label yang dilampirkan, 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": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

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 menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label yang dilampirkan, 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": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}

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

• --filter: Berikan ekspresi filter untuk memfilter pemberitahuan berdasarkan waktu atau 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 menghasilkan daftar URI resource, bukan output default.

• --limit: Tetapkan 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 membuat daftar pemberitahuan.

Dapatkan 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 menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label yang dilampirkan, dan kebijakan pemberitahuan sumber. Responsnya terlihat mirip dengan yang berikut ini:

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

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 menampilkan respons dengan detail pemberitahuan seperti status pemberitahuan, label yang dilampirkan, dan kebijakan pemberitahuan sumber. Responsnya terlihat mirip dengan yang berikut ini:

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}

Pengguna curl dapat menambahkan flag --data-urlencode diikuti dengan ekspresi filter untuk memfilter notifikasi berdasarkan 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 notifikasi 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 di antara 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"`\")"

Membuat daftar & memfilter pemberitahuan 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 pemberitahuan berisi informasi yang dapat membantu Anda mengidentifikasi penyebab pemberitahuan.

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

Menjelajahi hasil kueri

Panel Query information menunjukkan apakah kueri kebijakan pemberitahuan berjalan di slot on demand BigQuery atau di pemesanan. Panel ini juga menunjukkan estimasi byte yang dipindai dan waktu slot yang digunakan per hari, berdasarkan kueri yang berjalan dalam tujuh hari terakhir.

Panel SQL query results menampilkan daftar ringkasan hasil kueri dari setiap kali Observability Analytics menjalankan kueri SQL dari kondisi kebijakan pemberitahuan. Secara default, daftar difilter untuk hanya menampilkan kueri yang cocok dengan kondisi kebijakan pemberitahuan.

• Untuk melihat kueri dan tabel hasil kueri dari waktu tertentu saat Observability Analytics menjalankan kueri, klik nilai dari kolom Query run time.
• Untuk beralih antara hanya menampilkan hasil kueri yang cocok dengan kondisi kebijakan pemberitahuan dan semua kueri yang dijalankan Observability Analytics dari kebijakan pemberitahuan, klik Show only queries matching alert conditions.

Melihat informasi tambahan

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 Documentation akan menampilkan "No documentation is configured".

Menjelajahi pemberitahuan terkait

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

Bagian Related alerts menampilkan daftar pemberitahuan lain yang dibuat saat kondisi kebijakan pemberitahuan terpenuhi.

Kelola notifikasi

Notifikasi berada dalam salah satu status berikut:

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

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

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

Mengonfirmasi pemberitahuan

Sebaiknya tandai pemberitahuan sebagai diakui saat Anda mulai menyelidiki penyebab pemberitahuan.

Untuk menandai pemberitahuan sebagai diakui, lakukan hal berikut:

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

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

   • Klik  More options, lalu pilih Acknowledge.
   • Buka halaman detail untuk pemberitahuan, lalu klik Acknowledge alert.

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 akan ditutup berdasarkan durasi penutupan otomatis kebijakan pemberitahuan.

Untuk membuat penundaan pemberitahuan yang sedang Anda lihat, lakukan hal berikut:

1. Di halaman Alert details, klik Snooze Policy.

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

Anda juga dapat menunda kebijakan pemberitahuan dari halaman Alerts dengan menemukan pemberitahuan yang ingin Anda tunda, mengklik  More options, lalu memilih Snooze. Anda dapat menunda kebijakan pemberitahuan selama pemadaman layanan untuk mencegah notifikasi lebih lanjut selama proses pemecahan masalah.

Tutup pemberitahuan

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

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

Durasi tutup otomatis menentukan waktu yang harus berlalu, tanpa pengulangan penyebab pemberitahuan, sebelum pemberitahuan ditutup. Oleh karena itu, saat pemberitahuan terbuka dan penyebabnya terjadi lagi, pemberitahuan dapat tetap terbuka lebih lama dari durasi penutupan otomatis.

Untuk menutup pemberitahuan, lakukan tindakan berikut:

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

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

   • Klik  Lihat lainnya, lalu pilih Tutup pemberitahuan
   • Buka halaman Alert details untuk pemberitahuan tersebut, lalu klik Close alert.

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 berdasarkan API.