Menggunakan editor kode untuk PromQL

Halaman ini menjelaskan cara menggunakan editor kode untuk PromQL. Editor tersedia di Google Cloud Console dan memberikan saran serta alat lainnya untuk membuat kueri PromQL yang valid.

Halaman ini tidak mencakup bahasa PromQL; untuk informasi tentang PromQL, sebaiknya baca dokumentasi open source. Referensi berikut dapat membantu Anda memulai:

Mengakses editor kode

Anda dapat mengakses PromQL dari halaman berikut di Konsol Google Cloud:

  • Metrics Explorer
  • Menambahkan widget saat membuat dasbor

Untuk membuka editor kode saat menggunakan Metrics Explorer, lakukan langkah berikut:

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

    Buka Metrics Explorer

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

Menggunakan editor kode

Untuk menggunakan editor kode, ketik kueri dalam kolom teks, lalu klik Run Query.

Pelengkapan otomatis

Saat Anda mengetik kueri, editor akan menampilkan daftar penyelesaian yang valid secara sintaksis. Anda dapat menampilkan menu pelengkapan otomatis secara manual dengan menekan Control+Space, dan Anda dapat menutupnya dengan menekan Escape.

Untuk membuka daftar opsi, gunakan tombol panah. Menekan Enter akan menyisipkan pilihan yang dipilih.

Untuk menyisipkan awalan yang umum ke semua pilihan yang tersedia, tekan Tab.

Cari dan ganti

Editor mendukung fitur cari dan ganti. Untuk menemukan, dan jika ingin mengganti istilah dalam kueri Anda, tekan Control+F (atau Command+F di Mac). Screenshot berikut menunjukkan fitur:

editor kode mendukung fitur {i>find-and-replace<i}.

Kontrol editor

Editor memiliki dua kontrol yang menentukan cara editor berinteraksi dengan kueri Anda.

Secara default, kueri hanya dijalankan saat Anda mengklik Jalankan Kueri. Anda dapat menyiapkan editor untuk otomatis mengeksekusi kueri saat mengetik, tetapi opsi ini dinonaktifkan secara default.

Untuk mengaktifkan opsi jalankan otomatis, gunakan tombol Auto-run. Jika opsi ini diaktifkan, editor berfungsi sebagai berikut:

  • Tombol Run Query tidak ditampilkan.
  • Pesan error muncul terus-menerus saat Anda mengetik.

  • Jika kursor berada di akhir kueri yang tidak lengkap tetapi tidak memiliki error, editor akan menampilkan segitiga kuning di panel kontrol. Jika ada ruang, teks Kueri tidak lengkap juga akan muncul.

    Editor tidak berupaya mengevaluasi kueri yang tidak lengkap.

Ada juga Grab-bar antara editor kode dan region diagram. Gunakan batang ini untuk mengubah ukuran relatif kedua wilayah.

Simpan diagram

Cara menyimpan diagram bergantung pada konteks saat Anda membuat diagram:

  • Dari Metrics Explorer.
  • Sebagai bagian dari pembuatan atau pengeditan dasbor kustom.

Menyimpan diagram dari Metrics Explorer

Dari editor kode di Metrics Explorer, Anda memiliki opsi untuk menyimpan diagram ke dasbor kustom. Untuk menyimpan diagram, lakukan langkah-langkah berikut:

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

    Buka Metrics Explorer

  2. Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah  MQL atau  PromQL.
  3. Pastikan PromQL dipilih pada tombol Language. Tombol bahasa berada di toolbar yang sama dengan yang memungkinkan Anda memformat kueri.
  4. Masukkan kueri Anda di editor.

  5. Jika opsi jalankan otomatis tidak diaktifkan untuk editor kode, jalankan kueri Anda dengan mengklik Run Query sebelum menyimpan diagram. Secara default, dasbor kustom menyimpan perubahan Anda secara berkala. Jika Anda tidak menjalankan kueri terlebih dahulu, editor kode akan menyimpan kueri terakhir yang Anda jalankan.

  6. Klik Save Chart.

  7. Untuk terus menyimpan diagram:

    1. Berikan judul deskriptif pada diagram.
    2. Pilih dasbor yang diinginkan untuk diagram baru.
    3. Klik Simpan pada dialog.

Menyimpan diagram di dasbor kustom

Untuk menyimpan diagram baru ke dasbor Anda, lakukan tindakan berikut:

  1. Berikan judul deskriptif pada diagram.

  2. Jika opsi jalankan otomatis tidak diaktifkan untuk editor kode, jalankan kueri Anda dengan mengklik Run Query sebelum menyimpan diagram. Secara default, dasbor kustom menyimpan perubahan Anda secara berkala. Jika Anda tidak menjalankan kueri terlebih dahulu, editor kode akan menyimpan kueri terakhir yang Anda jalankan.

  3. Jika Anda tidak mengaktifkan simpan otomatis untuk dasbor, klik Save.

Konsol Google Cloud mendukung filter tingkat halaman untuk dasbor kustom. Filter ini didukung untuk diagram PromQL di dasbor kustom Anda.

Keluar dari editor kode

Untuk keluar dari editor kode tanpa menyimpan kueri, klik salah satu tab pemilih lainnya. Teks kueri apa pun di editor akan dibuang, tetapi Anda diberi opsi untuk menyimpannya ke {i>clipboard<i}.