Membuat dan mengelola penundaan

Konsol

Konsol Google Cloud menyediakan dua cara untuk membuat jeda:

• Jika Anda memulai dari halaman Detail pemberitahuan dari pemberitahuan yang terbuka, dialog yang Anda selesaikan untuk membuat penundaan telah dikonfigurasi sebelumnya untuk mencantumkan kebijakan pemberitahuan Anda. Dialog ini juga memungkinkan Anda memilih label, yang dilampirkan ke tunda sebagai filter berbasis label.

• Jika memulai dari halaman Pemberitahuan, Anda dapat membuat penundaan yang kriteria pemberitahuannya mencantumkan hingga 16 kebijakan pemberitahuan. Namun, Anda tidak dapat melampirkan filter berbasis label ke penundaan meskipun kriteria penundaan mencantumkan satu kebijakan pemberitahuan.

Untuk membuat penundaan dari pemberitahuan terbuka, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications 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.
3. Di panel Alerts pada halaman Alerting, temukan pemberitahuan Anda dan klik Alert summary.
4. Di halaman Detail pemberitahuan, klik Tunda, lalu pilih durasi penundaan.

5. Opsional: Untuk menambahkan filter berbasis label ke tunda, buka bagian Label dan pilih satu atau beberapa label. Filter berbasis label dapat menyertakan label resource dan metrik. Jika kebijakan pemberitahuan tidak berbasis PromQL, filter juga dapat menyertakan label metadata.

   Biasanya, penundaan berlaku untuk semua pemberitahuan yang dibuat oleh kebijakan pemberitahuan. Filter memungkinkan Anda menerapkan penundaan ke pemberitahuan yang labelnya cocok dengan label dalam filter.

6. Klik Tunda. Penundaan kini berlaku untuk kebijakan pemberitahuan yang membuat pemberitahuan.

Untuk membuat penundaan dari halaman Alerting, lakukan langkah berikut:

1. Di konsol Google Cloud , buka halaman notifications 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.
3. Di halaman Alerting, klik Create snooze.
4. Masukkan nama deskriptif untuk penundaan. Nama ini ditampilkan di halaman Alerting.
5. Pilih Waktu mulai. Anda dapat memasukkan waktu tertentu atau memulai penundaan saat penundaan dibuat.
6. Masukkan Durasi. Nilai kolom ini menentukan durasi tunda.

7. Lengkapi bagian Kriteria tunda. Anda dapat menggunakan menu Kebijakan pemberitahuan untuk memilih kebijakan pemberitahuan yang akan ditangguhkan.

   Anda dapat menambahkan hingga 16 kebijakan pemberitahuan ke penundaan.

   Setelah penundaan dibuat, kriteria penundaan tidak dapat diubah.

   Setelah Anda menyelesaikan bagian Kriteria tunda, panel Buat penundaan mencantumkan pemberitahuan sebelumnya yang cocok dengan kriteria.

8. Klik Create.

gcloud

gcloud CLI memungkinkan Anda membuat jeda yang kriteria daftarnya hingga 16 kebijakan pemberitahuan. Jika penundaan berlaku untuk satu kebijakan pemberitahuan, Anda juga dapat menyertakan filter berbasis label.

Untuk membuat snooze, jalankan perintah gcloud monitoring snoozes create:

gcloud monitoring snoozes create --criteria-policies=LIST_OF_POLICIES --display-name=DISPLAY_NAME --start-time=START_TIME --end-time=END_TIME --project=PROJECT_ID --criteria-filter=FILTER

Sebelum Anda menjalankan perintah sebelumnya, ganti hal berikut:

• LIST_OF_POLICIES: Kebijakan yang akan diterapkan penundaan. Jika Anda menentukan beberapa project, pisahkan project dengan koma.
• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• DISPLAY_NAME: Nama yang akan ditampilkan di konsol Google Cloud .
• START_TIME: Waktu mulai.

