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
<a name="using-google-cloud-monitoring-in-grafana"></a>

**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
<a name="google-adding-the-data-source"></a>

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

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

1.  Pilih tombol **\$1 Tambahkan sumber data** di header atas. 

1.  Pilih **Google Cloud Monitoring** dari daftar dropdown **Type**. 

1.  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  |  Deskripsi  | 
| --- | --- | 
|  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
<a name="google-authentication"></a>

 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
<a name="using-a-google-service-account-key-file"></a>

 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 APIs
<a name="google-enable-apis"></a>

 Berikut ini APIs harus diaktifkan terlebih dahulu: 
+  [API Pemantauan](https://console.cloud.google.com/apis/library/monitoring.googleapis.com) 
+  [API Manajer Sumber Daya Cloud](https://console.cloud.google.com/apis/library/cloudresourcemanager.googleapis.com) 

 Pilih tautan yang terdaftar, lalu pilih tombol **Aktifkan**.

#### Membuat akun layanan GCP untuk Proyek
<a name="create-a-gcp-service-account-for-a-project"></a>

1.  Arahkan ke halaman [APIsdan Kredensial Layanan](https://console.cloud.google.com/apis/credentials). 

1.  Pilih **Create credentials** dropdown/button dan pilih opsi **Service account key**. 

    \$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1button.png "class="docs-image—no-shadow” caption="Buat tombol akun layanan” >\$1\$1 

1.  Pada halaman **Create Service Account Key**, pilih Key Type`JSON`. Kemudian, di daftar dropdown **Akun Layanan**, pilih opsi **Akun layanan baru**. 

    \$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1key.png "class="docs-image—no-shadow” caption="Buat kunci akun layanan” >\$1\$1 

1.  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**. 

    \$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1service\$1account\$1choose\$1role.png "class="docs-image—no-shadow” caption="Pilih peran” >\$1\$1 

1.  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. 

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

    \$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1grafana\$1upload\$1key.png "class="docs-image—no-shadow” caption="Unggah berkas kunci layanan ke Grafana” >\$1\$1 

1.  Isi file akan dienkripsi dan disimpan di database Grafana. Jangan lupa untuk menyimpan setelah mengunggah file\$1 

    \$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1grafana\$1key\$1uploaded.png "class="docs-image—no-shadow” caption="File kunci layanan diunggah ke Grafana” >\$1\$1 

## Menggunakan editor kueri
<a name="google-using-the-query-editor"></a>

 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
<a name="google-metric-queries"></a>

 Editor kueri metrik memungkinkan Anda memilih metrik, group/aggregate berdasarkan label dan 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**. 

1.  Pilih proyek dari daftar dropdown **Project**. 

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

1.  Pilih metrik dari daftar dropdown **Metrik**. 

1.  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. 

#### Penyaring
<a name="google-filter"></a>

 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
<a name="google-simple-wildcards"></a>

 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
<a name="google-regular-expressions"></a>

 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
<a name="google-aggregation"></a>

 Bidang agregasi memungkinkan Anda menggabungkan deret waktu berdasarkan statistik umum. Untuk informasi lebih lanjut tentang agregasi, lihat opsi [agregasi](https://cloud.google.com/monitoring/charts/metrics-selector#aggregation-options). 

 `Aligner`Bidang ini memungkinkan Anda untuk menyelaraskan beberapa deret waktu setelah grup yang sama berdasarkan interval waktu. Untuk informasi selengkapnya tentang aligner, lihat pemilih [metrik penyelarasan.](https://cloud.google.com/monitoring/charts/metrics-selector#alignment) 

##### Periode Penyelarasan dan pengelompokan berdasarkan waktu
<a name="alignment-periodgroup-by-time"></a>

 `Alignment Period`Kelompokkan 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 adalah`grafana 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](variables-types.md#add-an-interval-variable). 

 Dimungkinkan juga untuk memilih interval waktu tetap untuk dikelompokkan menurut, seperti `1h` atau`1d`. 

#### Kelompokkan Oleh
<a name="google-group-by"></a>

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

##### Label metadata
<a name="google-metadata-labels"></a>

 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
<a name="google-alias-patterns"></a>

 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
<a name="metric-type-patterns"></a>


|  Pola alias  |  Deskripsi  |  Contoh hasil  | 
| --- | --- | --- | 
|  \$1\$1metric.type\$1\$1  |  Mengembalikan Tipe Metrik penuh.  |  compute.googleapis.com/instance/cpu/utilization  | 
|  \$1\$1metric.name\$1\$1  |  Mengembalikan bagian nama metrik.  |  instance/cpu/utilization  | 
|  \$1\$1metric.service\$1\$1  |  Mengembalikan bagian layanan.  |  compute  | 

#### Pola label
<a name="google-label-patterns"></a>

 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  | 
| --- | --- | --- | --- | 
|  \$1\$1metric.label.xxx\$1\$1  |  Mengembalikan nilai label metrik. |  \$1\$1metric.label.instance\$1name\$1\$1  |  grafana-1-prod  | 
|  \$1\$1resource.label.xxx\$1\$1  |  Mengembalikan nilai label sumber daya.  |  \$1\$1resource.label.zone\$1\$1  |  us-east1-b  | 
|  \$1\$1metadata.system\$1labels.xxx\$1\$1  |  Mengembalikan nilai label sistem metadata.  |  \$1\$1metadata.system\$1labels.name\$1\$1  |  grafana  | 
|  \$1\$1metadata.user\$1labels.xxx\$1\$1  |  Mengembalikan nilai label pengguna metadata.  |  \$1\$1metadata.user\$1labels.tag\$1\$1  |  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  | 
| --- | --- | --- | 
|  \$1\$1resource.type\$1\$1  |  Mengembalikan nama jenis sumber daya yang dipantau.  |  gce\$1instance  | 

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

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

### Kueri SLO
<a name="slo-service-level-objective-queries"></a>

**catatan**  
 Kueri SLO hanya tersedia di Grafana v7.0\$1 

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](https://cloud.google.com/monitoring/service-monitoring) Google Cloud Monitoring.

#### Membuat kueri SLO
<a name="how-to-create-an-slo-query"></a>

 Untuk membuat kueri SLO, ikuti langkah-langkah berikut: 

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

1.  Pilih proyek dari daftar dropdown **Project**. 

1.  Pilih [layanan SLO dari daftar](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services) **dropdown Layanan**. 

1.  Pilih [SLO dari daftar](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services.serviceLevelObjectives) **dropdown SLO**. 

1.  Pilih [pemilih deret waktu dari daftar](https://cloud.google.com/monitoring/service-monitoring/timeseries-selectors#ts-selector-list) 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\$1slo\$1health  | 
|  Kepatuhan SLO  |  select\$1slo\$1compliance  | 
|  SLO Kesalahan Anggaran Tersisa  |  select\$1slo\$1budget\$1fraction  | 

#### Pola alias untuk kueri SLO
<a name="alias-patterns-for-slo-queries"></a>

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


|  Pola alias  |  Deskripsi  |  Contoh hasil  | 
| --- | --- | --- | 
|  \$1\$1project\$1\$1  |  Mengembalikan nama proyek GCP.  |  myProject  | 
|  \$1\$1service\$1\$1  |  Mengembalikan nama layanan.  |  myService  | 
|  \$1\$1slo\$1\$1  |  Mengembalikan SLO.  |  latency-slo  | 
|  \$1\$1selector\$1\$1  |  Mengembalikan pemilih.  |  select\$1slo\$1health  | 

#### Periode Penyelarasan dan pengelompokan berdasarkan waktu untuk kueri SLO
<a name="alignment-periodgroup-by-time-for-slo-queries"></a>

 Kueri SLO menggunakan fungsionalitas periode penyelarasan yang sama dengan kueri metrik. Untuk informasi selengkapnya, lihat [Kueri metrik](#google-metric-queries). 

## Templating
<a name="google-templating"></a>

 Alih-alih melakukan 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, lihat[Template dan variabel](templates-and-variables.md). 

### Variabel kueri
<a name="google-query-variable"></a>

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


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  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
<a name="google-using-variables-in-queries"></a>

 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
<a name="google-annotations"></a>

 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](https://cloud.google.com/monitoring/custom-metrics/) di Google Cloud Monitoring.

Untuk informasi selengkapnya tentang anotasi, lihat[Anotasi](dashboard-annotations.md). 

 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
<a name="patterns-for-the-annotation-query-editor"></a>


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

## Penautan mendalam dari panel Grafana ke Metrics Explorer di Google Cloud Console
<a name="deep-linking-from-grafana-panels-to-the-metrics-explorer-in-google-cloud-console"></a>

**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.