Connect ke sumber data Google Cloud Monitoring - Amazon Managed Grafana
Menambahkan sumber dataAutentikasiMenggunakan editor kueriTemplatingAnotasiPenautan mendalam dari panel Grafana ke Metrics Explorer di Google Cloud Console

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Connect ke sumber data Google Cloud Monitoring

catatan

Dalam versi Grafana sebelumnya, sumber data ini diberi nama Google Stackdriver.

Tambahkan sumber data Google Cloud Monitoring agar dapat membuat dasbor untuk metrik Google Cloud Monitoring Anda.

Menambahkan sumber data

  1. Buka menu samping dengan memilih ikon Grafana di header atas.

  2. Di menu samping, di bawah tautan Dasbor, Anda harus menemukan tautan Sumber Data.

  3. Pilih tombol + Tambahkan sumber data di header atas.

  4. Pilih Google Cloud Monitoring dari daftar dropdown Type.

  5. Unggah atau tempel di file Kunci Akun Layanan. Lihat nanti di dokumen ini untuk langkah-langkah untuk membuat file Kunci Akun Layanan.

catatan

Jika Anda tidak melihat tautan Sumber Data di menu samping, pengguna Anda saat ini tidak memiliki Admin peran tersebut.

Nama Penjelasan
Name Nama sumber data. Ini adalah bagaimana Anda merujuk ke sumber data di panel dan kueri.
Default Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.
Service Account Key File kunci akun layanan untuk Proyek GCP. Lihat petunjuknya nanti di dokumen ini tentang cara membuatnya.

Autentikasi

Ada dua cara untuk mengautentikasi plugin Google Cloud Monitoring

  • Unggah file Google JWT

  • Secara otomatis mengambil kredensil dari server metadata Google

Opsi terakhir hanya tersedia saat menjalankan Grafana di mesin virtual GCE.

Menggunakan file kunci akun layanan Google

Untuk mengautentikasi dengan Google Cloud Monitoring API, Anda harus membuat Akun Layanan Google Cloud Platform (GCP) untuk Project yang ingin Anda tampilkan datanya. Sumber data Grafana terintegrasi dengan satu Proyek GCP. Untuk memvisualisasikan data dari beberapa Proyek GCP, Anda harus membuat satu sumber data per Proyek GCP.

Mengaktifkan API

API berikut harus diaktifkan terlebih dahulu:

Pilih tautan yang terdaftar, lalu pilih tombol Aktifkan.