• END_TIME : Waktu berakhir. Nilai harus minimal satu menit lebih lambat dari waktu mulai.

  Untuk waktu mulai dan berakhir, Anda harus mengikuti aturan pemformatan ISO 8601. Namun, Anda dapat menentukan waktu absolut atau relatif. Contoh berikut menentukan waktu absolut. Untuk memulai penundaan 30 menit dari waktu saat ini, gunakan --start-time="+PTM30M".

• FILTER: Opsional. Filter berbasis label dapat ditentukan saat penundaan berlaku untuk satu kebijakan pemberitahuan. Filter, yang dapat mencakup label resource, metrik, dan metadata, menerapkan penundaan pada pemberitahuan dengan label yang cocok. Jika kebijakan pemberitahuan berbasis PromQL, filter tidak dapat menggunakan label metadata. Untuk informasi selengkapnya, lihat halaman referensi gcloud monitoring snoozes create.

Misalnya, perintah berikut akan membuat penundaan untuk kebijakan pemberitahuan dengan ID "12345". Rentang waktu penundaan adalah interval dari 1 Maret 2025 hingga 7 Maret 2025.

gcloud monitoring snoozes create --display-name="Maintenance Week" \
    --criteria-policies="projects/my-project/alertPolicies/12345" \
    --start-time="2025-03-01T03:00:00.0-0500" \
    --end-time="2025-03-07T23:59:59.5-0500" \
    --project=PROJECT_ID

Contoh sebelumnya membuat penundaan berikut di my-project:

{
  "name": "projects/my-project/snoozes/778899",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/12345"
    ]
  },
  "interval": {
    "startTime": "2025-03-01T03:00:00.0-0500",
    "endTime": "2025-03-07T23:59:59.5-0500"
  },
  "displayName": "Maintenance Week"
}

Jika berhasil, respons untuk perintah ini akan mirip dengan berikut ini:

Created snooze [projects/my-project/snoozes/778899]

Nama kebijakan pemberitahuan tidak ditampilkan di konsol Google Cloud . Untuk menentukan nama kebijakan pemberitahuan, lakukan salah satu tindakan berikut:

• Jalankan perintah gcloud monitoring policies list. Data respons dari perintah ini mencakup nama kebijakan pemberitahuan Anda.
• Melihat representasi JSON dari kebijakan pemberitahuan. Anda dapat mendownload representasi JSON ke sistem lokal dengan menggunakan opsi di halaman Detail kebijakan.

REST

Cloud Monitoring API memungkinkan Anda membuat snooze yang kriterianya mencantumkan hingga 16 kebijakan pemberitahuan. Jika pemberitahuan tunda berlaku untuk satu kebijakan pemberitahuan, Anda juga dapat menyertakan filter berbasis label.

Untuk membuat snooze, panggil metode snoozes.create dengan mengirimkan permintaan POST ke endpoint Snooze. Anda harus menyediakan objek snooze:

curl -d @my-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-X POST https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes

Dalam ekspresi sebelumnya, PROJECT_ID adalah variabel lingkungan yang menyimpan project ID Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

Metode ini akan menampilkan objek snooze. Kolom "name", yang menyertakan ID snooze yang dihasilkan oleh Monitoring, adalah satu-satunya perbedaan antara objek yang ditampilkan dan konten my-snooze.json:

{
  "name": "projects/my-project/snoozes/778899",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/001122"
    ]
  },
  "interval": {
    "startTime": "2022-11-12T19:00:20Z",
    "endTime": "2022-11-12T19:05:20Z"
  },
  "displayName": "Snooze2"
}

Konsol

Untuk melihat daftar penundaan, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications 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.

