Menyiapkan pemberitahuan berbasis kueri menggunakan MQL

Menyiapkan pemberitahuan berbasis kueri menggunakan MQL

Dokumen ini menunjukkan cara menggunakan Bahasa Kueri Monitoring (MQL) untuk mempelajari metrik, membuat diagram, dan menyiapkan pemberitahuan berbasis kueri di Konsol Google Cloud. Jika Anda lebih suka menggunakan Cloud Monitoring API, lihat Membuat kondisi untuk kebijakan pemberitahuan.

Dalam dokumen ini, Anda akan melakukan hal berikut:

1. Buat instance Compute Engine.

2. Buka editor kode.

3. Lakukan kueri dan buat diagram.

4. Menyiapkan pemberitahuan berbasis kueri.

Sebelum memulai

Untuk menggunakan MQL, Anda harus membuat project Google Cloud dan mengaktifkan penagihan.

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Make sure that billing is enabled for your Google Cloud project.

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

5. Make sure that billing is enabled for your Google Cloud project.

Berikutnya, konfigurasikan izin dan saluran notifikasi.

1. Untuk mendapatkan izin yang diperlukan untuk membuat kebijakan pemberitahuan dengan kondisi berbasis MQL, 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.

   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.

2. Pastikan Anda sudah memahami konsep umum kebijakan pemberitahuan, MQL, dan editor kode. Untuk informasi selengkapnya, lihat topik berikut:

   • Ringkasan pemberitahuan
   • Kebijakan pemberitahuan dengan MQL
   • Menggunakan editor kode untuk MQL

Membuat instance Compute Engine

Agar memiliki resource Google Cloud yang metriknya akan dikumpulkan, buat instance Compute Engine dengan menyelesaikan langkah-langkah berikut:

1. Dari menu Konsol Google Cloud, pilih Compute Engine.

   

2. Pilih Create instance, lalu klik Create.

Catatan: Jika Anda mengalami masalah saat membuat instance, lihat Panduan memulai menggunakan VM Linux.

Membuka editor kode

Untuk mulai menggunakan MQL, lakukan hal berikut:

1. Di panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Metrics Explorer:

   Buka Metrics Explorer

2. Di toolbar panel pembuat kueri, pilih tombol dengan nama  MQL atau  PromQL.
3. Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

Menggunakan editor kode untuk membuat, menguji, dan menjalankan kueri MQL.

Melakukan kueri dan membuat diagram

Buat kueri yang memetakan penggunaan CPU instance Anda:

1. Tempel kueri berikut ke dalam editor kode:

   fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
   | {
       top 1, max(val())
     ;
       bottom 1, min(val())
     }
   | union
   

   Kueri ini memilih deret waktu dengan pemakaian CPU maksimum dan minimum untuk diagram. Untuk informasi selengkapnya tentang kueri ini, lihat Menggabungkan pilihan dengan union.

2. Klik Run Query. Diagram ini menampilkan dua baris, yang menunjukkan penggunaan CPU maksimum dan minimum instance Anda:

   

3. Untuk menyimpan diagram, klik Simpan Diagram. Beri nama pada diagram dan tambahkan ke dasbor yang ada atau yang baru. Kemudian, klik Simpan.

Diagram dapat diakses dengan membuka halaman Monitoring overview, atau jika Anda menyimpannya ke dasbor, dengan membuka halaman dasbor tersebut.

Menyiapkan pemberitahuan berbasis kueri

Anda dapat membuat kebijakan pemberitahuan yang memantau hasil kueri. Untuk membuat kebijakan pemberitahuan tersebut, selesaikan langkah-langkah berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Alerting:

   Buka Alerting

2. Dari halaman Alerting, klik Edit Notification Channels. Pada langkah ini, Anda akan mengonfigurasi alamat email untuk menerima notifikasi.

   1. Di halaman Notification channels, buka Email lalu klik Add new.

   2. Masukkan alamat email yang akan dikirimi notifikasi pemberitahuan di kolom Alamat Email.

   3. Masukkan deskripsi singkat tentang saluran ini, seperti "Alert on-call", di kolom Display name.

   4. Klik Simpan.

   5. Kembali ke halaman Alerting dengan mengklik Back di header halaman.

