Membuat dan mengelola penundaan

console

Di konsol Google Cloud , Anda dapat membuat penundaan dari insiden yang terbuka atau dari halaman Pemberitahuan. Anda hanya dapat membuat tunda dengan filter menggunakan halaman detail insiden.

Untuk membuat tunda dari insiden yang terbuka, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman notifications Pemberitahuan:

   Buka Alerting

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Di panel Incidents pada halaman Alerting, temukan insiden Anda dan klik Incident summary.
4. Di halaman Detail insiden, 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 mencakup label resource dan metrik. Jika kebijakan pemberitahuan tidak berbasis PromQL, filter juga dapat menyertakan label metadata.

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

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

Untuk membuat penundaan dari halaman Alerting, lakukan langkah berikut:

1. Di konsol Google Cloud , buka halaman notifications Pemberitahuan:

   Buka Alerting

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Di halaman Alerting, klik Buat jeda.
4. Masukkan nama deskriptif untuk tunda. Nama ini ditampilkan di halaman Pemberitahuan.
5. Pilih Waktu mulai. Anda dapat memasukkan waktu tertentu atau memulai tunda saat tunda 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 ditunda.

   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 insiden sebelumnya yang cocok dengan kriteria.

8. Klik Buat.

Cloud Monitoring API

Untuk membuat penundaan, 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

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

Metode ini menampilkan objek snooze. Kolom "name", yang mencakup ID tunda 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"
}

gcloud CLI

Untuk membuat tunda, 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 menjalankan perintah sebelumnya, ganti perintah berikut:

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

• END_TIME : Waktu berakhir. Nilainya harus setidaknya satu menit lebih lambat daripada 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 tunda 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 insiden 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 tunda 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 tunda 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 terhadap perintah ini akan terlihat seperti berikut:

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

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

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

console

Untuk melihat daftar tunda, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman notifications Pemberitahuan:

   Buka Alerting

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

3. Klik Lihat semua penundaan di panel Tunda.

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

   • Untuk mengedit, menyalin, membatalkan, atau mengakhiri tunda, gunakan menu more_vert Opsi lainnya untuk tunda. 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 disimpan 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.

Cloud Monitoring API

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 App Hub atau project pengelolaan folder yang mendukung aplikasi.

Metode ini menampilkan daftar objek snooze. Misalnya, jika project memiliki satu penundaan, 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 penundaan tertentu, panggil metode snoozes.get dan tentukan project ID dan ID penundaan. Dalam respons sebelumnya, ID tunda 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"
}

gcloud CLI

Untuk mencantumkan penundaan di project 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 App Hub atau project pengelolaan folder yang mendukung aplikasi.
• OPTIONAL_FLAGS: Untuk mengetahui informasi tentang tanda opsional, lihat halaman referensi gcloud monitoring snoozes list.

Respons terhadap perintah ini adalah daftar nama tunda 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 mencantumkan detail tentang penundaan tertentu, jalankan perintah gcloud monitoring snoozes describe:

gcloud monitoring snoozes describe NAME --project=PROJECT_ID

Misalnya, untuk menampilkan detail tentang tunda 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, respons 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.

console

Untuk mengedit penundaan, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications Pemberitahuan:

   Buka Alerting

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Klik Lihat semua penundaan di panel Tunda.
4. Dalam daftar tunda, temukan tunda yang ingin Anda edit, lalu pilih Edit tunda di menu Opsi lainnya more_vert.
5. Klik Simpan setelah Anda menyelesaikan perubahan.

Cloud Monitoring API

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

Untuk tunda yang akan datang, Anda dapat mengubah nama dan periode. Untuk penundaan aktif, Anda dapat mengubah nama dan waktu berakhir. Anda tidak dapat mengubah tunda sebelumnya.

Untuk memperbarui displayName penundaan, buat file JSON, my-updated-snooze.json, yang menjelaskan 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

Pada ekspresi sebelumnya:

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

• SNOOZE_ID adalah variabel lingkungan yang menyimpan ID penundaan.

Metode ini menampilkan objek snooze yang identik dengan konten 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"
}

gcloud CLI

Untuk mengedit tunda, 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 perintah berikut:

• NAME: Nama tunda.
• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
• OPTIONAL_FLAGS: Untuk mengetahui informasi tentang tanda opsional, lihat halaman referensi gcloud monitoring snoozes update.

Misalnya, untuk mengubah nama tampilan tunda 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

console

Untuk mengakhiri tunda yang aktif atau membatalkan tunda yang akan datang, lakukan tindakan berikut:

1. Di konsol Google Cloud , buka halaman notifications Pemberitahuan:

   Buka Alerting

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

2. Di toolbar konsol Google Cloud , pilih Google Cloud project Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.
3. Klik Lihat semua penundaan di panel Tunda.

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

   • Untuk mengakhiri tunda yang aktif, pilih Akhiri sekarang di menu more_vert Opsi lainnya.
   • Untuk membatalkan tunda yang akan datang, pilih Batalkan tunda di menu more_vert Opsi lainnya.

Cloud Monitoring API

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

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

gcloud CLI

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 tunda.
• PROJECT_ID: ID project. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mendukung aplikasi.

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

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