3. Klik Lihat semua tunda di panel Tunda.

   Halaman Tunda menampilkan daftar penundaan dan linimasa yang secara grafis menampilkan penundaan Anda yang lalu, yang akan datang, dan yang aktif.

   • Untuk mengedit, menyalin, membatalkan, atau mengakhiri penundaan, gunakan menu more_vert Opsi lainnya untuk penundaan. Status tunda menentukan opsi yang tersedia.
   • Untuk mencantumkan semua tunda, aktifkan Tampilkan tunda sebelumnya. Secara default, hanya tunda yang aktif dan akan datang yang dicantumkan.
   • Untuk mengubah periode tampilan tabel Linimasa, gunakan menu Rentang waktu. Secara default, tabel menampilkan data untuk satu jam berikutnya; namun, Anda dapat mengubah kolom ini untuk menentukan rentang waktu sebelumnya atau mendatang. Tunda yang sudah berakhir akan dipertahankan selama 13 bulan.
   • Untuk melihat detail tentang penundaan tertentu, klik Lihat detail.
   • Untuk melihat ringkasan penundaan aktif, arahkan kursor ke area yang diarsir pada baris Aktif di tabel Linimasa. Tooltip menampilkan informasi ringkasan.
   • Untuk melihat representasi grafis tunda aktif, luaskan baris Aktif pada tabel Linimasa.

gcloud

Untuk mencantumkan tunda di project Anda saat ini, jalankan perintah gcloud monitoring snoozes list:

gcloud monitoring snoozes list --project=PROJECT_ID OPTIONAL_FLAGS

Sebelum menjalankan perintah sebelumnya, ganti perintah berikut:

• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• OPTIONAL_FLAGS: Untuk mengetahui informasi tentang flag opsional, lihat halaman referensi gcloud monitoring snoozes list.

Respons terhadap perintah ini adalah daftar nama snooze dalam project, yang diformat sebagai YAML. Misalnya, respons terhadap perintah ini untuk projectGoogle Cloud dengan ID my-project adalah satu entri:

criteria:
  policies:
  - projects/my-project/alertPolicies/12345
  - projects/my-project/alertPolicies/23451
displayName: Maintenance Week
interval:
  endTime: '2023-03-08T04:59:59Z'
  startTime: '2023-03-01T08:00:00Z'
name: projects/my-project/snoozes/778899

Untuk menampilkan detail tentang penundaan tertentu, jalankan perintah gcloud monitoring snoozes describe:

gcloud monitoring snoozes describe NAME --project=PROJECT_ID

Misalnya, untuk menampilkan detail tentang snooze dengan nama projects/my-project/snoozes/778899, jalankan perintah berikut:

gcloud monitoring snoozes describe projects/my-project/snoozes/778899 --project=PROJECT_ID

Jika Anda memberikan NAME yang tidak valid ke perintah describe, responsnya akan berisi kode error 500 dan pesan berikut:

Internal error encountered. Please retry after a few seconds. If internal errors persist, contact support at https://cloud.google.com/support/docs.

REST

Untuk mencantumkan semua penundaan yang termasuk dalam project Google Cloud , panggil metode snoozes.list:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes

Pada ekspresi sebelumnya, PROJECT_ID adalah variabel lingkungan yang menyimpan project ID Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

Metode ini menampilkan daftar objek snooze. Misalnya, jika project memiliki satu snooze, respons terhadap perintah snoozes.list akan mirip dengan berikut ini:

{
  "name": "projects/my-project/snoozes/778899",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/12345"
    ]
  },
  "interval": {
    "startTime": "2025-03-01T03:00:00.0-0500",
    "endTime": "2025-03-07T23:59:59.5-0500"
  },
  "displayName": "Snooze2"
}

Untuk mendapatkan informasi tentang snooze tertentu, panggil metode snoozes.get dan tentukan project ID dan ID snooze. Dalam respons sebelumnya, ID snooze adalah 2986663705844383744:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}

Metode ini menampilkan satu objek snooze:

{
  "name": "projects/my-project/snoozes/778899",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/12345"
    ]
  },
  "interval": {
    "startTime": "2025-03-01T03:00:00.0-0500",
    "endTime": "2025-03-07T23:59:59.5-0500"
  },
  "displayName": "Snooze2"
}

Konsol

Untuk mengedit penundaan, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications 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.
3. Klik Lihat semua penundaan di panel Tunda.
4. Dalam daftar penundaan, temukan penundaan yang ingin Anda edit, lalu pilih Edit penundaan di menu more_vert Opsi lainnya.
5. Klik Simpan setelah Anda menyelesaikan perubahan.