3. Dari halaman Alerting, klik Create Policy.

   Halaman ini akan memandu Anda melakukan langkah-langkah untuk membuat kebijakan pemberitahuan:

   1. Mendeskripsikan hal yang ingin Anda tampilkan pemberitahuannya.
   2. Memberikan informasi tentang cara mengatasi masalah ini.
   3. Menentukan saluran notifikasi untuk pemberitahuan.

4. Untuk menjelaskan hal yang ingin Anda beri peringatan, klik Kondisi Baru. Tindakan ini akan memunculkan editor kondisi berbasis formulir.

   1. Di bagian Policy configuration mode, pilih Code editor (MQL atau PromQL).

   2. Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang memungkinkan Anda memformat kueri.

   3. Masukkan kueri yang memilih data yang ingin Anda pantau di editor kode. Kueri berikut memicu pemberitahuan saat waktu penggunaan CPU instance Anda tetap lebih dari 20 detik:

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 20 's'
      

      Operasi condition menetapkan nilai minimum performa yang ingin Anda beri tahu. Untuk mengetahui informasi selengkapnya tentang condition dan operasi pemberitahuan lainnya, lihat Pemberitahuan dalam referensi MQL.

      Jika Auto-run diaktifkan, diagram MQL akan menampilkan data yang dipilih dan garis nilai minimum:

      

   4. Untuk mengonfigurasi pemicu pemberitahuan, klik Berikutnya:

      1. Di menu Alert trigger, pilih jumlah deret waktu yang harus memenuhi operasi pemberitahuan sebelum kebijakan pemberitahuan dapat dipicu. Anda dapat memilih dari kriteria berikut:

         • Satu deret waktu.
         • Sejumlah deret waktu tertentu.
         • Persentase deret waktu.
         • Semua deret waktu.

      2. Opsional: Luaskan menu Opsi lanjutan, dan di kolom Pemicu saat kondisi terpenuhi untuk jumlah waktu ini, masukkan atau pilih nilai.

         Kolom ini menentukan berapa lama kondisi harus dipenuhi sebelum kebijakan pemberitahuan dipicu. Jendela pengujian ulang tidak sama dengan jendela penyelarasan yang digunakan dalam kueri MQL. Untuk mengetahui informasi selengkapnya tentang hubungan antara nilai-nilai ini, lihat Periode penyelarasan dan durasi.

      3. Masukkan nama untuk kondisi Anda, seperti "Kondisi MQL dasar".

5. Untuk menyiapkan notifikasi, dokumentasi, dan nama kebijakan pemberitahuan, klik Next.

   1. Pilih saluran notifikasi yang Anda buat sebelumnya.

   2. Pilih tingkat keparahan.

   3. Masukkan beberapa teks yang akan dikirim dengan notifikasi pemberitahuan di kolom Documentation. Teks ini biasanya memberikan informasi kepada responden untuk membantu mereka mengatasi masalah. Untuk latihan ini, masukkan "Penggunaan CPU Anda telah melebihi 20 detik".

   4. Masukkan nama untuk kebijakan pemberitahuan di kolom Alert policy name. Nilai ini memungkinkan Anda membedakan notifikasi dari berbagai kebijakan pemberitahuan.

6. Simpan kebijakan dengan mengklik Buat kebijakan.

Pembersihan

Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

1. Buka halaman Identity and Access Management di Konsol Google Cloud:

   Buka setelan project

2. Klik Shut Down dan ikuti petunjuknya.

Langkah selanjutnya

• Pelajari lebih lanjut cara menggunakan editor kode.
• Pelajari serangkaian contoh MQL.
• Pelajari lebih lanjut kebijakan pemberitahuan berbasis MQL.
• Pelajari cara memanggil kueri MQL dari Cloud Monitoring API.
• Pelajari detail MQL di Referensi MQL.
• Baca referensi kami tentang DevOps dan jelajahi program riset DORA.