Membuat akun layanan GCP untuk Proyek

  1. Arahkan ke halaman API dan Kredensial Layanan.

  2. Pilih dropdown/tombol Create credentials dan pilih opsi Service account key.

    {{< docs-imagebox img=” /img/docs/v71/cloudmonitoring_create_service_account_button.png "class="docs-image—no-shadow” caption="Buat tombol akun layanan” >}}

  3. Pada halaman Create Service Account Key, pilih Key TypeJSON. Kemudian, di daftar dropdown Akun Layanan, pilih opsi Akun layanan baru.

    {{< docs-imagebox img=” /img/docs/v71/cloudmonitoring_create_service_account_key.png "class="docs-image—no-shadow” caption="Buat kunci akun layanan” >}}

  4. Beberapa bidang baru akan muncul. Isi nama untuk akun layanan di bidang Nama akun layanan, lalu pilih peran Monitoring Viewer dari daftar tarik-turun Peran.

    {{< docs-imagebox img=” /img/docs/v71/cloudmonitoring_service_account_choose_role.png "class="docs-image—no-shadow” caption="Pilih peran” >}}

  5. Pilih tombol Buat. File kunci JSON akan dibuat dan diunduh ke komputer Anda. Simpan file ini di tempat yang aman karena memungkinkan akses ke data Google Cloud Monitoring Anda.

  6. Unggah ke Grafana di halaman Konfigurasi sumber data. Anda dapat mengunggah file atau menempelkan konten file.

    {{< docs-imagebox img=” /img/docs/v71/cloudmonitoring_grafana_upload_key.png "class="docs-image—no-shadow” caption="Unggah berkas kunci layanan ke Grafana” >}}

  7. Isi file akan dienkripsi dan disimpan di database Grafana. Jangan lupa untuk menyimpan setelah mengunggah file!

    {{< docs-imagebox img=” /img/docs/v71/cloudmonitoring_grafana_key_uploaded.png "class="docs-image—no-shadow” caption="File kunci layanan diunggah ke Grafana” >}}

Menggunakan editor kueri

Editor kueri Google Cloud Monitoring memungkinkan Anda membuat dua jenis kueri - Metric and Service Level Objective (SLO). Kedua jenis mengembalikan data deret waktu.

Kueri metrik

Editor kueri metrik memungkinkan Anda memilih metrik, mengelompokkan/agregat berdasarkan label dan berdasarkan waktu, dan menggunakan filter untuk menentukan deret waktu yang Anda inginkan dalam hasil.

Untuk membuat kueri metrik, ikuti langkah-langkah berikut:

  1. Pilih opsi Metrik dalam daftar tarik-turun Jenis Kueri.

  2. Pilih proyek dari daftar dropdown Project.

  3. Pilih layanan Google Cloud Platform dari daftar tarik-turun Layanan.

  4. Pilih metrik dari daftar dropdown Metrik.

  5. Untuk menambah atau menghapus filter atau mengelompokkan berdasarkan klausa, gunakan ikon plus dan minus di filter dan kelompokkan berdasarkan bagian. Langkah ini bersifat opsional.

Metrik Google Cloud Monitoring dapat dari berbagai jenis (GAUGE, DELTA, KUMULATIF) dan jenis ini memiliki dukungan untuk opsi agregasi yang berbeda (reduksi dan pelurus). Editor kueri Grafana menunjukkan daftar metode agregasi yang tersedia untuk metrik yang dipilih dan menetapkan peredam dan pelurus default saat Anda memilih metrik. Unit untuk sumbu Y juga dipilih secara otomatis oleh editor kueri.

Filter

Untuk menambahkan filter, pilih ikon plus, pilih bidang untuk difilter, dan masukkan nilai filter. Misalnya, masukkan instance_name = grafana-1. Anda dapat menghapus filter dengan memilih nama filter dan memilih--remove filter--.

Karakter wildcard sederhana

Ketika operator diatur ke atau, = != dimungkinkan untuk menambahkan karakter wildcard ke bidang nilai filter. Misalnya, us-* menangkap semua nilai yang dimulai dengan “us-”, dan *central-a menangkap semua nilai yang diakhiri dengan “central-a”. *-central-*menangkap semua nilai yang memiliki substring. central- Karakter wildcard sederhana lebih murah daripada ekspresi reguler.

Ekspresi reguler

Ketika operator diatur ke atau, =~ !=~ dimungkinkan untuk menambahkan ekspresi reguler ke bidang nilai filter. Misalnya, us-central[1-3]-[af] mencocokkan semua nilai yang dimulai dengan “us-central”, diikuti dengan angka dalam kisaran 1 hingga 3, tanda hubung dan kemudian “a” atau “f”. Garis miring dan garis miring tidak diperlukan saat membuat ekspresi reguler.

Agregasi

Bidang agregasi memungkinkan Anda menggabungkan deret waktu berdasarkan statistik umum. Untuk informasi lebih lanjut tentang agregasi, lihat opsi agregasi.

AlignerBidang ini memungkinkan Anda untuk menyelaraskan beberapa deret waktu setelah grup yang sama berdasarkan interval waktu. Untuk informasi selengkapnya tentang aligner, lihat pemilih metrik penyelarasan.

Periode Penyelarasan dan pengelompokan berdasarkan waktu

Alignment PeriodKelompokkan metrik berdasarkan waktu jika agregasi dipilih. Defaultnya adalah menggunakan pengelompokan default GCP Google Cloud Monitoring (yang memungkinkan Anda membandingkan grafik di Grafana dengan grafik di UI Pemantauan Google Cloud). Opsi ini dipanggil cloud monitoring auto dan defaultnya adalah:

  • 1m untuk rentang waktu <23 jam

  • 5m untuk rentang waktu> = 23 jam dan < 6 hari

  • 1 jam untuk rentang waktu> = 6 hari

Opsi otomatis lainnya adalahgrafana auto. Ini akan secara otomatis mengatur grup berdasarkan waktu tergantung pada rentang waktu yang dipilih dan lebar panel grafik. Untuk informasi selengkapnya, lihat Menambahkan variabel interval.

Dimungkinkan juga untuk memilih interval waktu tetap untuk dikelompokkan menurut, seperti 1h atau1d.

Kelompokkan Oleh

Kelompokkan berdasarkan sumber daya atau label metrik untuk mengurangi jumlah deret waktu dan untuk mengumpulkan hasil oleh grup berdasarkan. Misalnya, kelompokkan berdasarkan instance_name untuk melihat metrik agregat untuk instance komputasi.

Label metadata

Label metadata sumber daya berisi informasi untuk mengidentifikasi sumber daya secara unik di Google Cloud. Label metadata hanya ditampilkan dalam respons deret waktu jika label tersebut merupakan bagian dari segmen Grup Berdasarkan dalam permintaan deret waktu. Tidak ada API untuk mengambil label metadata, jadi tidak mungkin untuk mengisi grup berdasarkan daftar tarik-turun dengan label metadata yang tersedia untuk layanan dan metrik yang dipilih. Namun, daftar dropdown bidang Group By dilengkapi dengan daftar label sistem umum yang telah ditentukan sebelumnya.

Label pengguna tidak dapat ditentukan sebelumnya, tetapi Anda dapat memasukkannya secara manual di bidang Grup Berdasarkan. Jika label metadata, label pengguna, atau label sistem disertakan dalam segmen Grup Berdasarkan, Anda dapat membuat filter berdasarkan itu dan memperluas nilainya di bidang Alias.

Pola alias

Bidang Alias By memungkinkan Anda untuk mengontrol format tombol legenda. Defaultnya adalah menampilkan nama metrik dan label. Ini bisa panjang dan sulit dibaca. Menggunakan pola berikut di bidang alias, Anda dapat memformat kunci legenda seperti yang Anda inginkan.

Pola Jenis Metrik

Pola alias Deskripsi Contoh hasil
{{metric.type}} Mengembalikan Tipe Metrik penuh. compute.googleapis.com/instance/cpu/utilization
{{metric.name}} Mengembalikan bagian nama metrik. instance/cpu/utilization
{{metric.service}} Mengembalikan bagian layanan. compute

Pola label

Dalam daftar dropdown Group By, Anda dapat melihat daftar label metrik dan sumber daya untuk metrik. Ini dapat dimasukkan dalam kunci legenda menggunakan pola alias.

Format pola alias Deskripsi Contoh pola alias Contoh hasil
{{metric.label.xxx}} Mengembalikan nilai label metrik. {{metric.label.instance_name}} grafana-1-prod
{{resource.label.xxx}} Mengembalikan nilai label sumber daya. {{resource.label.zone}} us-east1-b
{{metadata.system_labels.xxx}} Mengembalikan nilai label sistem metadata. {{metadata.system_labels.name}} grafana
{{metadata.user_labels.xxx}} Mengembalikan nilai label pengguna metadata. {{metadata.user_labels.tag}} production

Contoh Alias Oleh: {{metric.type}} - {{metric.label.instance_name}}

Contoh Hasil: compute.googleapis.com/instance/cpu/usage_time - server1-prod

Dimungkinkan juga untuk menyelesaikan nama Jenis Sumber Daya yang Dipantau.

Format pola alias Deskripsi Contoh hasil
{{resource.type}} Mengembalikan nama jenis sumber daya yang dipantau. gce_instance

Contoh Alias Oleh: {{resource.type}} - {{metric.type}}

Contoh Hasil: gce_instance - compute.googleapis.com/instance/cpu/usage_time

Kueri SLO

catatan

Kueri SLO hanya tersedia di Grafana v7.0+

Pembuat kueri SLO di sumber data Google Cloud Monitoring memungkinkan Anda menampilkan data SLO dalam format deret waktu. Untuk mendapatkan pemahaman tentang konsep dasar dalam pemantauan layanan, lihat dokumentasi resmi Google Cloud Monitoring.

Membuat kueri SLO

Untuk membuat kueri SLO, ikuti langkah-langkah berikut:

  1. Pilih opsi Tujuan Tingkat Layanan (SLO) di daftar dropdown Jenis Kueri.

  2. Pilih proyek dari daftar dropdown Project.

  3. Pilih layanan SLO dari daftar dropdown Layanan.

  4. Pilih SLO dari daftar dropdown SLO.

  5. Pilih pemilih deret waktu dari daftar dropdown Selector.

Nama-nama ramah untuk pemilih deret waktu ditampilkan di Grafana. Tabel berikut menunjukkan pemetaan dari nama ramah ke nama sistem yang digunakan dalam dokumentasi Service Monitoring.

Nilai daftar dropdown pemilih Pemilih deret waktu yang sesuai digunakan
Nilai SLI select_slo_health
Kepatuhan SLO select_slo_compliance
SLO Kesalahan Anggaran Tersisa select_slo_budget_fraction

Pola alias untuk kueri SLO

Anda dapat menggunakan bidang Alias By untuk mengontrol format kunci legenda untuk kueri SLO.

Pola alias Deskripsi Contoh hasil
{{project}} Mengembalikan nama proyek GCP. myProject
{{service}} Mengembalikan nama layanan. myService
{{slo}} Mengembalikan SLO. latency-slo
{{selector}} Mengembalikan pemilih. select_slo_health

Periode Penyelarasan dan pengelompokan berdasarkan waktu untuk kueri SLO

Kueri SLO menggunakan fungsionalitas periode penyelarasan yang sama dengan kueri metrik. Untuk informasi selengkapnya, lihat Kueri metrik.

Templating

Alih-alih hardcoding hal-hal seperti server, aplikasi dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai kotak pilih dropdown di bagian atas dasbor. Anda dapat menggunakan kotak dropdown ini untuk mengubah data yang ditampilkan di dasbor Anda.

Untuk informasi selengkapnya tentang variabel template dan template, lihatTemplate dan variabel.

Variabel kueri

Variabel dari jenis Query memungkinkan Anda untuk query Google Cloud Monitoring untuk berbagai jenis data. Plugin sumber data Google Cloud Monitoring menyediakan yang berikut iniQuery Types.

Nama Penjelasan
Metric Types Mengembalikan daftar nama jenis metrik yang tersedia untuk layanan tertentu.
Labels Keys Mengembalikan daftar kunci untuk metric label dan resource label dalam metrik yang ditentukan.
Labels Values Mengembalikan daftar nilai untuk label dalam metrik yang ditentukan.
Resource Types Mengembalikan daftar jenis sumber daya untuk metrik tertentu.
Aggregations Mengembalikan daftar agregasi (cross series reducer) untuk metrik yang ditentukan.
Aligners Mengembalikan daftar aligner (per seri aligner) untuk metrik yang ditentukan.
Alignment periods Mengembalikan daftar semua periode penyelarasan yang tersedia di editor kueri Google Cloud Monitoring di Grafana.
Selectors Mengembalikan daftar pemilih yang dapat digunakan dalam pertanyaan SLO (Service Level Objectives).
SLO Services Mengembalikan daftar layanan Pemantauan Layanan yang dapat digunakan dalam kueri SLO.
Service Level Objectives (SLO) Mengembalikan daftar SLO untuk layanan SLO tertentu.

Menggunakan variabel dalam kueri

Ada dua sintaks:

  • $<varname>Contoh: metric.label.$metric_label

  • [[varname]]Contoh: metric.label.[[metric_label]]

Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Saat opsi Multi-nilai atau Sertakan semua nilai diaktifkan, Grafana mengonversi label dari teks biasa menjadi string yang kompatibel dengan regex, yang berarti Anda harus menggunakan sebagai gantinya. =~ =

Anotasi

Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Rendering anotasi mahal sehingga penting untuk membatasi jumlah baris yang dikembalikan. Belum ada dukungan untuk menampilkan anotasi dan acara Google Cloud Monitoring tetapi berfungsi dengan baik dengan metrik khusus di Google Cloud Monitoring.

Untuk informasi selengkapnya tentang anotasi, lihatAnotasi.

Dengan editor kueri untuk anotasi, Anda dapat memilih metrik dan filter. Bidang Judul dan Teks mendukung templating dan dapat menggunakan data yang dikembalikan dari kueri. Misalnya, bidang Judul dapat memiliki teks berikut:

{{metric.type}} has value: {{metric.value}}

Contoh Hasil: monitoring.googleapis.com/uptime_check/http_status has this value: 502

Pola untuk editor kueri anotasi

Format pola alias Deskripsi Contoh pola alias Contoh hasil
{{metric.value}} Nilai metrik/titik. {{metric.value}} 555
{{metric.type}} Mengembalikan Tipe Metrik penuh. {{metric.type}} compute.googleapis.com/instance/cpu/utilization
{{metric.name}} Mengembalikan bagian nama metrik. {{metric.name}} instance/cpu/utilization
{{metric.service}} Mengembalikan bagian layanan. {{metric.service}} compute
{{metric.label.xxx}} Mengembalikan nilai label metrik. {{metric.label.instance_name}} grafana-1-prod
{{resource.label.xxx}} Mengembalikan nilai label sumber daya. {{resource.label.zone}} us-east1-b

Penautan mendalam dari panel Grafana ke Metrics Explorer di Google Cloud Console

catatan

Fitur ini hanya tersedia untuk kueri Metrik.

Pilih deret waktu di panel untuk melihat menu konteks dengan tautan ke Lihat di Metrics Explorer di Google Cloud Console. Memilih tautan itu membuka Metrics Explorer di Google Cloud Console dan menjalankan kueri dari panel Grafana di sana. Tautan menavigasi pengguna terlebih dahulu ke Pemilih Akun Google. Setelah berhasil memilih akun, pengguna dialihkan ke Metrics Explorer. Tautan yang disediakan berlaku untuk akun apa pun, tetapi hanya menampilkan kueri jika akun Anda memiliki akses ke proyek GCP yang ditentukan dalam kueri.