gcloud

Untuk mengedit penundaan, jalankan perintah gcloud monitoring snoozes update. Anda dapat memperbarui nama tampilan, waktu mulai, dan waktu berakhir:

gcloud monitoring snoozes update NAME --project=PROJECT_ID OPTIONAL_FLAGS

Sebelum menjalankan perintah sebelumnya, ganti variabel berikut:

• NAME: Nama penundaan.
• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
• OPTIONAL_FLAGS: Untuk mengetahui informasi tentang flag opsional, lihat halaman referensi gcloud monitoring snoozes update.

Misalnya, untuk mengubah nama tampilan penundaan dengan nama projects/my-project/snoozes/778899, jalankan perintah berikut:

gcloud monitoring snoozes update projects/my-project/snoozes/778899 --display-name="Maintenance Week" --project=PROJECT_ID

REST

Untuk mengubah penundaan yang ada, panggil metode snoozes.patch dengan mengirimkan permintaan PATCH ke endpoint Snooze. Anda harus menyediakan objek snooze yang direvisi dan menyertakan parameter kueri yang mengidentifikasi kolom yang diubah. Saat menggunakan curl, parameter kueri harus dienkode URL.

Untuk penundaan mendatang, Anda dapat mengubah nama dan periodenya. Untuk penundaan aktif, Anda dapat mengubah nama dan waktu berakhirnya. Anda tidak dapat mengubah tunda sebelumnya.

Untuk memperbarui displayName penundaan, buat file JSON, my-updated-snooze.json, yang mendeskripsikan objek penundaan dan memperbarui nama tampilan. Kemudian, jalankan perintah berikut:

curl -d @my-updated-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-X PATCH https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}?updateMask=displayName

Dalam ekspresi sebelumnya:

• PROJECT_ID adalah variabel lingkungan yang menyimpan ID project Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

• SNOOZE_ID adalah variabel lingkungan yang menyimpan ID penundaan.

Metode ini menampilkan objek snooze yang identik dengan isi file my-updated-snooze.json:

{
  "name": "projects/my-project/snoozes/778899",
  "criteria": {
    "policies": [
      "projects/my-project/alertPolicies/12345"
    ]
  },
  "interval": {
    "startTime": "2025-03-01T03:00:00.0-0500",
    "endTime": "2025-03-07T23:59:59.5-0500"
  },
  "displayName": "Snooze2"
}

Konsol

Untuk mengakhiri tunda aktif atau membatalkan tunda mendatang, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications 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.
3. Klik Lihat semua penundaan di panel Tunda.

4. Dalam daftar penundaan, temukan penundaan yang ingin Anda akhiri atau batalkan, lalu lakukan salah satu tindakan berikut:

   • Untuk mengakhiri penundaan aktif, pilih Akhiri sekarang di menu more_vert Opsi lainnya.
   • Untuk membatalkan penundaan mendatang, pilih Batalkan penundaan di menu more_vert Opsi lainnya.

gcloud

Untuk mengakhiri penundaan aktif atau membatalkan penundaan yang akan datang, jalankan perintah gcloud monitoring snoozes cancel:

gcloud monitoring snoozes cancel NAME --project=PROJECT_ID

Sebelum menjalankan perintah sebelumnya, ganti perintah berikut:

• NAME: Nama penundaan.
• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

Misalnya, untuk membatalkan penundaan dengan nama projects/my-project/snoozes/778899, jalankan perintah berikut:

gcloud monitoring snoozes cancel projects/my-project/snoozes/778899 --project=PROJECT_ID

REST

Untuk mengakhiri penundaan yang aktif, edit penundaan dan tetapkan waktu berakhir ke waktu saat ini. Untuk mengetahui informasi selengkapnya, lihat Mengedit tunda.

Untuk membatalkan penundaan mendatang, edit penundaan dan tetapkan waktu berakhir ke waktu mulai penundaan. Waktu mulai harus pada masa mendatang. Untuk mengetahui informasi selengkapnya, lihat Mengedit tunda.