Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect ke sumber data Graphite
Grafana memiliki editor kueri Grafit canggih yang memungkinkan Anda menavigasi ruang metrik dengan cepat, menambahkan fungsi, mengubah parameter fungsi, dan banyak lagi. Editor dapat menangani semua jenis kueri grafit. Bahkan dapat menangani kueri bersarang yang kompleks melalui penggunaan referensi kueri.
## Pengaturan grafit
Untuk mengakses pengaturan Graphite, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih sumber data grafit.
| Nama | Deskripsi |
| --- | --- |
| Name | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| URL | Protokol HTTP, IP, dan port instalasi graphite-web atau grafit-api Anda. |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Auth | |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
| Custom HTTP Headers | Pilih Tambahkan header untuk menambahkan header HTTP kustom. |
| Header | Masukkan nama header kustom. |
| Value | Masukkan nilai header kustom. |
| Graphite details | |
| Version | Pilih versi Graphite Anda. |
| Type | Pilih jenis Grafit Anda. |
Mode akses mengontrol bagaimana permintaan ke sumber data akan ditangani. Server harus menjadi cara yang disukai jika tidak ada hal lain yang dinyatakan.
### Mode akses server (default)
Semua permintaan dibuat dari browser ke Amazon Managed Grafana, yang meneruskan permintaan ke sumber data, menghindari kemungkinan persyaratan Cross-Origin Resource Sharing (CORS). Jika Anda memilih mode akses ini, URL harus dapat diakses dari Grafana Terkelola Amazon.
### Mode akses browser
Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber data Graphite.
## Editor kueri grafit
Grafana menyertakan editor kueri khusus Graphite untuk membantu Anda membangun kueri.
Untuk melihat teks mentah dari kueri yang dikirim ke Graphite, pilih ikon **Toggle text edit mode** (pensil).
### Memilih metrik untuk kueri
Pilih **Pilih metrik** untuk menavigasi ruang metrik. Setelah Anda mulai, Anda dapat terus menggunakan tombol panah penunjuk atau keyboard. Anda dapat memilih karakter wildcard dan masih melanjutkan.
### Fungsi
Untuk menambahkan fungsi, pilih ikon plus di sebelah **Fungsi**. Anda dapat mencari fungsi atau memilihnya dari menu. Setelah fungsi dipilih, itu akan ditambahkan dan fokus Anda akan berada di kotak teks parameter pertama. Untuk mengedit atau mengubah parameter, pilih dan itu akan berubah menjadi kotak teks. - Untuk menghapus fungsi, pilih nama fungsi diikuti oleh ikon x.
Beberapa fungsi, seperti`aliasByNode`, mendukung argumen kedua opsional. Untuk menambahkan argumen, jeda pada argumen pertama, lalu pilih `+` simbol yang muncul. Untuk menghapus parameter opsional kedua, pilih dan biarkan kosong. Editor akan menghapusnya.
### Urutkan label
Jika Anda ingin pemesanan yang konsisten, gunakan`sortByName`. Ini bisa mengganggu ketika Anda memiliki label yang sama pada beberapa grafik, dan keduanya diurutkan secara berbeda dan menggunakan warna yang berbeda. Untuk memperbaikinya, gunakan`sortByName()`.
### Kueri bersarang
Anda dapat mereferensikan kueri dengan *huruf* baris yang mereka gunakan (mirip dengan Microsoft Excel). Jika Anda menambahkan kueri kedua ke grafik, Anda dapat mereferensikan kueri pertama dengan mengetik \$1A. Ini menyediakan cara mudah untuk membuat kueri gabungan.
### Menghindari banyak pertanyaan dengan menggunakan karakter wildcard
Kadang-kadang, Anda mungkin ingin melihat beberapa deret waktu diplot pada grafik yang sama. Misalnya, Anda mungkin ingin melihat bagaimana CPU digunakan pada mesin. Anda mungkin awalnya membuat grafik dengan menambahkan kueri untuk setiap deret waktu, seperti `cpu.percent.user.g``cpu.percent.system.g`,, dan sebagainya. Ini menghasilkan *n* kueri yang dibuat ke sumber data, yang tidak efisien.
Agar lebih efisien, seseorang dapat menggunakan karakter wildcard dalam pencarian Anda, mengembalikan semua deret waktu dalam satu kueri. Misalnya, `cpu.percent.*.g`.
### Memodifikasi nama metrik dalam tabel atau bagan
Gunakan `alias` fungsi untuk mengubah nama metrik pada tabel atau grafik Grafana; misalnya, atau. `aliasByNode()` `aliasSub()`
## Konsolidasi titik
Semua metrik Graphite dikonsolidasikan sehingga Graphite tidak mengembalikan lebih banyak titik data daripada piksel dalam grafik. Secara default, konsolidasi ini dilakukan dengan menggunakan `avg` fungsi. Anda dapat mengontrol bagaimana Graphite mengkonsolidasikan metrik dengan menambahkan fungsi Graphite ConsolidateBy.
**catatan**
Ini berarti bahwa nilai ringkasan legenda (maks, min, total) tidak dapat semuanya benar pada saat yang bersamaan. Mereka dihitung sisi klien oleh Grafana. Dan tergantung pada fungsi konsolidasi Anda, hanya satu atau dua yang bisa benar pada saat yang bersamaan.
## Menggabungkan deret waktu
Untuk menggabungkan deret waktu, pilih **Gabungkan** dalam daftar **Fungsi**.
## Eksplorasi data dan tag
Dalam Graphite, semuanya adalah tag.
Saat menjelajahi data, tag yang dipilih sebelumnya digunakan untuk memfilter kumpulan hasil yang tersisa. Untuk memilih data, Anda menggunakan `seriesByTag` fungsi, yang mengambil ekspresi tag (`=`,, `!=``=~`,`!=~`) untuk memfilter deret waktu.
Pembuat kueri Grafana melakukan ini untuk Anda secara otomatis saat Anda memilih tag.
**catatan**
**Tip:** Pencarian ekspresi reguler bisa lambat pada tag kardinalitas tinggi, jadi coba gunakan tag lain untuk mengurangi cakupan terlebih dahulu. Memulai dengan nama atau namespace tertentu membantu mengurangi hasilnya.
## Variabel template
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).
Untuk membuat variabel menggunakan nilai tag, gunakan fungsi `tags` Grafana dan. `tag_values`
| Kueri | Deskripsi |
| --- | --- |
| tags() | Mengembalikan semua tag. |
| tags(server=\$1backend\$1\$1) | Mengembalikan hanya tag yang terjadi dalam seri yang cocok dengan ekspresi filter. |
| tag\$1values(server) | Mengembalikan nilai tag untuk tag yang ditentukan. |
| tag\$1values(server, server=\$1backend\$1\$1) | Mengembalikan nilai tag yang disaring yang terjadi untuk tag tertentu dalam seri yang cocok dengan ekspresi tersebut. |
| tag\$1values(server, server=\$1backend\$1\$1, app=\$1\$1\$1apps:regex\$1) | Beberapa ekspresi dan ekspresi filter dapat berisi variabel lain. |
Untuk detail selengkapnya, lihat [Dokumen grafit pada API pelengkapan otomatis untuk](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support) tag.
### Variabel kueri
Kueri yang Anda tentukan di bidang kueri harus berupa jenis kueri pencarian metrik. Misalnya, kueri seperti `prod.servers.*` akan mengisi variabel dengan semua nilai yang mungkin ada di posisi wildcard.
Anda juga dapat membuat variabel bersarang yang menggunakan variabel lain dalam definisi mereka. Misalnya `apps.$app.servers.*` menggunakan variabel `$app` dalam definisi query nya.
#### Menggunakan `__searchFilter` untuk memfilter hasil variabel kueri
Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan apa yang Anda masukkan di kotak pilih tarik-turun. Ketika Anda tidak memasukkan apa-apa, nilai default untuk `__searchFilter` adalah `*` dan ``ketika digunakan sebagai bagian dari ekspresi reguler.
Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `server` sementara pengguna memasukkan teks dalam kotak pilih dropdown.
Kueri
```
apps.$app.servers.$__searchFilter
```
TagValues
```
tag_values(server, server=~${__searchFilter:regex})
```
### Penggunaan variabel
Anda dapat menggunakan variabel dalam jalur simpul metrik atau sebagai parameter untuk suatu fungsi.
Ada dua sintaks:
+ `$`Contoh: apps.frontend. \$1 server.requests.count
+ `${varname}`Contoh: apps.frontend. \$1 \$1server\$1 .requests.count
Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Gunakan sintaks kedua dalam ekspresi seperti`my.server${serverNumber}.count`.
### Penggunaan variabel dalam kueri tag
Variabel multi-nilai dalam kueri tag menggunakan sintaks pemformatan lanjutan yang diperkenalkan di Grafana 5.0 untuk variabel:. `{var:regex}` Kueri non-tag akan menggunakan pemformatan glob default untuk variabel multi-nilai.
Contoh kode berikut menunjukkan ekspresi tag dengan pemformatan regex dan menggunakan operator Equal Tilde,. `=~`
```
server=~${servers:regex}
```
Untuk informasi selengkapnya, lihat [Opsi format variabel lanjutan](templates-and-variables.md#advanced-variable-format-options).
## Anotasi
Anotasi memungkinkan Anda untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).
Graphite mendukung dua cara untuk menanyakan anotasi:
+ Kueri metrik reguler. Untuk ini, Anda menggunakan kotak teks **kueri Graphite**.
+ Sebuah query peristiwa grafit. Untuk ini, Anda menggunakan kotak `Graphite event tags` teks, dan menentukan tag atau karakter wildcard (menjaganya tetap kosong juga harus berfungsi).