

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

# Gunakan ruang kerja Grafana Anda
<a name="AMG-working-with-Grafana-workspace"></a>

Ruang kerja Grafana Anda adalah tempat Anda mengerjakan proyek untuk membuat visualisasi dan menjelajahi metrik Anda. Siapkan dan kueri sumber data untuk metrik Anda. Buat panel di dalam dasbor untuk melihat metrik Anda. Jelajahi data Anda. Buat alarm pada metrik Anda.

Topik di bagian ini menjelaskan cara menggunakan ruang kerja Grafana Terkelola Amazon Anda.

**catatan**  
Beberapa topik bervariasi berdasarkan versi Grafana yang Anda miliki di ruang kerja Anda. Untuk dokumentasi khusus untuk setiap versi, lihat[Bekerja di Grafana versi 10](using-grafana-v10.md),[Bekerja di Grafana versi 9](using-grafana-v9.md), dan[Bekerja di Grafana versi 8](using-grafana-v8.md). Untuk informasi tentang memutakhirkan ruang kerja Anda dari satu versi ke versi lainnya, lihat. [Perbarui versi ruang kerja Anda](AMG-workspace-version-update.md)

**Topics**
+ [Apa itu Grafana?](#what-is-grafana)
+ [Connect ke ruang kerja Anda](connect-to-workspace.md)
+ [Pengguna, tim, dan izin](Grafana-administration-authorization.md)
+ [Buat dasbor pertama Anda](getting-started-grafanaui.md)
+ [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md)
+ [Connect ke sumber data](AMG-data-sources.md)
+ [Bekerja di Grafana versi 10](using-grafana-v10.md)
+ [Bekerja di Grafana versi 9](using-grafana-v9.md)
+ [Bekerja di Grafana versi 8](using-grafana-v8.md)
+ [Ubah preferensi Anda](change-your-grafana-preferences.md)
+ [Kumpulkan informasi untuk dukungan](support-bundles.md)
+ [Peringatan dasbor klasik](old-alerts-overview.md)

## Apa itu Grafana?
<a name="what-is-grafana"></a>

 Grafana adalah perangkat lunak visualisasi dan analitik open source. Anda dapat menggunakannya untuk menanyakan, memvisualisasikan, mengingatkan, dan menjelajahi metrik Anda di mana pun mereka disimpan. 

 Misalnya, jika Anda ingin melihat metrik, log, dan melacak data untuk aplikasi Anda, Anda dapat membuat dasbor. Jika Anda adalah administrator untuk sebuah korporasi dan mengelola Grafana untuk beberapa tim, Anda mungkin perlu menyiapkan penyediaan dan otentikasi. 

 Bagian berikut memberikan ikhtisar tentang hal-hal yang dapat Anda lakukan dengan database dan tautan Grafana Anda sehingga Anda dapat mempelajari lebih lanjut. 

### Jelajahi metrik dan log
<a name="explore-metrics-and-logs"></a>

 Jelajahi data Anda melalui kueri satu kali, atau ad hoc, dan telusuri secara dinamis. Anda dapat membagi tampilan dan membandingkan rentang waktu, kueri, dan sumber data yang berbeda secara berdampingan. 

 Untuk informasi selengkapnya, lihat [Jelajahi di Grafana versi 10](v10-explore.md). 

### Pemberitahuan
<a name="intro-alerts"></a>

 Jika Anda menggunakan peringatan Grafana, peringatan dapat dikirim melalui notifier peringatan yang berbeda, termasuk yang berikut ini: 
+ Amazon SNS
+ PagerDuty
+ VictorOps
+ OpsGenie
+ Slack

Untuk informasi selengkapnya, lihat [Peringatan di Grafana versi 10](v10-alerts.md).

### Anotasi
<a name="intro-annotations"></a>

 Buat anotasi grafik dengan peristiwa kaya dari sumber data yang berbeda. Jeda pada acara untuk melihat metadata dan tag acara lengkap. 

 Fitur ini, yang muncul sebagai penanda grafik di Grafana, berguna untuk mengkorelasikan data jika terjadi kesalahan. Anda dapat membuat anotasi secara manual dengan menekan **Ctrl** saat Anda memilih grafik dan kemudian memasukkan beberapa teks. Atau Anda dapat mengambil data dari sumber data apa pun. 

 Untuk informasi selengkapnya, lihat [Visualisasi anotasi](v10-dash-annotations.md). 

### Variabel dasbor
<a name="intro-dashboard-variables"></a>

Gunakan variabel template untuk membuat dasbor yang dapat digunakan kembali untuk banyak kasus penggunaan yang berbeda. Dengan template ini, nilai tidak di-hardcode. Ini berarti Anda dapat menggunakan dasbor untuk beberapa server. Misalnya, jika Anda memiliki server produksi dan server pengujian, Anda dapat menggunakan dasbor yang sama untuk keduanya.

Templating membantu Anda menelusuri data Anda. Misalnya, Anda dapat menelusuri dari semua data ke data Amerika Utara, hingga data Texas, dan seterusnya. Anda juga dapat membagikan dasbor ini ke seluruh tim dalam organisasi Anda. Jika Anda membuat template dasbor yang bagus untuk sumber data populer, Anda juga dapat berkontribusi ke seluruh komunitas untuk disesuaikan dan digunakan.

Lihat informasi yang lebih lengkap di [Variabel](v10-dash-variables.md).

# Connect ke ruang kerja Anda
<a name="connect-to-workspace"></a>

Sebelum dapat menggunakan ruang kerja Grafana Terkelola Amazon, Anda harus menyambungkannya dengan masuk dengan penyedia identitas yang telah Anda siapkan. Jika Anda belum menyiapkan metode otentikasi melalui beberapa penyedia identitas, lihat [Mengautentikasi pengguna di ruang kerja Grafana Terkelola Amazon](authentication-in-AMG.md) untuk informasi selengkapnya.

**catatan**  
Jika Anda mencoba untuk terhubung ke ruang kerja Anda secara terprogram, Anda harus menggunakan token API. Untuk informasi selengkapnya, lihat [Otentikasi dengan token](authenticating-grafana-apis.md).

**Untuk masuk ke ruang kerja Grafana Anda**

1. Buka konsol Grafana Terkelola Amazon di [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/), dan masuk.

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja yang ingin Anda masuki.

1. Di halaman detail ruang kerja, pilih URL yang ditampilkan di bawah URL ruang kerja **Grafana**.

1. Memilih URL ruang kerja akan membawa Anda ke halaman arahan untuk konsol ruang kerja Grafana. Pilih **Masuk dengan AWS IAM Identity Center**, dan masukkan alamat email dan kata sandi.
**catatan**  
Tombol masuk akan memiliki teks dan persyaratan yang berbeda jika Anda telah mengatur otentikasi dengan penyedia identitas.

# Pengguna, tim, dan izin
<a name="Grafana-administration-authorization"></a>

Izin di Grafana Terkelola Amazon dikelola di konsol Grafana Terkelola Amazon dan langsung di dalam ruang kerja.
+ **Pengguna** — Pengguna [diautentikasi](authentication-in-AMG.md) di Pusat Identitas IAM atau penyedia identitas yang Anda atur melalui SALL di konsol Grafana Terkelola Amazon.
+ **Akses peran** — Anda dapat memberi pengguna atau grup [akses](AMG-manage-users-and-groups-AMG.md) dengan,, atau `Admin` peran `User``Editor`, untuk memberi mereka izin default ke ruang kerja Anda, menggunakan konsol Grafana Terkelola Amazon.
+ **Grup, atau Tim** — Anda dapat membuat grup pengguna untuk memberikan akses ke dalam dua cara. Anda dapat membuat grup di penyedia identitas Anda (atau Pusat Identitas IAM). Anda kemudian dapat memberikan akses grup ini, seperti halnya pengguna, di konsol Grafana yang Dikelola Amazon. Atau Anda dapat membuat [Tim](Grafana-teams.md) di ruang kerja Grafana, dan memberi mereka peran yang Anda inginkan.
+ **Izin khusus** - Jika Anda ingin [mengganti izin yang](Grafana-permissions.md) diberikan oleh peran untuk dasbor, folder, atau sumber data tertentu, Anda dapat menghapus izin default, dan menetapkan izin ke pengguna atau tim tertentu. Ini dilakukan di dalam ruang kerja Grafana.

Bagian ini menjelaskan cara melakukan manajemen izin dalam ruang kerja Grafana.

**Topics**
+ [Pengguna](Grafana-users.md)
+ [Peran pengguna](Grafana-user-roles.md)
+ [Mengelola tim](Grafana-teams.md)
+ [Menggunakan izin](Grafana-permissions.md)

# Pengguna
<a name="Grafana-users"></a>

Di Amazon Managed Grafana, Anda tidak menambahkan pengguna di ruang kerja Grafana. Sebagai gantinya, Anda menggunakan Pusat Identitas IAM atau dan penyedia identitas untuk mengautentikasi pengguna, lalu memberi pengguna akses ke ruang kerja Grafana Terkelola Amazon dari dalam konsol Grafana Terkelola Amazon. Lihat informasi yang lebih lengkap di [Kelola akses pengguna dan grup ke ruang kerja Grafana yang Dikelola Amazon](AMG-manage-users-and-groups-AMG.md).

# Peran pengguna
<a name="Grafana-user-roles"></a>

Di Grafana Terkelola Amazon, setiap pengguna yang diaktifkan untuk menggunakan ruang kerja Grafana Terkelola Amazon ditetapkan ke salah satu dari tiga peran [di](AMG-manage-users-and-groups-AMG.md) konsol Grafana Terkelola Amazon.
+ **Peran admin** - Pengguna dengan peran Admin dapat melakukan hal berikut:
  + Dapat menambah, mengedit, dan menghapus sumber data.
  + Dapat menambah dan mengedit pengguna dan tim.
  + Dapat menambah, mengedit, dan menghapus folder yang berisi dasbor.
  + Dapat melakukan semua yang diizinkan oleh peran Editor.
+ **Peran editor** - Pengguna dengan peran Editor dapat melakukan hal berikut:
  + Dapat melihat, menambah, dan mengedit dasbor, panel, dan aturan peringatan di dasbor yang dapat mereka akses. Ini dapat dinonaktifkan pada folder dan dasbor tertentu.
  + Dapat membuat, memperbarui, atau menghapus daftar putar.
  + Dapat mengakses Jelajahi.
  + Dapat menambah, mengedit, dan menghapus saluran notifikasi.
  + Tidak dapat menambah, mengedit, atau menghapus sumber data.
  + Dapat melakukan semua yang diizinkan oleh peran Viewer.
+ **Peran penampil** - Pengguna dengan peran Penampil dapat melakukan hal berikut:
  + Dapat melihat dasbor apa pun yang dapat mereka akses. Ini dapat dinonaktifkan pada folder dan dasbor tertentu.
  + Tidak dapat membuat, memperbarui, atau menghapus daftar putar.
  + Tidak dapat mengakses Jelajahi.
  + Tidak dapat menambah, mengedit, dan menghapus saluran notifikasi.
  + Tidak dapat menambah, mengedit, atau menghapus sumber data.
  + Tidak dapat menambah, mengedit, atau menghapus dasbor atau panel.
  + Tidak dapat mengelola pengguna atau tim lain.

Penetapan pengguna dan manajemen akses pengguna dari ruang kerja Grafana tidak didukung di Grafana Terkelola Amazon. Cara Anda mengelola akses pengguna dan grup tergantung pada apakah Anda menggunakan IAM Identity Center atau SALL untuk otentikasi:
+ Jika ruang kerja Anda menggunakan Pusat Identitas IAM untuk autentikasi, Anda dapat menggunakan konsol Grafana Terkelola Amazon atau untuk menetapkan peran. APIs Untuk informasi selengkapnya, lihat [Kelola akses pengguna dan grup ke ruang kerja Grafana yang Dikelola Amazon](AMG-manage-users-and-groups-AMG.md).
+ Jika ruang kerja Anda menggunakan SAFL untuk otentikasi, peran pengguna hanya ditentukan oleh atribut pernyataan. Lihat informasi yang lebih lengkap di [Pemetaan pernyataan](authentication-in-AMG-SAML.md#AMG-SAML-Assertion-Mapping).

# Mengelola tim
<a name="Grafana-teams"></a>

Menggunakan *tim* memungkinkan Anda memberikan izin kepada sekelompok pengguna secara bersamaan. Anda juga dapat mengatur sinkronisasi tim untuk secara otomatis menyinkronkan keanggotaan tim antara ruang kerja Grafana dan penyedia otorisasi Anda.

## Membuat atau menghapus tim
<a name="create-remove-team"></a>

Buat tim untuk mengelola pengguna dalam grup.

**Untuk membuat tim**

1. Di sidebar, pilih ikon **Configuration** (gear), dan pilih **Teams**.

1. Pilih **tim baru**.

1. Untuk **Nama**, masukkan nama untuk tim baru, lalu pilih **Buat**.

**Untuk menghapus tim**

1. Di sidebar, pilih ikon **Configuration** (gear), dan pilih **Teams**.

1. Di sebelah kanan nama tim, pilih **X**.

1. Untuk mengonfirmasi, pilih **Hapus**.

## Menambahkan atau menghapus pengguna dari tim
<a name="team-add-remove-user"></a>

Gunakan langkah-langkah ini untuk menambahkan pengguna ke tim atau menghapusnya dari tim.

**Untuk menambahkan pengguna ke tim**

1. Di sidebar, pilih ikon **Configuration** (gear), dan pilih **Teams**.

1. Pilih tim yang ingin Anda tambahkan pengguna.

1. Pilih **Tambah anggota**.

1. Di kotak **Tambahkan anggota tim**, pilih pengguna yang akan ditambahkan ke tim, lalu pilih **Tambahkan ke tim**.

**Untuk menghapus pengguna dari tim**

1. Di sidebar, pilih ikon **Configuration** (gear), dan pilih **Teams**.

1. Pilih tim tempat Anda ingin menghapus pengguna.

1. Di sebelah kanan nama pengguna, pilih **X**.

1. Untuk mengonfirmasi, pilih **Hapus**.

## Menggunakan sinkronisasi tim
<a name="Grafana-team-sync"></a>

Dengan *sinkronisasi tim*, Anda dapat mengatur sinkronisasi antara grup penyedia otorisasi dan tim di Grafana. Penyedia otorisasi yang saat ini didukung adalah IAM Identity Center dan SALL. 

**Untuk menyinkronkan tim Grafana dengan grup eksternal.**

1. **Di konsol Grafana, navigasikan ke **Konfigurasi, Tim**.** 

1. Untuk menyinkronkan dengan grup Pusat Identitas IAM, masukkan ID grup Pusat Identitas IAM. Untuk menyinkronkan dengan grup dari penyedia identitas berbasis SAFL, masukkan nilai nama atribut yang dimasukkan dalam bidang **grup atribut Assersion** di bagian konfigurasi SALL di halaman konfigurasi ruang kerja Amazon Managed Grafana.

1. Pilih **Tambah grup**.

# Menggunakan izin
<a name="Grafana-permissions"></a>

Apa yang dapat Anda lakukan di ruang kerja Grafana di Grafana Terkelola Amazon ditentukan oleh *izin* yang terkait dengan pengguna Anda. 

Grafana yang Dikelola Amazon menggunakan tiga jenis izin:
+ Izin diberikan sebagai admin Grafana
+ Izin yang terkait dengan keanggotaan Anda di tim
+ Izin diberikan ke folder atau dasbor tertentu

Anda dapat diberikan izin berdasarkan status admin, dasbor, atau izin folder yang ditetapkan untuk pengguna, dan izin sumber data. 

## Ikhtisar izin dasbor dan folder
<a name="dashboard-and-folder-permissions-overview"></a>

 Dengan menggunakan izin dasbor dan folder, Anda dapat menghapus izin berbasis peran default untuk editor dan pemirsa. Anda kemudian dapat menetapkan izin untuk pengguna dan tim tertentu. Untuk informasi selengkapnya, lihat [Izin dasbor dan folder](dashboard-and-folder-permissions.md). 

## Ikhtisar izin sumber data
<a name="data-source-permissions-overview"></a>

Secara default, sumber data dapat ditanyakan oleh pengguna mana pun. Misalnya, pengguna dengan `Viewer` peran dapat mengeluarkan kueri apa pun yang mungkin ke sumber data, bukan hanya kueri yang ada di dasbor tempat mereka memiliki akses.

****Menggunakan izin sumber data, Anda dapat mengubah izin default untuk sumber data dan membatasi izin kueri untuk Pengguna dan Tim tertentu.**** Lihat informasi yang lebih lengkap di [Izin sumber data](data-source-permissions.md).

# Izin dasbor dan folder
<a name="dashboard-and-folder-permissions"></a>

**Untuk dasbor dan folder dasbor, Anda dapat menggunakan halaman Izin untuk menghapus **izin** berbasis peran default untuk **Editor** dan Pemirsa.** **Di halaman ini, Anda dapat menambahkan dan menetapkan izin untuk **Pengguna** dan Tim tertentu.**

Grafana yang Dikelola Amazon menyediakan tingkat izin berikut. Izin bervariasi berdasarkan versi Grafana yang didukung ruang kerja.

**Untuk ruang kerja yang mendukung versi 8:**
+ `Admin`: Dapat mengedit dan membuat dasbor dan mengedit izin. Dapat juga menambah, mengedit, dan menghapus folder. 
+ `Edit`: Dapat mengedit dan membuat dasbor. **Tidak dapat** mengedit izin folder atau dasbor, atau menambah, mengedit, atau menghapus folder. 
+ `View`: Hanya dapat melihat dasbor dan folder yang ada.

**Untuk ruang kerja yang mendukung versi 9 ke atas:**
+ `Admin`: Dapat membuat, mengedit, atau menghapus dasbor. Dapat menambah, mengedit, atau menghapus folder, dan membuat dasbor dan subfolder dalam folder. Administrator juga dapat mengubah izin dasbor dan folder.
+ `Edit`: Dapat membuat, mengedit, atau menghapus dasbor. Dapat mengedit atau menghapus folder, dan membuat dasbor dan subfolder dalam folder. Editor **tidak dapat** mengubah izin folder atau dasbor.
+ `View`: Hanya dapat melihat dasbor dan folder yang ada.

## Memberikan izin folder
<a name="grant-folder-permissions"></a>

**Untuk memberikan izin folder**

1. **Di sidebar, arahkan kursor ke ikon **Dasbor** (kotak), lalu pilih Kelola.**

1. Arahkan kursor ke folder, lalu pilih **Pergi ke folder**.

1. Pada tab **Izin**, pilih **Tambahkan Izin**.

1. Di kotak dialog **Tambahkan Izin Untuk**, pilih **Pengguna**, **Tim**, atau salah satu opsi peran. Jika ruang kerja Anda menggunakan Grafana versi 10 atau yang lebih baru, **pilih Pengguna, Tim, Akun Layanan,** atau Peran.

1. Di kotak kedua, pilih pengguna, tim, akun layanan, atau peran yang ingin Anda tambahkan izin. Jika ruang kerja Anda menggunakan Grafana versi 9 atau sebelumnya, dan Anda memilih opsi peran di langkah sebelumnya, lewati langkah ini.

1. Di kotak ketiga, pilih izin yang ingin Anda tambahkan.

1. Pilih **Simpan**.

## Memberikan izin dasbor
<a name="grant-dashboard-permissions"></a>

**Untuk memberikan izin dasbor**

1. Di sudut kanan atas dasbor Anda, pilih ikon roda gigi untuk pergi ke **Pengaturan dasbor**.

1. Pada tab **Izin**, pilih **Tambahkan Izin**.

1. Di kotak dialog **Tambahkan Izin Untuk**, pilih **Pengguna**, **Tim**, atau salah satu opsi peran. Jika ruang kerja Anda menggunakan Grafana versi 10 atau yang lebih baru, **pilih Pengguna, Tim, Akun Layanan,** atau Peran.

1. Di kotak kedua, pilih pengguna, tim, akun layanan, atau peran yang ingin Anda tambahkan izin. Jika ruang kerja Anda menggunakan Grafana versi 9 atau sebelumnya, dan Anda memilih opsi peran di langkah sebelumnya, lewati langkah ini.

1. Di kotak ketiga, pilih izin yang ingin Anda tambahkan.

1. Pilih **Simpan**.

## Membatasi akses
<a name="restricting-access"></a>

 Izin tertinggi selalu menang. 
+  Anda tidak dapat mengganti izin untuk pengguna dengan peran tersebut. `Admin` Admin selalu memiliki akses ke semuanya. 
+  Izin yang lebih spesifik dengan tingkat izin yang lebih rendah tidak berpengaruh jika aturan yang lebih umum ada dengan tingkat izin yang lebih tinggi. Anda perlu menghapus atau menurunkan tingkat izin dari aturan yang lebih umum. 

## Bagaimana Grafana yang Dikelola Amazon menyelesaikan beberapa izin — contoh
<a name="how-grafana-resolves-multiple-permissions---examples"></a>

Contoh berikut menunjukkan bagaimana beberapa izin diselesaikan.

### Contoh 1: `user1` memiliki `Editor` peran
<a name="example-1-user1-has-the-editor-role"></a>

 Izin untuk dasbor: 
+  Setiap orang yang memiliki `Editor` peran dapat mengedit. 
+  `user1`dapat melihat. 

 Hasil: `user1` memiliki izin Edit karena izin tertinggi selalu menang. 

### Contoh 2: `user1` memiliki peran Viewer dan merupakan anggota `team1`
<a name="example-2-user1-has-the-viewer-role-and-is-a-member-of-team1"></a>

 Izin untuk dasbor: 
+  Setiap orang dengan `Viewer` peran dapat melihat. 
+  `user1`memiliki `Editor` peran dan dapat mengedit. 
+  `team1`memiliki `Admin` peran. 

 Hasil: `user1` memiliki izin Admin karena izin tertinggi selalu menang. 

### Contoh 3: `user1` memiliki beberapa izin di tingkat yang berbeda
<a name="example-3"></a>

 Izin untuk dasbor: 
+  `user1`memiliki `Admin` peran (diwarisi dari folder induk). 
+  `user1`memiliki `Editor` peran dan dapat mengedit. 

 Hasil: Anda tidak dapat mengganti izin yang lebih rendah. `user1`memiliki izin Admin karena izin tertinggi selalu menang. 

## Ringkasan
<a name="summary"></a>
+  **Lihat**: Hanya dapat melihat dasbor atau folder yang ada. 
+  Izin yang lebih spesifik dengan tingkat izin yang lebih rendah tidak akan berpengaruh jika aturan yang lebih umum ada dengan tingkat izin yang lebih tinggi. 

# Izin sumber data
<a name="data-source-permissions"></a>

Secara default, sumber data dapat ditanyakan oleh pengguna mana pun. Misalnya, pengguna dengan `Viewer` peran dapat mengeluarkan kueri apa pun yang mungkin ke sumber data, bukan hanya kueri yang ada di dasbor tempat mereka memiliki akses.

Anda dapat menggunakan izin sumber data untuk membatasi akses bagi pengguna untuk menanyakan sumber data. **Untuk setiap sumber data, ada halaman izin tempat Anda dapat mengaktifkan atau membatasi izin kueri untuk **Pengguna** dan Tim tertentu.**

## Mengaktifkan izin sumber data
<a name="enable-data-source-permissions"></a>

Saat izin diaktifkan untuk sumber data, Anda membatasi akses admin dan kueri untuk sumber data tersebut ke pengguna Admin secara default. Anda dapat secara selektif menambahkan akses untuk pengguna dan tim tertentu.

**Untuk mengaktifkan izin untuk sumber data**

1. Arahkan ke **Konfigurasi**, **Sumber Data**. Untuk ruang kerja yang mendukung Grafana versi 10, Arahkan **ke** Koneksi**,** Sumber Data.

1. Pilih sumber data yang ingin Anda aktifkan izinnya.

1. Pada tab **Izin**, pilih **Aktifkan**.

**Awas**  
Jika Anda mengaktifkan izin untuk sumber data default, pengguna yang tidak tercantum dalam izin tidak dapat memanggil kueri. Panel yang menggunakan sumber data default akan mengembalikan `Access denied to data source` kesalahan bagi pengguna tersebut.

## Memungkinkan pengguna dan tim untuk menanyakan sumber data
<a name="allow-users-and-teams-to-query-a-data-source"></a>

Setelah Anda mengaktifkan izin untuk sumber data, hanya admin yang memiliki akses ke sumber data tersebut secara default. Anda dapat menetapkan izin kueri untuk pengguna atau tim. Izin kueri akan memungkinkan akses untuk menanyakan sumber data.

**Untuk menetapkan izin kueri kepada pengguna dan tim**

1. Arahkan ke **Konfigurasi**, **Sumber Data**. Untuk ruang kerja yang mendukung Grafana versi 10, Arahkan **ke** Koneksi**,** Sumber Data.

1. Pilih sumber data yang ingin Anda tetapkan izin kueri.

1. Pada tab **Izin**, pilih **Tambahkan Izin**.

1. Pilih **Tim** atau **Pengguna**. **Untuk ruang kerja yang mendukung Grafana versi 10 atau yang lebih baru, Anda juga dapat **memilih Akun layanan** atau Peran.**

1. Pilih tim, pengguna, akun layanan, atau peran yang ingin Anda berikan akses kueri, lalu pilih **Simpan**.

## Menonaktifkan izin sumber data
<a name="disable-data-source-permissions"></a>

Jika Anda telah mengaktifkan izin untuk sumber data dan ingin mengembalikan izin sumber data ke default, ikuti langkah-langkah ini.

**catatan**  
*Semua* izin yang ada yang dibuat untuk sumber data akan dihapus.

**Untuk menonaktifkan izin untuk sumber data**

1. Arahkan ke **Konfigurasi**, **Sumber Data**. Untuk ruang kerja yang mendukung Grafana versi 10, Arahkan **ke** Koneksi**,** Sumber Data.

1. Pilih sumber data yang ingin Anda nonaktifkan izinnya.

1. Pada tab **Izin**, pilih **Nonaktifkan Izin**.

# Buat dasbor pertama Anda
<a name="getting-started-grafanaui"></a>

## Membuat dasbor
<a name="create-a-dashboard"></a>

Ikuti langkah-langkah ini untuk membuat dasbor di konsol Grafana.

**Untuk membuat dasbor pertama Anda**

1. Pilih ikon \$1 di panel kiri, pilih **Buat Dasbor**, lalu pilih **Tambahkan panel baru**.

1. Dalam tampilan ** Dashboard/Edit Panel Baru**, pilih tab **Query**. 

1. Konfigurasikan kueri Anda dengan memilih sumber data yang ingin Anda kueri. Misalnya, jika Anda menambahkan **TestDB** sebagai sumber data, ini menghasilkan dasbor sampel yang disebut dasbor Random Walk.

### Pengantar deret waktu
<a name="introduction-to-time-series"></a>

 Bayangkan Anda ingin tahu bagaimana suhu di luar berubah sepanjang hari. Setiap jam sekali, Anda akan memeriksa termometer dan menuliskan waktu bersama dengan suhu saat ini. Setelah beberapa saat, Anda akan memiliki sesuatu seperti data berikut. 


|  Waktu  |  Nilai  | 
| --- | --- | 
|  09:00  |  24° C  | 
|  10:00  |  26° C  | 
|  11:00  |  27° C  | 

 Data suhu seperti ini adalah salah satu contoh *deret waktu* —urutan pengukuran, yang diurutkan dalam waktu. Setiap baris dalam tabel mewakili satu pengukuran individu pada waktu tertentu. 

 Tabel berguna ketika Anda ingin mengidentifikasi pengukuran individu, tetapi mereka dapat membuat sulit untuk melihat gambaran besarnya. Visualisasi yang lebih umum untuk deret waktu adalah *grafik*, yang sebaliknya menempatkan setiap pengukuran sepanjang sumbu waktu. Representasi visual seperti grafik membuatnya lebih mudah untuk menemukan pola dan fitur data yang jika tidak akan sulit dilihat. 

 Contoh lain dari deret waktu adalah: 
+  Penggunaan CPU dan memori 
+  Data sensor 
+  Indeks pasar saham 

 Sementara masing-masing contoh ini adalah urutan pengukuran yang disusun secara kronologis, mereka juga berbagi atribut lain: 
+  Data baru ditambahkan di bagian akhir, pada interval reguler—misalnya, setiap jam pukul 09:00, 10:00, 11:00, dan seterusnya. 
+  Pengukuran jarang diperbarui setelah ditambahkan. Misalnya, suhu kemarin tidak berubah. 

 Deret waktu sangat kuat. Mereka membantu Anda memahami masa lalu dengan membiarkan Anda menganalisis keadaan sistem kapan saja. Deret waktu dapat memberi tahu Anda bahwa server mogok beberapa saat setelah ruang disk kosong turun ke nol. 

 Time series juga dapat membantu Anda memprediksi masa depan dengan mengungkap tren dalam data Anda. Misalnya, jika jumlah pengguna terdaftar telah meningkat setiap bulan sebesar 4 persen selama beberapa bulan terakhir, Anda dapat memprediksi seberapa besar basis pengguna Anda pada akhir tahun. 

 Beberapa deret waktu memiliki pola yang berulang selama periode yang diketahui. Misalnya, suhu biasanya lebih tinggi di siang hari, sebelum turun di malam hari. Dengan mengidentifikasi deret waktu periodik, atau *musiman* ini, Anda dapat membuat prediksi yang meyakinkan tentang periode berikutnya. Jika Anda tahu bahwa beban sistem memuncak setiap hari sekitar pukul 18:00, Anda dapat menambahkan lebih banyak mesin sebelumnya. 

#### Agregasi deret waktu
<a name="aggregating-time-series"></a>

 Tergantung pada apa yang Anda ukur, data dapat sangat bervariasi. Bagaimana jika Anda ingin membandingkan periode yang lebih lama dari interval antar pengukuran? Jika Anda mengukur suhu setiap jam sekali, Anda akan mendapatkan 24 titik data per hari. Untuk membandingkan suhu di bulan Agustus selama bertahun-tahun, Anda harus menggabungkan 31 kali 24 titik data menjadi satu. 

 Menggabungkan kumpulan pengukuran disebut *agregasi*. Ada beberapa cara untuk mengumpulkan data deret waktu. Berikut adalah beberapa yang umum: 
+  **Rata-rata** mengembalikan jumlah semua nilai dibagi dengan jumlah total nilai. 
+  **Min** dan **Max** mengembalikan nilai terkecil, dan terbesar dalam koleksi. 
+  **Jumlah** mengembalikan jumlah semua nilai dalam koleksi. 
+  **Count** mengembalikan jumlah nilai dalam koleksi. 

 Misalnya, dengan menggabungkan data dalam sebulan, Anda dapat menentukan bahwa Agustus 2017 rata-rata lebih hangat dari tahun sebelumnya. Jika Anda ingin melihat bulan mana yang memiliki suhu tertinggi, Anda akan membandingkan suhu maksimum untuk setiap bulan. 

 Bagaimana Anda mengumpulkan data deret waktu Anda adalah keputusan penting, dan itu tergantung pada cerita yang ingin Anda ceritakan dengan data Anda. Adalah umum untuk menggunakan agregasi yang berbeda untuk memvisualisasikan data deret waktu yang sama dengan cara yang berbeda. 

#### Deret waktu dan pemantauan
<a name="time-series-and-monitoring"></a>

 Dalam industri TI, data time series sering dikumpulkan untuk memantau hal-hal seperti infrastruktur, perangkat keras, atau peristiwa aplikasi. Data deret waktu yang dihasilkan mesin biasanya dikumpulkan dengan interval pendek, sehingga Anda dapat bereaksi terhadap perubahan yang tidak terduga, beberapa saat setelah itu terjadi. Data terakumulasi dengan cepat, sehingga penting untuk memiliki cara untuk menyimpan dan menanyakan data secara efisien. Akibatnya, database yang dioptimalkan untuk data deret waktu telah mengalami peningkatan popularitas dalam beberapa tahun terakhir. 

##### Database deret waktu
<a name="time-series-databases"></a>

 Database time series (TSDB) adalah database yang dirancang secara eksplisit untuk data deret waktu. Meskipun dimungkinkan untuk menggunakan database reguler apa pun untuk menyimpan pengukuran, TSDB dilengkapi dengan beberapa pengoptimalan yang berguna. 

 Modern TSDBs mengambil keuntungan dari fakta bahwa pengukuran hanya pernah ditambahkan, dan jarang diperbarui atau dihapus. Misalnya, stempel waktu untuk setiap pengukuran berubah sedikit dari waktu ke waktu, yang menghasilkan data yang berlebihan disimpan. 

 Contoh berikut menunjukkan urutan stempel waktu Unix. 

```
1572524345, 1572524375, 1572524404, 1572524434, 1572524464
```

 Melihat stempel waktu ini, semuanya dimulai dengan`1572524`, yang menyebabkan penggunaan ruang disk yang buruk. Sebagai gantinya, Anda dapat menyimpan setiap stempel waktu berikutnya sebagai perbedaan, atau *delta*, dari yang pertama, seperti yang ditunjukkan pada contoh berikut. 

```
1572524345, +30, +29, +30, +30
```

Anda bahkan dapat melangkah lebih jauh dengan menghitung delta delta ini, seperti yang ditunjukkan pada contoh berikut. 

```
1572524345, +30, -1, +1, +0
```

 Jika pengukuran dilakukan secara berkala, sebagian besar delta-of-deltas akan menjadi 0. Karena pengoptimalan seperti ini, TSDBs gunakan ruang yang jauh lebih sedikit daripada database lainnya. 

 Fitur lain dari TSDB adalah kemampuan untuk memfilter pengukuran dengan menggunakan *tag*. Setiap titik data diberi label dengan tag yang menambahkan informasi konteks, seperti di mana pengukuran dilakukan.

 Berikut ini TSDBs didukung oleh Grafana: 
+  [Grafit](https://graphiteapp.org/) 
+  [InfluxDB](https://www.influxdata.com/products/influxdb-overview/) 
+  [Prometheus](https://prometheus.io/) 

  ```
  weather,location=us-midwest temperature=82 1465839830100400200
    |    -------------------- --------------  |
    |             |             |             |
    |             |             |             |
  +-----------+--------+-+---------+-+---------+
  |measurement|,tag_set| |field_set| |timestamp|
  +-----------+--------+-+---------+-+---------+
  ```

##### Mengumpulkan data deret waktu
<a name="collecting-time-series-data"></a>

 Sekarang setelah Anda memiliki tempat untuk menyimpan deret waktu Anda, bagaimana Anda benar-benar mengumpulkan pengukuran? Untuk mengumpulkan data deret waktu, Anda biasanya memasang *kolektor* pada perangkat, mesin, atau instance yang ingin Anda pantau. Beberapa kolektor dibuat dengan database tertentu dalam pikiran, dan beberapa mendukung tujuan output yang berbeda. 

 Berikut adalah beberapa contoh kolektor: 
+  [collectd](https://collectd.org/) 
+  [statsd](https://github.com/statsd/statsd) 
+  [Eksportir Prometheus](https://prometheus.io/docs/instrumenting/exporters/) 
+  [Telegraf](https://github.com/influxdata/telegraf) 

 Seorang kolektor baik *mendorong* data ke database atau membiarkan database *menarik* data dari kolektor. Setiap pendekatan dilengkapi dengan pro dan kontra sendiri. 


|   |  Pro  |  Kontra  | 
| --- | --- | --- | 
|  Dorong  |  Lebih mudah untuk mereplikasi data ke beberapa tujuan.  |  TSDB tidak memiliki kendali atas berapa banyak data yang dikirim.  | 
|  Tarik  |  Kontrol lebih besar atas bagaimana jumlah data yang dicerna dan keaslian data.  |  Firewall, VPNs, atau penyeimbang beban dapat membuat sulit untuk mengakses agen.  | 

 Karena tidak efisien untuk menulis setiap pengukuran ke database, kolektor melakukan pra-agregat data dan menulis ke TSDB secara berkala. 

### Dimensi deret waktu
<a name="time-series-dimensions"></a>

 Dengan data deret waktu, data seringkali merupakan kumpulan beberapa deret waktu. Banyak sumber data Grafana mendukung jenis data ini. 

 Kasus umum adalah mengeluarkan kueri tunggal untuk pengukuran dengan satu atau lebih properti tambahan sebagai dimensi. Misalnya, Anda mungkin menanyakan pengukuran suhu bersama dengan properti lokasi. Dalam hal ini, beberapa seri dikembalikan kembali dari kueri tunggal itu, dan setiap seri memiliki lokasi unik sebagai dimensi. 

 *Untuk mengidentifikasi seri unik dalam serangkaian deret waktu, Grafana menyimpan dimensi dalam label.* 

#### Label
<a name="labels"></a>

 Setiap deret waktu di Grafana secara opsional memiliki label. Label adalah satu set pasangan kunci-nilai untuk mengidentifikasi dimensi. Contoh label adalah `{location=us}` atau`{country=us,state=ma,city=boston}`. Dalam satu set deret waktu, kombinasi nama dan labelnya mengidentifikasi setiap seri. Misalnya, `temperature {country=us,state=ma,city=boston}`. 

 Sumber data deret waktu yang berbeda memiliki dimensi yang disimpan secara asli, atau pola penyimpanan umum yang memungkinkan data diekstraksi ke dalam dimensi. 

 Biasanya, TSDBs secara native mendukung dimensi. *Prometheus menyimpan dimensi dalam label.* TSDBs Seperti Graphite atau OpenTSDB, istilah *tag* digunakan sebagai gantinya. 

 Dalam database tabel seperti SQL, dimensi ini umumnya `GROUP BY` parameter query. 

#### Beberapa dimensi dalam format tabel
<a name="multiple-dimensions-in-table-format"></a>

 Dalam database SQL atau SQL seperti yang mengembalikan respons tabel, dimensi tambahan biasanya adalah kolom dalam tabel respons kueri. 

##### Dimensi tunggal
<a name="single-dimension"></a>

 Misalnya, pertimbangkan kueri seperti contoh berikut. 

```
SELECT BUCKET(StartTime, 1h), AVG(Temperature) AS Temp, Location FROM T
  GROUP BY BUCKET(StartTime, 1h), Location
  ORDER BY time asc
```

 Kueri mungkin mengembalikan tabel dengan tiga kolom.


|  StartTime  |  Temp  |  Lokasi  | 
| --- | --- | --- | 
|  09:00  |  24  |  LGA  | 
|  09:00  |  20  |  BOS  | 
|  10:00  |  26  |  LGA  | 
|  10:00  |  22  |  BOS  | 

 Format tabel adalah deret waktu yang diformat *panjang*, juga disebut *tinggi*. Ini memiliki stempel waktu berulang, dan nilai berulang di Lokasi. Dalam hal ini, dua deret waktu dalam set akan diidentifikasi sebagai `Temp {Location=LGA}` dan`Temp {Location=BOS}`. 

 Deret waktu individu dari himpunan diekstraksi dengan menggunakan dimensi berikut: 
+ Kolom yang diketik waktu `StartTime` sebagai indeks waktu dari deret waktu
+ Kolom yang diketik numerik `Temp` sebagai nama seri
+ Nama dan nilai `Location` kolom yang diketik string untuk membangun label, seperti location=LGA

##### Beberapa dimensi
<a name="multiple-dimensions"></a>

 Jika kueri diperbarui untuk memilih dan mengelompokkan lebih dari satu kolom string (misalnya,`GROUP BY BUCKET(StartTime, 1h), Location, Sensor`), dimensi tambahan ditambahkan.


|  StartTime  |  Temp  |  Lokasi  |  Sensor  | 
| --- | --- | --- | --- | 
|  09:00  |  24  |  LGA  |  A  | 
|  09:00  |  24.1  |  LGA  |  B  | 
|  09:00  |  20  |  BOS  |  A  | 
|  09:00  |  20.2  |  BOS  |  B  | 
|  10:00  |  26  |  LGA  |  A  | 
|  10:00  |  26.1  |  LGA  |  B  | 
|  10:00  |  22  |  BOS  |  A  | 
|  10:00  |  22.2  |  BOS  |  B  | 

 Dalam hal ini, label yang mewakili dimensi memiliki dua kunci berdasarkan dua kolom yang diketik string, `Location` dan`Sensor`. Data menghasilkan empat seri:
+ `Temp {Location=LGA,Sensor=A}`
+ `Temp {Location=LGA,Sensor=B}`
+ `Temp {Location=BOS,Sensor=A}`
+ `Temp {Location=BOS,Sensor=B}`

**catatan**  
 **Catatan:** Beberapa dimensi tidak didukung dengan cara memetakan ke beberapa peringatan di Grafana. Sebaliknya, mereka diperlakukan sebagai beberapa kondisi untuk satu peringatan. 

##### Beberapa nilai
<a name="multiple-values"></a>

 Dalam kasus sumber data seperti SQL, lebih dari satu kolom numerik dapat dipilih, dengan atau tanpa kolom string tambahan untuk digunakan sebagai dimensi; misalnya,. `AVG(Temperature) AS AvgTemp, MAX(Temperature) AS MaxTemp` Ini, jika dikombinasikan dengan beberapa dimensi, dapat menghasilkan banyak seri. Memilih beberapa nilai saat ini dirancang untuk digunakan hanya dengan visualisasi. 

### Pengantar histogram dan peta panas
<a name="introduction-to-histograms-and-heatmaps"></a>

 Histogram adalah representasi grafis dari distribusi data numerik. Ini mengelompokkan nilai ke dalam ember (kadang-kadang juga disebut tempat sampah). Kemudian menghitung berapa banyak nilai yang jatuh ke dalam setiap ember. 

 Alih-alih membuat grafik nilai aktual, histogram membuat grafik ember. Setiap batang mewakili ember, dan tinggi batang mewakili frekuensi (seperti hitungan) nilai yang jatuh ke dalam interval ember itu. 

 Histogram hanya melihat *distribusi nilai selama rentang* waktu tertentu. Masalah dengan histogram adalah Anda tidak dapat melihat tren atau perubahan distribusi dari waktu ke waktu. Di sinilah peta panas menjadi berguna. 

#### Peta panas
<a name="heatmaps"></a>

 *Peta panas* seperti histogram dari waktu ke waktu, di mana setiap irisan waktu mewakili histogramnya sendiri. Alih-alih menggunakan tinggi batang sebagai representasi frekuensi, ia menggunakan sel, mewarnai sel sebanding dengan jumlah nilai dalam ember. 

#### Data pra-bucketed
<a name="pre-bucketed-data"></a>

 Sejumlah sumber data mendukung histogram dari waktu ke waktu, termasuk yang berikut:
+  OpenSearch Layanan Amazon (dengan menggunakan agregasi bucket histogram)
+ ***Prometheus (dengan tipe metrik histogram dan [opsi](https://prometheus.io/docs/concepts/metric_types/#histogram) Format sebagai disetel ke Heatmap)***

Umumnya, Anda dapat menggunakan sumber data apa pun yang mengembalikan seri dengan nama yang mewakili bucket bound atau mengembalikan seri yang diurutkan berdasarkan terikat dalam urutan menaik. 

#### Data mentah vs. data agregat
<a name="raw-data-vs-aggregated"></a>

 Jika Anda menggunakan peta panas dengan data deret waktu reguler (bukan pra-bucketed), penting untuk diingat bahwa data Anda sering kali sudah dikumpulkan oleh backend deret waktu Anda. Sebagian besar kueri deret waktu tidak mengembalikan data sampel mentah. Sebaliknya, mereka memasukkan grup berdasarkan interval waktu atau maxDataPoints batas yang digabungkan dengan fungsi agregasi (biasanya rata-rata). 

 Itu tergantung pada rentang waktu kueri Anda. Poin penting adalah untuk mengetahui bahwa bucketing histogram yang dilakukan Grafana mungkin dilakukan pada data yang sudah dikumpulkan dan dirata-ratakan. Untuk peta panas yang lebih akurat, lebih baik melakukan bucketing selama pengumpulan metrik atau menyimpan data di OpenSearch, atau di sumber data lain yang mendukung melakukan penghematan histogram pada data mentah. 

 Jika Anda menghapus atau menurunkan grup berdasarkan waktu (atau menaikkan maxDataPoints) kueri untuk mengembalikan lebih banyak titik data, peta panas Anda lebih akurat. Tetapi ini juga dapat menempatkan beban berat pada CPU dan memori Anda. Jika jumlah titik data menjadi tidak masuk akal besar, itu dapat menyebabkan macet dan crash. 

# Perluas ruang kerja Anda dengan plugin
<a name="grafana-plugins"></a>

*Plugin Grafana* menambahkan kemampuan untuk terhubung ke sumber data baru, atau menambahkan visualisasi atau fungsionalitas lain ke ruang kerja. Secara umum, plugin memiliki tiga jenis:
+ **Plugin panel** - Plugin panel menambahkan jenis visualisasi baru yang tersedia untuk digunakan di dasbor Anda. Ini menentukan rendering data di frontend.
+ **Plugin sumber data** — Plugin sumber data berkomunikasi dengan sumber data eksternal, dan mengembalikan data dalam format yang dapat digunakan Grafana.
+ **Plugin aplikasi** — Aplikasi, juga dikenal sebagai plugin aplikasi. Ini termasuk menggabungkan sumber data dan panel, dan dapat memberikan pengalaman yang kohesif dalam ruang kerja Grafana Anda.

**catatan**  
Ketika Amazon menentukan bahwa plugin sering gagal atau belum dipertahankan, itu mungkin menghapus plugin dari daftar plugin yang tersedia di konsol.

Untuk ruang kerja Grafana Terkelola Amazon yang mendukung versi 9 atau yang lebih baru, Anda dapat mengaktifkan pengelolaan plugin. *Hal ini memungkinkan admin ruang kerja untuk menginstal atau menghapus plugin dari katalog plugin.*

## Temukan plugin dengan katalog plugin
<a name="plugin-catalog"></a>

Ruang kerja Grafana Terkelola Amazon Anda menyertakan halaman yang menampilkan semua plugin yang diinstal dan daftar semua plugin yang tersedia untuk dipasang di ruang kerja Anda. Halaman ini adalah *katalog plugin*. Selain plugin yang diinstal secara default, Anda dapat menginstal hingga 50 plugin lainnya.

Plugin yang tersedia jatuh secara luas ke dalam kategori berikut:
+ **AWS Sumber Data** — Ini adalah plugin aplikasi, yang disediakan oleh Amazon Managed Grafana, untuk dengan mudah menemukan AWS sumber daya di akun Anda. Ini diinstal secara default. Untuk informasi selengkapnya, lihat [Gunakan plugin Sumber AWS Data untuk menemukan AWS data](aws-datasources-plugin.md).
+ **Plugin inti — Plugin** ini disediakan secara default di Grafana. Mereka termasuk sumber data populer dan visualisasi panel. Mereka ditandai sebagai **Core** dalam katalog plugin. Ini diinstal secara default dan tidak dapat dihapus.
+ **Plugin perusahaan** — Plugin ini tersedia untuk ruang kerja Grafana yang memiliki lisensi perusahaan. Ini tidak diinstal secara default. Mereka ditandai sebagai **Enterprise** dalam katalog plugin. Mereka hanya dapat diinstal jika Anda memiliki lisensi perusahaan yang valid. Untuk detail tentang cara meningkatkan ruang kerja ke lisensi Enterprise, lihat[Mengelola akses Anda ke plugin Amazon Managed Grafana Enterprise](AMG-workspace-manage-enterprise.md).
+ **Plugin komunitas — Plugin** ini disediakan untuk ruang kerja Grafana dari berbagai sumber, termasuk Grafana Labs,, dan lainnya. AWS Di ruang kerja Grafana yang mendukung versi 9 atau yang lebih baru, ini tidak diinstal secara default (ruang kerja sebelumnya memiliki beberapa di antaranya diinstal secara otomatis). Ini biasanya plugin open source. Anda dapat menginstal atau menghapus plugin ini.
**catatan**  
Menggunakan plugin komunitas adalah kebijaksanaan Anda. Sebagai bagian dari [model tanggung jawab bersama](security.md) antara Anda dan AWS, Anda diharapkan untuk memahami apa yang Anda instal ke ruang kerja Anda untuk plugin pihak ketiga ini. Anda juga bertanggung jawab atas plugin yang memenuhi kebutuhan keamanan Anda.

**Dukungan plugin**

Plugin berasal dari berbagai sumber, dan dukungan bervariasi untuk mereka.
+ **AWS Plugin Sumber Data** - Plugin ini disediakan oleh dan didukung oleh AWS.
+ **Plugin perusahaan — Plugin** Enterprise didukung oleh keduanya dan AWS Grafana Labs — Anda dapat mengirimkan masalah melalui salah satu tim dukungan.
+ **Plugin inti** — Plugin inti dan plugin lain yang disediakan oleh atau AWS Grafana Labs didukung di Amazon Managed Grafana oleh. AWS Anda dapat mengirimkan masalah GitHub untuk perbaikan bug atau penyempurnaan, atau membuat tiket dengan atau Grafana Labs. AWS 
+ **Plugin komunitas** — Plugin komunitas yang tidak dibuat oleh atau AWS Grafana Labs biasanya didukung melalui GitHub masalah atau forum lain. Support informasi dalam kasus tersebut termasuk dalam rincian untuk plugin di katalog plugin.

[Anda juga dapat mengirimkan masalah untuk plugin melalui GitHub forum untuk Grafana atau [Grafana yang Dikelola Amazon](https://github.com/aws/amazon-managed-grafana-roadmap/issues).](https://github.com/grafana/grafana/issues)

**Versi plugin**

Sebagian besar plugin diperbarui dengan irama reguler. Katalog plugin di ruang kerja Grafana yang Dikelola Amazon menunjukkan versi terbaru dari sebuah plugin, dan Anda memilih versi mana yang akan diinstal. Ketika sebuah plugin memiliki versi usang dengan masalah keamanan yang diketahui, versi usang dihapus dari ketersediaan.

Anda juga dapat [memperbarui](#update-plugin) plugin yang sudah diinstal.

**catatan**  
Terkadang, versi baru plugin tersedia yang memperbaiki masalah keamanan di plugin yang diinstal. Untuk masalah yang parah, Grafana Terkelola Amazon mungkin secara otomatis memperbarui plugin di ruang kerja Anda ke versi dengan perbaikan.

## Kelola plugin dengan katalog plugin
<a name="manage-plugins"></a>

Anda mengelola plugin untuk ruang kerja Grafana Terkelola Amazon Anda dari katalog plugin. Anda hanya dapat menginstal plugin yang tercantum dalam katalog plugin dalam ruang kerja Anda.

Berikut ini menjelaskan prasyarat untuk menggunakan katalog plugin, dan cara menemukan katalog plugin.

**Prasyarat**
+ Anda harus memiliki [ruang kerja Grafana Terkelola Amazon](AMG-create-workspace.md) yang mendukung versi 9, dan memiliki akun yang dapat masuk ke ruang kerja tersebut.
+ Ruang kerja harus [mengaktifkan manajemen plugin](AMG-configure-workspace.md).
+ Akun pengguna Anda harus menjadi [admin untuk ruang kerja Grafana Terkelola Amazon Anda](Grafana-user-roles.md).
+ Untuk menginstal dan menggunakan plugin Enterprise, Anda harus terlebih dahulu [meningkatkan ke lisensi Enterprise](AMG-workspace-manage-enterprise.md).

**Untuk melihat katalog plugin**

1. Masuk ke ruang kerja Grafana Terkelola Amazon Anda.

1. Dari menu sebelah kiri, pilih **Administrasi**, lalu **Plugin**. Ini membuka katalog plugin.

1. Secara default, katalog plugin mencantumkan plugin yang diinstal. Untuk melihat semua plugin yang tersedia, pilih **Semua** di bawah filter **Negara** di bagian atas katalog. Plugin yang diinstal menyertakan tag yang bertuliskan **Installed**.

## Instal atau hapus plugin
<a name="install-plugin"></a>

**catatan**  
Anda harus memenuhi prasyarat dari bagian sebelumnya, atau Anda tidak akan memiliki izin untuk memodifikasi plugin.

**Untuk menginstal atau menghapus plugin Grafana**

1. Buka katalog plugin.

1. Secara default, katalog plugin hanya mencantumkan plugin yang diinstal. Untuk melihat semua plugin yang tersedia, pilih **Semua** di bawah filter **Negara** di bagian atas katalog. Plugin yang diinstal menyertakan tag yang bertuliskan **Installed**.

1. Pilih plugin untuk menginstal atau menghapus instalasi. Misalnya, jika Anda ingin menghapus sumber data *Datadog*, pilih plugin **Datadog**.

1. Pada halaman detail plugin, pilih opsi uninstall atau install.

1. Setelah plugin diinstal, diperlukan waktu hingga beberapa menit sebelum perubahan disinkronkan di semua bagian ruang kerja. Ada baiknya menunggu beberapa menit sebelum menggunakan plugin baru.

**catatan**  
Anda dapat menginstal 50 plugin di ruang kerja (di luar plugin Core default).

## Perbarui plugin
<a name="update-plugin"></a>

**Untuk memperbarui plugin Grafana yang ada**

1. Masuk ke ruang kerja Grafana Terkelola Amazon Anda.

1. Dari menu sebelah kiri, pilih **Administrasi**, lalu **Plugin**. Ini membuka katalog plugin, hanya mencantumkan plugin yang diinstal.

1. Pilih plugin yang akan diperbarui.

1. Pada halaman detail plugin, periksa untuk melihat apakah ada pembaruan yang tersedia. Jika demikian, pilih opsi untuk memperbarui plugin dan pilih versi yang akan diperbarui.
**catatan**  
Jika Anda melihat catatan bahwa Anda tidak memiliki izin untuk memodifikasi plugin, konfirmasikan bahwa [manajemen plugin diaktifkan](AMG-configure-workspace.md) untuk ruang kerja Anda. Anda juga harus menjadi [admin](Grafana-user-roles.md) untuk ruang kerja Grafana yang Dikelola Amazon.

# Gunakan plugin Sumber AWS Data untuk menemukan AWS data
<a name="aws-datasources-plugin"></a>

AWS menyediakan plugin aplikasi untuk mempermudah menemukan dan menggunakan AWS sumber daya sebagai sumber data di ruang kerja Grafana yang Dikelola Amazon Anda. Plugin *Sumber AWS Data* diinstal secara default di ruang kerja baru.

Plugin Sumber AWS Data memerlukan izin untuk mengakses sumber daya Anda untuk penemuan. Untuk informasi selengkapnya, lihat [Izin yang diperlukan](#aws-ds-plugin-permissions).

## Buka plugin Sumber AWS Data
<a name="aws-ds-plugin-open"></a>

**Untuk membuka plugin Sumber AWS Data**

1. Masuk ke ruang kerja Grafana Terkelola Amazon Anda.

1. Dari **menu** di kiri atas, pilih **Aplikasi**, lalu **Sumber AWS Data**.

Antarmuka plugin Sumber AWS Data muncul daftar AWS layanan yang dapat Anda cari sumber daya.

## Temukan sumber daya
<a name="aws-ds-plugin-use"></a>

**Untuk menemukan sumber daya dari Anda Akun AWS**

1. Buka plugin Sumber AWS Data.

1. Dari daftar AWS layanan, pilih salah satu yang ingin Anda temukan sumber daya untuk digunakan sebagai sumber data. Misalnya, pilih **Amazon Managed Service untuk Prometheus**. Ini akan membawa Anda ke tab **Sumber data**, dengan **Layanan** yang dipilih untuk Anda.

1. Pilih AWS Wilayah tempat Anda ingin menemukan sumber daya. Misalnya, pilih`US East (N. Virginia)`.
**catatan**  
Untuk menemukan sumber daya, plugin harus memiliki [izin](#aws-ds-plugin-permissions) yang sesuai untuk mengakses layanan itu di wilayah itu.

1. Beberapa layanan dapat memiliki banyak sumber daya di suatu wilayah. Jika ada beberapa sumber daya di wilayah ini, plugin Sumber AWS Data menyediakan daftar untuk dipilih.

   Dari daftar sumber daya (dalam hal ini, Amazon Managed Service untuk Prometheus), pilih sumber daya yang ingin Anda gunakan sebagai sumber data. Misalnya, memilih Layanan Terkelola Amazon untuk ruang kerja Prometheus akan menyiapkan sumber daya tersebut sebagai sumber data Sumber data siap digunakan di dasbor atau pemantauan dengan Grafana Terkelola Amazon.

1. Sumber daya dalam layanan dan Wilayah yang telah Anda sediakan muncul di bagian bawah halaman.

   (Opsional) Anda dapat memilih **Buka pengaturan untuk** melihat dan mengedit pengaturan untuk sumber data tersebut.

**catatan**  
Plugin Sumber AWS Data bergantung pada masing-masing plugin sumber data yang dipasang di ruang kerja Anda. Misalnya, jika Anda ingin menggunakan AWS X-Ray fungsionalitas, Anda harus menginstal plugin sumber data X-Ray dari [katalog plugin](grafana-plugins.md#manage-plugins).

## Versi dan memperbarui plugin
<a name="aws-ds-plugin-versions"></a>

Plugin Sumber AWS Data diperbarui secara berkala. Versi yang diinstal dengan ruang kerja baru biasanya bukan versi terbaru. Versi yang lebih baru dapat memiliki lebih banyak fungsionalitas daripada yang diinstal di ruang kerja Anda. Misalnya, versi yang lebih baru mungkin mendukung AWS layanan tambahan sebagai sumber data.

Untuk melihat perubahan di setiap versi plugin Sumber AWS Data, Anda dapat melihat [Changelog](https://grafana.com/grafana/plugins/aws-datasource-provisioner-app/?tab=changelog).

Untuk memperbarui ke versi plugin yang lebih baru, ikuti instruksi standar untuk[Perbarui plugin](grafana-plugins.md#update-plugin).

**catatan**  
Jika Anda memperbarui ke versi plugin Sumber AWS Data yang lebih baru, Anda perlu memberikan [izin](#aws-ds-plugin-permissions) tambahan untuk sumber data baru yang tidak dikelola oleh Grafana Terkelola Amazon.

## Izin yang diperlukan
<a name="aws-ds-plugin-permissions"></a>

Plugin Sumber AWS Data memerlukan izin untuk mengakses AWS sumber daya Anda. Cara termudah untuk melakukannya adalah dengan mengizinkan Grafana Terkelola Amazon mengelola izin untuk Anda. Untuk mempelajari cara menyiapkan izin yang dikelola layanan untuk sumber data, lihat. [Mengelola izin untuk sumber data dan saluran notifikasi](AMG-datasource-and-notification.md) Grafana Terkelola Amazon dapat mengelola izin untuk AWS sumber daya yang disertakan dalam plugin Sumber AWS Data secara default.

Jika Anda memperbarui plugin Sumber AWS Data ke versi yang lebih baru daripada yang disertakan secara default di ruang kerja Anda, plugin tersebut dapat menambahkan dukungan untuk AWS sumber daya yang izinnya tidak dikelola oleh Grafana yang Dikelola Amazon secara otomatis. Dalam kasus ini, Anda harus menambahkan izin sendiri. Misalnya, AWS IoT TwinMaker ditambahkan ke versi terbaru dari plugin, (versi 1.9.0), dan izin untuk ini tidak dikelola oleh Amazon Managed Grafana.

Untuk mempelajari lebih lanjut tentang izin untuk sumber data tertentu, lihat detail untuk sumber data yang disediakan di [Connect ke sumber data](AMG-data-sources.md) bagian. Misalnya, [Connect ke sumber AWS IoT TwinMaker data](AMG-iot-twinmaker.md) bagian ini mencakup detail tentang memberikan izin Grafana Terkelola Amazon untuk mengakses. AWS IoT TwinMaker

# Connect ke sumber data
<a name="AMG-data-sources"></a>

Grafana yang Dikelola Amazon mendukung banyak sumber *data* yang berbeda. Sumber data adalah backend penyimpanan yang dapat Anda kueri di Grafana untuk melakukan hal-hal seperti membangun dasbor. Setiap sumber data memiliki editor kueri khusus yang disesuaikan untuk fitur dan kemampuan yang diekspos oleh sumber data tertentu.

Bahasa kueri dan kemampuan setiap sumber data berbeda. Anda dapat menggabungkan data dari beberapa sumber data ke satu dasbor.

Setiap AWS akun yang menggunakan Grafana Terkelola Amazon memiliki akses untuk membuat atau mengonfigurasi banyak sumber data. Beberapa sumber data mengharuskan Anda untuk menginstal plugin masing-masing untuk sumber data tersebut. Jika Anda memutakhirkan ruang kerja Anda ke plugin Amazon Managed Grafana Enterprise, Anda mungkin juga perlu menginstal plugin untuk sumber data Enterprise. Bagian berikut menjelaskan detail dari banyak sumber data yang tersedia, tetapi komunitas Grafana terkadang menambahkan sumber data baru yang mungkin tersedia di [katalog plugin](grafana-plugins.md#plugin-catalog) di dalam ruang kerja Anda.

**catatan**  
Untuk membantu Anda menemukan AWS sumber daya di akun dan mengatur sumber data untuk menanyainya, Grafana Terkelola Amazon menyediakan. [Gunakan plugin Sumber AWS Data untuk menemukan AWS data](aws-datasources-plugin.md)

## Sumber data khusus
<a name="AMG-data-sources-special"></a>

Grafana yang Dikelola Amazon mencakup tiga sumber data khusus:
+ **Grafana** (disebut *TestDB* di versi Grafana sebelumnya — Gunakan sumber data bawaan ini untuk menghasilkan data berjalan acak, atau daftar file. Ini berguna untuk menguji visualisasi dan menjalankan eksperimen.
+ **Campuran** — Gunakan ini untuk menanyakan beberapa sumber data di panel yang sama. Saat Anda menggunakan sumber data ini, Anda dapat menentukan sumber data untuk setiap kueri baru yang Anda tambahkan. Kueri pertama menggunakan sumber data yang Anda tentukan sebelum memilih **Mixed**.

   Anda tidak dapat mengubah kueri yang ada untuk menggunakan sumber data campuran.
+ **Dasbor** — Gunakan ini untuk menggunakan set hasil dari panel lain di dasbor yang sama.

**penting**  
Grafana yang Dikelola Amazon memiliki batas waktu tunggu sumber data, yang mungkin mengesampingkan batas batas waktu yang dikonfigurasi pada sumber data. Bagian bawah dari dua batas menggantikan yang lain. Untuk mempelajari tentang batas waktu tunggu sumber data Grafana yang Dikelola Amazon, lihat kuota layanan [Grafana Terkelola](https://docs.aws.amazon.com/general/latest/gr/grafana-service.html#grafana-quotas) Amazon di. *Referensi Umum AWS*

**Topics**
+ [Sumber data khusus](#AMG-data-sources-special)
+ [Bagaimana Amazon Managed Grafana bekerja dengan AWS Organizations untuk akses sumber AWS data](AMG-and-Organizations.md)
+ [Connect ke sumber data bawaan](AMG-data-sources-builtin.md)
+ [Connect ke sumber data Enterprise](AMG-data-sources-enterprise.md)

# Bagaimana Amazon Managed Grafana bekerja dengan AWS Organizations untuk akses sumber AWS data
<a name="AMG-and-Organizations"></a>

Dengan AWS Organizations, Anda dapat mengelola konfigurasi sumber data dan pengaturan izin secara terpusat untuk beberapa AWS akun. Di ruang kerja Grafana yang Dikelola Amazon, Anda dapat menentukan unit organisasi lain agar sumber AWS datanya tersedia untuk dilihat di akun utama. Akun AWS 

Misalnya, Anda dapat menggunakan satu akun di organisasi sebagai akun *manajemen* Grafana Terkelola Amazon, dan memberikan akses akun ini ke sumber data di akun lain di organisasi. Di akun manajemen, daftarkan semua unit organisasi yang memiliki sumber AWS data yang ingin Anda akses dengan akun manajemen. Ini secara otomatis membuat kebijakan peran dan izin yang Anda perlukan untuk menyiapkan sumber data ini, yang dapat Anda lihat di konsol Grafana di ruang kerja Grafana yang Dikelola Amazon.

Untuk informasi selengkapnya tentang Organizations, lihat [Apa itu AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html).

Grafana Terkelola Amazon menggunakan CloudFormation StackSets untuk secara otomatis membuat peran AWS Identity and Access Management (IAM) yang diperlukan untuk Grafana Terkelola Amazon untuk terhubung ke sumber data di seluruh organisasi Anda. AWS Sebelum Amazon Managed Grafana dapat mengelola kebijakan IAM Anda untuk mengakses sumber data di seluruh organisasi, Anda harus mengaktifkan AWS CloudFormation StackSets di akun manajemen organisasi Anda. Grafana yang Dikelola Amazon secara otomatis mengaktifkan ini saat pertama kali diperlukan.

## Skenario penyebaran untuk integrasi dengan AWS IAM Identity Center dan Organizations
<a name="AMG-and-SSO-and-Organizations-scenarios"></a>

Jika Anda menggunakan Grafana Terkelola Amazon dengan keduanya dan AWS IAM Identity Center Organizations, sebaiknya Anda membuat ruang kerja Grafana Terkelola Amazon di organisasi Anda menggunakan salah satu dari tiga skenario berikut. Untuk setiap skenario, Anda harus masuk ke akun dengan izin yang memadai. Untuk informasi selengkapnya, lihat [Contoh kebijakan untuk Grafana yang Dikelola Amazon](security_iam_id-based-policy-examples.md#security_iam_AMG-id-based-policy-examples).

**Akun mandiri**

Akun mandiri adalah AWS akun yang bukan anggota organisasi di Organizations. Ini adalah skenario yang mungkin terjadi jika Anda mencoba AWS untuk pertama kalinya.

Dalam skenario ini, Grafana Terkelola Amazon secara otomatis mengaktifkan dan AWS IAM Identity Center Organizations saat Anda masuk ke akun yang memiliki kebijakan **AWSGrafanaAccountAdministrator**, **AWSSSOMemberAccountAdministrator**, dan **AWSSSODirectoryAdministrator**. Untuk informasi selengkapnya, lihat [Membuat dan mengelola ruang kerja Grafana yang Dikelola Amazon dan pengguna dalam satu akun mandiri menggunakan IAM Identity Center](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-create-workspace-standalone).

**Akun anggota dari organisasi yang ada di mana Pusat Identitas IAM sudah dikonfigurasi**

Untuk membuat ruang kerja di akun anggota, Anda harus masuk ke akun yang memiliki kebijakan **AWSGrafanaAccountAdministrator**AWSSSOMemberAccountAdministrator****, dan **AWSSSODirectoryAdministrator**. Untuk informasi selengkapnya, lihat [Administrator Grafana di akun anggota menggunakan IAM Identity Center](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-admin-member).

Jika Anda membuat ruang kerja di akun anggota dan ingin ruang kerja tersebut mengakses sumber daya dari AWS akun lain di organisasi, Anda harus menggunakan izin terkelola pelanggan di ruang kerja. Untuk informasi selengkapnya, lihat [Izin yang dikelola pelanggan](AMG-manage-permissions.md#AMG-customer-managed).

Untuk menggunakan izin yang dikelola layanan untuk memungkinkan ruang kerja mengakses sumber daya dari AWS akun lain di organisasi, Anda harus membuat ruang kerja di akun manajemen organisasi. Namun, bukan praktik terbaik untuk membuat ruang kerja Grafana yang Dikelola Amazon atau sumber daya lain di akun manajemen suatu organisasi. Untuk informasi selengkapnya tentang praktik terbaik Organizations, lihat [Praktik terbaik untuk akun manajemen](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_best-practices_mgmt-acct.html).

**catatan**  
Jika Anda mengaktifkan AWS IAM Identity Center akun manajemen sebelum 25 November 2019, Anda juga harus mengaktifkan aplikasi terintegrasi Pusat Identitas IAM di akun manajemen. Secara opsional, Anda juga dapat mengaktifkan aplikasi terintegrasi Pusat Identitas IAM di akun anggota setelah Anda melakukannya di akun manajemen. Untuk mengaktifkan aplikasi ini, pilih **Aktifkan akses** di halaman **Pengaturan** Pusat Identitas IAM di bagian aplikasi terintegrasi Pusat Identitas IAM. Untuk informasi selengkapnya, lihat Pengaktifan aplikasi [terintegrasi Pusat Identitas IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/app-enablement.html).

**Akun anggota dari organisasi yang ada di mana Pusat Identitas IAM belum digunakan**

Dalam skenario ini, masuk sebagai administrator organisasi terlebih dahulu, dan aktifkan Pusat Identitas IAM di organisasi. Kemudian, buat ruang kerja Grafana Terkelola Amazon di akun anggota di organisasi.

Jika Anda bukan administrator organisasi, Anda harus menghubungi administrator untuk Organizations dan meminta mereka mengaktifkan IAM Identity Center. Setelah Pusat Identitas IAM diaktifkan, Anda kemudian dapat membuat ruang kerja di akun anggota.

Jika Anda membuat ruang kerja di akun anggota dan ingin ruang kerja tersebut mengakses sumber daya dari AWS akun lain di organisasi, Anda harus menggunakan izin terkelola pelanggan di ruang kerja. Untuk informasi selengkapnya, lihat [Izin yang dikelola pelanggan](AMG-manage-permissions.md#AMG-customer-managed).

Untuk membuat ruang kerja di akun anggota, Anda harus masuk ke akun yang memiliki kebijakan **AWSGrafanaAccountAdministrator**AWSSSOMemberAccountAdministrator****, dan **AWSSSODirectoryAdministrator**. Lihat informasi yang lebih lengkap di [Administrator Grafana di akun anggota menggunakan IAM Identity Center](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-admin-member).

# Connect ke sumber data bawaan
<a name="AMG-data-sources-builtin"></a>

Sumber data berikut didukung di setiap ruang kerja Grafana Terkelola Amazon.

Untuk ruang kerja yang mendukung versi 9 dan yang lebih baru, beberapa sumber data ini mungkin tidak diinstal secara default. Sumber data inti tersedia di semua instalasi, tetapi sumber data yang bukan bagian dari kumpulan inti mungkin memerlukan plugin Grafana yang benar untuk diinstal. Anda dapat menginstal plugin untuk sumber data tambahan yang tidak tercantum di sini. Untuk informasi selengkapnya tentang mengelola plugin, lihat[Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

**Topics**
+ [Pengelola Peringatan](data-source-alertmanager.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [OpenSearch Layanan Amazon](using-Amazon-OpenSearch-in-AMG.md)
+ [AWS IoT SiteWise](using-iotsitewise-in-AMG.md)
+ [AWS IoT TwinMaker](AMG-iot-twinmaker.md)
+ [Prometheus](prometheus-data-source.md)
+ [Amazon Timestream](timestream-datasource.md)
+ [Amazon Athena](AWS-Athena.md)
+ [Amazon Redshift](AWS-Redshift.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Monitor Azure](using-azure-monitor-in-AMG.md)
+ [Grafit](using-graphite-in-AMG.md)
+ [Pemantauan Google Cloud](using-google-cloud-monitoring-in-grafana.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Jaeger](jaeger-data-source.md)
+ [Loki](using-loki-in-AMG.md)
+ [Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [MySQL](using-mysql-in-AMG.md)
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [OpenTSDB](using-opentsdb-in-AMG.md)
+ [PostgreSQL](using-postgresql-in-AMG.md)
+ [Templ](tempo-data-source.md)
+ [TestData](testdata-data-source.md)
+ [Zipkin](zipkin-data-source.md)

# Connect ke sumber data Alertmanager
<a name="data-source-alertmanager"></a>

Grafana menyertakan dukungan bawaan untuk Prometheus Alertmanager. Setelah peringatan Grafana dikonfigurasi, Anda dapat menggunakan UI peringatan Grafana untuk mengelola keheningan, titik kontak, serta kebijakan pemberitahuan. Opsi drop-down di halaman ini memungkinkan Anda untuk beralih antara Grafana dan sumber data Alertmanager yang dikonfigurasi.

**Implementasi Alertmanager**

[Implementasi Prometheus](https://prometheus.io/), [Cortex](https://cortexmetrics.io/), dan [Grafana](https://grafana.com/docs/mimir/latest/) Mimir dari Alertmanager didukung. Anda dapat menentukan implementasi di halaman pengaturan sumber data. Titik kontak Prometheus dan kebijakan notifikasi hanya-baca di UI peringatan Grafana, karena tidak mendukung pembaruan konfigurasi melalui HTTP API.

## Mengkonfigurasi sumber data Alertmanager
<a name="data-source-alertmanager-create"></a>

Anda dapat mengonfigurasi sumber data Alertmanager untuk digunakan dengan peringatan Grafana.

**Prasyarat**

Untuk mengkonfigurasi Alertmanager, Anda harus memiliki prasyarat berikut lengkap:
+ Instance Prometheus, dengan metrik yang dicerna, dan setidaknya satu aturan peringatan atau perekaman yang dikonfigurasi. Anda akan membutuhkan URL untuk ruang kerja Anda.
+ Izin yang ditetapkan untuk Grafana Terkelola Amazon agar memiliki akses baca ke lansiran, grup peringatan, keheningan, dan titik kontak dari implementasi Alertmanager Anda.

**Untuk mengonfigurasi sumber data Alertmanager**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**

1. Pilih **Tambahkan sumber data**, dan pilih **Alertmanager** dari daftar tipe sumber data.

1. Berikan informasi berikut untuk sumber data baru Anda.
   + Untuk **Nama**, berikan nama yang Anda pilih untuk sumber data Anda.
   + ****Untuk **Implementasi**, pilih implementasi Alertmanager Anda — baik Prometheus, Mimir, atau **Cortex**.****
   + Di bawah **HTTP**, untuk **URL**, berikan URL Alertmanager. Untuk Prometheus, ini adalah URL ruang kerja, dengan ditambahkan. `alertmanager` Misalnya, `https://myprometheus/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`.
   + Di bawah **Auth**, konfigurasikan detail otentikasi yang diperlukan untuk mengakses implementasi Alertmanager Anda.

1. Pilih **Simpan & uji** untuk menyelesaikan penyiapan sumber data Anda.

   Jika sumber data Anda diatur dengan benar, Anda akan melihat pesan yang mengatakan **Pemeriksaan Kesehatan lulus**.

# Connect ke sumber CloudWatch data Amazon
<a name="using-amazon-cloudwatch-in-AMG"></a>

Dengan Amazon Managed Grafana, Anda dapat menambahkan Amazon CloudWatch sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan CloudWatch sebagai sumber data dengan menemukan CloudWatch akun Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses. CloudWatch Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan CloudWatch sebagai sumber data. Atau, Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan pada server Grafana yang dikelola sendiri.

**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data](adding-CloudWatch-AWS-config.md)
+ [Tambahkan secara manual CloudWatch sebagai sumber data](adding--CloudWatch-manual.md)
+ [Menggunakan editor kueri](CloudWatch-using-the-query-editor.md)
+ [Dasbor yang dikuratori](CloudWatch-curated-dashboards.md)
+ [Kueri templat](cloudwatch-templated-queries.md)
+ [Menggunakan contoh ec2\$1instance\$1attribute](cloudwatch-ec2-instance-attribute-examples.md)
+ [Menggunakan variabel template format JSON](cloudwatch-using-json-format-template-variables.md)
+ [Harga](cloudwatch-pricing.md)
+ [Kuota layanan](cloudwatch-service-quotas.md)
+ [Observabilitas lintas akun](cloudwatch-cross-account.md)

# Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data
<a name="adding-CloudWatch-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca CloudWatch sumber daya di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan CloudWatch sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Pada panel navigasi, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. 

1. Pilih kotak centang untuk **Amazon**, CloudWatch lalu pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi. 

1. Pilih **Konfigurasi di Grafana** di baris **Amazon CloudWatch**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center, jika perlu.

1. **Pada bilah navigasi di konsol ruang kerja Grafana, pilih AWS ikon dan kemudian pilih AWS layanan,. **CloudWatch****

1. Pilih Wilayah default tempat Anda ingin sumber CloudWatch data kueri. 

1. Pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.

# Tambahkan secara manual CloudWatch sebagai sumber data
<a name="adding--CloudWatch-manual"></a>

**Untuk menambahkan sumber CloudWatch data secara manual**

1. **Di menu sisi konsol Grafana, arahkan kursor ke ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber **CloudWatch**data. Jika perlu, Anda dapat mulai mengetik **CloudWatch** di kotak pencarian untuk membantu Anda menemukannya.

## CloudWatch pengaturan
<a name="settings-CloudWatch"></a>

 CloudWatch Pengaturan berikut berlaku.


| Nama | Deskripsi | 
| --- | --- | 
|  `Name`  | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri. | 
|  `Default`  | Menentukan sumber data yang akan dipilih sebelumnya untuk panel baru. | 
|  `Default Region`  | Atur Wilayah di editor kueri. Dapat diubah berdasarkan per-query. | 
|  `Namespaces of Custom Metrics`  | Menentukan CloudWatch ruang nama metrik kustom. Dapat menyertakan beberapa ruang nama, dipisahkan dengan koma. | 
|  `Auth Provider`  | Menentukan penyedia untuk mendapatkan kredensional. | 
|  `Assume Role Arn`  | Menentukan Nama Sumber Daya Amazon (ARN) dari peran yang akan diasumsikan. | 
|  `External ID`  | (Opsional) Menentukan ID eksternal. Gunakan jika Anda mengambil peran dalam peran lain Akun AWS yang telah dibuat dengan ID eksternal. | 
| `Timeout` | Konfigurasikan batas waktu khusus untuk kueri CloudWatch Log. | 
| `X-Ray trace links` | Untuk menambahkan tautan secara otomatis di log Anda saat log berisi `@xrayTraceId` bidang, tautkan sumber data X-Ray di bagian **tautan jejak X-Ray** pada konfigurasi sumber data. Anda harus sudah memiliki [sumber data X-Ray](x-ray-data-source.md) yang dikonfigurasi. | 

### Autentikasi
<a name="CloudWatch-authentication"></a>

Untuk mengaktifkan autentikasi antara Grafana Terkelola Amazon CloudWatch dan, Anda dapat menggunakan konsol Grafana Terkelola Amazon untuk membuat kebijakan dan izin yang diperlukan dengan cepat. Atau, Anda dapat mengatur otentikasi secara manual menggunakan beberapa metode yang sama seperti yang Anda lakukan di server Grafana yang dikelola sendiri.

Untuk menggunakan konfigurasi sumber data Grafana yang Dikelola Amazon untuk menyiapkan kebijakan dengan cepat, ikuti langkah-langkahnya. [Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data](adding-CloudWatch-AWS-config.md)

Untuk mengatur izin secara manual, gunakan salah satu metode di bagian berikut.

#### AWS kredensi
<a name="CloudWatch-authentication-aws-credentials"></a>

Ada tiga metode otentikasi berbeda yang tersedia. 
+ **AWS SDK Default** — Menggunakan izin yang ditentukan dalam peran yang dilampirkan ke ruang kerja Anda. Untuk informasi selengkapnya, lihat [Izin yang dikelola pelanggan](AMG-manage-permissions.md#AMG-customer-managed). 
+ **Akses dan kunci rahasia** — Sesuai dengan AWS SDK untuk Go `StaticProvider`. Menggunakan ID kunci akses yang diberikan dan kunci rahasia untuk mengautentikasi. Metode ini tidak memiliki fallback, dan akan gagal jika key pair yang disediakan tidak berfungsi.

#### Peran IAM
<a name="CloudWatch-authentication-iam-roles"></a>

 Saat ini, semua akses CloudWatch dilakukan di sisi server oleh backend Grafana menggunakan SDK resmi. AWS Jika Anda memilih metode otentikasi *Default AWS SDK*, dan server Grafana Anda sedang berjalan AWS, Anda dapat menggunakan peran IAM untuk menangani autentikasi secara otomatis.

 Untuk informasi selengkapnya, lihat [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html).

#### Kebijakan IAM
<a name="CloudWatch-authentication-iam-policies"></a>

Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca CloudWatch metrik dan tag EC2, instance, dan Wilayah. Anda dapat melampirkan izin ini ke peran IAM dan menggunakan dukungan Grafana bawaan untuk mengasumsikan peran. 

 Contoh kode berikut menunjukkan kebijakan minimal. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowReadingMetricsFromCloudWatch",
            "Effect": "Allow",
            "Action": [
                "cloudwatch:DescribeAlarmsForMetric",
                "cloudwatch:DescribeAlarmHistory",
                "cloudwatch:DescribeAlarms",
                "cloudwatch:ListMetrics",
                "cloudwatch:GetMetricStatistics",
                "cloudwatch:GetMetricData",
                "cloudwatch:GetInsightRuleReport"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AllowReadingLogsFromCloudWatch",
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogGroups",
                "logs:GetLogGroupFields",
                "logs:StartQuery",
                "logs:StopQuery",
                "logs:GetQueryResults",
                "logs:GetLogEvents"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AllowReadingTagsInstancesRegionsFromEC2",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeTags",
                "ec2:DescribeInstances",
                "ec2:DescribeRegions"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AllowReadingResourcesForTags",
            "Effect": "Allow",
            "Action": "tag:GetResources",
            "Resource": "*"
        },
        {
            "Sid": "AllowReadingAcrossAccounts",
            "Effect": "Allow",
            "Action": [
                "oam:ListSinks",
                "oam:ListAttachedLinks"
            ],
            "Resource": "*"
        }
    ]
}
```

------

#### Dengan asumsi peran
<a name="CloudWatch-assuming-a-role"></a>

 `Assume Role ARN`Bidang ini memungkinkan Anda menentukan peran IAM mana yang akan diasumsikan, jika ada. Jika Anda mengosongkan ini, kredensi yang disediakan akan digunakan secara langsung dan peran atau pengguna terkait harus memiliki izin yang diperlukan. Jika bidang ini tidak kosong, kredensi yang disediakan digunakan untuk melakukan panggilan. `sts:AssumeRole` 

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

Sumber CloudWatch data di Amazon Managed Grafana menyediakan editor kueri canggih yang memungkinkan Anda mengambil dan menganalisis metrik dan log dari berbagai AWS layanan yang mengirim data ke. CloudWatch Editor kueri mendukung dua mode kueri yang berbeda: Pencarian Metrik dan CloudWatch Log.

Mode editor kueri untuk metrik menggunakan CloudWatch API untuk menemukan metrik yang diunggah. CloudWatch Mode untuk log menggunakan CloudWatch Log APIs untuk menemukan catatan log. Setiap mode memiliki editor kueri khusus sendiri. Anda memilih API mana yang ingin Anda kueri dengan menggunakan sakelar mode kueri di bagian atas editor.

**Topics**
+ [Menggunakan editor kueri metrik](CloudWatch-using-the-metric-query-editor.md)
+ [Menggunakan editor kueri Amazon CloudWatch Logs](CloudWatch-using-the-logs-query-editor.md)

# Menggunakan editor kueri metrik
<a name="CloudWatch-using-the-metric-query-editor"></a>

Editor kueri metrik memungkinkan Anda membuat dua jenis kueri - **Pencarian Metrik** dan **Kueri Metrik**. Opsi **Kueri Metrik** menanyakan data menggunakan Wawasan CloudWatch Metrik.

## Bidang editor kueri umum
<a name="metrics-insights-common-fields"></a>

 Ada tiga bidang yang umum untuk mode **Pencarian Metrik** dan **Kueri Metrik**.

 **Bidang umum**

**Id**  
`GetMetricData`API mengharuskan semua kueri memiliki ID unik. Gunakan bidang ini untuk menentukan ID pilihan. ID dapat mencakup angka, huruf, dan garis bawah, dan harus dimulai dengan huruf kecil. Jika tidak ada ID yang ditentukan, Grafana Terkelola Amazon menghasilkan ID menggunakan pola berikut:. `query[refId of the current query row]` Misalnya, `queryA` mewakili baris kueri pertama di editor panel.

**Periode**  
Periode adalah lamanya waktu yang terkait dengan CloudWatch statistik tertentu. Periode didefinisikan dalam jumlah detik. Nilai yang valid termasuk 1, 5, 10, 30, atau kelipatan 60. Jika Anda membiarkan kolom periode kosong atau disetel ke`auto`, maka akan dihitung secara otomatis berdasarkan rentang waktu dan kebijakan CloudWatch penyimpanan. Rumus yang digunakan adalah`time range in seconds / 2000`, dan kemudian beralih ke nilai berikutnya yang lebih tinggi dalam array periode yang telah ditentukan [60, 300, 900, 3600, 21600, 86400] setelah menghapus periode berdasarkan retensi. Untuk melihat periode yang digunakan Grafana Terkelola Amazon, pilih **Tampilkan Pratinjau Kueri** di editor kueri.

**Alias**  
Pola alias berikut berlaku.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html)

# Menggunakan opsi pencarian metrik
<a name="CloudWatch-using-the-metric-search"></a>

 Untuk membuat kueri yang valid di **Pencarian Metrik**, Anda harus menentukan namespace, nama metrik, dan setidaknya satu statistik. Jika **Match Exact** diaktifkan, Anda juga harus menentukan semua dimensi metrik yang Anda kueri. Skema metrik harus sama persis. Untuk informasi selengkapnya, lihat [sintaks ekspresi CloudWatch pencarian](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html).

Jika **Match Exact** dimatikan, Anda dapat menentukan sejumlah dimensi yang ingin Anda filter. Hingga 100 metrik yang cocok dengan kriteria filter Anda dikembalikan. 

## Kueri dinamis menggunakan karakter wildcard dimensi
<a name="dynamic-queries-using-dimension-wildcards"></a>

 Anda dapat memantau daftar metrik dinamis dengan menggunakan karakter wildcard asterisk (`*`) untuk satu atau beberapa nilai dimensi. 

 Ini membantu Anda memantau metrik untuk AWS sumber daya, seperti instans EC2 atau container. Misalnya, ketika instance baru dibuat sebagai bagian dari peristiwa penskalaan otomatis, instance tersebut akan muncul secara otomatis di grafik tanpa Anda harus melacak instance baru. IDs Kemampuan ini saat ini terbatas untuk mengambil hingga 100 metrik. Anda dapat memilih **Tampilkan Pratinjau Kueri** untuk melihat ekspresi pencarian yang dibuat secara otomatis untuk mendukung karakter wildcard. 

 Secara default, ekspresi penelusuran didefinisikan sedemikian rupa sehingga metrik yang ditanyakan harus sama persis dengan nama dimensi yang ditentukan. Ini berarti bahwa dalam contoh hanya metrik dengan tepat satu dimensi dengan nama `InstanceId` yang dikembalikan. 

 Untuk menyertakan metrik yang memiliki dimensi lain yang ditentukan, Anda dapat menonaktifkan **Match Exact**. Mematikan **Match Exact** juga membuat ekspresi penelusuran meskipun Anda tidak menggunakan karakter wildcard. Grafana mencari metrik apa pun yang cocok setidaknya dengan namespace, nama metrik, dan semua dimensi yang ditentukan. 

## Variabel template multi-nilai
<a name="cloudwatch-multi-value-template-variables"></a>

 Saat menentukan nilai dimensi berdasarkan variabel template multi-nilai, ekspresi penelusuran digunakan untuk menanyakan metrik yang cocok. Hal ini memungkinkan penggunaan beberapa variabel template dalam satu query. Anda juga dapat menggunakan variabel template untuk kueri yang memiliki opsi **Match Exact** dimatikan. 

 Ekspresi penelusuran saat ini dibatasi hingga 1024 karakter, sehingga kueri Anda mungkin gagal jika Anda memiliki daftar nilai yang panjang. Jika Anda ingin menanyakan semua metrik yang memiliki nilai apa pun untuk nama dimensi tertentu, sebaiknya gunakan karakter wildcard asterisk (`*`) alih-alih opsi. `All` 

 Penggunaan variabel template multi-nilai hanya didukung untuk nilai dimensi. Menggunakan variabel template multi-nilai untuk`Region`,`Namespace`, atau `Metric Name` tidak didukung. 

## Ekspresi matematika metrik
<a name="cloudwatch-metric-math-expressions"></a>

 Anda dapat membuat metrik deret waktu baru dengan beroperasi di atas CloudWatch metrik menggunakan fungsi matematika. Operator aritmatika, pengurangan unary, dan fungsi lainnya didukung dan dapat diterapkan pada metrik. CloudWatch Untuk informasi selengkapnya tentang fungsi matematika CloudWatch metrik, lihat [Menggunakan matematika metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html). 

 Sebagai contoh, untuk menerapkan operasi aritmatika pada metrik, berikan ID (string unik) ke metrik mentah. Anda kemudian dapat menggunakan ID ini dan menerapkan operasi aritmatika padanya di `Expression` bidang metrik baru. 

 Jika Anda menggunakan `Expression` bidang untuk mereferensikan kueri lain`queryA * 2`, misalnya, Anda tidak dapat membuat aturan peringatan berdasarkan kueri tersebut. 

## Periode
<a name="cloudwatch-period"></a>

 Periode adalah lamanya waktu yang terkait dengan CloudWatch statistik Amazon tertentu. Periode didefinisikan dalam jumlah detik. Nilai yang valid termasuk 1, 5, 10, 30, atau kelipatan 60. 

Jika Anda membiarkan bidang periode kosong atau disetel ke **auto**, maka itu menghitung secara otomatis berdasarkan rentang waktu. Rumus yang digunakan adalah`time range in seconds / 2000`, dan kemudian beralih ke nilai berikutnya yang lebih tinggi dalam array periode `[60, 300, 900, 3600, 21600, 86400]` yang telah ditentukan. Untuk melihat periode yang digunakan Grafana Terkelola Amazon, pilih **Tampilkan Pratinjau Kueri** di editor kueri. 

## Tautan dalam dari panel Grafana ke konsol CloudWatch
<a name="deep-linking-from-grafana-panels-to-the-cloudwatch-console"></a>

 Memilih deret waktu di panel menunjukkan menu konteks dengan tautan ke **Lihat di CloudWatch konsol**. Memilih tautan itu membuka tab baru yang membawa Anda ke CloudWatch konsol dan menampilkan semua metrik untuk kueri itu. Jika saat ini Anda belum masuk ke CloudWatch konsol, tautan akan meneruskan Anda ke halaman login. Tautan yang disediakan valid untuk semua Akun AWS tetapi hanya menampilkan metrik yang benar jika Anda masuk ke Akun AWS yang sesuai dengan sumber data yang dipilih di Grafana. 

 Fitur ini tidak tersedia untuk metrik yang didasarkan pada ekspresi matematika metrik. 

# Menggunakan opsi kueri metrik untuk menanyakan data Wawasan CloudWatch Metrik
<a name="CloudWatch-using-the-metric-query"></a>

**catatan**  
Amazon CloudWatch Metrics Insights sedang dalam pratinjau. CloudWatch Fitur Wawasan Metrik terbuka untuk semua. Akun AWS Fitur dapat berubah sewaktu-waktu. 

 Anda dapat melakukan kueri data Wawasan CloudWatch Metrik dengan memilih `metric query` mode di Editor **kueri metrik**. 

 CloudWatch Metrics Insights adalah mesin kueri SQL berkinerja tinggi yang kuat yang dapat Anda gunakan untuk menanyakan metrik Anda dalam skala besar. Ini adalah mesin kueri berbasis SQL yang cepat, fleksibel, yang dapat Anda gunakan untuk mengidentifikasi tren dan pola dalam semua CloudWatch metrik Anda secara real time. Ini menggunakan dialek SQL. Untuk informasi selengkapnya tentang sintaks kueri Metrics Insights, lihat. [Sintaks kueri dan kata kunci](#metrics-insights-syntax-keywords)

## Sintaks kueri dan kata kunci
<a name="metrics-insights-syntax-keywords"></a>

CloudWatch Metrics Insights menggunakan dialek SQL. Contoh berikut menunjukkan sintaks query.

```
SELECT FUNCTION(metricName)
FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ]
     [ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ]
[ GROUP BY labelKey [, ...]]
[ ORDER BY FUNCTION() [DESC | ASC] ]
[ LIMIT number]
```

 Kata kunci tidak peka huruf besar/kecil, tetapi pengenalnya peka huruf besar/kecil. Pengidentifikasi mencakup nama metrik, ruang nama, dan dimensi. 

 Tabel berikut menyediakan kata kunci query dan deskripsi mereka.


|  Kata Kunci  |  Deskripsi  | 
| --- | --- | 
|  FUNCTION  |  Wajib. Menentukan fungsi agregat untuk digunakan, dan juga menentukan nama metrik untuk query. Nilai yang valid adalah AVG, COUNT, MAX, MIN, dan SUM.  | 
|  MetricName   |  Wajib. Misalnya, CPUUtilization.  | 
|  FROM  |  Wajib. Menentukan sumber metrik. Anda dapat menentukan namespace metrik yang berisi metrik untuk kueri, atau fungsi tabel SCHEMA. Beberapa contoh namespace adalah AWS/EC2 dan. AWS/Lambda  | 
|  SCHEMA  |  (Opsional) Memfilter hasil kueri untuk hanya menampilkan metrik yang sama persis, atau metrik yang tidak cocok.  | 
|  WHERE  |  (Opsional) Memfilter hasil untuk hanya menampilkan metrik yang cocok dengan ekspresi yang Anda tentukan. Misalnya, WHERE InstanceType \$1= 'c3.4xlarge'.  | 
|  GROUP BY  |  (Opsional) Kelompokkan hasil kueri menjadi beberapa deret waktu. Misalnya, GROUP BY ServiceName.  | 
|  ORDER BY  |  (Opsional) Menentukan urutan deret waktu untuk kembali. Pilihannya adalah ASC danDESC.  | 
|  LIMIT  |  (Opsional) Membatasi jumlah deret waktu untuk kembali.  | 

Berikut ini beberapa contohnya: 
+ 

  ```
  SELECT AVG(CPUUtilization) FROM "AWS/EC2" 
  ```

   Mencocokkan semua `CPUUtilization` metrik di `AWS/EC2` namespace, mengabaikan dimensinya, dan mengembalikan satu deret waktu gabungan. 
+ 

  ```
  SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")
  ```

   Hanya cocok dengan `CPUUtilization` metrik di `AWS/EC2` namespace yang tidak memiliki dimensi yang ditentukan.
+ 

  ```
  SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
  ```

   Hanya cocok dengan `CPUUtilization` metrik yang dilaporkan CloudWatch dengan tepat satu dimensi,`InstanceId`.
+ 

  ```
  SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
  AvailabilityZone)
  ```

   Mtches hanya `RequestCount` metrik yang dilaporkan CloudWatch dari `AWS/ApplicationELB` dengan tepat dua dimensi, `LoadBalancer` dan. `AvailabilityZone` 

 Nilai label harus dilampirkan oleh tanda kutip tunggal.

### Karakter melarikan diri
<a name="escape-characters"></a>

Dalam kueri, nilai label harus selalu dikurung dengan tanda kutip tunggal.   Misalnya, `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`. 

 Ruang nama metrik, nama metrik, dan kunci label yang berisi karakter selain huruf, angka, dan garis bawah (`_`) harus dikelilingi oleh tanda kutip ganda. Misalnya, `SELECT MAX("My.Metric")`. Jika salah satu dari ini berisi tanda kutip ganda itu sendiri (seperti`Bytes"Input"`), Anda harus menghindari tanda kutip ganda dengan garis miring terbalik, seperti pada. `SELECT AVG("Bytes\"Input\"")` Jika namespace metrik, nama metrik, atau kunci label, berisi kata yang merupakan kata kunci cadangan dalam Metrics Insights, ini juga harus diapit dalam tanda kutip ganda. Sebagai contoh, jika Anda memiliki metrik yang disebut `LIMIT`, Anda akan menggunakan `SELECT AVG("LIMIT")`. Ini juga benar untuk mengapit namespace, nama metrik, atau label dalam tanda kutip ganda bahkan jika itu tidak menyertakan kata kunci yang dicadangkan. 

## Mode pembangun dan mode kode
<a name="metrics-insights-query-modes"></a>

Anda dapat membuat kueri dalam `Builder` mode atau `Code` mode.

**Untuk membuat kueri dalam `Builder` mode**

1. Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel sebelumnya.

1. Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.

**Untuk membuat kueri dalam `Code` mode**

1. Tulis kueri Anda di editor kode.

1. Untuk menjalankan kueri, pilih **Jalankan kueri** di editor kode.

Untuk membuat kueri dalam `builder` mode:
+ Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel di atas.
+ Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.

Grafana secara otomatis membuat kueri SQL berdasarkan pilihan Anda.

 Untuk membuat kueri dalam `code` mode:
+ Tulis kueri Anda di editor kode.
+ Untuk menjalankan kueri, pilih **kueri Jalankan** pada editor kode.

Editor kode memiliki fitur pelengkapan otomatis bawaan yang memberikan saran untuk kata kunci, agregasi, ruang nama, metrik, label, dan nilai label. Saran ditampilkan saat Anda memasukkan tanda spasi, koma, atau dolar. Anda juga dapat menggunakan kombinasi keyboard`CTRL+Space`.

Editor kode dapat melengkapi kueri secara otomatis. Namun, penggunaan variabel template dalam editor kode dapat mengganggu pelengkapan otomatis.

## CloudWatch Contoh Wawasan Metrik
<a name="goldeneye-examples"></a>

**catatan**  
CloudWatch Wawasan Metrik ada dalam pratinjau terbuka. Pratinjau terbuka untuk semua AWS akun dan Anda tidak perlu meminta akses. Fitur dapat ditambahkan atau diubah sebelum mengumumkan Ketersediaan Umum. 

Bagian ini berisi contoh kueri Wawasan CloudWatch Metrik yang berguna yang dapat Anda salin dan gunakan secara langsung atau salin dan modifikasi di editor kueri. Beberapa contoh ini sudah tersedia di konsol, dan Anda dapat mengaksesnya dengan memilih **Tambahkan kueri** di tampilan **Metrik**. 

### Contoh EC2
<a name="goldeneye-EC2-examples"></a>

 Lihat pemanfaatan CPU per metrik instans

```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
```

Lihat rata-rata pemanfaatan CPU di seluruh armada

```
SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
```

 Lihat 10 instans dengan pemanfaatan CPU rata-rata tertinggi 

```
SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
```

Lihat 10 instans dengan pemanfaatan CPU tertinggi, diurutkan berdasarkan maksimum, dalam urutan menurun

```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10
```

Dalam hal ini, CloudWatch agen mengumpulkan CPUUtilization metrik per aplikasi. Kueri ini menyaring rata-rata metrik ini untuk nama aplikasi tertentu.

```
SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"
```

Lihat waktu eksekusi rata-rata untuk 10 fungsi Lambda teratas, diurutkan berdasarkan maksimum, dalam urutan menurun

```
SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10
```

Lihat maksimum, rata-rata, dan minimum waktu eksekusi Lambda

```
SELECT MAX(Duration)
FROM "AWS/Lambda"
```

### Contoh Penyeimbang Beban Aplikasi
<a name="application-loadbalancer-examples"></a>

 Lihat metrik yang memiliki dimensi **LoadBalancer**dan **AvailabilityZone**

```
SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
```

Lihat metrik dengan jumlah koneksi TCP bersamaan yang aktif

```
SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"
```

### Contoh Amazon EBS
<a name="Amazon-elastic-block-store-examples"></a>

 Lihat 10 byte tulis rata-rata per volume teratas dalam urutan menurun

```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10
```

Lihat rata-rata waktu tulis volume Amazon EBS

```
SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"
```

Lihat rata-rata waktu idle volume Amazon EBS

```
SELECT AVG(VolumeIdleTime)
FROM "AWS/EBS"
View average burst balance per volume
SELECT AVG(BurstBalance)
FROM "AWS/EBS"
GROUP BY VolumeId
View average read bytes across Amazon EBS volumes
SELECT AVG(VolumeReadBytes)
FROM "AWS/EBS"
```

Lihat rata-rata byte tulis di seluruh volume Amazon EBS

```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
```

### Contoh Amazon Simple Storage Service
<a name="simple-storage-service-examples"></a>

 Lihat grup latensi rata-rata berdasarkan nama bucket

```
SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName
```

Lihat rata-rata jumlah objek per ember di semua bucket Amazon S3

```
SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
```

### Contoh Amazon Simple Notification Service
<a name="Amazon-simple-notificaation-service-examples"></a>

A mazon-simple-notificaation-service -contoh 

```
SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"
```

Melihat rata-rata jumlah pesan yang gagal untuk setiap nama topik

```
SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName
```

### AWS Contoh penggunaan API
<a name="AWS-API-usage-examples"></a>

Lihat 20 teratas AWS APIs dengan jumlah panggilan di akun Anda 

```
SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20
```

## CloudWatch Batas Wawasan Metrik
<a name="metrics-insights-limits"></a>

CloudWatch Metrics Insights saat ini memiliki batasan berikut: 
+ Anda hanya dapat menanyakan tiga jam data terbaru.
+ Satu kueri dapat memproses tidak lebih dari 10.000 metrik. Ini berarti bahwa jika `WHERE` klausa `SELECT``FROM`,, dan cocok dengan lebih dari 10.000 metrik, hanya 10.000 metrik pertama yang ditemukan yang akan diproses oleh kueri.
+ Satu kueri dapat mengembalikan tidak lebih dari 500 deret waktu. Ini berarti bahwa jika kueri memproses lebih dari 500 metrik, tidak semua metrik akan dikembalikan dalam hasil kueri. Jika Anda menggunakan `ORDER BY` klausa, maka semua metrik yang sedang diproses akan diurutkan dan 500 yang memiliki nilai tertinggi atau terendah sesuai dengan `ORDER BY` klausa Anda akan dikembalikan. Jika Anda tidak menyertakan `ORDER BY` klausa, Anda tidak dapat mengontrol 500 metrik pencocokan mana yang dikembalikan. 
+ Setiap `GetMetricData` operasi hanya dapat memiliki satu kueri, tetapi Anda dapat memiliki beberapa widget di dasbor yang masing-masing menyertakan kueri. 

# Menggunakan editor kueri Amazon CloudWatch Logs
<a name="CloudWatch-using-the-logs-query-editor"></a>

 Untuk menanyakan CloudWatch Log, pilih Wilayah dan hingga 20 grup log yang ingin Anda kueri. Gunakan area input utama untuk menulis kueri Anda. Untuk informasi selengkapnya, lihat [sintaks kueri Wawasan CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). 

 Anda juga dapat menulis kueri yang mengembalikan data deret waktu dengan menggunakan `stats` perintah di Wawasan CloudWatch Log. Saat membuat `stats` kueri di Jelajahi, Anda harus memastikan bahwa Anda berada dalam mode Jelajahi Metrik. 

 Di sebelah kanan bidang input kueri terdapat tautan Wawasan CloudWatch Log yang membuka konsol Wawasan CloudWatch Log dengan kueri Anda. Anda dapat melanjutkan eksplorasi di sana jika perlu. 

## Menggunakan variabel template
<a name="cloudwatch-using-template-variables"></a>

 Seperti beberapa sumber data lainnya, sumber CloudWatch data mendukung penggunaan variabel template dalam kueri. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md). 

## Penautan dalam dari panel Grafana ke CloudWatch konsol Log
<a name="deep-linking-from-grafana-panels-to-the-cloudwatch-console-2"></a>

 Jika Anda ingin melihat kueri di konsol Wawasan CloudWatch Log, pilih tombol **Wawasan CloudWatch Log** di sebelah editor kueri. Jika saat ini Anda belum masuk ke CloudWatch konsol, tautan akan meneruskan Anda ke halaman login. Tautan yang disediakan valid untuk semua Akun AWS tetapi hanya menampilkan metrik yang benar jika Anda masuk ke Akun AWS yang sesuai dengan sumber data yang dipilih di Grafana. 

## Peringatan
<a name="cloudwatch-alerting"></a>

 Karena kueri CloudWatch Log dapat mengembalikan data numerik, misalnya, melalui penggunaan `stats` perintah, peringatan didukung. Lihat informasi yang lebih lengkap di [Grafana memperingatkan](alerts-overview.md). 

# Dasbor yang dikuratori
<a name="CloudWatch-curated-dashboards"></a>

 Sumber CloudWatch data yang diperbarui dikirimkan dengan dasbor pra-konfigurasi untuk lima layanan paling populer AWS : 
+  Amazon EC2 
+  Amazon Elastic Block Store 
+  AWS Lambda 
+  CloudWatch Log Amazon 
+  Amazon Relational Database Service 

 Untuk mengimpor dasbor yang telah dikonfigurasi sebelumnya, buka halaman konfigurasi sumber CloudWatch data Anda dan pilih tab **Dasbor**. Pilih **Impor** untuk dasbor yang ingin Anda gunakan. Untuk menyesuaikan dasbor, sebaiknya simpan dasbor dengan nama yang berbeda, karena jika tidak, dasbor akan ditimpa saat versi baru dasbor dirilis. 

# Kueri templat
<a name="cloudwatch-templated-queries"></a>

 Alih-alih hardcoding detail 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. 

 Lihat [Template](templates-and-variables.md#templates) untuk pengantar fitur templating dan berbagai jenis variabel template. 

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

 Sumber CloudWatch data menyediakan kueri berikut yang dapat Anda tentukan di bidang **Kueri** di tampilan Edit **variabel**. Anda dapat menggunakan ini untuk mengisi daftar opsi variabel dengan hal-hal seperti`region`,`namespaces`,`metric names`, dan`dimension keys/values`. 

 Sebagai gantinya`region`, Anda dapat menentukan `default` untuk menggunakan Wilayah default yang dikonfigurasi dalam sumber data untuk kueri. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  regions()  |  Mengembalikan daftar semua AWS Wilayah. | 
|  namespaces()  |  Mengembalikan daftar namespace yang CloudWatch mendukung.  | 
|  metrics(namespace, [region])  |  Mengembalikan daftar metrik di namespace. (Tentukan Wilayah atau gunakan "default" untuk metrik khusus.)  | 
|  dimension\$1keys(namespace)  |  Mengembalikan daftar kunci dimensi di namespace.  | 
|  dimension\$1values(region, namespace, metric, dimension\$1key, [filters])  |  Mengembalikan daftar nilai dimensi yang cocok dengan yang ditentukanregion,namespace,metric, ataudimension\$1key. secara ternatif, Anda dapat menggunakan dimensi filters untuk mendapatkan hasil yang lebih spesifik.  | 
|  ebs\$1volume\$1ids(region, instance\$1id)  |  Mengembalikan daftar volume IDs yang cocok dengan yang ditentukanregion,instance\$1id.  | 
|  ec2\$1instance\$1attribute(region, attribute\$1name, filters)  |  Mengembalikan daftar atribut yang cocok dengan yang ditentukanregion,attribute\$1name,filters.  | 
|  resource\$1arns(region, resource\$1type, tags)  |  Mengembalikan daftar ARNs pencocokan yang ditentukanregion,resource\$1type, dantags.  | 
|  statistics()  |  Mengembalikan daftar semua statistik standar.  | 

 Untuk detail tentang metrik yang CloudWatch disediakan, lihat [AWS layanan yang mempublikasikan CloudWatch metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html). 

### Contoh kueri template
<a name="cloudwatch-examples-templated-queries"></a>

 Tabel berikut menunjukkan contoh kueri dimensi yang mengembalikan daftar sumber daya untuk AWS layanan individual. 


|  Kueri  |  Layanan  | 
| --- | --- | 
|  dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName)  |  Elastic Load Balancing  | 
|  dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId)  |  Amazon ElastiCache  | 
|  dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier)  |  Amazon Redshift  | 
|  dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier)  |  Amazon RDS  | 
|  dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName)  |  Amazon Simple Storage Service (Amazon S3)  | 
|  dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1)  |  CloudWatch Agen  | 
|  resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Elastic Load Balancing  | 
|  resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1)  |  Amazon EC2  | 

# Menggunakan contoh ec2\$1instance\$1attribute
<a name="cloudwatch-ec2-instance-attribute-examples"></a>

## Filter JSON
<a name="json-filters"></a>

 `ec2_instance_attribute`Kueri mengambil `filters` dalam format JSON. Anda dapat menentukan filter yang telah ditentukan sebelumnya dari. `ec2:DescribeInstances` Perhatikan bahwa penyaringan sebenarnya terjadi di AWS, bukan di Grafana. 

 Contoh kode berikut menunjukkan sintaks filter. 

```
{ filter_name1: [ filter_value1 ], filter_name2: [ filter_value2 ] }
```

 Contoh berikut menunjukkan `ec2_instance_attribute()` query. 

```
ec2_instance_attribute(us - east - 1, InstanceId, { 'tag:Environment': ['production'] });
```

## Memilih atribut
<a name="cloudwatch-selecting-attributes"></a>

 Hanya satu atribut per instance yang dapat dikembalikan. Setiap atribut datar dapat dipilih (yaitu, jika atribut memiliki nilai tunggal dan bukan objek atau array). Atribut datar berikut tersedia. 
+  `AmiLaunchIndex` 
+  `Architecture` 
+  `ClientToken` 
+  `EbsOptimized` 
+  `EnaSupport` 
+  `Hypervisor` 
+  `IamInstanceProfile` 
+  `ImageId` 
+  `InstanceId` 
+  `InstanceLifecycle` 
+  `InstanceType` 
+  `KernelId` 
+  `KeyName` 
+  `LaunchTime` 
+  `Platform` 
+  `PrivateDnsName` 
+  `PrivateIpAddress` 
+  `PublicDnsName` 
+  `PublicIpAddress` 
+  `RamdiskId` 
+  `RootDeviceName` 
+  `RootDeviceType` 
+  `SourceDestCheck` 
+  `SpotInstanceRequestId` 
+  `SriovNetSupport` 
+  `SubnetId` 
+  `VirtualizationType` 
+  `VpcId` 

 Tag dapat dipilih dengan awalan nama tag dengan`Tags`. 

 Contoh berikut menunjukkan `ec2_instance_attribute()` query. 

```
ec2_instance_attribute(us - east - 1, Tags.Name, { 'tag:Team': ['sysops'] });
```

# Menggunakan variabel template format JSON
<a name="cloudwatch-using-json-format-template-variables"></a>

 Beberapa kueri menerima filter dalam format JSON dan Grafana mendukung konversi variabel template ke JSON. 

 Jika`env = 'production', 'staging'`, kueri berikut akan mengembalikan ARN dari instans EC2 yang `Environment` tag tersebut atau. `production` `staging` 

```
resource_arns(us-east-1, ec2:instance, {"Environment":${env:json}})
```

# Harga
<a name="cloudwatch-pricing"></a>

 Sumber CloudWatch data Amazon untuk Grafana menggunakan panggilan `GetMetricData` CloudWatch API `ListMetrics` dan untuk membuat daftar dan mengambil metrik. Harga untuk CloudWatch Log didasarkan pada jumlah data yang dicerna, diarsipkan, dan dianalisis melalui kueri Wawasan CloudWatch Log. Untuk informasi selengkapnya, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing). 

 Setiap kali Anda memilih dimensi di editor kueri, Grafana mengeluarkan permintaan. `ListMetrics` Setiap kali Anda mengubah kueri di editor kueri, satu permintaan baru GetMetricData akan dikeluarkan. 

 Permintaan API untuk mengambil sampel data menggunakan `GetMetricData` operasi. Operasi ini memberikan dukungan yang lebih baik untuk matematika CloudWatch metrik. Ini juga mendukung pembuatan ekspresi pencarian otomatis saat menggunakan karakter wildcard atau mematikan opsi **Match Exact**. `GetMetricData`Operasi menimbulkan biaya. Untuk informasi lebih lanjut, lihat [Amazon CloudWatch Harga](https://aws.amazon.com/cloudwatch/pricing).

# Kuota layanan
<a name="cloudwatch-service-quotas"></a>

 AWS mendefinisikan kuota, atau batas, untuk sumber daya, operasi, dan item di akun Anda AWS . Bergantung pada jumlah kueri di dasbor Anda dan jumlah pengguna yang mengakses dasbor, Anda mungkin mencapai batas penggunaan untuk berbagai CloudWatch sumber daya CloudWatch Log. Perhatikan bahwa kuota ditentukan per akun dan per AWS Wilayah. Jika Anda menggunakan beberapa Wilayah atau telah menyiapkan lebih dari satu sumber CloudWatch data untuk melakukan kueri terhadap beberapa akun, Anda harus meminta peningkatan kuota untuk setiap akun dan setiap Wilayah tempat Anda mencapai batas. 

 Untuk informasi selengkapnya, lihat [ CloudWatch service quotas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html). 

# Observabilitas lintas akun
<a name="cloudwatch-cross-account"></a>

**Awas**  
Fitur ini mengharuskan ruang kerja Grafana Anda menjadi versi 9 atau yang lebih baru.

 CloudWatch Plugin ini memungkinkan Anda untuk memantau dan memecahkan masalah aplikasi di beberapa akun regional. Menggunakan observabilitas lintas akun, Anda dapat dengan mulus mencari, memvisualisasikan, dan menganalisis metrik dan log tanpa mengkhawatirkan batasan akun.

Untuk mengaktifkan observabilitas lintas akun, pertama-tama aktifkan CloudWatch, lalu tambahkan tindakan IAM yang tepat ke plugin yang role/user sedang berjalan. Jika ruang kerja Grafana Terkelola Amazon Anda berjalan dalam VPC, maka Anda juga harus memiliki gateway NAT untuk mendukung akses internet.
+ Untuk mempelajari cara mengaktifkan fitur, lihat [observabilitas CloudWatch lintas akun](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) di * CloudWatchPanduan Pengguna Amazon*.
+ Tindakan berikut adalah tindakan IAM yang tepat untuk ditambahkan untuk role/user yang menjalankan plugin.

  ```
  {
  "Sid":  "AllowReadingAcrossAccounts",
  "Effect":  "Allow",
  "Action": [
    "oam:ListSinks",
    "oam:ListAttachedLinks"
  ],
  "Resource":  "*"
  }
  ```
+ Pengamatan lintas akun untuk sumber CloudWatch data bergantung pada Amazon CloudWatch Observability Access Manager. Pengelola Akses Observabilitas tidak mendukung titik akhir VPC. Jika ruang kerja Grafana Terkelola Amazon Anda berjalan dalam VPC, maka Anda juga harus memiliki NAT Gateway yang memungkinkan ruang kerja untuk menelepon di internet. APIs 

**catatan**  
Anda juga harus memiliki izin IAM untuk membaca CloudWatch data di akun yang Anda coba akses.

# Connect ke sumber data Amazon OpenSearch Service
<a name="using-Amazon-OpenSearch-in-AMG"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

Dengan Amazon Managed Grafana, Anda dapat menambahkan OpenSearch Layanan Amazon sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Sumber data ini mendukung domain OpenSearch Layanan, yang menjalankan OpenSearch cluster serta kluster Elasticsearch lama.

Opsi konfigurasi sumber AWS data menyederhanakan penambahan OpenSearch Layanan sebagai sumber data dengan menemukan akun OpenSearch Layanan yang ada, dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses. OpenSearch Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan OpenSearch Layanan sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan pada server Grafana yang dikelola sendiri.

Sumber data OpenSearch Layanan mendukung bahasa pemrosesan pipa (PPL). Untuk informasi selengkapnya tentang PPL, lihat [Menanyakan data OpenSearch Layanan Amazon menggunakan Bahasa Pemrosesan Piped](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html). 

Anda dapat menggunakan sumber data OpenSearch Layanan untuk melakukan banyak jenis OpenSearch kueri sederhana atau kompleks untuk memvisualisasikan log atau metrik yang disimpan. OpenSearch Anda juga dapat membuat anotasi grafik Anda dengan peristiwa log yang disimpan di. OpenSearch 

**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data](ES-adding-AWS-config.md)
+ [Tambahkan OpenSearch Layanan Amazon secara manual sebagai sumber data](ES-adding-the-data-source.md)
+ [OpenSearch Pengaturan layanan](#ES-settings)
+ [Menggunakan sumber data Amazon OpenSearch Service](ES-use-datasource.md)
+ [OpenSearch Layanan Amazon Tanpa Server](datasources-opensearch-serverless.md)
+ [Dukungan jejak](datasources-opensearch-traces.md)

# Gunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data
<a name="ES-adding-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya OpenSearch Layanan di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan OpenSearch Layanan sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk ** OpenSearch Layanan Amazon**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana** di baris ** OpenSearch Layanan Amazon**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon lalu pilih layanan **AWS ,** Layanan Amazon. OpenSearch **

1. Pilih Wilayah yang ingin dicari Grafana Terkelola Amazon untuk menemukan sumber daya OpenSearch Layanan, lalu pilih akun dan domain OpenSearch Layanan yang ingin ditambahkan, konfigurasikan setelan indeks, lalu pilih **Tambahkan** sumber data.

# Tambahkan OpenSearch Layanan Amazon secara manual sebagai sumber data
<a name="ES-adding-the-data-source"></a>

**Untuk menambahkan sumber data OpenSearch Layanan Amazon secara manual**

1.  Di menu sisi konsol Grafana, pilih **AWS**ikon, lalu pilih Sumber **Data**.

1. Pilih sumber data ** OpenSearch Layanan Amazon**. Jika perlu, Anda dapat mulai mengetik **OpenSearch** di kotak pencarian untuk membantu Anda menemukannya.

1. Pilih **Wilayah** tempat Anda ingin mencari data.

1. Pilih **Tambahkan sumber data**.

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

## OpenSearch Pengaturan layanan
<a name="ES-settings"></a>


|  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  |  Titik akhir domain OpenSearch Layanan Anda. Titik akhir mengambil format berikut: https://search-my-domain.us-east-1.es.amazonaws.com. | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana. Browser = URL harus dapat diakses dari browser.  | 

 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)
<a name="ES-server-access-mode-default"></a>

 Semua permintaan dibuat dari browser ke backend atau server 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 backend atau server Grafana. 

### Akses browser (langsung)
<a name="ES-browser-direct-access"></a>

Grafana yang Dikelola Amazon tidak mendukung akses langsung browser.

### Pengaturan indeks
<a name="ES-index-settings"></a>

 Di sini Anda dapat menentukan default untuk `time field` dan menentukan nama OpenSearch indeks Anda. Anda dapat menggunakan pola waktu untuk nama indeks atau karakter wildcard. 

### OpenSearch/Versi Elasticsearch
<a name="OpenSearch-version"></a>

Tentukan versi Elasticsearch OpenSearch atau lama Anda di menu tarik-turun versi. Versi ini penting karena ada perbedaan dalam bagaimana kueri disusun untuk setiap versi. Saat ini, Grafana mendukung OpenSearch 1.0.x. Versi Elasticsearch yang didukung adalah`2.0+`,,`5.0+`, `5.6+``6.0+`, dan. `7.0+` Nilai `5.6+` berarti versi 5.6 atau lebih tinggi, tetapi lebih rendah dari 6.0. Nilai `6.0+` berarti versi 6.0 atau lebih tinggi, tetapi lebih rendah dari 7.0. Akhirnya, `7.0+` berarti versi 7.0 atau lebih tinggi, tetapi lebih rendah dari 8.0.

### Interval waktu min
<a name="ES-min-time-interval"></a>

Batas bawah untuk grup auto berdasarkan interval waktu. Disarankan untuk diatur untuk menulis frekuensi; misalnya, `1m` jika data Anda ditulis setiap menit. Opsi ini juga dapat berada overridden/configured di panel dasbor di bawah opsi sumber data. Nilai ini **harus** diformat sebagai angka diikuti oleh pengidentifikasi waktu yang valid; misalnya, `1m` (1 menit) atau `30s` (30 detik). Pengidentifikasi waktu berikut didukung. 


|  Pengidentifikasi  |  Deskripsi  | 
| --- | --- | 
|  y  |  Tahun  | 
|  M  |  Bulan  | 
|  w  |  Minggu  | 
|  d  |  Hari  | 
|  h  |  Jam  | 
|  m  |  Menit  | 
|  s  |  Detik  | 
|  ms  |  Milidetik  | 

### Beberapa catatan
<a name="ES-logs-beta"></a>

Dua parameter, `Message field name` dan`Level field name`, secara opsional dapat dikonfigurasi dari halaman pengaturan sumber data yang menentukan bidang mana yang akan digunakan untuk pesan log dan tingkat log saat memvisualisasikan log masuk. [Jelajahi](explore.md) 

 Misalnya, jika Anda menggunakan pengaturan default Filebeat untuk mengirimkan log ke OpenSearch Layanan, konfigurasi berikut akan berfungsi. 
+  **Nama bidang pesan:** pesan 
+  **Nama bidang level:** fields.level 

### Tautan data
<a name="ES-data-links"></a>

 Tautan data membuat tautan dari bidang tertentu yang dapat diakses dalam tampilan log di Jelajahi. 

 Setiap konfigurasi tautan data terdiri dari yang berikut:
+ **Bidang** - Nama bidang yang digunakan oleh tautan data.
+ **URL/query** - Jika link eksternal, maka masukkan URL link lengkap. Jika tautannya adalah tautan internal, maka input ini berfungsi sebagai kueri untuk sumber data target. Dalam kedua kasus, Anda dapat menginterpolasi nilai dari bidang dengan `${__value.raw }` makro. 
+ **Tautan internal** — Pilih ini jika tautannya internal atau eksternal. Jika tautannya internal, pemilih sumber data memungkinkan Anda memilih sumber data target. Hanya melacak sumber data yang didukung.

# Menggunakan sumber data Amazon OpenSearch Service
<a name="ES-use-datasource"></a>

## Editor kueri metrik
<a name="ES-metric-query-editor"></a>

Editor OpenSearch kueri memungkinkan Anda memilih beberapa metrik dan mengelompokkan berdasarkan beberapa istilah atau filter. Gunakan ikon plus dan minus di sebelah kanan add/remove metrik atau kelompokkan berdasarkan klausa. Beberapa metrik dan grup berdasarkan klausa memiliki opsi. Pilih teks opsi untuk memperluas baris\$1 untuk melihat dan mengedit metrik atau grup berdasarkan opsi. 

## Menggunakan Piped Processing Language (PPL)
<a name="ES-PPL"></a>

Sumber data Amazon OpenSearch Service mendukung Piped Processing Language (PPL), yang memungkinkan kemampuan kueri dan visualisasi yang lebih sederhana namun kuat. OpenSearch PPL memungkinkan pelanggan untuk mengeksplorasi dan menemukan data tanpa harus menulis pernyataan OpenSearch Domain Specific Language (DSL) yang panjang atau menulis kueri menggunakan objek JSON. Dengan PPL, Anda dapat menulis kueri sebagai satu set perintah yang dibatasi oleh pipa yang mirip dengan pipa UNIX.

Ambil contoh kueri DSL berikut sebagai contoh:

```
GET opensearch_sample_data_logs/_search{"from":0,"size":0,"timeout":"1m","query":{"bool":{"should":[{"term":{"response.keyword":{"value":"404","boost":1}}},{"term":{"response.keyword":{"value":"503","boost":1}}}],"adjust_pure_negative":true,"boost":1}},"sort":[{"_doc":{"order":"asc"}}],"aggregations":{"composite_buckets":{"composite":{"size":1000,"sources":[{"host":{"terms":{"field":"host.keyword","missing_bucket":true,"order":"asc"}}},{"response":{"terms":{"field":"response.keyword","missing_bucket":true,"order":"asc"}}}]},"aggregations":{"request_count":{"value_count":{"field":"request.keyword"}},"sales_bucket_sort":{"bucket_sort":{"sort":[{"request_count":{"order":"desc"}}],"size":10}}}}}}>
```

Kueri DSL sebelumnya dapat diganti dengan perintah PPL berikut yang ringkas dan dapat dibaca manusia.

```
source = opensearch_sample_data_logs | where response='404' or response='503' | stats count(request) as request_count by host, response | sort –request_count
```

Untuk informasi selengkapnya tentang PPL, lihat [Menanyakan data OpenSearch Layanan Amazon menggunakan Bahasa Pemrosesan Piped](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html).

## Penamaan seri dan pola alias
<a name="ES-series-naming-and-alias-patterns"></a>

 Anda dapat mengontrol nama untuk deret waktu menggunakan bidang `Alias` input. 


|  Pola  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1term fieldname\$1\$1  |  Diganti dengan nilai istilah Group By.  | 
|  \$1\$1metric\$1\$1  |  Diganti dengan nama metrik (mis. Rata-rata, Min, Maks). | 
|  \$1\$1field\$1\$1  |  Diganti dengan nama bidang metrik. | 

## Metrik saluran pipa
<a name="ES-pipeline-metrics"></a>

*Beberapa agregasi metrik disebut agregasi pipa; misalnya, *Moving* Average dan Derivative.* OpenSearch metrik pipeline memerlukan metrik lain untuk didasarkan. Gunakan ikon mata di sebelah metrik untuk menyembunyikan metrik agar tidak muncul di grafik. Ini berguna untuk metrik yang hanya Anda miliki dalam kueri untuk digunakan dalam metrik pipeline. 

## Templating
<a name="ES-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="ES-query-variable"></a>

 Sumber data OpenSearch Layanan mendukung dua jenis kueri yang dapat Anda gunakan di bidang *Query* variabel *Query*. Kueri ditulis menggunakan string JSON kustom. 


|  Kueri  |  Deskripsi  | 
| --- | --- | 
|  \$1"find": "fields", "type": "keyword"\$1  |  Mengembalikan daftar nama bidang dengan jenis indekskeyword.  | 
|  \$1"find": "terms", "field": "@hostname", "size": 1000\$1  |  Mengembalikan daftar nilai untuk bidang menggunakan istilah agregasi. Kueri akan menggunakan rentang waktu dasbor saat ini sebagai rentang waktu untuk kueri.  | 
|  \$1"find": "terms", "field": "@hostname", "query": '<lucene query>'\$1  |  Mengembalikan daftar nilai untuk bidang menggunakan agregasi istilah dan filter kueri Lucene tertentu. Kueri akan menggunakan rentang waktu dasbor saat ini sebagai rentang waktu untuk kueri.  | 

Ada batas ukuran default 500 pada kueri istilah. Untuk menetapkan batas kustom, tetapkan properti size dalam kueri Anda. Anda dapat menggunakan variabel lain di dalam kueri. Contoh kode berikut menunjukkan definisi query untuk variabel bernama`$host`. 

```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```

Pada contoh sebelumnya, kita menggunakan variabel lain bernama `$source` di dalam definisi query. Setiap kali Anda mengubah, menggunakan daftar dropdown, nilai `$source` variabel saat ini, itu memulai pembaruan variabel. `$host` Setelah pembaruan, `$host` variabel hanya berisi nama host yang difilter oleh dalam hal ini properti `@source` dokumen. 

Kueri ini secara default mengembalikan hasil dalam urutan istilah (yang kemudian dapat diurutkan menurut abjad atau numerik untuk variabel apa pun). Untuk menghasilkan daftar istilah yang diurutkan berdasarkan jumlah dokumen (daftar nilai TOP-N), tambahkan `orderBy` properti dari. `doc_count` Ini secara otomatis memilih jenis menurun. Menggunakan `asc` with doc\$1count (daftar bawah N) dapat dilakukan dengan menyetel`order: "asc"`, tetapi tidak disarankan karena meningkatkan kesalahan pada jumlah dokumen. **Untuk menjaga istilah dalam urutan jumlah dokumen, setel daftar dropdown **Sort** variabel ke Dinonaktifkan.** Atau, Anda mungkin masih ingin menggunakan **Alphabetical** untuk mengurutkan ulang mereka. 

```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```

### Menggunakan variabel dalam kueri
<a name="ES-using-variables-in-queries"></a>

 Ada dua sintaks: 
+  `$<varname>`Contoh: @hostname: \$1hostname 
+  `[[varname]]`Contoh: @hostname: [[hostname]] 

 Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis, tetapi tidak memungkinkan Anda untuk menggunakan variabel di tengah kata. Saat opsi *Multi-nilai* atau *Sertakan semua nilai* diaktifkan, Grafana mengubah label dari teks biasa menjadi kondisi yang kompatibel dengan Lucene. 

 Pada contoh sebelumnya, kita memiliki kueri lucene yang memfilter dokumen berdasarkan `@hostname` properti menggunakan variabel bernama. `$hostname` Hal ini juga menggunakan variabel dalam *Terms* group by field input box. Ini memungkinkan Anda untuk menggunakan variabel untuk dengan cepat mengubah cara data dikelompokkan. 

## Anotasi
<a name="ES-annotations"></a>

Anotasi memungkinkan Anda untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi menggunakan menu Dasbor atau tampilan Anotasi. Grafana dapat menanyakan OpenSearch indeks apa pun untuk peristiwa anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md). 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Query  |  Anda dapat menyimpan kueri penelusuran kosong atau menentukan kueri Lucene.  | 
|  Time  |  Nama bidang waktu; harus bidang tanggal.  | 
|  Time End  |  Nama opsional bidang akhir waktu harus berupa bidang tanggal. Jika disetel, anotasi akan ditandai sebagai wilayah antara waktu dan akhir waktu.  | 
|  Text  |  Bidang deskripsi acara.  | 
|  Tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa (dapat berupa array atau string CSV).  | 

## Meminta log
<a name="ES-querying-logs-beta"></a>

 Menanyakan dan menampilkan data log dari OpenSearch tersedia di Jelajahi. Untuk menampilkan log Anda, pilih sumber data OpenSearch Layanan, lalu masukkan kueri Lucene secara opsional. Untuk informasi selengkapnya, lihat [Jelajahi](explore.md). 

### Kueri log
<a name="ES-log-queries"></a>

 Setelah hasilnya dikembalikan, panel log menunjukkan daftar baris log dan bagan batang di mana sumbu x menunjukkan waktu dan sumbu y menunjukkan frekuensi atau hitungan. 

### Memfilter pesan log
<a name="ES-filter-log-messages"></a>

 Secara opsional, masukkan kueri Lucene ke bidang kueri untuk memfilter pesan log. Misalnya, menggunakan pengaturan Filebeat default, Anda harus dapat menggunakan `fields.level:error` hanya menampilkan pesan log kesalahan. 

# OpenSearch Layanan Amazon Tanpa Server
<a name="datasources-opensearch-serverless"></a>

**catatan**  
OpenSearch Dukungan Layanan Tanpa Server hanya tersedia dengan ruang kerja Grafana yang menjalankan Grafana versi 9.4 dan yang lebih baru.

Anda dapat menggunakan sumber data OpenSearch Layanan untuk mengakses data Tanpa Server OpenSearch Layanan Amazon dengan Grafana Terkelola Amazon. Akses ke data dikendalikan oleh kebijakan akses data. Contoh berikut menunjukkan kebijakan yang memungkinkan pengguna melakukan kueri koleksi dan indeks tertentu. Pastikan untuk mengganti*`collection_name`*,*`index_name`*, dan *`principal_arn`* dengan nilai yang benar untuk kasus penggunaan Anda.

```
[
  {
    "Rules": [
      {
        "Resource": ["collection/{collection_name}"],
        "Permission": ["aoss:DescribeCollectionItems"],
        "ResourceType": "collection"
      },
      {
        "Resource": ["index/{collection_name}/{index_name}"],
        "Permission": ["aoss:DescribeIndex", "aoss:ReadDocument"],
        "ResourceType": "index"
      }
    ],
    "Principal": ["principal_arn"],
    "Description": "read-access"
  }
]
```

# Dukungan jejak
<a name="datasources-opensearch-traces"></a>

 OpenSearch Plugin ini memiliki dukungan untuk melihat daftar jejak dalam bentuk tabel, dan satu **jejak di Trace View**, yang menunjukkan garis waktu rentang jejak.

**catatan**  
 OpenSearch Jejak kueri hanya tersedia menggunakan kueri Lucene.  
Dukungan pelacakan hanya tersedia untuk ruang kerja Grafana yang mendukung versi 9.4 atau yang lebih baru.

Untuk membuat kueri yang menampilkan semua jejak, gunakan tipe kueri Lucene `Traces` dengan kueri kosong. Jika perlu, pilih jenis visualisasi **Tabel**.

Memilih ID jejak dalam tabel akan membuka jejak itu dalam tampilan jejak.

Untuk membuat kueri yang menampilkan jejak tunggal, gunakan kueri`traceid: {traceId}`, dan, jika perlu, pilih jenis visualisasi **Jejak**.

# Connect ke sumber AWS IoT SiteWise data
<a name="using-iotsitewise-in-AMG"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

 Dengan Amazon Managed Grafana, Anda dapat menambahkan AWS IoT SiteWise sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan AWS IoT SiteWise sebagai sumber data dengan menemukan AWS IoT SiteWise akun Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses. AWS IoT SiteWise Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan AWS IoT SiteWise sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan pada server Grafana yang dikelola sendiri.

**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise sebagai sumber data](IoTSiteWise-adding-AWS-config.md)
+ [Menambahkan sumber AWS IoT SiteWise data secara manual](iotsitewise-add-the-data-source.md)
+ [AWS IoT SiteWise pengaturan](#iotsitewise-settings)
+ [Menggunakan sumber AWS IoT SiteWise data](IoTSiteWise-using.md)

# Gunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise sebagai sumber data
<a name="IoTSiteWise-adding-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca AWS IoT SiteWise sumber daya di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan AWS IoT SiteWise sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk **AWS IoT SiteWise**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. **Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** IoT AWS . SiteWise**

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon lalu pilih layanan **AWS ,** IoT. SiteWise**

1. Pilih Wilayah default tempat Anda ingin sumber AWS IoT SiteWise data kueri, pilih akun, lalu pilih **Tambahkan sumber data**.

# Menambahkan sumber AWS IoT SiteWise data secara manual
<a name="iotsitewise-add-the-data-source"></a>

**Untuk menambahkan sumber AWS IoT SiteWise data secara manual**

1.  **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber SiteWise data **AWS IoT**. Jika perlu, Anda dapat mulai mengetik **SiteWise** di kotak pencarian untuk membantu Anda menemukannya.

## AWS IoT SiteWise pengaturan
<a name="iotsitewise-settings"></a>


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Nama  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri.  | 
|  Penyedia Auth  |  Tentukan penyedia untuk mendapatkan kredensional.  | 
|  Wilayah Default  |  Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan).  | 
|  Nama profil kredensial  |  Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file); tetap kosong untuk default.  | 
|  Asumsikan Peran Arn  |  Tentukan ARN dari peran yang akan diasumsikan.  | 
|  Titik akhir (opsional)  |  Jika Anda harus menentukan titik akhir layanan alternatif.  | 

# Menggunakan sumber AWS IoT SiteWise data
<a name="IoTSiteWise-using"></a>

Untuk informasi tentang cara menggunakan sumber AWS IoT SiteWise data, lihat Sumber data di [AWS IoT SiteWise Github.](https://github.com/grafana/iot-sitewise-datasource/blob/main/src/README.md)

# Connect ke sumber AWS IoT TwinMaker data
<a name="AMG-iot-twinmaker"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

 Dengan Amazon Managed Grafana, Anda dapat menambahkan AWS IoT TwinMaker, layanan analisis data industri yang canggih, sebagai aplikasi dan sumber data di ruang kerja Grafana Anda. Dengan AWS IoT TwinMaker, Anda dapat membuat aplikasi kembar digital 3D pengguna akhir untuk memantau operasi industri. Ini AWS IoT TwinMaker adalah layanan yang membuatnya lebih cepat bagi pengembang untuk membuat replika digital sistem dunia nyata, membantu lebih banyak pelanggan menyadari potensi kembar digital untuk mengoptimalkan operasi. The AWS IoT TwinMaker for Grafana menyediakan panel khusus, templat dasbor, dan sumber data untuk terhubung ke data kembar digital Anda. 

# Menambahkan sumber AWS IoT TwinMaker data secara manual
<a name="twinmaker-add-the-data-source"></a>

## Prasyarat
<a name="twinmaker-prerequisites"></a>

Sebelum Anda mulai, pastikan Anda memiliki akses **AWS IoT TwinMaker**dari Anda Akun AWS.

 Untuk mempelajari cara menambahkan izin ke peran IAM ruang kerja Anda untuk diakses AWS IoT TwinMaker, lihat. [Menambahkan izin AWS IoT TwinMaker untuk peran pengguna ruang kerja Anda](AMG-iot-twinmaker.md#twinmaker-add-permission)

**Untuk menambahkan sumber AWS IoT TwinMaker data:**

1. Pastikan bahwa peran pengguna Anda adalah admin atau editor.

1.  **Di menu sisi konsol Grafana, arahkan kursor ke ikon **Konfigurasi** (roda gigi) lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber **AWS IoT TwinMaker**data. Jika perlu, Anda dapat mulai mengetik **TwinMaker** di kotak pencarian untuk membantu Anda menemukannya.

1. Ini membuka halaman **Detail Koneksi**. Ikuti langkah-langkah dalam mengonfigurasi file. [AWS IoT TwinMaker pengaturan detail koneksi](AMG-iot-twinmaker.md#twinmaker-connection-details) 

## Menambahkan izin AWS IoT TwinMaker untuk peran pengguna ruang kerja Anda
<a name="twinmaker-add-permission"></a>

**Untuk menambahkan izin AWS IoT TwinMaker ke peran pengguna ruang kerja Anda, gunakan izin peran antara ruang kerja Grafana Terkelola Amazon dan peran dasbor. TwinMaker**

1. Kunjungi [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 

1. Buat peran dasbor secara manual. Untuk informasi selengkapnya tentang membuat peran dasbor, lihat[Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual](#iot-twinmaker-dashboard-role).

## AWS IoT TwinMaker pengaturan detail koneksi
<a name="twinmaker-connection-details"></a>

**Konfigurasikan pengaturan detail koneksi**

1.  Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**). 

1.  Pilih **Wilayah Default** yang ingin Anda kueri. 

1.  Dalam **TwinMaker pengaturan**, masukkan nama AWS IoT TwinMaker ruang kerja.

# Menggunakan sumber AWS IoT TwinMaker data
<a name="IoT-twinmaker-using"></a>

Untuk informasi tentang cara menggunakan sumber AWS IoT TwinMaker data, lihat Sumber [AWS IoT TwinMakerdata di.](https://github.com/grafana/grafana-iot-twinmaker-app) GitHub

## Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual
<a name="iot-twinmaker-dashboard-role"></a>

**Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual**

1. Masuk ke konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Temukan peran ruang kerja Grafana Terkelola Amazon Anda dalam ringkasan. Tampaknya sebagai berikut:

   ```
    AmazonGrafanaServiceRole-random_ID
   ```

1. Tambahkan kebijakan inline berikut ke peran:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": {
           "Effect": "Allow",
           "Action": "sts:AssumeRole",
           "Resource": "arn:aws:iam::111122223333:role/TwinMakerDashboardRole"
       }
   }
   ```

------

1. Tambahkan kebijakan inline baru untuk setiap peran dasbor. Atau, tambahkan daftar peran Amazon Resource Names (ARNs) pada baris **Resource**.

1. Temukan peran dasbor Anda di konsol IAM. Itu harus memiliki `SceneViewer` kebijakan dan, secara opsional, `VideoPlayer` kebijakan.

1. Pilih tab **Hubungan kepercayaan**.

1. Pilih **Edit trust relationship** (Edit Hubungan Kepercayaan).

1. Masukkan kebijakan berikut, ganti *AMGWorkspaceRoleArn* dengan Arn dari akun Anda:

------
#### [ JSON ]

****  

   ```
      {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "AWS": "AMGWorkspaceRoleARN"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

## Contoh AWS IoT TwinMaker kebijakan
<a name="AMG-TM-policy"></a>

Berikut ini adalah AWS IoT TwinMaker kebijakan minimal yang dapat Anda lampirkan ke peran dasbor. Anda harus mengganti nilai untuk ARN dan ID AWS IoT TwinMaker ruang kerja, serta ARN bucket Amazon S3, berdasarkan sumber daya Anda sendiri.

# Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka
<a name="prometheus-data-source"></a>

 Di Grafana Terkelola Amazon, sumber data Prometheus mendukung penggunaan server Prometheus yang dikelola sendiri dan Layanan Terkelola Amazon untuk ruang kerja Prometheus sebagai sumber data. Untuk informasi selengkapnya tentang Layanan Terkelola Amazon untuk Prometheus, lihat [Apa itu Layanan Terkelola Amazon](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html) untuk Prometheus?

 Dengan Grafana Terkelola Amazon, Anda dapat menambahkan Layanan Terkelola Amazon untuk ruang kerja Prometheus sebagai sumber data dengan menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Fitur ini menyederhanakan penambahan Amazon Managed Service untuk Prometheus sebagai sumber data dengan menemukan Amazon Managed Service yang ada untuk akun Prometheus dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses Amazon Managed Service untuk Prometheus.

**catatan**  
Anda dapat melihat peringatan Prometheus Anda di antarmuka peringatan Grafana terpadu, oleh. [Mengkonfigurasi sumber data Alertmanager](data-source-alertmanager.md#data-source-alertmanager-create)

**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus sebagai sumber data](AMP-adding-AWS-config.md)
+ [Menambahkan sumber data Prometheus secara manual](prometheus-manually-adding.md)
+ [Menggunakan sumber data Prometheus](using-prometheus-datasource.md)
+ [Visualisasikan peringatan dari Amazon Managed Service untuk Prometheus](amp-configure-alerts.md)
+ [Konfigurasikan contoh](amp-configure-exemplars.md)

# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus sebagai sumber data
<a name="AMP-adding-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya Layanan Terkelola Amazon untuk Prometheus di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Amazon Managed Service for Prometheus sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md).

1. Pilih tab **Sumber data**. **Kemudian pilih kotak centang untuk **Amazon Managed Service for Prometheus**, dan **pilih** Tindakan, Aktifkan kebijakan yang dikelola layanan.**

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di** baris **Amazon Managed Service for Prometheus**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. ****Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon dan kemudian pilih AWS layanan, Prometheus.****

1. **Pilih Wilayah yang ingin dicari Grafana Terkelola Amazon untuk menemukan Layanan Terkelola Amazon untuk ruang kerja Prometheus, lalu pilih akun dan Layanan Terkelola Amazon untuk ruang kerja Prometheus yang ingin Anda tambahkan, lalu pilih Tambahkan sumber data.**

# Menambahkan sumber data Prometheus secara manual
<a name="prometheus-manually-adding"></a>

**Untuk menambahkan sumber data Prometheus secara manual**

1.  **Di menu sisi konsol Grafana, jeda pada item menu **Administrasi** (atau ikon **Konfigurasi** (roda gigi) di Grafana v8), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber data **Prometheus**. Jika perlu, Anda dapat mulai mengetik **Prometheus** di kotak pencarian untuk membantu Anda menemukannya.

# Menggunakan sumber data Prometheus
<a name="using-prometheus-datasource"></a>

## Pengaturan Prometheus
<a name="prometheus-settings"></a>


|  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  |  URL server Prometheus Anda; misalnya,. https://prometheus.example.org:9090  | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana.  | 
|  Basic Auth  |  Aktifkan otentikasi dasar ke sumber data Prometheus.  | 
|  User  |  Nama pengguna untuk otentikasi dasar.  | 
|  Password  |  Kata sandi untuk otentikasi dasar.  | 
|  Scrape interval  |  Setel ini ke interval gesekan dan evaluasi khas yang dikonfigurasi di Prometheus. Default ke 15 detik.  | 
|  Disable metrics lookup  |  Memeriksa opsi ini akan menonaktifkan pemilih metrik dan metric/label dukungan di pelengkapan otomatis bidang kueri. Ini membantu jika Anda memiliki masalah kinerja dengan instance Prometheus yang lebih besar.  | 
|  Custom Query Parameters  |  Tambahkan parameter khusus ke URL kueri Prometheus. Misalnyatimeout,partial\$1response,dedup, ataumax\$1source\$1resolution. Beberapa parameter harus digabungkan bersama dengan “&”.  | 

## Editor kueri Prometheus
<a name="prometheus-query-editor"></a>

 Bagian berikut memberikan informasi dan opsi untuk editor kueri Prometheus di dasbor dan di Jelajahi. 

### Editor kueri di dasbor
<a name="query-editor-in-dashboards"></a>

 Buka grafik dalam mode edit dengan memilih judul dan kemudian memilih **Edit** (atau dengan menekan tombol **e** sambil berhenti di panel). 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Query expression  |  [Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.](https://prometheus.io/docs/querying/basics/)  | 
|  Legend format  |  Mengontrol nama deret waktu, menggunakan nama atau pola. Misalnya \$1\$1hostname\$1\$1 diganti dengan nilai label untuk labelhostname.  | 
|  Min step  |  Batas bawah tambahan untuk [`step`parameter kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) dan untuk variabel dan. \$1\$1\$1interval \$1\$1\$1rate\$1interval Batasnya mutlak dan tidak dimodifikasi oleh pengaturan Resolusi.  | 
|  Resolution  |  1/1menetapkan \$1\$1\$1interval variabel dan [`step`parameter kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) sedemikian rupa sehingga setiap piksel sesuai dengan satu titik data. Untuk kinerja yang lebih baik, gunakan resolusi yang lebih rendah. 1/2hanya mengambil titik data untuk setiap piksel lainnya, dan 1/10 mengambil satu titik data per 10 piksel. Perhatikan bahwa interval waktu Min dan langkah Min membatasi nilai akhir \$1\$1\$1interval danstep.  | 
|  Metric lookup  |  Cari nama metrik di kolom input ini.  | 
|  Format as  |  Beralih antaraTable,Time series, atauHeatmap. Tablehanya berfungsi di panel tabel. Heatmapcocok untuk menampilkan metrik tipe histogram pada panel peta panas. Ini mengubah histogram kumulatif menjadi histogram biasa dan mengurutkan seri dengan terikat ember.  | 
|  Instant  |  Lakukan kueri “instan”, untuk mengembalikan hanya nilai terbaru yang telah dikikis Prometheus untuk deret waktu yang diminta. Kueri instan mengembalikan hasil jauh lebih cepat daripada kueri rentang normal. Gunakan mereka untuk mencari set label.  | 
|  Min time interval  |  [Nilai ini dikalikan dengan penyebut dari pengaturan *Resolusi* menetapkan batas bawah untuk `$__interval` variabel dan parameter `step` kueri rentang Prometheus.](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) Default untuk Scrape interval seperti yang diatur dalam opsi sumber data.  | 

**catatan**  
 Grafana Terkelola Amazon memodifikasi tanggal permintaan kueri untuk menyelaraskannya dengan langkah yang dihitung secara dinamis. Ini memastikan tampilan data metrik yang konsisten, tetapi dapat menghasilkan celah kecil data di tepi kanan grafik. 

#### Kueri instan di dasbor
<a name="prometheus-instant-queries-in-dashboards"></a>

 Sumber data Prometheus memungkinkan Anda menjalankan kueri instan, yang hanya menanyakan nilai terbaru. Anda dapat memvisualisasikan hasil dalam panel tabel untuk melihat semua label yang tersedia dari deret waktu.

 Hasil kueri instan hanya terdiri dari satu titik data per seri. Mereka dapat ditampilkan di panel grafik dengan bantuan penggantian seri. Untuk menunjukkannya dalam grafik sebagai titik nilai terbaru, tambahkan penggantian seri dan pilih`Points > true`. Untuk menampilkan garis horizontal di seluruh grafik, tambahkan penggantian seri dan pilih `Transform > constant` Untuk informasi selengkapnya tentang penggantian seri, lihat. [Penggantian seri](graph-panel.md#graph-panel-series-overrides) 

### Editor kueri di Jelajahi
<a name="p-query-editor-in-explore"></a>


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Query expression  |  [Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.](https://prometheus.io/docs/querying/basics/)  | 
|  Step  |  [`Step`parameter dari kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries). Satuan waktu dapat digunakan di sini, misalnya: 5s, 1m, 3h, 1d, 1y. Unit default jika tidak ada unit yang ditentukan adalah s (detik).  | 
|  Query type  |  Range, Instant, atau Both. Saat menjalankan kueri Rentang, hasil kueri ditampilkan dalam grafik dan tabel. Kueri instan hanya mengembalikan nilai terbaru yang Prometheus telah tergores untuk deret waktu yang diminta dan ditampilkan dalam tabel. Ketika Keduanya dipilih, kueri instan dan kueri rentang dijalankan. Hasil kueri rentang ditampilkan dalam grafik dan hasil kueri instan ditampilkan dalam tabel.  | 

## Browser metrik
<a name="prometheus-metrics-browser"></a>

Browser metrik memungkinkan Anda menemukan metrik dengan cepat dan memilih label yang relevan untuk membuat kueri dasar. Saat Anda membuka browser, Anda akan melihat semua metrik dan label yang tersedia. Jika didukung oleh instance Prometheus Anda, setiap metrik akan menampilkan HELP dan TYPE sebagai tooltip.

Saat Anda memilih metrik, browser mempersempit label yang tersedia untuk hanya menampilkan label yang berlaku untuk metrik. Anda kemudian dapat memilih satu atau beberapa label yang nilai label yang tersedia ditampilkan dalam daftar di bagian bawah. Pilih satu atau beberapa nilai untuk setiap label untuk memperketat cakupan kueri Anda.

**catatan**  
Jika Anda tidak ingat nama metrik untuk memulai, Anda juga dapat memilih beberapa label terlebih dahulu, untuk mempersempit daftar dan kemudian menemukan nilai label yang relevan. 

Semua daftar di browser metrik memiliki bidang pencarian di atasnya untuk dengan cepat memfilter metrik atau label yang cocok dengan string tertentu. Bagian nilai hanya memiliki satu bidang pencarian. Pemfilterannya berlaku untuk semua label untuk membantu Anda menemukan nilai di seluruh label setelah dipilih, misalnya, di antara aplikasi label Anda, job, job\$1name hanya satu yang mungkin dengan nilai yang Anda cari.

Setelah Anda puas dengan kueri Anda, klik “Gunakan kueri” untuk menjalankan kueri. Tombol **Use as rate query** menambahkan rate (...) [\$1\$1\$1interval] di sekitar kueri Anda untuk membantu menulis kueri untuk metrik penghitung. Tombol “Validasi pemilih” akan memeriksa dengan Prometheus berapa banyak deret waktu yang tersedia untuk pemilih itu.

### Batasan
<a name="metrics-browser-limitations"></a>

Browser metrik memiliki batas keras 10.000 label (kunci) dan 50.000 nilai label (termasuk nama metrik). Jika instance Prometheus Anda mengembalikan lebih banyak hasil, browser akan terus berfungsi. Namun, set hasil akan terpotong di atas batas maksimum tersebut.

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

 Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. 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="p-query-variable"></a>

 Variabel tipe *Query* memungkinkan Anda untuk query Prometheus untuk daftar metrik, label, atau nilai label. **Plugin sumber data Prometheus menyediakan fungsi-fungsi berikut yang dapat Anda gunakan di bidang input Query.** 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  label\$1names()  |  Mengembalikan daftar nama label.  | 
|  label\$1values(label)  |  Mengembalikan daftar nilai label untuk label dalam setiap metrik.  | 
|  label\$1values(metric, label)  |  Mengembalikan daftar nilai label untuk label dalam metrik tertentu.  | 
|  metrics(metric)  |  Mengembalikan daftar metrik yang cocok dengan metric regex tertentu.  | 
|  query\$1result(query)  |  Mengembalikan daftar Prometheus hasil query untuk. query  | 

 Untuk informasi tentang *nama metrik, nama* *label*, dan *nilai label*, lihat dokumentasi [Prometheus](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). 

#### Menggunakan variabel interval dan rentang
<a name="p-using-interval-and-range-variables"></a>

**catatan**  
 Support untuk`$__range`,`$__range_s`, dan hanya `$__range_ms` tersedia dari Grafana v5.3. 

 Anda dapat menggunakan beberapa variabel global dalam variabel kueri:`$__interval`,`$__interval_ms`,`$__range`,`$__range_s`, dan`$__range_ms`. Untuk informasi selengkapnya, lihat [Variabel global](variables-types.md#global-variables). Ini dapat nyaman digunakan dengan `query_result` fungsi ketika Anda harus memfilter kueri variabel karena `label_values` fungsi tidak mendukung kueri. 

 Untuk mendapatkan instance yang benar saat mengubah rentang waktu di dasbor, pastikan untuk mengatur `refresh` pemicu variabel menjadi`On Time Range Change`. 

Contoh kode berikut menunjukkan cara mengisi variabel dengan lima instance permintaan tersibuk berdasarkan QPS rata-rata selama rentang waktu yang ditunjukkan di dasbor. 

```
Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/
```

 Contoh kode berikut menunjukkan cara mengisi variabel dengan instance yang memiliki status tertentu selama rentang waktu yang ditunjukkan di dasbor, menggunakan. `$__range_s` 

```
Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Regex:
```

### Menggunakan `$__rate_interval` variabel
<a name="p-using-__rate_interval-variable"></a>

 `$__rate_interval`Variabel dimaksudkan untuk digunakan dalam fungsi laju. Ini didefinisikan sebagai maks (`$__interval`\$1 *Interval scrape*, 4 \$1 *Scrape interval*). *Interval scrape* adalah pengaturan langkah Min (AKA query\$1interval, pengaturan per kueri promQL), jika ada yang disetel, dan sebaliknya *interval Scrape* seperti yang diatur dalam sumber data Prometheus (tetapi mengabaikan pengaturan interval Min apa pun di panel, karena yang terakhir dimodifikasi oleh pengaturan resolusi). 

### Menggunakan variabel dalam kueri
<a name="p-using-variables-in-queries"></a>

 Ada dua sintaks: 
+  `$<varname>`Contoh: tingkat (http\$1requests\$1total \$1job=\$1"\$1job "\$1 [5m]) 
+  `[[varname]]`Contoh: rate (http\$1requests\$1total \$1job=\$1 "[[job]]"\$1 [5m]) 

 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 `=~` alih-alih`=`. 

## Anotasi
<a name="p-annotations"></a>

 Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi menggunakan menu Dasbor atau tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md). 

 Prometheus mendukung dua cara untuk menanyakan anotasi. 
+  Kueri metrik biasa 
+  Permintaan Prometheus untuk peringatan tertunda dan penembakan. Untuk informasi selengkapnya, lihat [Memeriksa peringatan selama runtime](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/#inspecting-alerts-during-runtime)). 

 Opsi langkah berguna untuk membatasi jumlah peristiwa yang dikembalikan dari kueri Anda. 

# Visualisasikan peringatan dari Amazon Managed Service untuk Prometheus
<a name="amp-configure-alerts"></a>

Anda dapat memvisualisasikan peringatan Amazon Managed Service untuk Prometheus atau Prometheus di Amazon Managed Grafana dengan mengonfigurasi sumber data Alertmanager untuk sumber data Prometheus yang sudah terhubung dengan Anda.

**Prasyarat**

Untuk mengonfigurasi Alertmanager untuk digunakan dengan Amazon Managed Service for Prometheus, Anda harus menyelesaikan prasyarat berikut:
+ [Layanan Terkelola Amazon untuk instans Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-onboard-create-workspace.html), dengan metrik tertelan, dan setidaknya satu peringatan atau aturan perekaman yang dikonfigurasi. **Anda akan memerlukan URL untuk ruang kerja Anda (dari detail ruang kerja Anda di Amazon Managed Service untuk Prometheus Anda dapat melihat URL Endpoint.** Ruang kerja URl adalah URL Endpoint tanpa `api/v1/remote_write` di akhir).
+ [Ruang kerja Grafana Terkelola Amazon yang [dibuat](AMG-create-workspace.md) dengan instance Prometheus yang dikonfigurasi sebagai sumber data.](prometheus-data-source.md)
+ Grafana yang Dikelola Amazon harus memiliki izin berikut untuk sumber daya Prometheus Anda. Anda harus menambahkannya ke kebijakan yang dikelola layanan atau yang dikelola pelanggan yang dijelaskan dalam. [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md)
  + `aps:ListRules`
  + `aps:ListAlertManagerSilences`
  + `aps:ListAlertManagerAlerts`
  + `aps:GetAlertManagerStatus`
  + `aps:ListAlertManagerAlertGroups`
  + `aps:PutAlertManagerSilences`
  + `aps:DeleteAlertManagerSilence`

**Untuk mengonfigurasi sumber data Alertmanager untuk digunakan dengan Amazon Managed Service for Prometheus**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**

1. Pilih **Tambahkan sumber data**, dan pilih **Alertmanager** dari daftar tipe sumber data.

1. Berikan informasi berikut untuk sumber data baru Anda.
   + Untuk **Implementasi**, pilih **Prometheus**.
   + Di bawah **HTTP**, untuk **URL**, berikan URL ruang kerja Prometheus, dengan ditambahkan. `alertmanager` Misalnya, `https://aps-workspaces.us-east1.amazonaws.com/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`.
   + Di bawah **Auth**, nyalakan **Sigv4auth**. Ini memberitahu Grafana untuk menggunakan [AWS otentikasi untuk permintaan](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
   + Di bawah **Detail Sigv4Auth**, untuk **Wilayah Default, berikan wilayah** instance Prometheus Anda, misalnya. `us-east-1`

1. Pilih **Simpan & uji** untuk menyelesaikan penyiapan sumber data Anda.

   Jika sumber data Anda diatur dengan benar, Anda akan melihat pesan yang mengatakan **Pemeriksaan Kesehatan berlalu**.

**Untuk menghubungkan sumber data Alertmanager baru Anda ke sumber data Prometheus**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**

1. Pilih Layanan Terkelola Amazon asli Anda untuk sumber data Prometheus dan aktifkan sakelar sakelar **Kelola peringatan melalui UI Peringatan**.

1. Pilih **Simpan & uji** untuk menyelesaikan konfigurasi sumber data Anda.

# Konfigurasikan contoh
<a name="amp-configure-exemplars"></a>

**catatan**  
Fitur ini membutuhkan Prometheus versi 2.26 atau yang lebih baru.  
Contoh tidak didukung di Amazon Managed Service untuk Prometheus.

Anda dapat menampilkan data contoh bersama metrik baik di Explore maupun Dashboards. Contoh mengaitkan metadata kardinalitas yang lebih tinggi dari peristiwa tertentu dengan data deret waktu tradisional.

Anda dapat mengonfigurasi contoh dalam pengaturan sumber data dengan menambahkan tautan ke contoh Anda. Anda dapat menggunakan makro di URL Anda. Misalnya, Anda dapat membuat URL seperti`https://example.com/${__value.raw}`.

# Connect ke sumber data Amazon Timestream
<a name="timestream-datasource"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

 Dengan Grafana Terkelola Amazon, Anda dapat menambahkan Amazon Timestream sebagai sumber data dengan menggunakan opsi konfigurasi sumber data AWS di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Timestream sebagai sumber data dengan menemukan akun Timestream Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses Timestream. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Timestream sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama dengan yang Anda lakukan pada server Grafana yang dikelola sendiri.



# Gunakan konfigurasi sumber AWS data untuk menambahkan Timestream sebagai sumber data
<a name="Timestream-adding-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya Timestream di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Timestream sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Timestream sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk **Amazon Timestream**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di** baris **Amazon Timestream**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih **Aplikasi** lalu **Sumber AWS Data** (di Grafana v8, pilih AWS ikon dari menu kiri).

1. Pilih tab **AWS layanan**, lalu **Timestream**.

1. Pilih wilayah default yang Anda inginkan sumber data **Timestream** untuk kueri, pilih akun, lalu pilih **Tambahkan sumber data**.

# Menambahkan sumber data Timestream secara manual
<a name="timestream-add-the-data-source"></a>

**Untuk menambahkan sumber data Timestream secara manual**

1.  **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber data **Amazon Timestream**. Jika perlu, Anda dapat mulai mengetik **Timestream** di kotak pencarian untuk membantu Anda menemukannya.

## Pengaturan Timestream
<a name="timestream-settings"></a>


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Nama  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri.  | 
|  Penyedia Auth  |  Tentukan penyedia untuk mendapatkan kredensional.  | 
|  Wilayah Default  |  Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan). | 
|  Nama profil kredensial  |  Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file), tetap kosong untuk default.  | 
|  Asumsikan Peran Arn  |  Tentukan ARN dari peran yang akan diasumsikan.  | 
|  Titik akhir (opsional)  |  Jika Anda harus menentukan titik akhir layanan alternatif.  | 

### Autentikasi
<a name="timestream-authentication"></a>

 Bagian ini mencakup berbagai jenis otentikasi yang dapat Anda gunakan untuk sumber data Amazon Timestream. 

#### Contoh AWS kredensial
<a name="timestream-example-aws-credentials"></a>

 Anda tidak dapat menggunakan metode autentikasi file kredensial di Grafana Terkelola Amazon. 

# Menggunakan sumber data Timestream
<a name="timestream-query-editor"></a>

## Editor kueri
<a name="timestream-query-editor"></a>

 Editor kueri menerima sintaks Timestream selain makro yang terdaftar sebelumnya dan variabel template dasbor apa pun. 

 Tekan **Ctrl\$1Space untuk membuka saran**. IntelliSense 

## Makro
<a name="timestream-macros"></a>

 Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro. 


|  Contoh makro  |  Deskripsi  | 
| --- | --- | 
|  *\$1 \$1\$1basis data* |  Akan menentukan database yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri.  | 
|  *\$1 \$1\$1tabel*  |  Akan menentukan database yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri.  | 
|  *\$1 \$1\$1ukur*  |  Akan menentukan ukuran yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri.  | 
|  *\$1 \$1\$1TimeFilter*  |  Akan diganti dengan ekspresi yang membatasi waktu ke rentang dasbor  | 
|  *\$1 \$1\$1interval\$1ms*  |  Akan diganti dengan angka yang mewakili jumlah waktu yang harus dicakup oleh satu piksel dalam grafik.  | 

# Connect ke sumber data Amazon Athena
<a name="AWS-Athena"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

**catatan**  
 Panduan ini mengasumsikan bahwa Anda sudah terbiasa dengan layanan Amazon Athena sebelum Anda menggunakan sumber data Athena. 

Dengan Amazon Managed Grafana, Anda dapat menambahkan Athena sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Athena sebagai sumber data dengan menemukan akun Athena Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses Athena. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Athena sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama dengan yang Anda lakukan pada server Grafana yang dikelola sendiri.



 Ada prasyarat agar Athena dapat diakses oleh Grafana yang Dikelola Amazon. Untuk prasyarat yang terkait dengan penggunaan sumber data Athena, lihat. [Prasyarat](Athena-prereq.md)

# Prasyarat
<a name="Athena-prereq"></a>

Untuk menggunakan kebijakan terkelola untuk Grafana Terkelola Amazon untuk Athena, selesaikan tugas berikut sebelum Anda mengonfigurasi sumber data Athena:
+ Tandai kelompok kerja Athena Anda dengan. `GrafanaDataSource: true` 
+ Buat bucket S3 dengan nama yang dimulai dengan`grafana-athena-query-results-`. Kebijakan ini memberikan izin untuk menulis hasil kueri ke dalam bucket S3 dengan konvensi penamaan tersebut.

Izin Amazon S3 untuk mengakses sumber data dasar kueri Athena tidak disertakan dalam kebijakan terkelola ini. Anda harus menambahkan izin yang diperlukan untuk bucket Amazon S3 secara manual, secara manual. case-by-case Untuk informasi selengkapnya, lihat [contoh kebijakan berbasis identitas di Grafana Terkelola Amazon dalam](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) panduan ini.

# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Athena sebagai sumber data
<a name="Athena-adding-AWS-config"></a>

## Prasyarat
<a name="Athena-prerequisites"></a>
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) diinstal dan dikonfigurasi di lingkungan Anda.
+ Anda memiliki akses ke Athena dari akun Anda.

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama buka konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya Athena di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Athena sebagai sumber data.

# Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Athena sebagai sumber data


1.  Pastikan bahwa peran pengguna Anda adalah admin atau editor.

1.  Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk **Amazon Athena**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** **Amazon Athena**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu. Pengguna harus memiliki kebijakan akses Athena yang dilampirkan pada pengguna/peran untuk memiliki akses ke sumber data Athena. Lihat [AWS kebijakan terkelola: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) untuk info lebih lanjut. 

1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon bawah (ada dua) dan kemudian pilih **Athena** dari menu Sumber data.**

1. Pilih Wilayah default yang Anda inginkan dari sumber data Athena untuk kueri, lalu pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.

1.  Ikuti langkah-langkah untuk mengonfigurasi **Detail Athena** di [**Pengaturan Detail Athena**](#Athena-settings)

## **Pengaturan Detail Athena**
<a name="Athena-settings"></a>

**Konfigurasikan **pengaturan Detail Athena****

1.  Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**). 

1.  Pilih sumber data Athena yang ditargetkan tempat Anda memiliki akun Athena. Jika Anda tidak memilih sumber data apa pun, ada sumber data default di drop-down.

   Untuk membuat akun Athena baru, ikuti petunjuk di [Memulai](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html) dengan Athena

1.  Pilih database Athena yang ditargetkan di sumber data yang dipilih di atas.

1.  Pilih Workgroup. **Primer** secara default. 

1.  Jika workgroup Anda belum memiliki lokasi keluaran yang dikonfigurasi, tentukan bucket dan folder S3 yang akan digunakan untuk hasil kueri. Sebagai contoh, `s3://grafana-athena-plugin-test-data/query-result-output/ `. 

1.  Pilih **Simpan & Uji**. 

# Menambahkan sumber data Athena secara manual
<a name="Athena-add-the-data-source"></a>

## Prasyarat
<a name="Athena-prerequisites2"></a>
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) diinstal dan dikonfigurasi di lingkungan Anda.
+  Anda memiliki akses ke **Amazon Athena dari akun** Anda.

**Untuk menambahkan sumber data Athena secara manual:**

1.  **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber data **AWS Athena**. Jika perlu, Anda dapat mulai mengetik **Athena** di kotak pencarian untuk membantu Anda menemukannya.

1.  Di menu **Detail Koneksi**, konfigurasikan penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**) 

1.  Pilih sumber data, database, dan grup kerja Athena yang ditargetkan.

   Untuk membuat akun Athena baru, ikuti petunjuk di [Memulai dengan Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html).

1.  Jika workgroup Anda belum memiliki lokasi keluaran yang dikonfigurasi, tentukan bucket dan folder S3 yang akan digunakan untuk hasil kueri. Misalnya, `s3://grafana-athena-plugin-test-data/query-result-output/ `. 

1.  Pilih **Simpan & Uji**. 

Berikut ini adalah contoh pengaturan **Detail Athena**.

![\[Athena Detail contoh\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/athena.png)


# Menggunakan sumber data Athena
<a name="Athena-using-the-data-source"></a>

## Kebijakan IAM
<a name="Athena-policies"></a>

 Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca metrik Athena. Anda dapat melampirkan izin ini ke peran IAM dan memanfaatkan dukungan bawaan Grafana untuk mengambil peran. Perhatikan bahwa Anda perlu [Mengonfigurasi kebijakan yang diperlukan](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) untuk peran Anda sebelum menambahkan sumber data ke Grafana. Anda akan memerlukan peran admin atau editor untuk menambahkan sumber data. Kebijakan akses Amazon Grafana Athena bawaan ditentukan di bagian ini. [AWS kebijakan terkelola: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) 

## Permintaan data Athena
<a name="Athena-query"></a>

Sumber data Athena menyediakan editor kueri SQL standar. Grafana yang Dikelola Amazon menyertakan beberapa makro untuk membantu menulis kueri timeseries yang lebih kompleks. 

Makro


|  Makro  |  Deskripsi  |  Contoh  |  Contoh Keluaran  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1dateFilter(column)  |  \$1\$1\$1dateFiltermembuat filter bersyarat yang memilih data (menggunakancolumn) berdasarkan rentang tanggal panel.  |  \$1\$1\$1date(my\$1date)  | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | 
|  \$1\$1\$1parseTime(column,format)  |  \$1\$1\$1parseTimemelemparkan varchar sebagai stempel waktu dengan format yang diberikan.  |  \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z')  | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') | 
|  \$1\$1\$1timeFilter(column,format)  |  \$1\$1\$1timeFiltermembuat kondisional yang menyaring data (menggunakancolumn) berdasarkan rentang waktu panel. Argumen kedua digunakan untuk mengurai kolom secara opsional dari varchar ke stempel waktu dengan format tertentu.  | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' | 
|  \$1\$1\$1timeFrom()  |  \$1\$1\$1timeFromoutput waktu mulai saat ini dari kisaran panel dengan tanda kutip.  | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | 
|  \$1\$1\$1timeTo()  |  \$1\$1\$1timeTo menghasilkan waktu akhir saat ini dari kisaran panel dengan tanda kutip.  | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | 
|  \$1\$1\$1timeGroup(column, '1m', format)  |  \$1\$1\$1timeGroup mengelompokkan stempel waktu sehingga hanya ada 1 poin untuk setiap periode pada grafik. Argumen ketiga digunakan untuk mengurai kolom secara opsional dari varchar ke stempel waktu dengan format tertentu.  | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) | 
|  \$1\$1\$1table  |   \$1\$1\$1tablemengembalikan tabel yang dipilih dalam pemilih Tabel.  | \$1\$1\$1table | my\$1table | 
|  \$1\$1\$1column  |  \$1\$1\$1columnmengembalikan kolom yang dipilih dalam pemilih Kolom (membutuhkan tabel).  | \$1\$1\$1column  | col1  | 

**Visualisasi**

Sebagian besar pertanyaan di Athena paling baik diwakili oleh visualisasi tabel. Sebuah query menampilkan kembali data dalam tabel. Jika dapat ditanyakan, maka dapat ditampilkan sebagai tabel.

Contoh ini mengembalikan hasil untuk visualisasi tabel: 

```
SELECT {column_1}, {column_2} FROM {table};
```

**Timeseries/ Visualisasi grafik**

Untuk rangkaian waktu dan visualisasi grafik, Anda harus: 
+ pilih kolom dengan `date` atau `datetime` tipe. `date`Kolom harus dalam urutan menaik (menggunakan`ORDER BY column ASC`).
+ juga pilih kolom numerik.

**Memeriksa kueri**

Grafana yang Dikelola Amazon mendukung makro yang tidak dimiliki Athena, yang berarti kueri mungkin tidak berfungsi saat disalin dan ditempelkan langsung ke Athena. **Untuk melihat kueri interpolasi lengkap, yang bekerja langsung di Athena, klik tombol Query Inspector.** Kueri lengkap ditampilkan di bawah tab **Query**.

## Template dan variabel
<a name="using-Athena-templates-variables"></a>

Untuk informasi selengkapnya tentang menambahkan variabel kueri Athena, lihat. [Menambahkan variabel kueri](variables-types.md#add-a-query-variable) Gunakan sumber data Athena Anda sebagai sumber data Anda untuk kueri yang tersedia.

Setiap nilai yang ditanyakan dari tabel Athena dapat digunakan sebagai variabel. Hindari memilih terlalu banyak nilai, karena ini dapat menyebabkan masalah kinerja.

Setelah membuat variabel, Anda dapat menggunakannya dalam kueri Athena Anda dengan menggunakan. [Sintaks variabel](templates-and-variables.md#variable-syntax) Untuk informasi lebih lanjut tentang variabel, lihat[Template dan variabel](templates-and-variables.md).

## Anotasi
<a name="using-Athena-annotations"></a>

[Anotasi](dashboard-annotations.md)memungkinkan Anda untuk melapisi informasi acara yang kaya di atas grafik. **Anda dapat menambahkan anotasi dengan memilih panel atau dengan menambahkan kueri anotasi menggunakan tampilan Anotasi menu **Dasbor**.** 

Contoh kueri untuk menambahkan anotasi secara otomatis:

```
SELECT
  time as time,
  environment as tags,
  humidity as text
FROM
  tableName
WHERE
  $__dateFilter(time) and humidity > 95
```

Tabel berikut mewakili deskripsi kolom yang dapat digunakan untuk membuat anotasi:


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Time  |  Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  Timeend  |  Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. (Grafana v6.6\$1)  | 
|  Text  |  Bidang deskripsi acara.  | 
|  Tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma.  | 

## Dukungan data kueri async
<a name="athena-async-query"></a>

Kueri Athena di Grafana Terkelola Amazon ditangani secara asinkron untuk menghindari batas waktu. Kueri asinkron menggunakan permintaan terpisah untuk memulai kueri, lalu memeriksa kemajuannya, dan akhirnya untuk mengambil hasilnya. Ini menghindari batas waktu untuk kueri yang berjalan untuk waktu yang lama.

## Penggunaan kembali hasil kueri
<a name="athena-query-reuse"></a>

Anda dapat menggunakan kembali hasil kueri sebelumnya untuk meningkatkan kinerja kueri. Untuk mengaktifkan penggunaan kembali kueri, aktifkan ada di bagian **Penggunaan kembali hasil kueri** pada editor kueri. Ini harus dilakukan untuk setiap kueri yang ingin Anda gunakan kembali kueri.

**catatan**  
Fitur ini mengharuskan instans Athena Anda berada di engine versi 3. Untuk informasi selengkapnya, lihat [Mengubah versi mesin Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) di Panduan Pengguna *Amazon Athena*.

# Connect ke sumber data Amazon Redshift
<a name="AWS-Redshift"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

**catatan**  
 Panduan ini mengasumsikan bahwa pengguna sudah terbiasa dengan layanan Amazon Redshift sebelum menggunakan sumber data Amazon Redshift. 

Dengan Amazon Managed Grafana, Anda dapat menambahkan Amazon Redshift sebagai sumber data dengan menggunakan opsi konfigurasi sumber data AWS di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Amazon Redshift sebagai sumber data dengan menemukan akun Amazon Redshift Anda yang ada dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses Amazon Redshift. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Amazon Redshift sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan di server Grafana yang dikelola sendiri.

Ada prasyarat agar Amazon Redshift dapat diakses oleh Amazon Managed Grafana. Untuk prasyarat yang terkait dengan penggunaan sumber data Amazon Redshift, lihat. [Prasyarat](Redshift-prereq.md)

# Prasyarat
<a name="Redshift-prereq"></a>

Untuk menggunakan kebijakan AWS terkelola untuk Grafana Terkelola Amazon, selesaikan tugas berikut sebelum mengonfigurasi sumber data Amazon Redshift:
+ Tandai cluster Amazon Redshift Anda dengan. `GrafanaDataSource: true` Jika tidak, itu tidak akan dapat diakses.
+ Buat kredensi database dengan salah satu cara yang saling eksklusif berikut ini:
  + Jika Anda ingin menggunakan mekanisme default (opsi kredensial sementara) untuk mengautentikasi terhadap database Redshift, Anda harus membuat nama pengguna database. `redshift_data_api_user`
  + Jika Anda ingin menggunakan kredensi dari Secrets Manager, Anda harus menandai rahasia dengan. `RedshiftQueryOwner: true` Untuk informasi selengkapnya, lihat [contoh kebijakan berbasis identitas di Grafana Terkelola Amazon dalam](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) panduan ini.

# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Redshift sebagai sumber data
<a name="Redshift-configure"></a>

# Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Amazon Redshift sebagai sumber data


1.  Pastikan bahwa peran pengguna Anda adalah admin atau editor.

1.  Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk **Amazon Redshift**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** **Amazon Redshift**.

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon bawah (ada dua) dan kemudian pilih Redshift.**

1. Pilih wilayah default yang Anda inginkan dari sumber data Amazon Redshift untuk kueri, lalu pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.

1.  Ikuti langkah-langkah untuk mengonfigurasi **Detail Koneksi** di[Pengaturan **detail koneksi**](Redshift-config.md#Redshift-connection-details).

# Menambahkan sumber data Amazon Redshift secara manual
<a name="Redshift-add-the-data-source"></a>

## Prasyarat
<a name="Redshift-prerequisites"></a>
+  Anda memiliki akses ke **Amazon Redshift dari akun** Anda.

**Untuk menambahkan sumber data Amazon Redshift:**

1. Lampirkan [AmazonRedshiftAccessPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)ke peran pengguna ruang kerja Anda.

1. Pastikan peran pengguna Anda adalah admin atau editor.

1.  Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1.  **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber data **AWS Redshift**. Jika perlu, Anda dapat mulai mengetik **Redshift** di kotak pencarian untuk membantu Anda menemukannya.

1. Ini membuka halaman **Detail Koneksi**. Ikuti langkah-langkah dalam mengonfigurasi file. [Pengaturan **detail koneksi**](Redshift-config.md#Redshift-connection-details) 

# Mengonfigurasi Amazon Redshift
<a name="Redshift-config"></a>

 Setelah menambahkan sumber data Amazon Redshift ke ruang kerja, konfigurasikan setelan Amazon Redshift sebagai berikut:

## Prasyarat
<a name="Redshift-prerequisites"></a>
+  Anda memiliki akses ke **Amazon Redshift dari akun** Anda.

## Pengaturan **detail koneksi**
<a name="Redshift-connection-details"></a>

**Konfigurasikan pengaturan detail Koneksi**

1.  Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**). 

1.  Pilih **Wilayah Default** yang ingin Anda kueri. 

## **Pengaturan otentikasi**
<a name="Redshift-Authentication"></a>

**Konfigurasikan **pengaturan Otentikasi****

1.  Di menu **Authentication**, pilih tab **Temporary Credentials atau **AWS Secrets Manager** sebagai penyedia kredensial** akses Anda. Untuk detail tentang Temporary Credentials and AWS Secrets Manager, lihat [AWS kebijakan terkelola: AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)

1.  Jika Anda memilih **Kredensi sementara** yang secara default, ikuti langkah-langkah di bawah ini. Jika Anda memilih **AWS Secrets Manager**, masukkan kredenal **AWS Secrets Manager** Anda di kolom input. 

1.  Pilih **Cluster Identifier** dari cluster yang Anda buat di Amazon Redshift.

   [Untuk informasi lebih lanjut tentang cluster Redshift, lihat Koneksi Redshift.](https://docs.aws.amazon.com/redshift/latest/gsg/connection.html)

1.  Pilih database Redshift yang ditargetkan.

1.  Pilih pengguna database yang Anda buat untuk cluster di atas. 

1.  Pilih **Simpan & Uji**. 

Berikut ini adalah contoh pengaturan **Kredensial Sementara**.

![\[Contoh Kredensial Sementara\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/redshift.png)


Berikut ini adalah contoh dari menu **AWS Secrets Manager**.

![\[Contoh Secrets Manager\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/secretsmanager.png)


# Menggunakan sumber data Amazon Redshift
<a name="Redshift-using-the-data-source"></a>

## Kebijakan IAM
<a name="Redshift-policies"></a>

 Grafana membutuhkan izin yang diberikan menggunakan IAM untuk dapat membaca metrik Redshift. Anda dapat melampirkan izin ini ke peran IAM dan memanfaatkan dukungan bawaan Grafana untuk mengambil peran. Kebijakan akses Amazon Grafana Redshift bawaan ditentukan di bagian ini. [AWS kebijakan terkelola: AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess) 

## Kueri data Amazon Redshift
<a name="Redshift-query"></a>

 Sumber data Amazon Redshift menyediakan editor kueri SQL standar. Grafana yang Dikelola Amazon menyertakan beberapa makro untuk membantu menulis kueri timeseries yang lebih kompleks. 

Makro


|  Makro  |  Deskripsi  |  Contoh keluaran  | 
| --- | --- | --- | 
|  \$1\$1\$1timeEpoch(column)  |  \$1\$1\$1timeEpochakan diganti dengan ekspresi untuk mengonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi waktu  |  UNIX\$1TIMESTAMP(dateColumn) as "time"  | 
|  \$1\$1\$1timeFilter(column)  |  \$1\$1\$1timeFiltermembuat kondisional yang menyaring data (menggunakancolumn) berdasarkan rentang waktu panel  |  time BETWEEN '2017-07-18T11:15:52Z' AND '2017-07-18T11:15:52Z'  | 
|  \$1\$1\$1timeFrom()  |  \$1\$1\$1timeFromoutput waktu mulai saat ini dari kisaran panel dengan tanda kutip  | '2017-07-18T11:15:52Z' | 
|  \$1\$1\$1timeTo()  |  \$1\$1\$1timeTooutput waktu akhir saat ini dari kisaran panel dengan tanda kutip  | '2017-07-18T11:15:52Z' | 
|  \$1\$1\$1timeGroup(column, '1m')  |  \$1\$1\$1timeGroupmengelompokkan stempel waktu sehingga hanya ada 1 poin untuk setiap periode pada grafik  | floor(extract(epoch from time)/60)\$160 AS "time" | 
|  \$1\$1\$1schema  |  \$1\$1\$1schema menggunakan skema yang dipilih  | public | 
|  \$1\$1\$1table  |   \$1\$1\$1tableoutput tabel dari yang diberikan \$1\$1\$1schema (menggunakan skema publik secara default)  | sales | 
|  \$1\$1\$1column  |  \$1\$1\$1columnoutput kolom dari saat ini \$1\$1\$1table  | date  | 
|  \$1\$1\$1unixEpochFilter(column)  |  \$1\$1\$1unixEpochFilterdiganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix  |   column >= 1624406400 AND column <= 1624410000  | 
|  \$1\$1\$1unixEpochGroup(column)  |  \$1\$1\$1unixEpochGroupsama dengan \$1\$1\$1timeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix  | floor(time/60)\$160 AS "time" | 

**Visualisasi**

Sebagian besar kueri di Redshift paling baik diwakili oleh visualisasi tabel. Setiap kueri akan menampilkan data dalam tabel. Jika bisa ditanyakan, maka bisa dimasukkan ke dalam tabel. 

Contoh ini mengembalikan hasil untuk visualisasi tabel: 

```
SELECT {column_1}, {column_2} FROM {table};
```

**Deret waktu dan visualisasi grafik**

Untuk deret waktu dan visualisasi grafik, ada beberapa persyaratan: 
+ Kolom dengan `date` atau `datetime` tipe harus dipilih.
+ `date`Kolom harus dalam urutan menaik (menggunakan`ORDER BY column ASC`).
+ Anda harus memilih kolom numerik.

Untuk membuat grafik yang lebih masuk akal, pastikan untuk menggunakan `$__timeFilter` dan `$__timeGroup` makro.

**Contoh kueri timeseries:**

```
SELECT
  avg(execution_time) AS average_execution_time,
  $__timeGroup(start_time, 'hour'),
  query_type
FROM
  account_usage.query_history
WHERE
  $__timeFilter(start_time)
group by
  query_type,start_time
order by
  start_time,query_type ASC;
```

**Modus isi**

Grafana juga melengkapi bingkai secara otomatis tanpa nilai dengan beberapa default. Untuk mengonfigurasi nilai ini, ubah **Nilai Isi** di editor kueri. 

**Memeriksa kueri**

Karena Grafana mendukung makro yang Redshift tidak, kueri yang dirender sepenuhnya, yang dapat disalin dan ditempelkan langsung ke Redshift, terlihat di Query Inspector. **Untuk melihat kueri interpolasi lengkap, pilih menu Query **Inspector**, dan kueri lengkap terlihat di tab Query.**

## Template dan variabel
<a name="using-redshift-templates-variables"></a>

Untuk informasi selengkapnya tentang cara menambahkan varialble kueri Redshift baru, lihat. [Menambahkan variabel kueri](variables-types.md#add-a-query-variable) Gunakan sumber data Redshift Anda sebagai sumber data Anda untuk kueri yang tersedia.

Nilai apa pun yang ditanyakan dari tabel Amazon Redshift dapat digunakan sebagai variabel. Pastikan untuk menghindari memilih terlalu banyak nilai, karena ini dapat menyebabkan masalah kinerja. 

Setelah membuat variabel, Anda dapat menggunakannya dalam kueri Redshift Anda dengan menggunakan. [Sintaks variabel](templates-and-variables.md#variable-syntax) Untuk informasi lebih lanjut tentang variabel, lihat[Template dan variabel](templates-and-variables.md).

## Anotasi
<a name="using-redshift-annotations"></a>

[Anotasi](dashboard-annotations.md)memungkinkan Anda untuk melapisi informasi acara yang kaya di atas grafik. **Anda dapat menambahkan anotasi dengan memilih panel atau dengan menambahkan kueri anotasi menggunakan tampilan **Anotasi**, dibuka dari menu Dasbor.** 

Contoh kueri untuk menambahkan anotasi secara otomatis:

```
SELECT
  time as time,
  environment as tags,
  humidity as text
FROM
  $__table
WHERE
  $__timeFilter(time) and humidity > 95
```

Tabel berikut mewakili nilai-nilai kolom diperhitungkan untuk membuat anotasi:


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Time  |  Nama bidang tanggal atau waktu. Bisa berupa kolom dengan tipe data tanggal atau waktu SQL asli atau nilai epoch.  | 
|  Timeend  |  Nama opsional dari bidang tanggal akhir atau waktu. Bisa berupa kolom dengan tanggal SQL asli atau tipe data waktu atau nilai epoch.  | 
|  Text  |  Bidang deskripsi acara.  | 
|  Tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma.  | 

# Connect ke sumber AWS X-Ray data
<a name="x-ray-data-source"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

 Tambahkan AWS X-Ray sebagai sumber data, lalu buat dasbor atau gunakan Jelajahi dengan X-Ray untuk melihat jejak, analitik, atau wawasan. 

 Dengan Amazon Managed Grafana, Anda dapat menambahkan X-Ray sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan X-Ray sebagai sumber data dengan menemukan akun X-Ray yang ada dan mengelola konfigurasi kredensil otentikasi yang diperlukan untuk mengakses X-Ray. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan X-Ray sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan pada server Grafana yang dikelola sendiri.

**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan X-Ray sebagai sumber data](xray-adding-AWS-config.md)
+ [Menambahkan sumber data X-Ray secara manual](xray-add-the-data-source.md)
+ [Pengaturan X-Ray](#xray-settings)
+ [Menggunakan sumber data X-Ray](xray-using.md)

# Gunakan konfigurasi sumber AWS data untuk menambahkan X-Ray sebagai sumber data
<a name="xray-adding-AWS-config"></a>

Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM berkontrol layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya X-Ray di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan X-Ray sebagai sumber data.

**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan X-Ray sebagai sumber data**

1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)

1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.

1. Pilih nama ruang kerja.

1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md). 

1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk **AWS X-Ray**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.

1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana** di baris. **AWS X-Ray**

1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.

1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon dan kemudian pilih layanan **AWS ,** X-Ray.**

1. Pilih Wilayah default tempat Anda ingin sumber data X-Ray kueri, pilih akun, lalu pilih **Tambahkan sumber data**.

# Menambahkan sumber data X-Ray secara manual
<a name="xray-add-the-data-source"></a>

**Untuk menambahkan sumber data X-Ray secara manual**

1.  **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**

1. Pilih **Tambahkan sumber data**.

1. Pilih sumber data **X-Ray**. Jika perlu, Anda dapat mulai mengetik **X-Ray** di kotak pencarian untuk membantu Anda menemukannya.

## Pengaturan X-Ray
<a name="xray-settings"></a>


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Nama  |  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.  | 
|  Wilayah Default  |  Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan). | 
|  Penyedia Auth  |  Tentukan penyedia untuk mendapatkan kredensil.  | 
|  Nama profil kredensial  |  Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file), tetap kosong untuk default.  | 
|  Asumsikan Peran Arn  |  Tentukan ARN dari peran yang akan diasumsikan.  | 
|  ID Eksternal  |  Jika Anda mengambil peran di akun lain, yang telah dibuat dengan ID eksternal, tentukan ID eksternal di sini.  | 

### Autentikasi
<a name="xray-authentication"></a>

Bagian ini mencakup berbagai jenis otentikasi yang dapat Anda gunakan untuk sumber data X-Ray. 

#### Peran IAM
<a name="xray-iam-roles"></a>

 Saat ini, semua akses ke X-Ray dilakukan di sisi server oleh backend ruang kerja Grafana menggunakan SDK resmi. AWS Jika server Grafana Anda berjalan AWS, Anda dapat menggunakan peran IAM dan otentikasi akan ditangani secara otomatis. 

 Untuk informasi selengkapnya, lihat [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html). 

### Kebijakan IAM
<a name="xray-iam-policies"></a>

 Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca data X-Ray dan EC2. tags/instances/regions Anda dapat melampirkan izin ini ke peran IAM dan menggunakan dukungan Grafana bawaan untuk mengasumsikan peran. 

 Contoh kode berikut menunjukkan kebijakan minimal. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:BatchGetTraces",
                "xray:GetTraceSummaries",
                "xray:GetTraceGraph",
                "xray:GetGroups",
                "xray:GetTimeSeriesServiceStatistics",
                "xray:GetInsightSummaries",
                "xray:GetInsight",
                "ec2:DescribeRegions"
            ],
            "Resource": "*"
        }
    ]
}
```

------

#### Contoh AWS kredensial
<a name="xray-example-aws-credentials"></a>

 Anda tidak dapat menggunakan metode file kredensial di Grafana Terkelola Amazon. 

# Menggunakan sumber data X-Ray
<a name="xray-using"></a>

## Editor kueri
<a name="xray-query-editor"></a>

 Bidang yang paling penting dalam editor adalah jenis kueri. Ada empat jenis kueri: 
+  Daftar Jejak (Jejak di AWS) 
+  Statistik Jejak 
+  Trace Analytics (Analisis di AWS) 
+  Wawasan 

## Daftar Jejak
<a name="xray-trace-list"></a>

 Jenis Trace List memungkinkan Anda untuk mencari jejak, yang ditampilkan dalam tabel. Memilih ID jejak di kolom pertama membuka jejak di sisi kanan. Perhatikan bidang kueri di editor. Anda dapat menulis kueri, memfilter ekspresi, atau Anda dapat menyisipkan ID jejak tunggal yang akan ditampilkan dalam tampilan jejak. Untuk detail selengkapnya tentang ekspresi filter, lihat [AWS X-Ray dokumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html). 

**catatan**  
 Daftar jejak hanya akan menampilkan 1000 jejak pertama. 

## Statistik Jejak
<a name="xray-trace-statistics"></a>

 Di Trace Statistics, Anda dapat melihat grafik dan tabel yang menunjukkan informasi tentang kesalahan, kesalahan, throttle, keberhasilan, dan jumlah total. Anda dapat menggunakan kolom kolom di editor kueri untuk melihat hanya kolom tertentu. 

## Trace Analytics
<a name="xray-trace-analytics"></a>

 Di Trace Analytics, Anda dapat memvisualisasikan tabel berikut. 
+  Akar Penyebab 
  +  Waktu Respons 
    +  Layanan Root Cause (Layanan terakhir di jalur) 
    +  Jalur (beberapa jalur) 
  +  Kesalahan 
    +  Layanan Root Cause (Layanan terakhir di jalur) 
    +  Jalan 
    +  Pesan Kesalahan 
  +  Kesalahan 
    +  Layanan Root Cause (Layanan terakhir di jalur) 
    +  Jalan 
    +  Pesan Kesalahan 
+  Dampak Pengguna Akhir 
+  URL 
+  Kode Status HTTP 

## Wawasan
<a name="xray-insights"></a>

 Di Wawasan, Anda dapat melihat tabel ringkasan untuk Wawasan. Memilih InsightId akan membawa Anda ke konsol AWS Manajemen. 

## Peringatan
<a name="xray-alerting"></a>

 Karena kueri X-Ray dapat mengembalikan data numerik, peringatan didukung. Lihat informasi yang lebih lengkap di [Grafana memperingatkan](alerts-overview.md). 

# Connect ke sumber data Azure Monitor
<a name="using-azure-monitor-in-AMG"></a>

 Sumber data Azure Monitor mendukung beberapa layanan di cloud Azure: 
+  Layanan **Azure Monitor adalah layanan** platform yang menyediakan satu sumber untuk memantau sumber daya Azure. Untuk informasi selengkapnya, lihat [Menanyakan layanan Azure Monitor](#query-the-azure-monitor-service). 
+  **Server Application Insights** adalah layanan Application Performance Management (APM) yang dapat diperluas untuk pengembang web di berbagai platform dan dapat digunakan untuk memantau aplikasi web langsung Anda - ini akan secara otomatis mendeteksi anomali kinerja. Untuk informasi selengkapnya, lihat [Menanyakan layanan Application Insights Analytics](#query-the-application-insights-analytics-service). 
+  **Azure Log Analytics** (atau Azure Logs) memberi Anda akses ke data log yang dikumpulkan oleh Azure Monitor. Untuk informasi selengkapnya, lihat [Menanyakan layanan Azure Log Analytics](#querying-the-azure-log-analytics-service). 
+  Gunakan **layanan Application Insights Analytics** untuk menanyakan [data Application Insights](https://docs.microsoft.com/en-us/azure/azure-monitor/app/analytics) menggunakan bahasa kueri yang sama yang digunakan untuk Azure Log Analytics. Untuk informasi selengkapnya, lihat [Menanyakan layanan Application Insights Analytics](#query-the-application-insights-analytics-service). 

## Menambahkan sumber data
<a name="azure-add-the-data-source"></a>

 Sumber data dapat mengakses metrik dari empat layanan berbeda. Anda dapat mengonfigurasi akses ke layanan yang Anda gunakan. Dimungkinkan juga untuk menggunakan kredensi yang sama untuk beberapa layanan jika itu adalah cara Anda mengaturnya di Azure Entra ID. 
+  [Daftarkan aplikasi Microsoft Entra dan buat prinsipal layanan](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-create-service-principal-portal) 

1.  Diakses dari menu utama Grafana, sumber data yang baru diinstal dapat segera ditambahkan di bagian Sumber Data. Selanjutnya, pilih **Tambahkan sumber data** tombol di kanan atas. Sumber data Azure Monitor akan tersedia untuk dipilih di bagian Cloud dalam daftar sumber data. 

1.  Di bidang nama, Grafana akan secara otomatis mengisi nama untuk sumber data: `Azure Monitor` atau sesuatu seperti. `Azure Monitor - 3` Jika Anda mengonfigurasi beberapa sumber data, ubah nama menjadi sesuatu yang lebih informatif. 

1.  Jika Anda menggunakan Azure Monitor, Anda memerlukan empat informasi dari portal Azure (untuk instruksi terperinci, lihat tautan yang disediakan sebelumnya): 
   +  **Id Penyewa** (Azure Entra ID, Properti, ID Direktori) 
   +  **Client Id** (Azure Entra ID, Pendaftaran Aplikasi, Pilih aplikasi Anda, ID Aplikasi) 
   +  **Rahasia Klien** (ID Azure Entra, Pendaftaran Aplikasi, Pilih aplikasi Anda, Kunci) 
   +  **Id Langganan Default** (Langganan, Pilih langganan, Ikhtisar, ID Langganan) 

1.  Tempelkan keempat item ini ke bidang di bagian Detail API Azure Monitor. 
   +  Id Langganan dapat diubah per kueri. Simpan sumber data dan segarkan halaman untuk melihat daftar langganan yang tersedia untuk ID Klien yang ditentukan. 

1.  Jika Anda juga menggunakan layanan Azure Log Analytics, Anda harus menentukan dua nilai konfigurasi ini atau menggunakan kembali Client Id dan Secret dari langkah sebelumnya. 
   +  Client Id (Azure Entra ID, Pendaftaran Aplikasi, Pilih aplikasi Anda, ID Aplikasi) 
   +  Rahasia Klien (ID Azure Entra, Pendaftaran Aplikasi, Pilih aplikasi Anda, Kunci, Buat kunci, Gunakan rahasia klien) 

1.  Jika Anda menggunakan Application Insights, Anda memerlukan dua informasi dari Portal Azure (untuk petunjuk terperinci, lihat tautan yang disediakan sebelumnya): 
   +  ID Aplikasi 
   +  Kunci API 

1.  Tempelkan kedua item ini ke bidang yang sesuai di bagian Application Insights API Details. 

1.  Uji apakah detail konfigurasi sudah benar dengan memilih tombol **Simpan & Uji**. 

 Atau pada langkah 4, jika Anda membuat Aplikasi ID Azure Entra baru, gunakan [Azure](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest) CLI: 

```
az ad sp create-for-rbac -n "http://localhost:3000"
```

## Memilih layanan
<a name="azure-choose-a-service"></a>

 Di editor kueri untuk panel, setelah Anda memilih sumber data Azure Monitor, langkah pertama adalah memilih layanan. Ada empat opsi: 
+  `Azure Monitor` 
+  `Application Insights` 
+  `Azure Log Analytics` 
+  `Insights Analytics` 

 Editor kueri berubah tergantung pada opsi mana yang Anda pilih. Azure Monitor adalah default. 

## Menanyakan layanan Azure Monitor
<a name="query-the-azure-monitor-service"></a>

 Layanan Azure Monitor menyediakan metrik untuk semua layanan Azure yang telah Anda jalankan. Ini membantu Anda memahami kinerja aplikasi Anda di Azure, dan secara proaktif menemukan masalah yang memengaruhi aplikasi Anda. 

 Jika kredensi Azure Monitor Anda memberi Anda akses ke beberapa langganan, pilih langganan yang sesuai terlebih dahulu. 

 Contoh metrik yang bisa Anda dapatkan dari layanan adalah: 
+  `Microsoft.Compute/virtualMachines - Percentage CPU` 
+  `Microsoft.Network/networkInterfaces - Bytes sent` 
+  `Microsoft.Storage/storageAccounts - Used Capacity` 

 Editor kueri memungkinkan Anda untuk menanyakan beberapa dimensi untuk metrik yang mendukungnya. Metrik yang mendukung beberapa dimensi adalah yang tercantum dalam [Daftar Metrik yang didukung Azure Monitor](https://docs.microsoft.com/en-us/azure/azure-monitor/platform/metrics-supported) yang memiliki satu atau beberapa nilai yang tercantum dalam kolom **Dimensi** untuk metrik. 

### Memformat kunci legenda dengan alias untuk Azure Monitor
<a name="format-legend-keys-with-aliases-for-azure-monitor"></a>

 Pemformatan legenda default untuk Azure Monitor API adalah: 

 `metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}` 

 Ini bisa panjang, tetapi Anda dapat mengubah pemformatan ini dengan menggunakan alias. Di bidang **Format Legenda**, Anda dapat menggabungkan alias berikut dengan cara apa pun yang Anda inginkan. 

 Contoh Azure Monitor: 
+  `Blob Type: {{ blobtype }}` 
+  `{{ resourcegroup }} - {{ resourcename }}` 

### Pola alias untuk Azure Monitor
<a name="alias-patterns-for-azure-monitor"></a>
+  `{{ resourcegroup }}`= diganti dengan nilai Grup Sumber Daya 
+  `{{ namespace }}`= diganti dengan nilai Namespace (misalnya, Microsoft.Compute/VirtualMachines) 
+  `{{ resourcename }}`= diganti dengan nilai Resource Name 
+  `{{ metric }}`= diganti dengan nama metrik (misalnya, Persentase CPU) 
+  `{{ dimensionname }}`= *Legacy pada 7.1\$1 (untuk kompatibilitas mundur)* diganti dengan dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) key/label (misalnya, blobtype) 
+  `{{ dimensionvalue }}`= *Legacy pada 7.1\$1 (untuk kompatibilitas mundur)* diganti dengan nilai dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) (misalnya,) BlockBlob 
+  `{{ arbitraryDim }}`= *Tersedia dalam 7.1\$1* diganti dengan nilai dimensi yang sesuai. (misalnya, `{{ blobtype }}` menjadi BlockBlob) 

### Membuat variabel template untuk Azure Monitor
<a name="create-template-variables-for-azure-monitor"></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. 

 Perhatikan bahwa layanan Azure Monitor belum mendukung beberapa nilai. Untuk memvisualisasikan beberapa deret waktu (misalnya, metrik untuk server1 dan server2), tambahkan beberapa kueri sehingga Anda dapat melihatnya pada grafik yang sama atau dalam tabel yang sama. 

 Plugin sumber data Azure Monitor menyediakan kueri berikut yang dapat Anda tentukan di bidang **Kueri** dalam tampilan Edit variabel. Anda dapat menggunakannya untuk mengisi daftar opsi variabel. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Subscriptions()  |  Mengembalikan daftar langganan.  | 
|  ResourceGroups()  |  Mengembalikan daftar kelompok sumber daya.  | 
|  ResourceGroups(12345678-aaaa-bbbb-cccc-123456789aaa)  |  Mengembalikan daftar kelompok sumber daya untuk langganan tertentu.  | 
|  Namespaces(aResourceGroup)  |  Mengembalikan daftar namespace untuk kelompok sumber daya tertentu.  | 
|  Namespaces(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup)  |  Mengembalikan daftar namespace untuk kelompok sumber daya tertentu dan berlangganan.  | 
|  ResourceNames(aResourceGroup, aNamespace)  |  Mengembalikan daftar nama sumber daya.  | 
|  ResourceNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace)  |  Mengembalikan daftar nama sumber daya untuk langganan tertentu.  | 
|  MetricNamespace(aResourceGroup, aNamespace, aResourceName)  |  Mengembalikan daftar ruang nama metrik.  | 
|  MetricNamespace(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName)  |  Mengembalikan daftar ruang nama metrik untuk langganan tertentu.  | 
|  MetricNames(aResourceGroup, aNamespace, aResourceName)  |  Mengembalikan daftar nama metrik.  | 
|  MetricNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName)  |  Mengembalikan daftar nama metrik untuk langganan tertentu.  | 

 Contoh: 
+  Kueri Resource Groups: `ResourceGroups()` 
+  Melewati variabel nama metrik: `Namespaces(cosmo)` 
+  Variabel template rantai: `ResourceNames($rg, $ns)` 
+  Jangan mengutip parameter: `MetricNames(hg, Microsoft.Network/publicIPAddresses, grafanaIP)` 

 Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template](templates-and-variables.md#templates). 

### Daftar metrik Azure Monitor yang didukung
<a name="list-of-supported-azure-monitor-metrics"></a>

 Tidak semua metrik yang dikembalikan oleh Azure Monitor API memiliki nilai. Untuk mempermudah pembuatan kueri, sumber data Grafana memiliki daftar metrik Azure Monitor yang didukung, dan mengabaikan metrik yang tidak akan pernah memiliki nilai. Daftar ini diperbarui secara berkala karena layanan dan metrik baru ditambahkan ke cloud Azure.

### Peringatan Azure Monitor
<a name="azure-monitor-alerting"></a>

 Grafana alert didukung untuk layanan Azure Monitor. Ini bukan dukungan Azure Alerts. Untuk informasi lebih lanjut tentang peringatan Grafana, lihat. [Grafana memperingatkan](alerts-overview.md) 

## Menanyakan layanan Application Insights
<a name="query-the-application-insights-service"></a>

### Memformat kunci legenda dengan alias untuk Wawasan Aplikasi
<a name="formatting-legend-keys-with-aliases-for-application-insights"></a>

 Pemformatan legenda default adalah: 

 `metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}` 

 Di bidang Format Legenda, alias berikut dapat digabungkan dengan cara apa pun yang Anda inginkan. 

 Contoh Wawasan Aplikasi: 
+  `city: {{ client/city }}` 
+  `{{ metric }} [Location: {{ client/countryOrRegion }}, {{ client/city }}]` 

### Pola alias untuk Wawasan Aplikasi
<a name="alias-patterns-for-application-insights"></a>
+  `{{ groupbyvalue }}`= *Legacy pada Grafana 7.1\$1 (untuk kompatibilitas mundur) diganti dengan dimensi pertama (seperti* yang diurutkan berdasarkan key/label kunci/label) 
+  `{{ groupbyname }}`= *Legacy pada Grafana 7.1\$1 (untuk kompatibilitas mundur*) diganti dengan nilai dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) (misalnya,) BlockBlob 
+  `{{ metric }}`= diganti dengan nama metrik (misalnya, permintaan/hitungan) 
+  `{{ arbitraryDim }}`= *Tersedia dalam 7.1\$1* diganti dengan nilai dimensi yang sesuai. (misalnya, `{{ client/city }}` menjadi Chicago) 

### Ekspresi filter untuk Wawasan Aplikasi
<a name="filter-expressions-for-application-insights"></a>

 Bidang filter mengambil ekspresi OData filter. 

 Contoh: 
+  `client/city eq 'Boydton'` 
+  `client/city ne 'Boydton'` 
+  `client/city ne 'Boydton' and client/city ne 'Dublin'` 
+  `client/city eq 'Boydton' or client/city eq 'Dublin'` 

### Templating dengan variabel untuk Application Insights
<a name="templating-with-variables-for-application-insights"></a>

 Gunakan salah satu kueri berikut di bidang **Query** di tampilan edit Variabel. 

 Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template](templates-and-variables.md#templates). 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  AppInsightsMetricNames()  |  Mengembalikan daftar nama metrik.  | 
|  AppInsightsGroupBys(aMetricName)  |  Mengembalikan daftar group by klausa untuk nama metrik tertentu.  | 

 Contoh: 
+  Kueri Nama Metrik: `AppInsightsMetricNames()` 
+  Melewati variabel nama metrik: `AppInsightsGroupBys(requests/count)` 
+  Variabel template rantai: `AppInsightsGroupBys($metricnames)` 

### Peringatan Wawasan Aplikasi
<a name="application-insights-alerting"></a>

 Peringatan Grafana didukung untuk Wawasan Aplikasi. Ini bukan dukungan Azure Alerts. Untuk informasi lebih lanjut tentang peringatan Grafana, lihat. [Grafana memperingatkan](alerts-overview.md) 

## Menanyakan layanan Azure Log Analytics
<a name="querying-the-azure-log-analytics-service"></a>

 Kueri ditulis dalam Bahasa Kueri [Azure Log Analytics (atau KustoDB](https://docs.microsoft.com/en-us/azure/azure-monitor/log-query/query-language)) yang baru. Kueri Log Analytics dapat diformat sebagai data deret waktu atau sebagai data tabel. 

 Jika kredensional Anda memberi Anda akses ke beberapa langganan, pilih langganan yang sesuai sebelum memasukkan kueri. 

### Pertanyaan deret waktu
<a name="azure-time-series-queries"></a>

 Kueri deret waktu adalah untuk panel grafik dan panel lain seperti SingleStat panel. Setiap kueri harus berisi setidaknya kolom datetime dan kolom nilai numerik. Hasilnya harus diurutkan dalam urutan menaik menurut kolom datetime. 

 Contoh kode berikut menunjukkan query yang mengembalikan jumlah agregat dikelompokkan berdasarkan jam. 

```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h)
| order by TimeGenerated asc
```

 Kueri juga dapat memiliki satu atau lebih kolom non-numerik/non-datetime, dan kolom tersebut dianggap dimensi dan menjadi label dalam respons. Misalnya, kueri yang mengembalikan jumlah agregat yang dikelompokkan berdasarkan jam, Komputer, dan. CounterName 

```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h), Computer, CounterName
| order by TimeGenerated asc
```

 Anda juga dapat memilih kolom nilai angka tambahan (dengan, atau tanpa beberapa dimensi). Misalnya, mendapatkan hitungan dan nilai rata-rata per jam, Komputer CounterName, dan InstanceName: 

```
Perf
| where $__timeFilter(TimeGenerated)
| summarize Samples=count(), ["Avg Value"]=avg(CounterValue)
    by bin(TimeGenerated, $__interval), Computer, CounterName, InstanceName
| order by TimeGenerated asc
```

**catatan**  
 **Tip**: Pada kueri sebelumnya, sintaks Kusto dan `Samples=count()` `["Avg Value"]=...` digunakan untuk mengganti nama kolom tersebut — sintaks kedua yang memungkinkan ruang. Ini mengubah nama metrik yang digunakan Grafana. Akibatnya, hal-hal seperti legenda seri dan kolom tabel akan cocok dengan apa yang Anda tentukan. Dalam contoh `Samples` ini, ditampilkan bukan`_count`. 

### Kueri tabel
<a name="azure-table-queries"></a>

 Kueri tabel terutama digunakan dalam panel tabel, dan mereka menunjukkan daftar kolom dan baris. Contoh query ini mengembalikan baris dengan enam kolom tertentu. 

```
AzureActivity
| where $__timeFilter()
| project TimeGenerated, ResourceGroup, Category, OperationName, ActivityStatus, Caller
| order by TimeGenerated desc
```

### Memformat nama tampilan untuk Log Analytics
<a name="format-the-display-name-for-log-analytics"></a>

 Format nama tampilan default adalah: 

 `metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}` 

 Ini dapat disesuaikan dengan menggunakan opsi bidang nama tampilan. 

### Makro Azure Log Analytics
<a name="azure-log-analytics-macros"></a>

 Untuk mempermudah penulisan kueri, Grafana menyediakan beberapa makro yang dapat Anda gunakan di klausa where kueri: 
+  `$__timeFilter()`— Memperluas ke `TimeGenerated ≥ datetime(2018-06-05T18:09:58.907Z) and` `TimeGenerated ≤ datetime(2018-06-05T20:09:58.907Z)` tempat dari dan ke datetimes berasal dari pemilih waktu Grafana. 
+  `$__timeFilter(datetimeColumn)`— Memperluas ke `datetimeColumn ≥ datetime(2018-06-05T18:09:58.907Z) and` `datetimeColumn ≤ datetime(2018-06-05T20:09:58.907Z)` tempat dari dan ke datetimes berasal dari pemilih waktu Grafana. 
+  `$__timeFrom()`— Mengembalikan datetime Dari dari pemilih Grafana. Contoh:`datetime(2018-06-05T18:09:58.907Z)`. 
+  `$__timeTo()`— Mengembalikan datetime Dari dari pemilih Grafana. Contoh:`datetime(2018-06-05T20:09:58.907Z)`. 
+  `$__escapeMulti($myVar)`— akan digunakan dengan variabel template multi-nilai yang berisi karakter ilegal. Jika `$myVar` memiliki dua nilai berikut sebagai string`'\\grafana-vm\Network(eth0)\Total','\\hello!'`, maka itu meluas ke:`@'\\grafana-vm\Network(eth0)\Total', @'\\hello!'`. Jika menggunakan variabel nilai tunggal tidak perlu untuk makro ini, lepas dari variabel inline sebagai gantinya:. `@'\$myVar'` 
+  `$__contains(colName, $myVar)`— akan digunakan dengan variabel template multi-nilai. Jika `$myVar` memiliki nilai`'value1','value2'`, itu meluas ke:`colName in ('value1','value2')`. 

   Jika menggunakan **Semua** pilihan, centang kotak centang **Sertakan Semua Opsi** dan di bidang **Kustom semua nilai**, masukkan nilai berikut:**all**. Jika `$myVar` memiliki nilai`all`, makro malah akan diperluas ke`1 == 1`. Untuk variabel template dengan banyak opsi, ini meningkatkan kinerja kueri dengan tidak membangun klausa “where.. in” yang besar.

### Variabel bawaan Azure Log Analytics
<a name="azure-log-analytics-builtin-variables"></a>

 Ada juga beberapa variabel Grafana yang dapat digunakan dalam kueri Azure Log Analytics: 
+  `$__interval`- Grafana menghitung butir waktu minimum yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ia mengembalikan butir waktu seperti `5m` atau `1h` yang dapat digunakan dalam fungsi bin; misalnya,`summarize count() by bin(TimeGenerated, $__interval)`. Untuk informasi lebih lanjut tentang variabel interval, lihat[Menambahkan variabel interval](variables-types.md#add-an-interval-variable). 

### Templating dengan variabel untuk Azure Log Analytics
<a name="templating-with-variables-for-azure-log-analytics"></a>

 Setiap kueri Log Analytics yang mengembalikan daftar nilai dapat digunakan di bidang **Kueri** dalam tampilan edit Variabel. Ada juga satu fungsi Grafana untuk Log Analytics yang mengembalikan daftar ruang kerja. 

 Untuk informasi tentang template dan variabel template, lihat[Template dan variabel](templates-and-variables.md). 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  workspaces()  |  Mengembalikan daftar ruang kerja untuk langganan default.  | 
|  workspaces(12345678-aaaa-bbbb-cccc-123456789aaa)  |  Mengembalikan daftar ruang kerja untuk langganan tertentu (parameter dapat dikutip atau tidak dikutip).  | 

 Tabel berikut menunjukkan contoh query variabel. 


|  Kueri  |  Deskripsi  | 
| --- | --- | 
|  subscriptions()  |  Mengembalikan daftar langganan Azure.  | 
|  workspaces()  |  Mengembalikan daftar ruang kerja untuk langganan default.  | 
|  workspaces("12345678-aaaa-bbbb-cccc-123456789aaa")  |  Mengembalikan daftar ruang kerja untuk langganan tertentu. | 
|  workspaces("\$1subscription")  |  Dengan variabel template untuk parameter berlangganan.  | 
|  workspace("myWorkspace").Heartbeat \$1\$1 distinct Computer  |  Mengembalikan daftar mesin virtual.  | 
|  workspace("\$1workspace").Heartbeat \$1\$1 distinct Computer  |  Mengembalikan daftar mesin virtual dengan variabel template.  | 
|  workspace("\$1workspace").Perf \$1\$1 distinct ObjectName  |  Mengembalikan daftar objek dari tabel Perf.  | 
|  workspace("\$1workspace").Perf \$1\$1 where ObjectName == "\$1object" \$1\$1 distinct CounterName  |  Mengembalikan daftar nama metrik dari tabel Perf.  | 

 Kode xample berikut menunjukkan query deret waktu menggunakan variabel.

```
Perf
| where ObjectName == "$object" and CounterName == "$metric"
| where TimeGenerated >= $__timeFrom() and TimeGenerated <= $__timeTo()
| where  $__contains(Computer, $computer)
| summarize avg(CounterValue) by bin(TimeGenerated, $__interval), Computer
| order by TimeGenerated asc
```

### Penautan mendalam dari panel Grafana ke editor kueri Log Analytics di Azure Portal
<a name="deep-linking-from-grafana-panels-to-the-log-analytics-query-editor-in-azure-portal"></a>

 Pilih deret waktu di panel untuk melihat menu konteks dengan tautan ke **Lihat di Portal Azure**. Memilih tautan itu membuka editor kueri Azure Log Analytics di Portal Azure dan menjalankan kueri dari panel Grafana di sana. 

 Jika saat ini Anda tidak masuk ke Portal Azure, maka tautan akan membuka halaman login. Tautan yang disediakan berlaku untuk akun apa pun, tetapi hanya menampilkan kueri jika akun Anda memiliki akses ke ruang kerja Azure Log Analytics yang ditentukan dalam kueri. 

### Peringatan Azure Log Analytics
<a name="azure-log-analytics-alerting"></a>

 Peringatan Grafana didukung untuk Wawasan Aplikasi. Ini bukan dukungan Azure Alerts. Untuk informasi selengkapnya tentang peringatan di ruang kerja Grafana, lihat. [Grafana memperingatkan](alerts-overview.md)

## Menanyakan layanan Application Insights Analytics
<a name="query-the-application-insights-analytics-service"></a>

 Jika Anda mengubah jenis layanan ke **Insights Analytics**, editor serupa dengan layanan Log Analytics akan tersedia. Layanan ini juga menggunakan bahasa Kusto, sehingga instruksi untuk kueri data identik dengan[Menanyakan layanan Azure Log Analytics](#querying-the-azure-log-analytics-service), kecuali Anda meminta data Application Insights Analytics sebagai gantinya. 

# Connect ke sumber data Graphite
<a name="using-graphite-in-AMG"></a>

 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
<a name="graphite-settings"></a>

 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)
<a name="graphite-server-access-mode-default"></a>

 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
<a name="graphite-browser-access-mode"></a>

 Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber data Graphite.

## Editor kueri grafit
<a name="graphite-query-editor"></a>

 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
<a name="graphite-choose-metrics-to-query"></a>

 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
<a name="graphite-functions"></a>

 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
<a name="graphite-sort-labels"></a>

 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
<a name="graphite-nested-queries"></a>

 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
<a name="avoiding-many-queries-by-using-wildcards"></a>

 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
<a name="modify-the-metric-name-in-my-tables-or-charts"></a>

 Gunakan `alias` fungsi untuk mengubah nama metrik pada tabel atau grafik Grafana; misalnya, atau. `aliasByNode()` `aliasSub()` 

## Konsolidasi titik
<a name="graphite-point-consolidation"></a>

 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
<a name="graphite-combine-time-series"></a>

 Untuk menggabungkan deret waktu, pilih **Gabungkan** dalam daftar **Fungsi**. 

## Eksplorasi data dan tag
<a name="data-exploration-and-tags"></a>

 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
<a name="graphite-template-variables"></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). 

 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
<a name="graphite-query-variable"></a>

 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
<a name="using-__searchfilter-to-filter-query-variable-results"></a>

 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
<a name="variable-usage"></a>

 Anda dapat menggunakan variabel dalam jalur simpul metrik atau sebagai parameter untuk suatu fungsi. 

 Ada dua sintaks: 
+  `$<varname>`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
<a name="variable-usage-in-tag-queries"></a>

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

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

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

# Connect ke sumber data InfluxDB
<a name="using-influxdb-in-AMG"></a>

 Grafana dikirimkan dengan plugin sumber data kaya fitur untuk InfluxDB. Plugin ini mencakup editor kueri khusus dan mendukung anotasi dan templat kueri. 

## Menambahkan sumber data
<a name="influxdb-add-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 bernama **Sumber Data**. 

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

1.  Pilih **InfluxDB** dari daftar **dropdown Type**. 

1.  **Pilih **InfluxQL** atau **Flux** dari daftar Bahasa Kueri.** 

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

# Connect ke sumber data Jaeger
<a name="jaeger-data-source"></a>

 Sumber data Jaeger menyediakan penelusuran terdistribusi sumber terbuka. end-to-end 

## Menambahkan sumber data
<a name="jaeger-adding-the-data-source"></a>

 **Untuk mengakses pengaturan Jaeger, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih Jaeger.** 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Name  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi.  | 
|  Default  |  Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.  | 
|  URL  |  URL dari contoh Jaeger; misalnya,. http://localhost:16686  | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana.  | 
|  Basic Auth  |  Aktifkan otentikasi dasar ke sumber data Jaeger.  | 
|  User  |  Nama pengguna untuk otentikasi dasar.  | 
|  Password  |  Kata sandi untuk otentikasi dasar.  | 

## Jejak kueri
<a name="jaeger-query-traces"></a>

 Anda dapat menanyakan dan menampilkan jejak dari Jaeger melalui Jelajahi. Untuk informasi selengkapnya, lihat [Jelajahi](explore.md). 

 Editor kueri Jaeger memungkinkan Anda untuk menanyakan dengan melacak ID secara langsung atau memilih jejak dari pemilih jejak. Untuk melakukan kueri berdasarkan ID jejak, masukkan ID ke dalam input teks. 

 Gunakan pemilih jejak untuk memilih jejak tertentu dari semua jejak yang dicatat dalam rentang waktu yang telah Anda pilih di Jelajahi. Pemilih jejak memiliki tiga tingkat bersarang: 1. Layanan yang Anda minati. 1. Operasi khusus adalah bagian dari layanan yang dipilih. 1. Jejak spesifik di mana operasi yang dipilih terjadi, diwakili oleh nama operasi root dan durasi jejak. 

## Menautkan ke ID jejak dari log
<a name="linking-trace-id-from-logs"></a>

 Anda dapat menautkan ke jejak Jaeger dari log di Loki dengan mengonfigurasi bidang turunan dengan tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields). 

# Connect ke sumber data Loki
<a name="using-loki-in-AMG"></a>

 Sumber data Loki menyediakan akses ke Loki, sistem agregasi log Grafana. 

## Menambahkan sumber data
<a name="loki-adding-the-data-source"></a>

1.  Buka ruang kerja Grafana dan pastikan Anda masuk. 

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

1.  pilih tombol **Tambahkan sumber data** di bagian atas. 

1.  Pilih **Loki** dari daftar sumber data. 

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Name  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi.  | 
|  Default  |  Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.  | 
|  URL  | URL dari instance Loki; misalnya,http://localhost:3100. Ini bisa berupa URL untuk EC2 host Amazon, atau Application Load Balancer di depan kluster Amazon EKS, atau URL lain untuk instance Loki. | 
|  Maximum lines  |  Batas atas untuk jumlah baris log yang dikembalikan oleh Loki (default adalah 1000). Kurangi jika browser Anda lamban saat menampilkan log di Jelajahi.  | 

### Bidang turunan
<a name="loki-derived-fields"></a>

 Anda dapat menggunakan konfigurasi *bidang turunan* untuk melakukan hal berikut: 
+  Tambahkan bidang yang diuraikan dari pesan log. 
+  Tambahkan tautan yang menggunakan nilai bidang. 

 Anda dapat menggunakan fungsi ini untuk menautkan ke backend penelusuran langsung dari log Anda, atau menautkan ke halaman profil pengguna jika userID ada di baris log. Tautan ini muncul di detail log. Untuk informasi selengkapnya, lihat [Label dan bidang yang terdeteksi](explore.md#labels-and-detected-fields). 

Setiap bidang turunan terdiri dari yang berikut: 
+  **Nama** - Ditampilkan dalam rincian log sebagai label. 
+  **Regex** — Pola Regex yang berjalan pada pesan log dan menangkap bagian darinya sebagai nilai bidang baru. Hanya dapat berisi satu grup tangkapan. 
+  **URL/query** - Jika link eksternal, maka masukkan URL link lengkap. Jika tautannya adalah tautan internal, maka input ini berfungsi sebagai kueri untuk sumber data target. Dalam kedua kasus, Anda dapat menginterpolasi nilai dari bidang dengan `${__value.raw }` makro. 
+  **Tautan internal** — Pilih apakah tautannya internal atau eksternal. Dalam hal tautan internal, pemilih sumber data memungkinkan Anda memilih sumber data target. Hanya melacak sumber data yang didukung. 

 Anda dapat menggunakan bagian debug untuk melihat apa yang diekstrak bidang Anda dan bagaimana URL diinterpolasi. pilih **Tampilkan pesan log contoh** untuk menampilkan area teks tempat Anda dapat memasukkan pesan log. 

 Bidang baru dengan tautan yang ditampilkan dalam detail log. 

## Memeriksa log
<a name="loki-querying-logs"></a>

 Menanyakan dan menampilkan data log dari Loki tersedia melalui Jelajahi dan dengan panel log dalam visualisasi. Pilih sumber data Loki, lalu masukkan kueri LogQL untuk menampilkan log Anda. [Untuk informasi selengkapnya tentang LogQL, lihat LogQL.](https://grafana.com/docs/loki/latest/logql/) 

### Kueri log
<a name="loki-log-queries"></a>

 Kueri log terdiri dari dua bagian: **pemilih aliran log**, dan **ekspresi pencarian**. Untuk alasan kinerja, Anda harus mulai dengan memilih label log untuk aliran log. 

 Penjelajah **Log (tombol Log label**) di sebelah bidang kueri menunjukkan daftar label aliran log yang tersedia. Cara alternatif untuk menulis kueri adalah dengan menggunakan penyelesaian otomatis bidang kueri. Anda mulai dengan mengetik penjepit keriting kiri `{` dan menu pelengkapan otomatis akan menyarankan daftar label. Tekan tombol **Enter** untuk menjalankan kueri. 

 Setelah hasilnya dikembalikan, panel log menunjukkan daftar baris log dan bagan batang di mana sumbu x menunjukkan waktu dan sumbu y menunjukkan frekuensi/hitungan. 

### Pemilih Aliran Log
<a name="log-stream-selector"></a>

 Untuk bagian label dari ekspresi kueri, bungkus dalam kurung kurawal `{}` dan kemudian gunakan sintaks nilai kunci untuk memilih label. Beberapa ekspresi label dipisahkan oleh koma: 

 `{app="mysql",name="mysql-backup"}` 

 Operator pencocokan label berikut saat ini didukung: 
+  `=`persis sama. 
+  `!=`tidak sama. 
+  `=~`pertandingan regex. 
+  `!~`jangan regex-match. 

 Contoh: 
+  `{name=~"mysql.+"}` 
+  `{name!~"mysql.+"}` 

 Cara lain untuk menambahkan pemilih label adalah di bagian tabel. pilih **Filter** di samping label untuk menambahkan label ke ekspresi kueri. Ini bahkan berfungsi untuk beberapa kueri dan akan menambahkan pemilih label ke setiap kueri. 

### Ekspresi pencarian
<a name="loki-search-expression"></a>

 Setelah menulis Pemilih Aliran Log, Anda dapat memfilter hasil lebih lanjut dengan menulis ekspresi pencarian. Ekspresi pencarian bisa berupa teks atau ekspresi regex. 

 Contoh kueri: 
+  `{job="mysql"} |= "error"` 
+  `{name="kafka"} |~ "tsdb-ops.*io:2003"` 
+  `{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"` 

 Operator filter dapat dirantai dan secara berurutan akan memfilter ekspresi. Garis log yang dihasilkan akan memenuhi setiap filter. 

 Contoh 

 `{job="mysql"} |= "error" != "timeout"` 

 Jenis filter berikut saat ini didukung: 
+  `|=`baris berisi string. 
+  `!=`baris tidak mengandung string. 
+  `|~`garis cocok dengan ekspresi reguler. 
+  `!~`garis tidak cocok dengan ekspresi reguler. 

**catatan**  
 [Untuk informasi selengkapnya tentang LogQL, bahasa kueri Loki, lihat Loki LogQL.](https://grafana.com/docs/loki/latest/logql/) 

## Konteks log
<a name="loki-log-context"></a>

 Saat menggunakan ekspresi penelusuran seperti yang dijelaskan di atas, Anda sekarang memiliki kemampuan untuk mengambil konteks seputar hasil yang difilter. Dengan memilih `Show Context` tautan pada baris yang difilter, Anda akan dapat menyelidiki pesan log yang datang sebelum dan sesudah pesan log yang Anda minati. 

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

 Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. 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). 

## Anotasi
<a name="loki-annotations"></a>

 Anda dapat menggunakan kueri Loki non-metrik apa pun sebagai sumber anotasi. Konten log akan digunakan sebagai teks anotasi dan label aliran log Anda sebagai tag, jadi tidak perlu pemetaan tambahan. 

# Connect ke sumber data Microsoft SQL Server
<a name="using-microsoft-sql-server-in-AMG"></a>

 Gunakan sumber data Microsoft SQL Server (MSSQL) untuk menanyakan dan memvisualisasikan data dari Microsoft SQL Server 2005 atau yang lebih baru, termasuk Microsoft Azure SQL Database. 

**penting**  
Grafana versi 8.0 mengubah struktur data yang mendasari untuk frame data untuk Microsoft SQL Server, Postgres, dan MySQL. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana.  
Untuk membuat visualisasi Anda berfungsi seperti sebelumnya, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.

## Menambahkan sumber data
<a name="mssql-adding-the-data-source"></a>

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

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

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

1.  Pilih **Microsoft SQL Server** dari **Type** daftar dropdown. 

### Opsi sumber data
<a name="mssql-data-source-options"></a>


|  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.  | 
|  Host  |  IP address/hostname dan port opsional instans MSSQL Anda. Jika port dihilangkan, default 1433 akan digunakan.  | 
|  Database  |  Nama database MSSQL Anda.  | 
|  User  |  Database pengguna login/nama pengguna.  | 
|  Password  |  Kata sandi pengguna basis data. | 
|  Encrypt  |  Opsi ini menentukan apakah atau sejauh mana TCP/IP koneksi SSL yang aman akan dinegosiasikan dengan server, default (falseGrafana v5.4 \$1).  | 
|  Max open  |  Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1).  | 
|  Max idle  |  Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1).  | 
|  Max lifetime  |  Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam.  | 

### Interval waktu min
<a name="mssql-min-time-interval"></a>

 Batas bawah untuk `$_interval` `$_interval_ms` variabel. Disarankan untuk diatur untuk menulis frekuensi, misalnya `1m` jika data Anda ditulis setiap menit. Opsi ini juga dapat berada overridden/configured di panel dasbor di bawah opsi sumber data. Nilai ini **harus** diformat sebagai angka diikuti oleh pengenal waktu yang valid; misalnya, `1m` (1 menit) atau `30s` (30 detik). Pengidentifikasi waktu berikut didukung.


|  Pengidentifikasi  |  Deskripsi  | 
| --- | --- | 
|  y  |  Tahun  | 
|  M  |  Bulan  | 
|  w  |  Minggu  | 
|  d  |  Hari  | 
|  h  |  Jam  | 
|  m  |  Menit  | 
|  s  |  Detik  | 
|  ms  |  Milidetik  | 

### Izin pengguna basis data
<a name="mssql-database-user-permissions-important"></a>

**penting**  
 Pengguna database yang Anda tentukan saat Anda menambahkan sumber data seharusnya hanya diberikan izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `DELETE FROM user;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna MSSQL tertentu dengan izin terbatas. 

 Kode contoh berikut menunjukkan pembuatan pengguna MSSQL tertentu dengan izin terbatas. 

```
 CREATE USER grafanareader WITH PASSWORD 'password'
 GRANT SELECT ON dbo.YourTable3 TO grafanareader
```

 Pastikan bahwa pengguna tidak mendapatkan izin yang tidak diinginkan dari peran publik. 

### Masalah yang diketahui
<a name="mssql-known-issues"></a>

 Jika Anda menggunakan versi Microsoft SQL Server yang lebih lama seperti 2008 dan 2008R2, Anda mungkin perlu menonaktifkan enkripsi agar dapat terhubung. Jika memungkinkan, kami sarankan Anda untuk menggunakan paket layanan terbaru yang tersedia untuk kompatibilitas optimal. 

## Editor kueri
<a name="mssql-query-editor"></a>

 Anda akan menemukan editor kueri MSSQL di tab metrik dalam mode edit grafik, Singlestat, atau panel tabel. Anda masuk ke mode edit dengan memilih judul panel dan kemudian memilih Edit. Editor memungkinkan Anda untuk menentukan query SQL untuk memilih data yang akan divisualisasikan. 

1.  Pilih *Format as* `Time series` (untuk digunakan dalam panel Grafik atau Singlestat antara lain) atau `Table` (untuk digunakan di panel Tabel antara lain). 

1.  Ini adalah editor aktual tempat Anda menulis kueri SQL Anda. 

1.  Tampilkan bagian bantuan untuk MSSQL di bawah editor kueri. 

1.  Tampilkan query SQL yang dijalankan. Akan tersedia terlebih dahulu setelah kueri yang berhasil dijalankan. 

1.  Tambahkan kueri tambahan di mana editor kueri tambahan akan ditampilkan. 

## Makro
<a name="mssql-macros"></a>

 Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro. 


|  Contoh makro  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1\$1time(dateColumn)  |  Akan diganti dengan ekspresi untuk mengganti nama kolom menjadi waktu. Misalnya, DateColumn sebagai waktu. | 
|  \$1\$1\$1timeEpoch(dateColumn)  |  Akan diganti dengan ekspresi untuk mengonversi tipe kolom DATETIME ke stempel waktu Unix dan mengganti namanya menjadi waktu. Misalnya, DATEDIFF (kedua, “1970-01-01", DateColumn) sebagai waktu.  | 
|  \$1\$1\$1timeFilter(dateColumn)  |  Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn ANTARA “2017-04-21T 05:01:17 Z” DAN “2017-04-21T 05:06:17 Z”.  | 
|  \$1\$1\$1timeFrom()  |  Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, “2017-04-21T 05:01:17 Z”.  | 
|  \$1\$1\$1timeTo()  |  Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, “2017-04-21T 05:06:17 Z”.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m'[, fillvalue])  |  Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Memberikan fillValue NULL atau nilai mengambang akan secara otomatis mengisi seri kosong dalam rentang waktu dengan nilai itu. Misalnya, CAST (ROUND (DATEDIFF (second, “1970-01-01", time\$1column) /300.0, 0) sebagai bigint) \$1300.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', 0)  |  Sama seperti sebelumnya tetapi dengan parameter isian sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', NULL)  |  Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', previous)  |  Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1).  | 

 Editor kueri memiliki tautan **SQL yang Dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan. 

## Kueri tabel
<a name="mssql-table-queries"></a>

 Jika opsi kueri diatur ke, **Format sebagai** **Tabel** maka pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda. 

 Kode contoh berikut menunjukkan tabel database. 

```
CREATE TABLE [event] (
  time_sec bigint,
  description nvarchar(100),
  tags nvarchar(100),
)
```

```
CREATE TABLE [mssql_types] (
  c_bit bit, c_tinyint tinyint, c_smallint smallint, c_int int, c_bigint bigint, c_money money, c_smallmoney smallmoney, c_numeric numeric(10,5),
  c_real real, c_decimal decimal(10,2), c_float float,
  c_char char(10), c_varchar varchar(10), c_text text,
  c_nchar nchar(12), c_nvarchar nvarchar(12), c_ntext ntext,
  c_datetime datetime,  c_datetime2 datetime2, c_smalldatetime smalldatetime, c_date date, c_time time, c_datetimeoffset datetimeoffset
)

INSERT INTO [mssql_types]
SELECT
  1, 5, 20020, 980300, 1420070400, '$20000.15', '£2.15', 12345.12,
  1.11, 2.22, 3.33,
  'char10', 'varchar10', 'text',
  N'☺nchar12☺', N'☺nvarchar12☺', N'☺text☺',
  GETDATE(), CAST(GETDATE() AS DATETIME2), CAST(GETDATE() AS SMALLDATETIME), CAST(GETDATE() AS DATE), CAST(GETDATE() AS TIME), SWITCHOFFSET(CAST(GETDATE() AS DATETIMEOFFSET), '-07:00')
```

 Contoh kode berikut menunjukkan query. 

```
SELECT * FROM [mssql_types]
```

 Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `AS` SQL biasa, seperti yang ditunjukkan dalam kode contoh berikut. 

```
SELECT
  c_bit as [column1], c_tinyint as [column2]
FROM
  [mssql_types]
```

 Panel tabel yang dihasilkan: 

## Pertanyaan deret waktu
<a name="mssql-time-series-queries"></a>

 Jika Anda menyetel **Format sebagai** **deret Waktu**, untuk digunakan dalam panel Grafik misalnya, kueri harus memiliki kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik apa pun yang mewakili epoch Unix dalam hitungan detik. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Jika Anda menghilangkan `metric` kolom, nama kolom nilai akan menjadi nama metrik. Anda dapat memilih beberapa kolom nilai, masing-masing akan memiliki namanya sebagai metrik. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama `metric` maka kolom ini digunakan sebagai awalan untuk nama seri. 

 Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu. 

 Kode contoh berikut menunjukkan tabel database. 

```
CREATE TABLE [event] (
  time_sec bigint,
  description nvarchar(100),
  tags nvarchar(100),
)
```

```
CREATE TABLE metric_values (
  time datetime,
  measurement nvarchar(100),
  valueOne int,
  valueTwo int,
)

INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric A', 62, 6)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric B', 49, 11)
...
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric A', 14, 25)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric B', 48, 10)
```

 Kode contoh berikut menunjukkan satu `value` dan satu `metric` kolom. 

```
SELECT
  time,
  valueOne,
  measurement as metric
FROM
  metric_values
WHERE
  $__timeFilter(time)
ORDER BY 1
```

 Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time` 

 Kode contoh berikut menunjukkan beberapa `value` kolom. 

```
SELECT
  time,
  valueOne,
  valueTwo
FROM
  metric_values
WHERE
  $__timeFilter(time)
ORDER BY 1
```

 Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time` 

 Kode contoh berikut menunjukkan menggunakan makro \$1\$1\$1TimeGroup. 

```
SELECT
  $__timeGroup(time, '3m') as time,
  measurement as metric,
  avg(valueOne)
FROM
  metric_values
WHERE
  $__timeFilter(time)
GROUP BY
  $__timeGroup(time, '3m'),
  measurement
ORDER BY 1
```

 Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time` Setiap dua seri yang tidak memiliki nilai dalam jendela tiga menit akan membuat garis di antara dua garis tersebut. Anda akan melihat bahwa grafik di sebelah kanan tidak pernah turun ke nol. 

 Kode contoh berikut menunjukkan menggunakan makro \$1\$1\$1TimeGroup dengan parameter fill diatur ke nol. 

```
SELECT
  $__timeGroup(time, '3m', 0) as time,
  measurement as metric,
  sum(valueTwo)
FROM
  metric_values
WHERE
  $__timeFilter(time)
GROUP BY
  $__timeGroup(time, '3m'),
  measurement
ORDER BY 1
```

 Ketika kueri ini digunakan dalam panel grafik, hasilnya adalah dua seri bernama `Metric A` dan `Metric B` dengan jumlah `valueTwo` diplot di atas. `time` Setiap seri yang tidak memiliki nilai dalam jendela 3 menit akan memiliki nilai nol yang akan Anda lihat dirender dalam grafik di sebelah kanan. 

## Templating
<a name="mssql-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="mssql-query-variable"></a>

 Jika Anda menambahkan variabel templat dari jenisnya`Query`, Anda dapat menulis kueri MSSQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun. 

 Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. 

```
SELECT hostname FROM host
```

 Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`. 

```
SELECT [host].[hostname], [other_host].[hostname2] FROM host JOIN other_host ON [host].[city] = [other_host].[city]
```

 Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik maka nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai yang memungkinkan Anda memiliki nama ramah sebagai teks dan id sebagai nilainya. Contoh query dengan `hostname` sebagai teks dan `id` sebagai nilai: 

```
SELECT hostname __text, id __value FROM host
```

 Anda juga dapat membuat variabel bersarang. Misalnya, jika Anda memiliki variabel lain bernama`region`. Kemudian Anda dapat meminta variabel host hanya menampilkan host dari wilayah yang dipilih saat ini dengan kueri seperti ini (jika `region` adalah variabel multi-nilai, maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai). 

```
SELECT hostname FROM host WHERE region IN ($region)
```

### Menggunakan variabel dalam kueri
<a name="mssql-using-variables-in-queries"></a>

**catatan**  
 Nilai variabel template hanya dikutip ketika variabel template adalah`multi-value`. 

 Jika variabel adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai. 

 Ada dua sintaks: 

 `$<varname>`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  atimestamp time,
  aint value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp
```

 `[[varname]]`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp
```

#### Mematikan kutipan untuk variabel multi-nilai
<a name="mssql-disabling-quoting-for-multi-value-variables"></a>

 Grafana secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya, jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel. 

 `${servers:csv}` 

 Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Template dan variabel](templates-and-variables.md). 

## Anotasi
<a name="mssql-annotations"></a>

 Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md). 

 **Kolom:** 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  time  |  Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  timeend  |  Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  text  |  Bidang deskripsi acara.  | 
|  tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma.  | 

 Kode contoh berikut menunjukkan tabel database. 

```
CREATE TABLE [events] (
  time_sec bigint,
  description nvarchar(100),
  tags nvarchar(100),
)
```

 Kami juga menggunakan tabel database yang didefinisikan dalam[Pertanyaan deret waktu](#mssql-time-series-queries). 

 Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch. 

```
SELECT
  time_sec as time,
  description as [text],
  tags
FROM
  [events]
WHERE
  $__unixEpochFilter(time_sec)
ORDER BY 1
```

 Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch. 

```
SELECT
  time_sec as time,
  time_end_sec as timeend,
  description as [text],
  tags
FROM
  [events]
WHERE
  $__unixEpochFilter(time_sec)
ORDER BY 1
```

 Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli. 

```
SELECT
  time,
  measurement as text,
  convert(varchar, valueOne) + ',' + convert(varchar, valueTwo) as tags
FROM
  metric_values
WHERE
  $__timeFilter(time_column)
ORDER BY 1
```

## Dukungan prosedur tersimpan
<a name="stored-procedure-support"></a>

 Prosedur yang disimpan telah diverifikasi untuk bekerja. Namun, mungkin ada kasus tepi di mana itu tidak akan berfungsi seperti yang Anda harapkan. Prosedur tersimpan harus didukung dalam tabel, deret waktu, dan kueri anotasi selama Anda menggunakan penamaan kolom yang sama dan mengembalikan data dalam format yang sama seperti yang dijelaskan sebelumnya di bagian masing-masing. 

 Fungsi makro tidak akan berfungsi di dalam prosedur yang disimpan. 

### Contoh
<a name="mssql-examples"></a>

 Untuk contoh berikut, tabel database didefinisikan dalam Query deret Time. Katakanlah Anda ingin memvisualisasikan empat seri dalam panel grafik, seperti semua kombinasi kolom`valueOne`, `valueTwo` dan`measurement`. Panel grafik di sebelah kanan memvisualisasikan apa yang ingin kita capai. Untuk mengatasi ini, Anda harus menggunakan dua kueri: 

 Kode contoh berikut menunjukkan query pertama. 

```
SELECT
  $__timeGroup(time, '5m') as time,
  measurement + ' - value one' as metric,
  avg(valueOne) as valueOne
FROM
  metric_values
WHERE
  $__timeFilter(time)
GROUP BY
  $__timeGroup(time, '5m'),
  measurement
ORDER BY 1
```

 Kode contoh berikut menunjukkan query kedua. 

```
SELECT
  $__timeGroup(time, '5m') as time,
  measurement + ' - value two' as metric,
  avg(valueTwo) as valueTwo
FROM
  metric_values
GROUP BY
  $__timeGroup(time, '5m'),
  measurement
ORDER BY 1
```

#### Prosedur tersimpan menggunakan waktu dalam format epoch
<a name="mssql-stored-procedure-using-time-in-epoch-format"></a>

 Anda dapat menentukan prosedur tersimpan yang akan mengembalikan semua data yang Anda butuhkan untuk membuat empat seri dalam panel grafik seperti di atas. Dalam hal ini, prosedur yang disimpan menerima dua parameter, `@from` dan`@to`, dari tipe `int` data, yang harus berupa rentang waktu (dari-ke) dalam format epoch yang akan digunakan untuk menyaring data untuk kembali dari prosedur yang disimpan. 

 Ini meniru ekspresi `$__timeGroup(time, '5m')` dalam pilih dan kelompokkan, dan itulah sebabnya banyak ekspresi panjang diperlukan. Ini dapat diekstraksi ke fungsi MSSQL, jika diinginkan.

```
CREATE PROCEDURE sp_test_epoch(
  @from int,
  @to   int
)   AS
BEGIN
  SELECT
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
    measurement + ' - value one' as metric,
    avg(valueOne) as value
  FROM
    metric_values
  WHERE
    time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
  GROUP BY
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
    measurement
  UNION ALL
  SELECT
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
    measurement + ' - value two' as metric,
    avg(valueTwo) as value
  FROM
    metric_values
  WHERE
    time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
  GROUP BY
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
    measurement
  ORDER BY 1
END
```

 Kemudian Anda dapat menggunakan kueri berikut untuk panel grafik Anda. 

```
DECLARE
  @from int = $__unixEpochFrom(),
  @to int = $__unixEpochTo()

EXEC dbo.sp_test_epoch @from, @to
```

#### Prosedur tersimpan menggunakan waktu dalam format datetime
<a name="mssql-stored-procedure-using-time-in-datetime-format"></a>

 Anda dapat menentukan prosedur tersimpan yang akan mengembalikan semua data yang Anda butuhkan untuk membuat empat seri dalam panel grafik seperti di atas. Dalam hal ini, prosedur yang disimpan menerima dua parameter, `@from` dan`@to`, dari tipe `datetime` data, yang harus berupa rentang waktu (dari-ke) yang akan digunakan untuk memfilter data untuk kembali dari prosedur yang disimpan. 

 Ini meniru ekspresi `$__timeGroup(time, '5m')` dalam pilih dan kelompokkan, dan itulah sebabnya banyak ekspresi panjang diperlukan. Ini dapat diekstraksi ke fungsi MSSQL, jika diinginkan. 

```
CREATE PROCEDURE sp_test_datetime(
  @from datetime,
  @to   datetime
)   AS
BEGIN
  SELECT
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
    measurement + ' - value one' as metric,
    avg(valueOne) as value
  FROM
    metric_values
  WHERE
    time >= @from AND time <= @to
  GROUP BY
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
    measurement
  UNION ALL
  SELECT
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
    measurement + ' - value two' as metric,
    avg(valueTwo) as value
  FROM
    metric_values
  WHERE
    time >= @from AND time <= @to
  GROUP BY
    cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
    measurement
  ORDER BY 1
END
```

 Kemudian Anda dapat menggunakan kueri berikut untuk panel grafik Anda. 

```
DECLARE
  @from datetime = $__timeFrom(),
  @to datetime = $__timeTo()

EXEC dbo.sp_test_datetime @from, @to
```

## Peringatan
<a name="mssql-alerting"></a>

 Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan. 

# Connect ke sumber data MySQL
<a name="using-mysql-in-AMG"></a>

 Tambahkan sumber data MySQL untuk dapat menanyakan dan memvisualisasikan data dari database yang kompatibel dengan MySQL. 

**penting**  
Grafana versi 8.0 mengubah struktur data yang mendasari untuk frame data untuk sumber data MySQL, Postgres, dan Microsoft SQL Server. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana.  
Untuk membuat visualisasi Anda berfungsi seperti sebelumnya, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.

## Menambahkan sumber data
<a name="mysql-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 bernama **Sumber Data**. 

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

1.  Pilih **MySQL** dari daftar dropdown Type**.** 

### Opsi sumber data
<a name="mysql-data-source-options"></a>


|  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.  | 
|  Host  |  IP address/hostname dan port opsional dari instance MySQL Anda.  | 
|  Database  |  Nama database MySQL Anda.  | 
|  User  |  Login/nama pengguna database pengguna.  | 
|  Password  |  Kata sandi pengguna basis data.  | 
|  Max open  |  Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1).  | 
|  Max idle  |  Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1).  | 
|  Max lifetime  |  Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam. Ini harus selalu lebih rendah dari [wait\$1timeout](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_wait_timeout) yang dikonfigurasi di MySQL (Grafana v5.4\$1).  | 

### Interval waktu min
<a name="mysql-min-time-interval"></a>

 Batas bawah untuk `$_interval` `$_interval_ms` variabel. Disarankan untuk diatur untuk menulis frekuensi, misalnya `1m` jika data Anda ditulis setiap menit. Opsi ini juga dapat berada overridden/configured di panel dasbor di bawah opsi sumber data. Nilai ini **harus** diformat sebagai angka diikuti oleh pengidentifikasi waktu yang valid; misalnya, `1m` (1 menit) atau `30s` (30 detik). Pengidentifikasi waktu berikut didukung. 


|  Pengidentifikasi  |  Deskripsi  | 
| --- | --- | 
|  y  |  Tahun  | 
|  M  |  Bulan  | 
|  w  |  Minggu  | 
|  d  |  Hari  | 
|  h  |  Jam  | 
|  m  |  Menit  | 
|  s  |  Detik  | 
|  ms  |  Milidetik  | 

### Izin pengguna basis data
<a name="database-user-permissions-important"></a>

**penting**  
 Pengguna database yang Anda tentukan saat Anda menambahkan sumber data harus diberikan hanya izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `USE otherdb;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna MySQL tertentu dengan izin terbatas.

 Contoh kode berikut menunjukkan membuat pengguna MySQL tertentu dengan izin terbatas.

```
 CREATE USER 'grafanaReader' IDENTIFIED BY 'password';
 GRANT SELECT ON mydatabase.mytable TO 'grafanaReader';
```

 Untuk memberikan akses ke lebih banyak database dan tabel, Anda dapat menggunakan karakter wildcard (`*`) sebagai pengganti database atau tabel jika Anda mau. 

## Editor kueri
<a name="mysql-query-editor"></a>

 Anda menemukan editor kueri MySQL di tab metrik dalam mode edit panel. Anda masuk ke mode edit dengan memilih judul panel, lalu **Edit**. 

 Editor kueri memiliki tautan **SQL yang dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan. 

### Pilih tabel, kolom waktu, dan kolom metrik (DARI)
<a name="select-table-time-column-and-metric-column-from"></a>

 Saat Anda memasuki mode edit untuk pertama kalinya atau menambahkan kueri baru, Grafana akan mencoba mengisi ulang pembuat kueri dengan tabel pertama yang memiliki kolom stempel waktu dan kolom numerik. 

 Di bidang FROM, Grafana akan menyarankan tabel yang ada di database yang dikonfigurasi. Untuk memilih tabel atau tampilan di database lain yang dapat diakses oleh pengguna database Anda, Anda dapat memasukkan nama yang memenuhi syarat secara manual (database.table) seperti. `otherDb.metrics` 

 Kolom kolom Waktu mengacu pada nama kolom yang memegang nilai waktu Anda. Memilih nilai untuk bidang kolom Metrik adalah opsional. Jika nilai dipilih, bidang kolom Metrik akan digunakan sebagai nama seri. 

 Saran kolom metrik hanya akan berisi kolom dengan tipe data teks (teks, tinytext, mediumtext, longtext, varchar, char). Jika Anda ingin menggunakan kolom dengan tipe data yang berbeda sebagai kolom metrik, Anda dapat memasukkan nama kolom dengan pemeran:`CAST(numericColumn as CHAR)`. Anda juga dapat memasukkan ekspresi SQL arbitrer di bidang kolom metrik yang mengevaluasi tipe data teks seperti. `CONCAT(column1, " ", CAST(numericColumn as CHAR))`

### Kolom dan fungsi agregasi (SELECT)
<a name="columns-and-aggregation-functions-select"></a>

 Di `SELECT` baris, Anda dapat menentukan kolom dan fungsi apa yang ingin Anda gunakan. Di kolom kolom, Anda dapat menulis ekspresi arbitrer alih-alih nama kolom seperti`column1 * column2 / column3`. 

 Jika Anda menggunakan fungsi agregat, Anda harus mengelompokkan set hasil Anda. Editor akan secara otomatis menambahkan `GROUP BY time` jika Anda menambahkan fungsi agregat. 

 Anda dapat menambahkan kolom nilai lebih lanjut dengan memilih tombol plus dan memilih `Column` dari menu. Beberapa kolom nilai akan diplot sebagai seri terpisah di panel grafik. 

### Data penyaringan (WHERE)
<a name="mysql-filter-data-where"></a>

 Untuk menambahkan filter, pilih ikon plus di sebelah kanan `WHERE` kondisi. Anda dapat menghapus filter dengan memilih pada filter dan memilih`Remove`. Filter untuk rentang waktu yang dipilih saat ini secara otomatis ditambahkan ke kueri baru.

### Grup Oleh
<a name="mysql-group-by"></a>

 Untuk mengelompokkan berdasarkan waktu atau kolom lainnya, pilih ikon plus di akhir baris GROUP BY. Daftar tarik-turun saran hanya akan menampilkan kolom teks dari tabel yang Anda pilih saat ini tetapi Anda dapat memasukkan kolom apa pun secara manual. Anda dapat menghapus grup dengan memilih item dan kemudian memilih`Remove`. 

 Jika Anda menambahkan pengelompokan apa pun, semua kolom yang dipilih harus memiliki fungsi agregat yang diterapkan. Pembuat kueri akan secara otomatis menambahkan fungsi agregat ke semua kolom tanpa fungsi agregat saat Anda menambahkan pengelompokan. 

#### Pengisian celah
<a name="mysql-gap-filling"></a>

 Grafana dapat mengisi nilai yang hilang saat Anda mengelompokkan berdasarkan waktu. Fungsi waktu menerima dua argumen. Argumen pertama adalah jendela waktu yang ingin Anda kelompokkan, dan argumen kedua adalah nilai yang Anda inginkan Grafana untuk mengisi item yang hilang. 

### Mode editor teks (mentah)
<a name="mysql-text-editor-mode-raw"></a>

 Anda dapat beralih ke mode editor kueri mentah dengan memilih ikon hamburger dan memilih **mode Switch editor** atau dengan memilih **Edit SQL** di bawah kueri. 

**catatan**  
 Jika Anda menggunakan editor kueri mentah, pastikan kueri Anda setidaknya memiliki `ORDER BY time` dan filter pada rentang waktu yang dikembalikan. 

## Makro
<a name="mysql-macros"></a>

 Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro. 


|  Contoh makro  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1\$1time(dateColumn)  |  Akan diganti dengan ekspresi untuk dikonversi ke stempel waktu UNIX dan mengganti nama kolom menjaditime\$1sec; misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. | 
|  \$1\$1\$1timeEpoch(dateColumn)  |  Akan diganti dengan ekspresi untuk dikonversi ke stempel waktu UNIX dan mengganti nama kolom menjaditime\$1sec; misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec.  | 
|  \$1\$1\$1timeFilter(dateColumn)  |  Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn BETWEEN FROM\$1UNIXTIME (1494410783) DAN FROM\$1UNIXTIME (1494410983). | 
|  \$1\$1\$1timeFrom()  |  Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410783).  | 
|  \$1\$1\$1timeTo()  |  Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410983).  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m')  |  Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Misalnya, cast (cast (UNIX\$1TIMESTAMP (DateColumn)/(300) sebagai ditandatangani) 300 sebagai ditandatangani), \$1  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', 0)  |  Sama seperti baris sebelumnya, tetapi dengan parameter isian sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', NULL)  |  Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', previous)  |  Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1).  | 
|  \$1\$1\$1timeGroupAlias(dateColumn,'5m')  |  Akan diganti identik dengan \$1\$1\$1timeGroup tetapi dengan alias kolom tambahan (hanya tersedia di Grafana 5.3\$1).  | 
| \$1\$1\$1unixEpochFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix. Misalnya, dateColumn > 1494410783 AND dateColumn < 1494497183. | 
| \$1\$1\$1unixEpochFrom() | Akan diganti dengan dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, 1494410783. | 
| \$1\$1\$1unixEpochTo() | Akan diganti dengan akhir pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, 1494497183. | 
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu nanodetik. Misalnya, dateColumn > 1494410783152415214 AND dateColumn < 1494497183142514872. | 
| \$1\$1\$1unixEpochNanoFrom() | Akan digantikan oleh dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, 1494410783152415214. | 
| \$1\$1\$1unixEpochNanoTo() | Akan diganti pada akhir pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, 1494497183142514872. | 
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | Sama seperti \$1\$1\$1timeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix (hanya tersedia di Grafana 5.3\$1). | 
| \$1\$1\$1unixEpochGroupAlias(dateColumn,"5m", [fillmode])` | Sama seperti di atas tetapi juga menambahkan alias kolom (hanya tersedia di Grafana 5.3\$1). | 

 Editor kueri memiliki tautan **SQL yang Dihasilkan** yang muncul setelah kueri berjalan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan. 

## Kueri tabel
<a name="mysql-table-queries"></a>

 Jika opsi **Format sebagai** kueri diatur ke **Tabel**, pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda. 

 Kode berikut menunjukkan contoh query. 

```
SELECT
  title as 'Title',
  user.login as 'Created By' ,
  dashboard.created as 'Created On'
 FROM dashboard
INNER JOIN user on user.id = dashboard.created_by
WHERE $__timeFilter(dashboard.created)
```

 Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `as` SQL biasa. 

## Pertanyaan deret waktu
<a name="mysql-time-series-queries"></a>

 Jika Anda menetapkan **Format sebagai** **deret Waktu**, untuk digunakan dalam panel grafik misalnya, kueri harus mengembalikan kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik yang mewakili epoch Unix. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama`metric`, kolom ini digunakan sebagai awalan untuk nama seri (hanya tersedia di Grafana 5.3\$1).

 Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu. 

 Contoh kode berikut menunjukkan `metric` kolom. 

```
SELECT
  $__timeGroup(time_date_time,'5m'),
  min(value_double),
  'min' as metric
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```

 Contoh kode berikut menunjukkan menggunakan parameter fill di \$1\$1\$1timeGroup makro untuk mengkonversi nilai null menjadi nol sebagai gantinya. 

```
SELECT
  $__timeGroup(createdAt,'5m',0),
  sum(value_double) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter(createdAt)
GROUP BY time, measurement
ORDER BY time
```

 Contoh kode berikut menunjukkan beberapa kolom. 

```
SELECT
  $__timeGroup(time_date_time,'5m'),
  min(value_double) as min_value,
  max(value_double) as max_value
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```

Tidak ada dukungan untuk grup dinamis berdasarkan waktu berdasarkan rentang waktu dan lebar panel.

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

 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, lihat[Template](templates-and-variables.md#templates). 

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

 Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri MySQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun. 

 Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. 

```
SELECT hostname FROM my_host
```

 Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`. 

```
SELECT my_host.hostname, my_other_host.hostname2 FROM my_host JOIN my_other_host ON my_host.city = my_other_host.city
```

 Untuk menggunakan makro yang bergantung pada rentang waktu seperti `$__timeFilter(column)` dalam kueri Anda, mode penyegaran variabel template harus disetel ke *On Time Range Change*. 

```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```

 Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik, nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai sehingga Anda dapat memiliki nama ramah sebagai teks dan ID sebagai nilainya.

Contoh kode berikut menunjukkan query dengan `hostname` sebagai teks dan `id` sebagai nilai. 

```
SELECT hostname AS __text, id AS __value FROM my_host
```

 Anda juga dapat membuat variabel bersarang. Misalnya, jika Anda memiliki variabel lain bernama`region`. Kemudian Anda dapat meminta variabel host hanya menampilkan host dari wilayah yang dipilih saat ini dengan kueri seperti ini (jika `region` adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai). 

```
SELECT hostname FROM my_host  WHERE region IN($region)
```

#### Menggunakan `__searchFilter` untuk memfilter hasil dalam Variabel Kueri
<a name="using-__searchfilter-to-filter-results-in-query-variable"></a>

 Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan jenis pengguna di kotak pilih dropdown. Ketika tidak ada yang dimasukkan oleh pengguna, nilai default untuk `__searchFilter` adalah`%`. 

**catatan**  
 Penting bahwa Anda mengelilingi `__searchFilter` ekspresi dengan tanda kutip karena Grafana tidak melakukan ini untuk Anda. 

 Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `hostname` sementara pengguna mengetik di kotak pilih dropdown. 

```
SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'
```

### Menggunakan variabel dalam kueri
<a name="using-variables-in-queries-2"></a>

 Dari Grafana 4.3.0 hingga 4.6.0, variabel template selalu dikutip secara otomatis sehingga jika itu adalah nilai string jangan membungkusnya dalam tanda kutip di klausa where. 

 Dari Grafana 4.7.0, nilai variabel template hanya dikutip jika variabel template adalah a. `multi-value` 

 Jika variabel adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai. 

 Ada dua sintaks: 

 `$<varname>`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  UNIX_TIMESTAMP(atimestamp) as time,
  aint as value,
  avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```

 `[[varname]]`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  UNIX_TIMESTAMP(atimestamp) as time,
  aint as value,
  avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```

#### Mematikan kutipan untuk variabel multi-nilai
<a name="disabling-quoting-for-multi-value-variables"></a>

 Grafana secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya: jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel. 

 `${servers:csv}` 

 Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Opsi format variabel lanjutan](templates-and-variables.md#advanced-variable-format-options). 

## Anotasi
<a name="mysql-annotations"></a>

 Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat . 

 Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch. 

```
SELECT
  epoch_time as time,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)
```

Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch. 

**catatan**  
 Hanya tersedia di Grafana v6.6\$1. 

```
SELECT
  epoch_time as time,
  epoch_timeend as timeend,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)
```

 Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli. 

```
SELECT
  native_date_time as time,
  metric1 as text,
  CONCAT(tag1, ',', tag2) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)
```


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  time  |  Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  timeend  |  Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  text  |  Bidang deskripsi acara.  | 
|  tags  |  Nama bidang opsional yang akan digunakan untuk tag peristiwa sebagai string yang dipisahkan koma.  | 

## Peringatan
<a name="mysql-alerting"></a>

 Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan. 

# Connect ke sumber OpenSearch data
<a name="using-opensearch-in-AMG"></a>

**catatan**  
Di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

Dengan Grafana Terkelola Amazon, Anda dapat menambahkan sumber terbuka [OpenSearch](https://opensearch.org/docs/)(atau Elasticsearch lama) sebagai sumber data. Anda dapat melakukan banyak jenis OpenSearch kueri sederhana atau kompleks untuk memvisualisasikan log atau metrik yang disimpan. OpenSearch Anda juga dapat membuat anotasi grafik Anda dengan peristiwa log yang disimpan di. OpenSearch

## Tambahkan OpenSearch sebagai sumber data
<a name="opensearch-adding-the-data-source"></a>

**catatan**  
Untuk dapat menambahkan sumber OpenSearch data, Anda perlu menambahkan akun Grafana IAM Anda ke peran ALL\$1ACCESS dan SECURITY\$1MANAGER.

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

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

1.  Pilih **OpenSearch**dari daftar dropdown **Type**. 

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 


|  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 OpenSearch server Anda.  | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana. Browser = URL harus dapat diakses dari browser.  | 

 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)
<a name="opensearch-server-access-mode-default"></a>

 Semua permintaan dibuat dari browser ke backend atau server 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 backend atau server Grafana. 

### Akses browser (langsung)
<a name="opensearch-browser-direct-access"></a>

 Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber OpenSearch data. 

### Pengaturan indeks
<a name="opensearch-index-settings"></a>

 Di sini Anda dapat menentukan default untuk `time field` dan menentukan nama OpenSearch indeks Anda. Anda dapat menggunakan pola waktu untuk nama indeks atau karakter wildcard. 

### OpenSearch/Versi Elasticsearch
<a name="opensearch-version"></a>

Tentukan versi Elasticsearch OpenSearch atau lama Anda di menu tarik-turun versi. Versi ini penting karena ada perbedaan dalam bagaimana kueri disusun untuk setiap versi. Saat ini, Grafana mendukung OpenSearch 1.0.x. Versi Elasticsearch yang didukung adalah`2.0+`,,`5.0+`, `5.6+``6.0+`, dan. `7.0+` Nilai `5.6+` berarti versi 5.6 atau lebih tinggi, tetapi lebih rendah dari 6.0. Nilai `6.0+` berarti versi 6.0 atau lebih tinggi, tetapi lebih rendah dari 7.0. Akhirnya, `7.0+` berarti versi 7.0 atau lebih tinggi, tetapi lebih rendah dari 8.0.

### Interval waktu min
<a name="opensearch-min-time-interval"></a>

 Batas bawah untuk grup auto berdasarkan interval waktu. Disarankan untuk diatur untuk menulis frekuensi; misalnya, `1m` jika data Anda ditulis setiap menit. Opsi ini juga dapat berada overridden/configured di panel dasbor di bawah opsi sumber data. Nilai ini **harus** diformat sebagai angka diikuti oleh pengidentifikasi waktu yang valid; misalnya, `1m` (1 menit) atau `30s` (30 detik). Pengidentifikasi waktu berikut didukung. 


|  Pengidentifikasi  |  Deskripsi  | 
| --- | --- | 
|  y  |  Tahun  | 
|  M  |  Bulan  | 
|  w  |  Minggu  | 
|  d  |  Hari  | 
|  h  |  Jam  | 
|  m  |  Menit  | 
|  s  |  Detik  | 
|  ms  |  Milidetik  | 

### Beberapa catatan
<a name="opensearch-logs-beta"></a>

Dua parameter, `Message field name` dan`Level field name`, secara opsional dapat dikonfigurasi dari halaman pengaturan sumber data yang menentukan bidang mana yang akan digunakan untuk pesan log dan tingkat log saat memvisualisasikan log masuk. [Jelajahi](explore.md) 

 Misalnya, jika Anda menggunakan pengaturan default Filebeat untuk mengirimkan log ke OpenSearch, konfigurasi berikut akan berfungsi. 
+  **Nama bidang pesan:** pesan 
+  **Nama bidang level:** fields.level 

### Tautan data
<a name="opensearch-data-links"></a>

 Tautan data membuat tautan dari bidang tertentu yang dapat diakses dalam tampilan log di Jelajahi. 

 Setiap konfigurasi data link terdiri dari yang berikut:
+ **Bidang** - Nama bidang yang digunakan oleh tautan data.
+ **URL/query** - Jika link eksternal, maka masukkan URL link lengkap. Jika tautannya adalah tautan internal, maka input ini berfungsi sebagai kueri untuk sumber data target. Dalam kedua kasus, Anda dapat menginterpolasi nilai dari bidang dengan `${__value.raw }` makro. 
+ **Tautan internal** — Pilih ini jika tautannya internal atau eksternal. Jika tautannya internal, pemilih sumber data memungkinkan Anda memilih sumber data target. Hanya melacak sumber data yang didukung.

## Menggunakan sumber OpenSearch data
<a name="opensearch-use-datasource"></a>

### Editor kueri metrik
<a name="opensearch-metric-query-editor"></a>

 Editor OpenSearch kueri memungkinkan Anda memilih beberapa metrik dan mengelompokkan berdasarkan beberapa istilah atau filter. Gunakan ikon plus dan minus di sebelah kanan add/remove metrik atau kelompokkan berdasarkan klausa. Beberapa metrik dan grup berdasarkan klausa memiliki opsi. Pilih teks opsi untuk memperluas baris untuk melihat dan mengedit metrik atau grup berdasarkan opsi. 

### Penamaan seri dan pola alias
<a name="opensearch-series-naming-and-alias-patterns"></a>

 Anda dapat mengontrol nama untuk deret waktu melalui bidang `Alias` input. 


|  Pola  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1term fieldname\$1\$1  |  Diganti dengan nilai istilah Group By.  | 
|  \$1\$1metric\$1\$1  |  Diganti dengan nama metrik (mis. Rata-rata, Min, Maks). | 
|  \$1\$1field\$1\$1  |  Diganti dengan nama bidang metrik. | 

### Metrik pipa
<a name="opensearch-pipeline-metrics"></a>

*Beberapa agregasi metrik disebut agregasi pipa; misalnya, *Moving* Average dan Derivative.* OpenSearch metrik pipeline memerlukan metrik lain untuk didasarkan. Gunakan ikon mata di sebelah metrik untuk menyembunyikan metrik agar tidak muncul di grafik. Ini berguna untuk metrik yang hanya Anda miliki dalam kueri untuk digunakan dalam metrik pipeline. 

### Templating
<a name="opensearch-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="opensearch-query-variable"></a>

 Sumber OpenSearch data mendukung dua jenis kueri yang dapat Anda gunakan di bidang *Query* variabel *Query*. Kueri ditulis menggunakan string JSON kustom. 


|  Kueri  |  Deskripsi  | 
| --- | --- | 
|  \$1"find": "fields", "type": "keyword"\$1  |  Mengembalikan daftar nama bidang dengan jenis indekskeyword.  | 
|  \$1"find": "terms", "field": "@hostname", "size": 1000\$1  |  Mengembalikan daftar nilai untuk bidang menggunakan istilah agregasi. Kueri akan menggunakan rentang waktu dasbor saat ini sebagai rentang waktu untuk kueri.  | 
|  \$1"find": "terms", "field": "@hostname", "query": '<lucene query>'\$1  |  Mengembalikan daftar nilai untuk bidang menggunakan agregasi istilah dan filter kueri Lucene tertentu. Kueri akan menggunakan rentang waktu dasbor saat ini sebagai rentang waktu untuk kueri.  | 

Ada batas ukuran default 500 pada kueri istilah. Untuk menetapkan batas kustom, atur properti size dalam kueri Anda. Anda dapat menggunakan variabel lain di dalam kueri. Contoh kode berikut menunjukkan definisi query untuk variabel bernama`$host`. 

```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```

Pada contoh sebelumnya, kita menggunakan variabel lain bernama `$source` di dalam definisi query. Setiap kali Anda mengubah, melalui daftar dropdown, nilai `$source` variabel saat ini, itu memulai pembaruan variabel. `$host` Setelah pembaruan, `$host` variabel hanya berisi nama host yang difilter oleh dalam hal ini properti `@source` dokumen. 

Kueri ini secara default mengembalikan hasil dalam urutan istilah (yang kemudian dapat diurutkan menurut abjad atau numerik untuk variabel apa pun). Untuk menghasilkan daftar istilah yang diurutkan berdasarkan jumlah dokumen (daftar nilai TOP-N), tambahkan `orderBy` properti dari. `doc_count` Ini secara otomatis memilih jenis menurun. Menggunakan `asc` with doc\$1count (daftar bawah N) dapat dilakukan dengan pengaturan`order: "asc"`, tetapi tidak disarankan karena meningkatkan kesalahan pada jumlah dokumen. **Untuk menjaga istilah dalam urutan jumlah dokumen, setel daftar dropdown **Sort** variabel ke Dinonaktifkan.** Atau, Anda mungkin masih ingin menggunakan **Alphabetical** untuk mengurutkan ulang mereka. 

```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```

#### Menggunakan variabel dalam kueri
<a name="opensearch-using-variables-in-queries"></a>

 Ada dua sintaks: 
+  `$<varname>`Contoh: @hostname: \$1hostname 
+  `[[varname]]`Contoh: @hostname: [[hostname]] 

 Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis, tetapi tidak memungkinkan Anda untuk menggunakan variabel di tengah kata. Saat opsi *Multi-nilai* atau *Sertakan semua nilai* diaktifkan, Grafana mengubah label dari teks biasa menjadi kondisi yang kompatibel dengan Lucene. 

 Pada contoh sebelumnya, kita memiliki kueri lucene yang memfilter dokumen berdasarkan `@hostname` properti menggunakan variabel bernama. `$hostname` Hal ini juga menggunakan variabel dalam *Terms* group by field input box. Ini memungkinkan Anda menggunakan variabel untuk dengan cepat mengubah cara data dikelompokkan. 

### Anotasi
<a name="opensearch-annotations"></a>

Anotasi memungkinkan Anda untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor atau tampilan Anotasi. Grafana dapat menanyakan OpenSearch indeks apa pun untuk peristiwa anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md). 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Query  |  Anda dapat menyimpan kueri penelusuran kosong atau menentukan kueri Lucene.  | 
|  Time  |  Nama bidang waktu; harus bidang tanggal.  | 
|  Time End  |  Nama opsional bidang akhir waktu harus berupa bidang tanggal. Jika disetel, anotasi akan ditandai sebagai wilayah antara waktu dan akhir waktu.  | 
|  Text  |  Bidang deskripsi acara.  | 
|  Tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa (dapat berupa array atau string CSV).  | 

### Meminta log
<a name="opensearch-querying-logs-beta"></a>

 Menanyakan dan menampilkan data log dari OpenSearch tersedia di Jelajahi. Untuk menampilkan log Anda, pilih sumber OpenSearch data, lalu masukkan kueri Lucene secara opsional. Untuk informasi selengkapnya, lihat [Jelajahi](explore.md). 

#### Kueri log
<a name="opensearch-log-queries"></a>

 Setelah hasilnya dikembalikan, panel log menunjukkan daftar baris log dan bagan batang di mana sumbu x menunjukkan waktu dan sumbu y menunjukkan frekuensi atau hitungan. 

#### Memfilter pesan log
<a name="opensearch-filter-log-messages"></a>

 Secara opsional, masukkan kueri Lucene ke bidang kueri untuk memfilter pesan log. Misalnya, menggunakan pengaturan Filebeat default, Anda harus dapat menggunakan `fields.level:error` hanya menampilkan pesan log kesalahan. 

# Connect ke sumber data OpenTSDB
<a name="using-opentsdb-in-AMG"></a>

 Grafana yang Dikelola Amazon dikirimkan dengan dukungan lanjutan untuk OpenTSDB. 

## Menambahkan sumber data
<a name="opentsdb-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 **OpenTSDB** dari daftar **dropdown Type**. 

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 


|  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 server opentsdb Anda (port default biasanya 4242).  | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana.  | 
|  Version  |  Versi = versi opentsdb, baik <=2.1 atau 2.2.  | 
|  Resolution  |  Metrik dari opentsdb dapat memiliki titik data dengan resolusi kedua atau milidetik.  | 

## Editor kueri
<a name="opentsdb-query-editor"></a>

 Buka grafik dalam mode edit dengan memilih judul. Editor kueri akan berbeda jika sumber data memiliki versi <=2.1 atau = 2.2. Dalam versi sebelumnya, hanya tag yang dapat digunakan untuk kueri OpenTSDB. Tetapi dalam versi yang terakhir, filter serta tag dapat digunakan untuk menanyakan opentsdb. Kebijakan Isi juga diperkenalkan di OpenTSDB 2.2. 

**catatan**  
 Saat menggunakan sumber data OpenTSDB 2.2, pastikan Anda menggunakan Filter atau Tag karena keduanya saling eksklusif. Jika digunakan bersama, mungkin memberi Anda hasil yang aneh. 

### Menggunakan saran pelengkapan otomatis
<a name="auto-complete-suggestions"></a>

 Segera setelah Anda mulai mengetik nama metrik, nama tag, dan nilai tag, Anda akan melihat saran lengkap otomatis yang disorot untuknya. Pelengkapan otomatis hanya berfungsi jika API saran OpenTSDB diaktifkan. 

## Kueri template
<a name="opentsdb-templating-queries"></a>

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

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

 Sumber data OpenTSDB mendukung kueri variabel template. Ini berarti Anda dapat membuat variabel template yang mengambil nilai dari OpenTSDB. Misalnya, nama metrik, nama tag, atau nilai tag. 

 Saat menggunakan OpenTSDB dengan variabel template `query` tipe Anda dapat menggunakan sintaks berikut untuk pencarian. 


|  Kueri  |  Deskripsi  | 
| --- | --- | 
|  metrics(prefix)  |  Mengembalikan nama metrik dengan awalan tertentu (bisa kosong).  | 
|  tag\$1names(cpu)  |  Mengembalikan nama tag (yaitu, kunci) untuk metrik cpu tertentu.  | 
|  tag\$1values(cpu, hostname)  |  Mengembalikan nilai tag untuk cpu metrik dan nama host kunci tag.  | 
|  suggest\$1tagk(prefix)  |  Mengembalikan nama tag (yaitu, kunci) untuk semua metrik dengan awalan tertentu (bisa kosong).  | 
|  suggest\$1tagv(prefix)  |  Mengembalikan nilai tag untuk semua metrik dengan awalan tertentu (bisa kosong).  | 

 Jika Anda tidak melihat variabel template yang diisi di `Preview of values` bagian, Anda harus mengaktifkan `tsd.core.meta.enable_realtime_ts` dalam pengaturan server OpenTSDB. Juga, untuk mengisi metadata data deret waktu yang ada di OpenTSDB, Anda harus berjalan `tsdb uid metasync` di server OpenTSDB. 

### Templating bersarang
<a name="nested-templating"></a>

 Satu variabel template dapat digunakan untuk memfilter nilai tag untuk variabel template lain. Parameter pertama adalah nama metrik, parameter kedua adalah kunci tag yang Anda butuhkan untuk menemukan nilai tag, dan setelah itu semua variabel template dependen lainnya. Beberapa contoh disebutkan di bawah ini untuk membuat kueri template bersarang bekerja dengan sukses. 


|  Kueri  |  Deskripsi  | 
| --- | --- | 
|  tag\$1values(cpu, hostname, env=\$1env)  |  Mengembalikan nilai tag untuk metrik cpu, nilai tag env yang dipilih, dan nama host kunci tag.  | 
|  tag\$1values(cpu, hostname, env=\$1env, region=\$1region)  |  Mengembalikan nilai tag untuk metrik cpu, nilai tag env yang dipilih, nilai tag wilayah yang dipilih, dan nama host kunci tag.  | 

 [Untuk informasi selengkapnya tentang kueri metrik OpenTSDB, lihat dokumentasi OpenTSDB](https://opentsdb.net/docs/build/html/index.html) 

# Connect ke sumber data PostgreSQL
<a name="using-postgresql-in-AMG"></a>

 Anda dapat menggunakan sumber data PostgreSQL untuk menanyakan dan memvisualisasikan data dari database Amazon Aurora PostgreSQL Anda. 

**penting**  
*Grafana versi 8* mengubah struktur data yang mendasari frame data untuk sumber data Postgres, MySQL, dan Microsoft SQL Server. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana. Untuk membuat visualisasi Anda berfungsi seperti sebelum versi 8, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.  
Di *Grafana versi 9*, sumber data PostgreSQL menyiapkan sertifikat root untuk menghubungkan ke database Anda secara berbeda dari versi sebelumnya. Jika Anda memperbarui ruang kerja dari versi 8 ke 9, Anda mungkin perlu mengubah cara Anda terhubung. Untuk informasi selengkapnya, lihat [Memecahkan masalah dengan ruang kerja yang diperbarui](AMG-workspace-version-update-troubleshoot.md).

## Menambahkan sumber data
<a name="postgresql-adding-the-data-source"></a>

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

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

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

1.  **Pilih **PostgreSQL** dari daftar dropdown Type.** 

### Opsi sumber data
<a name="postgresql-data-source-options"></a>


|  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.  | 
|  Host  |  IP address/hostname dan port opsional instance PostgreSQL Anda. Jangan sertakan nama database. String koneksi untuk menghubungkan ke Postgres tidak akan benar dan akan menyebabkan kesalahan.  | 
|  Database  |  Nama database PostgreSQL Anda.  | 
|  User  |  Database pengguna login/nama pengguna. | 
|  Password  |  Kata sandi pengguna basis data  | 
|  SSL Mode  |  Opsi ini menentukan apakah atau dengan prioritas apa TCP/IP koneksi SSL aman akan dinegosiasikan dengan server.  | 
|  Max open  |  Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1).  | 
|  Max idle  |  Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1).  | 
|  Max lifetime  |  Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam (Grafana v5.4\$1).  | 
|  Version  |  Opsi ini menentukan fungsi mana yang tersedia di pembuat kueri (hanya tersedia di Grafana 5.3\$1).  | 
|  TimescaleDB  |  TimescaleDB adalah database deret waktu yang dibangun sebagai ekstensi PostgreSQL. Jika diaktifkan, Grafana akan digunakan time\$1bucket di \$1\$1\$1timeGroup makro dan menampilkan fungsi agregat spesifik TimescaleDB di pembuat kueri (hanya tersedia di Grafana 5.3\$1).  | 

### Interval waktu min
<a name="postgresql-min-time-interval"></a>

 Batas bawah untuk `$_interval` `$_interval_ms` variabel. Disarankan untuk diatur untuk menulis frekuensi, misalnya `1m` jika data Anda ditulis setiap menit. Opsi ini juga dapat berada overridden/configured di panel dasbor di bawah opsi sumber data. Nilai ini **harus** diformat sebagai angka diikuti oleh pengidentifikasi waktu yang valid; misalnya, `1m` (1 menit) atau `30s` (30 detik). Pengidentifikasi waktu berikut didukung.


|  Pengidentifikasi  |  Deskripsi  | 
| --- | --- | 
|  y  |  Tahun  | 
|  M  |  Bulan  | 
|  w  |  Minggu  | 
|  d  |  Hari  | 
|  h  |  Jam  | 
|  m  |  Menit  | 
|  s  |  Detik  | 
|  ms  |  Milidetik  | 

### Izin pengguna basis data
<a name="postgresql-database-user-permissions-important"></a>

**penting**  
 Pengguna database yang Anda tentukan saat Anda menambahkan sumber data seharusnya hanya diberikan izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `DELETE FROM user;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna PostgreSQL tertentu dengan izin terbatas. 

Kode contoh berikut menunjukkan pembuatan pengguna PostgreSQL specifice dengan izin terbatas. 

```
 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;
```

 Pastikan bahwa pengguna tidak mendapatkan izin yang tidak diinginkan dari peran publik. 

## Editor kueri
<a name="postgresql-query-editor"></a>

 Anda menemukan editor kueri PostgreSQL di tab metrik di Graph atau mode edit panel Singlestat. Anda masuk ke mode edit dengan memilih judul panel, lalu edit. 

 Editor kueri memiliki tautan **SQL yang dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan. 

### Pilih tabel, kolom waktu, dan kolom metrik (DARI)
<a name="postgresql-select-table-time-column-and-metric-column-from"></a>

 Saat Anda memasuki mode edit untuk pertama kalinya atau menambahkan kueri baru, Grafana akan mencoba mengisi ulang pembuat kueri dengan tabel pertama yang memiliki kolom stempel waktu dan kolom numerik. 

 Di bidang FROM, Grafana akan menyarankan tabel yang ada di `search_path` pengguna database. Untuk memilih tabel atau tampilan yang tidak ada di Anda, `search_path` Anda dapat memasukkan nama yang sepenuhnya memenuhi syarat (schema.table) secara manual seperti. `public.metrics` 

 Kolom kolom Waktu mengacu pada nama kolom yang memegang nilai waktu Anda. Memilih nilai untuk bidang kolom Metrik adalah opsional. Jika nilai dipilih, bidang kolom Metrik akan digunakan sebagai nama seri. 

 Saran kolom metrik hanya akan berisi kolom dengan tipe data teks (char, varchar, text). Untuk menggunakan kolom dengan tipe data yang berbeda sebagai kolom metrik, Anda dapat memasukkan nama kolom dengan pemeran:`ip::text`. Anda juga dapat memasukkan ekspresi SQL arbitrer di bidang kolom metrik yang mengevaluasi tipe data teks seperti. `hostname || ' ' || container_name` 

### Kolom, jendela, dan fungsi agregasi (SELECT)
<a name="columns-window-and-aggregation-functions-select"></a>

 Di `SELECT` baris, Anda dapat menentukan kolom dan fungsi apa yang ingin Anda gunakan. Di kolom kolom, Anda dapat menulis ekspresi arbitrer alih-alih nama kolom seperti`column1 * column2 / column3`. 

 Fungsi yang tersedia di editor kueri bergantung pada versi PostgreSQL yang Anda pilih saat mengonfigurasi sumber data. Jika Anda menggunakan fungsi agregat, Anda harus mengelompokkan set hasil Anda. Jika Anda menambahkan fungsi agregat, editor akan secara otomatis menambahkan file. `GROUP BY time` 

Editor mencoba menyederhanakan dan menyatukan bagian kueri ini. 

Anda dapat menambahkan kolom nilai lebih lanjut dengan memilih tombol plus dan memilih **Kolom** dari menu. Beberapa kolom nilai akan diplot sebagai seri terpisah di panel grafik. 

### Data penyaringan (WHERE)
<a name="postgresql-filter-data-where"></a>

 Untuk menambahkan filter, pilih ikon plus di sebelah kanan `WHERE` kondisi. Anda dapat menghapus filter dengan memilih filter dan memilih **Hapus**. Filter untuk rentang waktu yang dipilih saat ini secara otomatis ditambahkan ke kueri baru.

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

 Untuk mengelompokkan berdasarkan waktu atau kolom lainnya pilih ikon plus di akhir baris GROUP BY. Daftar tarik-turun saran hanya akan menampilkan kolom teks dari tabel yang Anda pilih saat ini tetapi Anda dapat memasukkan kolom apa pun secara manual. Anda dapat menghapus grup dengan memilih item dan kemudian memilih **Hapus**. 

 Jika Anda menambahkan pengelompokan apa pun, semua kolom yang dipilih harus memiliki fungsi agregat yang diterapkan. Pembuat kueri akan secara otomatis menambahkan fungsi agregat ke semua kolom tanpa fungsi agregat saat Anda menambahkan pengelompokan. 

#### Pengisian celah
<a name="postgresql-gap-filling"></a>

 Grafana yang Dikelola Amazon dapat mengisi nilai yang hilang saat Anda mengelompokkan berdasarkan waktu. Fungsi waktu menerima dua argumen. Argumen pertama adalah jendela waktu yang ingin Anda kelompokkan, dan argumen kedua adalah nilai yang Anda inginkan Grafana untuk mengisi item yang hilang. 

### Mode editor teks (RAW)
<a name="postgresql-text-editor-mode-raw"></a>

 Anda dapat beralih ke mode editor kueri mentah dengan memilih ikon hamburger dan memilih **mode Switch editor** atau dengan memilih **Edit SQL** di bawah kueri. 

**catatan**  
 Jika Anda menggunakan editor kueri mentah, pastikan kueri Anda setidaknya memiliki `ORDER BY time` dan filter pada rentang waktu yang dikembalikan. 

## Makro
<a name="postgresql-macros"></a>

 Makro dapat digunakan dalam kueri untuk menyederhanakan sintaks dan memungkinkan bagian dinamis. 


|  Contoh makro  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1\$1time(dateColumn)  |  Akan diganti dengan ekspresi untuk mengkonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi. time\$1sec Misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec.  | 
|  \$1\$1\$1timeEpoch(dateColumn)  |  Akan diganti dengan ekspresi untuk mengkonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi. time\$1sec Misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. | 
|  \$1\$1\$1timeFilter(dateColumn)  |  Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn BETWEEN FROM\$1UNIXTIME (1494410783) DAN FROM\$1UNIXTIME (1494410983).  | 
|  \$1\$1\$1timeFrom()  |  Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410783). | 
|  \$1\$1\$1timeTo()  |  Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410983).  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m')  |  Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Misalnya, cast (cast (UNIX\$1TIMESTAMP (DateColumn)/(300) sebagai ditandatangani) 300 sebagai ditandatangani), \$1  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', 0)  |  Sama seperti baris preivious, tetapi dengan parameter fill sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', NULL)  |  Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang.  | 
|  \$1\$1\$1timeGroup(dateColumn,'5m', previous)  |  Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1).  | 
|  \$1\$1\$1timeGroupAlias(dateColumn,'5m')  |  Akan diganti identik dengan \$1\$1\$1TimeGroup tetapi dengan alias kolom tambahan  | 
|  \$1\$1\$1unixEpochFilter(dateColumn) |  Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix. Misalnya, \$1DateColumn > 1494410783 DAN DateColumn < 1494497183\$1  | 
| \$1\$1\$1unixEpochFrom()`  | \$1 Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif sebagai stempel waktu Unix. Misalnya, \$11494410783\$1 | 
| \$1\$1\$1unixEpochTo() | Akan diganti dengan akhir pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, \$11494497183\$1 | 
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu nanodetik. Misalnya, \$1DateColumn > 1494410783152415214 DAN DateColumn < 1494497183142514872\$1 | 
| \$1\$1\$1unixEpochNanoFrom() | Akan digantikan oleh dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, \$11494410783152415214\$1 | 
| \$1\$1\$1unixEpochNanoTo() | Akan diganti pada akhir pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, \$11494497183142514872\$1 | 
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | Sama seperti \$1\$1\$1TimeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix. | 

## Kueri tabel
<a name="postgresql-table-queries"></a>

 Jika opsi kueri diatur ke **Format sebagai Tabel**, pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda. 

 Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `as` SQL biasa. 

## Pertanyaan deret waktu
<a name="postgresql-time-series-queries"></a>

 Jika Anda menetapkan **Format**`Time series`, untuk digunakan dalam panel grafik misalnya, kueri harus mengembalikan kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik yang mewakili Unix epoch. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama`metric`, kolom ini digunakan sebagai awalan untuk nama seri. 

 Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu. 

 Kode contoh berikut menunjukkan `metric` kolom. 

```
SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```

 Contoh kode folowing menunjukkan menggunakan parameter fill di makro \$1\$1\$1TimeGroup untuk mengonversi nilai null menjadi nol sebagai gantinya. 

```
SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time
```

 Kode contoh berikut menunjukkan beberapa kolom. 

```
SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```

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

 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, lihat[Template](templates-and-variables.md#templates). 

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

 Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri PostgreSQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun. 

 Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. 

```
SELECT hostname FROM host
```

 Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`. 

```
SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city
```

 Untuk menggunakan makro yang bergantung pada rentang waktu seperti `$__timeFilter(column)` dalam kueri Anda, mode penyegaran variabel template harus disetel ke *On Time Range Change*. 

```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```

 Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik, nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai yang memungkinkan Anda memiliki nama ramah sebagai teks dan id sebagai nilainya. Contoh query dengan `hostname` sebagai teks dan `id` sebagai nilai: 

```
SELECT hostname AS __text, id AS __value FROM host
```

 Anda juga dapat membuat variabel bersarang. Menggunakan variabel bernama`region`, Anda bisa memiliki variabel host hanya menampilkan host dari wilayah yang dipilih saat ini. Contoh kode berikut menunjukkan kueri seperti ini (jika `region` adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai). 

```
SELECT hostname FROM host  WHERE region IN($region)
```

#### Menggunakan `__searchFilter` untuk memfilter hasil dalam Variabel Kueri
<a name="postgresql-using-__searchfilter-to-filter-results-in-query-variable"></a>

 Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan jenis pengguna di kotak pilih dropdown. Ketika tidak ada yang dimasukkan oleh pengguna, nilai default untuk `__searchFilter` adalah`%`. 

**catatan**  
 Penting bahwa Anda mengelilingi `__searchFilter` ekspresi dengan tanda kutip karena Grafana tidak melakukan ini untuk Anda. 

 Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `hostname` sementara pengguna mengetik di kotak pilih dropdown. 

```
SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'
```

### Menggunakan variabel dalam kueri
<a name="postgresql-using-variables-in-queries"></a>

 Nilai variabel template hanya dikutip ketika variabel template adalah`multi-value`. 

 Jika variabel adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai. 

 Ada dua sintaks: 

 `$<varname>`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```

 `[[varname]]`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```

#### Mematikan kutipan untuk variabel multi-nilai
<a name="postgresql-disabling-quoting-for-multi-value-variables"></a>

 Grafana yang Dikelola Amazon secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya: jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel. 

 `${servers:csv}` 

 Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Template dan variabel](templates-and-variables.md). 

## Anotasi
<a name="postgresql-annotations"></a>

 Gunakan anotasi 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). 

 Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch. 

```
SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)
```

 Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch. 

**catatan**  
 Ini hanya tersedia di Grafana v6.6\$1. 

```
SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)
```

 Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli. 

```
SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)
```


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  time  |  Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch.  | 
|  timeend  |  Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch (Grafana v6.6\$1). | 
|  text  |  Bidang deskripsi acara.  | 
|  tags  |  Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string yang dipisahkan koma.  | 

## Peringatan
<a name="postgresql-alerting"></a>

 Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan. 

# Connect ke sumber data Tempo
<a name="tempo-data-source"></a>

 Tempo adalah penyimpanan jejak ketergantungan minimal volume tinggi, solusi penelusuran OSS dari Grafana Labs. 

## Menambahkan sumber data
<a name="tempo-adding-the-data-source"></a>

 Untuk mengakses pengaturan Tempo, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih **Tempo**. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Name  |  Nama yang akan Anda gunakan untuk merujuk ke sumber data di panel, kueri, dan Jelajahi.  | 
|  Default  |  Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.  | 
|  URL  |  URL dari instance Tempo; misalnya,http://tempo.  | 
|  Basic Auth  |  Aktifkan otentikasi dasar ke sumber data Tempo.  | 
|  User  |  Nama pengguna untuk otentikasi dasar.  | 
|  Password  |  Kata sandi untuk otentikasi dasar.  | 

## Lacak ke log
<a name="tempo-trace-to-logs"></a>

 Ini adalah konfigurasi untuk fitur trace to logs. Sumber data target saat ini haruslah Loki. Untuk informasi selengkapnya, lihat [Menelusuri integrasi](explore.md#tracing-integration). 
+ **Sumber data — Sumber** data target.
+ **Tag** — Tag yang akan digunakan dalam kueri Loki. Bawaannya adalah `'cluster', 'hostname', 'namespace', pod'`
+ **Pergeseran waktu mulai rentang** - Pergeseran waktu mulai untuk kueri Loki berdasarkan rentang waktu mulai. Untuk memperluas ke masa lalu, Anda perlu menggunakan nilai negatif. Satuan waktu dapat digunakan di sini, misalnya, 5s, 1m, 3h. Default-nya adalah 0.
+ **Pergeseran waktu akhir rentang** — Pergeseran waktu akhir untuk kueri Loki berdasarkan rentang waktu akhir. Satuan waktu dapat digunakan di sini, misalnya, 5s, 1m, 3h. Default-nya adalah 0.

## Jejak kueri
<a name="tempo-query-traces"></a>

 Anda dapat menanyakan dan menampilkan jejak dari Tempo melalui Explore. Anda dapat mencari jejak jika Anda mengatur pengaturan jejak ke log di halaman konfigurasi sumber data. Untuk menemukan jejak untuk memvisualisasikan, gunakan editor kueri Loki. Untuk mendapatkan hasil pencarian, Anda harus memiliki bidang turunan yang dikonfigurasi, yang mengarah ke sumber data ini. 

Untuk menanyakan jejak tertentu, pilih jenis kueri TraceID, lalu masukkan ID ke dalam bidang Trace ID.

## Menautkan ke ID jejak dari log
<a name="tempo-linking-trace-id-from-logs"></a>

 Anda dapat menautkan ke jejak Tempo dari log di Loki atau Elastis dengan mengonfigurasi tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields). 

# Konfigurasikan sumber TestData data untuk pengujian
<a name="testdata-data-source"></a>

Grafana dikirimkan dengan sumber TestData data, yang membuat data deret waktu simulasi untuk panel apa pun. Anda dapat menggunakannya untuk membuat data deret waktu palsu dan acak Anda sendiri dan merendernya di panel apa pun, yang membantu Anda memverifikasi fungsionalitas dasbor dan membagikan data dengan aman dan mudah.

**Konfigurasikan sumber data**

**Untuk mengakses konfigurasi sumber data untuk TestData**

1. Pilih ikon **Konfigurasi** (roda gigi).

1. Pilih **Sumber Data**.

1. pilih **TestData**.

Sumber data tidak menyediakan pengaturan apa pun di luar opsi paling dasar yang umum untuk semua sumber data:


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  `Name`  |  Nama sumber data di panel, kueri, dan Jelajahi.  | 
|  `Default`  |  Apakah sumber data ini akan dipilih sebelumnya untuk panel baru.  | 

**Buat data tiruan**

Menambahkan sumber TestData data, pengguna instans Grafana Anda dapat menggunakannya sebagai sumber data di panel metrik apa pun, dan itu akan memberikan data tiruan yang dapat Anda gunakan, berdasarkan TestData skenario yang Anda pilih.

**Pilih skenario**

Alih-alih menyediakan editor kueri, sumber TestData data membantu Anda memilih **Skenario** yang menghasilkan data simulasi untuk panel.

Anda dapat menetapkan **Alias** untuk setiap skenario, dan banyak yang memiliki opsi sendiri yang muncul saat dipilih.

**Skenario yang tersedia:**
+ **Anotasi**
+ **Kesalahan Bersyarat**
+ **Konten CSV**
+ **CSV Berkas**
+ **Nilai Metrik CSV**
+ **Datapoint Luar Jangkauan**
+ **Data bucket peta panas eksponensial**
+ **Grafana API**
+ **Grafana Langsung**
+ **Data bucket peta panas linier**
+ **Muat Data Panah Apache**
+ **Log**
+ **Tidak Ada Poin Data**
+ **Grafik Node**
+ **Gelombang CSV yang Dapat Diprediksi**
+ **Pulsa yang Dapat Diprediksi**
+ **Jalan Acak**
+ **Random Walk (dengan kesalahan)**
+ **Meja Jalan Acak**
+ **Bingkai Mentah**
+ **Simulasi**
+ **Kueri Lambat**
+ **Klien Streaming**
+ **Tabel statis**
+ **Data yang dihasilkan AS**

**Impor dasbor yang telah dikonfigurasi sebelumnya**

TestData juga menyediakan contoh dasbor.

**Untuk mengimpor dasbor contoh**

1. Arahkan ke halaman konfigurasi sumber data.

1. Pilih tab **Dasbor**.

1. Pilih **Impor** untuk dasbor **Contoh Streaming Sederhana**.

**Untuk menyesuaikan dasbor yang diimpor:**

Untuk menyesuaikan dasbor yang diimpor, kami sarankan Anda menyimpannya dengan nama yang berbeda. Jika tidak, memutakhirkan Grafana dapat menimpa dasbor yang disesuaikan dengan versi baru.

**Gunakan data pengujian untuk melaporkan masalah**

Jika Anda melaporkan masalah terkait GrafanaLabs penggunaan atau rendering data deret waktu, kami sangat menyarankan agar Anda menggunakan sumber data ini untuk mereplikasi masalah tersebut. GitHub Itu membuatnya lebih mudah bagi pengembang untuk mereplikasi dan menyelesaikan masalah Anda.

# Connect ke sumber data Zipkin
<a name="zipkin-data-source"></a>

 Zipkin adalah sistem penelusuran terdistribusi open source. Tambahkan sumber data Zipkin untuk dapat menanyakan jejak Anda di Jelajahi di Grafana Terkelola Amazon 

## Menambahkan sumber data
<a name="zipkin-adding-the-data-source"></a>

 Untuk mengakses pengaturan Zipkin, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih **Zipkin**. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Name  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi.  | 
|  Default  |  Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.  | 
|  URL  |  URL dari contoh Zipkin; misalnya,http://localhost:9411.  | 
|  Access  |  Server (default) = URL harus dapat diakses dari backend/server Grafana.  | 
|  Basic Auth  |  Aktifkan otentikasi dasar ke sumber data Zipkin.  | 
|  User  |  Nama pengguna untuk otentikasi dasar.  | 
|  Password  |  Kata sandi untuk otentikasi dasar.  | 

## Jejak kueri
<a name="zipkin-query-traces"></a>

 Menanyakan dan menampilkan jejak dari Zipkin tersedia melalui Explore. 

 Editor kueri Zipkin memungkinkan Anda untuk melakukan kueri dengan melacak ID secara langsung atau memilih jejak dari pemilih jejak. Untuk kueri berdasarkan ID jejak, masukkan ID ke input teks. 

 Gunakan pemilih jejak untuk memilih jejak tertentu dari semua jejak yang dicatat dalam rentang waktu yang telah Anda pilih di Jelajahi. Pemilih jejak memiliki tiga tingkat bersarang: 1. Layanan yang Anda minati. 1. Operasi khusus adalah bagian dari layanan yang dipilih 1. Jejak spesifik di mana operasi yang dipilih terjadi, diwakili oleh nama operasi root dan durasi jejak. 

## Pemetaan data di UI jejak
<a name="zipkin-data-mapping-in-the-trace-ui"></a>

 Anotasi Zipkin ditampilkan dalam tampilan jejak sebagai log dengan nilai anotasi yang ditampilkan di bawah kunci anotasi. 

## Menautkan ke ID jejak dari log
<a name="zipkin-linking-trace-id-from-logs"></a>

 Anda dapat menautkan ke jejak Zipkin dari log di Loki dengan mengonfigurasi bidang turunan dengan tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields). 

# Connect ke sumber data Enterprise
<a name="AMG-data-sources-enterprise"></a>

Sumber data berikut didukung di ruang kerja yang telah ditingkatkan ke plugin Amazon Managed Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).

Plugin perusahaan diperbarui secara berkala. Ini termasuk pembaruan untuk plugin yang ada, dan terkadang sumber data baru. Dokumentasi berikut ini mungkin tidak mencakup semua sumber data yang tersedia. *Untuk daftar plugin Enterprise saat ini yang didukung oleh plugin Amazon Managed Grafana Enterprise, lihat Plugin Grafana [Enterprise dalam dokumentasi Grafana](https://grafana.com/docs/plugins/).*

Untuk ruang kerja yang mendukung versi 9 dan yang lebih baru, sumber data Enterprise tidak lagi diinstal secara default. Anda harus menginstal plugin sumber data yang benar. Anda dapat menginstal plugin untuk semua sumber data Enterprise, termasuk yang tidak tercantum di sini. Anda juga dapat memilih untuk memperbarui versi plugin yang sudah Anda instal. Untuk informasi selengkapnya tentang mengelola plugin, lihat[Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

**Topics**
+ [AppDynamics](appdynamics-AMG-datasource.md)
+ [Databricks](AMG-databricks-datasource.md)
+ [Datadog](AMG-datadog-datasource-plugin.md)
+ [Dynatrace](dynatrace-AMG-datasource.md)
+ [GitLab](gitlab-AMG-datasource.md)
+ [Honeycomb](honeycomb-AMG-datasource.md)
+ [Jira](jira-AMG-datasource.md)
+ [MongoDB](AMG-mongodb-datasource.md)
+ [New Relic](new-relic-data-source.md)
+ [Oracle Database](oracle-datasource-AMG.md)
+ [Salesforce](salesforce-AMG-datasource.md)
+ [SAP HANA](saphana-AMG-datasource.md)
+ [ServiceNow](grafana-enterprise-servicenow-datasource.md)
+ [Kepingan salju](snowflake-datasource-for-AMG.md)
+ [Splunk](splunk-datasource.md)
+ [Pemantauan Infrastruktur Splunk](AMG-datasource-splunkinfra.md)
+ [Depan gelombang](wavefront-datasource-for-AMG.md)

# Connect ke sumber AppDynamics data
<a name="appdynamics-AMG-datasource"></a>

 Sumber AppDynamics data untuk Grafana Terkelola Amazon memungkinkan Anda melakukan kueri metrik dari AppDynamics menggunakan Metrics API dan memvisualisasikannya di dasbor Grafana. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Catatan tentang konfigurasi sumber data
<a name="note-on-the-datasource-config"></a>

 Gunakan akses Server (proxy) (untuk menghindari CORS dan pengguna mencari kata sandi Anda) dan otentikasi dasar. Ingat bahwa nama pengguna harus “user @account “, (yaitu, your.name @customer1 atau my\$1user @saas\$1account\$1name).

 Konfigurasikan kata sandi menggunakan langkah-langkah berikut: 

1.  Arahkan [https://accounts.appdynamics.comke/langganan](https://accounts.appdynamics.com/subscriptions) 

1.  Pilih tautan di kolom **Nama** pada baris untuk langganan Anda. 

1.  Arahkan ke **detail Lisensi** dengan memilih tab di bagian atas halaman. 

1.  Bidang Kunci Akses memiliki tombol **Tampilkan**. Pilih tombol **Tampilkan** untuk menampilkan Kunci Akses. 

1.  Salin Kunci Akses ke bidang Kata Sandi di Detail Auth Dasar pada halaman konfigurasi di Grafana. 

 Siapkan pengguna dan peran untuk Grafana Terkelola Amazon menggunakan langkah-langkah berikut. 

1.  Masuk AppDynamics, navigasikan ke Pengaturan, Administrasi. 

1.  Pilih tab **Peran**, dan pilih tombol “\$1” untuk membuat peran baru; misalnya, `grafana_readonly.` 

1.  Di tab **Akun** di bagian Buat Peran, tambahkan izin`View Business Flow`.

1.  Di tab **Aplikasi**, centang kotak **Tampilan** untuk memungkinkan Grafana melihat data aplikasi. 

1.  Di tab **Database**, centang kotak **Tampilan** untuk memungkinkan Grafana melihat data database. 

1.  Di tab **Analytics**, centang kotak **Dapat melihat data dari semua Aplikasi** untuk memungkinkan Grafana melihat data analitik aplikasi. 

1.  Di tab **Pengguna** pada halaman Administrasi, buat pengguna baru; misalnya,`grafana`. Tetapkan pengguna baru (atau Grup tempat pengguna berada) ke peran yang baru saja Anda buat; misalnya,`grafana_readonly`.

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

 Kueri template yang didukung untuk saat ini adalah: 

1.  `Applications`(Semua Aplikasi) 

1.  `AppName.BusinessTransactions`(Semua BTs untuk Nama Aplikasi) 

1.  `AppName.Tiers`(Semua Tingkatan untuk Nama Aplikasi) 

1.  `AppName.Nodes`(Semua Node untuk Nama Aplikasi) 

1.  `AppName.TierName.BusinessTransactions`(Semua BTs untuk Tier tertentu) 

1.  `AppName.TierName.Nodes`(Semua Node untuk Tingkat tertentu) 

1.  `AppName.Path.<Any Metric Path>`(Jalur metrik apa pun dapat ditentukan) 

## Kunci legenda
<a name="legend-keys"></a>

 Default untuk kunci legenda bisa sangat panjang tetapi pemformatan ini dapat disesuaikan. 

 Kunci legenda dapat diawali dengan nama aplikasi dengan memilih `App on legend` opsi. Sebagai contoh: `MyApp - Overall Application Performance|Average Response Time (ms)`. 

 Jika kueri adalah untuk panel tunggal atau panel lain di mana Anda tidak dapat melihat kunci legenda, maka pilih opsi Tampilkan Metadata untuk melihat apa kunci legenda (juga disebut alias) untuk kueri tersebut. 

 Daftar dropdown Legend memiliki tiga opsi:`Full Path`, `Segments` dan. `Custom` 

### Opsi legenda - jalur lengkap
<a name="legend-option---full-path"></a>

 Kunci legenda adalah jalur metrik lengkap; misalnya,`Overall Application Performance|Average Response Time (ms)`. 

### Opsi legenda - segmen
<a name="legend-option---segments"></a>

 Nama metrik terdiri dari segmen. Anda dapat memilih segmen mana yang akan ditampilkan. 

 Misalnya, dengan nama metrik: 

 `Errors|mywebsite|Error|Errors per Minute` 

 memasukkan berikut ini `2,4` di bidang Segmen kembali`mywebsite|Errors per minute`. 

 Pengindeksan dimulai dengan 1 jadi `1` kembali`Errors`. 

### Opsi legenda - kustom
<a name="legend-option---custom"></a>

 Buat legenda kustom dengan menggabungkan teks dengan pola aliasing berikut untuk dapat mencampur metadata metrik. 
+  `{{app}}`mengembalikan nama Aplikasi 
+  `{{1}}`mengembalikan segmen dari jalur metrik. 

   Misalnya, metrik: `Overall Application Performance|Average Response Time (ms)` memiliki dua segmen. `{{1}}`mengembalikan segmen pertama, `{{2}}` mengembalikan segmen kedua. 

 Contoh pola kunci legenda dan kunci legenda yang dihasilkan: 
+  `custom legend key` => `custom legend key` 
+  `App: {{app}} MetricPart2: {{2}}` => `App: myApp MetricPart2: Average Response Time (ms)` 

# Connect ke sumber data Databricks
<a name="AMG-databricks-datasource"></a>

Sumber data Databricks memungkinkan Anda melakukan kueri dan memvisualisasikan data Databricks dalam Grafana Terkelola Amazon. Ini termasuk editor SQL untuk memformat dan kode warna kueri Anda.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Menambahkan sumber data Databricks
<a name="AMG-databricks-add-datasource"></a>

Ikuti langkah-langkah ini untuk menambahkan sumber data Databricks di konsol Grafana.

**Untuk menambahkan sumber data Databricks**

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

1. Di menu samping, di bawah tautan **Dasbor**, pilih **Sumber Data**.
**catatan**  
Jika Anda tidak melihat tautan **Sumber Data**, Anda tidak memiliki `Admin` peran untuk Grafana.

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

1. Pilih **Databricks dari daftar** **dropdown Type**.
**catatan**  
Jika Anda tidak melihat opsi Databricks, dan membutuhkannya, Anda harus meningkatkan ke Grafana Enterprise.

1. Pilih opsi untuk terhubung dan mengedit data Anda.

## Catatan saat menggunakan sumber data Databricks
<a name="AMG-databricks-notes"></a>

**Deret waktu**

Visualisasi deret waktu dapat dipilih saat Anda menambahkan `datetime` bidang ke kueri Anda. Bidang ini akan digunakan sebagai stempel waktu untuk seri. Jika bidang tidak menyertakan zona waktu tertentu, Grafana akan menganggap bahwa waktunya adalah UTC.

**Seri waktu multi-baris**

Untuk membuat visualisasi deret waktu multi-baris, kueri harus menyertakan setidaknya tiga bidang dalam urutan berikut.

1. `datetime`Bidang dengan alias. `time`

1. Nilai untuk`GROUP BY`.

1. Satu atau lebih nilai metrik untuk divisualisasikan.

Berikut ini adalah contoh kueri yang akan mengembalikan opsi deret waktu multi-baris.

```
SELECT log_time AS time, machine_group, avg(disk_free) AS avg_disk_free
FROM mgbench.logs1
GROUP BY machine_group, log_time
ORDER BY log_time
```

# Connect ke sumber data Datadog
<a name="AMG-datadog-datasource-plugin"></a>

 Sumber data Datadog memungkinkan Anda memvisualisasikan metrik dari layanan pemantauan Datadog di Amazon Managed Grafana. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Penggunaan
<a name="datadog-usage"></a>

### Pembuatan cache
<a name="datadog-caching"></a>

 Untuk dasbor besar, yang membuat banyak kueri dimungkinkan untuk dibatasi oleh Datadog API (mencapai jumlah maksimum panggilan API per jam yang diizinkan oleh Datadog API). Fitur caching menyimpan kueri unik selama 60 detik. Interval ini dapat diubah menjadi lebih panjang atau lebih pendek pada halaman konfigurasi. 

### Editor kueri
<a name="datadog-query-editor"></a>

 Sangat mudah - pilih agregasi dan metrik. Jika Anda ingin memfilter hasil, pilih satu atau beberapa tag. 

 Sumber data Datadog mendukung semua fungsi lanjutan yang didukung oleh editor kueri Datadog. Pilih dari daftar dropdown dan atur dengan memilih nama fungsi.

 **Alias berdasarkan kemungkinan penggunaan lapangan:** 
+  Masukkan alias ke bidang “Alias oleh”. 
+  Gunakan variabel cakupan: 
  +  `$__metric`= diganti dengan nama metrik 
  +  `$__display_name`= diganti dengan nama metrik 
  +  `$__expression`= diganti dengan ekspresi metrik penuh 
  +  `$__aggr`= diganti dengan fungsi agregasi metrik (misalnya, rata-rata, maks, min, jumlah) 
  +  `$__scope`= diganti dengan cakupan metrik (misalnya, wilayah, situs, env, host) 
+  Gunakan ekspresi reguler: 
  +  Masukkan ekspresi reguler Anda ke bidang “Alias RegExp” dalam `/you regexp here/flags` format. 
  +  Jika bidang “Alias oleh” kosong, RegExp hasil akan digabungkan menggunakan. Contoh dengan ekspresi metrik =`avg:system.load.5{*}`: “Alias oleh” input bidang: “" "Alias RegExp "input bidang: Hasil: `avg:(.+)\.(\d)` `system.load, 5` 
  +  Gunakan `$<group_number>` variabel di bidang “Alias oleh”. Contoh dengan ekspresi metrik =`avg:system.load.5{*}`: “Alias oleh” masukan bidang: `$1: $2 seconds` “Alias RegExp" masukan bidang: Hasil: `avg:(.+)\.(\d)` `system.load: 5 seconds` 
  +  Gunakan `$0` untuk mendapatkan seluruh ekspresi. Contoh dengan ekspresi metrik =`datadog.dogstatsd.packet.count{*}`: “Alias oleh” masukan bidang: `Expression: $0` “Alias RegExp" masukan bidang: Hasil: `DOGstatsd\.(.*)\.(.*){\*}/i` `Expression: datadog.dogstatsd.packet.count{*}` 

   Catatan: Anda akan mendapatkan kesalahan menggunakan nomor grup yang tidak ada. 

#### Aritmatika metrik
<a name="datadog-metric-arithmetic"></a>

 *Untuk menggunakan aritmatika metrik, atur *tipe Query* ke Aritmatika.* Tautkan ke metrik yang Anda inginkan dengan menggunakan `#` tanda. Misalnya, `#A * 2` akan menggandakan hasil query`A`. Aritmatika antara dua metrik bekerja dengan cara yang sama - tambahkan kueri hasil yang ingin Anda gunakan untuk perhitungan dan kemudian tautkan ke metrik ini di kueri ketiga, seperti. `#A / #B` 

### Anotasi
<a name="datadog-annotations"></a>

 Anotasi adalah peristiwa yang dilapisi di atas grafik - contoh peristiwa adalah penyebaran atau pemadaman. Dengan sumber data ini, Anda dapat mengambil peristiwa dari Datadog dan melapisinya pada grafik di Amazon Managed Grafana. Peristiwa anotasi dapat disaring berdasarkan sumber, tag, atau prioritas. 

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

 Ada beberapa opsi untuk mendapatkan nilai variabel template - metrik dan tag. Untuk mengambil daftar metrik yang tersedia, tentukan `*` di bidang *Kueri*. 

 Untuk mengembalikan semua tag gunakan nilai: `tag` atau`scope`. 

 Untuk mengembalikan tag untuk grup tag tertentu, gunakan salah satu nilai kategori default berikut: 
+  `host` 
+  `device` 
+  `env` 
+  `region` 
+  `site` 
+  `status` 
+  `version` 

 Untuk grup tag kustom, cukup masukkan nama grup tag. Misalnya, jika nama grup tag kustom Anda`subscription_name`, masukkan itu di bidang *Kueri*. 

 Filter hasil dengan menggunakan bidang *Regex*. Variabel multi-nilai didukung saat menggunakan tag - beberapa nilai tag yang dipilih akan diubah menjadi daftar tag yang dipisahkan koma. 

#### Filter ad-hoc
<a name="datadog-ad-hoc-filters"></a>

 Ada jenis variabel template khusus baru di Grafana yang disebut filter *Ad-hoc*. Variabel ini akan berlaku untuk *semua* query Datadog di dashboard. Ini memungkinkan menggunakannya seperti filter cepat. Variabel ad-hoc untuk Datadog mengambil semua pasangan kunci-nilai dari tag, misalnya`region:east, region:west`, dan menggunakannya sebagai tag kueri. Untuk membuat variabel ini, pilih jenis *filter Ad-hoc* dan pilih sumber data Datadog Anda. Anda dapat mengatur nama apa pun untuk variabel ini. 

# Connect ke sumber data Dynatrace
<a name="dynatrace-AMG-datasource"></a>

Sumber data untuk [https://www.dynatrace.com/](https://www.dynatrace.com). Untuk menggunakan sumber data ini, Anda harus memiliki akun Dynatrace.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

**Keterbatasan yang diketahui**

Variabel template tidak bisa multi-pilih. Hanya satu pilihan yang didukung.

Hanya metrik v2 APIs yang didukung.

## Fitur
<a name="features"></a>

### Fitur inti
<a name="core-features"></a>
+  Variabel Template 
  +  Nama Metrik 
  +  Hanya pilihan tunggal (**tidak ada multi-pilih**) 
  +  Filter Ad-Hoc 
+  Anotasi 
  +  Saat ini tidak didukung 
+  Aliasing 
  +  Nama Metrik 
  +  Agregasi 
  +  Nama Tampilan 
  +  Host 
  +  Deskripsi 
+  Peringatan 
  +  Dukungan peringatan penuh 

### Fitur khusus Dynatrace
<a name="dynatrace-specific-features"></a>

 Mendukung metrik bawaan dan kustom menggunakan Dynatrace metrics v2 API. [Untuk informasi selengkapnya, lihat dokumentasi Dynatrace: [Metrics API v2 dan Metric ingestion](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/).](https://www.dynatrace.com/support/help/how-to-use-dynatrace/metrics/metric-ingestion/) 

Bergantung pada metrik, API mungkin mendukung opsi transformasi tambahan.

## Izin Dynatrace
<a name="dynatrace-permissions"></a>

 Anda akan memerlukan izin berikut di Dynatrace - Baca metrik menggunakan izin API V2 (metrics.read) - Baca entitas menggunakan izin API V2 (entities.read) 

## Dapatkan kunci API dari Dynatrace
<a name="dynatrace-apikey"></a>

Untuk menyiapkan token API, lihat [Dynatrace API - Token](https://www.dynatrace.com/support/help/dynatrace-api/basics/dynatrace-api-authentication/?api-token%3C-%3Epersonal-access-token=api-token) dan otentikasi 

Tetapkan `metrics.read` dan `entities.read` izin untuk token API Anda.

### Konfigurasi
<a name="configuration"></a>

1.  **Pilih **Pengaturan/Sumber Data** dalam UI server Grafana logis dan pilih Tambahkan sumber data.** 

1.  Pada halaman **Tambahkan sumber data**, filter untuk **Dynatrace**, dan pilih plugin Dynatrace. 

1. Mengkonfigurasi sumber data Dynatrace memerlukan parameter berikut: 
   +  `Name`- Nama yang ingin Anda terapkan ke sumber data Dynatrace (default: Dynatrace). 
   +  `Dynatrace API Type`- Jenis instans Dynatrace yang Anda sambungkan. Ini salah satu `SaaS` atau`Managed Cluster`. 
   +  `Dynatrace API Token`- Ini adalah token API yang Anda buat pada langkah sebelumnya.. 

   Dua pengaturan berikutnya tergantung pada apakah Anda Dynatrace SaaS atau dikelola
   + Dalam contoh SaaS`yfc55578.live.dynatrace.com`, **ID Lingkungan** Anda akan menjadi. `yfc55578`
   + Dalam contoh Dikelola`yd8888.managed-sprint.dynalabs.io/e/abc99984-3af2-55tt-72kl-0672983gc45`, **ID Lingkungan** Anda akan menjadi `abc99984-3af2-55tt-72kl-0672983gc45` dan **Domain** Anda akan `yd8888.managed-sprint.dynalabs.io`

1.  Setelah semua nilai konfigurasi telah ditetapkan, pilih **Simpan & Uji** untuk memvalidasi konfigurasi dan menyimpan perubahan Anda. 

### Kueri sumber data
<a name="dynatrace-usage"></a>

Gunakan editor kueri untuk menanyakan metrik dan masalah Dynatrace. Jenis kueri dapat berupa `metric` atau`problem`.

**Jenis kueri metrik**
+ `Metric`— Pilih metrik yang ingin Anda lihat. Untuk mendapatkan daftar metrik dari Dynatrace lagi, pilih tombol **Refresh**.
+ `Aggregations`— Pilih agregasi yang ingin Anda gunakan untuk metrik tertentu. Pilih nilai agregasi untuk mengubah jenis agregasi atau pilih **\$1** untuk menambahkan agregasi lain.
+ `Transformations`— Anda dapat memilih transformasi di editor kueri. Setelah itu, masukkan sejumlah parameter ke dalam transformasi yang dipilih. Saat ini, hanya transformasi gabungan yang didukung. Untuk informasi selengkapnya tentang transformasi gabungan, lihat [Menggabungkan](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation) transformasi.
+ `Filters`— Sumber data Dynatrace secara dinamis menanyakan filter yang sesuai untuk setiap metrik. Untuk menambahkan filter, pilih simbol **\$1** di samping label **Filter** pada editor kueri Dynatrace, pilih bidang mana yang akan difilter, pilih operator yang akan digunakan, lalu pilih nilai yang akan difilter. Sumber data Dynatrace memungkinkan Anda membuat Grup Filter yang dapat Anda gabungkan bersama untuk membuat perbandingan logis yang kompleks. Untuk sebagian besar kasus penggunaan, Grup Filter tidak diperlukan. Saat membuat filter dengan Tag, terlepas dari konjungsi yang dipilih, Dynatrace akan selalu menggunakan AND. Dynatrace tidak mendukung filter OR dengan Tag.
+ `Alias`— Ada dua jenis alias yang akan Anda temui saat menggunakan sumber data Dynatrace. Yang pertama adalah alias statis. Alias jenis ini tersedia di setiap kueri yang Anda buat, dan nama alias dimulai dengan huruf kecil. Yang kedua adalah alias dinamis, yang berubah berdasarkan metrik yang Anda gunakan dalam kueri Anda, dan nama alias dimulai dengan huruf besar. Plugin Dynatrace mendukung beberapa alias yang berbeda:`Metric Names`,,, `Aggregation``Display Name`, `Host` dan. `Description`


|  Nama  |  Nilai  | 
| --- | --- | 
|  \$1name  |  builtin:apps.other. keyUserActions. reportedErrorCount.os  | 
|  \$1aggregation  |  auto, nilai  | 
|  \$1displayName  | Jumlah kesalahan yang dilaporkan (berdasarkan tindakan pengguna utama, OS) [seluler, kustom] | 

**Jenis kueri masalah**
+ `Problem Query Type`— Pilih jenis kueri masalah. Saat ini, hanya jenis kueri masalah umpan yang didukung. Untuk informasi tentang jenis kueri masalah feed, lihat [Menggabungkan transformasi](https://www.dynatrace.com/support/help/dynatrace-api/environment-api/metric-v2/metric-selector/#merge-transformation)
+ `Status Filter`— Filter masalah hasil berdasarkan status.
+ `Impact Filter`— Filter masalah hasil berdasarkan tingkat dampak.
+ `Severity Filter`— Filter masalah hasil berdasarkan tingkat keparahan.
+ `Expand Details`— Sertakan peristiwa terkait dengan respons, jika diatur..

#### Menggunakan variabel template
<a name="using-template-variables"></a>

 Untuk menambahkan variabel kueri Dynatrace baru, lihat [menambahkan variabel template baru](variables-types.md#add-a-query-variable). Gunakan sumber data Dynatrace sebagai sumber data untuk kueri berikut yang tersedia: 
+ `Query type`— Pilih jenis kueri. Jenis kueri mengaitkan beberapa data dengan beberapa kunci atau deskriptor.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/dynatrace-AMG-datasource.html)
+ `Regex`— (Opsional) Saring salah satu nilai yang dikembalikan dari kueri Anda dengan ekspresi reguler.

**catatan**  
`Multi-value`dan saat `Include All option` ini tidak didukung oleh sumber data Dynatrace.

Setelah membuat variabel, Anda dapat menemukannya di menu drop-down **Metric**. 

##### Impor dasbor untuk Dynatrace
<a name="dynatrace-import"></a>

Untuk mengimpor dasbor, lihat[Mengimpor dasbor](dashboard-export-and-import.md#importing-a-dashboard). Dasbor yang diimpor dapat ditemukan di **Konfigurasi>** **Sumber Data** > pilih sumber data Dynatrace Anda> pilih tab Dasbor untuk melihat **dasbor pra-dibuat** yang tersedia.

# Connect ke sumber GitLab data
<a name="gitlab-AMG-datasource"></a>

Sumber GitLab data memungkinkan Anda melacak GitLab statistik terperinci, seperti kontributor teratas, komit per hari, atau penerapan per hari. Anda juga dapat menggunakan variabel template, seperti proyek, untuk menyiapkan filter untuk dasbor Anda. Anda dapat menggabungkan data dari GitLab API dengan data dari sumber lain.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Keterbatasan yang Sudah Diketahui
<a name="gitlab-known-limitations"></a>

Peringatan belum didukung di plugin ini karena transformasi tidak didukung dalam kueri peringatan dan transformasi adalah satu-satunya cara untuk mendapatkan metrik agregat yang berarti dari data mentah API. GitLab 

## Menambahkan sumber data
<a name="gitlab-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 
**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

1.  Pilih **GitLab**dari daftar sumber data. 

1. Masukkan informasi berikut:
   + Untuk **Nama**, masukkan nama untuk sumber GitLab data ini.
   + Untuk **URL**, masukkan URL root untuk GitLab contoh Anda, seperti**https://gitlab.com/api/v4**.
   + Untuk **Access token**, masukkan token akses GitLab pribadi Anda.

## Kueri sumber GitLab data
<a name="gitlab-query"></a>

Dari Editor GitLab Kueri, Anda dapat memilih jenis sumber daya yang berbeda, seperti komit, masalah, atau rilis.

**Filter dan lihat proyek**

1.  **Dari menu tarik-turun, pilih Projects.** 

1.  (Opsional) Filter berdasarkan proyek yang Anda miliki. 

1.  Gunakan dropdown dan pilih **Ya** atau **Tidak** untuk memfilter hasilnya. 
**catatan**  
 Mengambil semua proyek yang **Dimiliki = Tidak** bisa memakan waktu lama. 

**Filter dan lihat komit**

1.  **Dari menu tarik-turun, pilih Komit.** 

1.  Gunakan kolom input untuk menambahkan ID proyek. 

1.  (Opsional) Untuk memfilter dengan branch/tag menggunakan bidang input untuk menambahkan branch/tag referensi. 

**Filter dan lihat masalah**

1.  **Dari menu tarik-turun, pilih Masalah.** 

1.  Gunakan kolom input untuk menambahkan ID proyek. 

1.  **(Opsional) Untuk memfilter berdasarkan judul/deskripsi, gunakan kolom input untuk mencari masalah berdasarkan **judul** dan deskripsi mereka.** 

**Lihat rilis**

1.  **Dari menu tarik-turun, pilih Deployments.** 

1.  Gunakan kolom input untuk menambahkan ID proyek. 

1.  (Opsional) Untuk memfilter berdasarkan lingkungan/status, gunakan bidang input. Atribut **status** dapat berupa salah satu nilai berikut:`created`,`running`,`success`,`failed`, atau`canceled`. 

**Lihat label**

1.  **Dari menu tarik-turun, pilih Label.** 

1.  Gunakan kolom input untuk menambahkan ID proyek. 

## Template dan variabel
<a name="gitlab-templates"></a>

Untuk menambahkan variabel GitLab kueri baru, lihat[Menambahkan variabel kueri](variables-types.md#add-a-query-variable). Gunakan sumber GitLab data Anda sebagai sumber data. Pilih jenis sumber daya: **Rilis**, **Proyek**, atau **Label**.

Untuk mendapatkan daftar dinamis proyek, label, dan sebagainya untuk dipilih, buat variabel tipe Query. Variabel tipe GitLab kueri menggunakan Editor Kueri untuk menanyakan dan mengembalikan Proyek, Label, dan sebagainya. Contoh berikut membuat variabel Project untuk membuat parameter kueri Anda

**Buat variabel Project untuk membuat parameter kueri Anda**

1.  Tambahkan variabel tipe **Query** bernama**project**. 

1.  Pilih sumber GitLab data Anda dan segarkan **On Dashboard Load**. 

1.  Pilih jenis sumber daya **Proyek**, **Ya** untuk **Dimiliki**, **nama** untuk **bidang tampilan** dan **id** untuk **bidang nilai**. 

1. Pilih **Perbarui** untuk menambahkan variabel ke dasbor.

1. Tambahkan panel baru ke dasbor dan gunakan **\$1project** sebagai ID proyek.

   Sekarang, ketika memilih dari dropdown, Anda mendapatkan hasil yang termasuk dalam proyek itu.

## Menggunakan transformasi dari Grafana untuk menjawab pertanyaan umum
<a name="gitlab-transformations"></a>

Sekarang Anda dapat melakukan GitLab kueri dasar untuk menemukan komit, masalah, dll, Anda dapat menggunakan Transformasi untuk memvisualisasikan, menggabungkan, mengelompokkan, dan bergabung dengan kumpulan data, bersama dengan banyak jenis transformasi lainnya untuk mengubah hasil sederhana menjadi jawaban untuk pertanyaan kompleks. Di bawah ini adalah beberapa pertanyaan umum dan bagaimana menggunakan transformasi untuk menjawabnya.

**Berapa banyak commits/issues/deployments per hari dalam proyek saya?**

1.  Tambahkan kueri. Pilih **Komit** untuk jenis sumber daya dan tambahkan ID proyek. 

1.  **Tambahkan **Grup baru dengan transformasi: untuk **Grup oleh****, pilih **created\$1at\$1date** dan kemudian hitung (Hitung) = id** 

1. Pilih visualisasi **Grafik**.

**Berapa waktu rata-rata untuk menutup masalah dalam proyek saya?**

1.  Tambahkan kueri. Pilih **Masalah** untuk jenis sumber daya dan tambahkan ID proyek. 

1.  ******Tambahkan **bidang Tambah baru dari transformasi perhitungan**: untuk **Mode**, pilih **Operasi Biner, untuk Operasi**, pilih **closed\$1at = created\$1at dan untuk Alias pilih resolution\$1time**.****** 

1.  ******Tambahkan **bidang Tambah baru dari transformasi perhitungan**: untuk **Mode**, pilih **Operasi Biner, untuk Operasi**, pilih **resolution\$1time/86400000 dan untuk Alias pilih resolution\$1time**.****** 

   Untuk **Ganti semua bidang**, pilih **Benar**.

1. Pilih visualisasi **Stat**.
   + Tampilkan = Hitung
   + Perhitungan = Mean
   + Bidang = **resolution\$1time**

# Connect ke sumber data Honeycomb
<a name="honeycomb-AMG-datasource"></a>

Sumber data Honeycomb memungkinkan Anda untuk menanyakan dan memvisualisasikan metrik Honeycomb dan menautkan ke jejak Honeycomb dari dalam Grafana yang Dikelola Amazon.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Keterbatasan yang Sudah Diketahui
<a name="honeycomb-known-limitations"></a>
+  Sumber data ini tidak mendukung kueri ad-hoc. 
+  Karena keterbatasan API, editor variabel hanya dapat mengembalikan 1000 nilai unik pertama untuk kolom yang dipilih. 
+  Karena keterbatasan API, sumber data hanya dapat melakukan kueri selama 7 hari terakhir data. 

## Menambahkan sumber data
<a name="honeycomb-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 

1.  Pilih **Honeycomb** dari daftar sumber data. 

**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

**Pengaturan Honeycomb**


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Name  |  Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi.  | 
|  Honeycomb API key  |  Kunci API yang Anda peroleh dari Honeycomb.  | 
|  URL  |  URL dari API Honeycomb. Misalnya, https://api.honeycomb.io.  | 
|  Team  |  Tim Honeycomb terkait dengan kunci API.  | 

## Kueri sumber data Honeycomb
<a name="honeycomb-query"></a>

Untuk menanyakan metrik, masukkan nilai ke dalam bidang editor:
+  Pilih kumpulan data. 
+  Kueri default adalah `COUNT` di atas kumpulan data yang dipilih. 
+  ****Untuk menyempurnakan kueri, pilih nilai untuk salah satu bidang yang tersisa, seperti **Visualisasi, Visualisasi**, **Tempat**, **Kendala**, **Kelompokkan menurut, **Urutkan** menurut**, atau Batas.**** 

## Template dan variabel
<a name="honeycomb-templates"></a>

Untuk menambahkan variabel kueri Honeycomb baru, lihat[Menambahkan variabel kueri](variables-types.md#add-a-query-variable).

YOu dapat membuat variabel yang berisi Datasets, Columns, atau Column Values.
+  Jika tidak ada dataset yang dipilih, variabel akan berisi dataset. 
+  Jika hanya kumpulan data yang dipilih, variabel akan berisi nama kolom. 
+  Jika dataset dan kolom dipilih, variabel akan berisi nilai kolom. Nilai kolom dapat dibatasi lebih lanjut menggunakan bidang **Where** di editor. 

## Lihat kueri di Honeycomb UI
<a name="honeycomb-view"></a>

Untuk melihat kueri yang telah Anda buat di UI Honeycomb dari panel dasbor, pilih titik mana saja dalam grafik dan pilih **Buka di Honeycomb**. 

Untuk melihat kueri yang telah Anda buat di UI Honeycomb dari Query Editor, pilih **Buka di Honeycomb**. 

## Impor dasbor untuk Honeycomb
<a name="honeycomb-import"></a>

Untuk mengimpor dasbor, lihat[Mengimpor dasbor](dashboard-export-and-import.md#importing-a-dashboard). 

Untuk menemukan dasbor yang diimpor, pilih **Konfigurasi**, **Sumber data**. 

**Untuk melihat dasbor pra-dibuat yang tersedia, pilih sumber data Honeycomb dan pilih tab Dasbor.** 

# Connect ke sumber data Jira
<a name="jira-AMG-datasource"></a>

Dapatkan gambaran keseluruhan proses pengembangan Anda dengan menggabungkan data masalah dari Jira dengan data kinerja aplikasi dari sumber lain.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).
+ Buat anotasi berdasarkan pembuatan atau resolusi masalah, untuk melihat hubungan antara masalah dan metrik.
+ Lacak statistik Jira yang terperinci, seperti waktu rata-rata untuk menyelesaikan dan mengeluarkan throughput.

Untuk menggunakan sumber data Jira, Anda memerlukan akun Atlassian dengan akses ke proyek Jira.

## Keterbatasan yang Sudah Diketahui
<a name="jira-known-limitations"></a>

Jenis bidang khusus dari addons Jira mungkin tidak didukung.

## Menambahkan sumber data
<a name="jira-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 
**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

1.  Pilih **JIRA** dari daftar sumber data. 

1. Masukkan informasi berikut:
   + Untuk **Nama**, masukkan nama untuk sumber data Jira ini.
   + Untuk **URL**, masukkan URL root untuk instance Atlassian Anda, seperti. **https://bletchleypark.atlassian.net**
   + Untuk **Pengguna**, masukkan alamat email untuk user/service akun tersebut.
   + Untuk **token API**, masukkan token API yang dibuat untuk pengguna.

## Kueri sumber data Jira
<a name="jira-query"></a>

Dari Editor Kueri Jira Anda dapat memilih bidang dan masalah kueri.

Sumber data Jira meminta Jira untuk masalah, yang dapat mewakili bug, cerita pengguna, tiket dukungan, atau tugas lain di Jira

**Filter dan lihat masalah**

1.  Pilih **Bidang** pilih dropdown dan gunakan type-ahead untuk memilih dari salah satu bidang di instance Jira Anda, termasuk bidang khusus. Beberapa bidang untuk dicoba: 
   + **Ringkasan** — Nama masalah
   + **Nama Epik** — Epi yang menjadi milik suatu masalah
   + **Perkiraan Titik Cerita** — Jumlah poin cerita yang diperkirakan tim untuk suatu masalah

1.  Filter atau urutkan masalah. Untuk melakukannya, masukkan ekspresi JQL yang valid untuk memfilter atau mengurutkan masalah berdasarkan bidangnya seperti **Project**, **Assignee**, atau **Sprint** dengan bahasa kueri Atlassian JQL. 

Dari sini, Anda dapat menampilkan data Anda dalam tabel atau menggunakan transformasi Grafana untuk memanipulasi data masalah itu, menjalankan perhitungan, atau mengubah data menjadi grafik deret waktu. Untuk informasi selengkapnya, lihat [Menerapkan transformasi](panel-transformations.md#apply-a-transformation).

## Kueri deret waktu
<a name="jira-timeseries-query"></a>

Untuk menampilkan data deret waktu, pilih bidang **Tanggal** bersama dengan bidang numerik, lalu beralih ke visualisasi grafik. Misalnya: **Sprint Start Date**, **Story point estimasi**.

Contoh sebelumnya, dengan sendirinya, tidak terlalu berguna. Bidang numerik dapat (dan kemungkinan besar akan) dihitung dari Transformasi. Menggunakan **Grup Dengan** Transformasi akan memungkinkan pengelompokan berdasarkan **Tanggal Mulai Sprint** dan meringkas **estimasi titik Cerita** yang memungkinkan visualisasi Poin Cerita dari waktu ke waktu per Sprint. Untuk informasi lebih lanjut tentang transformasi, lihat [Menerapkan transformasi](panel-transformations.md#apply-a-transformation). 

## Template dan variabel
<a name="jira-templates"></a>

Untuk menambahkan variabel query Jira baru, lihat[Menambahkan variabel kueri](variables-types.md#add-a-query-variable). Gunakan sumber data Jira Anda sebagai sumber data.

Anda dapat menentukan variabel pada dasbor Anda dan mereferensikannya dalam ekspresi JQL. Misalnya, Anda dapat membuat dasbor status proyek dan memilih di antara proyek, atau dasbor status epik dan memilih epos yang berbeda, atau dasbor status tugas dan memilih penerima tugas yang berbeda.

Untuk mendapatkan daftar dinamis proyek, epos, penerima tugas, dan sebagainya untuk dipilih, buat variabel tipe Query. Variabel tipe kueri menggunakan JQL untuk menanyakan masalah dan mengembalikan Proyek, Epik, Penerima Tugas, atau apa pun yang terkait dengan masalah. Berikut ini adalah contohnya:

**Buat variabel Assignee untuk mendapatkan status masalah oleh Penerima Tugas**

1.  Tambahkan variabel tipe **Query** bernama**assignee**. 

1.  Pilih **Bidang: Penerima Tugas**. 

1.  ) Opsional) Tambahkan **proyek filter JQL = 'proyek Anda'**. 

1.  Pilih **Jalankan** untuk melihat daftar Penerima Tugas. 

1. Pilih **Perbarui** untuk menambahkan variabel ke dasbor.

1. Tambahkan panel baru ke dasbor dan edit JQL untuk memfilter menggunakan variabel baru Anda assignee = **\$1assignee**.

   Sekarang, ketika memilih dari dropdown, Anda hanya melihat masalah yang ditetapkan untuk pengguna itu.

Variabel multi-nilai memungkinkan memilih beberapa opsi dan dapat digunakan sebagai bagian dari klausa IN. Misalnya, penerima tugas IN (**\$1assignee)**.

## Menggunakan transformasi dari Grafana untuk menjawab pertanyaan umum
<a name="jira-macros"></a>

Makro adalah variabel yang mereferensikan jendela waktu Dasbor sehingga Anda dapat memfilter masalah hanya dalam rentang jendela Dasbor. Ada 2 makro: 
+ **\$1\$1\$1TimeFrom**
+ **\$1 \$1\$1TimeTo.**

Contoh berikut masalah filter permintaan JQL yang dibuat dalam jendela waktu dasbor: `createdDate >= $__timeFrom AND createdDate <= $__timeTo`

## Dapatkan hasil maksimal dari sumber data
<a name="jira-getmost"></a>

Menggunakan transformasi Grafana dan fitur bawaan lainnya dapat membantu Anda melihat data Jira Anda secara bermakna.

### Menggunakan transformasi untuk menambah JQL
<a name="gitlab-transformations-JQL"></a>

Meskipun ada banyak Transformasi di Grafana untuk dipilih, berikut ini memberikan augmentasi yang kuat untuk memberikan JQL beberapa SQL. features/power 

**Group By** Transformasi ini menyediakan fitur utama yang bukan bagian dari sintaks Jira JQL standar: Pengelompokan. Dengan menggunakan transformasi **Grup Berdasarkan**, Anda dapat mengelompokkan berdasarkan Sprint atau bidang Masalah lainnya, dan menggabungkan menurut grup untuk mendapatkan metrik seperti perkiraan kecepatan dan titik cerita vs penyelesaian aktual dalam Sprint.

**Outer** Join Mirip dengan SQL bergabung, Anda dapat menggabungkan 2 atau lebih kueri bersama-sama dengan bidang umum. Ini menyediakan cara untuk menggabungkan kumpulan data dari kueri dan menggunakan transformasi lain untuk menghitung nilai dari beberapa kueri/kumpulan data.

**Tambahkan Bidang dari Perhitungan** Mirip dengan ekspresi SQL, transformasi ini memungkinkan penambahan bidang baru ke kumpulan data Anda berdasarkan perhitungan bidang lain. Bidang yang digunakan dalam perhitungan dapat berasal dari satu kueri atau dari kueri yang telah Anda gabungkan bersama. Anda juga dapat menggabungkan perhitungan dan melakukan perhitungan dari bidang terhitung.

### Menggunakan transformasi dari Grafana untuk menjawab pertanyaan umum
<a name="gitlab-transformations-common"></a>

Anda dapat menggunakan Transformasi untuk memvisualisasikan, menggabungkan, mengelompokkan, dan menggabungkan kumpulan data, bersama dengan banyak jenis transformasi lainnya untuk mengubah hasil sederhana menjadi jawaban untuk pertanyaan kompleks.

**Bagaimana cara menunjukkan kecepatan per sprint?**

1.  Pilih Bidang: **Nama Sprint**, **Perkiraan titik cerita**. 

1.  Tambahkan filter JQL: `project = "Your Project" AND type != epic AND status = done order by created ASC` 

1.  Tambahkan **Grup Berdasarkan** transformasi: 
   + Nama Sprint \$1 Kelompokkan Berdasarkan
   + Perkiraan Poin Cerita \$1 Hitung \$1 Total

1. Pilih visualisasi **Bar Gauage**.

**Bagaimana cara menunjukkan apa yang telah Selesai vs Diperkirakan dalam Sprint?**

1.  Tambahkan kueri. Pertama, pilih Bidang: **Nama Sprint**, **Tanggal Mulai Sprint,,** Perkiraan **titik cerita**. 

   Kemudian tambahkan filter JQL: `project = 'Your Project' AND type != epic` 

1.  Tambahkan kueri kedua. Pertama, pilih Bidang: **Nama Sprint**, **Tanggal Mulai Sprint,,** Perkiraan **titik cerita**. 

   Kemudian tambahkan filter JQL: `project = 'Your Project' AND type != epic AND status = done` 

1.  Tambahkan **Grup Berdasarkan** transformasi: 
   + Nama Sprint \$1 Kelompokkan Berdasarkan
   + Tanggal Mulai Sprint \$1 Kelompokkan Berdasarkan
   + Perkiraan Poin Cerita \$1 Hitung \$1 Total

1. Pilih visualisasi **Grafik**.

**Berapa waktu rata-rata untuk menyelesaikan masalah dalam proyek saya?**

1.  Tambahkan kueri. Pertama, pilih Bidang: **Dibuat**, **Kategori Status Diubah**. 

   Kemudian tambahkan filter JQL: `project = 'Your Project' AND type != epic AND status = done` 

1.  Tambahkan transformasi: **Tambahkan bidang dari perhitungan**
   + Mode = Kurangi Baris
   + Perhitungan = Perbedaan

1.  Tambahkan transformasi: **Tambahkan bidang dari perhitungan**
   + Mode = Operasi Biner
   + Operasi = Perbedaan/86000000
   + Alias = Hari

1.  Tambahkan transformasi: **Atur bidang**
   + Sembunyikan bidang yang berbeda

1.  Tambahkan transformasi: **Filter data berdasarkan nilai**
   + Jenis Filter = Sertakan
   + kondisi = Cocokkan apapun
     + Bidang = Hari \$1 Pertandingan = Lebih Besar \$1 Nilai = 1

1.  Tambahkan transformasi: **Kurangi**
   + Mode = Seri ke Baris
   + Perhitungan = mean

1. Pilih visualisasi **Stat**.

# Connect ke sumber data MongoDB
<a name="AMG-mongodb-datasource"></a>

 Sumber Data MongoDB memungkinkan Anda memvisualisasikan data dari MongoDB di Amazon Managed Grafana. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Penggunaan
<a name="mongo-usage"></a>

### Editor kueri
<a name="mongo-query-editor"></a>

 Editor kueri mendukung sintaks yang sama dengan MongoDB Shell, dengan beberapa batasan: \$1 Anda hanya dapat menjalankan satu perintah/kueri. \$1 Hanya perintah baca yang didukung: **temukan** dan **agregat** \$1 *Sebagian besar* konstruktor Objek tidak didukung (dengan pengecualian **ISODate**, yang didukung) 

 Editor memperluas sintaks MongoDB Shell dengan cara berikut: 
+  **Pemilihan database** — Anda dapat memberikan nama database di tempat normal “db”: 
**catatan**  
Anda masih dapat menggunakan “db”. Ini akan merujuk ke database default dalam string koneksi Anda.

  ```
  sample_mflix.movies.find()
  ```
+  **Penyortiran agregat** — Biasanya penyortiran terjadi dengan langkah dalam pipeline agregat, namun tingkat gratis MongoDB Atlas tidak mengizinkan penyortiran. Kami telah memperluas sintaks untuk memungkinkannya bagi mereka yang menggunakan tingkat gratis. 
**catatan**  
MongoDB tidak melakukan pengurutan dengan sintaks ini. Pengurutan terjadi setelah hasil ditanyakan dari koleksi.

  ```
  sample_mflix.movies.aggregate({}).sort({"time": 1})
  ```
+  Dengan editor kosong, **Ctrl\$1Space** akan menampilkan pilihan semua database yang tersedia. 
+  Memasukkan titik setelah database akan menampilkan pilihan semua koleksi yang tersedia untuk database tersebut. 
+  Memasukkan titik setelah koleksi akan menampilkan metode kueri yang tersedia. 
+  Memasukkan titik setelah metode query akan menampilkan fungsi tambahan: sort/limit. 

#### Menjalankan kueri
<a name="mongo-running-the-query"></a>

 Tekan **Cmd \$1 S** untuk menjalankan kueri 

### Deret waktu
<a name="mongo-time-series"></a>

 Saat memvisualisasikan data deret waktu, plugin perlu mengetahui bidang mana yang akan digunakan sebagai waktu. Cukup proyeksikan bidang dengan nama alias “waktu”. Tipe data bidang harus berupa tanggal. 

 Anda dapat memaksa tipe data non-tanggal hingga saat ini. Melakukannya akan memungkinkan penggunaan bidang non-tanggal sebagai deret waktu. Contoh berikut menunjukkan cara mengonversi bidang int “tahun” ke tanggal yang diproyeksikan sebagai “waktu” menggunakan operator pipa MongoDB \$1dateFromParts . 

```
sample_mflix.movies.aggregate([
{"$match": { "year": {"$gt" : 2000} }},
{"$group": { "_id": "$year", "count": { "$sum": 1 }}},
{"$project": { "_id": 0, "count": 1, "time": { "$dateFromParts": {"year": "$_id", "month": 2}}}}
]
).sort({"time": 1})
```

### Diagnostik
<a name="mongo-diagnostics"></a>

 [Perintah Diagnostik](https://docs.mongodb.com/manual/reference/command/nav-diagnostic/) 

 Perintah diagnostik berikut saat ini didukung: “stats”, “ServerStatus”, "Status”, “getLog”, replSetGet "“, “ConnectionStatus”, “BuildInfo”, connPoolStats “dBStats”, “HostInfo”, “LockInfo” 

 Contoh: 

```
admin.connectionStatus()  // run the connectionStatus command
admin.connectionStatus({"authInfo.authenticatedUserRoles": 1})  // run and only return the "authInfo.authenticatedUserRoles" field
admin.connPoolStats({arg: "pool"})  // run the connPoolStats command and pass 1 argument
admin.serverStatus({args: {repl: 0, metrics:0}})  // run the serverStatus command and pass multiple args
```

### Makro
<a name="mongo-macros"></a>

 Anda dapat mereferensikan rentang waktu dasbor dalam kueri Anda.
+ ` $__timeFrom `— makro yang mereferensikan waktu mulai dasbor
+ ` $__timeTo `— makro yang mereferensikan waktu akhir dasbor

```
          $__timeTo -  ``` sample_mflix.movies.find({released: {$gt:
          "$__timeFrom"}}).sort({year: 1})
```

#### Variabel template
<a name="mongo-variables"></a>

MongoDB mendukung gagasan “Variabel Senyawa”, yang memungkinkan Anda menggunakan satu variabel sebagai beberapa variabel untuk melakukan filter multi-kunci yang kompleks.

Untuk membuat Variabel Senyawa, gunakan konvensi penamaan untuk memecah variabel dengan menggunakan garis bawah (harus dimulai dengan garis bawah): `_var1_var2` Saat menanyakan, respons harus dalam format: `val1-val2`

**Contoh: Saya ingin memfilter hasil pada nama film dan tahun.**

1. Buat variabel tipe Query: `_movie_year`

1. Atur kueri variabel ke kueri yang akan mengembalikan array item dengan satu properti film tahun, seperti yang ditunjukkan pada contoh berikut.

   ```
   // Example sample_mflix.movies.aggregate([
             {"$match": {year: {"$gt": 2011}}},
             {"$project": {_id: 0, movie_year: {"$concat":
             ["$title", " - ", {"$toString":"$year"}]}}}
             ])
   ```

   ```
    // [{"movie-year": "Ted - 2016"},
             {"movie-year": "The Terminator -
             1985"}]
   ```

1. Sekarang dalam kueri Anda, Anda dapat mereferensikan “Movie” dan “Year” sebagai variabel template terpisah menggunakan sintaks “\$1\$1variable”. 

##### Menggunakan filter ad-hoc
<a name="mongo-adhoc"></a>

Selain variabel tipe “ad-hoc filter” standar dari nama apa pun, variabel pembantu kedua harus dibuat. Ini harus berupa tipe “konstan” dengan nama `mongodb\$1adhoc\$1query` dan nilai yang kompatibel dengan editor kueri. Hasil kueri akan digunakan untuk mengisi filter yang dapat dipilih. Anda dapat memilih untuk menyembunyikan variabel ini dari tampilan karena tidak memiliki tujuan lebih lanjut.

```
          sample_mflix.movies.aggregate([
          {"$group": { "_id": "$year"}},
          {"$project": { "year": "$_id","_id":
          0 }} ] )
```

# Connect ke sumber data New Relic
<a name="new-relic-data-source"></a>

 Bagian ini mencakup [APM](https://newrelic.com/products/application-monitoring) Relik Baru dan [Wawasan untuk](https://newrelic.com/products/insights) Grafana. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Fitur
<a name="newrelic-features"></a>
+  Variabel template 
  +  Nama metrik 
  +  Nilai metrik 
+  Anotasi 
+  Aliasing 
  +  Nama metrik 
  +  Nilai metrik 
+  Filter ad-hoc 
  +  Saat ini tidak didukung 
+  Peringatan 

## Konfigurasi
<a name="newrelic-configuration"></a>

 Tambahkan sumber data, isi kolom untuk [kunci API admin, kunci API](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#admin) [pribadi](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key), dan [ID akun](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/account-id) Anda. 

## Penggunaan
<a name="newrelic-usage"></a>

### Jenis layanan
<a name="newrelic-service-types"></a>
+  **Metrik**[; untuk kueri New Relic APM melalui REST API New Relic.](https://docs.newrelic.com/docs/apis/rest-api-v2) 
+  **Wawasan**[; untuk menanyakan Wawasan Relik Baru melalui NRQL.](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions) 

### Alias
<a name="newrelic-aliases"></a>

 Anda dapat menggabungkan plaintext dengan variabel berikut untuk menghasilkan output kustom. 


|  Variabel  |  Deskripsi  |  Nilai contoh  | 
| --- | --- | --- | 
|  \$1\$1\$1nr\$1metric  |  Nama metrik  |  CPU/User waktu  | 
|  \$1\$1\$1nr\$1metric\$1value  |  Nilai metrik  |  nilai rata-rata\$1  | 

Contoh:

```
    <para>
      Server: $__nr_server Metric: $__nr_metric
    </para>
    <programlisting>
```

### Template dan variabel
<a name="newrelic-templates-and-variables"></a>

1.  Buat variabel template untuk dasbor Anda. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md). 

1.  Pilih jenis “Kueri”. 

1.  Pilih sumber data “New Relic”. 

1.  Merumuskan kueri menggunakan titik akhir [REST API](https://docs.newrelic.com/docs/apis/rest-api-v2) relatif (tidak termasuk ekstensi file). 

Daftar aplikasi yang tersedia:

```
    <para>
      applications
    </para>
    <programlisting>
```

Daftar metrik yang tersedia untuk aplikasi:

```
    <para>
      applications/{application_id}/metrics
    </para>
    <programlisting>
```

### NRQL makro
<a name="nrql-macros"></a>

 Untuk meningkatkan pengalaman menulis saat membuat kueri New Relic Query Language (NRQL), editor mendukung makro yang telah ditentukan: 
+  `$__timeFilter`(atau`[[timeFilter]]`) akan melakukan interpolasi `SINCE &lt;from&gt; UNTIL &lt;to&gt;` berdasarkan rentang waktu dasbor Anda. 

Contoh:

```
    <para>
      SELECT average(value) FROM $event_template_variable
      $__timeFilter TIMESERIES
    </para>
    <programlisting>
```

 Untuk petunjuk lebih lanjut tentang cara menggunakan makro dan variabel template, lihat bagian bantuan editor. 

### Peringatan peristiwa
<a name="newrelic-alert-events"></a>

 Pilih sumber data New Relic Anda dan atur filter tambahan. Tanpa filter yang disetel, semua acara akan dikembalikan. 

 Jika Anda ingin memfilter peristiwa berdasarkan *ID Entitas*, gunakan variabel template karena Anda akan dapat memilih nama entitas alih-alih ID. Misalnya, untuk memfilter peristiwa untuk aplikasi tertentu, buat variabel `_$app_` yang mengambil daftar aplikasi dan menggunakannya sebagai filter *ID Entity*. 

### Acara penyebaran
<a name="newrelic-deployment-events"></a>

 *ID Aplikasi* adalah bidang wajib. 

# Connect ke sumber data Oracle Database
<a name="oracle-datasource-AMG"></a>

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Menambahkan sumber data
<a name="datasource-configuration"></a>

 Pilih **Sumber data** di panel kiri Grafana. 

 Pilih Tambahkan Sumber Data: 

 Masukkan **oracle** untuk menemukan sumber data. 

 Masukkan detail server Oracle. 

 Masukkan nama host (atau alamat IP) bersama dengan nomor port, dan nama pengguna dan kata sandi untuk terhubung. 

 Dengan opsi tnsnames toggle, entri valid apa pun yang ditemukan di file konfigurasi tnsnames.ora Anda dapat digunakan, bersama dengan otentikasi dasar. 

 Mirip dengan contoh sebelumnya, tetapi menggunakan Kerberos untuk otentikasi. Lihat panduan penyiapan khusus kerberos untuk detail tentang cara mengonfigurasi OS atau wadah docker untuk menggunakan kerberos. 

 Secara opsional mengubah zona waktu yang digunakan untuk terhubung ke server Oracle dan untuk digunakan oleh makro sadar zona waktu. Pengaturan default adalah UTC. 

 Simpan dan Uji sumber data, Anda akan melihat pesan hijau dengan “Koneksi Database OK” 

## Penggunaan
<a name="usage-4"></a>

### Makro
<a name="macros-1"></a>

 Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro. Nama kolom harus terkandung dalam tanda kutip ganda (`"`). 


|  Contoh makro  |  Deskripsi  | 
| --- | --- | 
|  \$1\$1\$1\$1time (DateColumn) \$1 \$1 Akan diganti dengan ekspresi untuk mengganti nama kolom menjadi `time`. Misalnya, `DateColumn as time` \$1\$1\$1\$1timeEpoch (DateColumn) \$1  |  Akan diganti dengan ekspresi untuk mengganti nama kolom menjadi time dan mengubah nilai menjadi stempel waktu unix (dalam milidetik).  | 
|  \$1\$1\$1\$1TimeFilter (DateColumn) \$1 \$1 Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, `DateColumn ANTARA TO\$1DATE ('19700101', 'yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552001 DAN TO\$1DATE ('19700101', 'yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552002` \$1\$1\$1\$1timeFrom () \$1  |  Akan diganti dengan dimulainya pemilihan waktu aktif yang saat ini dikonversi ke tipe DATE data. Misalnya, TO\$1DATE('19700101','yyyymmdd') \$1 (1/24/60/60/1000) \$1 1500376552001.  | 
|  \$1\$1\$1\$1timeTo () \$1 \$1 Akan diganti dengan akhir pemilihan waktu aktif yang saat ini dikonversi ke tipe data `DATE`. \$1\$1\$1\$1TimeGroup (DateColumn, “5m”) \$1  |  Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY.  | 
|  \$1\$1\$1\$1TimeGroup (DateColumn, “5m" [, fillvalue]) \$1  |  Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Memberikan fillValue NULL atau nilai mengambang akan secara otomatis mengisi seri kosong dalam rentang waktu dengan nilai itu. Misalnya, t i m e G r o u p c r e a t e d A t, ′1 m ′, 0. \$1\$1\$1TimeGroup (DateColumn, “5m”, 0) \$1.  | 
|  \$1 t i m e G r o u p (d a t e C o l u m n, '5 m ', N U L L) \$1 \$1 S a m e a s a b o v e b u t U U L l l l l l e u s e e s s s s a v a l u u e e m m i n g p o i n t s. \$1\$1\$1TimeGroup (DateColumn, “5m”, sebelumnya) \$1  |  Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan.  | 
|  \$1\$1\$1\$1 unixEpochFilter (DateColumn) \$1 \$1 Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu unix (dalam milidetik). Misalnya, `DateColumn >= 1500376552001 DAN DateColumn <= 1500376552002` \$1\$1\$1\$1 () \$1 unixEpochFrom  |  Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif sebagai stempel waktu unix. Misalnya, 1500376552001.  | 
|  \$1\$1\$1\$1unixEpochTo()\$1  |  Akan diganti dengan akhir pemilihan waktu yang aktif saat ini sebagai stempel waktu unix. Misalnya, 1500376552002.  | 

 Plugin ini juga mendukung notasi menggunakan kawat gigi`{}`. Gunakan notasi ini ketika kueri diperlukan di dalam parameter. 

**catatan**  
Gunakan satu jenis notasi per kueri. Jika kueri membutuhkan tanda kurung gigi, semua makro dalam kueri harus menggunakan tanda kurung gigi. 

```
$__timeGroup{"dateColumn",'5m'}
$__timeGroup{SYS_DATE_UTC("SDATE"),'5m'}
$__timeGroup{FROM_TZ(CAST("SDATE" as timestamp), 'UTC'), '1h'}
```

 Editor kueri memiliki tautan **SQL yang Dihasilkan** yang muncul setelah kueri berjalan, saat dalam mode edit panel. Ketika Anda memilih link, itu memperluas dan menunjukkan string SQL interpolasi mentah yang dijalankan. 

### Kueri tabel
<a name="table-queries"></a>

 Jika opsi **Format sebagai** kueri diatur ke **Tabel** maka pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom & baris apa pun yang dikembalikan kueri Anda. Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `as` SQL biasa. 

### Pertanyaan deret waktu
<a name="time-series-queries"></a>

 Jika Anda menyetel **Format sebagai** **deret Waktu**, untuk digunakan dalam panel Grafik misalnya, kueri harus mengembalikan kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik apa pun yang mewakili epoch unix dalam hitungan detik. Grafana menafsirkan kolom DATE dan TIMESTAMP tanpa zona waktu eksplisit sebagai UTC. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. 

 Contoh kode berikut menunjukkan `metric` kolom. 

```
SELECT
  $__timeGroup("time_date_time", '5m') AS time,
  MIN("value_double"),
  'MIN' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY $__timeGroup("time_date_time", '5m')
ORDER BY time
```

### Lebih banyak kueri — menggunakan oracle-fake-data-gen
<a name="more-queries---using-oracle-fake-data-gen"></a>

```
SELECT
  $__timeGroup("createdAt", '5m') AS time,
  MIN("value"),
  'MIN' as metric
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
GROUP BY $__timeGroup("createdAt", '5m')
ORDER BY time
```

 Contoh kode berikut menunjukkan deret waktu Data Palsu. 

```
SELECT
  "createdAt",
  "value"
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
ORDER BY "createdAt" ASC
```

```
SELECT
  "createdAt" as time,
  "value" as value
FROM "grafana_metric"
WHERE $__timeFilter("createdAt")
ORDER BY time ASC
```

 Contoh berikut menunjukkan hasil tabel yang berguna. 

```
select tc.table_name Table_name
,tc.column_id Column_id
,lower(tc.column_name) Column_name
,lower(tc.data_type) Data_type
,nvl(tc.data_precision,tc.data_length) Length
,lower(tc.data_scale) Data_scale
,tc.nullable nullable
FROM all_tab_columns tc
,all_tables t
WHERE tc.table_name = t.table_name
```

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

 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. Kotak dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda. 

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

 Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri Oracle yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci atau nilai kunci yang ditampilkan sebagai kotak pilih dropdown. 

 Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. 

```
SELECT "hostname" FROM host
```

 Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`. 

```
SELECT "host.hostname", "other_host.hostname2" FROM host JOIN other_host ON host.city = other_host.city
```

 Untuk menggunakan makro yang bergantung pada rentang waktu seperti `$__timeFilter("time_column")` dalam kueri Anda, mode penyegaran variabel template perlu diatur ke *On Time Range Change*. 

```
SELECT "event_name" FROM event_log WHERE $__timeFilter("time_column")
```

 Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik maka nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai yang memungkinkan Anda memiliki nama ramah sebagai teks dan id sebagai nilainya. Contoh kode berikut menunjukkan query dengan `hostname` sebagai teks dan `id` sebagai nilai. 

```
SELECT "hostname" AS __text, "id" AS __value FROM host
```

 Anda juga dapat membuat variabel bersarang. Misalnya, jika Anda memiliki variabel lain bernama`region`. Kemudian Anda dapat meminta variabel host hanya menampilkan host dari wilayah yang dipilih saat ini dengan kueri seperti ini (jika `region` adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai). 

```
SELECT "hostname" FROM host WHERE region IN('$region')
```

#### Menggunakan variabel dalam kueri
<a name="using-variables-in-queries-1"></a>

 Nilai variabel template hanya dikutip ketika variabel template adalah`multi-value`. 

 Jika variabel adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai. 

 Ada dua sintaks: 

 `$<varname>`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  "atimestamp" as time,
  "aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('$hostname')
ORDER BY "atimestamp" ASC
```

 `[[varname]]`Contoh dengan variabel template bernama`hostname`: 

```
SELECT
  "atimestamp" as time,
  "aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('[[hostname]]')
ORDER BY atimestamp ASC
```

# Connect ke sumber data Salesforce
<a name="salesforce-AMG-datasource"></a>

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

Sumber data Salesforce memungkinkan Anda memvisualisasikan data dari Salesforce dalam Grafana Terkelola Amazon.

Untuk menggunakan sumber data ini, Anda harus memiliki akun [Salesforce](https://www.salesforce.com/) dan Aplikasi Terhubung [Salesforce](https://help.salesforce.com/articleView?id=sf.connected_app_overview.htm&type=5).

## Keterbatasan yang Sudah Diketahui
<a name="salesforce-known-limitations"></a>
+  Filter ad-hoc belum didukung. 
+  Hanya kueri SOQL, dan data yang dapat diakses melalui SOQL yang saat ini didukung. Format kueri SOSL dan SAQL belum didukung. 

## Pengaturan yang diperlukan
<a name="salesforce-settings"></a>

Pengaturan berikut diperlukan.

**catatan**  
Plugin saat ini menggunakan OAuth 2.0 Username-Password Flow. URL panggilan balik yang diperlukan di Aplikasi Terhubung tidak digunakan. Dengan demikian, Anda dapat mengaturnya ke URL yang valid.


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Enable OAuth settings  |  Anda harus memeriksa ini untuk mengaktifkan OAuth.  | 
|  Callback URL  |  Tidak digunakan dalam plugin ini, sehingga Anda dapat menentukan URL yang valid.  | 
|  Selected OAuth Scopes (minimum requirements)  | Akses dan Kelola data Anda (api). | 
|  Require Secret for Refresh Token Flow  |  Anda dapat mengaktifkan atau menonaktifkan ini.  | 

## Menambahkan sumber data
<a name="salesforce-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 
**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

1.  Pilih **Salesforce** dari daftar sumber data. 

1. Masukkan informasi berikut:
   + Untuk **Nama Pengguna**, masukkan nama pengguna untuk akun Salesforce yang ingin Anda gunakan untuk menghubungkan dan menanyakan Salesforce.
   + Untuk **Kata Sandi**, masukkan kata sandi untuk pengguna tersebut.
   + Untuk **Token Keamanan**, masukkan token keamanan untuk pengguna tersebut.
   + Untuk **Kunci Konsumen**, masukkan kunci Konsumen untuk terhubung ke Salesforce. Anda dapat memperoleh ini dari Aplikasi Salesforce Connected Anda.
   + Untuk **Rahasia Konsumen**, masukkan rahasia Konsumen untuk terhubung ke Salesforce. Anda dapat memperoleh ini dari Aplikasi Salesforce Connected Anda.
   + Untuk **Gunakan Sandbox**, pilih ini jika Anda ingin menggunakan kotak pasir Salesforce.

## Kueri sumber data Salesforce
<a name="salesforce-query"></a>

Editor kueri mendukung mode Query Builder dan SOQL Editor. SOQL adalah singkatan dari [Salesforce](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm) Object Query Language. 

### Pembuat Kueri (Pembuat SOQL)
<a name="salesforce-query-builder"></a>

Query Builder adalah antarmuka yang ramah pengguna untuk membangun kueri SOQL. Jika Anda tidak terbiasa menulis kueri SOQL, Anda dapat menggunakan mode ini untuk membangun SOQL untuk menanyakan objek Salesforce. **Bidang FROM di pembuat kueri mengacu pada entitas atau entitas di Salesforce.** Anda harus memilih bidang **FROM** sebelum operasi lain di pembuat kueri. Setelah Anda memilih bidang **FROM**, Anda harus memilih mode pembangun. SOQL Builder saat ini mendukung mode berikut.
+ `List`— Daftar item dengan bidangnya dari tabel/salesforce yang dipilih. Gunakan mode ini untuk mendapatkan hasil seperti, “Tunjukkan daftar peluang yang dibuat pada kuartal fiskal ini bersama dengan nama, nilai, dan tahapannya.”
+ `Aggregate`— Agregat item dalam suatu entitas. Gunakan mode ini untuk mendapatkan hasil seperti, “Hitung peluang yang dibuat pada bulan lalu.” atau “Berapa nilai total peluang yang dikelompokkan berdasarkan nama panggung mereka?”
+ `Trend`— Menampilkan hasil agregat dari waktu ke waktu. Gunakan mode ini untuk mendapatkan hasil seperti, “Hitung jumlah peluang dengan CreatedDate.” atau “Berapa jumlah total nilai yang dikelompokkan berdasarkan tanggal penutupan peluang.”

Setelah Anda memilih `Entity/FROM` dan **mode** di editor kueri, buat kueri Anda menggunakan opsi berikut. 


|  **Bidang**  |  **Dapat diterapkan ke**  |  **Deskripsi**  | 
| --- | --- | --- | 
|  SELECT |  SEMUA  |  Pilih daftar bidang yang ingin Anda lihat. Untuk tampilan agregat atau tren, pilih juga bagaimana Anda ingin menggabungkan nilai. | 
|  WHERE |  SEMUA  |  (Opsional) Tentukan kondisi filter. Hasilnya disaring berdasarkan kondisi yang Anda pilih. | 
|  ORDER BY |  DAFTAR, AGREGAT  |  (Opsional) Pilih nama bidang dan urutan pengurutan yang Anda inginkan untuk hasilnya. | 
|  LIMIT |  DAFTAR, AGREGAT  |  (Opsional) Batasi jumlah hasil yang dikembalikan. Secara default, nilainya adalah 100. | 
|  GROUP BY |  AGREGAT  |  (Opsional) Pilih bidang jika Anda ingin membagi nilai agregat dengan bidang tertentu. | 
|  BIDANG WAKTU |  KECENDERUNGAN  |  Tentukan bidang tanggal yang ingin Anda kelompokkan hasil Anda. Hasil disaring berdasarkan rentang pemilih waktu Grafana. | 

Jika Anda mengonfigurasi bidang sebelumnya di editor kueri, Anda juga akan melihat pratinjau SOQL yang dihasilkan di bawah editor kueri. Jika Anda diblokir dengan batasan apa pun di pembuat kueri, Anda dapat dengan aman beralih ke Editor SOQL, di mana Anda dapat menyesuaikan kueri SOQL yang dihasilkan.

### Editor SOQL
<a name="salesforce-SOQL-editor"></a>

Editor SOQL mentah menyediakan opsi untuk menanyakan objek Salesforce melalui kueri SOQL mentah. Editor SOQL memberikan saran pelengkapan otomatis, seperti entitas yang tersedia per tabel dan bidang yang sesuai. Gunakan Ctrl\$1Spasi setelah SELECT atau WHERE untuk melihat entitas yang tersedia per tabel. Anda dapat melihat bidang yang tersedia, jika Anda memasukkan titik setelah nama entitas.

**Pintasan**

Gunakan CTRL\$1SPACE untuk menunjukkan penyelesaian kode, yang menunjukkan opsi kontekstual yang tersedia.

CMD \$1S menjalankan kueri.

**Kueri sebagai deret waktu**

Buat kueri deret waktu dengan mengalihkan bidang tanggal ke waktu, dan bidang metrik ke metrik, lalu kelompokkan berdasarkan metrik dan tanggal. Berikut ini adalah contohnya:

```
SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate
```

**Makro**

Untuk memfilter berdasarkan rentang waktu dasbor, Anda dapat menggunakan Makro dalam kueri SOQL Anda:
+ `$__timeFrom`— Akan diganti dengan dimulainya pemilihan waktu aktif yang saat ini dikonversi ke tipe `time` data.
+ `$__timeTo`— Akan diganti pada akhir pemilihan waktu aktif yang saat ini dikonversi ke tipe `time` data.
+ `$__quarterStart`— Awal kuartal fiskal (berasal dari Pengaturan Tahun SalesForce Fiskal).
+ `$__quarterEnd`— Akhir kuartal fiskal (berasal dari Pengaturan Tahun SalesForce Fiskal).

```
SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom
```

## Template dan variabel
<a name="salesforce-templates"></a>

Untuk menambahkan variabel kueri Salesforce baru, lihat. [Menambahkan variabel kueri](variables-types.md#add-a-query-variable) Gunakan sumber data Salesforce Anda sebagai sumber data Anda. Anda dapat menggunakan kueri SOQL apa pun di sini.

Jika Anda ingin menggunakan name/value pasangan, misalnya id pengguna dan nama pengguna, kembalikan dua bidang dari kueri SOQL Anda. Bidang pertama akan digunakan sebagai ID. Lakukan ini ketika Anda ingin memfilter berdasarkan kunci (ID, dll) di editor kueri SOQL Anda.

Gunakan variabel dalam kueri SOQL Anda dengan menggunakan sintaks Variabel. Lihat informasi yang lebih lengkap di [Sintaks variabel](templates-and-variables.md#variable-syntax).

# Connect ke sumber data SAP HANA
<a name="saphana-AMG-datasource"></a>

[SAP HANA](https://www.sap.com/products/technology-platform/hana.html) adalah database dalam memori berkinerja tinggi yang mempercepat pengambilan keputusan dan tindakan real-time yang digerakkan oleh data. Ini dikembangkan dan dipasarkan oleh SAP. Plugin sumber data SAP HANA membantu Anda menghubungkan instance SAP HANA Anda dengan Grafana.

Dengan plugin SAP HANA Grafana Enterprise, Anda dapat memvisualisasikan data SAP HANA Anda bersama semua sumber data Anda yang lain di Grafana serta data log dan metrik dalam konteks. Plugin ini mencakup editor kueri bawaan, mendukung anotasi, dan memungkinkan Anda untuk mengatur ambang peringatan, mengontrol akses, mengatur izin, dan banyak lagi.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Fitur
<a name="saphana-features"></a>
+ **Editor kueri** - Plugin ini dilengkapi dengan editor kueri SQL bawaan dengan penyorotan sintaks yang memungkinkan Anda memvisualisasikan deret waktu atau data tabel dan secara otomatis melengkapi makro Grafana dasar.
+ **Izin sumber data** — Kontrol siapa yang dapat melihat atau menanyakan data SAP HANA di Grafana.
+ **Anotasi** — Hamparkan peristiwa atau data SAP HANA pada grafik Grafana apa pun untuk mengkorelasikan peristiwa dengan data grafik lainnya.
+ **Peringatan** - Atur toko metrik berbasis peringatan di SAP HANA.
+ **Variabel untuk kueri** — Buat variabel template di Grafana, yang didasarkan pada data SAP HANA, dan sertakan variabel dalam kueri SAP HANA untuk membuat dasbor interaktif.

## Menambahkan sumber data
<a name="saphana-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 
**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

1.  Pilih **SAP HANA** dari daftar sumber data. 

1. Di editor Config, masukkan informasi berikut:
   + Untuk **alamat Server**, Berikan alamat instance SAP HANA. Contoh:`xxxxxxx-xxxx-xxxx-xxxx-xxxxxxx.hana.trial-us10.hanacloud.ondemand.com`.
   + Untuk **port Server**, sediakan port instance SAP HANA.
   + Untuk **Username**, masukkan nama pengguna yang akan digunakan untuk terhubung ke instance SAP HANA.
   + Untuk **Kata Sandi**, masukkan kata sandi untuk pengguna ini.
   + (Opsional) Aktifkan **Lewati verifikasi TLS** jika Anda ingin melewati verifikasi TLS.
   + (Opsional) Aktifkan **Auth Klien TLS** jika Anda perlu memberikan sertifikat dan kunci klien.
   + (Opsional) Aktifkan **Dengan sertifikat CA** jika Anda ingin mengaktifkan verifikasi Sertifikat TLS yang ditandatangani sendiri.
   + (Opsional) Untuk **skema Default**, masukkan skema default yang akan digunakan. Jika Anda menghilangkan ini, Anda harus menentukan skema di setiap kueri. 

**Akses dan izin**

Untuk menghubungkan Grafana ke SAP HANA, gunakan kredensi khusus. Hanya berikan izin yang diperlukan kepada pengguna. Pertama, buat pengguna terbatas dengan nama pengguna dan kata sandi. Query berikut adalah contoh untuk membuat pengguna terbatas. Kueri ini juga menonaktifkan perubahan kata sandi paksa.

```
CREATE RESTRICTED USER <USER> PASSWORD <PASSWORD> NO FORCE_FIRST_PASSWORD_CHANGE;
```

Selanjutnya, izinkan pengguna untuk menghubungkan sistem melalui klien seperti Grafana dengan yang berikut:

```
ALTER USER <USER> ENABLE CLIENT CONNECT;
```

Terakhir, berikan pengguna akses ke tampilan, tabel, dan skema yang diperlukan.

```
ALTER USER <USER> GRANT ROLE PUBLIC;
GRANT SELECT ON SCHEMA <SCHEMA> TO <USER>;
```

**Izin tingkat pengguna**

Batasi akses ke SAP HANA dengan mengklik tab Izin di halaman konfigurasi sumber data untuk mengaktifkan izin sumber data. Pada halaman izin, Admin dapat mengaktifkan izin dan membatasi izin kueri untuk Pengguna dan Tim tertentu.

## Editor kueri
<a name="saphana-queryeditor"></a>

Plugin SAP HANA Grafana dilengkapi dengan editor kueri SQL tempat Anda dapat memasukkan kueri HANA apa pun. Jika kueri Anda mengembalikan data timeseries, Anda dapat memformatnya sebagai timeseries untuk memvisualisasikannya dalam panel grafik. Editor kueri menyediakan penyelesaian otomatis untuk makro Grafana yang didukung dan penyorotan sintaks kueri SQL Anda.

## Anotasi
<a name="saphana-annotations"></a>

Anda dapat menggunakan kueri SAP HANA sebagai sumber anotasi Grafana. Kueri anotasi Anda harus mengembalikan setidaknya satu kolom waktu dan satu kolom teks. Untuk informasi selengkapnya tentang anotasi, lihat[Anotasi](dashboard-annotations.md).

**Untuk membuat anotasi dari SAP HANA**

1.  Pilih ikon roda gigi **pengaturan Dasbor**. 

1.  Dari menu sebelah kiri, pilih **Anotasi**, **Baru**. 

1.  Dari menu drop-down **sumber data**, pilih instance sumber data SAP HANA Anda. 

1.  Di bidang **Query**, masukkan kueri SAP HANA yang mengembalikan setidaknya satu bidang waktu dan satu bidang teks. 

1.  Di menu tarik-turun **Format sebagai**, pilih **Seri Waktu**. 

1.  Untuk setiap anotasi, konfigurasikan bidang **Dari**. 

## Template dan variabel
<a name="saphana-templates"></a>

Untuk menambahkan variabel kueri SAP HANA baru, lihat[Menambahkan variabel kueri](variables-types.md#add-a-query-variable). Gunakan sumber data SAP HANA Anda sebagai sumber data Anda.

Contoh query berikut mengembalikan daftar yang berbeda `username` dari dari `users` tabel.

```
select distinct("username") from "users"
```

**catatan**  
Pastikan untuk hanya memilih satu kolom dalam kueri variabel Anda. Jika query Anda mengembalikan dua kolom, kolom pertama akan digunakan sebagai nilai tampilan dan kolom kedua akan digunakan sebagai nilai aktual dari variabel. Jika kueri Anda mengembalikan lebih dari dua kolom, mereka akan ditolak.

### Template dan variabel
<a name="saphana-Grafana-variables"></a>

Anda dapat menggunakan variabel Grafana apa pun dalam kueri Anda. Contoh berikut menunjukkan cara menggunakan variabel tunggal/multi dalam kueri Anda.

```
-- For example, following query
select * from "users" where "city" = ${city}
-- will be translated into
select * from "users" where "city" = 'london'
--- where you can see ${city} variable translated into actual value in the variable
```

Mirip dengan teks, variabel juga berfungsi untuk bidang numerik. Dalam contoh di bawah ini, `${age}` adalah variabel kotak teks di mana ia menerima angka dan kemudian membandingkan dengan bidang numerik dalam tabel.

```
select * from "users" where "age" > ${age}
--- wil be translated into
select * from "users" where "age" > '36'
```

Jika variabel Anda mengembalikan beberapa nilai, maka Anda dapat menggunakannya dalam `in` kondisi query SAP HANA seperti di bawah ini. Perhatikan tanda kurung yang mengelilingi variabel untuk membuat `where in` kondisi valid di SAP HANA.

```
select * from "users" where "city" in (${cities})
--- will be translated into
select * from "users" where "city" in ('london','perth','delhi')
--- where you can see ${cities} turned into a list of grafana variables selected.
--- You can also write the same query using shorthand notation as shown below
select * from "users" where "city" in ($cities)
```

### Makro
<a name="saphana-macros"></a>
+ `$__timeFilter(<time_column>)`— Menerapkan rentang waktu Grafana ke kolom yang ditentukan saat digunakan dalam kueri mentah. Berlaku untuk kolom date/timestamp/long waktu.
+ `$__timeFilter(<time_column>, <format>)`Sama seperti di atas. Tetapi memberikan kemampuan untuk menentukan format time\$1column yang disimpan dalam database.
+ `$__timeFilter(<time_column>, "epoch", <format>)`— Sama seperti di atas tetapi dapat digunakan ketika kolom waktu Anda dalam zaman. format dapat menjadi salah satu dari 's', 'ms' dan 'ns'.
+ `$__fromTimeFilter(<time_column>)`— Sama seperti di atas tetapi dapat digunakan ketika kolom waktu Anda dalam zaman. format dapat menjadi salah satu dari 's', 'ms' dan 'ns'.
+ `$__fromTimeFilter(<time_column>, <comparison_predicate>)`— Sama seperti di atas tetapi dapat menentukan comparison\$1predicate.
+ `$__fromTimeFilter(<time_column>, <format>)`— Sama seperti di atas tetapi dapat menentukan format kolom waktu.
+ `$__fromTimeFilter(<time_column>, <format>, <comparison_predicate>)`— Sama seperti di atas tetapi dapat menentukan comparison\$1predicate.
+ `$__toTimeFilter(<time_column>)`— Mengembalikan kondisi waktu berdasarkan grafana ke waktu melalui bidang waktu.
+ `$__toTimeFilter(<time_column>, <comparison_predicate>)`— Sama seperti di atas tetapi dapat menentukan comparison\$1predicate.
+ `$__toTimeFilter(<time_column>, <format>)`— Sama seperti di atas tetapi dapat menentukan format kolom waktu.
+ `$__toTimeFilter(<time_column>, <comparison_predicate>)`— Sama seperti di atas tetapi dapat menentukan comparison\$1predicate.
+ `$__timeGroup(<time_column>, <interval>)`— Memperluas kolom waktu ke dalam kelompok interval. Berlaku untuk kolom date/timestamp/long waktu..

**\$1 \$1\$1TimeFilter () makro** <time\$1column>

Contoh berikut menjelaskan `$__timeFilter(<time_column>)` makro:

```
- In the following example, the query
select ts, temperature from weather where $__timeFilter(ts)
--- will be translated into
select ts, temperature from weather where ts > '2021-02-24T12:52:48Z' AND ts < '2021-03-24T12:52:48Z'
--- where you can see the grafana dashboard's time range is applied to the column ts in the query.
```

**\$1\$1\$1TimeFilter (,) makro** <time\$1column><format>

Dalam beberapa kasus, kolom waktu dalam database disimpan dalam format khusus. Contoh berikut menjelaskan `$__timeFilter(<time_column>, <format>)` makro, yang membantu memfilter stempel waktu khusus berdasarkan pemilih waktu grafana:

```
SELECT TO_TIMESTAMP("TS",'YYYYMMDDHH24MISS') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYYMMDDHH24MISS") -- TS is in 20210421162012 format
SELECT TO_TIMESTAMP("TS",'YYYY-MON-DD') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYY-MON-DD") -- TS is in 2021-JAN-15 format
```

Di makro, formatnya bisa menjadi salah satu format HANA yang valid yang cocok dengan kolom stempel waktu Anda. Misalnya, `YYYYMMDDHH24MISS` adalah format yang valid ketika data Anda disimpan dalam `20210421162012` format.

**\$1\$1\$1TimeFilter (, “epoch”) makro** <time\$1column><format>

Dalam beberapa kasus, stempel waktu disimpan sebagai stempel waktu epoch di DB Anda. Contoh berikut menjelaskan `$__timeFilter(<time_column>, "epoch" <format>)` makro yang membantu menyaring stempel waktu epoch berdasarkan pemilih waktu grafana. Dalam makro, format bisa menjadi salah satu ms, s atau ns. Jika tidak ditentukan, s akan diperlakukan sebagai format default.

```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","s") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms") -- Example : TIMESTAMP field stored in epoch_ms format 1257894000000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000000000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ns") -- Example : TIMESTAMP field stored in epoch_nanoseconds format 1257894000000000000
```

Alih-alih menggunakan argumen ketiga ke \$1\$1\$1timeFilter, Anda dapat menggunakan salah satu epoch\$1s, epoch\$1ms atau epoch\$1ns sebagai argumen kedua Anda..

```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms")
-- is same as
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch_ms")
```

**Makro \$1\$1\$1 fromTimeFilter () dan \$1\$1\$1 toTimeFilter ()**

`$__fromTimeFilter()`Makro berkembang ke kondisi selama bidang waktu berdasarkan pemilih waktu Grafana dari waktu.

Ini menerima tiga parameter. Parameter pertama adalah nama bidang waktu. Anda dapat meneruskan comparison\$1predicate atau format kolom waktu sebagai argumen kedua. Jika Anda ingin meneruskan keduanya, maka formatnya adalah parameter kedua dan gunakan comparison\$1predicate sebagai parameter ketiga Anda.

****<format>Jika format tidak ditentukan, plugin akan mengasumsikan bahwa kolom waktu adalah timestamp/date tipe. Jika kolom waktu Anda disimpan dalam format lain selain stempel waktu/tanggal, maka berikan format sebagai argumen kedua. <format>dapat berupa salah satu epoch\$1s, epoch\$1ms, epoch\$1ns atau format khusus lainnya seperti. YYYY-MM-DD

****<comparison\$1predicate>parameter opsional. Jika tidak diteruskan, plugin akan menggunakan> sebagai predikat perbandingan. <comparison\$1predicate>bisa menjadi salah satu dari =,\$1 =, <>, <, <=, >, >=

`$__toTimeFilter()`bekerja sama dengan \$1\$1\$1 fromTimeFilter (). Alih-alih menggunakan Grafana dari waktu ke waktu, itu akan digunakan untuk waktu. Juga predikat perbandingan default adalah <.

**\$1 \$1\$1TimeGroup (,)** <time\$1column><interval> 

Misalnya, makro \$1\$1\$1TimeGroup (timecol,1h) diperluas ke SERIES\$1ROUND (“timecol”, 'INTERVAL 1 HOUR') dalam kueri.

Contoh berikut menjelaskan `$__timeGroup(<time_column>, <interval>) macro.`

```
SELECT $__timeGroup(timestamp,1h),  "user", sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp,1h), "user"
ORDER BY $__timeGroup(timestamp,1h) ASC
```

Ini diterjemahkan ke dalam kueri berikut di `$__timeGroup(timestamp,1h)` mana diperluas ke`SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR')`.

```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR') as "timestamp",  "user", sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2020-01-01T00:00:00Z' AND "timestamp" < '2020-01-01T23:00:00Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR'), "user"
ORDER BY "timestamp" ASC
```

**catatan**  
Saat menggunakan grup dengan makro \$1\$1\$1TimeGroup, pastikan bahwa pilihan Anda, urutkan menurut bidang mengikuti nama yang sama dengan grup Anda menurut bidang. Jika tidak, HANA mungkin tidak mengenali kueri.

Jika Anda tidak ingin membuat kode keras interval dalam fungsi \$1\$1\$1timeGroup (), maka Anda dapat menyerahkannya ke Grafana dengan menentukan \$1\$1\$1interval sebagai interval Anda. Grafana akan menghitung interval itu dari rentang waktu dasbor. Contoh kueri:

```
SELECT $__timeGroup(timestamp, $__interval), sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp, $__interval)
ORDER BY $__timeGroup(timestamp, $__interval) ASC
```

Kueri itu diterjemahkan ke dalam kueri followin berdasarkan rentang waktu dasbor.

```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE'), sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2019-12-31T23:09:14Z' AND "timestamp" < '2020-01-01T23:17:54Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE')
ORDER BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE') ASC
```

### Peringatan
<a name="saphana-alerting"></a>

**Untuk mengatur peringatan SAP HANA di Grafana**

1. Buat panel grafik di dasbor Anda.

1. Buat kueri SAP HANA dalam format deret waktu.

1. Pilih tab **Alert** dan tentukan kriteria peringatan.

1. Pilih **Aturan Uji** untuk menguji kueri peringatan.

1. Tentukan penerima peringatan, pesan, dan penanganan kesalahan.

1. Simpan dasbor.

#### Peringatan tentang data non-timeseries
<a name="saphana-alerting-nontimeseries"></a>

Untuk memperingatkan data non-timeseries, gunakan `TO_TIMESTAMP('${__to:date}')` makro untuk membuat metrik non-timeseries menjadi timeseries. Ini akan mengubah metrik Anda menjadi kueri deret waktu titik tunggal. Format kueri diberikan di bawah ini

```
SELECT TO_TIMESTAMP('${__to:date}'),  <METRIC> FROM <TABLE≶ WHERE <YOUR CONDITIONS>
```

Dalam contoh berikut, tabel memiliki empat bidang yang disebut nama pengguna, usia, kota, dan peran. Tabel ini tidak memiliki bidang waktu. Kami ingin memberi tahu ketika jumlah pengguna dengan peran dev kurang dari tiga.

```
SELECT  TO_TIMESTAMP('${__to:date}'), count(*) as "count" FROM (
   SELECT 'John' AS "username", 32 AS "age", 'Chennai' as "city", 'dev' as "role" FROM dummy
   UNION ALL SELECT 'Jacob' AS "username", 32 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
   UNION ALL SELECT 'Ali' AS "username", 42 AS "age", 'Delhi' as "city", 'admin' as "role" FROM dummy
   UNION ALL SELECT 'Raja' AS "username", 12 AS "age", 'New York' as "city", 'ceo' as "role" FROM dummy
   UNION ALL SELECT 'Sara' AS "username", 35 AS "age", 'Cape Town' as "city", 'dev' as "role" FROM dummy
   UNION ALL SELECT 'Ricky' AS "username", 25 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
   UNION ALL SELECT 'Angelina' AS "username", 31 AS "age", 'London' as "city", 'cxo' as "role" FROM dummy
) WHERE "role" = 'dev'
```

# Connect ke sumber ServiceNow data
<a name="grafana-enterprise-servicenow-datasource"></a>

Ini adalah sumber ServiceNow data yang digunakan untuk terhubung ke ServiceNow instance.

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Fitur
<a name="features-1"></a>
+  Kueri 
  +  Kueri Stat API 
  +  Kueri API Tabel 
    +  Insiden, Perubahan, dan tabel lainnya 
+  Pemberitahuan 
+  Anotasi (fitur beta) 
+  Variabel Template 

## Konfigurasi
<a name="configuration-2"></a>

 Pilih sumber data di panel kiri Grafana. 

 Pilih Tambahkan Sumber Data: 

 Masukkan **servicenow** untuk menemukan plugin sumber data: 

 Masukkan ServiceNow URL: 

 Pilih **Simpan & Uji**. Anda akan melihat pesan hijau dengan "ServiceNow Koneksi OK”. 

### Contoh dasbor
<a name="example-dashboards"></a>

 Dasbor pra-dibuat disertakan dengan plugin dan dapat diimpor melalui halaman konfigurasi sumber data, di bawah tab dasbor. 

## Penggunaan
<a name="usage-2"></a>

 Ada dua cara untuk mengembalikan data di editor kueri. 
+  TableAPI 
+  AggregateAPI 

 Pengguna saat ini dapat memilih antara menanyakan tabel yang telah ditentukan sebelumnya, seperti berikut ini: 
+  Perubahan 
+  Insiden 

 Atau, pada`v1.4.0`, daftar tabel dan bidang berbasis API menggunakan opsi **Lainnya (Tabel Kustom)**. Opsi ini akan memungkinkan Anda untuk menanyakan data yang ada di tabel apa pun yang tersedia bagi pengguna yang digunakan untuk mengatur sumber ServiceNow data. 

 Opsi **Tabel Kustom** harus mendukung semua fitur yang sama dengan daftar tabel yang telah ditentukan sebelumnya. 

### Kueri TableAPI
<a name="tableapi-queries"></a>

 TableAPI mengembalikan data yang cocok untuk ditampilkan di panel tabel. Ini memungkinkan pemilihan bidang yang diurutkan untuk ditampilkan ditambah opsi pemfilteran. Editor kueri juga menyediakan bidang untuk membatasi jumlah baris yang dikembalikan oleh kueri. 

 Contoh panel tabel yang menunjukkan hasil dari query sebelumnya. 

#### Tampilkan
<a name="show"></a>

 Baris *Tampilkan* menyediakan pemilih untuk bidang yang akan ditampilkan. Beberapa bidang juga dapat ditentukan. Bidang akan dikembalikan dalam urutan yang tepat yang ditentukan. 

#### Nilai Tampilan
<a name="display-values"></a>

 Flag *Nilai Tampilan* akan menyebabkan kueri mengembalikan nilai yang ramah manusia, atau menampilkan vaules, bukan nilai numerik. 

 Misalnya, tingkat keparahan `1` tanpa bendera ini hanya akan ditampilkan`1`. Jika bendera diaktifkan, nilai yang ditampilkan akan menjadi`1 - High`. 

 Menurut [dokumentasi ServiceNow API](https://developer.servicenow.com/dev.do#!/reference/api/orlando/rest/c_TableAPI), ini dapat memiliki dampak kinerja negatif. 

**catatan**  
 [...] menentukan nilai tampilan dapat menyebabkan masalah kinerja karena tidak membaca langsung dari database dan dapat mencakup referensi bidang dan catatan lain. 

#### Filter (umum)
<a name="filters-general"></a>

 Baris *Filter* memberikan kemampuan untuk mempersempit baris yang ditampilkan berdasarkan beberapa kriteria bidang dan nilai. 

 Semua filter digabungkan dengan operasi *AND* *atau OR*. 

 Bidang berikut tersedia saat tidak menggunakan tabel kustom (daftar ini akan diperluas di masa mendatang).

```
Active
Asset
Group
Assigned To
Escalation
Issue Number
Description
Priority
State
Type
Change Risk
Change State
Start Date
End Date
On Hold
```

 Saat memilih tabel kustom, bidang secara otomatis diisi dari Service Now API. 

##### Filter tanggal
<a name="date-filters"></a>


|  Bidang Waktu  |  Operator  |  Nilai  | 
| --- | --- | --- | 
|  Dibuka di  |  Pada atau Sebelum Hari Ini Tidak Hari Ini Sebelum Pada atau Sebelum Setelah Pada atau Setelah  |  stempel waktu javascript:GS.Daysago (30)  | 
|  Aktivitas Karena  |   |   | 
|  Ditutup Pada  |   |   | 
|  Tanggal Jatuh Tempo  |   |   | 
|  Mulai yang Diharapkan  |   |   | 
|  Waktu Dibuka Kembali  |   |   | 
|  Diselesaikan Pada  |   |   | 
|  Akhir Kerja  |   |   | 
|  Mulai Kerja  |   |   | 
|  Abaikan Waktu  |   |   | 

 Untuk nilai tanggal tambahan, lihat: https://developer.servicenow.com/app.do\$1\$1/ api\$1doc? v=newYork&id=R\$1SGSYS-DateGenerate\$1s\$1s 

##### Operator (umum, berbasis string)
<a name="operators-generalstring-based"></a>
+  Dimulai Dengan 
+  Berakhir Dengan 
+  Suka 
+  Tidak Suka 
+  Sama dengan 
+  Tidak Sama Dengan 
+  Kosong 

##### Operator (berbasis waktu)
<a name="operators-time-based"></a>
+  Hari ini 
+  Tidak Hari Ini 
+  Sebelum 
+  Di atau Sebelum 
+  Setelah 
+  Pada atau Setelah 

##### Nilai
<a name="values"></a>

 Pemilihan nilai tergantung pada jenis filter yang dipilih. 
+  Filter Boolean memiliki opsi True/False 
+  Filter teks akan memungkinkan mengetik nilai apa pun 
+  Eskalasi, Prioritas memiliki seperangkat nilai numerik yang tetap 

#### Urutkan Berdasarkan
<a name="sort-by"></a>

 Baris *Sort By* memberikan kemampuan untuk mempersempit baris yang ditampilkan berdasarkan beberapa kriteria bidang dan nilai. 

 Semua filter digabungkan dengan operasi *AND*. Support untuk operator tambahan akan ditambahkan. 

#### Kuota
<a name="limit"></a>

 Batas baris dapat ditentukan untuk mencegah pengembalian terlalu banyak data. Nilai default adalah 25. 

#### Bidang Waktu
<a name="time-field"></a>

 `Time Field`Inilah yang mengubah data kueri Anda menjadi deret waktu. Data Anda ditangani sebagai deret waktu berarti bahwa nilai dalam “bidang waktu” yang Anda pilih yang tidak termasuk dalam rentang waktu dasbor/panel Anda tidak akan ditampilkan. 

 Bidang waktu default yang digunakan adalah “Dibuka Pada”, tetapi dapat diubah ke bidang yang tersedia yang memiliki nilai waktu. 

 Nilai khusus “Abaikan Waktu” disediakan untuk memungkinkan hasil “sampai sekarang” dan juga untuk mengaktifkan filter untuk mengontrol data apa yang ditampilkan. 

### Kueri AggregateAPI (Statistik)
<a name="aggregateapi-queries-stats"></a>

 AggregateAPI akan selalu menampilkan metrik, dengan agregasi berikut: avg, min, max, sum. Pemfilteran juga tersedia untuk mempersempit kueri. 

#### Tampilkan
<a name="show-1"></a>

 Baris *Tampilkan* menyediakan pemilih untuk metrik yang akan ditampilkan. Beberapa metrik juga dapat ditentukan. 

#### Filter (umum)
<a name="filters-general-1"></a>

 *Filter* Agregat memberikan kemampuan untuk mempersempit metrik yang ditampilkan berdasarkan kriteria bidang dan nilai, mirip dengan opsi tabel. 

 Semua filter digabungkan dengan operasi *AND*. Support untuk operator tambahan akan ditambahkan. 

 Opsi filter stat sama dengan TableAPI. 

#### Agregasi
<a name="aggregation"></a>

 Ada empat jenis agregasi metrik, ditambah “hitungan”: 
+  Rata-rata 
+  Minimum 
+  Maksimum 
+  Jumlah 
+  Hitung - ini mengembalikan “nomor” metrik yang dikembalikan oleh kueri 

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

 Pemilih ini menyediakan kemampuan untuk membagi metrik menjadi agregat yang lebih kecil. Pengelompokan berdasarkan “prioritas” akan mengembalikan metrik dengan “tag” prioritas dan nilai unik dipisahkan. 

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

 Alih-alih hardcoding nama dalam kueri 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. 

 Lihat contoh di bagian **Query Variable** tentang cara menambahkan variabel query dan referensi dengan nilai Template. 

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

 Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri yang dapat mengembalikan item seperti nama kategori, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun. 

 Misalnya, Anda dapat memiliki variabel yang berisi semua nilai `categories` dengan menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. 

 Saat memilih pengaturan **Kueri**, bagian **Filter** ditampilkan, memungkinkan Anda memilih **Jenis** dan **Bidang**. Saat ini, **Jenis** terbatas pada Insiden dan Perubahan. Saat memilih jenis, Anda diberikan daftar bidang yang berlaku untuk Jenis tersebut. Setelah **Jenis** dan **Bidang** dipilih, pratinjau nilai akan ditampilkan di bagian bawah yang menunjukkan opsi yang tersedia untuk Jenis/Bidang itu. Nilai-nilai tersebut akan ditampilkan dalam daftar dropdown di Dashboard, yang dapat Anda gunakan bersama dengan Templating untuk memfilter data pada Panel Dasbor Anda. 

 Misalnya, jika Anda menambahkan *kategori* bernama Variabel lalu pilih Jenis = Insiden dan Bidang = Kategori, Anda akan melihat daftar opsi untuk Kategori. Jika Anda kemudian menambahkan Filter ke panel, dan pilih Category Equals \$1 \$1category\$1, data panel hanya akan menampilkan data untuk Kategori yang dipilih dari daftar dropdown Dashboard. 

 Impor dasbor **Insiden Berdasarkan Kategori** untuk melihat contoh. 

#### Menggunakan variabel dalam kueri
<a name="using-variables-in-queries"></a>

 Ada dua sintaks: 

 `$<varname>`Contoh dengan variabel template bernama`hostname`: 

 `[[varname]]`Contoh dengan variabel template bernama`hostname`: 

## Peringatan
<a name="servicenow-alerting"></a>

 Peringatan Grafana standar didukung. Setiap kueri yang ditentukan dalam panel grafik dapat digunakan untuk menghasilkan peringatan. 

 Berikut ini adalah contoh query dan peringatan. Kueri ini akan mengembalikan grafik dari semua insiden prioritas tinggi kritis terbuka: 

 Peringatan ini akan dimulai ketika ada lebih dari lima insiden prioritas tinggi kritis terbuka: 

 Menguji aturan peringatan akan menampilkan output dari aturan peringatan, dan memilih riwayat status akan menampilkan transisi peringatan dari ok ke pending ke alert. 

 Tampilan grafik akan menunjukkan garis vertikal dan ikon hati di bagian atas akan berubah menjadi oranye saat peringatan tertunda. 

 Setelah kriteria peringatan terpenuhi, aturan beralih ke merah.

 Pada tampilan grafik, garis vertikal merah akan muncul dan ikon hati di bagian atas akan berubah menjadi merah. 

### Menulis insiden untuk peringatan
<a name="writing-incidents-for-alerts"></a>

 **Fitur beta** 
+  Konfigurasikan Saluran Pemberitahuan untuk sumber ServiceNow data Anda. 

 Ini akan mengonfigurasi [Saluran Pemberitahuan Grafana](https://grafana.com/docs/grafana/latest/alerting/notifications/) yang menggunakan pengguna yang dikonfigurasi untuk membuat insiden pada ServiceNow instance untuk sumber data ini. 

 Tindakan ini mengharuskan pengguna sumber ServiceNow data memiliki izin untuk menulis insiden. 

## Anotasi
<a name="annotations-1"></a>

 Anotasi Grafana adalah **fitur beta** pada `v1.4.0` sumber data ini. Anotasi memberi Anda kemampuan untuk melapisi peristiwa pada grafik. 

 Kueri Anotasi mendukung opsi yang sama dengan editor kueri standar dengan beberapa perbedaan kecil: 
+  Hanya satu kolom “Tampilkan” yang dapat dipilih. Ini kemungkinan akan diperbaiki dalam perbaikan masa depan. 
+  Bidang waktu diperlukan. 

## Pertanyaan yang Sering Diajukan
<a name="faq-1"></a>

### Bagaimana jika kita tidak memiliki Plugin Peran ITSM?
<a name="what-if-we-dont-have-the-itsm-roles-plugin"></a>

 **Akses administrator diperlukan untuk melakukan tindakan berikut** 

 Opsi 1: Berikan izin admin pengguna Grafana untuk mengizinkan akses ke semua tabel. 

 Opsi 2: Buat peran dan terapkan ACLs ke semua tabel yang harus diakses oleh Grafana.

 Akses administrator diperlukan untuk melakukan tindakan berikut.

1.  Administrator yang masuk perlu meningkatkan akses ke security\$1admin.

   1.  Di panel navigasi kanan atas, pilih ikon profil. Ikon profil memiliki indikator tanda sisipan dropdown. 

   1.  Dari daftar dropdown, pilih **Elevate** Roles. 

   1.  Dari modal yang ditampilkan, pilih kotak centang **security\$1admin**.

   1.  Pilih OK. 

1. Buat peran baru dengan konvensi penamaan apa pun yang Anda inginkan.

   1.  Arahkan ke bagian peran di navigasi kiri Keamanan Sistem => Pengguna dan Grup => Peran 

   1.  Pilih **Baru** di bagian atas.

   1.  Masukkan nama untuk peran dan deskripsi yang relevan. 

   1.  Pilih **Kirim**. 

1.  Buat pengguna baru atau modifikasi pengguna yang sudah ada dengan peran yang diperlukan. 

   1.  Peran yang Anda buat di Langkah 2 

   1.  personalize\$1dictionary 

   1.  personalize\$1choices 

   1.  cmdb\$1read (ini akan memberikan akses baca ke semua tabel cmdb) 

1.  Buat Tabel ACLs untuk tabel dan bidang yang diperlukan. 

   1.  Buat ACL untuk tabel sys\$1db\$1object. 

     1.  Di kolom header pencarian kedua **Nama**, masukkan**sys\$1db\$1object**, dan tekan **Enter**. 

     1.  Hasil yang disaring harus menunjukkan **Tabel**. Pilih **Tabel** untuk menavigasi ke catatan. 

     1.  Pada bagian tab, pilih **Kontrol**.

     1.  Pada bagian bawah halaman, pastikan bahwa **Access Controls** adalah tab yang dipilih. 

     1.  Pilih **Baru** untuk membuat ACL baru. 

     1.  Ubah pilihan **Operasi** untuk membaca. 

     1.  Di bagian **Memerlukan Peran** di bagian bawah layar, pilih (klik dua kali) **Sisipkan Baris Baru**, dan cari peran yang Anda buat. 

     1. Setelah Anda memilih peran yang Anda buat, pilih tanda centang hijau. 

     1.  Pilih **Kirim** di bagian bawah layar untuk membuat ACL, lalu pilih **Lanjutkan** saat modal muncul. 

1.  Buat ACLs untuk bidang sys\$1db\$1object tertentu. Langkah-langkah berikut harus diulang untuk masing-masing bidang berikut: Nama, Label, Nama Tampilan, dan Memperpanjang tabel. 

   1.  Saat masih dalam tampilan rekaman tabel untuk sys\$1db\$1object, pilih tab **Kolom** di grup tab yang paling dekat dengan bagian atas layar.

   1.  Temukan nama bidang dan pilih. 

   1.  Di bagian tab bawah, pilih **Baru** di tab **Access Controls**. 

   1.  Ubah operasi untuk membaca 

   1.  Pilih (klik dua kali) sisipkan teks baris di bagian bawah tabel “Memerlukan peran”. 

   1.  Cari peran yang Anda buat, dan pilih tanda centang hijau. 

   1.  Pilih **Kirim**. 

   1.  Pastikan Anda telah mengulangi langkah-langkah ini untuk semua bidang yang diperlukan: Name, Label, Display Name, dan Extends table. 

1.  Ulangi langkah-langkah dari 4.1 pada Perubahan, Insiden, dan tabel non-CMDB lainnya yang ingin Anda kueri dari Grafana. Jangan ulangi langkah-langkah dari 4.2; langkah itu hanya diperlukan untuk sys\$1db\$1object. 

# Connect ke sumber data Snowflake
<a name="snowflake-datasource-for-AMG"></a>

 Dengan sumber data Snowflake Enterprise, Anda dapat memvisualisasikan data Snowflake Anda bersama semua sumber data Anda yang lain di Grafana serta data log dan metrik dalam konteks. Sumber data ini mencakup editor kueri tipe-depan yang kuat, mendukung anotasi kompleks, menetapkan ambang peringatan, mengontrol akses dan izin, dan banyak lagi. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Ikhtisar
<a name="snowflake-overview"></a>

### Apa itu Kepingan Salju?
<a name="what-is-snowflake"></a>

 Snowflake menawarkan layanan penyimpanan dan analisis data berbasis cloud, umumnya disebut “data warehouse-as-a-service” yang menawarkan solusi untuk pergudangan data, data lake, rekayasa data, ilmu data, pengembangan aplikasi data, dan berbagi data. Selama beberapa tahun terakhir, Snowflake telah mendapatkan popularitas besar karena kemampuannya untuk menyimpan dan menganalisis data dengan harga terjangkau menggunakan perangkat keras dan perangkat lunak berbasis cloud; baru-baru ini berpuncak pada IPO perangkat lunak terbesar yang pernah ada. Saat ini, banyak perusahaan menggunakan Snowflake sebagai database utama mereka untuk menyimpan data aplikasi dan bisnis seperti jumlah transaksi, sesi pengguna aktif, dan bahkan deret waktu dan data metrik. 

### Memanfaatkan Snowflake dan Grafana yang Dikelola Amazon
<a name="making-the-most-of-snowflake-and-AMG"></a>

 **Visualisasikan data Snowflake tanpa memindahkannya**: Arsitektur unik Grafana menanyakan data secara langsung di tempat tinggalnya daripada memindahkannya dan membayar penyimpanan dan konsumsi yang berlebihan. 

 **Buat panel dari berbagai sumber:** Dengan dasbor pra-bangun dan kustom, satukan data dari berbagai sumber data ke dalam satu panel kaca. 

 **Transformasi dan komputasi di tingkat pengguna**: Pengguna dapat mengubah data dan menjalankan berbagai perhitungan pada data yang mereka lihat, membutuhkan lebih sedikit persiapan data. 

 **Menggabungkan, menghitung, dan memvisualisasikan dalam panel: Buat panel** sumber data campuran yang menampilkan data terkait dari Snowflake dan sumber lainnya. 

### Fitur
<a name="snowflake-features"></a>

 **Editor kueri: Editor** kueri adalah editor pelengkapan otomatis Smart SQL yang memungkinkan Anda memvisualisasikan deret waktu atau data tabel, menangani kesalahan sintaks SQL, dan melengkapi kata kunci SQL dasar secara otomatis. 

 **Izin sumber data**: Kontrol siapa yang dapat melihat atau menanyakan data Kepingan Salju di Grafana 

 **Anotasi:** Hamparkan peristiwa Kepingan Salju pada grafik Grafana apa pun, untuk mengkorelasikan peristiwa dengan data grafik lainnya 

 **Peringatan:** Setel toko metrik berbasis peringatan di Snowflake 

 **Variabel untuk kueri:** Buat variabel template di Grafana berdasarkan data Snowflake, dan sertakan variabel dalam kueri Snowflake untuk membuat dasbor interaktif. 

 **Kueri multi-metrik:** Tulis satu kueri yang mengembalikan beberapa metrik, masing-masing di kolomnya sendiri 

## Memulai dengan plugin Snowflake
<a name="get-started-with-the-snowflake-plugin"></a>

 Berikut adalah lima langkah cepat untuk memulai plugin Snowflake di Grafana: 

### Langkah 1: Siapkan Sumber Data Snowflake
<a name="set-up-the-snowflake-data-source"></a>

 Untuk mengkonfigurasi sumber data, pilih **Konfigurasi**, **Sumber Data**, **Tambahkan sumber data**, kepingan salju. 

 Tambahkan detail otentikasi Anda, dan sumber data siap untuk ditanyakan\$1 

 Bidang konfigurasi berikut tersedia. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Akun  |  Akun untuk Snowflake.  | 
|  nama pengguna  |  Nama pengguna untuk akun layanan.  | 
|  Kata Sandi  |  Kata sandi untuk akun layanan.  | 
|  Skema (opsional)  |  Menetapkan skema default untuk kueri.  | 
|  Gudang (opsional)  |  Menetapkan gudang default untuk kueri.  | 
|  Database (opsional)  |  Menetapkan database default untuk query.  | 
|  Peran (opsional)  |  Mengasumsikan peran untuk kueri.  | 

### Langkah 2: Tulis kueri untuk data Snowflake Anda
<a name="write-queries-for-your-snowflake-data"></a>

 Buat panel di dasbor, dan pilih Sumber Data Kepingan Salju untuk mulai menggunakan editor kueri. 
+  Tanggal/waktu dapat muncul di mana saja dalam kueri selama disertakan. 
+  Kolom numerik harus disertakan. Ini bisa berupa agregasi atau int/float kolom. 
+  Secara opsional, Anda dapat menyertakan kolom string untuk membuat seri data terpisah, jika data deret waktu Anda diformat untuk metrik yang berbeda. 

#### Tata letak kueri Snowflake
<a name="layout-of-a-snowflake-query"></a>

```
select
  <time_column>,
  <any_numerical_column>
  <other_column_1>,
  <other_column_2>,
  <...>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

#### Format kueri SQL untuk grup deret waktu berdasarkan interval
<a name="sql-query-format-for-timeseries-group-by-interval"></a>

```
select
  $__timeGroup(created_ts, '1h'), // group time by interval of 1h
  <time_column>, 
  <any_numerical_column>,
  <metric_column>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
group by <time_column>
```

#### Format kueri SQL untuk tabel
<a name="sql-query-format-for-tables"></a>

```
select
  <time_column>, // optional if result format option is table
  <any_column_1>
  <any_column_2>
  <any_column_3>
from
  <any_table>
where
  $__timeFilter(time_column) // macro for time range, optional if format as option is table
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

### Langkah 3: Buat dan gunakan Variabel Template
<a name="snowflake-create-and-use-template-variables"></a>

#### Menggunakan variabel template
<a name="snowflake-using-template-variables-1"></a>

 Anda dapat menyertakan variabel template dalam query, seperti yang ditunjukkan pada contoh berikut. 

```
 select
   <column>
 from 
   <table>
 WHERE column >= '$variable'
```

 Contoh berikut menunjukkan menggunakan variabel multi-nilai dalam query. 

```
select
  <column>
from 
  <table>
WHERE <column> regexp '${variable:regex}'
```

#### Menggunakan sumber data Snowflake untuk membuat variabel
<a name="using-the-snowflake-datasource-to-create-variables"></a>

 Di pengaturan dasbor, pilih **Variabel**, dan pilih **Baru**. 

 Menggunakan tipe variabel “Query”, pilih sumber data Snowflake sebagai “Sumber data”. 

**penting**  
 Pastikan untuk memilih hanya satu kolom dalam kueri variabel Anda. 

 Contoh: 

```
SELECT DISTINCT query_type from account_usage.query_history;
```

 akan memberi Anda variabel-variabel ini: 

```
All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW
```

### Langkah 4: Siapkan peringatan
<a name="snowflake-set-up-an-alert"></a>

 Anda dapat mengatur peringatan pada metrik Snowflake tertentu atau pada kueri yang telah Anda buat. 

 Pilih tombol tab peringatan di dalam editor kueri, dan pilih **Buat Peringatan**. 

### Langkah 5. Buat anotasi
<a name="snowflake-create-an-annotation"></a>

 Anotasi memungkinkan Anda untuk melapisi peristiwa pada grafik. 

 Untuk membuat anotasi, di pengaturan dasbor, pilih **Anotasi**, dan **Baru**, dan pilih Snowflake sebagai sumber data. 

 Karena anotasi adalah peristiwa, mereka memerlukan setidaknya satu kolom waktu dan satu kolom untuk menggambarkan peristiwa tersebut. 

 Kode contoh berikut menunjukkan kueri untuk membubuhi keterangan semua login yang gagal ke Snowflake. 

```
SELECT
  EVENT_TIMESTAMP as time,
  EVENT_TYPE,
  CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;
```

 Dan 
+  waktu: `TIME` 
+  judul: `EVENT_TYPE` 
+  teks: `CLIENT_IP` 

 Ini akan melapisi anotasi semua login yang gagal ke Snowflake di panel dasbor Anda. 

## Fungsionalitas tambahan
<a name="additional-functionality"></a>

### Menggunakan bidang Nama Tampilan
<a name="snowflake-using-display-name"></a>

 Plugin ini menggunakan bidang Nama Tampilan di tab Bidang panel Opsi untuk mempersingkat atau mengubah kunci legenda berdasarkan nama, label, atau nilainya. Sumber data lain menggunakan `alias` fungsionalitas khusus untuk memodifikasi kunci legenda, tetapi fungsi Nama Tampilan adalah cara yang lebih konsisten untuk melakukannya. 

### Izin sumber data
<a name="snowflake-data-source-permissions"></a>

 Batasi akses ke Snowflake dengan memilih tab Izin di halaman konfigurasi sumber data untuk mengaktifkan **izin** sumber data. Pada halaman izin, Admin dapat mengaktifkan izin dan membatasi izin kueri untuk Pengguna dan Tim tertentu. 

### Memahami data penagihan dan penggunaan Snowflake Anda
<a name="understand-your-snowflake-billing-and-usage-data"></a>

 Dalam sumber data Snowflake, Anda dapat mengimpor dasbor penagihan dan penggunaan yang menunjukkan informasi penagihan dan penggunaan yang berguna. 

 Tambahkan dasbor di halaman konfigurasi Sumber Data Snowflake: 

 Dasbor ini menggunakan database ACCOUNT\$1USAGE, dan membutuhkan querier untuk memiliki peran ACCOUNTADMIN. Untuk melakukan ini dengan aman, buat sumber data Grafana baru yang memiliki pengguna dengan peran ACCOUNTADMIN. Kemudian pilih sumber data tersebut di variabel. 

# Connect ke sumber data Splunk
<a name="splunk-datasource"></a>

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Konfigurasi
<a name="splunk-configuration-3"></a>

### Konfigurasi sumber data
<a name="splunk-data-source-config"></a>

 Saat mengonfigurasi Sumber Data, pastikan bahwa bidang URL menggunakan `https` dan menunjuk ke port Splunk yang Anda konfigurasi. Titik API Splunk default adalah 8089, bukan 8000 (ini adalah port UI web default). Aktifkan *Basic Auth* dan tentukan nama pengguna dan kata sandi Splunk. 

#### Mode akses browser (langsung) dan CORS
<a name="splunk-browser-direct-access-mode-and-cors"></a>

 Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber data Splunk. 

### Opsi lanjutan
<a name="splunk-advanced-options"></a>

#### Mode Streaming
<a name="stream-mode"></a>

 Aktifkan mode streaming jika Anda ingin mendapatkan hasil pencarian saat tersedia. Ini adalah fitur eksperimental, jangan aktifkan sampai Anda benar-benar membutuhkannya. 

#### Hasil Polling
<a name="splunk-poll-result"></a>

 Jalankan pencarian dan kemudian periksa hasilnya secara berkala. Di bawah tenda opsi ini menjalankan panggilan `search/jobs` API dengan `exec_mode` disetel ke`normal`. Dalam hal ini permintaan API mengembalikan pekerjaan SID, dan kemudian Grafana memeriksa status pekerjaan dari waktu ke waktu, untuk mendapatkan hasil pekerjaan. Opsi ini dapat membantu untuk kueri yang lambat. Secara default opsi ini dinonaktifkan dan Grafana disetel `oneshot` yang `exec_mode` memungkinkan pengembalian hasil pencarian dalam panggilan API yang sama. Lihat selengkapnya tentang titik akhir `search/jobs` API di dokumen [Splunk](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTsearch#search.2Fjobs). 

#### Cari interval pemungutan suara
<a name="splunk-search-polling-interval"></a>

 Opsi ini memungkinkan untuk menyesuaikan seberapa sering Grafana yang Dikelola Amazon akan melakukan polling splunk untuk hasil pencarian. Waktu untuk jajak pendapat berikutnya memilih secara acak dari interval [min, max). Jika Anda menjalankan banyak pencarian berat, masuk akal untuk meningkatkan nilai-nilai ini. Tips: tingkatkan *Min* jika eksekusi pekerjaan pencarian membutuhkan waktu lama, dan *Max* jika Anda menjalankan banyak pencarian paralel (banyak metrik splunk di dasbor Grafana). Defaultnya adalah interval milidetik [500, 3000). 

#### Pembatalan otomatis
<a name="auto-cancel"></a>

 Jika ditentukan, pekerjaan secara otomatis akan dibatalkan setelah beberapa detik tidak aktif ini (0 berarti tidak pernah membatalkan otomatis). Defaultnya adalah 30. 

#### Ember status
<a name="status-buckets"></a>

 Bucket status terbanyak untuk dihasilkan. 0 menunjukkan untuk tidak menghasilkan informasi garis waktu. Defaultnya adalah 300. 

#### Mode pencarian bidang
<a name="splunk-fields-search-mode"></a>

 Saat Anda menggunakan editor kueri visual, sumber data mencoba mendapatkan daftar bidang yang tersedia untuk jenis sumber yang dipilih. 
+  cepat - gunakan hasil pertama yang tersedia dari pratinjau 
+  penuh - tunggu pekerjaan selesai dan dapatkan hasil penuh. 

#### Default waktu paling awal
<a name="default-earliest-time"></a>

 Beberapa pencarian tidak dapat menggunakan rentang waktu dasbor (seperti kueri variabel template). Opsi ini membantu mencegah pencarian sepanjang waktu, yang dapat memperlambat Splunk. Sintaks adalah integer dan satuan waktu. `[+|-]<time_integer><time_unit>` Sebagai contoh, `-1w`. [Satuan waktu](https://docs.splunk.com/Documentation/Splunk/latest/Search/Specifytimemodifiersinyoursearch) bisa`s, m, h, d, w, mon, q, y`. 

#### Modus pencarian variabel
<a name="splunk-variables-search-mode"></a>

 Mode pencarian untuk kueri variabel template. Kemungkinan nilai: 
+  cepat - Penemuan lapangan dimatikan untuk pencarian acara. Tidak ada data peristiwa atau bidang untuk pencarian statistik. 
+  smart - Penemuan lapangan untuk pencarian acara. Tidak ada data peristiwa atau bidang untuk pencarian statistik. 
+  verbose - Semua data acara & bidang. 

## Penggunaan
<a name="splunk-usage-5"></a>

### Editor kueri
<a name="splunk-query-editor-2"></a>

#### Mode editor
<a name="splunk-editor-modes"></a>

 Editor kueri mendukung dua mode: mentah dan visual. Untuk beralih di antara mode ini pilih ikon hamburger di sisi kanan editor dan pilih *Toggle Editor* Mode. 

#### Modus mentah
<a name="raw-mode"></a>

 Gunakan `timechart` perintah untuk data deret waktu, seperti yang ditunjukkan pada contoh kode berikut. 

```
index=os sourcetype=cpu | timechart span=1m avg(pctSystem) as system, avg(pctUser) as user, avg(pctIowait) as iowait
index=os sourcetype=ps | timechart span=1m limit=5 useother=false avg(cpu_load_percent) by process_name
```

 Kueri mendukung variabel template, seperti yang ditunjukkan pada contoh berikut. 

```
sourcetype=cpu | timechart span=1m avg($cpu)
```

 Ingatlah bahwa Grafana adalah aplikasi berorientasi deret waktu dan pencarian Anda harus mengembalikan data deret waktu (stempel waktu dan nilai) atau nilai tunggal. [Anda dapat membaca tentang perintah [timechart](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Timechart) dan menemukan lebih banyak contoh pencarian di Referensi Pencarian Splunk resmi](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/WhatsInThisManual) 

#### Metrik Splunk dan `mstats`
<a name="splunk-metrics-and-mstats"></a>

 Splunk 7.x menyediakan `mstats` perintah untuk menganalisis metrik. Agar grafik berfungsi dengan baik`mstats`, itu harus dikombinasikan dengan `timeseries` perintah dan `prestats=t` opsi harus diatur. 

```
Deprecated syntax:
| mstats prestats=t avg(_value) AS Value WHERE index="collectd" metric_name="disk.disk_ops.read" OR metric_name="disk.disk_ops.write" by metric_name span=1m
| timechart avg(_value) span=1m by metric_name

Actual:
| mstats prestats=t avg(disk.disk_ops.read) avg(disk.disk_ops.write) WHERE index="collectd" by metric_name span=1m
| timechart avg(disk.disk_ops.read) avg(disk.disk_ops.write) span=1m
```

 Baca lebih lanjut tentang `mstats` perintah di [Referensi Pencarian Splunk](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Mstats). 

#### Format sebagai
<a name="format-as"></a>

 Ada dua mode format hasil yang didukung - *Deret waktu* (default) dan *Tabel*. Mode tabel cocok untuk digunakan dengan panel Tabel saat Anda ingin menampilkan data agregat. Itu bekerja dengan peristiwa mentah (mengembalikan semua bidang yang dipilih) dan fungsi `stats` pencarian, yang mengembalikan data seperti tabel. Contoh: 

```
index="os" sourcetype="vmstat" | fields host, memUsedMB
index="os" sourcetype="ps" | stats avg(PercentProcessorTime) as "CPU time", latest(process_name) as "Process", avg(UsedBytes) as "Memory" by PID
```

 Hasilnya mirip dengan tab *Statistik* di Splunk UI.

 Baca lebih lanjut tentang penggunaan `stats` fungsi di [Referensi Pencarian Splunk](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/Stats). 

#### Mode visual
<a name="splunk-visual-mode"></a>

Mode ini menyediakan pembuatan step-by-step pencarian. Perhatikan bahwa mode ini menciptakan pencarian `timechart` splunk. Cukup pilih indeks, jenis sumber, dan metrik, dan atur pemisahan menurut bidang jika Anda mau. 

##### Metrik
<a name="splunk-metric"></a>

 Anda dapat menambahkan beberapa metrik untuk dicari dengan memilih tombol *plus* di sisi kanan baris metrik. Editor metrik berisi daftar agregasi yang sering digunakan, tetapi Anda dapat menentukan di sini fungsi lainnya. Cukup pilih segmen agg (secara `avg` default) dan ketik apa yang Anda butuhkan. Pilih bidang tertarik dari daftar dropdown (atau masukkan), dan atur alias jika Anda mau. 

##### Dibagi dan Dimana
<a name="split-by-and-where"></a>

 Jika Anda mengatur Split by field dan menggunakan mode *Time series*, Where editor akan tersedia. Pilih *plus* dan pilih operator, agregasi dan nilai, misalnya *Dimana rata-rata di 10 besar*. Perhatikan, klausa *Where* ini adalah bagian dari *Split by*. Lihat selengkapnya di dokumen [timechart](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/timechart#where_clause). 

#### Opsi
<a name="splunk-options"></a>

 Untuk mengubah opsi timechart default, pilih **Opsi di baris** terakhir.

Lihat selengkapnya tentang opsi ini di dokumen [timechart](https://docs.splunk.com/Documentation/Splunk/latest/SearchReference/timechart). 

#### Pencarian splunk yang dirender
<a name="rendered-splunk-search"></a>

 Pilih huruf target di sebelah kiri untuk menciutkan editor dan menampilkan pencarian splunk yang diberikan. 

### Anotasi
<a name="splunk-annotations-2"></a>

Gunakan anotasi jika Anda ingin menampilkan peringatan atau peristiwa Splunk pada grafik. Anotasi dapat berupa peringatan Splunk yang telah ditentukan sebelumnya atau pencarian splunk biasa. 

#### Peringatan splunk
<a name="splunk-alert"></a>

 Tentukan nama peringatan, atau kosongkan bidang untuk mendapatkan semua peringatan yang diaktifkan. Variabel template didukung. 

#### Pencarian splunk
<a name="splunk-search"></a>

 Gunakan pencarian splunk untuk mendapatkan acara yang dibutuhkan, seperti yang ditunjukkan pada contoh berikut. 

```
index=os sourcetype=iostat | where total_ops > 400
index=os sourcetype=iostat | where total_ops > $io_threshold
```

 Variabel template didukung. 

 Opsi **bidang Peristiwa sebagai teks** cocok jika Anda ingin menggunakan nilai bidang sebagai teks anotasi. Contoh berikut menunjukkan teks pesan kesalahan dari log. 

```
Event field as text: _raw
Regex: WirelessRadioManagerd\[\d*\]: (.*)
```

 Regex memungkinkan untuk mengekstrak bagian dari pesan. 

### Variabel template
<a name="splunk-template-variables"></a>

 Fitur variabel template mendukung kueri Splunk yang mengembalikan daftar nilai, misalnya dengan `stats` perintah. 

```
index=os sourcetype="iostat" | stats values(Device)
```

 Query ini mengembalikan daftar nilai `Device` bidang dari `iostat` sumber. Kemudian Anda dapat menggunakan nama perangkat ini untuk kueri atau anotasi deret waktu. 

 Ada dua kemungkinan jenis kueri variabel yang dapat digunakan di Grafana. Yang pertama adalah query sederhana (seperti yang disajikan sebelumnya), yang mengembalikan daftar nilai. Tipe kedua adalah query yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `_text` dan`_value`. Nilai `_text` kolom harus unik (jika tidak unik maka nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai sehingga Anda dapat memiliki nama ramah sebagai teks dan ID sebagai nilainya. 

 Misalnya, pencarian ini mengembalikan tabel dengan kolom `Name` (nama wadah Docker) dan `Id` (id wadah). 

```
source=docker_inspect | stats count latest(Name) as Name by Id | table Name, Id
```

 Untuk menggunakan nama kontainer sebagai nilai yang terlihat untuk variabel dan id sebagai nilai sebenarnya, kueri harus dimodifikasi, seperti pada contoh berikut. 

```
source=docker_inspect | stats count latest(Name) as Name by Id | table Name, Id | rename Name as "_text", Id as "_value"
```

#### Variabel multi-nilai
<a name="splunk-multi-value-variables"></a>

 Dimungkinkan untuk menggunakan variabel multi-nilai dalam kueri. Pencarian yang diinterpolasi akan tergantung pada konteks penggunaan variabel. Ada beberapa konteks yang didukung plugin. Asumsikan ada variabel `$container` dengan nilai yang dipilih `foo` dan`bar`: 
+  Filter dasar untuk `search` perintah 

  ```
  source=docker_stats $container
  =>
  source=docker_stats (foo OR bar)
  ```
+  Filter nilai lapangan 

  ```
  source=docker_stats container_name=$container
  =>
  source=docker_stats (container_name=foo OR container_name=bar)
  ```
+  Filter nilai bidang dengan operator dan fungsi `IN` `in()` 

  ```
  source=docker_stats container_name IN ($container)
  =>
  source=docker_stats container_name IN (foo, bar)
  
  source=docker_stats | where container_name in($container)
  =>
  source=docker_stats | where container_name in(foo, bar)
  ```

#### Variabel multi-nilai dan kutipan
<a name="multi-value-variables-and-quotes"></a>

 Jika variabel dibungkus dalam tanda kutip (baik ganda atau tunggal), nilainya juga akan dikutip, seperti pada contoh berikut. 

```
source=docker_stats container_name="$container"
=>
source=docker_stats (container_name="foo" OR container_name="bar")

source=docker_stats container_name='$container'
=>
source=docker_stats (container_name='foo' OR container_name='bar')
```

# Connect ke sumber data Pemantauan Infrastruktur Splunk
<a name="AMG-datasource-splunkinfra"></a>

Memberikan dukungan untuk Pemantauan Infrastruktur Splunk (sebelumnya SignalFx).

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Menambahkan sumber data
<a name="bigquery-adding-the-data-source"></a>

1.  Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk. 

1.  Di menu samping di bawah **Konfigurasi** (ikon roda gigi), pilih **Sumber Data**. 

1.  Pilih **Tambahkan sumber data**. 
**catatan**  
 Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran. 

1.  Pilih **Pemantauan Infrastruktur Splunk** dari daftar sumber data. 

1. Masukkan informasi berikut:
   + Untuk **Access Token**, masukkan token yang dihasilkan oleh SignalFx akun Anda. Untuk informasi selengkapnya, lihat [Token Otentikasi](https://docs.signalfx.com/en/latest/admin-guide/tokens.html).
   + **Realm** Penerapan mandiri yang menampung organisasi Anda. Anda dapat menemukan nama ranah Anda di halaman profil Anda saat masuk ke antarmuka SignalFx pengguna.

## Menggunakan editor kueri
<a name="splunkinfra-query"></a>

Editor kueri menerima [ SignalFlow](https://dev.splunk.com/observability/docs/signalflow/)program/kueri.

Untuk label, label Signalflow `publish(label = 'foo')` diterapkan sebagai metadata ke hasil: **“**label” :"foo”

Untuk variabel template tipe kueri, tidak ada bidang **Query**. Sebagai gantinya, Anda memilih salah satu jenis kueri berikut:
+ Dimensi
+ Metrik-metrik
+ Tag

Filter ad-hoc didukung, memungkinkan filter global menggunakan dimensi.

Anotasi Grafana didukung. Saat Anda membuat anotasi, gunakan kueri SignalFlow Peringatan atau Peristiwa.

Contoh mendapatkan peringatan untuk detektor:

```
alerts(detector_name='Deployment').publish();
```

Contoh mendapatkan Acara khusus berdasarkan jenis:

```
events(eventType='simulated').publish();
```

# Connect ke sumber data Wavefront (VMware Tanzu Observability by Wavefront)
<a name="wavefront-datasource-for-AMG"></a>

 Sumber data Wavefront (VMware Tanzu Observability by Wavefront) memungkinkan pengguna Grafana yang Dikelola Amazon untuk menanyakan dan memvisualisasikan data yang mereka kumpulkan langsung dari Wavefront dan dengan mudah memvisualisasikannya bersama metrik, log, penelusuran, atau sumber data lainnya. Tampilan panel tunggal yang fleksibel ini memudahkan untuk melacak masalah kesehatan dan debug sistem. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Apa itu Wavefront?
<a name="what-is-wavefront"></a>

 [Wavefront](https://www.wavefront.com) adalah alat pemantauan dan analitik cloud yang dikembangkan oleh. VMware Wavefront adalah layanan yang dihosting cloud tempat Anda mengirim data deret waktu (metrik) — dari CollectD, StatSD, JMX, logger Ruby, atau alat lainnya. AWS Dengan Wavefront, pengguna dapat melakukan operasi matematika pada seri tersebut, membuat grafik untuk melihat anomali, melacak KPIs, dan membuat peringatan. 

## Memaksimalkan tumpukan teknologi Anda dengan Wavefront dan Grafana
<a name="maximizing-your-tech-stack-with-wavefront-and-AMG"></a>

 Sementara di permukaan, Grafana dan Wavefront terdengar serupa, banyak organisasi menggunakan Wavefront dan Grafana sebagai bagian penting dari alur kerja observabilitas mereka. 

 **Visualisasikan tanpa Memindahkan Sumber Data:** Arsitektur unik Grafana menanyakan data secara langsung di tempat tinggalnya daripada memindahkannya dan membayar penyimpanan dan konsumsi yang berlebihan. 

 **Buat Panel dari Berbagai Sumber** Dengan dasbor pra-bangun dan kustom, satukan data dari berbagai sumber data ke dalam satu panel kaca. 

 **Transform dan Compute di Tingkat Pengguna:** Pengguna dapat mengubah data dan menjalankan berbagai perhitungan pada data yang mereka lihat, membutuhkan lebih sedikit persiapan data. 

 **Gabungkan, Hitung, dan Visualisasikan dalam Panel: Buat panel** sumber data campuran yang menampilkan data terkait dari Waveferont dan sumber lain, seperti Prometheus dan InfluxDB. 

## Dokumentasi
<a name="wavefront-documentation"></a>

### Fitur
<a name="wavefront-features-3"></a>
+  Visualisasi Timeseries 
+  Visualisasi Tabel 
+  Visualisasi Heatmap 
+  Visualisasi Stat Tunggal 
+  Editor Kueri Terpandu 
+  Editor Kueri WQL Mentah 
+  Anotasi untuk data acara 
+  Variabel Template 
+  Filter Ad-Hoc 
+  Peringatan 

### Konfigurasi
<a name="wavefront-configuration-4"></a>

 Mengkonfigurasi sumber data Wavefront relatif mudah. Hanya ada dua bidang yang diperlukan untuk menyelesaikan konfigurasi: `API URL` dan`Token`. 
+  `API URL`akan menjadi URL yang Anda gunakan untuk mengakses lingkungan wavefront Anda. Contoh:`https://myenvironment.wavefront.com`. 
+  `Token`harus dibuat dari akun pengguna atau akun layanan. 

  1.  **Untuk membuat token berbasis akun pengguna, masuk ke lingkungan Wavefront Anda, pilih roda gigi di sudut kanan atas halaman, pilih nama pengguna Anda (misalnya,`me@grafana.com`), pilih tab **Akses API** di bagian atas halaman pengguna, lalu salin kunci yang ada atau pilih buat.**

  1. Untuk membuat token berbasis akun layanan, masuk ke lingkungan Wavefront Anda, pilih roda gigi di sudut kanan atas halaman, pilih manajemen akun. Pada navigasi kiri, pilih **Akun, Grup, & Peran**, pilih tab **Akun Layanan** di bagian atas, lalu pilih **Buat Akun Baru**. Masukkan nama untuk akun layanan. Ini bisa apa pun yang Anda inginkan. Salin token yang disediakan di bawah bagian **Token**.

  1. Langkah terakhir adalah memastikan bahwa kotak centang **Akun, Grup, & Peran** dipilih di bawah **Izin**. 

 Setelah Anda memiliki token, tambahkan itu ke bidang `Token` konfigurasi dan Anda harus disetel\$1 

 Halaman konfigurasi akhir akan terlihat mirip dengan ini: 

### Penggunaan
<a name="wavefront-usage-6"></a>

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

 Editor kueri Wavefront memiliki dua mode: **Query Builder** dan **Raw** Query. Untuk beralih di antara keduanya, gunakan pemilih di kanan atas formulir kueri: 

 Dalam mode **Query Builder**, Anda akan disajikan dengan empat pilihan untuk membuat: 

1.  Metrik apa yang ingin Anda kueri? 

1.  Agregasi apa yang ingin Anda lakukan pada metrik itu? 

1.  Bagaimana Anda ingin memfilter hasil dari kueri metrik itu? 

1.  Apakah Anda ingin menerapkan fungsi tambahan pada hasilnya? 

 Pemilih metrik adalah hierarki yang dikategorikan. Pilih kategori, lalu pilih lagi untuk menelusuri subkategori. Ulangi proses ini sampai Anda mencapai metrik yang Anda inginkan. 

 Setelah memilih metrik, filter dan nilai filter yang tersedia akan diisi secara otomatis untuk Anda. 

 Dalam mode **Raw Query**, Anda akan melihat satu bidang berlabel **Query**. Ini memungkinkan Anda menjalankan kueri [WQL](#wavefront-references) apa pun yang Anda inginkan. 

#### Menggunakan filter
<a name="wavefront-using-filters-1"></a>

 Plugin Wavefront akan secara dinamis menanyakan filter yang sesuai untuk setiap metrik. 

 Untuk menambahkan filter, pilih **\$1** di sebelah label **Filter** pada editor kueri Wavefront, pilih bidang mana yang ingin Anda filter, dan pilih nilai yang akan difilter. 

#### Menggunakan fungsi
<a name="wavefront-using-functions"></a>

 Fungsi menyediakan cara tambahan untuk mengumpulkan, memanipulasi, dan melakukan perhitungan pada data respons metrik. Untuk melihat fungsi yang tersedia, pilih daftar dropdown dengan label fungsi pada **Query** Builder. Berdasarkan fungsi yang Anda pilih, Anda akan dapat melakukan tindakan lebih lanjut seperti mengatur grup berdasarkan bidang atau menerapkan ambang batas. Pengguna dapat menghubungkan beberapa fungsi bersama-sama untuk melakukan perhitungan lanjutan atau manipulasi data. 

#### Menambahkan variabel template kueri
<a name="wavefront-adding-a-query-template-variable-1"></a>

1.  Untuk membuat variabel template Wavefront baru untuk dasbor, pilih roda pengatur di bagian kanan atas dasbor. 

1.  Di panel di sebelah kiri, pilih **Variabel**. 

1.  Di kanan atas halaman Variabel, pilih **Baru**. 

1.  Masukkan **Nama** dan **Label** untuk variabel template yang ingin Anda buat. **Nama** adalah nilai yang akan Anda gunakan di dalam kueri untuk referensi variabel template. **Label** adalah nama yang ramah manusia untuk ditampilkan untuk variabel template pada panel pilih dasbor. 

1.  Pilih tipe **Query** untuk bidang tipe (harus dipilih secara default). 

1.  Di bawah judul **Query Options**, pilih **Wavefront** di daftar **dropdown Sumber data**. 

1.  Lihat [Struktur Kueri Variabel Template](#template-variable-query-structure) untuk detail tentang apa yang harus dimasukkan ke dalam bidang **Query**. 

1.  Jika Anda ingin memfilter salah satu nilai yang dikembalikan dari kueri Anda, masukkan ekspresi reguler di bidang input **Regex**. 

1.  Terapkan preferensi pengurutan apa pun yang mungkin Anda miliki dengan memilih jenis pengurutan di daftar dropdown **Sort**. 

1.  Setelah memverifikasi konfigurasi, pilih **Tambah** untuk menambahkan variabel template, lalu pilih **Simpan dasbor** di panel navigasi sebelah kiri untuk menyimpan perubahan Anda. 

#### Struktur kueri variabel template
<a name="template-variable-query-structure"></a>

 daftar metrik: metrik: ts (...) 

 daftar sumber: sumber: ts (...) 

 daftar tag sumber: sourceTags: ts (...) 

 daftar tag sumber yang cocok: matchingSourceTags: ts (...) 

 daftar nama tag: tagNames: ts (...) 

 daftar nilai tag: tagValues (<tag>): ts (...) 

 **Catatan** 
+  S di akhir setiap jenis kueri adalah opsional 
+  Support untuk semua huruf kecil. Anda dapat menggunakan tagname atau tagNames, tetapi tidak TAGNAMES. 
+  Menggunakan spasi di sekitar: adalah opsional 

   **PERINGATAN** 

   `Multi-value`dan saat `Include All option` ini tidak didukung oleh plugin Wavefront. 

#### Menggunakan variabel template
<a name="wavefront-using-template-variables-2"></a>

 Setelah menyelesaikan langkah-langkah untuk [menambahkan variabel template baru](#wavefront-adding-a-query-template-variable-1), Anda sekarang siap untuk menggunakan variabel template dalam panel dashboard Anda untuk membuat visualisasi dinamis. 

1.  Tambahkan panel dasbor baru menggunakan ikon panel\$1di sudut kanan atas dasbor Anda. 

1.  Pilih agregat yang ingin Anda gunakan untuk kueri Anda. 

1.  Pilih ikon\$1di samping label **Filter** dan pilih jenis kunci yang cocok dengan variabel template Anda. `host=`untuk filter host, misalnya. 

1.  Masukkan nama variabel template yang Anda buat di bidang input **Nilai** filter. 

1.  Simpan dasbor. 

 Anda sekarang harus dapat menelusuri nilai yang berbeda dari variabel template Anda dan memiliki panel Anda diperbarui secara dinamis\$1 

#### Menggunakan filter Ad-Hoc
<a name="wavefront-using-ad-hoc-filters"></a>

 Untuk menggunakan filter ad-hoc, kita harus membuat dua variabel template. Yang pertama adalah variabel pembantu yang akan digunakan untuk memilih metrik sehingga filter add-hoc dapat diisi untuk nama metrik tersebut. Yang lainnya akan menjadi variabel filter ad-hoc yang sebenarnya. 

**penting**  
 Variabel pembantu yang diperlukan harus diberi nama`metriclink`. Ini bisa berupa variabel kustom dengan daftar metrik yang ingin Anda gunakan atau variabel berbasis kueri menggunakan [Struktur Kueri Variabel Template](#template-variable-query-structure). Jika Anda ingin mengisi bidang filter ad-hoc hanya dengan nilai dari satu metrik, Anda dapat menyembunyikan variabel template. `metriclink` 

 Setelah membuat `metriclink` variabel, Anda sekarang dapat menambahkan filter ad-hoc dengan mengikuti langkah-langkah yang sama yang dirinci dalam [Menambahkan Variabel Template Kueri](#wavefront-adding-a-query-template-variable-1). Perbedaannya adalah Anda akan memilih **Filter Ad Hoc** sebagai **Jenis** dan tidak ada input yang diperlukan untuk kueri. 

#### Menambahkan anotasi
<a name="wavefront-adding-annotations"></a>

1.  Untuk membuat anotasi Wavefront baru untuk dasbor, pilih roda pengatur di bagian kanan atas dasbor. 

1.  Di panel di sebelah kiri, pilih **Anotasi**. 

1.  Di kanan atas halaman Anotasi, pilih **Baru**. 

1.  Masukkan nama untuk anotasi (ini akan digunakan sebagai nama sakelar di dasbor).

1.  Pilih **sumber data** dari Wavefront. 

1.  Secara default, anotasi memiliki batas 100 peristiwa peringatan yang akan dikembalikan. Untuk mengubahnya, atur bidang **Limit** ke nilai yang Anda inginkan. 

1.  Pilih **Tambahkan**. 

#### Menggunakan anotasi
<a name="using-annotations"></a>

 Saat anotasi diaktifkan, Anda sekarang akan melihat peristiwa peringatan dan masalah yang berkorelasi dengan periode waktu tertentu. 

 Jika Anda menjeda di bagian bawah bagian beranotasi visualisasi, jendela pop-up akan ditampilkan yang menunjukkan nama peringatan dan menyediakan tautan langsung ke peringatan di Wavefront. 

#### Menggunakan bidang Nama Tampilan
<a name="wavefront-using-display-name-1"></a>

 Sumber data ini menggunakan bidang Nama Tampilan di tab Bidang panel Opsi untuk mempersingkat atau mengubah kunci legenda berdasarkan nama, label, atau nilainya. Sumber data lain menggunakan `alias` fungsionalitas khusus untuk memodifikasi kunci legenda, tetapi fungsi Nama Tampilan adalah cara yang lebih konsisten untuk melakukannya. 

### Referensi
<a name="wavefront-references"></a>
+  [WQL (Wavefront Query Language)](https://docs.wavefront.com/query_language_reference.html) 

# Bekerja di Grafana versi 10
<a name="using-grafana-v10"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Saat Anda membuat ruang kerja Grafana, Anda memiliki opsi versi Grafana mana yang akan digunakan. Topik berikut menjelaskan penggunaan ruang kerja Grafana yang menggunakan Grafana versi 10.

**Topics**
+ [Dasbor di Grafana versi 10](v10-dashboards.md)
+ [Panel dan visualisasi dalam Grafana versi 10](v10-panels.md)
+ [Jelajahi di Grafana versi 10](v10-explore.md)
+ [Korelasi dalam Grafana versi 10](v10-correlations.md)
+ [Peringatan di Grafana versi 10](v10-alerts.md)

# Dasbor di Grafana versi 10
<a name="v10-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Dasbor adalah satu set dari satu atau lebih [panel](v10-panels.md) yang diatur dan disusun menjadi satu atau lebih baris. Grafana dikirimkan dengan berbagai panel sehingga mudah untuk membuat kueri yang tepat, dan menyesuaikan visualisasi sehingga Anda dapat membuat dasbor yang sempurna untuk kebutuhan Anda. Setiap panel dapat berinteraksi dengan data dari apa pun yang dikonfigurasi[Connect ke sumber data](AMG-data-sources.md). 

 Snapshot dasbor bersifat statis. Kueri dan ekspresi tidak dapat dieksekusi ulang dari snapshot. Akibatnya, jika Anda memperbarui variabel apa pun dalam kueri atau ekspresi Anda, itu tidak akan mengubah data dasbor Anda. 

**Topics**
+ [Menggunakan dasbor](v10-dash-using-dashboards.md)
+ [Membangun dasbor](v10-dash-building-dashboards.md)
+ [Mengelola dasbor](v10-dash-managing-dashboards.md)
+ [Mengelola daftar putar](v10-dash-managing-playlists.md)
+ [Berbagi dasbor dan panel](v10-dash-sharing.md)
+ [Variabel](v10-dash-variables.md)
+ [Menilai penggunaan dasbor](v10-dash-assess-dashboard-usage.md)
+ [Memecahkan masalah dasbor](v10-dash-troubleshoot.md)
+ [Mencari Dasbor di Grafana versi 10](v10-search.md)

# Menggunakan dasbor
<a name="v10-dash-using-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini memberikan ikhtisar fitur dasbor dan pintasan, dan menjelaskan cara menggunakan pencarian dasbor.

## Fitur
<a name="v10-dash-features"></a>

Anda dapat menggunakan dasbor untuk menyesuaikan presentasi data Anda. Gambar berikut menunjukkan antarmuka dasbor di ruang kerja Grafana yang Dikelola Amazon.

![\[Gambar yang menunjukkan antarmuka untuk dasbor di ruang kerja Grafana yang Dikelola Amazon, dengan sorotan untuk tombol untuk berbagai fitur.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Fitur  |  Deskripsi  | 
| --- | --- | 
| **1. Rumah** | Pilih ikon beranda Grafana yang akan diarahkan ke halaman beranda yang dikonfigurasi dalam instance Grafana. | 
| **2. Judul** | Saat Anda memilih judul dasbor, Anda dapat mencari dasbor yang terdapat di folder saat ini. | 
| **3. Berbagi dasbor** | Gunakan opsi ini untuk membagikan dasbor saat ini dengan tautan atau snapshot. Anda juga dapat mengekspor definisi dasbor dari modal saham. | 
| **4. Menambahkan panel baru** | Gunakan opsi ini untuk menambahkan panel, baris dasbor, atau panel perpustakaan ke dasbor saat ini. | 
| **5. Simpan dasbor** | Pilih ikon Simpan untuk menyimpan perubahan ke dasbor Anda. | 
| **6. Wawasan dasbor** | Pilih untuk melihat analitik tentang dasbor Anda, termasuk informasi tentang pengguna, aktivitas, dan jumlah kueri. Untuk informasi selengkapnya, lihat [Menilai penggunaan dasbor](v10-dash-assess-dashboard-usage.md). | 
| **7. Pengaturan dasbor** | Gunakan opsi ini untuk mengubah nama dasbor, folder, atau tag dan mengelola variabel dan kueri anotasi. Untuk informasi selengkapnya tentang setelan dasbor, lihat[Memodifikasi pengaturan dasbor](v10-dash-modify-settings.md). | 
| **8. Dropdown pemilih waktu** |  Gunakan untuk memilih opsi rentang waktu relatif dan mengatur rentang waktu absolut kustom. Anda dapat mengubah pengaturan **Zona waktu** dan **tahun fiskal** dari kontrol rentang waktu dengan mengklik **Ubah pengaturan waktu** tombol. Pengaturan waktu disimpan berdasarkan per dasbor.  | 
| **9. Memperkecil rentang waktu** |  Gunakan untuk memperkecil rentang waktu. Untuk informasi selengkapnya tentang cara menggunakan kontrol rentang waktu, lihat[Pengaturan rentang waktu dasbor](#v10-dash-setting-dashboard-time-range).  | 
| **10. Segarkan dasbor** | Pilih untuk segera memicu kueri dan menyegarkan data dasbor. | 
| **11. Segarkan interval waktu dasbor** | Pilih interval waktu penyegaran otomatis dasbor. | 
| **12. Mode tampilan**  | Pilih untuk menampilkan dasbor di layar besar seperti TV atau kios. Mode tampilan menyembunyikan informasi yang tidak relevan seperti menu navigasi.  | 
| **13. Panel dasbor** |  Blok bangunan utama dasbor adalah panel. Untuk menambahkan panel baru, baris dasbor, atau panel perpustakaan, pilih **Tambah panel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Legenda grafik** | Ubah warna seri, sumbu y, dan visibilitas seri langsung dari legenda. | 
| **15. Baris dasbor** | Baris dasbor adalah pembagi logis dalam dasbor yang mengelompokkan panel bersama-sama. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

## Pintasan keyboard
<a name="v10-dash-keyboard-shortcuts"></a>

Grafana memiliki sejumlah pintasan keyboard yang tersedia. **Untuk menampilkan semua pintasan keyboard yang tersedia untuk Anda, tekan?** atau **h** pada keyboard Anda.
+ `Ctrl+S`menyimpan dasbor saat ini. 
+ `f`membuka pencari dasbor/pencarian. 
+  `d+k`beralih mode kios (menyembunyikan menu). 
+ `d+e`memperluas semua baris. 
+ `d+s`membuka pengaturan dasbor. 
+ `Ctrl+K`membuka palet perintah.
+ `Esc`keluar dari panel saat dalam tampilan layar penuh atau mode edit. Juga mengembalikan Anda ke dasbor dari pengaturan dasbor.

**Panel terfokus**

Untuk menggunakan pintasan yang menargetkan panel tertentu, arahkan kursor ke panel dengan penunjuk Anda.
+ `e`beralih tampilan edit panel 
+ `v`beralih tampilan layar penuh panel 
+ `ps`membuka fitur berbagi panel 
+ `pd`panel duplikat 
+ `pr`menghapus panel 
+ `pl`beralih legenda panel 

## Pengaturan rentang waktu dasbor
<a name="v10-dash-setting-dashboard-time-range"></a>

Grafana menyediakan beberapa cara untuk mengelola rentang waktu data yang divisualisasikan, untuk dasbor, panel dan juga untuk peringatan.

Bagian ini menjelaskan unit waktu dan rentang relatif yang didukung, kontrol waktu umum, pengaturan waktu di seluruh dasbor, dan pengaturan waktu khusus panel.

**Satuan waktu dan rentang relatif**

Grafana mendukung satuan waktu berikut:`s (seconds)`,,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)` `M (months)``Q (quarters)`, dan. `y (years)` 

Operator minus memungkinkan Anda untuk mundur dalam waktu, relatif terhadap tanggal dan waktu saat ini, atau`now`. Jika Anda ingin menampilkan periode penuh unit (hari, minggu, atau bulan), tambahkan `/<time unit>` ke akhir. Untuk melihat periode fiskal, penggunaan `fQ (fiscal quarter)` dan satuan `fy (fiscal year)` waktu.

Operator plus memungkinkan Anda untuk melangkah maju dalam waktu, relatif terhadap sekarang. Misalnya, Anda dapat menggunakan fitur ini untuk melihat data yang diprediksi di masa mendatang.

Tabel berikut memberikan contoh rentang relatif.


| Contoh rentang relatif | Dari | Ke | 
| --- | --- | --- | 
| 5 menit terakhir |  `now-5m`  |  `now`  | 
| Hari sejauh ini |  `now/d`  |  `now`  | 
| Minggu ini |  `now/w`  |  `now/w`  | 
| Minggu ini sejauh ini |  `now/w`  |  `now`  | 
| Bulan ini |  `now/M`  |  `now/M`  | 
| Bulan ini sejauh ini |  `now/M`  |  `now`  | 
| Bulan Sebelumnya |  `now-1M/M`  |  `now-1M/M`  | 
| Tahun ini sejauh ini |  `now/Y`  |  `now`  | 
| Tahun ini |  `now/Y`  |  `now/Y`  | 
| Tahun fiskal sebelumnya |  `now-1y/fy`  |  `now-1y/fy`  | 

**catatan**  
 Grafana Alerting tidak mendukung sintaks berikut:  
`now+n`untuk stempel waktu masa depan.
`now-1n/n`untuk *awal n sampai akhir n*, karena ini adalah stempel waktu absolut.

**Kontrol rentang waktu umum**

Kontrol waktu dasbor dan panel memiliki antarmuka pengguna yang umum. Berikut ini menjelaskan kontrol rentang waktu umum.
+ Rentang waktu saat ini, juga disebut *pemilih waktu*, menunjukkan rentang waktu yang saat ini ditampilkan di dasbor atau panel yang Anda lihat. Arahkan kursor ke lapangan untuk melihat stempel waktu yang tepat dalam rentang dan sumbernya (seperti waktu browser lokal). Klik *rentang waktu saat ini* untuk mengubahnya. Anda dapat mengubah waktu saat ini menggunakan *rentang waktu relatif*, seperti 15 menit terakhir, atau rentang waktu absolut, seperti `2020-05-14 00:00:00` untuk`2020-05-15 23:59:59`.
+ **Rentang waktu relatif** dapat dipilih dari daftar **rentang waktu relatif**. Anda dapat memfilter daftar menggunakan bidang input di bagian atas. Beberapa contoh rentang waktu termasuk *30 menit terakhir*, *12 jam terakhir*, *7 hari terakhir*, *2 tahun terakhir*, *Kemarin*, *Hari sebelum kemarin*, *Hari ini minggu lalu*, *Hari ini sejauh* *ini, Minggu ini sejauh* ini, dan *Bulan ini sejauh* ini.
+ **Rentang waktu absolut** dapat diatur dalam dua cara: Mengetik nilai waktu yang tepat atau nilai waktu relatif ke dalam bidang **Dari** dan **Ke** dan mengklik **Terapkan rentang waktu**, atau mengklik rentang tanggal atau tanggal dari kalender yang ditampilkan saat Anda mengklik **Dari** atau **Ke** bidang. Untuk menerapkan pilihan Anda, klik **Terapkan rentang waktu**. Anda juga dapat memilih dari daftar rentang waktu absolut yang baru-baru ini digunakan.
+ **Rentang waktu semi-relatif** dapat dipilih dalam pengaturan rentang waktu absolut. Misalnya, untuk menampilkan aktivitas sejak tanggal tertentu, Anda dapat memilih waktu absolut untuk waktu mulai, dan waktu relatif (seperti`now`) untuk waktu akhir.

  Menggunakan rentang waktu semi-relatif, seiring berjalannya waktu, dasbor Anda akan secara otomatis dan progresif memperkecil untuk menampilkan lebih banyak riwayat dan lebih sedikit detail. Pada tingkat yang sama, karena resolusi data yang tinggi menurun, tren historis selama seluruh periode waktu akan menjadi lebih jelas.
**catatan**  
Peringatan tidak mendukung rentang waktu semi-relatif.
+ **Perkecil** dengan memilih ikon zoom out (atau dengan menggunakan Cmd\$1Z atau Ctrl\$1Z sebagai pintasan keyboard). Ini meningkatkan tampilan, menunjukkan rentang waktu yang lebih besar di dasbor atau visualisasi panel.
+ **Perbesar** dengan memilih rentang waktu yang ingin Anda lihat pada grafik dalam visualisasi.
**catatan**  
Zoom in hanya berlaku untuk visualisasi grafik. 

**Segarkan dasbor**

Klik ikon **Segarkan dasbor** untuk segera menjalankan setiap kueri di dasbor dan menyegarkan visualisasi. Grafana membatalkan permintaan yang tertunda saat Anda memicu penyegaran.

Secara default, Grafana tidak secara otomatis menyegarkan dasbor. Kueri berjalan sesuai jadwal mereka sendiri sesuai dengan pengaturan panel. Namun, jika Anda ingin menyegarkan dasbor secara teratur, klik panah bawah di sebelah ikon **Refresh dashboard** dan kemudian pilih interval penyegaran.

**Kontrol rentang waktu menggunakan URL**

Anda dapat mengontrol rentang waktu dasbor dengan memberikan parameter kueri berikut di URL dasbor.
+ `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms, atau waktu [relatif](#v10-dash-setting-dashboard-time-range).
+ `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms, atau waktu relatif.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

# Membangun dasbor
<a name="v10-dash-building-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setelah Anda membuat ruang kerja Grafana dan masuk, Anda dapat membuat dasbor dan memodifikasi pengaturan agar sesuai dengan kebutuhan Anda. Dasbor terdiri dari [panel dengan visualisasi](v10-panels-viz.md). Setiap panel memiliki kueri yang terkait dengannya, untuk menarik data dari salah satu Anda[Connect ke sumber data](AMG-data-sources.md).

Anda dapat membuat dasbor yang lebih interaktif dan dinamis dengan menambahkan dan menggunakan [variabel](v10-dash-variables.md). Alih-alih hard-coding server, aplikasi, atau nama lain dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya.

**Topics**
+ [Membuat dasbor](v10-dash-creating.md)
+ [Mengimpor dasbor](v10-dash-importing.md)
+ [Mengekspor dasbor](v10-dash-exporting.md)
+ [Memodifikasi pengaturan dasbor](v10-dash-modify-settings.md)
+ [Variabel URL dasbor](v10-dash-dashboard-url-variables.md)
+ [Mengelola panel perpustakaan](v10-dash-manage-library-panels.md)
+ [Mengelola riwayat versi dasbor](v10-dash-manage-version-history.md)
+ [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md)
+ [Visualisasi anotasi](v10-dash-annotations.md)
+ [Model Dashboard JSON](v10-dash-dashboard-json-model.md)
+ [Praktik terbaik untuk dasbor](v10-dash-bestpractices.md)

# Membuat dasbor
<a name="v10-dash-creating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

**Membuat dasbor**

Dasbor dan panel memungkinkan Anda menampilkan data Anda dalam bentuk visual menggunakan Grafana. Setiap panel membutuhkan setidaknya satu kueri untuk menampilkan visualisasi. Sebelum Anda memulai, selesaikan prasyarat berikut.
+ Pastikan Anda memiliki izin yang tepat. Untuk informasi selengkapnya tentang izin, lihat [Pengguna, tim, dan izin](Grafana-administration-authorization.md).
+ Identifikasi dasbor yang ingin Anda tambahkan panel.
+ Memahami bahasa kueri dari sumber data target.
+ Pastikan bahwa sumber data yang Anda tulis kueri telah ditambahkan. Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

 Untuk membuat dasbor:

1. Masuk ke Grafana, dan pilih **Dasbor dari menu** kiri.

1. Pilih **Baru**, lalu **Dasbor baru**.

1. Di dasbor kosong, pilih **\$1 Tambahkan visualisasi**. Ini membuka kotak dialog visualisasi baru.

1. Pilih sumber data. Anda dapat memilih sumber data yang ada, salah satu sumber data bawaan Grafana untuk pengujian, atau memilih **Konfigurasi sumber data baru** untuk menyiapkan yang baru (hanya pengguna dengan izin Admin yang dapat mengonfigurasi sumber data baru).

   Tampilan **panel Edit** terbuka, dengan sumber data Anda dipilih. Anda dapat mengubah sumber data untuk panel nanti, menggunakan tab **Query** dari editor panel, jika diperlukan.

1. Tulis atau buat kueri dalam bahasa kueri sumber data Anda. Pilih ikon segarkan dasbor untuk melakukan kueri pada sumber data, melihat hasilnya saat Anda pergi.

1. Dalam daftar **Visualisasi**, pilih jenis visualisasi. Grafana menampilkan pratinjau hasil kueri Anda dengan visualisasi yang diterapkan. Untuk informasi selengkapnya, lihat [Opsi visualisasi](v10-panels-viz.md).

1. Di bawah **opsi Panel**, Anda dapat memasukkan judul dan deskripsi untuk panel Anda. 

1. Sebagian besar visualisasi memerlukan beberapa penyesuaian sebelum mereka menampilkan informasi yang tepat yang Anda butuhkan. Anda dapat menyesuaikan pengaturan panel dengan cara berikut.
   + [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)
   + [Opsi khusus visualisasi](v10-panels-viz.md)
   + [Ganti nilai bidang](v10-panels-configure-overrides.md)
   + [Konfigurasikan ambang batas](v10-panels-configure-thresholds.md)
   + [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md)

1. Setelah selesai mengonfigurasi panel, pilih **Simpan untuk menyimpan** dasbor.

   Atau, pilih **Terapkan** untuk melihat perubahan tanpa meninggalkan editor panel.

1. Tambahkan catatan untuk menggambarkan visualisasi (atau jelaskan perubahan Anda) dan kemudian klik **Simpan** di sudut kanan atas halaman.
**catatan**  
Catatan sangat membantu jika Anda perlu mengembalikan dasbor ke versi sebelumnya.

1. Pilih **Simpan**.

1. Secara opsional, Anda dapat menambahkan lebih banyak panel ke dasbor dengan memilih **Tambahkan** di header dasbor, dan memilih **Visualisasi dari drop-down**.

**Menyalin dasbor yang ada**

Anda dapat dengan cepat menyalin dasbor yang ada, untuk memulai membuat yang baru.

**Untuk menyalin dasbor yang ada**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih dasbor yang ingin Anda salin, untuk membukanya.

1. Pilih **Pengaturan** (ikon roda gigi) di kanan atas dasbor.

1. Pilih **Simpan seperti** di sudut kanan atas dasbor.

1. (Opsional) Tentukan nama, folder, deskripsi, dan apakah akan menyalin tag dasbor asli untuk dasbor yang disalin atau tidak.

1. Pilih **Simpan**.

**Mengkonfigurasi baris berulang**

Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua baris di dasbor. Untuk informasi selengkapnya tentang panel berulang, lihat [Mengonfigurasi panel berulang.]()

Anda juga dapat mengulang baris jika Anda memiliki variabel yang ditetapkan dengan `Multi-value` atau `Include all values` dipilih.

Sebelum Anda memulai, pastikan bahwa kueri menyertakan variabel multi-nilai, maka Anda harus menyelesaikan langkah-langkah berikut.

**Untuk mengkonfigurasi baris berulang**

1. Pilih **Dasbor** dari menu kiri, lalu pilih dasbor yang ingin Anda ubah.

1. Di bagian atas dasbor, pilih **Tambah**, lalu pilih **Baris** dari drop-down.

   Jika dasbor kosong, Anda dapat secara bergantian memilih tombol **\$1 Tambahkan baris** di tengah dasbor.

1. Arahkan kursor ke judul baris dan pilih ikon **Pengaturan** (roda gigi) yang muncul.

1. Pada kotak dialog **Opsi Baris**, tambahkan judul dan pilih variabel yang ingin Anda tambahkan baris berulang.
**catatan**  
 Untuk memberikan konteks kepada pengguna dasbor, tambahkan variabel ke judul baris. 

1. Pilih **Perbarui**.

**Baris berulang dan sumber data khusus Dasbor**

Jika baris menyertakan panel menggunakan sumber data [Dasbor](AMG-data-sources.md#AMG-data-sources-special) khusus—sumber data yang menggunakan kumpulan hasil dari panel lain di dasbor smae—maka panel yang sesuai dalam baris berulang akan mereferensikan panel di baris asli, bukan yang ada di baris berulang.

Misalnya, di dasbor:
+ `Row 1`termasuk `Panel 1A` dan`Panel 1B`.
+ `Panel 1B`menggunakan hasil dari `Panel 1A` dengan menggunakan sumber `Dashboard` data.
+ Pengulangan `Row 2` termasuk `Panel 2A` dan`Panel 2B`.
+ `Panel 2B`Referensi`Panel 1A`, tidak`Panel 2A`.

**Untuk memindahkan panel**

1. Buka dasbor.

1. Pilih judul panel dan seret panel ke lokasi baru. Anda dapat menempatkan panel di dasbor di lokasi mana pun.

**Untuk mengubah ukuran panel**

1. Buka dasbor.

1. Untuk menyesuaikan ukuran panel, seret sudut kanan bawah panel. Anda dapat mengukur panel dasbor sesuai dengan kebutuhan Anda.

# Mengimpor dasbor
<a name="v10-dash-importing"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat mengimpor dasbor yang telah dikonfigurasi sebelumnya ke ruang kerja Grafana yang Dikelola Amazon.

**Untuk mengimpor dasbor**

1. Masuk ke ruang kerja Grafana Terkelola Amazon Anda.

1. Pilih **Dasbor** dari menu kiri.

1. Pilih **Baru** dan pilih **Impor** di menu tarik-turun.

1. Selanjutnya Anda harus memilih definisi JSON dasbor untuk diimpor. Anda memiliki tiga pilihan untuk cara mengimpor JSON:
   + Unggah file yang berisi dashboard JSON.
   + Langsung salin teks JSON ke area teks.
   + Tempelkan URL atau ID dasbor Grafana Labs ke bidang. Untuk informasi lebih lanjut tentang dasbor grafana.com URLs, lihat bagian selanjutnya.
   + (Opsional) Ubah detail dasbor yang ingin Anda ubah.
   + Pilih sumber data, jika diperlukan.
   + Pilih **Impor**.
   + Simpan dasbor.

## Menemukan dasbor di grafana.com
<a name="v10-dash-import-from-grafana"></a>

Halaman [Dasbor](https://grafana.com/grafana/dashboards/) di grafana.com memberi Anda dasbor untuk aplikasi server umum. Jelajahi pustaka dasbor resmi dan yang dibangun oleh komunitas dan impor untuk memulai dan menjalankan dengan cepat.

**catatan**  
Untuk mengimpor dasbor dari grafana.com, ruang kerja Grafana yang Dikelola Amazon Anda harus memiliki akses ke internet.

# Mengekspor dasbor
<a name="v10-dash-exporting"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menggunakan Grafana UI atau HTTP API untuk mengekspor dasbor.

Tindakan ekspor dasbor membuat file Grafana JSON yang berisi semua yang Anda butuhkan, termasuk tata letak, variabel, gaya, sumber data, kueri, dan sebagainya, sehingga Anda nantinya dapat mengimpor dasbor.

**Membuat dasbor portabel**

Jika Anda ingin mengekspor dasbor untuk digunakan orang lain, Anda dapat menambahkan variabel template untuk hal-hal seperti awalan metrik (gunakan variabel konstan) dan nama server.

Variabel template dari jenis ini `Constant` akan secara otomatis disembunyikan di dasbor, dan juga akan ditambahkan sebagai input yang diperlukan saat dasbor diimpor.

**Untuk mengekspor dasbor**

1. Buka dasbor yang ingin Anda ekspor.

1. Pilih ikon bagikan.

1. Pilih **Ekspor**.

1. Pilih **Simpan ke file.**

**catatan**  
Grafana mengunduh file JSON ke mesin lokal Anda. 

# Memodifikasi pengaturan dasbor
<a name="v10-dash-modify-settings"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman pengaturan dasbor memungkinkan Anda untuk:
+ Edit properti dasbor umum, termasuk pengaturan waktu.
+ Tambahkan kueri anotasi.
+ Tambahkan variabel dasbor.
+ Tambahkan tautan.
+ Lihat model JSON dasbor

**Untuk mengakses halaman pengaturan dasbor**

1. Buka dasbor dalam mode edit.

1. Klik **Pengaturan dasbor** (ikon roda gigi) yang terletak di bagian atas halaman.

**Memodifikasi pengaturan waktu dasbor**

Sesuaikan pengaturan waktu dasbor saat Anda ingin mengubah zona waktu dasbor, waktu browser lokal, dan tentukan interval waktu penyegaran otomatis.

**Untuk mengubah pengaturan waktu dasbor**

1. Pada halaman Pengaturan **dasbor**, pilih **Umum**.

1. Arahkan ke bagian **Opsi Waktu**.

1. Tentukan pengaturan waktu sesuai dengan deskripsi berikut.

1. 
   + **Timezone** — Tentukan zona waktu lokal layanan atau sistem yang Anda pantau. Ini dapat membantu ketika memantau sistem atau layanan yang beroperasi di beberapa zona waktu.
     + **Default** — Grafana menggunakan zona waktu default yang dipilih untuk profil pengguna, tim, atau organisasi. Jika tidak ada zona waktu yang ditentukan untuk profil pengguna, tim yang menjadi anggota pengguna, atau organisasi, maka Grafana menggunakan waktu browser lokal.
     + **Waktu browser lokal** — Zona waktu yang dikonfigurasi untuk browser pengguna tampilan digunakan. Ini biasanya zona waktu yang sama seperti yang diatur di komputer.
     + Gunakan [zona waktu standar ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), termasuk UTC.
   + **Penyegaran otomatis** - Sesuaikan opsi yang ditampilkan untuk waktu relatif dan opsi penyegaran otomatis. Entri dipisahkan koma dan menerima satuan waktu yang valid.
   + **Sekarang tunda** — Ganti `now` waktu dengan memasukkan waktu tunda. Gunakan opsi ini untuk mengakomodasi penundaan yang diketahui dalam agregasi data untuk menghindari nilai nol.
   + **Sembunyikan pemilih waktu** - Memilih opsi ini jika Anda tidak ingin dasbor menampilkan pemilih waktu.

**catatan**  
Untuk memiliki kontrol waktu, data Anda harus menyertakan kolom waktu. Lihat dokumentasi untuk [sumber data](AMG-data-sources.md) spesifik Anda untuk informasi selengkapnya tentang menyertakan kolom waktu.

**Menambahkan kueri anotasi**

Kueri anotasi adalah kueri yang menanyakan peristiwa. Peristiwa ini dapat divisualisasikan dalam grafik di dasbor sebagai garis vertikal bersama dengan ikon kecil yang dapat Anda arahkan kursor untuk melihat informasi acara.

**Untuk menambahkan kueri anotasi**

1. Pada halaman **Pengaturan dasbor**, pilih **Anotasi**.

1. Pilih **Tambahkan kueri anotasi**. 

1. Masukkan nama dan pilih sumber data.

1. Lengkapi sisa formulir untuk membuat kueri dan anotasi.

UI editor kueri berubah berdasarkan sumber data yang Anda pilih. lihat dokumentasi [sumber data](AMG-data-sources.md) untuk detail tentang cara membuat kueri. Atau, untuk plugin sumber data yang Anda instal dari[Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog), Anda dapat menggunakan [dokumentasi di situs web Grafana Labs](https://grafana.com/docs/grafana/v10.3/datasources/).

**Menambahkan variabel**

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Untuk informasi selengkapnya tentang variabel, lihat [Variabel](v10-dash-variables.md).

**Untuk menambahkan variabel**

1. Pada halaman **pengaturan Dasbor**, klik **Variabel** di menu bagian sisi kiri dan kemudian tombol **Tambahkan variabel**.

1. Di bagian **Umum**, tambahkan nama variabel. Ini adalah nama yang nantinya akan Anda gunakan dalam kueri.

1. Pilih variabel **Type**.
**catatan**  
Jenis variabel yang Anda pilih memengaruhi bidang mana yang Anda isi di halaman.

1. Tentukan variabel dan klik **Perbarui**.

**Menambahkan tautan**

Tautan dasbor memungkinkan Anda menempatkan tautan ke dasbor dan situs web lain langsung di bawah header dasbor. Tautan menyediakan navigasi yang mudah ke dasbor dan konten terkait lainnya. 

**Untuk menambahkan tautan**

1. Pada halaman **pengaturan Dasbor**, pilih **Tautan** dari menu bagian sisi kiri dan kemudian tombol **Tambahkan tautan**.

1. Masukkan judul dan di bidang **Jenis**, pilih **Dasbor** atau **Tautan**.

1. Untuk menambahkan tautan dasbor, tambahkan tag opsional, pilih salah satu opsi tautan dasbor, dan klik **Terapkan**.
**catatan**  
Menggunakan tag membuat dropdown dinamis dasbor yang semuanya memiliki tag tertentu.

1. Untuk menambahkan tautan web, tambahkan URL dan teks tooltip yang muncul saat pengguna mengarahkan kursor ke tautan, pilih ikon yang muncul di sebelah tautan, dan pilih salah satu opsi tautan dasbor. 

**Lihat dasbor model JSON**

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbor. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, kueri panel, dan sebagainya. Metadata JSON mendefinisikan dasbor.

Untuk melihat model JSON dasbor, pada halaman **pengaturan Dasbor**, klik **JSON**.

Untuk informasi selengkapnya tentang bidang JSON, lihat bidang [JSON](v10-dash-dashboard-json-model.md).

# Variabel URL dasbor
<a name="v10-dash-dashboard-url-variables"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana dapat menerapkan nilai variabel yang diteruskan sebagai parameter kueri di dasbor. URLs Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md) serta [Template dan variabel](v10-dash-variables.md).

**Melewati variabel sebagai parameter kueri**

Grafana menafsirkan parameter string kueri yang diawali dengan variabel di `var-` dasbor yang diberikan.

Misalnya, di URL ini: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Parameter query `var-example=value` merupakan contoh variabel dashboard dengan nilai`value`.

**Melewati beberapa nilai untuk variabel**

Untuk melewatkan beberapa nilai, ulangi parameter variabel sekali untuk setiap nilai.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana menafsirkan `var-example=value1&var-example=value2` sebagai contoh variabel dasbor dengan dua nilai: dan. `value1` `value2`

**Menambahkan variabel ke tautan dasbor**

Grafana dapat menambahkan variabel ke tautan dasbor saat Anda membuatnya dari pengaturan dasbor. Untuk informasi selengkapnya dan langkah-langkah untuk menambahkan variabel, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).

**Melewati filter ad hoc**

Filter ad hoc menerapkan filter kunci atau nilai ke semua kueri metrik yang menggunakan sumber data tertentu. Untuk informasi selengkapnya, lihat [Filter ad hoc](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

Untuk meneruskan filter ad hoc sebagai parameter kueri, gunakan sintaks variabel untuk meneruskan variabel filter ad hoc, dan juga berikan kunci, operator sebagai nilai, dan nilai sebagai daftar yang dipisahkan pipa.

Misalnya, di URL ini:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Parameter kueri `var-adhoc=key|=|value` menerapkan filter ad hoc yang dikonfigurasi sebagai variabel dasbor adhoc menggunakan `example_key` kunci, `=` operator, dan nilainya. `example_value`

**catatan**  
Saat berbagi URLs dengan filter ad hoc, ingatlah untuk menyandikan URL. Pada contoh di atas, ganti pipa (`|`) dengan `%7C` dan operator kesetaraan (`=`) dengan`%3D`.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengatur rentang waktu dasbor, gunakan parameter`from`,`to`,`time`, dan `time.window` kueri. Karena ini bukan variabel, mereka tidak memerlukan `var-` awalan.

# Mengelola panel perpustakaan
<a name="v10-dash-manage-library-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel perpustakaan adalah panel yang dapat digunakan kembali yang dapat Anda gunakan di dasbor apa pun. Saat Anda mengubah panel pustaka, perubahan menyebar ke semua contoh di mana panel digunakan. Panel perpustakaan merampingkan penggunaan kembali panel di beberapa dasbor.

Anda dapat menyimpan panel perpustakaan di folder bersama dasbor yang disimpan.

**Membuat panel perpustakaan**

Saat Anda membuat panel pustaka, panel di dasbor sumber juga dikonversi ke panel perpustakaan. Anda perlu menyimpan dasbor asli setelah panel dikonversi.

**Untuk membuat panel perpustakaan**

1. Buka panel yang ingin Anda konversi ke panel perpustakaan dalam mode edit.

1. Dalam opsi tampilan panel, klik opsi panah bawah untuk memulai perubahan pada visualisasi.

1. Pilih **panel Perpustakaan**, lalu **\$1 Buat panel perpustakaan**. Ini membuka dialog buat.

1. Di **nama panel Perpustakaan**, masukkan nama yang Anda inginkan untuk panel.

1. Di **Simpan di folder**, pilih folder untuk menyimpan panel perpustakaan.

1. Pilih **Buat panel perpustakaan** untuk menyimpan perubahan Anda ke perpustakaan.

1. Simpan dasbor.

Setelah panel perpustakaan dibuat, Anda dapat memodifikasi panel menggunakan dasbor apa pun yang muncul. Setelah Anda menyimpan perubahan, semua instance panel pustaka mencerminkan modifikasi ini.

Anda juga dapat membuat panel perpustakaan langsung dari menu edit panel apa pun, dengan memilih **More...** lalu **Buat panel perpustakaan**.

**Menambahkan panel pustaka ke dasbor**

Tambahkan panel pustaka Grafana ke dasbor saat Anda ingin memberikan visualisasi kepada pengguna dasbor lainnya.

**Untuk menambahkan panel pustaka ke dasbor**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **Baru**, lalu pilih **Dasbor baru** dari drop-down.

1. Di dasbor kosong, pilih **\$1 Impor panel perpustakaan**. Anda akan melihat daftar panel perpustakaan Anda.

1. Filter daftar atau cari untuk menemukan panel yang ingin Anda tambahkan.

1. Klik panel untuk menambahkannya ke dasbor.

**Membatalkan tautan panel pustaka**

Putuskan tautan panel pustaka saat Anda ingin membuat perubahan pada panel dan tidak memengaruhi contoh panel pustaka lainnya.

**Untuk memutuskan tautan panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**.

1. Pilih panel perpustakaan yang sedang digunakan di dasbor yang berbeda.

1. Pilih panel yang ingin Anda putuskan tautannya.

1. Pilih judul panel (atau arahkan penunjuk ke mana saja di atas panel), untuk menampilkan menu tindakan di sudut kanan atas panel.

1. Pilih **Edit**. Panel akan terbuka dalam mode edit.

1. Pilih **Putuskan tautan** di sudut kanan atas halaman.

1. Pilih **Ya, batalkan tautan**.

**Melihat daftar panel pustaka**

Anda dapat melihat daftar panel pustaka yang tersedia dan mencari panel perpustakaan.

**Untuk melihat daftar panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**. Anda dapat melihat daftar panel pustaka yang ditentukan sebelumnya.

1. Cari panel perpustakaan tertentu jika Anda tahu namanya. Anda juga dapat memfilter panel berdasarkan folder atau jenis.

**Menghapus panel pustaka**

Hapus panel perpustakaan saat Anda tidak lagi membutuhkannya.

**Untuk menghapus panel pustaka**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **panel Perpustakaan**.

1. Pilih ikon hapus di sebelah nama panel perpustakaan untuk panel yang ingin Anda hapus.

# Mengelola riwayat versi dasbor
<a name="v10-dash-manage-version-history"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setiap kali Anda menyimpan versi dasbor Anda, salinan versi itu disimpan sehingga versi dasbor Anda sebelumnya tidak hilang. Daftar versi ini tersedia dengan memasukkan pengaturan dasbor dan kemudian memilih **Versi** di menu sebelah kiri.

**catatan**  
20 versi terbaru dari dasbor disimpan.

Fitur riwayat versi dasbor memungkinkan Anda membandingkan dan mengembalikan ke versi dasbor yang disimpan sebelumnya.

**Membandingkan dua versi dasbor**

Untuk membandingkan dua versi dasbor, pilih dua versi dari daftar yang ingin Anda bandingkan. Klik **Bandingkan versi** untuk melihat perbedaan antara dua versi. Ini memunculkan tampilan diff versi. Secara default, Anda akan melihat ringkasan tekstual perubahan.

Jika Anda ingin melihat perbedaan JSON mentah yang mewakili dasbor Anda, Anda dapat melakukannya dengan mengklik tombol **View JSON Diff** di bagian bawah.

**Memulihkan ke versi dasbor yang disimpan sebelumnya**

Jika Anda perlu mengembalikan ke versi dasbor yang disimpan sebelumnya, Anda dapat memilih tombol **Pulihkan** di sebelah kanan baris dalam daftar versi dasbor, atau pilih** <x>tombol **Pulihkan ke versi** di tampilan diff. Memilih salah satu dari ini akan meminta Anda untuk mengkonfirmasi pemulihan.

Setelah memulihkan ke versi sebelumnya, versi baru akan dibuat yang berisi data yang sama persis dengan versi sebelumnya, hanya dengan nomor versi yang berbeda. Ini ditunjukkan di **kolom Catatan** untuk baris di versi dasbor baru. Ini memastikan versi dasbor Anda sebelumnya tidak terpengaruh oleh perubahan.

# Mengelola tautan dasbor
<a name="v10-dash-manage-dashboard-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menggunakan tautan untuk menavigasi antara dasbor yang umum digunakan atau untuk menghubungkan orang lain ke visualisasi Anda. Tautan memungkinkan Anda membuat pintasan ke dasbor, panel, dan bahkan situs web eksternal lainnya.

Grafana mendukung tautan dasbor, tautan panel, dan tautan data. Tautan dasbor ditampilkan di bagian atas dasbor. Tautan panel dapat diakses dengan mengklik ikon di sudut kiri atas panel.

**Memilih tautan mana yang akan digunakan**

Mulailah dengan mencari tahu bagaimana Anda saat ini menavigasi antar dasbor. Jika Anda sering melompat di antara satu set dasbor dan berjuang untuk menemukan konteks yang sama di masing-masing, tautan dapat membantu mengoptimalkan alur kerja Anda.

Langkah selanjutnya adalah mencari tahu jenis tautan mana yang tepat untuk alur kerja Anda. Meskipun semua jenis tautan di Grafana digunakan untuk membuat pintasan ke dasbor lain atau situs web eksternal, mereka bekerja dalam konteks yang berbeda.
+ Jika tautan terkait dengan sebagian besar jika tidak semua panel di dasbor, gunakan tautan dasbor.
+ Jika Anda ingin menelusuri panel tertentu, gunakan tautan panel.
+ Jika Anda ingin menautkan ke situs eksternal, Anda dapat menggunakan tautan dasbor atau tautan panel.
+ Jika Anda ingin menelusuri seri tertentu, atau bahkan pengukuran tunggal, gunakan tautan data.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengontrol rentang waktu panel atau dasbor, Anda dapat memberikan parameter kueri di URL dasbor:
+ `from`mendefinisikan batas bawah rentang waktu, ditentukan dalam ms epoch.
+ `to`mendefinisikan batas atas rentang waktu, ditentukan dalam ms epoch.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

**Tautan dasbor**

Saat Anda membuat tautan dasbor, Anda dapat menyertakan rentang waktu dan variabel template saat ini untuk langsung melompat ke konteks yang sama di dasbor lain. Dengan cara ini, Anda tidak perlu khawatir apakah orang yang Anda kirimi tautan melihat data yang tepat. Untuk jenis tautan lainnya, lihat [Variabel tautan data]().

Tautan dasbor juga dapat digunakan sebagai pintasan ke sistem eksternal, seperti mengirimkan GitHub masalah dengan nama dasbor saat ini.

Setelah menambahkan tautan dasbor, itu akan muncul di sudut kanan atas dasbor Anda.

**Menambahkan tautan ke dasbor**

Tambahkan tautan ke dasbor lain di bagian atas dasbor Anda saat ini.

**Untuk menambahkan tautan ke dasbor**

1. Saat melihat dasbor yang ingin Anda tautkan, klik roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Pilih **Tautan** dan kemudian **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di **Type**, pilih **dasbor**.

1. Pilih opsi tautan dari berikut ini.
   + **Dengan tag** - Masukkan tag untuk membatasi dasbor yang ditautkan hanya dengan tag yang Anda masukkan. Jika tidak, Grafana menyertakan tautan ke semua dasbor lainnya.
   + **Sebagai dropdown** — Jika Anda menautkan ke banyak dasbor, Secara default, Grafana menampilkan semuanya side-by-side di bagian atas dasbor Anda. Memilih opsi ini dan menambahkan judul opsional, akan menampilkan tautan dalam dropdown.
   + **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
   + **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan. Untuk informasi selengkapnya, lihat [Variabel URL Dasbor](v10-dash-dashboard-url-variables.md).
   + **Buka di tab baru** - Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru.

1. Klik **Tambah**.

**Menambahkan tautan URL ke dasbor**

Tambahkan tautan ke URL di bagian atas dasbor Anda saat ini. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

**Untuk menambahkan tautan URL ke dasbor**

1. Saat melihat dasbor yang ingin Anda tautkan, pilih roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Pilih **Tautan** dan kemudian **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di **Ketik**, pilih **Tautan**.

1. Pilih opsi tautan dari berikut ini.
   + **URL** — Masukkan URL yang ingin Anda tautkan. Bergantung pada target, Anda mungkin ingin menyertakan nilai bidang.
   + **Judul** - Masukkan judul yang ingin ditampilkan tautan.
   + **Tooltip** - Masukkan tooltip yang ingin ditampilkan tautan.
   + **Ikon** - Pilih ikon yang ingin ditampilkan dengan tautan.
   + **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditentukan.
     + `from`— Mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms.
     + `to`— Mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms.
     + `time`dan `time.window` — Tentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
   + **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan.

     Format variabel adalah sebagai berikut:

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + **Buka di tab baru** - Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru

1. Pilih **Tambahkan**.

**Memperbarui tautan dasbor**

Untuk mengubah atau memperbarui tautan dasbor yang ada, ikuti prosedur ini.

**Untuk memperbarui tautan dasbor**

1. Di **pengaturan Dasbor,** pada tab **Tautan**, pilih tautan yang ada yang ingin Anda edit.

1. Ubah pengaturan dan kemudian pilih **Perbarui**.

**Menduplikasi tautan dasbor**

Untuk menduplikasi tautan dasbor yang ada, pilih ikon duplikat di sebelah tautan yang ada yang ingin Anda duplikat.

**Menghapus tautan dasbor**

Untuk menghapus tautan dasbor yang ada, pilih ikon sampah di samping tautan yang ingin Anda hapus.

**Tautan panel**

Setiap panel dapat memiliki rangkaian tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

Untuk melihat tautan panel yang tersedia, pilih ikon di sebelah kanan judul panel.
+ **Menambahkan tautan panel**: Setiap panel dapat memiliki kumpulan tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana. Klik ikon di sudut kiri atas panel untuk melihat tautan panel yang tersedia.

  1. Arahkan kursor ke panel yang ingin Anda tambahkan tautannya.

  1. Pilih menu, dan pilih **Edit**, atau Anda dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Pilih **Tambahkan tautan**.

  1. Masukkan **Judul**. Ini adalah label yang dapat dibaca manusia untuk tautan yang akan ditampilkan di UI.

  1. Masukkan **URL** yang ingin Anda tautkan. Tekan `Ctrl+Space` (atau`Cmd+Space`) dan pilih bidang URL untuk melihat variabel yang tersedia. Dengan menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan.

     Anda juga dapat menggunakan variabel waktu.
     + `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms.
     + `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam epoch ms.
     + `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
+ **Memperbarui tautan panel**

  1. Pilih panel (atau letakkan kursor di atas panel) untuk menampilkan menu tindakan di kanan atas panel.

  1. Dari menu, pilih **Edit**.

     Anda juga dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Temukan tautan yang ingin Anda ubah, dan pilih ikon **Edit** (pensil) di sebelahnya.

  1. Buat perubahan yang diperlukan.

  1. Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela.

  1. Simpan perubahan ke dasbor Anda dengan memilih **Simpan** di kanan atas.
+ **Menghapus tautan panel**

  1. Pilih panel (atau letakkan kursor di atas panel) untuk menampilkan menu tindakan di kanan atas panel.

  1. Dari menu, pilih **Edit**.

     Anda juga dapat menggunakan pintasan keyboard,`e`.

  1. Perluas bagian **opsi Panel**, dan gulir ke bawah ke **tautan Panel**.

  1. Temukan tautan yang ingin Anda hapus, dan pilih ikon **X** di sebelahnya.

  1. Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor.

# Visualisasi anotasi
<a name="v10-dash-annotations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anotasi menyediakan cara untuk menandai poin pada visualisasi dengan acara yang kaya. Mereka divisualisasikan sebagai garis vertikal dan ikon pada semua panel grafik. Saat Anda mengarahkan kursor ke anotasi, Anda bisa mendapatkan deskripsi acara dan tag acara. Bidang teks dapat menyertakan tautan ke sistem lain dengan lebih detail.

Anda dapat membuat anotasi visualisasi dengan tiga cara:
+ Langsung di panel, menggunakan [kueri anotasi bawaan](#v10-dash-built-in-query).
+ Menggunakan Grafana HTTP API.
+ Mengkonfigurasi kueri anotasi di pengaturan dasbor.

Dalam dua kasus pertama, Anda membuat anotasi baru, sementara yang terakhir Anda menanyakan anotasi yang ada dari sumber data. Kueri anotasi bawaan juga mendukung ini.

Bagian ini menjelaskan opsi pertama dan ketiga; untuk informasi tentang penggunaan Grafana HTTP API, lihat. [API Anotasi](Grafana-API-Annotations.md)

Anotasi didukung untuk jenis visualisasi berikut:
+ Deret waktu 
+ Garis waktu negara
+ Candlestick

## Buat anotasi di panel
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana hadir dengan kemampuan untuk menambahkan peristiwa anotasi langsung dari panel menggunakan [kueri anotasi bawaan](#v10-dash-built-in-query) yang ada di semua dasbor. Anotasi yang Anda buat dengan cara ini disimpan di Grafana.

Untuk menambahkan anotasi langsung di panel:
+ Dasbor harus sudah disimpan.
+ Kueri bawaan harus diaktifkan.

**Untuk menambahkan anotasi**

1. Di dasbor pilih panel tempat Anda menambahkan anotasi. Menu konteks akan muncul. 

1. Di menu konteks, pilih **Tambahkan anotasi**.

1. (Opsional) Tambahkan deskripsi anotasi dan tag.

1. Pilih **Simpan**.

Atau, untuk menambahkan anotasi, tekan `Ctrl` (atau`Cmd`) saat memilih panel, dan popover **Tambahkan anotasi akan** muncul.

**Anotasi wilayah**

Anda juga dapat membuat anotasi yang mencakup wilayah, atau periode waktu dalam visualisasi.

**Untuk menambahkan anotasi wilayah**

1. Di dasbor tekan `Ctrl` (atau`Cmd`) saat memilih area panel.

1.  Tambahkan deskripsi anotasi dan tag (opsional). 

1.  Klik **Simpan**. 

**Untuk mengedit anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel.

1. Pilih ikon **Edit** (pensil) di tooltip anotasi.

1. Ubah and/or tag deskripsi.

1. Pilih **Simpan**.

**Untuk menghapus anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel.

1. Pilih ikon **Hapus** (sampah) di tooltip anotasi.

## Ambil anotasi melalui pengaturan dasbor
<a name="v10-dash-fetch-annotations"></a>

Di pengaturan dasbor, di bawah **Anotasi**, Anda dapat menambahkan kueri baru untuk mengambil anotasi menggunakan sumber data apa pun, termasuk sumber data anotasi data bawaan. Kueri anotasi mengembalikan peristiwa yang dapat divisualisasikan sebagai penanda peristiwa dalam grafik di seluruh dasbor. 

**Untuk menambahkan kueri anotasi baru**

1. Pilih ikon **Pengaturan** (roda gigi) di header dasbor untuk membuka menu pengaturan.

1. Pilih **Anotasi**.

1. Klik **Tambahkan kueri anotasi**.

1. Masukkan nama untuk kueri anotasi.

   Nama ini diberikan ke sakelar (kotak centang) yang memungkinkan Anda mengaktifkan menampilkan peristiwa anotasi dari kueri ini. 

1. Pilih sumber data untuk anotasi.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data baru (hanya tersedia untuk Admin).

1. Jika Anda tidak ingin segera menggunakan kueri anotasi, kosongkan kotak centang **Diaktifkan**.

1. **Jika Anda tidak ingin sakelar kueri anotasi ditampilkan di dasbor, pilih kotak centang Tersembunyi.**

1. Pilih warna untuk penanda acara.

1. Di menu tarik-turun **Tampilkan di**, pilih salah satu opsi berikut:
   + **Semua panel** — Anotasi ditampilkan pada semua panel yang mendukung anotasi.
   + **Panel yang dipilih** - Anotasi ditampilkan pada semua panel yang Anda pilih.
   + **Semua panel kecuali** - Anotasi ditampilkan pada semua panel kecuali yang Anda pilih.

1. Konfigurasikan kueri.

   Opsi kueri anotasi berbeda untuk setiap sumber data. Untuk informasi tentang anotasi dalam sumber data tertentu, lihat[Connect ke sumber data](AMG-data-sources.md).

## Kueri bawaan
<a name="v10-dash-built-in-query"></a>

Setelah Anda menambahkan anotasi, mereka akan tetap terlihat. Ini karena kueri anotasi bawaan yang ada di semua dasbor. Kueri anotasi ini akan mengambil semua peristiwa anotasi yang berasal dari dasbor saat ini, yang disimpan di Grafana, dan menampilkannya di panel tempat pembuatannya. Ini termasuk anotasi riwayat status peringatan.

Secara default, kueri anotasi bawaan menggunakan sumber data `Grafana` khusus, dan anotasi manual hanya didukung menggunakan sumber data ini. Anda dapat menggunakan sumber data lain dalam kueri anotasi bawaan, tetapi Anda hanya dapat membuat anotasi otomatis menggunakan editor kueri untuk sumber data tersebut.

Untuk menambahkan anotasi langsung ke dasbor, kueri ini harus diaktifkan.

**Untuk mengonfirmasi kueri bawaan diaktifkan**

1. Pilih ikon **pengaturan** dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.

1. Pilih **Anotasi**. 

1. Temukan kueri **Anotasi & Peringatan (Built-in)**.

   Jika ditampilkan **Dinonaktifkan** sebelum nama kueri, maka Anda harus memilih nama kueri untuk membukanya dan memperbarui pengaturan.

**Untuk menghentikan anotasi agar tidak diambil dan digambar**

1. Pilih ikon **pengaturan** dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.

1. Pilih **Anotasi**. 

1. Pilih kueri **Anotasi & Peringatan (Built-in)**.

1. Pilih sakelar **Diaktifkan** untuk mematikannya.

Saat Anda menyalin dasbor menggunakan fitur **Simpan Sebagai**, itu akan mendapatkan id dasbor baru, jadi anotasi yang dibuat di dasbor sumber tidak akan lagi terlihat pada salinan. Anda masih dapat menunjukkannya jika Anda menambahkan **Kueri Anotasi** baru dan memfilter berdasarkan tag. Namun, ini hanya berfungsi jika anotasi di dasbor sumber memiliki tag untuk difilter.

**Memfilter kueri berdasarkan tag**

**Anda dapat membuat kueri baru untuk mengambil anotasi dari kueri anotasi bawaan menggunakan sumber `Grafana` data dengan menyetel Filter menurut ke.** `Tags`

Misalnya, buat nama kueri anotasi `outages` dan tentukan tag`outage`. Kueri ini akan menampilkan semua anotasi (dari dasbor apa pun atau melalui API) dengan `outage` tag. Jika beberapa tag didefinisikan dalam kueri anotasi, maka Grafana hanya akan menampilkan anotasi yang cocok dengan semua tag. Untuk mengubah perilaku, aktifkan **Match any**, dan Grafana akan menampilkan anotasi yang berisi salah satu tag yang Anda berikan.

 Anda juga dapat menggunakan variabel template dalam kueri tag. Ini berarti jika Anda memiliki dasbor yang menampilkan statistik untuk layanan yang berbeda dan variabel template yang menentukan layanan mana yang akan ditampilkan, Anda dapat menggunakan variabel template yang sama dalam kueri anotasi Anda untuk hanya menampilkan anotasi untuk layanan tersebut. 

# Model Dashboard JSON
<a name="v10-dash-dashboard-json-model"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbornya. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, dan kueri panel.

**Untuk melihat JSON dasbor**

1. Arahkan ke dasbor.

1. Di menu navigasi atas, pilih ikon **Pengaturan dasbor** (roda gigi).

1. Pilih **Model JSON**.

## Bidang JSON
<a name="v10-dash-json-fields"></a>

Saat pengguna membuat dasbor baru, objek JSON dasbor baru diinisialisasi dengan bidang berikut.

**catatan**  
Dalam JSON berikut, id ditampilkan sebagai null, yang merupakan nilai default yang ditetapkan untuk itu sampai dashboard disimpan. Setelah dasbor disimpan, nilai integer ditetapkan ke `id` bidang.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Berikut ini menjelaskan setiap bidang di dashboard JSON.


| Nama | Penggunaan | 
| --- | --- | 
| `id` | pengidentifikasi numerik unik untuk dasbor (dihasilkan oleh db) | 
| `uid` | pengidentifikasi dasbor unik yang dapat dihasilkan oleh siapa saja. string (8-40) | 
| `title` | judul dasbor saat ini | 
| `tags` | tag yang terkait dengan dasbor, array string | 
| `style` | tema dasbor, seperti `dark` atau `light` | 
| `timezone` | zona waktu dasbor, seperti `utc` atau `browser` | 
| `editable` | apakah dasbor dapat diedit atau tidak | 
| `graphTooltip` | 0 tanpa crosshair bersama atau tooltip (default), 1 untuk crosshair bersama, 2 untuk crosshair bersama dan tooltip bersama | 
| `time` | rentang waktu untuk dasbor, seperti `last 6 hours` atau `last 7 days` | 
| `timepicker` | [metadata timepicker, lihat bagian timepicker untuk detailnya](#v10-dash-json-panels) | 
| `templating` | template metadata, lihat bagian [templating](#v10-dash-json-panels) untuk detailnya | 
| `annotations` | metadata anotasi, lihat [anotasi](v10-dash-annotations.md) untuk cara menambahkannya | 
| `refresh` | interval penyegaran otomatis | 
| `schemaVersion` | versi skema JSON (integer), bertambah setiap kali pembaruan Grafana membawa perubahan pada skema ini | 
| `version` | versi dasbor (integer), bertambah setiap kali dasbor diperbarui | 
| `panels` | panel array (lihat bagian selanjutnya untuk detailnya) | 

## Panel
<a name="v10-dash-json-panels"></a>

Panel adalah blok bangunan dasbor. Ini terdiri dari kueri sumber data, jenis grafik, alias, dan banyak lagi. Panel JSON terdiri dari array objek JSON, masing-masing mewakili panel yang berbeda. Sebagian besar bidang umum untuk semua panel tetapi beberapa bidang tergantung pada jenis panel. Berikut ini adalah contoh panel JSON dari panel teks.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Ukuran dan posisi panel**

Properti GridPOS menjelaskan ukuran panel dan posisi dalam koordinat grid.
+ `w`- 1 hingga 24 (lebar dasbor dibagi menjadi 24 kolom)
+ `h`— Dalam satuan tinggi grid, masing-masing mewakili 30 piksel.
+ `x`— Posisi x, dalam satuan yang sama dengan`w`.
+ `y`— Posisi y, dalam satuan yang sama dengan`h`.

Grid memiliki gravitasi negatif yang bergerak ke atas panel jika ada ruang kosong di atas panel.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Templating**

`templating`Bidang berisi array variabel template dengan nilai yang disimpan bersama dengan beberapa metadata lainnya.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

Tabel berikut menjelaskan penggunaan bidang templating.


| Nama | Penggunaan | 
| --- | --- | 
|  `enable`  |  apakah templating diaktifkan atau tidak  | 
|  `list`  |  array objek masing-masing mewakili satu variabel template  | 
|  `allFormat`  |  format yang akan digunakan saat mengambil semua nilai dari sumber data, termasuk`wildcard`,, `glob``regex`,`pipe`.  | 
|  `current`  |  menunjukkan variabel yang dipilih saat ini text/value di dasbor  | 
|  `datasource`  |  menunjukkan sumber data untuk variabel  | 
|  `includeAll`  |  apakah semua opsi nilai tersedia atau tidak  | 
|  `multi`  |  apakah beberapa nilai dapat dipilih atau tidak dari daftar nilai variabel  | 
|  `multiFormat`  |  format yang akan digunakan saat mengambil timeseries dari sumber data  | 
|  `name`  |  nama variabel  | 
|  `options`  |  array text/value pasangan variabel yang tersedia untuk seleksi di dasbor  | 
|  `query`  |  kueri sumber data yang digunakan untuk mengambil nilai untuk variabel  | 
|  `refresh`  |  mengonfigurasi kapan harus me-refresh variabel  | 
|  `regex`  |  mengekstrak bagian dari nama seri atau segmen simpul metrik  | 
|  `type`  |  jenis variabel,`custom`,`query`, atau `interval`  | 

# Praktik terbaik untuk dasbor
<a name="v10-dash-bestpractices"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Bagian ini memberikan informasi tentang praktik terbaik bagi administrator dan pengguna Grafana tentang cara membuat dan memelihara dasbor Grafana.

Untuk informasi tentang berbagai jenis dasbor yang dapat Anda buat, lihat [dasbor Grafana: Panduan lengkap untuk semua jenis berbeda yang dapat Anda](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) buat posting blog di situs web Grafana Labs.

**catatan**  
Bagian ini dapat membantu Anda membuat strategi untuk pemantauan dan pemeliharaan dasbor Anda. Anda tahu sistem Anda yang terbaik, dan harus menggunakan bagian ini untuk memandu pemahaman Anda. Pada akhirnya, adalah tanggung jawab Anda untuk menciptakan strategi terbaik untuk sistem Anda.

## Strategi observabilitas umum
<a name="v10-dash-common-observability-strategies"></a>

Ketika Anda memiliki banyak hal untuk dipantau, seperti server farm, Anda memerlukan strategi untuk memutuskan apa yang cukup penting untuk dipantau. Halaman ini menjelaskan beberapa metode umum untuk memilih apa yang akan dipantau.

Strategi logis memungkinkan Anda membuat dasbor yang seragam dan menskalakan platform observabilitas Anda dengan lebih mudah.

**Pedoman strategi**
+ Metode USE memberi tahu Anda betapa bahagianya mesin Anda, metode RED memberi tahu Anda betapa bahagianya pengguna Anda.
+ Gunakan laporan tentang penyebab masalah.
+ RED melaporkan pengalaman pengguna dan lebih cenderung melaporkan gejala masalah.
+ Memantau keduanya penting untuk memahami sistem Anda. Sebagai praktik terbaik, waspada pada gejala daripada penyebab. Biasanya, peringatan dikonfigurasi pada dasbor MERAH.

**Gunakan metode**

USE adalah singkatan dari:
+ **Pemanfaatan** — Persentase waktu sumber daya sibuk, seperti penggunaan CPU node.
+ **Saturasi** — Jumlah pekerjaan yang harus dilakukan sumber daya, seringkali panjang antrian atau beban simpul.
+ **Kesalahan** — Hitungan peristiwa kesalahan.

Metode ini paling baik untuk sumber daya perangkat keras dalam infrastruktur, seperti CPU, memori, dan perangkat jaringan. [Untuk informasi lebih lanjut, lihat posting blog Brendan Gregg Metode USE.](http://www.brendangregg.com/usemethod.html)

**Metode RED**

RED adalah singkatan dari:
+ **Tarif** - Permintaan per detik
+ **Kesalahan** — Jumlah permintaan yang gagal.
+ **Durasi** — Jumlah waktu yang dibutuhkan permintaan ini, distribusi pengukuran latensi.

Metode ini paling berlaku untuk layanan, terutama lingkungan microservices. Untuk setiap layanan Anda, instrumen kode untuk mengekspos metrik ini untuk setiap komponen. Dasbor MERAH bagus untuk mengingatkan dan. SLAs Dasbor RED yang dirancang dengan baik adalah proxy untuk pengalaman pengguna.

Untuk informasi lebih lanjut, lihat posting blog Tom Wilkie [Metode RED: Cara instrumen layanan Anda](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Empat Sinyal Emas**

Menurut [buku pegangan Google SRE](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), jika Anda hanya dapat mengukur empat metrik sistem yang dihadapi pengguna Anda, fokuslah pada keempat metrik ini.

Metode ini mirip dengan metode RED, tetapi termasuk saturasi.
+ **Latensi** — Waktu yang dibutuhkan untuk melayani permintaan.
+ **Lalu Lintas** — Berapa banyak permintaan yang ditempatkan pada sistem Anda.
+ **Kesalahan** — Tingkat permintaan yang gagal.
+ **Saturasi** — Seberapa “penuh” sistem Anda,

## Model kematangan manajemen dasbor
<a name="v10-dash-management-maturity-model"></a>

*Kematangan manajemen dasbor* mengacu pada seberapa baik dirancang dan efisien ekosistem dasbor Anda. Kami merekomendasikan untuk meninjau pengaturan dasbor Anda secara berkala untuk mengukur di mana Anda berada dan bagaimana Anda dapat meningkatkan.

Secara garis besar, kematangan dasbor dapat didefinisikan sebagai rendah, sedang, atau tinggi. 

 Sebagian besar konten untuk topik ini diambil dari pembicaraan KubeCon 2019 [Fool-Proof Kubernetes Dashboards for Sleep-Deprived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY). 

**Rendah - keadaan default**

Pada tahap ini, Anda tidak memiliki strategi manajemen dasbor yang koheren. Hampir semua orang mulai dari sini.

Bagaimana Anda bisa tahu Anda ada di sini?
+ Semua orang dapat memodifikasi dasbor Anda.
+ Banyak dasbor yang disalin, sedikit atau tidak ada penggunaan kembali dasbor.
+ Dasbor satu kali yang berkeliaran selamanya.
+ Tidak ada kontrol versi (dasbor JSON dalam kontrol versi).
+ Banyak browsing untuk dashboard, mencari dashboard yang tepat. Ini berarti banyak waktu yang terbuang untuk mencoba menemukan dasbor yang Anda butuhkan.
+ Tidak ada peringatan untuk mengarahkan Anda ke dasbor kanan.

**Sedang - dasbor metodis**

Pada tahap ini, Anda mulai mengelola penggunaan dasbor Anda dengan dasbor metodis. Anda mungkin telah menyusun strategi, tetapi ada beberapa hal yang dapat Anda tingkatkan.

 Bagaimana Anda bisa tahu Anda ada di sini? 
+ Mencegah penyebaran dengan menggunakan variabel template. Misalnya, Anda tidak memerlukan dasbor terpisah untuk setiap node, Anda dapat menggunakan variabel kueri. Lebih baik lagi, Anda dapat menjadikan sumber data sebagai variabel template juga, sehingga Anda dapat menggunakan kembali dasbor yang sama di berbagai cluster dan memantau backend.

  Lihat daftar contoh di[Variabel](v10-dash-variables.md), untuk ide.
+ [Dasbor metodis menurut strategi observabilitas.](#v10-dash-common-observability-strategies)
+ Dasbor hierarkis dengan penelusuran ke tingkat berikutnya.
+ Desain dasbor mencerminkan hierarki layanan. Misalnya, Anda dapat menggunakan metode RED dengan satu baris per layanan. Urutan baris dapat mencerminkan aliran data, saat Anda menggulir ke bawah dasbor.
+ Bandingkan like to like: split service dashboard bila besarnya berbeda. Pastikan metrik agregat tidak menghilangkan informasi penting.
+ Bagan ekspresif dengan penggunaan warna yang berarti dan sumbu normalisasi di mana Anda bisa.
  + Contoh warna yang bermakna: Biru berarti bagus, merah berarti buruk. [Ambang batas](v10-panels-configure-thresholds.md) dapat membantu dengan itu.
  + Contoh sumbu normalisasi: Saat membandingkan penggunaan CPU, ukur berdasarkan persentase daripada angka mentah, karena mesin dapat memiliki jumlah inti yang berbeda. Normalisasi penggunaan CPU dengan jumlah core mengurangi beban kognitif karena pemirsa dapat mempercayai bahwa pada 100% semua core sedang digunakan, tanpa harus mengetahui jumlahnya. CPUs
+ Penjelajahan terarah mengurangi tebakan.
  + Variabel template membuat lebih sulit untuk menjelajah secara acak atau tanpa tujuan.
  + Sebagian besar dasbor harus ditautkan dengan peringatan.
  + Penjelajahan diarahkan dengan tautan. Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).
+  Dasbor yang dikontrol versi JSON. 

**Penggunaan yang dioptimalkan tinggi**

Pada tahap ini, Anda telah mengoptimalkan penggunaan manajemen dasbor Anda dengan strategi yang konsisten dan bijaksana. Itu membutuhkan perawatan, tetapi hasilnya sepadan.
+ Secara aktif mengurangi penyebaran.
  + Tinjau dasbor yang ada secara teratur untuk memastikannya masih relevan.
  + Hanya dasbor yang disetujui yang ditambahkan ke daftar dasbor utama.
  + Melacak penggunaan dasbor. Anda dapat memanfaatkan [wawasan Penggunaan](v10-dash-assess-dashboard-usage.md).
+ Konsistensi dengan desain.
+ Gunakan pustaka skrip untuk menghasilkan dasbor, memastikan konsistensi dalam pola dan gaya.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ Tidak ada pengeditan di browser. Pemirsa dasbor mengubah tampilan dengan variabel.
+ Menjelajahi dasbor adalah pengecualian, bukan aturannya.
+ Lakukan eksperimen dan pengujian dalam instance Grafana terpisah yang didedikasikan untuk tujuan itu, bukan instance produksi Anda. Jika dasbor di lingkungan pengujian terbukti berguna, tambahkan dasbor itu ke instance Grafana utama Anda.

## Praktik terbaik untuk membuat dasbor
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

Bagian ini menguraikan beberapa praktik terbaik untuk diikuti saat membuat dasbor Grafana.

**Sebelum Anda memulai**

 Berikut adalah beberapa prinsip yang perlu dipertimbangkan sebelum Anda membuat dasbor. 

**Dasbor harus menceritakan kisah atau menjawab pertanyaan**

Kisah apa yang ingin Anda ceritakan dengan dasbor Anda? Cobalah untuk membuat perkembangan data yang logis, seperti besar ke kecil atau umum ke spesifik. Apa tujuan dari dasbor ini? (Petunjuk: Jika dasbor tidak memiliki tujuan, tanyakan pada diri Anda apakah Anda benar-benar membutuhkan dasbor.)

Buat grafik Anda sederhana dan fokus untuk menjawab pertanyaan yang Anda ajukan. Misalnya, jika pertanyaan Anda adalah “server mana yang bermasalah?” , maka mungkin Anda tidak perlu menampilkan semua data server. Cukup tampilkan data untuk mereka yang bermasalah.

**Dasbor harus mengurangi beban kognitif, bukan menambahkannya**

*Beban kognitif* pada dasarnya adalah seberapa sulit Anda perlu memikirkan sesuatu untuk mengetahuinya. Buat dasbor Anda mudah ditafsirkan. Pengguna lain dan future Anda (ketika Anda mencoba mencari tahu apa yang rusak pada 2AM) akan menghargainya.

 Tanyakan pada diri sendiri: 
+ Dapatkah saya memberi tahu persis apa yang diwakili oleh setiap grafik? Apakah sudah jelas, atau apakah saya harus memikirkannya?
+ Jika saya menunjukkan ini kepada orang lain, berapa lama waktu yang dibutuhkan mereka untuk mengetahuinya? Apakah mereka akan tersesat?

**Memiliki Strategi Monitoring**

Sangat mudah untuk membuat dasbor baru. Lebih sulit untuk mengoptimalkan pembuatan dasbor dan mematuhi rencana, tetapi itu sepadan. Strategi ini harus mengatur skema dasbor Anda secara keseluruhan dan menegakkan konsistensi dalam desain dasbor individual.

Lihat [strategi observabilitas umum](#v10-dash-common-observability-strategies) dan [tingkat kematangan manajemen Dasbor](#v10-dash-management-maturity-model) untuk informasi lebih lanjut.

**Tuliskan**

Setelah Anda memiliki strategi atau pedoman desain, tuliskan untuk membantu menjaga konsistensi dari waktu ke waktu.

**Praktik terbaik untuk diikuti**
+ Saat membuat dasbor baru, pastikan itu memiliki nama yang berarti.
  + Jika Anda membuat dasbor untuk bermain atau bereksperimen, maka masukkan `TMP` kata `TEST` atau namanya.
  + Pertimbangkan untuk memasukkan nama atau inisiasi Anda di nama dasbor atau sebagai tag sehingga orang tahu siapa yang memiliki dasbor.
  + Hapus dasbor eksperimen sementara setelah Anda selesai menggunakannya.
+ Jika Anda membuat banyak dasbor terkait, pikirkan cara mereferensikan silang untuk navigasi yang mudah. Untuk informasi selengkapnya, lihat [Praktik terbaik untuk mengelola dasbor](#v10-dash-best-practices-for-managing-dashboards), nanti di bagian ini.
+ Grafana mengambil data dari sumber data. Pemahaman dasar [Connect ke sumber data](AMG-data-sources.md) secara umum, dan sumber data spesifik Anda adalah penting.
+ Hindari penyegaran dasbor yang tidak perlu untuk mengurangi beban pada jaringan atau backend. Misalnya, jika data Anda berubah setiap jam, maka Anda tidak perlu mengatur kecepatan refresh dasbor menjadi 30 detik.
+ Gunakan sumbu Y kiri dan kanan saat menampilkan deret waktu dengan satuan atau rentang yang berbeda.
+ Tambahkan dokumentasi ke dasbor dan panel.
  + Untuk menambahkan dokumentasi ke dasbor, tambahkan [visualisasi panel Teks](v10-panels-text.md) ke dasbor. Rekam hal-hal seperti tujuan dasbor, tautan sumber daya yang berguna, dan instruksi apa pun yang mungkin diperlukan pengguna untuk berinteraksi dengan dasbor.
  + Untuk menambahkan dokumentasi ke panel, edit pengaturan panel dan tambahkan deskripsi. Teks apa pun yang Anda tambahkan akan muncul jika Anda mengarahkan kursor ke atas yang kecil `i` di sudut kiri atas panel.
+ Gunakan kembali dasbor Anda dan terapkan konsistensi dengan menggunakan [templat](v10-dash-variables.md) dan variabel.
+ Hati-hati dengan menumpuk data grafik. Visualisasi dapat menyesatkan, dan menyembunyikan data penting. Kami merekomendasikan untuk mematikannya dalam banyak kasus.

## Praktik terbaik untuk mengelola dasbor
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Halaman ini menguraikan beberapa praktik terbaik untuk diikuti saat mengelola dasbor Grafana. 

**Sebelum Anda memulai**

Berikut adalah beberapa prinsip yang perlu dipertimbangkan sebelum Anda mulai mengelola dasbor.

**Observabilitas strategis**

Ada beberapa [strategi observabilitas umum](#v10-dash-common-observability-strategies). Anda harus meneliti mereka dan memutuskan apakah salah satu dari mereka bekerja untuk Anda atau jika Anda ingin membuat sendiri. Either way, punya rencana, menuliskannya, dan menaatinya.

Sesuaikan strategi Anda untuk mengubah kebutuhan seperlunya.

**Tingkat kedewasaan**

Apa tingkat kematangan dasbor Anda? Analisis pengaturan dasbor Anda saat ini dan bandingkan dengan [model kematangan manajemen Dasbor](#v10-dash-management-maturity-model). Memahami di mana Anda berada dapat membantu Anda memutuskan bagaimana menuju ke tempat yang Anda inginkan.

**Praktik terbaik untuk diikuti**
+ Hindari penyebaran dasbor, yang berarti pertumbuhan dasbor yang tidak terkendali. Dashboard sprawl berdampak negatif pada waktu untuk menemukan dasbor yang tepat. Menduplikasi dasbor dan mengubah “satu hal” (lebih buruk lagi: menyimpan tag asli) adalah jenis penyebaran yang paling mudah.
  + Tinjau dasbor secara berkala dan hapus yang tidak perlu.
  + Jika Anda membuat dasbor sementara, mungkin untuk menguji sesuatu, awali nama dengan`TEST:`. Hapus dasbor saat Anda selesai.
+ Menyalin dasbor tanpa perubahan signifikan bukanlah ide yang baik.
  + Anda kehilangan pembaruan ke dasbor asli, seperti perubahan dokumentasi, perbaikan bug, atau penambahan metrik.
  + Dalam banyak kasus salinan sedang dibuat untuk hanya menyesuaikan tampilan dengan mengatur parameter template. Ini seharusnya dilakukan dengan mempertahankan tautan ke dasbor utama dan menyesuaikan tampilan dengan [parameter URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Ketika Anda harus menyalin dasbor, ganti nama dengan jelas dan *jangan* menyalin tag dasbor. Tag adalah metadata penting untuk dasbor yang digunakan selama pencarian. Menyalin tag dapat menghasilkan kecocokan palsu.
+ Pertahankan dasbor dasbor atau dasbor referensi silang. Ini dapat dilakukan dengan beberapa cara: 
  + Buat tautan dasbor, panel, atau tautan data. Tautan dapat pergi ke dasbor lain atau ke sistem eksternal. Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v10-dash-manage-dashboard-links.md).
  +  Tambahkan [panel daftar Dashboard](v10-panels-dashboard-list.md). Anda kemudian dapat menyesuaikan apa yang Anda lihat dengan melakukan pencarian tag atau folder.
  + Tambahkan [panel Teks](v10-panels-dashboard-list.md) dan gunakan penurunan harga untuk menyesuaikan tampilan. 

# Mengelola dasbor
<a name="v10-dash-managing-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pada halaman **Dasbor** ruang kerja Anda (tersedia dengan memilih **Dasbor** dari menu kiri), Anda dapat melakukan tugas manajemen dasbor, termasuk mengatur dasbor Anda ke dalam folder.

Untuk informasi selengkapnya tentang membuat dasbor, lihat[Membangun dasbor](v10-dash-building-dashboards.md).

## Jelajahi dasbor
<a name="v10-dash-browse-dashboards"></a>

Di halaman **Dasbor**, Anda dapat menelusuri dan mengelola folder dan dasbor. Ini termasuk opsi untuk:
+ Buat folder dan dasbor.
+ Pindahkan dasbor antar folder.
+ Hapus beberapa dasbor dan folder.
+ Arahkan ke folder.
+ Kelola izin folder. Untuk informasi selengkapnya, lihat [Izin dasbor dan folder](dashboard-and-folder-permissions.md).

## Membuat folder dasbor
<a name="v10-dash-create-dashboard-folder"></a>

Folder membantu Anda mengatur dan mengelompokkan dasbor, yang berguna ketika Anda memiliki banyak dasbor atau beberapa tim menggunakan instance Grafana yang sama. Subfolder memungkinkan Anda membuat hierarki bersarang di organisasi dasbor Anda.

**Prasyarat**

Pastikan Anda memiliki izin Admin Grafana. Untuk informasi selengkapnya tentang izin dasbor, lihat[Izin dasbor dan folder](dashboard-and-folder-permissions.md).

**Untuk membuat folder dasbor**

1. Masuk ke Grafana. 

1. Di menu sebelah kiri, pilih **Dasbor**.

1. Pada halaman **Dasbor**, pilih **Baru** lalu pilih **Folder baru** di drop-down.

1. Masukkan nama unik dan klik **Buat**.

**catatan**  
Saat Anda menyimpan dasbor, Anda dapat memilih folder untuk dasbor yang akan disimpan atau membuat folder baru.

**Untuk mengedit nama folder**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih folder yang akan diganti namanya

1. Pilih ikon **Edit judul** (pensil) di header dan perbarui nama folder.

   Nama folder baru disimpan secara otomatis.

**Izin folder**

Anda dapat menetapkan izin ke folder. Dasbor di folder mewarisi izin apa pun yang telah Anda tetapkan ke folder. Anda dapat menetapkan izin untuk peran organisasi, tim, dan pengguna.

**Untuk mengubah izin untuk folder**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih folder dalam daftar.

1. Pada halaman detail folder, pilih **Tindakan folder** dan pilih **Kelola izin** di daftar drop-down.

1. Perbarui izin sesuai keinginan.

Perubahan disimpan secara otomatis.

# Mengelola daftar putar
<a name="v10-dash-managing-playlists"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Daftar putar* adalah daftar dasbor yang ditampilkan secara berurutan. Anda dapat menggunakan daftar putar untuk membangun kesadaran situasional atau untuk menyajikan metrik Anda kepada tim atau pengunjung Anda. Grafana secara otomatis menskalakan dasbor ke resolusi apa pun, yang membuatnya sempurna untuk layar besar. Anda dapat mengakses fitur daftar putar dari menu samping Grafana di submenu **Dasbor**.

## Mengakses, berbagi, dan mengendalikan daftar putar
<a name="v10-dash-access-share-control-playlist"></a>

Gunakan informasi di bagian ini untuk mengakses daftar putar yang ada. Mulai dan kendalikan tampilan daftar putar menggunakan salah satu dari lima mode yang tersedia.

**Untuk mengakses daftar putar**

1. Pilih **Daftar Putar** dari menu sebelah kiri.

1. Pilih daftar putar dari daftar putar yang ada.

**Memulai daftar putar**

Anda dapat memulai daftar putar dalam lima mode tampilan berbeda. Mode tampilan menentukan bagaimana menu dan bilah navigasi muncul di dasbor.

Secara default, setiap dasbor ditampilkan untuk jumlah waktu yang dimasukkan di bidang **Interval**, yang Anda atur saat membuat atau mengedit daftar putar. Setelah Anda memulai daftar putar, Anda dapat mengontrolnya dengan bilah navigasi di bagian atas halaman.

**Untuk memulai daftar putar**

1. Akses halaman daftar putar untuk melihat daftar putar yang ada.

1. Temukan daftar putar yang ingin Anda mulai, lalu klik **Mulai daftar putar**.

   Kotak dialog daftar putar mulai akan terbuka.

1. Pilih salah satu dari lima mode daftar putar yang tersedia berdasarkan informasi dalam tabel berikut.

1. Klik **Mulai**<playlist name>.

Daftar putar menampilkan setiap dasbor untuk waktu yang ditentukan di `Interval` bidang, diatur saat membuat atau mengedit daftar putar. Setelah daftar putar dimulai, Anda dapat mengontrolnya menggunakan bilah navigasi di bagian atas layar Anda.


| Modus | Deskripsi | 
| --- | --- | 
| Modus normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modus TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode TV (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kios |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kios (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**Mengontrol daftar putar**

Anda dapat mengontrol daftar putar dalam mode **Normal** atau **TV** setelah dimulai, menggunakan bilah navigasi di bagian atas layar Anda. Tekan `Esc` tombol di keyboard Anda untuk menghentikan daftar putar.


| Tombol | Tindakan | 
| --- | --- | 
| Berikutnya (panah kanan ganda) | Maju ke dasbor berikutnya. | 
| Kembali (panah kiri) | Kembali ke dasbor sebelumnya. | 
| Berhenti (persegi) | Mengakhiri daftar putar, dan keluar ke dasbor saat ini. | 
| Mode tampilan siklus (ikon monitor) | Memutar tampilan dasbor dalam mode tampilan yang berbeda. | 
| Rentang waktu | Menampilkan data dalam rentang waktu. Ini dapat diatur untuk menampilkan 5 menit terakhir hingga 5 tahun yang lalu, atau rentang waktu khusus, menggunakan panah bawah. | 
| Segarkan (panah lingkaran) | Muat ulang dasbor, untuk menampilkan data saat ini. Ini dapat diatur untuk memuat ulang secara otomatis setiap 5 detik hingga 1 hari, menggunakan panah tarik-turun. | 

## Membuat daftar putar
<a name="v10-dash-create-playlist"></a>

Anda dapat membuat daftar putar untuk menyajikan dasbor secara berurutan dengan urutan yang ditetapkan dan interval waktu antar dasbor.

**Untuk membuat daftar putar**

1. Pilih **Dasbor** dari menu kiri.

1. Pilih **Daftar Putar** di halaman daftar putar.

1. Pilih **Daftar putar baru**.

1. Masukkan nama deskriptif di kotak teks **Nama**.

1. Masukkan interval waktu di kotak teks **Interval**. Dasbor yang Anda tambahkan tercantum dalam urutan berurutan.

1. Di **Dasbor**, tambahkan dasbor yang ada ke daftar putar menggunakan opsi tarik-turun **Tambahkan berdasarkan judul** dan **Tambahkan berdasarkan tag**.

1. Opsional:
   + Cari dasbor dengan namanya, ekspresi reguler, atau tag.
   + Filter hasil Anda berdasarkan status atau tag berbintang.
   + Atur ulang urutan dasbor yang telah Anda tambahkan menggunakan ikon panah atas dan bawah.
   + Hapus dasbor dari daftar putar dengan mengklik ikon **x** di samping dasbor.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Menyimpan daftar putar
<a name="v10-dash-save-playlist"></a>

Anda dapat menyimpan daftar putar dan menambahkannya ke halaman **Daftar Putar** Anda, tempat Anda dapat memulainya.

**penting**  
Pastikan semua dasbor yang ingin Anda tampilkan di daftar putar ditambahkan saat membuat atau mengedit daftar putar sebelum menyimpannya.

**Untuk menyimpan daftar putar**

1. Pilih **Dasbor** di menu sebelah kiri.

1. Pilih **Daftar Putar** untuk melihat daftar putar yang tersedia untuk Anda.

1. Pilih daftar putar pilihan Anda.

1. Edit daftar putar.

1. Periksa apakah daftar putar memiliki **Nama**, **Interval**, dan setidaknya satu **Dasbor** yang ditambahkan ke dalamnya.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Mengedit atau menghapus daftar putar
<a name="v10-dash-edit-delete-playlist"></a>

Anda dapat mengedit daftar putar dengan memperbarui namanya, interval waktu, dan dengan menambahkan, menghapus, dan mengatur ulang urutan dasbor, atau Anda dapat menghapus daftar putar.

**Untuk mengedit daftar putar**

1. Pilih **Edit daftar putar** di halaman daftar putar.

1. Perbarui nama dan interval waktu, lalu tambahkan atau hapus dasbor dari daftar putar menggunakan instruksi di Buat daftar putar, di atas.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menghapus daftar putar**

1. Pilih **Daftar Putar**.

1. Pilih **Hapus** di samping daftar putar yang ingin Anda hapus.

**Untuk mengatur ulang urutan dasbor dalam daftar putar**

1. Di sebelah dasbor yang ingin Anda pindahkan, klik panah atas atau bawah.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menghapus dasbor**

1. Pilih **Hapus** untuk menghapus dasbor dari daftar putar.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

## Berbagi daftar putar dalam mode tampilan
<a name="v10-dash-share-playlist-view-mode"></a>

Anda dapat membagikan daftar putar dengan menyalin alamat tautan pada mode tampilan yang Anda inginkan, dan menempelkan URL ke tujuan Anda.

**Untuk berbagi daftar putar dalam mode tampilan**

1. Dari menu sisi kiri **Dasbor**, pilih Daftar **Putar**.

1. Pilih **Mulai daftar putar di samping daftar** putar yang ingin Anda bagikan.

1. Di dropdown, klik kanan mode tampilan yang Anda inginkan.

1. Pilih **Salin Alamat Tautan** untuk menyalin URL ke clipboard Anda.

1. Tempel URL ke tujuan Anda.

# Berbagi dasbor dan panel
<a name="v10-dash-sharing"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana memungkinkan Anda untuk berbagi dasbor dan panel dengan pengguna lain dalam suatu organisasi dan dalam situasi tertentu, secara publik di Web. Anda dapat berbagi menggunakan:
+ Tautan langsung
+ Sebuah snapshot
+ Tautan ekspor (hanya untuk dasbor)

Anda harus memiliki izin penampil resmi untuk melihat gambar yang diberikan oleh tautan langsung.

Saat Anda membagikan panel atau dasbor sebagai snapshot, snapshot (yang merupakan panel atau dasbor saat Anda mengambil snapshot) tersedia untuk umum di web. Siapa pun yang memiliki tautan ke sana dapat mengaksesnya. Karena snapshot tidak memerlukan otorisasi apa pun untuk melihat, Grafana menghapus informasi yang terkait dengan akun asalnya, serta data sensitif apa pun dari snapshot.

## Berbagi dasbor
<a name="v10-dash-share-dashboard"></a>

Anda dapat membagikan dasbor sebagai tautan langsung atau sebagai snapshot. Anda juga dapat mengekspor dasbor.

**catatan**  
Jika Anda mengubah dasbor, pastikan Anda menyimpan perubahan sebelum berbagi.

**Untuk Berbagi dasbor**

1. Pilih **Dasbor** dari menu kiri di ruang kerja Anda.

1. Pilih dasbor yang ingin Anda bagikan.

1. Pilih ikon bagikan di bagian atas layar.

   Kotak dialog berbagi terbuka dan menampilkan tab **Tautan**.

**Berbagi tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda juga dapat membagikan URL yang dipersingkat.

**Untuk berbagi tautan langsung**

1. Pilih **Salin**. Tindakan ini menyalin URL default atau singkat ke clipboard.

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

**Menerbitkan snapshot**

Snapshot dasbor membagikan dasbor interaktif secara publik. Grafana menghapus data sensitif seperti kueri (metrik, templat, dan anotasi) dan tautan panel, hanya menyisakan data metrik yang terlihat dan nama seri yang disematkan di dasbor. Snapshot dasbor dapat diakses oleh siapa saja yang memiliki tautan.

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

**Untuk mempublikasikan snapshot**

1. Pilih tab **Snapshot**.

1. Pilih **Snapshot Lokal**.

1. Grafana menghasilkan tautan snapshot. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

**Mengekspor dasbor**

Dasbor Grafana dapat dengan mudah diekspor dan diimpor. Untuk informasi selengkapnya, lihat bagian impor dan ekspor di[Membangun dasbor](v10-dash-building-dashboards.md).

## Berbagi panel
<a name="v10-dash-share-panel"></a>

Anda dapat berbagi panel sebagai tautan langsung, atau sebagai snapshot. Anda juga dapat membuat panel perpustakaan menggunakan opsi **Bagikan** pada panel apa pun.

**Untuk berbagi panel**

1. Pilih judul panel panel yang ingin Anda bagikan. Menu panel terbuka.

1. Pilih **Bagikan**. Kotak dialog berbagi akan terbuka dan menampilkan tab **Tautan**.

**Menggunakan tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda dapat mengaktifkan URL singkat untuk dibagikan secara opsional.

**Untuk menggunakan tautan langsung**

1. Pilih **Salin** untuk menyalin default atau URL singkat ke clipboard. 

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

**Menerbitkan snapshot panel**

Snapshot panel adalah bagian dari panel interaktif secara publik. Grafana menghapus data sensitif hanya menyisakan data metrik yang terlihat dan nama seri yang tertanam di dasbor. Snapshot panel dapat diakses oleh siapa saja yang memiliki tautan.

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

**Untuk mempublikasikan snapshot panel**

1. Di kotak dialog **Share Panel**, pilih tab **Snapshot**.

1. Pilih **Snapshot Lokal**. Grafana menghasilkan tautan snapshot.

1. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

Jika Anda membuat snapshot secara tidak sengaja, klik **Hapus snapshot untuk menghapus snapshot** dari instance Grafana Anda.

**Membuat panel perpustakaan**

Untuk membuat panel pustaka dari kotak dialog **Share Panel**.

**Untuk membuat panel perpustakaan**

1. Pilih **panel Perpustakaan**.

1. Di **nama panel Perpustakaan**, masukkan nama.

1. Di **Simpan dalam folder**, pilih folder untuk menyimpan panel perpustakaan. Secara default, folder root dipilih.

1. Pilih **Buat panel perpustakaan** untuk menyimpan perubahan Anda.

1. Simpan dasbor.

# Variabel
<a name="v10-dash-variables"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Variabel adalah placeholder untuk suatu nilai. Anda dapat menggunakan variabel dalam kueri metrik dan judul panel. Jadi saat Anda mengubah nilainya, menggunakan dropdown di bagian atas dasbor, kueri metrik panel Anda akan berubah untuk mencerminkan nilai baru.

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Ini bisa sangat berguna bagi administrator yang ingin mengizinkan pemirsa Grafana menyesuaikan visualisasi dengan cepat tetapi tidak ingin memberi mereka izin pengeditan penuh. Grafana Viewers dapat menggunakan variabel.

Variabel dan template juga memungkinkan Anda untuk dasbor sumber tunggal. Jika Anda memiliki beberapa sumber data atau server yang identik, Anda dapat membuat satu dasbor dan menggunakan variabel untuk mengubah apa yang Anda lihat. Ini sangat menyederhanakan pemeliharaan dan pemeliharaan.

**Template**

Template adalah kueri yang berisi variabel. Misalnya, jika Anda mengelola dasbor untuk memantau beberapa server, Anda dapat membuat dasbor untuk setiap server, atau Anda dapat membuat satu dasbor dan menggunakan panel dengan kueri templat, seperti berikut ini.

```
wmi_system_threads{instance=~"$server"}
```

<varname>Nilai variabel selalu disinkronkan ke URL menggunakan sintaks var- =value.

**Contoh**

Variabel tercantum dalam daftar dropdown di bagian atas layar. Pilih variabel yang berbeda untuk melihat bagaimana visualisasi berubah.

Untuk melihat pengaturan variabel, navigasikan ke **Pengaturan Dasbor > Variabel**. Klik variabel dalam daftar untuk melihat pengaturannya.

Variabel dapat digunakan dalam judul, deskripsi, panel teks, dan kueri. Kueri dengan teks yang dimulai dengan `$` adalah template. Tidak semua panel akan memiliki kueri template.

**Praktik terbaik variabel**
+ Daftar dropdown variabel ditampilkan dalam urutan mereka tercantum dalam daftar variabel di pengaturan **Dashboard**.
+ Letakkan variabel yang akan sering Anda ubah di bagian atas, sehingga akan ditampilkan terlebih dahulu (paling kiri di dasbor).
+ Variabel memilih nilai paling atas dalam daftar dropdown secara default. Jika Anda ingin memilih nilai kosong sebagai gantinya, ubah pengaturan variabel, sebagai berikut:

  1. Pilih kotak centang **Sertakan Semua Opsi**.

  1. Di bidang **Kustom semua nilai**, masukkan nilai`+`.

**Topics**
+ [Menambahkan dan mengelola variabel](v10-dash-variable-add.md)
+ [Periksa Variabel](v10-dash-variable-add-inspect.md)
+ [Sintaks variabel](v10-dash-variable-syntax.md)

# Menambahkan dan mengelola variabel
<a name="v10-dash-variable-add"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tabel berikut mencantumkan jenis variabel di Grafana.


| Jenis variabel | Deskripsi | 
| --- | --- | 
| Kueri | Daftar nilai yang dihasilkan kueri seperti nama metrik, nama server, sensor IDs, pusat data, dan sebagainya. | 
| Khusus | Tentukan opsi variabel secara manual menggunakan daftar yang dipisahkan koma. | 
| Kotak teks | Menampilkan kolom input teks gratis dengan nilai default opsional. | 
| Konstan | Tentukan konstanta tersembunyi. | 
| Sumber data | Ubah sumber data dengan cepat untuk seluruh dasbor. | 
| Interval | Variabel interval mewakili rentang waktu. | 
| Filter ad hoc | Filter nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik untuk sumber data (Prometheus, Loki, InfluxDB, dan Elasticsearch saja). | 
| Variabel global | Variabel bawaan yang dapat digunakan dalam ekspresi di editor kueri. | 
| Variabel yang dirantai | Kueri variabel dapat berisi variabel lain. | 

**Topics**
+ [Memasuki opsi Umum](#v10-dash-variable-options)
+ [Menambahkan variabel kueri](#v10-dash-variable-add-query)
+ [Menambahkan variabel kustom](#v10-dash-variable-add-custom)
+ [Menambahkan variabel kotak teks](#v10-dash-variable-add-text)
+ [Menambahkan variabel konstan](#v10-dash-variable-add-constant)
+ [Menambahkan variabel sumber data](#v10-dash-variable-add-datasource)
+ [Menambahkan variabel interval](#v10-dash-variable-add-internal)
+ [Menambahkan filter ad hoc](#v10-dash-variable-add-adhoc)
+ [Konfigurasikan opsi pemilihan variabel](#v10-dash-variable-add-selection)
+ [Variabel global](#v10-dash-variable-add-global)
+ [Variabel yang dirantai](#v10-dash-variable-add-chained)
+ [Kelola variabel](#v10-dash-variable-add-manage)
+ [Filter variabel dengan regex](#v10-dash-variable-add-filter)

## Memasuki opsi Umum
<a name="v10-dash-variable-options"></a>

Anda harus memasukkan opsi umum untuk semua jenis variabel yang Anda buat.

**Untuk memasukkan opsi umum**

1. Arahkan ke dasbor yang ingin Anda buat variabel dan pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman.

1. Pada tab **Variables**, pilih **Variabel baru**.

1. Masukkan **Nama** untuk variabel.

1. Dalam daftar **Type**, pilih **Query**.

1. (Opsional) Di **Label**, masukkan nama tampilan dropdown variabel.

   Jika Anda tidak memasukkan nama tampilan, maka label dropdown adalah nama variabel.

1. Pilih opsi **Sembunyikan**:
   + **Tidak ada pilihan (kosong)** - Variabel dropdown menampilkan variabel **Nama** atau nilai **Label**.
   + **Label** - Variabel dropdown hanya menampilkan nilai variabel yang dipilih dan panah bawah.
   + **Variabel** - Tidak ada dropdown variabel yang ditampilkan di dasbor.

## Menambahkan variabel kueri
<a name="v10-dash-variable-add-query"></a>

Variabel kueri memungkinkan Anda menulis kueri sumber data yang dapat mengembalikan daftar nama metrik, nilai tag, atau kunci. Misalnya, variabel kueri mungkin mengembalikan daftar nama server, sensor IDs, atau pusat data. Nilai variabel berubah saat mereka secara dinamis mengambil opsi dengan kueri sumber data.

Variabel kueri umumnya hanya didukung untuk string. Jika kueri Anda mengembalikan angka atau tipe data lainnya, Anda mungkin perlu mengonversinya menjadi string untuk menggunakannya sebagai variabel. Untuk sumber data Azure, misalnya, Anda dapat menggunakan fungsi [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) untuk tujuan ini.

Ekspresi kueri dapat berisi referensi ke variabel lain dan pada dasarnya membuat variabel terkait. Grafana mendeteksi ini dan secara otomatis menyegarkan variabel ketika salah satu variabel tertaut berubah.

**catatan**  
Ekspresi kueri berbeda untuk setiap sumber data. Untuk informasi selengkapnya, lihat dokumentasi untuk [sumber data](AMG-data-sources.md) Anda.

**Untuk menambahkan variabel kueri**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target untuk kueri.

1. Dalam daftar **Refresh**, pilih kapan variabel harus memperbarui opsi.
   + **On Dashboard Load** — Query sumber data setiap kali dashboard dimuat. Ini memperlambat pemuatan dasbor, karena kueri variabel perlu diselesaikan sebelum dasbor dapat diinisialisasi.
   + **Perubahan Rentang Waktu** — Menanyakan sumber data saat rentang waktu dasbor berubah. Hanya gunakan opsi ini jika kueri opsi variabel Anda berisi filter rentang waktu atau bergantung pada rentang waktu dasbor.

1. Di bidang **Query**, masukkan kueri.
   + Bidang kueri bervariasi sesuai dengan sumber data Anda. Beberapa sumber data memiliki editor kueri khusus.
   + Query harus mengembalikan nilai bernama `__text` dan`__value`. Misalnya, di SQL, Anda dapat menggunakan kueri seperti`SELECT hostname AS __text, id AS __value from MyTable`. Kueri untuk bahasa lain akan bervariasi tergantung pada sintaks.
   + Jika Anda membutuhkan lebih banyak ruang dalam editor kueri bidang input tunggal, arahkan kursor Anda ke garis di sudut kanan bawah bidang dan seret ke bawah untuk memperluas.

1. (Opsional) Di bidang **Regex**, ketik ekspresi regex untuk memfilter atau menangkap bagian tertentu dari nama yang dikembalikan oleh kueri sumber data Anda. Untuk melihat contoh, lihat [Filter variabel dengan regex](#v10-dash-variable-add-filter).

1. Dalam daftar **Urutkan**, pilih urutan pengurutan untuk nilai yang akan ditampilkan dalam daftar dropdown. Opsi default, **Dinonaktifkan**, berarti urutan opsi yang dikembalikan oleh kueri sumber data Anda akan digunakan.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel kustom
<a name="v10-dash-variable-add-custom"></a>

Gunakan variabel *kustom* untuk nilai yang tidak berubah, seperti angka atau string.

Misalnya, jika Anda memiliki nama server atau nama Wilayah yang tidak pernah berubah, Anda mungkin ingin membuatnya sebagai variabel kustom daripada variabel kueri. Karena mereka tidak berubah, Anda dapat menggunakannya dalam [variabel berantai daripada variabel](#v10-dash-variable-add-chained) kueri lainnya. Itu akan mengurangi jumlah kueri yang harus dikirim Grafana ketika variabel berantai diperbarui.

**Untuk menambahkan variabel kustom**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Nilai dipisahkan oleh koma**, masukkan nilai untuk variabel ini dalam daftar yang dipisahkan koma. Anda dapat menyertakan angka, string, atau pasangan kunci-nilai yang dipisahkan oleh spasi dan titik dua. Misalnya, `key1 : value1,key2 : value2`.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel kotak teks
<a name="v10-dash-variable-add-text"></a>

Variabel *kotak teks* menampilkan bidang input teks gratis dengan nilai default opsional. Ini adalah variabel yang paling fleksibel, karena Anda dapat memasukkan nilai apa pun. Gunakan jenis variabel ini jika Anda memiliki metrik dengan kardinalitas tinggi atau jika Anda ingin memperbarui beberapa panel di dasbor secara bersamaan.

**Untuk menambahkan variabel kotak teks**

1. Masukkan opsi umum, seperti di atas.

1. (Opsional) Di bidang **Nilai default**, pilih nilai default untuk variabel. Jika Anda tidak memasukkan apa pun di bidang ini, Grafana menampilkan kotak teks kosong bagi pengguna untuk mengetik teks.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel konstan
<a name="v10-dash-variable-add-constant"></a>

Variabel *konstan* memungkinkan Anda untuk menentukan konstanta tersembunyi. Ini berguna untuk awalan jalur metrik untuk dasbor yang ingin Anda bagikan. Saat Anda mengekspor dasbor, variabel konstan dikonversi ke opsi impor.

Variabel konstan *tidak* fleksibel. Setiap variabel konstan hanya memiliki satu nilai, dan tidak dapat diperbarui kecuali Anda memperbarui pengaturan variabel.

Variabel konstan berguna ketika Anda memiliki nilai kompleks yang perlu Anda sertakan dalam kueri tetapi tidak ingin mengetik ulang di setiap kueri. Misalnya, jika Anda memiliki jalur server yang disebut`i-0b6a61efe2ab843gg`, maka Anda bisa menggantinya dengan variabel yang disebut`$path_gg`.

**Untuk menambahkan variabel konstan**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan nilai variabel. Anda dapat memasukkan huruf, angka, dan simbol. Anda bahkan dapat menggunakan wildcard jika Anda menggunakan [format mentah](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel sumber data
<a name="v10-dash-variable-add-datasource"></a>

Variabel *sumber data* memungkinkan Anda mengubah sumber data dengan cepat untuk seluruh dasbor. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda.

**Untuk menambahkan variabel sumber data**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Jenis**, pilih sumber data target untuk variabel.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin). Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

1. (Opsional) Dalam **filter nama Instance**, masukkan filter regex untuk contoh sumber datanya untuk dipilih dalam daftar dropdown nilai variabel. Biarkan bidang ini kosong untuk menampilkan semua instance.

1. (Opsional) Masukkan [Pilihan Pilihan](#v10-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel interval
<a name="v10-dash-variable-add-internal"></a>

Gunakan variabel *interval* untuk mewakili rentang waktu seperti`1m`,`1h`, atau`1d`. Anda dapat menganggapnya sebagai *grup di seluruh dasbor berdasarkan* perintah waktu. Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan Opsi Otomatis untuk mengembalikan sejumlah titik data per rentang waktu.

Anda dapat menggunakan variabel interval sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB), interval histogram tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Grafit).

**Untuk menambahkan variabel interval**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan interval rentang waktu yang ingin Anda tampilkan di daftar dropdown variabel. Unit waktu berikut didukung:`s (seconds)`,,`m (minutes)`,`h (hours)`, `d (days)``w (weeks)`,`M (months)`, dan`y (years)`. Anda juga dapat menerima atau mengedit nilai default:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Opsional) Nyalakan **Opsi Otomatis** jika Anda ingin menambahkan `auto` opsi ke daftar. Opsi ini memungkinkan Anda untuk menentukan berapa kali rentang waktu saat ini harus dibagi untuk menghitung rentang `auto` waktu saat ini. Jika Anda menyalakannya, maka dua opsi lagi muncul:
   + **Jumlah langkah** - Pilih berapa kali rentang waktu saat ini akan dibagi untuk menghitung nilainya, mirip dengan opsi kueri **poin data Maks**. Misalnya, jika rentang waktu yang terlihat saat ini adalah 30 menit, maka `auto` interval mengelompokkan data menjadi 30 peningkatan satu menit. Nilai default adalah 30 langkah.
   + **Interval Min** — Ambang minimum di bawah mana interval hitungan langkah tidak akan membagi waktu. Untuk melanjutkan contoh 30 menit, jika interval minimum diatur ke 2m, maka Grafana akan mengelompokkan data menjadi 15 kenaikan dua menit.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Contoh variabel interval**

Contoh berikut menunjukkan variabel template `myinterval` dalam fungsi Graphite:

```
summarize($myinterval, sum, false)
```

## Menambahkan filter ad hoc
<a name="v10-dash-variable-add-adhoc"></a>

Filter *ad hoc memungkinkan Anda menambahkan filter* nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik yang menggunakan sumber data yang ditentukan. Tidak seperti variabel lain, Anda tidak menggunakan filter ad hoc dalam kueri. Sebagai gantinya, Anda menggunakan filter ad hoc untuk menulis filter untuk kueri yang ada.

**catatan**  
Variabel filter ad hoc hanya berfungsi dengan sumber data Prometheus, Loki, InfluxDB, dan Elasticsearch.

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin). Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Buat filter ad hoc**

Filter ad hoc adalah salah satu opsi variabel paling kompleks dan fleksibel yang tersedia. Alih-alih daftar opsi variabel reguler, variabel ini memungkinkan Anda membuat kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor.

## Konfigurasikan opsi pemilihan variabel
<a name="v10-dash-variable-add-selection"></a>

*Pilihan Pilihan* adalah fitur yang dapat Anda gunakan untuk mengelola pilihan opsi variabel. Semua opsi pilihan adalah opsional, dan mereka mati secara default.

### Variabel multi-nilai
<a name="v10-dash-variable-add-selection-multi"></a>

Interpolasi variabel dengan beberapa nilai yang dipilih rumit karena tidak langsung bagaimana memformat beberapa nilai menjadi string yang valid dalam konteks tertentu di mana variabel digunakan. Grafana mencoba menyelesaikan ini dengan mengizinkan setiap plugin sumber data untuk memberi tahu mesin interpolasi template format apa yang akan digunakan untuk beberapa nilai.

**catatan**  
Opsi **Kustom semua nilai** pada variabel harus kosong agar Grafana memformat semua nilai menjadi satu string. Jika dibiarkan kosong, maka Grafana menggabungkan (menambahkan bersama) semua nilai dalam kueri. Misalnya, `value1,value2,value3`. Jika `all` nilai kustom digunakan, maka sebaliknya nilainya akan menjadi `*` atau`all`.

**Variabel multi-nilai dengan sumber data Grafit**

Grafit menggunakan ekspresi glob. *Variabel dengan beberapa nilai, dalam hal ini, diinterpolasi `{host1,host2,host3}` seolah-olah nilai variabel saat ini iss *host1, host2**, dan host3*.*

**Variabel multi-nilai dengan sumber data Prometheus atau InfluxDB**

InfluxDB dan Prometheus menggunakan ekspresi regex, sehingga variabel yang sama diinterpolasi sebagai. `(host1|host2|host3)` Setiap nilai juga regex lolos. Jika tidak, nilai dengan karakter kontrol regex akan merusak ekspresi regex.

**Variabel multi-nilai dengan sumber data Elastis**

Elasticsearch menggunakan sintaks kueri lucene, sehingga variabel yang sama diformat sebagai. `("host1" OR "host2" OR "host3")` Dalam hal ini, setiap nilai diloloskan sehingga nilainya hanya berisi kata-kata kontrol lucene dan tanda kutip.

**Memecahkan masalah variabel multi-nilai**

Pelarian dan pemformatan otomatis dapat menyebabkan masalah dan sulit untuk memahami logika di baliknya. Khusus untuk InfluxDB dan Prometheus di mana penggunaan sintaks regex mengharuskan variabel digunakan dalam konteks operator regex.

Jika Anda tidak ingin Grafana melakukan pelolosan dan pemformatan regex otomatis ini, maka Anda harus melakukan salah satu hal berikut:
+ Matikan **opsi **Multi-nilai** atau Sertakan Semua**.
+ Gunakan [format mentah](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Sertakan Semua opsi
<a name="v10-dash-variable-add-multi-all"></a>

Grafana menambahkan `All` opsi ke daftar dropdown variabel. Jika pengguna memilih opsi ini, maka semua opsi variabel dipilih.

### Kustom semua nilai
<a name="v10-dash-variable-add-multi-custom"></a>

Opsi ini hanya terlihat jika **opsi Sertakan Semua** dipilih.

Masukkan sintaks regex, gumpalan, atau lucene di bidang **Kustom semua nilai** untuk menentukan nilai opsi. `All`

Secara default `All` nilai mencakup semua opsi dalam ekspresi gabungan. Ini bisa menjadi sangat panjang dan dapat memiliki masalah kinerja. Terkadang lebih baik untuk menentukan nilai semua kustom, seperti regex wildcard.

Untuk memiliki sintaks regex, gumpalan, atau lucene khusus di opsi **Kustom semua nilai**, itu tidak pernah lolos sehingga Anda harus memikirkan nilai yang valid untuk sumber data Anda.

## Variabel global
<a name="v10-dash-variable-add-global"></a>

Grafana memiliki variabel bawaan global yang dapat digunakan dalam ekspresi di editor kueri. Topik ini mencantumkannya dalam urutan abjad dan mendefinisikannya. Variabel ini berguna dalam kueri, tautan dasbor, tautan panel, dan tautan data.

**\$1 \$1\$1dasbor**

Variabel ini adalah nama dasbor saat ini.

**\$1\$1\$1from dan \$1\$1\$1to**

Grafana memiliki dua variabel rentang waktu bawaan: `$__from` dan. `$__to` Mereka saat ini selalu diinterpolasi sebagai milidetik epoch secara default, tetapi Anda dapat mengontrol pemformatan tanggal.


| Sintaksis | Contoh hasil | Deskripsi | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoch unix milidetik  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Tidak ada argumen, default ke ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoch detik Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Format tanggal kustom apa pun yang tidak menyertakan karakter:  | 

Sintaks di atas juga berfungsi dengan`${__to}`.

**\$1 \$1\$1interval**

*Anda dapat menggunakan `$__interval` variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, MySQL, Postgres, MSSQL), interval histogram Tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Graphite).*

Grafana secara otomatis menghitung interval yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ketika ada lebih banyak titik data daripada yang dapat ditampilkan pada grafik, kueri dapat dibuat lebih efisien dengan mengelompokkan dengan interval yang lebih besar. Misalnya, jika Anda melihat grafik data senilai 3 bulan, Anda mungkin tidak dapat melihat detail pada tingkat menit. Pengelompokan berdasarkan jam atau hari membuat kueri lebih efisien tanpa mempengaruhi apa yang ditunjukkan grafik. `$__interval`Itu dihitung menggunakan rentang waktu dan lebar grafik (jumlah piksel).

Perhitungan Perkiraan: `(to - from) / resolution`

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, maka interval dapat dihitung menjadi `2m` - titik dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, maka intervalnya mungkin `1d` (1 hari) - poin dikelompokkan berdasarkan hari.

Dalam sumber data InfluxDB, variabel warisan `$interval` adalah variabel yang sama. `$__interval`harus digunakan sebagai gantinya.

Sumber data InfluxDB dan Elasticsearch memiliki `Group by time interval` bidang yang digunakan untuk membuat kode keras interval atau untuk menetapkan batas minimum untuk `$__interval` variabel (dengan menggunakan `>` sintaks, misalnya). `>10m`

**\$1 \$1\$1interval\$1ms**

Variabel ini adalah `$__interval` variabel dalam milidetik, bukan string yang diformat interval waktu. Misalnya, jika `$__interval` adalah `20m` maka `$__interval_ms` adalah`1200000`.

**\$1\$1\$1org**

Variabel ini adalah ID dari organisasi saat ini. `${__org.name}`adalah nama organisasi saat ini.

**\$1 \$1\$1pengguna**

`${__user.id}`adalah ID pengguna saat ini. `${__user.login}`adalah pegangan login dari pengguna saat ini. `${__user.email}`adalah email untuk pengguna saat ini.

**\$1 \$1\$1kisaran**

Hanya didukung untuk sumber data Prometheus dan Loki. Variabel ini mewakili rentang untuk dasbor saat ini. Itu dihitung oleh`to - from`. Ini memiliki milidetik dan representasi kedua disebut `$__range_ms` dan`$__range_s`.

**\$1 \$1\$1rate\$1interval**

Hanya didukung untuk sumber data Prometheus. `$__rate_interval`Variabel dimaksudkan untuk digunakan dalam fungsi laju.

**\$1 TimeFilter atau \$1 \$1\$1TimeFilter**

`$timeFilter`Variabel mengembalikan rentang waktu yang dipilih saat ini sebagai ekspresi. Misalnya, `Last 7 days` ekspresi interval rentang waktu adalah`time > now() - 7d`.

Ini digunakan di beberapa tempat, termasuk:
+ Klausul WHERE untuk sumber data InfluxDB. Grafana menambahkannya secara otomatis ke kueri InfluxDB saat dalam mode Query Editor. Anda dapat menambahkannya secara manual dalam mode Editor Teks:`WHERE $timeFilter`.
+ Kueri log Analytics di sumber data Azure Monitor.
+ Kueri SQL di MySQL, Postgres, dan MSSQL.
+ `$__timeFilter`Variabel ini digunakan dalam sumber data MySQL.

**\$1 \$1\$1zona waktu**

`$__timezone`Variabel mengembalikan zona waktu yang dipilih saat ini, baik `utc` atau entri basis data zona waktu IANA (misalnya,`America/New_York`).

Jika zona waktu yang dipilih saat ini adalah *Waktu Browser*, Grafana akan mencoba menentukan zona waktu browser Anda.

## Variabel yang dirantai
<a name="v10-dash-variable-add-chained"></a>

*Variabel berantai*, juga disebut *variabel terkait atau variabel* *bersarang, adalah variabel* kueri dengan satu atau lebih variabel lain dalam kueri variabelnya.

Kueri variabel berantai berbeda untuk setiap sumber data, tetapi premisnya sama untuk semua. Anda dapat menggunakan kueri variabel berantai di sumber data apa pun yang memungkinkan mereka.

Dasbor templat tertaut yang sangat kompleks dimungkinkan, kedalaman 5 atau 10 tingkat. Secara teknis, tidak ada batasan seberapa dalam atau kompleks Anda dapat pergi, tetapi semakin banyak tautan yang Anda miliki, semakin besar beban kueri.

**Praktik dan kiat terbaik**

Praktik berikut akan membuat dasbor dan variabel Anda lebih mudah digunakan.

**Membuat variabel terkait baru**
+ Variabel rantai membuat parent/child dependensi. Anda dapat membayangkan mereka sebagai tangga atau pohon.
+ Cara termudah untuk membuat variabel berantai baru adalah dengan menyalin variabel yang ingin Anda dasarkan pada yang baru. Dalam daftar variabel, klik ikon **variabel Duplikat** di sebelah kanan entri variabel untuk membuat salinan. Anda kemudian dapat menambahkan ke kueri untuk variabel induk.
+ Variabel baru yang dibuat dengan cara ini muncul di bagian bawah daftar. Anda mungkin perlu menyeretnya ke posisi yang berbeda dalam daftar untuk memasukkannya ke dalam urutan logis.

**Urutan variabel**

Anda dapat mengubah urutan variabel dalam daftar variabel dasbor dengan mengklik panah atas dan bawah di sisi kanan setiap entri. Grafana mencantumkan dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, dengan variabel di bagian atas di paling kiri.
+ Buat daftar variabel yang tidak memiliki dependensi di bagian atas, sebelum variabel anak mereka.
+ Setiap variabel harus mengikuti salah satu yang bergantung padanya.
+ Ingat tidak ada indikasi di UI variabel mana yang memiliki hubungan ketergantungan. Buat daftar variabel dalam urutan logis untuk memudahkan pengguna lain (dan diri Anda sendiri).

**Pertimbangan kompleksitas**

Semakin banyak lapisan ketergantungan yang Anda miliki dalam variabel, semakin lama waktu yang dibutuhkan untuk memperbarui dasbor setelah Anda mengubah variabel.

Misalnya, jika Anda memiliki serangkaian empat variabel tertaut (negara, Wilayah, server, metrik) dan Anda mengubah nilai variabel root (negara), maka Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor.

## Kelola variabel
<a name="v10-dash-variable-add-manage"></a>

Halaman variabel memungkinkan Anda menambahkan variabel dan mengelola variabel yang ada. Hal ini juga memungkinkan Anda untuk [memeriksa](v10-dash-variable-add-inspect.md) variabel dan mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel lain atau dashboard.

**Pindah** - Anda dapat memindahkan variabel ke atas atau ke bawah daftar menggunakan drag and drop.

**Klon** - Untuk mengkloning variabel, klik ikon klon dari kumpulan ikon di sebelah kanan. Ini menciptakan salinan variabel dengan nama variabel asli yang diawali dengan`copy_of_`.

**Hapus** - Untuk menghapus variabel, klik ikon sampah dari kumpulan ikon di sebelah kanan.

## Filter variabel dengan regex
<a name="v10-dash-variable-add-filter"></a>

Menggunakan opsi Regex Query, Anda memfilter daftar opsi yang dikembalikan oleh kueri variabel atau memodifikasi opsi yang dikembalikan.

Halaman ini menunjukkan cara menggunakan regex ke filter/modify nilai dalam dropdown variabel.

Menggunakan Opsi Kueri Regex, Anda memfilter daftar opsi yang dikembalikan oleh kueri Variabel atau memodifikasi opsi yang dikembalikan. Untuk informasi selengkapnya, lihat panduan Mozilla tentang [ekspresi Reguler](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Contoh berikut menunjukkan pemfilteran pada daftar opsi berikut

```
backend_01
backend_02
backend_03
backend_04
```

**Filter sehingga hanya opsi yang diakhiri dengan `01` atau `02` dikembalikan**

Regex:

```
/
(
01|02 
) 
$/
```

Hasil:

```
backend_01
backend_02
```

**Filter dan ubah opsi menggunakan grup tangkapan regex untuk mengembalikan bagian teks**

Regex:

```
/.* 
(
01|02 
)
/
```

Hasil:

```
01
02
```

**Filter dan modifikasi - Contoh Prometheus**

Untuk daftar opsi ini:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex ini:

```
/. *instance="
(
[^"]*
)
.*/
```

Mengembalikan hasil ini:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filter dan modifikasi menggunakan teks bernama dan grup penangkap nilai**

Menggunakan grup tangkapan bernama, Anda dapat menangkap bagian 'teks' dan 'nilai' terpisah dari opsi yang dikembalikan oleh kueri variabel. Hal ini memungkinkan daftar dropdown variabel berisi nama ramah untuk setiap nilai yang dapat dipilih.

Misalnya, saat menanyakan metrik `node_hwmon_chip_names` Prometheus, nilainya jauh lebih ramah `chip_name` daripada nilainya. `chip` Jadi hasil query variabel berikut:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Melewati Regex berikut:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Akan menghasilkan daftar dropdown berikut:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Hanya `text` dan `value` menangkap nama grup yang didukung.

# Periksa Variabel
<a name="v10-dash-variable-add-inspect"></a>

Halaman variabel memungkinkan Anda dengan mudah mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel atau dasbor lain.

Setiap variabel yang direferensikan atau digunakan memiliki tanda centang hijau di sebelahnya, sementara variabel yang tidak direferensikan memiliki ikon peringatan oranye di sebelahnya. Selain itu, semua variabel yang direferensikan memiliki ikon ketergantungan di sebelah tanda centang hijau. Anda dapat memilih ikon untuk melihat peta ketergantungan. Peta ketergantungan dapat dipindahkan. Anda dapat memperbesar atau memperkecil dengan roda mouse atau yang setara.

# Sintaks variabel
<a name="v10-dash-variable-syntax"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Judul panel dan kueri metrik dapat merujuk ke variabel menggunakan dua sintaks yang berbeda.
+ `$varname`— Sintaks ini mudah dibaca, tetapi tidak memungkinkan Anda untuk menggunakan variabel di tengah kata.

  **Contoh:** `apps.frontend.$server.requests.count`
+ `${var_name}`— Gunakan sintaks ini ketika Anda ingin menggunakan variabel di tengah ekspresi.
+ `${var_name:<format>}`— Format ini memberi Anda kontrol lebih besar atas bagaimana Grafana menafsirkan nilai. Untuk informasi selengkapnya, lihat *Opsi format variabel lanjutan*, mengikuti daftar ini.
+ `[[varname]]`- Jangan gunakan. Sintaks ini sudah tua dan sudah usang. Ini akan dihapus dalam rilis future.

Sebelum kueri dikirim ke sumber data Anda, kueri *diinterpolasi*, artinya variabel diganti dengan nilai saat ini. Selama interpolasi, nilai variabel mungkin *lolos* agar sesuai dengan sintaks bahasa kueri dan di mana ia digunakan. Misalnya, variabel yang digunakan dalam ekspresi regex dalam kueri InfluxDB atau Prometheus akan diloloskan regex.

**Opsi format variabel lanjutan**

Pemformatan interpolasi variabel tergantung pada sumber data, tetapi ada beberapa situasi di mana Anda mungkin ingin mengubah format default.

Misalnya, default untuk sumber data MySQL adalah menggabungkan beberapa nilai sebagai dipisahkan koma dengan tanda kutip:. `'server01','server02'` Dalam beberapa kasus, Anda mungkin ingin memiliki string yang dipisahkan koma tanpa tanda kutip:. `server01,server02` Anda dapat mewujudkannya dengan opsi pemformatan variabel lanjutan yang tercantum di bawah ini.

**Sintaks umum**

Sintaks: `${var_name:option}`

Jika ada opsi pemformatan yang tidak valid ditentukan, maka `glob` adalah opsi. default/fallback 

**CSV**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Didistribusikan - OpenTSDB**

Memformat variabel dengan beberapa nilai dalam format khusus untuk OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Kutipan ganda**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `"` di setiap nilai dengan `\"` dan mengutip setiap nilai dengan. `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Grafit**

Memformat variabel dengan beberapa nilai menjadi gumpalan (untuk kueri Grafit).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Memformat variabel dengan beberapa nilai dalam format Lucene untuk Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Kode Persentase**

Memformat variabel tunggal dan multivalued untuk digunakan dalam parameter URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Pipa**

Memformat variabel dengan beberapa nilai menjadi string yang dipisahkan pipa.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Mentah**

Menonaktifkan pemformatan khusus sumber data, seperti tanda kutip tunggal dalam kueri SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Memformat variabel dengan beberapa nilai menjadi string regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `\'` dan mengutip setiap nilai dengan. `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `''` dan mengutip setiap nilai dengan. `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Teks**

Memformat variabel tunggal dan multi-nilai ke dalam representasi teks mereka. Untuk satu variabel, itu hanya akan mengembalikan representasi teks. Untuk variabel multi-nilai, itu akan mengembalikan representasi teks yang digabungkan dengan`+`.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parameter kueri**

Memformat variabel tunggal dan multi-nilai ke dalam representasi parameter kueri mereka. Contoh: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Menilai penggunaan dasbor
<a name="v10-dash-assess-dashboard-usage"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Untuk setiap dasbor dan sumber data, Anda dapat mengakses informasi penggunaan.

**Wawasan dasbor**

Untuk melihat informasi penggunaan dasbor, pilih **Wawasan dasbor** di bilah atas.

Wawasan dasbor menunjukkan informasi berikut.
+ **Statistik** — Jumlah kueri dan kesalahan harian selama 30 hari terakhir.
+ **Pengguna & aktivitas** — Jumlah tampilan harian selama 30 hari terakhir; aktivitas terakhir di dasbor dan pengguna terbaru (dengan batas 20).

**Wawasan sumber data**

Wawasan sumber data memberikan informasi tentang bagaimana sumber data telah digunakan dalam 30 hari terakhir, seperti:
+ Pertanyaan per hari
+ Kesalahan per hari
+ Waktu muat kueri per hari (dirata-ratakan dalam ms)

**Untuk menemukan wawasan sumber data**

1. Pilih **Koneksi** di navigasi utama ruang kerja Anda.

1. Pilih **Sumber data**.

1. Pilih sumber data.

1. Pilih tab **Wawasan**.

## Indikator kehadiran
<a name="v10-dash-presence-indicator"></a>

Saat Anda masuk dan melihat dasbor, Anda dapat mengetahui siapa yang melihat dasbor yang sama dengan Anda melalui indikator kehadiran, yang menampilkan avatar pengguna yang baru saja berinteraksi dengan dasbor. Jangka waktu default adalah 10 menit. Untuk melihat nama pengguna, arahkan kursor ke avatar pengguna. Avatar berasal dari [Gravatar](https://gravatar.com/) berdasarkan email pengguna.

Ketika ada lebih banyak pengguna aktif di dasbor daripada yang dapat masuk dalam indikator kehadiran, klik **ikon\$1X**. Melakukan hal ini akan membuka wawasan dasbor, yang berisi detail lebih lanjut tentang aktivitas pengguna terbaru.

## Menyortir dasbor dengan menggunakan data wawasan
<a name="v10-dash-sort-dashboards"></a>

Di tampilan penelusuran, Anda dapat menggunakan data wawasan untuk membantu menemukan dasbor yang paling sering digunakan, rusak, dan tidak digunakan. Anda dapat mengurutkan dasbor berdasarkan berikut ini.
+ Tampilan
+ Kesalahan
+ Tampilan
+ Waktu yang dibuat
+ Waktu yang diperbarui

# Memecahkan masalah dasbor
<a name="v10-dash-troubleshoot"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Gunakan strategi berikut untuk membantu Anda memecahkan masalah dasbor umum. 

## Dashboard lambat
<a name="v10-dash-dashboard-is-slow"></a>
+ Apakah Anda mencoba merender lusinan (atau ratusan atau ribuan) deret waktu pada grafik? Ini dapat menyebabkan browser tertinggal. Coba gunakan fungsi seperti `highestMax` (dalam Graphite) untuk mengurangi jumlah seri yang dikembalikan.
+ Terkadang nama seri bisa sangat besar. Ini menyebabkan ukuran respons yang lebih besar. Coba gunakan `alias` untuk mengurangi ukuran nama seri yang dikembalikan.
+ Apakah Anda menanyakan banyak deret waktu atau rentang waktu yang lama? Kedua kondisi ini dapat menyebabkan Grafana atau sumber data Anda menarik banyak data, yang dapat memperlambat dasbor. Coba kurangi salah satu atau keduanya.
+ Mungkin ada beban tinggi pada infrastruktur jaringan Anda. Jika kelambatan tidak konsisten, ini mungkin masalahnya.

## Masalah kecepatan penyegaran dasbor
<a name="v10-dash-refresh-rate-issues"></a>

Secara default, Grafana menanyakan sumber data Anda setiap 30 detik. Namun, menyetel kecepatan refresh rendah pada dasbor Anda memberi tekanan yang tidak perlu pada backend. Dalam banyak kasus, kueri ini sering tidak diperlukan karena sumber data tidak mengirim data cukup sering sehingga ada perubahan setiap 30 detik.

Sebaiknya lakukan hal berikut:
+ Hanya aktifkan penyegaran otomatis di dasbor, panel, atau variabel jika perlu. Pengguna dapat me-refresh browser mereka secara manual.
+ Jika Anda memerlukan penyegaran otomatis, maka atur kecepatan refresh ke periode waktu yang lebih lama yang masuk akal, seperti sekali dalam satu menit, setiap 10 menit, atau setiap jam.
+ Periksa rentang waktu dasbor Anda. Jika dasbor Anda memiliki rentang waktu yang lebih lama, seperti seminggu, maka Anda benar-benar tidak perlu penyegaran otomatis dan Anda harus menonaktifkannya.

## Menangani atau merender data nol salah atau membingungkan
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

Beberapa aplikasi mempublikasikan data sebentar-sebentar; misalnya, mereka hanya memposting metrik ketika suatu peristiwa terjadi. Secara default, grafik Grafana menghubungkan garis antara titik data, tetapi ini bisa menipu.

Grafik yang memiliki opsi **Connect null values** disetel ke **Always**, akan menghubungkan garis di mana ada nilai yang hilang.

Salah satu cara untuk memperbaikinya adalah dengan menggunakan bilah alih-alih garis dan mengatur opsi **No value** (di bawah **opsi Standar**)`0`. Dalam hal ini, data yang hilang akan muncul sebagai area grafik tanpa data.

# Mencari Dasbor di Grafana versi 10
<a name="v10-search"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat mencari dasbor berdasarkan nama dasbor dan judul panel. Saat Anda mencari dasbor, sistem mengembalikan semua dasbor yang tersedia dalam instance Grafana, bahkan jika Anda tidak memiliki izin untuk melihat konten dasbor.

## Cari dasbor menggunakan nama dasbor
<a name="v10-search-by-name"></a>

Masukkan bagian mana pun dari nama dasbor di bilah pencarian. Pencarian mengembalikan hasil untuk setiap kecocokan string sebagian secara real-time, saat Anda mengetik.

Pencarian dasbor adalah:
+ Real-time
+ *Tidak* peka huruf besar/kecil
+ Fungsional di seluruh dasbor yang disimpan dan berbasis file.

**Tip**  
Anda dapat menggunakan tombol panah keyboard untuk menavigasi hasil dan tekan `Enter` untuk membuka dasbor yang dipilih.

## Cari dasbor menggunakan judul panel
<a name="v10-search-by-title"></a>

Anda dapat mencari dasbor dengan judul panel yang muncul di dasbor. Jika judul panel cocok dengan kueri penelusuran Anda, dasbor akan muncul di hasil penelusuran.

## Filter hasil pencarian dasbor berdasarkan tag
<a name="v10-search-by-tag"></a>

Tag adalah cara yang bagus untuk mengatur dasbor Anda, terutama karena jumlah dasbor bertambah. Anda dapat menambahkan dan mengelola tag di **Pengaturan** dasbor.

Saat Anda memilih beberapa tag, Grafana menampilkan dasbor yang menyertakan semua tag yang dipilih.

Untuk memfilter hasil pencarian dasbor dengan tag, selesaikan salah satu langkah berikut:
+ Untuk memfilter hasil pencarian dasbor berdasarkan tag, pilih tag yang muncul di kolom kanan hasil pencarian.

  Anda dapat melanjutkan pemfilteran dengan memilih tag tambahan.
+ Untuk melihat daftar semua tag yang tersedia, klik menu dropdown **Filter by tags** dan pilih tag.

  Semua tag akan ditampilkan, dan ketika Anda memilih tag, pencarian dasbor akan langsung disaring.

**Tip**  
Saat hanya menggunakan keyboard, tekan `tab` tombol dan arahkan ke menu dropdown **Filter by tag**, tekan tombol panah bawah untuk mengaktifkan menu dan menemukan tag, dan tekan `Enter` untuk memilih tag.

## Palet perintah
<a name="v10-search-palette"></a>

Anda dapat menggunakan palet perintah untuk melakukan hal berikut:
+ Cari dan buka dasbor dan folder.
+ Buat dasbor dan aturan peringatan.
+ Temukan halaman dalam Grafana.
+ Ubah tema menjadi gelap atau terang.

Buka palet perintah atas, masukkan `ctrl+k` (`cmd+k`di macOS). Anda juga dapat memilih input pencarian di bilah navigasi Grafana.

**catatan**  
Untuk pergi ke langkah sebelumnya, tekan `backspace` dengan palet perintah kosong.

# Panel dan visualisasi dalam Grafana versi 10
<a name="v10-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Panel* adalah blok bangunan visualisasi dasar di Grafana. Setiap panel memiliki editor kueri khusus untuk sumber data yang dipilih di panel. Editor kueri memungkinkan Anda membuat kueri yang mengembalikan data yang ingin Anda visualisasikan.

Ada berbagai macam pilihan styling dan format untuk setiap panel. Panel dapat diseret, dijatuhkan, dan diubah ukurannya untuk mengatur ulang mereka di dasbor.

Sebelum Anda menambahkan panel, pastikan Anda telah mengonfigurasi sumber data.

Jenis panel tambahan mungkin tersedia dengan menginstal [plugin tambahan ke ruang](grafana-plugins.md) kerja Anda.

Untuk detail tentang penggunaan sumber data tertentu, lihat[Connect ke sumber data](AMG-data-sources.md).

**Topics**
+ [Ikhtisar editor panel](v10-panels-editor-overview.md)
+ [Tampilan inspeksi panel](v10-panels-panel-inspector.md)
+ [Kueri dan transformasi data](v10-panels-query-xform.md)
+ [Konfigurasikan opsi panel](v10-panels-configure-panel-options.md)
+ [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md)
+ [Konfigurasikan legenda](v10-panels-configure-legend.md)
+ [Konfigurasikan tautan data](v10-panels-configure-data-links.md)
+ [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)
+ [Konfigurasikan ambang batas](v10-panels-configure-thresholds.md)
+ [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md)
+ [Visualisasi tersedia dalam Grafana versi 10](v10-panels-viz.md)

# Ikhtisar editor panel
<a name="v10-panels-editor-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Di editor panel, Anda dapat memperbarui semua elemen visualisasi, termasuk sumber data, kueri, rentang waktu, dan opsi tampilan.

Untuk menambahkan panel ke dasbor baru, pilih **\$1 Tambahkan visualisasi** di tengah dasbor. Untuk menambahkan panel ke dasbor yang ada, pilih **Tambahkan** di header dasbor dan pilih **Visualisasi** di drop-down. Anda juga dapat menyalin dan menempelkan panel yang ada dari dasbor yang sama atau berbeda.

## Menu panel
<a name="v10-panels-editor-menu"></a>

Untuk mengakses editor panel, arahkan kursor ke sudut kanan atas panel mana pun. Pilih ikon menu panel yang muncul dan pilih **Edit**.

Menu panel juga memberi Anda akses ke tindakan berikut:
+ **Lihat** - Lihat panel di layar penuh.
+ **Edit** - Buka editor panel untuk mengedit panel dan opsi visualisasi.
+ **Bagikan** — Bagikan panel sebagai tautan, atau panel perpustakaan.
+ **Jelajahi** — Buka panel di **Jelajahi**, di mana Anda dapat fokus pada kueri Anda.
+ **Inspect** — Buka laci **Inspect**, tempat Anda dapat meninjau data panel, statistik, metadata, JSON, dan kueri.
  + **Data** — Buka laci **Inspect** di tab **Data**.
  + **Query** - Buka laci **Inspect** di tab **Query**.
  + **Panel JSON** **- Buka laci **Inspect** di tab JSON.**
+ **Ekstensi** — Akses tindakan lain yang disediakan oleh aplikasi yang diinstal, seperti mendeklarasikan insiden. Opsi ini hanya muncul jika Anda menginstal plugin aplikasi yang berkontribusi ekstensi ke menu panel.
+ **Lainnya** - Akses tindakan panel lainnya.
  + **Duplikat** — Buat salinan panel. Panel duplikat menanyakan data secara terpisah dari panel asli. Jika Anda ingin menggunakan hasil kueri yang sama, Anda dapat menggunakan sumber `Dashboard` data di panel kedua.
  + **Salin** — Salin panel ke clipboard.
  + **Buat panel pustaka** — Buat panel yang dapat diimpor ke dasbor lain.
  + **Buat peringatan** — Buka halaman konfigurasi aturan **peringatan di Peringatan, tempat Anda dapat membuat peringatan** yang [dikelola Grafana berdasarkan kueri](v10-alerts.md) panel.
  + **Sembunyikan legenda** - Sembunyikan legenda panel.
  + **Dapatkan bantuan** — Kirim snapshot atau data panel ke Grafana Labs Technical Support.
+ **Hapus** - Hapus panel dari dasbor.

## Editor panel
<a name="v10-panels-editor-view"></a>

Bagian ini menjelaskan area editor panel Grafana.
+ Header panel - Bagian header mencantumkan dasbor tempat panel muncul dan kontrol berikut:
  + **Buang** — Buang perubahan yang telah Anda buat pada panel sejak terakhir kali Anda menyimpan dasbor.
  + **Simpan** - Menyimpan perubahan yang Anda buat ke panel.
  + **Terapkan - Menerapkan** perubahan yang Anda buat dan menutup editor panel, mengembalikan Anda ke dasbor. Anda harus menyimpan dasbor untuk mempertahankan perubahan yang diterapkan.
+ Pratinjau visualisasi - Bagian pratinjau visualisasi berisi opsi berikut:
  + **Tampilan tabel** - Ubah visualisasi apa pun ke tabel sehingga Anda dapat melihat datanya. Tampilan tabel sangat membantu untuk pemecahan masalah. Tampilan ini hanya berisi data mentah. Ini tidak termasuk transformasi yang mungkin telah Anda terapkan pada data atau opsi pemformatan yang tersedia dalam visualisasi [Tabel](v10-panels-table.md).
  + **Isi - Pratinjau** visualisasi mengisi ruang yang tersedia. Jika Anda mengubah lebar panel samping atau tinggi panel bawah, visualisasi berubah untuk mengisi ruang yang tersedia.
  + **Aktual** - Pratinjau visualisasi akan memiliki ukuran yang tepat seperti ukuran di dasbor. Jika tidak cukup ruang yang tersedia, visualisasi akan mengurangi menjaga rasio aspek.
  + **Kontrol rentang waktu** — **Default** adalah zona waktu lokal browser atau zona waktu yang dipilih pada tingkat yang lebih tinggi.
+ Bagian data — Bagian data berisi tab tempat Anda memasukkan kueri, mengubah data, dan membuat aturan peringatan (jika berlaku).
  + **Tab kueri** — Pilih sumber data Anda dan masukkan kueri di sini. Untuk informasi selengkapnya, lihat [Kueri dan transformasi data](v10-panels-query-xform.md). Saat Anda pertama kali membuat dasbor, Anda diminta untuk memilih sumber data. Anda dapat memperbarui sumber data atau kueri di tab ini.
  + **Tab Transform** - Terapkan transformasi data. Untuk informasi selengkapnya, lihat [Kueri dan transformasi data](v10-panels-query-xform.md).
  + **Tab peringatan** - Tulis aturan peringatan. Untuk informasi selengkapnya, lihat [Peringatan di Grafana versi 10](v10-alerts.md).
+ Opsi tampilan panel - Bagian opsi tampilan berisi tab tempat Anda mengonfigurasi hampir setiap aspek visualisasi data Anda. Detailnya bervariasi berdasarkan jenis visualisasi yang dipilih.

## Panel memeriksa laci
<a name="v10-panels-editor-inspect"></a>

Laci inspeksi membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat melihat data mentah untuk panel apa pun, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, dan mengekspor panel dan data JSON.

**catatan**  
Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri.

Inspektur panel terdiri dari opsi-opsi berikut:
+ Panel memeriksa tampilan laci sebagai laci di sisi kanan. Pilih panah di sudut kanan atas untuk memperluas atau mengurangi panel laci.
+ **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default.
+ **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+ **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana.
+ **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data.
+ **Tab kesalahan** - Menampilkan kesalahan yang dikembalikan oleh kueri. Tab hanya terlihat ketika kueri mengembalikan kesalahan.

# Tampilan inspeksi panel
<a name="v10-panels-panel-inspector"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tampilan inspeksi panel, yang dapat Anda buka melalui menu panel, membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat memeriksa data mentah untuk panel Grafana Terkelola Amazon, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, serta mengekspor panel dan data JSON.

**catatan**  
Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri.

Inspektur panel terdiri dari opsi-opsi berikut:

1. Inspektur panel menampilkan **Inspect:** di bagian atas panel. Pilih panah di sudut kanan atas untuk memperluas atau mengurangi panel.

1. **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default.

1. **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.

1. **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana.

1. **Tab kueri** — Menampilkan permintaan yang dikirim ke server saat Grafana menanyakan sumber data.

1. **Tab kesalahan** - Menampilkan kesalahan apa pun. Hanya terlihat ketika kueri mengembalikan kesalahan.

## Mengunduh hasil kueri mentah
<a name="v10-panels-raw-query-results"></a>

Grafana yang Dikelola Amazon menghasilkan file CSV yang berisi data Anda, termasuk transformasi apa pun pada data tersebut. Anda dapat memilih untuk melihat data sebelum atau setelah panel menerapkan opsi bidang atau penggantian opsi bidang.

**Untuk mengunduh hasil kueri mentah**

1. Edit panel yang berisi data kueri yang ingin Anda unduh.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Data**.

   Jika panel Anda berisi beberapa kueri atau kueri beberapa node, maka Anda memiliki opsi tambahan.
   + **Pilih hasil** - Pilih data set hasil yang ingin Anda lihat.
   + **Mengubah data**
   + **Bergabung berdasarkan waktu** - Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Pilih judul kolom untuk menyusun ulang data.

1. Untuk melihat data sebelum sistem menerapkan penggantian bidang, pilih sakelar Data yang **diformat.**

1. Untuk mengunduh file CSV yang diformat khusus untuk Excel, pilih tombol **Unduh untuk Excel**.

1. Pilih **Unduh CSV**.

## Memeriksa kinerja kueri
<a name="v10-panels-query-performance"></a>

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

**Untuk memeriksa kinerja kueri**

1. Edit panel yang berisi kueri dengan kinerja yang ingin Anda periksa.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Statistik.**

Statistik ditampilkan dalam format read-only.

## Memeriksa permintaan dan respons kueri
<a name="v10-panels-query-request-response"></a>

Anda dapat memeriksa permintaan kueri dan data respons saat ingin memecahkan masalah kueri yang mengembalikan hasil yang tidak terduga, atau gagal mengembalikan hasil yang diharapkan.

1. Edit panel yang berisi kueri yang ingin Anda ekspor.

1. Di editor kueri, pilih **Query Inspector**.

1. Pilih **Segarkan**.

   Panel diisi dengan data respons.

1. Lakukan penyesuaian, seperlunya dan jalankan kembali kueri.

1. Untuk mengunduh permintaan kueri dan data respons, klik ikon **Salin ke clipboard** dan tempel hasilnya ke aplikasi lain.

# Kueri dan transformasi data
<a name="v10-panels-query-xform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana yang Dikelola Amazon mendukung banyak jenis sumber [data](AMG-data-sources.md). *Kueri* sumber data mengembalikan data yang *dapat* diubah dan divisualisasikan Grafana. Setiap sumber data menggunakan bahasa kueri sendiri, dan plugin sumber data masing-masing menerapkan antarmuka pengguna yang membangun kueri yang disebut editor kueri.

**Topics**
+ [Tentang pertanyaan](#v10-panels-query-xform-about)
+ [Menavigasi tab kueri](#v10-panels-query-xform-navigate)
+ [Menambahkan kueri](#v10-panels-query-xform-add)
+ [Kelola kueri](#v10-panels-query-xform-manage)
+ [Opsi kueri](#v10-panels-query-xform-options)
+ [Tulis kueri ekspresi](v10-panels-query-xform-expressions.md)
+ [Bagikan hasil kueri dengan panel lain](v10-panels-query-share.md)
+ [Mengubah data](v10-panels-xform.md)
+ [Memecahkan masalah kueri](v10-panels-query-troubleshoot.md)
+ [Jenis perhitungan](v10-panels-calculation-types.md)

## Tentang pertanyaan
<a name="v10-panels-query-xform-about"></a>

Panel Grafana berkomunikasi dengan sumber data melalui kueri, yang mengambil data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data.

Anda dapat mengonfigurasi frekuensi kueri dan batas pengumpulan data dalam opsi sumber data panel. Grafana mendukung hingga 26 kueri per panel.

Anda dapat menemukan informasi selengkapnya tentang bahasa kueri setiap sumber [data di bagian Sumber data](AMG-data-sources.md).

**Editor kueri**

Setiap *editor kueri* sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Untuk detail tentang fitur editor kueri unik sumber data tertentu, termasuk informasi tentang kueri dan sintaks, lihat dokumentasi sumber data:
+ Untuk sumber data yang disertakan dengan Grafana Terkelola Amazon, lihat Sumber [data bawaan](AMG-data-sources-builtin.md).
+ Untuk sumber data yang disertakan dengan Grafana Enterprise, lihat. [Connect ke sumber data Enterprise](AMG-data-sources-enterprise.md)
+ Untuk plugin sumber data lain yang Anda instal melalui[Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog), dokumentasi ditautkan dalam daftar di katalog plugin.

**Sintaks kueri**

Sumber data menggunakan bahasa kueri yang berbeda untuk meminta data. Untuk detail tentang bahasa kueri unik sumber data tertentu, lihat dokumentasinya.

**Contoh PostgreSQL:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**Contoh PromQL:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Sumber data khusus**

**Grafana juga mencakup tiga sumber data khusus: **Grafana**, **Campuran**, dan Dasbor.** Untuk informasi selengkapnya, lihat [Connect ke sumber data](AMG-data-sources.md).

## Menavigasi tab kueri
<a name="v10-panels-query-xform-navigate"></a>

Tab **Query** panel terdiri dari elemen-elemen berikut:
+ **Pemilih sumber data** - Memilih sumber data untuk kueri.
+ **Opsi kueri** - Menetapkan parameter pengambilan data maksimum dan interval waktu menjalankan kueri.
+ **Tombol inspektur kueri** — Membuka panel inspektur kueri, tempat Anda dapat melihat dan mengoptimalkan kueri Anda.
+ **Daftar editor kueri** - Daftar kueri yang telah Anda tulis.
+ **Ekspresi** - Menggunakan pembuat ekspresi untuk membuat ekspresi peringatan. Untuk informasi selengkapnya tentang ekspresi, lihat[Tulis kueri ekspresi](v10-panels-query-xform-expressions.md).

## Menambahkan kueri
<a name="v10-panels-query-xform-add"></a>

Kueri mengembalikan data yang divisualisasikan Grafana di panel dasbor. Saat Anda membuat panel, Grafana secara otomatis memilih sumber data default.

**Untuk menambahkan kueri**

1. Edit panel tempat Anda menambahkan kueri.

1. Pilih tab **Kueri**.

1. Pilih menu tarik-turun **Sumber data** dan pilih sumber data.

1. Pilih **opsi Kueri** untuk mengonfigurasi jumlah maksimum titik data yang Anda butuhkan. Untuk informasi selengkapnya tentang opsi kueri, lihat[Opsi kueri](#v10-panels-query-xform-options).

1. Tulis kueri menggunakan editor kueri.

1. Pilih **Terapkan**.

Grafana menanyakan sumber data dan memvisualisasikan data.

## Kelola kueri
<a name="v10-panels-query-xform-manage"></a>

Grafana mengatur kueri dalam baris kueri yang dapat dilipat. Setiap baris kueri berisi editor kueri dan diidentifikasi dengan huruf (A, B, C, dan sebagainya).

Untuk mengelola kueri, Anda dapat menyalin kueri, menyembunyikan kueri, menghapus kueri, menyusun ulang kueri, dan beralih bantuan untuk editor kueri.

## Opsi kueri
<a name="v10-panels-query-xform-options"></a>

Pilih **Opsi kueri** di sebelah pemilih sumber data untuk melihat pengaturan sumber data yang dipilih. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini.

Grafana menetapkan default yang ditampilkan dalam teks abu-abu gelap. Perubahan ditampilkan dalam teks putih. Untuk mengembalikan bidang ke pengaturan default, hapus teks putih dari bidang.

Opsi kueri sumber data panel meliputi:
+ **Titik data maksimum** - Jika sumber data mendukungnya, ini menetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, maka sumber data mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata, maks, atau fungsi lain.

  Anda dapat membatasi jumlah poin untuk meningkatkan kinerja kueri atau menghaluskan garis yang divisualisasikan. Nilai default adalah lebar (atau jumlah piksel) grafik, karena Anda hanya dapat memvisualisasikan titik data sebanyak panel grafik memiliki ruang untuk ditampilkan.

  Dengan streaming data, Grafana menggunakan nilai titik data maksimal untuk buffer bergulir. Streaming adalah aliran data yang berkelanjutan, dan buffering membagi aliran menjadi beberapa bagian.
+ **Interval min** - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, yang biasanya merupakan interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak mendapat manfaat dari interval yang lebih rendah dari itu. Anda juga dapat mengatur ini ke minimum yang lebih tinggi daripada interval scrape untuk mengambil kueri yang lebih kasar dan berfungsi dengan baik.
+ **Interval** - Menetapkan rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu.

  Grafana secara otomatis menghitung interval yang sesuai yang dapat Anda gunakan sebagai variabel dalam kueri templat. Variabel diukur dalam detik (`$__interval`) atau milidetik (`$__interval_ms`).

  Interval biasanya digunakan dalam fungsi agregasi seperti jumlah atau rata-rata. Misalnya, ini adalah kueri Prometheus yang menggunakan variabel interval:. `rate(http_requests_total[$__interval])`

  Interval otomatis ini dihitung berdasarkan lebar grafik. Saat pengguna memperkecil visualisasi, interval tumbuh, menghasilkan agregasi yang lebih kasar. Demikian juga, jika pengguna memperbesar, intervalnya berkurang, menghasilkan agregasi yang lebih halus.

  Untuk informasi selengkapnya, lihat [Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Waktu relatif** — Mengganti rentang waktu relatif untuk panel individu, yang menyebabkannya berbeda dari yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Anda dapat menggunakan ini untuk menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Pergeseran waktu** — Mengganti rentang waktu untuk panel individu dengan menggeser awal dan akhir relatif terhadap pemilih waktu. Misalnya, Anda dapat menggeser rentang waktu panel menjadi dua jam lebih awal dari pemilih waktu dasbor.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-query-xform.html)
+ Batas **waktu cache** — *(Terlihat hanya jika tersedia di sumber data)* Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Tentukan nilai ini sebagai nilai numerik dalam hitungan detik.

# Tulis kueri ekspresi
<a name="v10-panels-query-xform-expressions"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data.

## Tentang ekspresi
<a name="v10-panels-query-about"></a>

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data, selain dari beberapa restrukturisasi data kecil untuk membuat input data yang dapat diterima untuk ekspresi.

**Menggunakan ekspresi**

Ekspresi paling sering digunakan oleh peringatan [Grafana](v10-alerts.md). Pemrosesan dilakukan sisi server, sehingga ekspresi dapat beroperasi tanpa sesi browser. Namun, ekspresi juga dapat digunakan dengan sumber data backend dan visualisasi.

**catatan**  
Ekspresi tidak berfungsi dengan peringatan dasbor lama.

Ekspresi dimaksudkan untuk menambah sumber data dengan memungkinkan kueri dari sumber data yang berbeda untuk digabungkan atau dengan menyediakan operasi yang tidak tersedia di sumber data.

**catatan**  
Jika memungkinkan, Anda harus melakukan pemrosesan data di dalam sumber data. Menyalin data dari penyimpanan ke server Grafana untuk diproses tidak efisien, sehingga ekspresi ditargetkan pada pemrosesan data ringan.

Ekspresi bekerja dengan kueri sumber data yang mengembalikan deret waktu atau data numerik. Mereka juga beroperasi pada data [multi-dimensi](getting-started-grafanaui.md#time-series-dimensions). Misalnya, kueri yang mengembalikan beberapa seri, di mana setiap seri diidentifikasi oleh label atau tag.

Ekspresi individu mengambil satu atau lebih kueri atau ekspresi lain sebagai input dan menambahkan data ke hasilnya. Setiap ekspresi atau kueri individu diwakili oleh variabel yang merupakan pengidentifikasi bernama yang dikenal sebagai ReFID-nya (misalnya, huruf `A` default atau). `B`

Untuk mereferensikan output dari ekspresi individu atau kueri sumber data dalam ekspresi lain, pengidentifikasi ini digunakan sebagai variabel.

**Jenis ekspresi**

Ekspresi bekerja dengan dua jenis data.
+ Koleksi deret waktu.
+ Kumpulan angka, di mana setiap nomor adalah item.

Setiap koleksi dikembalikan dari kueri atau ekspresi sumber data tunggal dan diwakili oleh ReFID. Setiap koleksi adalah satu set, di mana setiap item dalam set diidentifikasi secara unik oleh dimensinya yang disimpan sebagai [label](getting-started-grafanaui.md#labels) atau pasangan nilai kunci.

**Kueri sumber data**

Ekspresi sisi server hanya mendukung kueri sumber data untuk sumber data backend. Data umumnya diasumsikan diberi label data deret waktu. 

Kueri sumber data, bila digunakan dengan ekspresi, dijalankan oleh mesin ekspresi. Ketika melakukan ini, ia merestrukturisasi data menjadi satu deret waktu atau satu angka per frame data. Jadi misalnya jika menggunakan sumber data yang mengembalikan beberapa seri pada satu bingkai dalam tampilan tabel, Anda mungkin melihat itu terlihat berbeda saat dijalankan dengan ekspresi.

Saat ini, satu-satunya format seri non-waktu (angka) yang didukung saat menggunakan bingkai data adalah Anda memiliki respons tabel yang mengembalikan bingkai data tanpa waktu, kolom string, dan satu kolom angka:

Contoh tabel berikut menghasilkan angka yang bekerja dengan ekspresi. Kolom string menjadi label dan kolom nomor nilai yang sesuai. Misalnya `{"Loc": "MIA", "Host": "A"}` dengan nilai 1.


| Loc | Host | AVG\$1CPU | 
| --- | --- | --- | 
| MIA | A | 1 | 
| NYC | B | 2 | 

**Operasi**

Anda dapat menggunakan operasi berikut dalam ekspresi: matematika, kurangi, dan sampel ulang.

**Matematika**

Matematika adalah untuk rumus matematika bentuk bebas pada deret waktu atau data angka. Operasi matematika mengambil angka dan deret waktu sebagai masukan dan mengubahnya menjadi angka dan deret waktu yang berbeda.

Data dari kueri atau ekspresi lain direferensikan dengan awalan ReFID dengan tanda dolar, misalnya. `$A` Jika variabel memiliki spasi dalam nama, maka Anda dapat menggunakan sintaks kurung kurung seperti. `${my variable}`

Konstanta numerik bisa dalam desimal (`2.24`), oktal (dengan nol terkemuka seperti`072`), atau hex (dengan seperti 0x terkemuka). `0x2A` Eksponensial dan tanda juga didukung (misalnya,). `-0.8e-2`

**Operator**

Operator aritmatika (`+`, biner dan unary`-`,,`*`,`/`,`%`, eksponen`**`), relasional (,`<`,,,`>`,`<=`) `==``!=`, `>=` dan logis (,, dan unary) `&&` didukung`||`. `!`

Bagaimana operasi berperilaku dengan data tergantung pada apakah itu adalah data angka atau deret waktu.

Dengan operasi biner`$A || $B`, seperti `$A + $B` atau, operator diterapkan dengan cara berikut tergantung pada jenis data:
+ Jika keduanya `$A` dan `$B` merupakan angka, maka operasi dilakukan antara dua angka.
+ Jika satu variabel adalah angka, dan variabel lainnya adalah deret waktu, maka operasi antara nilai setiap titik dalam deret waktu dan angka dilakukan.
+ Jika keduanya `$A` dan `$B` merupakan data deret waktu, maka operasi antara setiap nilai dalam dua seri dilakukan untuk setiap cap waktu yang ada di keduanya `$A` dan`$B`. `Resample`Operasi ini dapat digunakan untuk menyusun stempel waktu.

Ringkasan:
+ Nomor <Operation>nomor = angka
+ Nomor <Operation>seri = seri
+ Seri <Operation>seri = seri

Karena ekspresi bekerja dengan beberapa seri atau angka yang diwakili oleh satu variabel, operasi biner juga melakukan penyatuan (gabungan) antara dua variabel. Ini dilakukan berdasarkan label pengenal yang terkait dengan setiap seri atau nomor individu.

Jadi jika Anda memiliki angka dengan label seperti `{host=web01}` in `$A` dan nomor lain `$B` dengan label yang sama maka operasi dilakukan antara dua item dalam setiap variabel, dan hasilnya akan berbagi label yang sama. Aturan untuk perilaku serikat ini adalah sebagai berikut:
+ Item tanpa label akan bergabung dengan apa pun.
+ Jika keduanya `$A` dan `$B` masing-masing hanya berisi satu item (satu seri, atau satu nomor), mereka akan bergabung.
+ Jika label sama persis, mereka akan bergabung.
+ Jika label adalah bagian dari yang lain, misalnya item di `$A` diberi label `{host=A,dc=MIA}` dan item di `$B` diberi label, `{host=A}` mereka akan bergabung.
+ Jika dalam variabel seperti `$A` ada kunci tag yang berbeda untuk setiap item, perilaku bergabung tidak terdefinisi.

Operator relasional dan logis mengembalikan 0 untuk false 1 untuk true.

**Fungsi Matematika**

Sementara sebagian besar fungsi ada dalam operasi ekspresi sendiri, operasi matematika memang memiliki beberapa fungsi yang mirip dengan operator matematika atau simbol. Ketika fungsi dapat mengambil angka atau seri, dari jenis yang sama dengan argumen akan dikembalikan. Ketika itu adalah seri, operasi dilakukan untuk nilai setiap titik dalam seri.

*perut*

abs mengembalikan nilai absolut dari argumennya yang dapat berupa angka atau seri. Misalnya, `abs(-1)` atau `abs($A)`.

*is\$1inf*

is\$1inf mengambil angka atau seri dan mengembalikan `1` `Inf` nilai (negatif atau positif) dan `0` untuk nilai lainnya. Sebagai contoh, `is_inf($A)`.

**catatan**  
Jika Anda perlu secara khusus memeriksa ketidakterbatasan negatif misalnya, Anda dapat melakukan perbandingan seperti`$A == infn()`.

*is\$1nan*

is\$1nan mengambil angka atau seri dan mengembalikan `1` `NaN` nilai dan `0` nilai lainnya. Sebagai contoh, `is_nan($A)`. Fungsi ini diperlukan untuk pemeriksaan ini karena `NaN` tidak sama dengan`NaN`.

*adalah\$1null*

is\$1null mengambil angka atau seri dan mengembalikan `1` `null` nilai dan nilai lainnya`0`. Sebagai contoh, `is_null($A)`.

*is\$1number*

is\$1number mengambil angka atau seri dan mengembalikan `1` untuk semua nilai bilangan real dan `0` untuk nilai lainnya (yaitu`null`,, `Inf+``Inf-`, dan`NaN`). Sebagai contoh, `is_number($A)`.

*log*

Log mengembalikan logaritma natural dari argumennya yang dapat berupa angka atau seri. Jika nilainya kurang dari 0, `NaN` dikembalikan. Misalnya, `log(-1)` atau `log($A)`.

*inf, infn, nan, dan null*

Fungsi inf, infn, nan, dan null semuanya mengembalikan satu nilai nama. Mereka terutama ada untuk pengujian. Contoh:`null()`.

*bulat*

Round mengembalikan nilai integer bulat. Misalnya, `round(3.123)` atau `round($A)`.

*ceil*

Ceil membulatkan angka ke nilai integer terdekat. Misalnya, `ceil(3.123)` mengembalikan `4`.

*lantai*

Lantai membulatkan angka ke bawah ke nilai integer terdekat. Misalnya,`floor(3.123`) kembali`3`.

**Mengurangi**

Reduce mengambil satu atau lebih deret waktu yang dikembalikan dari kueri atau ekspresi dan mengubah setiap seri menjadi satu nomor. Label deret waktu disimpan sebagai label pada setiap angka yang dikurangi yang dikeluarkan.

*Bidang:*
+ **Fungsi — Fungsi** reduksi yang digunakan
+ **Input** - Variabel (ReFID (seperti`A`)) untuk sampel ulang
+ **Mode** - Memungkinkan perilaku kontrol fungsi reduksi ketika seri berisi nilai non-numerik (null, NaN, \$1-Inf)

**Fungsi Reduksi**

*Hitungan*

Hitung mengembalikan jumlah poin di setiap seri.

*Berarti*

Mean mengembalikan total semua nilai dalam setiap seri dibagi dengan jumlah poin dalam seri itu. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Min dan Max*

Min dan Max mengembalikan nilai terkecil atau terbesar dalam seri masing-masing. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Jumlah*

Jumlah mengembalikan total semua nilai dalam seri. Jika seri memiliki panjang nol, jumlahnya akan menjadi 0. Dalam `strict` mode jika ada nilai NaN atau Null dalam seri, NaN dikembalikan.

*Terakhir*

Terakhir mengembalikan nomor terakhir dalam seri. Jika seri tidak memiliki nilai maka kembali NaN.

**Mode Pengurangan**

*Ketat*

Dalam mode Ketat, seri input diproses apa adanya. Jika ada nilai dalam seri non-numerik (null, NaN atau \$1-Inf), NaN dikembalikan.

*Jatuhkan Non-Numerik*

Dalam mode ini semua nilai non-numerik (null, NaN atau \$1-Inf) dalam seri input disaring sebelum menjalankan fungsi reduksi.

*Ganti Non-Numerik*

Dalam mode ini semua nilai non-numerik diganti dengan nilai yang telah ditentukan sebelumnya.

**Sampel ulang**

Sampel ulang mengubah stempel waktu di setiap deret waktu agar memiliki interval waktu yang konsisten. Kasus penggunaan utama adalah agar Anda dapat mengambil sampel ulang deret waktu yang tidak berbagi stempel waktu yang sama sehingga matematika dapat dilakukan di antara mereka. Ini dapat dilakukan dengan mengambil sampel ulang masing-masing dari dua seri, dan kemudian dalam operasi Matematika yang merujuk variabel sampel ulang.

*Bidang:*
+ **Input** - Variabel data deret waktu (ReFID (seperti`A`)) untuk sampel ulang
+ **Sampel ulang** ke — Durasi waktu untuk melakukan resample ke, misalnya. `10s` Unit bisa `s` untuk detik, `m` menit, `h` berjam-jam, `d` berhari-hari, `w` berminggu-minggu, dan `y` bertahun-tahun.
+ **Downsample** - Fungsi reduksi untuk digunakan ketika ada lebih dari satu titik data per sampel jendela. Lihat operasi reduksi untuk detail perilaku.
+ **Upsample** — Metode yang digunakan untuk mengisi sampel jendela yang tidak memiliki titik data.
  + **pad** diisi dengan nilai knowm terakhir
  + **isi ulang** dengan nilai yang diketahui berikutnya
  + **fillna** untuk mengisi jendela sampel kosong dengan NaNs

## Tulis ekspresi
<a name="v10-panels-query-write"></a>

Jika sumber data Anda mendukungnya, Grafana menampilkan tombol **Ekspresi dan menampilkan ekspresi** yang ada dalam daftar editor kueri.

**Untuk menulis ekspresi**

1. Buka panelnya.

1. Di bawah kueri, pilih **Ekspresi**.

1. Di bidang **Operasi**, pilih jenis ekspresi yang ingin Anda tulis.

1. Tulis ekspresinya.

1. Pilih **Terapkan**.

## Kasus khusus
<a name="v10-panels-query-special"></a>

Ketika sumber data yang ditanyakan tidak mengembalikan seri atau angka, mesin ekspresi kembali`NoData`. Misalnya, jika permintaan berisi dua kueri sumber data yang digabungkan dengan ekspresi, jika `NoData` dikembalikan oleh setidaknya salah satu kueri sumber data, maka hasil yang dikembalikan untuk seluruh kueri adalah. `NoData` Untuk informasi selengkapnya tentang cara Grafana Alerting memproses `NoData` hasil, lihat. [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md)

Dalam kasus menggunakan ekspresi pada beberapa kueri, mesin ekspresi mengharuskan semua kueri mengembalikan stempel waktu yang identik. Misalnya, jika menggunakan matematika untuk menggabungkan hasil beberapa kueri SQL yang digunakan masing-masing`SELECT NOW() AS "time"`, ekspresi hanya akan berfungsi jika semua kueri mengevaluasi `NOW()` ke stempel waktu yang identik, yang tidak selalu terjadi. Untuk mengatasi hal ini, Anda dapat mengganti `NOW()` dengan waktu sewenang-wenang, seperti`SELECT 1 AS "time"`, atau stempel waktu UNIX valid lainnya.

# Bagikan hasil kueri dengan panel lain
<a name="v10-panels-query-share"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana memungkinkan Anda menggunakan hasil kueri dari satu panel untuk panel lain di dasbor. Berbagi hasil kueri di seluruh panel mengurangi jumlah kueri yang dibuat ke sumber data Anda, yang dapat meningkatkan kinerja dasbor Anda.

Sumber data *Dasbor* memungkinkan Anda memilih panel di dasbor yang berisi kueri yang ingin Anda bagikan hasilnya. Alih-alih mengirim kueri terpisah untuk setiap panel, Grafana mengirim satu kueri dan panel lainnya menggunakan hasil kueri untuk membangun visualisasi.

Strategi ini dapat secara drastis mengurangi jumlah kueri yang dibuat ketika Anda misalnya memiliki beberapa panel yang memvisualisasikan data yang sama.

**Untuk berbagi hasil kueri**

1. [Buat dasbor](v10-dash-creating.md).

1. Ubah judul menjadi`Source panel`. Anda akan menggunakan panel ini sebagai sumber untuk panel lainnya.

1. Tentukan kueri atau kueri yang ingin Anda bagikan.

   Jika Anda tidak memiliki sumber data yang tersedia, gunakan sumber data **Grafana**, yang mengembalikan deret waktu acak yang dapat Anda gunakan untuk pengujian.

1. Tambahkan panel kedua dan pilih sumber data **Dasbor** di editor kueri.

1. Dalam **daftar Gunakan hasil dari panel**, pilih panel pertama yang Anda buat.

Semua query didefinisikan dalam panel sumber sekarang tersedia untuk panel baru. Kueri yang dibuat di panel sumber dapat dibagikan dengan beberapa panel.

Anda dapat mengklik salah satu kueri untuk pergi ke panel tempat mereka ditentukan.

# Mengubah data
<a name="v10-panels-xform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Transformasi adalah cara ampuh untuk memanipulasi data yang dikembalikan oleh kueri sebelum sistem menerapkan visualisasi. Menggunakan transformasi, Anda dapat:
+ Ganti nama bidang
+ Bergabunglah dengan data deret waktu
+ Lakukan operasi matematika di seluruh kueri
+ Gunakan output dari satu transformasi sebagai masukan ke transformasi lain

Untuk pengguna yang mengandalkan beberapa tampilan dari kumpulan data yang sama, transformasi menawarkan metode yang efisien untuk membuat dan memelihara banyak dasbor.

Anda juga dapat menggunakan output dari satu transformasi sebagai masukan ke transformasi lain, yang menghasilkan peningkatan kinerja.

**catatan**  
Terkadang sistem tidak dapat membuat grafik data yang ditransformasikan. Ketika itu terjadi, klik tombol **Tampilan tabel** di atas visualisasi untuk beralih ke tampilan tabel data. Ini dapat membantu Anda memahami hasil akhir dari transformasi Anda.

## Jenis transformasi
<a name="v10-panels-xform-types"></a>

Grafana menyediakan sejumlah cara agar Anda dapat mengubah data. Ada daftar lengkap fungsi transformasi di bawah ini.

## Urutan transformasi
<a name="v10-panels-xform-order"></a>

Ketika ada beberapa transformasi, Grafana menerapkannya dalam urutan yang terdaftar. Setiap transformasi menciptakan set hasil yang kemudian diteruskan ke transformasi berikutnya dalam pipa pemrosesan.

Urutan di mana Grafana menerapkan transformasi secara langsung berdampak pada hasil. Misalnya, jika Anda menggunakan transformasi Reduce untuk memadatkan semua hasil dari satu kolom menjadi satu nilai, maka Anda hanya dapat menerapkan transformasi ke nilai tunggal itu.

## Menambahkan fungsi transformasi ke data
<a name="v10-panels-xform-add"></a>

Langkah-langkah berikut memandu Anda dalam menambahkan transformasi ke data. Dokumentasi ini tidak menyertakan langkah-langkah untuk setiap jenis transformasi.

**Untuk menambahkan transformasi ke panel**

1. Arahkan ke panel tempat Anda ingin menambahkan satu atau lebih transformasi.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Dari menu tindakan pilih **Edit**.

1. Pilih tab **Transform**.

1. Pilih transformasi. Baris transformasi muncul di mana Anda mengonfigurasi opsi transformasi.

1. Untuk menerapkan transformasi lain, Pilih **Tambahkan transformasi**. Transformasi ini bekerja pada set hasil yang dikembalikan oleh transformasi sebelumnya.

## Debug transformasi
<a name="v10-panels-xform-debug"></a>

Untuk melihat input dan set hasil output transformasi, pilih ikon debug (bug) di sisi kanan baris transformasi. Ini akan menampilkan data input, dan hasil transformasi sebagai output.

Set hasil input dan output dapat membantu Anda men-debug transformasi.

## Nonaktifkan transformasi
<a name="v10-panels-xform-disable"></a>

Anda dapat menonaktifkan atau menyembunyikan transformasi dengan memilih ikon show (eye) di kanan atas baris transformasi. Ini menonaktifkan tindakan yang diterapkan dari transformasi spesifik itu dan dapat membantu mengidentifikasi masalah ketika Anda mengubah beberapa transformasi satu demi satu.

## Filter transformasi
<a name="v10-panels-xform-filter"></a>

Jika transformasi Anda menggunakan lebih dari satu kueri, Anda dapat memfilter ini, dan menerapkan transformasi yang dipilih hanya ke salah satu kueri. Untuk melakukan ini, pilih ikon filter di kanan atas baris transformasi. Ini membuka dropdown dengan daftar query yang digunakan pada panel. Dari sini, Anda dapat memilih kueri yang ingin Anda ubah.

Anda juga dapat memfilter berdasarkan anotasi (yang mencakup contoh) untuk menerapkan transformasi padanya. Ketika Anda melakukannya, daftar bidang berubah untuk mencerminkan yang ada dalam anotasi atau tooltip contoh.

Ikon filter selalu ditampilkan jika panel Anda memiliki lebih dari satu kueri atau sumber data (yaitu data panel atau anotasi), tetapi mungkin tidak berfungsi jika transformasi sebelumnya untuk menggabungkan output kueri diterapkan. Ini karena satu transformasi mengambil output dari yang sebelumnya.

## Hapus transformasi
<a name="v10-panels-xform-delete"></a>

Kami menyarankan Anda menghapus transformasi yang tidak Anda butuhkan. Saat Anda menghapus transformasi, Anda menghapus data dari visualisasi.

Prasyarat:

Identifikasi semua dasbor yang bergantung pada transformasi dan informasikan pengguna dasbor yang terkena dampak.

**Untuk menghapus transformasi**

1. Buka panel untuk mengedit.

1. Pilih tab **Transform**.

1. Pilih ikon sampah di sebelah transformasi yang ingin Anda hapus.

# Fungsi transformasi
<a name="v10-panels-xform-functions"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat melakukan transformasi berikut pada data Anda.

## Tambahkan bidang dari perhitungan
<a name="v10-panels-xform-funcs-add"></a>

Gunakan transformasi ini untuk menambahkan bidang baru yang dihitung dari dua bidang lainnya. Setiap transformasi memungkinkan Anda menambahkan satu bidang baru.
+ **Mode** - Pilih mode:
  + **Kurangi baris** - Terapkan perhitungan yang dipilih pada setiap baris bidang yang dipilih secara independen.
  + **Operasi biner** — Terapkan operasi biner dasar (misalnya, jumlah atau kalikan) pada nilai dalam satu baris dari dua bidang yang dipilih.
  + **Operasi unary** - Terapkan operasi unary dasar pada nilai dalam satu baris dari bidang yang dipilih. Operasi yang tersedia adalah:
    + **Nilai absolut (abs)** — Mengembalikan nilai absolut dari ekspresi yang diberikan. Ini mewakili jarak dari nol sebagai angka positif.
    + **Eksponensial alami (exp)** — Mengembalikan *e* dinaikkan ke kekuatan ekspresi yang diberikan.
    + **Logaritma natural (ln)** — Mengembalikan logaritma natural dari ekspresi yang diberikan.
    + **Floor (floor)** — Mengembalikan bilangan bulat terbesar kurang dari atau sama dengan ekspresi yang diberikan.
    + **Ceiling (ceil)** — mengembalikan bilangan bulat terkecil yang lebih besar dari atau sama dengan ekspresi yang diberikan.
  + **Fungsi kumulatif** — Terapkan fungsi pada baris saat ini dan semua baris sebelumnya.
    + **Total** — Menghitung total kumulatif hingga dan termasuk baris saat ini.
    + **Mean** — Menghitung mean hingga dan termasuk baris saat ini.
  + **Fungsi jendela** - Terapkan fungsi jendela. Jendela bisa *tertinggal atau *terpusat**. Dengan jendela trailing baris saat ini akan menjadi baris terakhir di jendela. Dengan jendela tengah, jendela akan dipusatkan pada baris saat ini. Untuk ukuran jendela genap, jendela akan berada di tengah antara baris saat ini dan baris sebelumnya.
    + **Mean** — Menghitung rata-rata bergerak atau rata-rata berjalan.
    + ****— Menghitung deviasi standar bergerak.
    + **Varians** — Hitung varians bergerak.
  + **Indeks baris** - Sisipkan bidang dengan indeks baris.
+ **Nama bidang** - Pilih nama bidang yang ingin Anda gunakan dalam perhitungan untuk bidang baru.
+ **Perhitungan** - Jika Anda memilih mode **Kurangi baris**, maka bidang **Perhitungan** akan muncul. Pilih bidang untuk melihat daftar pilihan perhitungan yang dapat Anda gunakan untuk membuat bidang baru. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).
+ **Operasi** — Jika Anda memilih **operasi biner** atau mode **operasi Unary**, maka bidang **Operasi** akan muncul. Bidang ini memungkinkan Anda melakukan operasi matematika dasar pada nilai dalam satu baris dari dua bidang yang dipilih. Anda juga dapat menggunakan nilai numerik untuk operasi biner.
+ **Sebagai persentil** — Jika Anda memilih mode **indeks baris**, maka sakelar **persentil As** muncul. Sakelar ini memungkinkan Anda untuk mengubah indeks baris sebagai persentase dari jumlah total baris.
+ **Alias** — (Opsional) Masukkan nama bidang baru Anda. Jika Anda membiarkan ini kosong, maka bidang akan diberi nama agar sesuai dengan perhitungan.
+ **Ganti semua bidang** — (Opsional) Pilih opsi ini jika Anda ingin menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi.

**catatan**  
Fungsi **kumulatif dan fungsi** **Jendela** saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

## Bidang gabungan
<a name="v10-panels-xform-funcs-concat"></a>

**Bidang gabungan**

Gunakan transformasi ini untuk menggabungkan semua bidang dari semua frame menjadi satu hasil.

Misalnya, jika Anda memiliki kueri terpisah yang mengambil data suhu dan waktu aktif (kueri A) dan indeks kualitas udara dan informasi kesalahan (kueri b), menerapkan transformasi gabungan menghasilkan kerangka data terkonsolidasi dengan semua informasi yang relevan dalam satu tampilan.

Pertimbangkan dua berikut ini.

*Kueri A:*


| Temp | Uptime | 
| --- | --- | 
| 15.4 | 1230233 | 

*Kueri B:*


| AQI | Kesalahan | 
| --- | --- | 
| 3.2 | 5 | 

Setelah Anda menggabungkan bidang, bingkai data akan menjadi:


| Temp | Uptime | AQI | Kesalahan | 
| --- | --- | --- | --- | 
| 15.4 | 1230233 | 3.2 | 5 | 

Transformasi ini menyederhanakan proses penggabungan data dari berbagai sumber, memberikan pandangan komprehensif untuk analisis dan visualisasi.

## Config dari hasil kueri
<a name="v10-panels-xform-funcs-config"></a>

**Config dari hasil kueri**

Gunakan transformasi ini untuk memilih satu kueri dan mengekstrak opsi standar seperti **Min**, **Max**, **Unit** dan **Thresholds** dan menerapkannya ke hasil kueri lainnya. Ini memungkinkan konfigurasi visualisasi dinamis, berdasarkan data yang dikembalikan oleh kueri tertentu.

**Pilihan**
+ **Query Config** - Pilih kueri yang mengembalikan data yang ingin Anda gunakan sebagai konfigurasi.
+ **Terapkan ke** - Pilih bidang atau seri yang konfigurasi harus diterapkan.
+ **Terapkan ke opsi** - Tentukan jenis bidang atau gunakan nama bidang regex, tergantung pada pilihan Anda di **Terapkan** ke.

**Tabel pemetaan lapangan**

Di bawah opsi konfigurasi, Anda akan menemukan tabel pemetaan bidang. Tabel ini mencantumkan semua bidang yang ditemukan dalam data yang dikembalikan oleh kueri konfigurasi, bersama dengan opsi **Gunakan sebagai** dan **Pilih**. Ini memberikan kontrol atas bidang pemetaan ke properti konfigurasi, dan untuk beberapa baris, ini memungkinkan Anda untuk memilih nilai mana yang akan dipilih.

Contoh berikut menunjukkan query input dan query yang digunakan sebagai konfigurasi bidang.

*Permintaan masukan*


| Waktu | Nilai | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*Kueri Config*


| Waktu | Nilai | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*Kueri keluaran (sama seperti input, tetapi sekarang dengan konfigurasi pada bidang nilai)*


| Waktu | Nilai (konfigurasi: Maks = 100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

Setiap bidang sekarang memiliki set opsi konfigurasi maksimum. Pilihan seperti **Min**, **Max**, **Unit**, dan **Thresholds** adalah bagian dari konfigurasi lapangan. Jika diatur, mereka digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

**Pemetaan nilai**

Anda juga dapat mengubah hasil kueri menjadi pemetaan nilai. Dengan opsi ini, setiap baris dalam hasil kueri konfigurasi mendefinisikan satu baris pemetaan nilai. Lihat contoh berikut ini.

*Hasil kueri Config*


| Nilai | Teks | Warna | 
| --- | --- | --- | 
| L | Rendah | biru | 
| M | Sedang | hijau | 
| H | Tinggi | merah | 

*Dalam pemetaan bidang, tentukan:*


| Bidang | Gunakan sebagai | Pilih | 
| --- | --- | --- | 
| Nilai | Pemetaan nilai/Nilai | Semua nilai | 
| Teks | Pemetaan nilai/Teks | Semua nilai | 
| Warna | Pemetaan nilai/Warna | Semua nilai | 

Grafana membangun pemetaan nilai dari hasil kueri Anda dan menerapkannya ke hasil kueri data nyata. Anda akan melihat nilai yang dipetakan dan diwarnai sesuai dengan hasil kueri konfigurasi.

## Mengkonversi jenis bidang
<a name="v10-panels-xform-funcs-convert"></a>

Gunakan transformasi ini untuk memodifikasi jenis bidang bidang yang ditentukan.

Transformasi ini memiliki opsi berikut:
+ **Bidang** - Pilih dari bidang yang tersedia.
+ **as** — Pilih FieldType untuk dikonversi ke.
  + **Numerik** — mencoba untuk membuat angka nilai.
  + **String** - akan membuat nilai string.
  + **Waktu** — mencoba mengurai nilai sebagai waktu.
    + Akan menampilkan opsi untuk menentukan DateFormat sebagai input oleh string, seperti `yyyy-mm-dd` atau`DD MM YYYY hh:mm:ss`.
  + **Boolean** - akan membuat nilai-nilai Boolean.
  + **Enum** — akan membuat nilai enum.
    + Akan menampilkan tabel untuk mengelola enum.
  + **Lainnya** — mencoba mengurai nilai sebagai json.

Misalnya pertimbangkan kueri berikut yang dapat dimodifikasi dengan memilih bidang waktu, sebagai **Waktu**, dan Format Tanggal sebagai`YYYY`.


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
| 2017-07-01 | atas | 25 | 
| 2018-08-02 | di bawah ini | 22 | 
| 2019-09-02 | di bawah ini | 29 | 
| 2020-10-04 | atas | 22 | 

Hasilnya:


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | atas | 25 | 
| 2018-01-01 00:00:00 | di bawah ini | 22 | 
| 2019-01-01 00:00:00 | di bawah ini | 29 | 
| 2020-01-01 00:00:00 | atas | 22 | 

Transformasi ini memungkinkan Anda untuk secara fleksibel menyesuaikan tipe data Anda, memastikan kompatibilitas dan konsistensi dalam visualisasi Anda.

## Ekstrak Bidang
<a name="v10-panels-xform-funcs-extract"></a>

Gunakan transformasi ini untuk memilih sumber data dan mengekstrak konten darinya dalam format yang berbeda. Transformasi ini memiliki bidang-bidang berikut:
+ **Sumber** — Pilih bidang untuk sumber data.
+ **Format** - Pilih salah satu dari berikut ini:
  + **JSON** - Parse konten JSON dari sumbernya.
  + **Pasangan kunci\$1nilai** — Parse konten dalam format `a=b` atau `c:d` dari sumber.
  + **Otomatis** — Temukan bidang secara otomatis.
+ **Ganti Semua Bidang** - (Opsional) Pilih opsi ini untuk menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi.
+ **Pertahankan Waktu** - (Opsional) Hanya tersedia jika **Ganti Semua Bidang** benar. Menyimpan bidang waktu dalam output.

Pertimbangkan kumpulan data berikut:

**Contoh Dataset**


| Stempel waktu | json\$1data | 
| --- | --- | 
| 1636678740000000000 | \$1"nilai”: 1\$1 | 
| 1636678680000000000 | \$1"nilai”: 5\$1 | 
| 1636678620000000000 | \$1"nilai”: 12\$1 | 

Anda dapat menyiapkan data yang akan digunakan oleh [panel Time series](v10-panels-time-series.md) dengan konfigurasi ini:
+ Sumber: json\$1data
+ Format: JSON
  + Bidang: nilai
  + Alias: my\$1value
+ Ganti semua bidang: true
+ Pertahankan waktu: benar

Ini akan menghasilkan output sebagai berikut:

**Data yang Diubah**


| Stempel waktu | nilai\$1my\$1 | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

Dengan transformasi ini, Anda dapat mengekstrak dan memformat data dengan berbagai cara. Anda dapat menyesuaikan format ekstraksi berdasarkan kebutuhan data spesifik Anda.

## Bidang pencarian dari sumber daya
<a name="v10-panels-xform-funcs-lookup"></a>

Gunakan transformasi ini untuk memperkaya nilai bidang dengan mencari bidang tambahan dari sumber eksternal.

Transformasi ini memiliki bidang-bidang berikut:
+ **Bidang** - Pilih bidang teks dari kumpulan data Anda.
+ **Pencarian** — Pilih dari **Negara, Negara** **Bagian AS**, dan **Bandara**.

**catatan**  
Transformasi ini hanya mendukung data spasial.

Misalnya, jika Anda memiliki data ini:

**Contoh Dataset**


| Lokasi | Nilai | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Di suatu tempat | 5 | 

Dengan konfigurasi ini:
+ Bidang: lokasi
+ Pencarian: Amerika Serikat

Anda akan mendapatkan output sebagai berikut:

**Data yang Diubah**


| Lokasi | ID | Nama | Lng | Lat | Nilai | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80.891064 | 12.448457 | 0 | 
| AK | AK | Arkansas | -100.891064 | 24.448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Di suatu tempat |  |  |  |  | 5 | 

Transformasi ini memungkinkan Anda menambah data Anda dengan mengambil informasi tambahan dari sumber eksternal, menyediakan kumpulan data yang lebih komprehensif untuk analisis dan visualisasi.

## Filter data berdasarkan kueri ReFID
<a name="v10-panels-xform-funcs-queryrefid"></a>

Gunakan transformasi ini untuk menyembunyikan satu atau beberapa kueri di panel yang memiliki beberapa kueri.

Grafana menampilkan surat identifikasi kueri dalam teks abu-abu gelap. Pilih pengenal kueri untuk beralih pemfilteran. Jika surat kueri berwarna putih, maka hasilnya ditampilkan. Jika surat kueri gelap, maka hasilnya disembunyikan.

**catatan**  
Transformasi ini tidak tersedia untuk Graphite karena sumber data ini tidak mendukung korelasi data yang dikembalikan dengan kueri.

## Filter data berdasarkan nilai
<a name="v10-panels-xform-funcs-values"></a>

Gunakan transformasi ini untuk secara selektif memfilter titik data langsung dalam visualisasi Anda. Transformasi ini menyediakan opsi untuk menyertakan atau mengecualikan data berdasarkan satu atau beberapa kondisi yang diterapkan pada bidang yang dipilih.

Transformasi ini sangat berguna jika sumber data Anda tidak secara native memfilter berdasarkan nilai. Anda juga dapat menggunakan ini untuk mempersempit nilai untuk ditampilkan jika Anda menggunakan kueri bersama.

Kondisi yang tersedia untuk semua bidang adalah:
+ **Regex - Cocokkan ekspresi regex**.
+ **Apakah Null** — Cocokkan jika nilainya nol.
+ **Is Not Null** — Cocokkan jika nilainya tidak null.
+ **Sama** - Cocokkan jika nilainya sama dengan nilai yang ditentukan.
+ **Berbeda** - Cocokkan jika nilainya berbeda dari nilai yang ditentukan.

Ketentuan tambahan yang tersedia untuk bidang angka adalah:
+ **Lebih besar** — Cocokkan jika nilainya lebih besar dari nilai yang ditentukan.
+ **Lower** — Cocokkan jika nilainya lebih rendah dari nilai yang ditentukan.
+ **Lebih besar atau sama** — Cocokkan jika nilainya lebih besar atau sama.
+ **Lebih rendah atau sama** — Cocokkan jika nilainya lebih rendah atau sama.
+ **Rentang** - Cocokkan rentang antara minimum dan maksimum yang ditentukan, termasuk min dan maks.

Pertimbangkan kumpulan data berikut:


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Jika Anda **Sertakan** titik data yang memiliki suhu di bawah 30° C, konfigurasi akan terlihat sebagai berikut:
+ Jenis Filter: 'Sertakan'
+ Kondisi: Baris di mana 'Suhu' cocok dengan 'Lebih Rendah Dari' '30'

Dan Anda akan mendapatkan hasil berikut, di mana hanya suhu di bawah 30° C yang disertakan:

**Data yang Diubah**


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Anda dapat menambahkan lebih dari satu kondisi ke filter. Misalnya, Anda mungkin ingin memasukkan data hanya jika ketinggiannya lebih besar dari 100. Untuk melakukannya, tambahkan kondisi itu ke konfigurasi berikut:
+ Jenis filter: 'Sertakan' baris yang kondisi 'Cocokkan Semua'
+ Kondisi 1: Baris di mana 'Suhu' cocok dengan 'Lebih Rendah' dari '30'
+ Kondisi 2: Baris di mana 'Ketinggian' cocok dengan 'Lebih Besar' dari '100'

Bila Anda memiliki lebih dari satu kondisi, Anda dapat memilih apakah Anda ingin tindakan (sertakan/kecualikan) diterapkan pada baris yang **Cocokkan semua kondisi atau Cocokkan** **salah** satu kondisi yang Anda tambahkan.

Pada contoh di atas, kami memilih **Match all** karena kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30° C *DAN* ketinggian lebih tinggi dari 100. Jika kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30° C *ATAU* ketinggian lebih tinggi dari 100 sebagai gantinya, maka kami akan memilih **Match any**. Ini akan mencakup baris pertama dalam data asli, yang memiliki suhu 32° C (tidak cocok dengan kondisi pertama) tetapi ketinggian 101 (yang cocok dengan kondisi kedua), sehingga disertakan.

Kondisi yang tidak valid atau tidak lengkap dikonfigurasi diabaikan.

Transformasi pemfilteran data serbaguna ini memungkinkan Anda memasukkan atau mengecualikan titik data secara selektif berdasarkan kondisi tertentu. Sesuaikan kriteria untuk menyesuaikan presentasi data Anda untuk memenuhi kebutuhan analitis unik Anda.

## Filter bidang berdasarkan nama
<a name="v10-panels-xform-funcs-name"></a>

Gunakan transformasi ini untuk menghapus bagian dari hasil kueri Anda. Ada tiga cara untuk memfilter nama bidang:
+ Masukkan ekspresi reguler.
+ Pilih bidang yang disertakan secara manual.
+ Gunakan variabel dasbor.

*Gunakan ekspresi reguler*

Saat Anda memfilter menggunakan ekspresi reguler, nama bidang yang cocok dengan ekspresi reguler disertakan. Misalnya, menggunakan ekspresi reguler hanya `'prod.*'` akan mengembalikan bidang yang dimulai `prod`

Ekspresi reguler dapat menyertakan variabel dasbor yang diinterpolasi menggunakan sintaks. `${variableName}`

*Pilih bidang yang disertakan secara manual*

Pilih atau batal pilihan nama bidang untuk menghapusnya dari hasil. Jika ekspresi reguler juga disertakan, bidang yang cocok dengan ekspresi akan disertakan, meskipun tidak dicentang.

*Gunakan variabel dasbor*

Pilih **Dari variabel** untuk memungkinkan Anda memilih variabel dasbor yang digunakan untuk menyertakan bidang. Dengan menyiapkan variabel dasbor dengan beberapa pilihan, bidang yang sama dapat ditampilkan di beberapa visualisasi.

Transformasi ini memberikan fleksibilitas dalam menyesuaikan hasil kueri Anda agar fokus pada bidang spesifik yang Anda butuhkan untuk analisis dan visualisasi yang efektif.

## Format string
<a name="v10-panels-xform-funcs-string"></a>

Gunakan transformasi ini untuk menyesuaikan output dari bidang string. Transformasi ini memiliki bidang-bidang berikut:
+ **Huruf** besar - Memformat seluruh string dalam karakter huruf besar.
+ **Huruf** kecil - Memformat seluruh string dalam karakter huruf kecil.
+ **Kasus kalimat** - Memformat karakter pertama string dalam huruf besar.
+ **Kasus judul** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar.
+ **Kasus Pascal** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar dan tidak menyertakan spasi di antara kata-kata.
+ **Kasus unta** - Memformat karakter pertama dari setiap kata dalam string dalam huruf besar, kecuali kata pertama, dan tidak termasuk spasi di antara kata-kata.
+ **Kasus ular** - Memformat semua karakter dalam string dalam huruf kecil dan menggunakan garis bawah alih-alih spasi di antara kata-kata.
+ **Kasus keb** — Memformat semua karakter dalam string dalam huruf kecil dan menggunakan tanda hubung alih-alih spasi di antara kata-kata.
+ **Trim** - Menghapus semua spasi depan dan belakang dari string.
+ **Substring** - Mengembalikan substring string, menggunakan posisi awal dan akhir yang ditentukan.

Transformasi ini menyediakan cara mudah untuk membakukan dan menyesuaikan penyajian data string untuk visualisasi dan analisis yang lebih baik.

**catatan**  
Transformasi ini saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

## Format waktu
<a name="v10-panels-xform-funcs-time"></a>

Gunakan transformasi ini untuk menyesuaikan output dari bidang waktu. Output dapat diformat menggunakan [string format Moment.js](https://momentjs.com/docs/#/displaying/). Misalnya, jika Anda hanya ingin menampilkan tahun bidang waktu, string format 'YYYY' dapat digunakan untuk menampilkan tahun kalender (misalnya, 1999 atau 2012).

**Sebelum Transformasi:**


| Stempel waktu | Peristiwa | 
| --- | --- | 
| 1636678740000000000 | Sistem Mulai | 
| 1636678680000000000 | Login Pengguna | 
| 1636678620000000000 | Data Diperbarui | 

**Setelah menerapkan 'YYYY-MM-DD HH: mm: SS':**


| Stempel waktu | Peristiwa | 
| --- | --- | 
| 2021-11-12 14:25:40 | Sistem Mulai | 
| 2021-11-12 14:24:40 | Login Pengguna | 
| 2021-11-12 14:23:40 | Data Diperbarui | 

Transformasi ini memungkinkan Anda menyesuaikan representasi waktu dalam visualisasi Anda, memberikan fleksibilitas dan presisi dalam menampilkan data temporal.

**catatan**  
Transformasi ini tersedia di ruang kerja compatbile dengan Grafana v10 sebagai fitur alfa.

## Grup oleh
<a name="v10-panels-xform-funcs-group"></a>

Transformasi ini mengelompokkan data dengan nilai bidang (kolom) tertentu dan memproses perhitungan pada setiap grup. Pilih untuk melihat daftar pilihan perhitungan.

Berikut adalah contoh data asli.


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 

Transformasi ini berjalan dalam dua langkah. Pertama, Anda menentukan satu atau beberapa bidang untuk mengelompokkan data berdasarkan. Ini akan mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya. Misalnya jika kita mengelompokkan berdasarkan bidang ID Server, maka itu akan mengelompokkan data dengan cara ini:


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 

Semua baris dengan nilai ID Server yang sama dikelompokkan bersama.

Setelah memilih bidang mana Anda ingin mengelompokkan data Anda, Anda dapat menambahkan berbagai perhitungan pada bidang lain, dan menerapkan perhitungan untuk setiap kelompok baris. Misalnya, kita bisa menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Jadi kita dapat menambahkan perhitungan *rata-rata* yang diterapkan pada bidang Suhu CPU untuk mendapatkan yang berikut:


| ID Server | Suhu CPU (rata-rata) | 
| --- | --- | 
| server 1 | 82 | 
| server 2 | 88,6 | 
| server 3 | 59,6 | 

Dan kita dapat menambahkan lebih dari satu perhitungan. Misalnya:
+ Untuk bidang Waktu, kita dapat menghitung nilai *Terakhir*, untuk mengetahui kapan titik data terakhir diterima untuk setiap server
+ Untuk bidang Status Server, kita dapat menghitung nilai *Terakhir* untuk mengetahui berapa nilai status terakhir untuk setiap server
+ Untuk bidang Temperatur, kita juga dapat menghitung nilai *Terakhir* untuk mengetahui berapa suhu yang dipantau terbaru untuk setiap server

Kami kemudian akan mendapatkan:


| ID Server | Suhu CPU (rata-rata) | Suhu CPU (terakhir) | Waktu (terakhir) | Status Server (terakhir) | 
| --- | --- | --- | --- | --- | 
| server 1 | 82 | 80 | 7/7/2020 11:34:20AM | Matikan | 
| server 2 | 88,6 | 90 | 7/7/2020 10:32:20AM | Kelebihan | 
| server 3 | 59,6 | 62 | 7/7/2020 11:34:20AM | OK | 

Transformasi ini memungkinkan Anda untuk mengekstrak informasi penting dari deret waktu Anda dan menampilkannya dengan cara yang nyaman.

## Pengelompokan ke matriks
<a name="v10-panels-xform-funcs-groupmatrix"></a>

Gunakan transformasi ini untuk menggabungkan tiga bidang—yang digunakan sebagai masukan untuk **kolom nilai Kolom****, **Baris**, dan Sel** dari output kueri—dan buat matriks. Matriks dihitung sebagai berikut:

**Data asli**


| ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | 
| server 1 | 82 | OK | 
| server 2 | 88,6 | OK | 
| server 3 | 59,6 | Matikan | 

Kita dapat menghasilkan matriks menggunakan nilai `Server Status` sebagai nama kolom, `Server ID` nilai sebagai nama baris, dan `CPU Temperature` sebagai isi dari setiap sel. Isi setiap sel akan muncul untuk kolom (`Server Status`) dan kombinasi baris (`Server ID`) yang ada. Untuk sisa sel, Anda dapat memilih nilai mana yang akan ditampilkan antara: **Null**, **True**, **False**, atau **Empty**.

**Keluaran**


|  IDServer Status Server | OK | Matikan | 
| --- | --- | --- | 
| server 1 | 82 |  | 
| server 2 | 88,6 |  | 
| server 3 |  | 59,6 | 

Gunakan transformasi ini untuk membangun matriks dengan menentukan bidang dari hasil kueri Anda. Output matriks mencerminkan hubungan antara nilai-nilai unik di bidang ini. Ini membantu Anda menyajikan hubungan yang kompleks dalam format matriks yang jelas dan terstruktur.

## Kelompokkan ke tabel bersarang
<a name="v10-panels-xform-funcs-grouptable"></a>

Gunakan transformasi ini untuk mengelompokkan data dengan nilai bidang (kolom) tertentu dan perhitungan proses pada setiap grup. Rekaman dihasilkan yang berbagi nilai bidang dikelompokkan yang sama, untuk ditampilkan dalam tabel bersarang.

Untuk menghitung statistik bidang, pilih kotak di sebelah bidang dan pilih opsi **Hitung**. Ini akan menambahkan kotak pilihan lain dengan statistik yang akan dipilih.

Tabel berikut menunjukkan data sampel.


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 80 | Matikan | 
| 7/7/2020 11:34:20AM | server 3 | 62 | OK | 
| 7/7/2020 10:32:20AM | server 2 | 90 | Kelebihan | 
| 7/7/2020 10:31:22AM | server 3 | 55 | OK | 
| 7/7/2020 9:30:57AM | server 3 | 62 | Rebooting | 
| 7/7/2020 9:30:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:28:06AM | server 1 | 80 | OK | 
| 7/7/2020 9:25:05AM | server 2 | 88 | OK | 
| 7/7/2020 9:23:07AM | server 1 | 86 | OK | 

Transformasi ini memiliki dua langkah. Pertama, tentukan satu atau lebih bidang yang digunakan untuk mengelompokkan data. Ini mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya Misalnya, jika Anda mengelompokkan berdasarkan `Server ID` bidang, Grafana mengelompokkan data dengan cara ini:


| ID Server | Data | 
| --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| Waktu | Suhu CPU | Status Server | 
| --- | --- | --- | 
| server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 11:34:20AM | 80 | Matikan | 
| 7/7/2020 9:28:06AM | 80 | OK | 
| 7/7/2020 9:23:07AM | 86 | OK | 
| 7/7/2020 10:32:20AM | 90 | Kelebihan | 
| 7/7/2020 9:30:05AM | 88 | OK | 
| 7/7/2020 9:25:05AM | 88 | OK | 
| 7/7/2020 11:34:20AM | 62 | OK | 
| 7/7/2020 10:31:22AM | 55 | OK | 
| 7/7/2020 9:30:57AM | 62 | Rebooting | 

Setelah memilih bidang yang ingin Anda kelompokkan data, Anda dapat menambahkan berbagai perhitungan di bidang lain dan menerapkan perhitungan ke setiap grup baris. Misalnya, Anda mungkin ingin menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Untuk melakukannya, tambahkan perhitungan rata-rata yang diterapkan pada bidang Suhu CPU untuk mendapatkan hasil sebagai berikut:


| ID Server | Suhu CPU (rata-rata) |  | 
| --- | --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| Waktu | Status Server | 
| --- | --- | 
| server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | 88,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 7/7/2020 11:34:20AM | Matikan | 
| 7/7/2020 9:28:06AM | OK | 
| 7/7/2020 9:23:07AM | OK | 
| 7/7/2020 10:32:20AM | Kelebihan | 
| 7/7/2020 9:30:05AM | OK | 
| 7/7/2020 9:25:05AM | OK | 
| 7/7/2020 11:34:20AM | OK | 
| 7/7/2020 10:31:22AM | OK | 
| 7/7/2020 9:30:57AM | Rebooting | 

## Buat peta panas
<a name="v10-panels-xform-funcs-heatmap"></a>

Gunakan transformasi ini untuk menyiapkan data histogram untuk memvisualisasikan tren dari waktu ke waktu. Mirip dengan visualisasi peta panas, transformasi ini mengubah metrik histogram menjadi bucket temporal.

**Ember X**

Pengaturan ini menentukan bagaimana sumbu x dibagi menjadi ember.
+ **Ukuran** - Tentukan interval waktu di bidang input. Misalnya, rentang waktu `1h` membuat sel selebar satu jam pada sumbu x.
+ **Hitung** - Untuk non-time-related seri, gunakan opsi ini untuk menentukan jumlah elemen dalam ember.

**Ember Y**

Pengaturan ini menentukan bagaimana sumbu y dibagi menjadi ember.
+ **Linear**
+ **Logaritmik** - Pilih antara basis log 2 atau basis log 10.
+ **Symlog — Menggunakan skala logaritmik** simetris. Pilih antara basis log 2 atau basis log 10, memungkinkan nilai negatif.

Asumsikan Anda memiliki kumpulan data berikut:


| Stempel waktu | Nilai | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ Dengan X Bucket disetel ke `Size: 15m` dan Y Bucket as`Linear`, histogram mengatur nilai ke dalam interval waktu 15 menit pada sumbu x dan linier pada sumbu y.
+ Untuk X Bucket as `Count: 2` dan Y Bucket as`Logarithmic (base 10)`, histogram mengelompokkan nilai ke dalam ember dua pada sumbu x dan menggunakan skala logaritmik pada sumbu y.

## Histogram
<a name="v10-panels-xform-funcs-histogram"></a>

Gunakan transformasi ini untuk menghasilkan histogram berdasarkan data input, memungkinkan Anda memvisualisasikan distribusi nilai.
+ **Ukuran bucket** — Rentang antara item terendah dan tertinggi dalam ember (Xmin hingga XMax).
+ **Bucket offset** — Offset untuk non-zero-based ember.
+ **Gabungkan seri** - Buat histogram terpadu menggunakan semua seri yang tersedia.

**Data asli**

Seri 1:


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

Seri 2:


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**Keluaran**


| xMin | XMax | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

Visualisasikan distribusi nilai menggunakan histogram yang dihasilkan, memberikan wawasan tentang penyebaran dan kepadatan data.

## Bergabung dengan bidang
<a name="v10-panels-xform-funcs-joinfield"></a>

Gunakan transformasi ini untuk menggabungkan beberapa hasil ke dalam satu tabel, memungkinkan konsolidasi data dari kueri yang berbeda.

Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang waktu bersama.

**Gabung batin**

Gabungan bagian dalam menggabungkan data dari beberapa tabel di mana semua tabel berbagi nilai yang sama dari bidang yang dipilih. Jenis gabungan ini mengecualikan data di mana nilai tidak cocok di setiap hasil.

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri (menggabungkan pada bidang gabungan yang diteruskan atau kolom pertama kali) menjadi satu hasil, dan jatuhkan baris di mana gabungan yang berhasil tidak dapat terjadi.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi gabungan batin.

Kueri A:


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 15 | 
| 7/7/2020 11:24:20AM | server 2 | 5 | 
| 7/7/2020 11:04:20AM | server 3 | 10 | 

Hasil setelah menerapkan transformasi gabungan batin terlihat seperti berikut:


| Waktu | Pekerjaan | Uptime | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | server 1 | 15 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | server 2 | 5 | 

*Bergabung di luar*

Gabungan luar mencakup semua data dari gabungan dalam dan baris di mana nilai tidak cocok di setiap input. Sementara gabungan bagian dalam bergabung dengan Kueri A dan Kueri B pada bidang waktu, gabungan luar mencakup semua baris yang tidak cocok di bidang waktu.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel sebelum menerapkan transformasi gabungan luar.

Kueri A:


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | server 1 | 15 | 
| 7/7/2020 11:24:20AM | server 2 | 5 | 
| 7/7/2020 11:04:20AM | server 3 | 10 | 

Hasil setelah menerapkan transformasi gabungan luar terlihat seperti berikut:


| Waktu | Pekerjaan | Uptime | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
| 7/7/2020 11:04:20AM |  |  | server 3 | 10 | 
| 7/7/2020 11:14:20AM | postgre | 345001233 |  |  | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | server 1 | 15 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | server 2 | 5 | 

## Bergabunglah dengan label
<a name="v10-panels-xform-funcs-joinlabel"></a>

Gunakan transformasi ini untuk menggabungkan beberapa hasil menjadi satu tabel.

Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang **Label** bersama.
+ **Gabung** — Pilih label untuk bergabung di antara label yang tersedia atau umum di semua deret waktu.
+ **Nilai** — Nama untuk hasil output.

**Contoh**

Masukan 1: `series1{what='Temp', cluster='A', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Masukan 2: `series2{what='Temp', cluster='B', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Masukan 3: `series3{what='Speed', cluster='B', job='J1'}`


| Waktu | Nilai | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

Config:

```
value: 'what'
```

Output:


| klaster | pekerjaan | Temp | Kecepatan | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

Gabungkan dan atur data deret waktu secara efektif dengan transformasi ini untuk wawasan yang komprehensif.

## Label ke bidang
<a name="v10-panels-xform-funcs-labelstofields"></a>

Gunakan transformasi ini untuk mengonversi hasil deret waktu dengan label atau tag ke dalam tabel, termasuk kunci dan nilai setiap label dalam hasilnya. Tampilkan label sebagai kolom atau nilai baris untuk visualisasi data yang disempurnakan.

Diberikan hasil query dari dua deret waktu:
+ Seri 1 - label`Server=Server A`, `Datacenter=EU`
+ Seri 2 - label`Server=Server B`, `Datacenter=EU`

Dalam mode **Kolom**, hasilnya terlihat seperti ini:


| Waktu | Server | Pusat data | Nilai | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | Server A | EU | 1 | 
| 7/7/2020 11:34:20AM | Peladen B | EU | 2 | 

Dalam mode “Baris”, hasilnya memiliki tabel untuk setiap seri dan menunjukkan setiap nilai label seperti ini:


| label | nilai | 
| --- | --- | 
| Server | Server A | 
| Pusat data | EU | 


| label | nilai | 
| --- | --- | 
| Server | Peladen B | 
| Pusat data | EU | 

**Nama bidang nilai**

Jika Anda memilih Server sebagai **nama bidang Nilai**, maka Anda akan mendapatkan satu bidang untuk setiap nilai label Server.


| Waktu | Pusat data | Server A | Peladen B | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | EU | 1 | 2 | 

**Perilaku penggabungan**

Label ke bidang transformator secara internal adalah dua transformasi terpisah. Tindakan pertama pada seri tunggal dan mengekstrak label ke bidang. Yang kedua adalah transformasi gabungan yang menggabungkan semua hasil menjadi satu tabel. Transformasi gabungan mencoba bergabung di semua bidang yang cocok. Langkah penggabungan ini diperlukan dan tidak dapat dimatikan.

Untuk mengilustrasikan hal ini, berikut adalah contoh di mana Anda memiliki dua kueri yang mengembalikan deret waktu tanpa label yang tumpang tindih.
+ Seri 1 - label `Server=ServerA`
+ Seri 2 - label `Datacenter=EU`

Ini pertama-tama akan menghasilkan dua tabel ini:


| Waktu | Server | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | ServerA | 10 | 


| Waktu | Pusat data | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | EU | 20 | 

Setelah bergabung:


| Waktu | Server | Nilai | Pusat data | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | ServerA | 10 |  | 
| 7/7/2020 11:34:20AM |  | 20 | EU | 

## Kuota
<a name="v10-panels-xform-funcs-limit"></a>

Gunakan transformasi ini untuk membatasi jumlah baris yang ditampilkan, memberikan tampilan data yang lebih terfokus. Ini sangat berguna ketika berhadapan dengan dataset besar.

Berikut ini adalah contoh yang menggambarkan dampak transformasi **Limit** pada respons dari sumber data:


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | Temperatur | 25 | 
| 7/7/2020 11:34:20AM | Kelembaban | 22 | 
| 7/7/2020 10:32:20AM | Kelembaban | 29 | 
| 7/7/2020 10:31:22AM | Temperatur | 22 | 
| 7/7/2020 9:30:57AM | Kelembaban | 33 | 
| 7/7/2020 9:30:05AM | Temperatur | 19 | 

Berikut adalah hasil setelah menambahkan transformasi Limit dengan nilai '3':


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | Temperatur | 25 | 
| 7/7/2020 11:34:20AM | Kelembaban | 22 | 
| 7/7/2020 10:32:20AM | Kelembaban | 29 | 

Transformasi ini membantu Anda menyesuaikan presentasi visual data Anda untuk fokus pada data yang paling relevan.

## Gabungkan seri/tabel
<a name="v10-panels-xform-funcs-merge"></a>

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri menjadi satu hasil, yang sangat berguna saat menggunakan visualisasi panel tabel. Transformasi menggabungkan nilai ke dalam baris yang sama jika bidang bersama berisi data yang sama.

Berikut contoh ilustrasi dampak transformasi **Merge seri/tabel pada dua kueri yang mengembalikan data tabel**:

*Kueri A:*


| Waktu | Pekerjaan | Uptime | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 123001233 | 

Kueri B:


| Waktu | Pekerjaan | Kesalahan | 
| --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 15 | 
| 7/7/2020 11:24:20AM | postgre | 5 | 

Berikut adalah hasilnya setelah menerapkan transformasi Merge:


| Waktu | Pekerjaan | Kesalahan | Uptime | 
| --- | --- | --- | --- | 
| 7/7/2020 11:34:20AM | simpul | 15 | 25260122 | 
| 7/7/2020 11:24:20AM | postgre | 5 | 123001233 | 

Transformasi ini menggabungkan nilai-nilai dari Query A dan Query B ke dalam tabel terpadu, meningkatkan presentasi untuk wawasan yang lebih baik.

## Atur bidang berdasarkan nama
<a name="v10-panels-xform-funcs-organize"></a>

Gunakan transformasi ini untuk mengganti nama, menyusun ulang, atau menyembunyikan bidang yang dikembalikan oleh satu kueri di panel Anda. Transformasi ini hanya berfungsi di panel dengan satu kueri. Jika panel Anda memiliki beberapa kueri, maka Anda harus menerapkan transformasi *gabungan Luar* atau menghapus kueri tambahan.

**Mengubah bidang**

Grafana menampilkan daftar bidang yang dikembalikan oleh kueri. Anda dapat:
+ **Ubah urutan bidang** - Seret bidang ke lokasi baru dalam daftar.
+ **Sembunyikan atau tampilkan bidang** — Gunakan ikon mata di samping nama bidang untuk mengaktifkan visibilitas bidang.
+ **Ganti nama bidang** - Ketik nama baru ke dalam kotak **Ganti Nama**.

**Contoh**

Mengingat hasil kueri awal ini:


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 

Anda dapat menerapkan penggantian bidang ganti nama untuk membuat:


| Waktu | Sensor | Membaca | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 

Transformasi ini memungkinkan Anda menyesuaikan tampilan hasil kueri, memastikan representasi data Anda yang jelas dan berwawasan luas di Grafana.

## Partisi berdasarkan nilai
<a name="v10-panels-xform-funcs-partition"></a>

Gunakan transformasi ini untuk merampingkan proses grafik beberapa seri tanpa perlu beberapa kueri dengan klausa yang berbeda. `WHERE`

**catatan**  
Fungsi ini tersedia di ruang kerja yang kompatibel dengan Grafana versi 9 ke atas.

Ini sangat berguna saat menggunakan tabel SQL metrik, seperti dalam contoh ini:


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | AS | 1520 | 
| 10/20/2022 12:00:00PM | EU | 2936 | 
| 10/20/2022 1:00:00AM | AS | 1327 | 
| 10/20/2022 1:00:00AM | EU | 912 | 

Dengan transformator *Partisi berdasarkan nilai*, Anda dapat mengeluarkan satu kueri dan membagi hasilnya dengan nilai unik dalam satu atau beberapa kolom (bidang) pilihan Anda. Contoh berikut menggunakan `Region`.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | AS | 1520 | 
| 10/20/2022 1:00:00AM | AS | 1327 | 


| Waktu | Region | Nilai | 
| --- | --- | --- | 
| 10/20/2022 12:00:00PM | EU | 2936 | 
| 10/20/2022 1:00:00AM | EU | 912 | 

Transformasi ini menyederhanakan proses dan meningkatkan fleksibilitas memvisualisasikan beberapa seri dalam visualisasi deret waktu yang sama.

## Siapkan seri waktu
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

Gunakan transformasi ini untuk mengatasi masalah saat sumber data mengembalikan data deret waktu dalam format yang tidak kompatibel dengan visualisasi yang diinginkan. Transformasi ini memungkinkan Anda untuk mengonversi data deret waktu dari antara format lebar dan panjang.

**Seri waktu multi-frame**

Gunakan opsi ini untuk mengubah kerangka data deret waktu dari format lebar ke format panjang. Ini sangat membantu ketika sumber data Anda memberikan informasi deret waktu dalam format yang perlu dibentuk ulang untuk kompatibilitas optimal dengan visualisasi Anda.

*Contoh*

Masukan ini:


| Stempel waktu | Nilai1 | Nilai2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

Dapat diubah menjadi:


| Stempel waktu | Variabel | Nilai | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Nilai1 | 10 | 
| 2023-01-01 00:00:00 | Nilai2 | 20 | 
| 2023-01-01 01:00:00 | Nilai1 | 15 | 
| 2023-01-01 01:00:00 | Nilai2 | 25 | 

**Seri waktu yang luas**

Gunakan opsi ini untuk mengubah kerangka data deret waktu dari format panjang ke format lebar. Ini sangat membantu ketika sumber data Anda mengirimkan data deret waktu dalam format yang panjang dan visualisasi Anda memerlukan format yang luas.

*Contoh*

Masukan ini:


| Stempel waktu | Variabel | Nilai | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Nilai1 | 10 | 
| 2023-01-01 00:00:00 | Nilai2 | 20 | 
| 2023-01-01 01:00:00 | Nilai1 | 15 | 
| 2023-01-01 01:00:00 | Nilai2 | 25 | 

Dapat diubah menjadi:


| Stempel waktu | Nilai1 | Nilai2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## Kurangi
<a name="v10-panels-xform-funcs-reduce"></a>

Gunakan transformasi ini menerapkan perhitungan untuk setiap bidang dalam bingkai data dan mengembalikan nilai tunggal. Transformasi ini sangat berguna untuk mengkonsolidasikan data deret waktu mulitiple ke dalam format yang lebih ringkas dan ringkas. Bidang waktu dihapus saat menerapkan transformasi ini.

Pertimbangkan masukannya:

Kueri A:


| Waktu | Temp | Uptime | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15.4 | 1230233 | 

Kueri B:


| Waktu | AQI | Kesalahan | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6.5 | 15 | 
| 2020-07-07 11:24:20 | 3.2 | 5 | 

Trafo reduksi memiliki dua mode:
+ **Seri ke baris** - Membuat baris untuk setiap bidang dan kolom untuk setiap perhitungan.
+ **Mengurangi bidang** - Menjaga struktur bingkai yang ada, tetapi menciutkan setiap bidang menjadi satu nilai.

Misalnya, jika Anda menggunakan perhitungan **Pertama** dan **Terakhir** dengan transformasi **Seri ke baris**, maka hasilnya akan menjadi:


| Bidang | Pertama | Terakhir | 
| --- | --- | --- | 
| Temp | 12.3 | 15.4 | 
| Uptime | 256122 | 1230233 | 
| AQI | 6.5 | 3.2 | 
| Kesalahan | 15 | 5 | 

**Kolom Reduce** dengan perhitungan **Terakhir**, menghasilkan dua frame, masing-masing dengan satu baris:

Kueri A:


| Temp | Uptime | 
| --- | --- | 
| 15.4 | 1230233 | 

Kueri B:


| AQI | Kesalahan | 
| --- | --- | 
| 3.2 | 5 | 

## Ganti nama dengan regex
<a name="v10-panels-xform-funcs-rename"></a>

Gunakan transformasi ini untuk mengganti nama bagian dari hasil kueri menggunakan ekspresi reguler dan pola penggantian.

Anda dapat menentukan ekspresi reguler, yang hanya diterapkan pada kecocokan, bersama dengan pola pengganti yang mendukung referensi kembali. Misalnya, bayangkan Anda memvisualisasikan penggunaan CPU per host dan Anda ingin menghapus nama domain. Anda dapat mengatur regex ke `([^\.]+)\..+` dan pola penggantian ke`$1`, `web-01.example.com` akan menjadi. `web-01`

Transformasi ini memungkinkan Anda menyesuaikan data untuk memenuhi kebutuhan visualisasi Anda, membuat dasbor Anda lebih informatif dan ramah pengguna.

## Baris ke bidang
<a name="v10-panels-xform-funcs-row"></a>

Gunakan transformasi ini untuk mengubah baris menjadi bidang terpisah. Ini dapat berguna karena bidang dapat ditata dan dikonfigurasi secara individual. Ini juga dapat menggunakan bidang tambahan sebagai sumber untuk konfigurasi bidang dinamis atau memetakannya ke label bidang. Label tambahan kemudian dapat digunakan untuk menentukan nama tampilan yang lebih baik untuk bidang yang dihasilkan.

Transformasi ini mencakup tabel bidang yang mencantumkan semua bidang dalam data yang dikembalikan oleh kueri konfigurasi. Tabel ini memberi Anda kontrol atas bidang apa yang harus dipetakan ke setiap properti konfigurasi (opsi **Gunakan sebagai**). Anda juga dapat memilih nilai mana yang akan dipilih jika ada beberapa baris dalam data yang dikembalikan.

Transformasi ini membutuhkan:
+ Satu bidang untuk digunakan sebagai sumber nama bidang.

  Secara default, transformasi menggunakan bidang string pertama sebagai sumber. Anda dapat mengganti pengaturan default ini dengan memilih **Nama bidang** di kolom **Use as** untuk bidang yang ingin Anda gunakan sebagai gantinya.
+ Satu bidang untuk digunakan sebagai sumber nilai.

  Secara default, transformasi menggunakan bidang angka pertama sebagai sumber. Tetapi Anda dapat mengganti pengaturan default ini dengan memilih **Nilai bidang** di kolom **Gunakan sebagai** kolom untuk bidang yang ingin Anda gunakan sebagai gantinya.

Berguna saat memvisualisasikan data di:
+ Pengukur
+ Stat
+ Bagan pai

**Petakan bidang tambahan ke label**

Jika bidang tidak dipetakan ke properti konfigurasi Grafana akan secara otomatis menggunakannya sebagai sumber untuk label pada bidang output.

Contoh:


| Nama | DataCenter | Nilai | 
| --- | --- | --- | 
| ServerA | AS | 100 | 
| ServerB | EU | 200 | 

Output:


| ServerA (label: DataCenter: AS) | ServerB (label: DataCenter: EU) | 
| --- | --- | 
| 100 | 200 | 

Label tambahan sekarang dapat digunakan dalam nama tampilan bidang untuk memberikan nama bidang yang lebih lengkap.

Jika Anda ingin mengekstrak konfigurasi dari satu kueri dan menerapkannya ke kueri lain, Anda harus menggunakan *konfigurasi dari transformasi hasil kueri*.

**Contoh**

Masukan:


| Nama | Nilai | Maks | 
| --- | --- | --- | 
| ServerA | 10 | 100 | 
| ServerB | 20 | 200 | 
| ServerC | 30 | 300 | 

Output:


| ServerA (konfigurasi: maks = 100) | ServerB (konfigurasi: maks = 200) | ServerC (konfigurasi: maks = 300) | 
| --- | --- | --- | 
| 10 | 20 | 30 | 

Seperti yang Anda lihat setiap baris dalam data sumber menjadi bidang terpisah. Setiap bidang sekarang juga memiliki set opsi konfigurasi maks. Opsi seperti **Min**, **Max**, **Unit** dan **Thresholds** adalah bagian dari konfigurasi bidang dan jika diatur seperti ini akan digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

Transformasi ini memungkinkan konversi baris menjadi bidang individual, memfasilitasi konfigurasi bidang dinamis, dan memetakan bidang tambahan ke label.

## Seri ke baris
<a name="v10-panels-xform-funcs-series"></a>

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri data deret waktu menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel.

Hasil dari transformasi ini akan berisi tiga kolom: Waktu, Metrik, dan Nilai. Kolom Metrik ditambahkan sehingga Anda dapat dengan mudah melihat dari mana kueri metrik berasal. Sesuaikan nilai ini dengan mendefinisikan Label pada kueri sumber.

Pada contoh di bawah ini, kami memiliki dua pertanyaan yang mengembalikan data deret waktu. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

*Kueri A:*


| Waktu | Temperatur | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*Kueri B:*


| Waktu | Kelembaban | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

Berikut adalah hasil setelah menerapkan Seri ke transformasi baris.


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatur | 25 | 
| 2020-07-07 11:34:20 | Kelembaban | 22 | 
| 2020-07-07 10:32:20 | Kelembaban | 29 | 
| 2020-07-07 10:31:22 | Temperatur | 22 | 
| 2020-07-07 09:30:57 | Kelembaban | 33 | 
| 2020-07-07 09:30:05 | Temperatur | 19 | 

Transformasi ini memfasilitasi konsolidasi hasil dari beberapa kueri deret waktu, menyediakan kumpulan data yang efisien dan terpadu untuk analisis dan visualisasi yang efisien dalam format tabel.

## Urutkan berdasarkan
<a name="v10-panels-xform-funcs-sort"></a>

Gunakan transformasi ini untuk mengurutkan setiap frame dalam hasil kueri berdasarkan bidang tertentu, membuat data Anda lebih mudah dipahami dan dianalisis. Dengan mengonfigurasi bidang yang diinginkan untuk penyortiran, Anda dapat mengontrol urutan data disajikan dalam tabel atau visualisasi.

Gunakan sakelar **Reverse** untuk memesan nilai secara terbalik dalam bidang yang ditentukan. Fungsionalitas ini sangat berguna ketika Anda ingin beralih dengan cepat antara urutan naik dan turun agar sesuai dengan kebutuhan analitis Anda.

Misalnya, dalam skenario di mana data deret waktu diambil dari sumber data, **Urutkan berdasarkan** transformasi dapat diterapkan untuk mengatur kerangka data berdasarkan stempel waktu, baik dalam urutan naik atau turun, tergantung pada persyaratan analitis. Kemampuan ini memastikan bahwa Anda dapat dengan mudah menavigasi dan menafsirkan data deret waktu, mendapatkan wawasan berharga dari presentasi yang terorganisir dan koheren secara visual.

## Spatial
<a name="v10-panels-xform-funcs-spatial"></a>

Gunakan transformasi ini untuk menerapkan operasi spasial ke hasil kueri.
+ **Tindakan** - Pilih tindakan:
  + **Siapkan bidang spasial** — Tetapkan bidang geometri berdasarkan hasil bidang lainnya.
    + **Mode lokasi** - Pilih mode lokasi (opsi ini dibagikan oleh **nilai Hitung** dan mode **Transformasi**):
      + **Otomatis** - Mengidentifikasi data lokasi secara otomatis berdasarkan nama bidang default.
      + **Coords** — Tentukan bidang lintang dan bujur.
      + **Geohash** — Tentukan bidang geohash.
      + **Pencarian** — Tentukan bidang lokasi Gazetteer.
  + **Hitung nilai** — Gunakan geometri untuk menentukan bidang baru (heading/distance/area).
    + **Fungsi** — Pilih operasi matematika untuk diterapkan pada geometri:
      + **Heading** — Hitung heading (arah) antara dua titik.
      + **Luas** — Hitung luas yang tertutup oleh poligon yang ditentukan oleh geometri.
      + **Jarak** — Hitung jarak antara dua titik.
  + **Transform** — Terapkan operasi spasial ke geometri.
    + **Operasi** - Pilih operasi untuk diterapkan pada geometri:
      + **Sebagai garis** - Buat fitur baris tunggal dengan simpul di setiap baris.
      + **Pembuat garis** - Buat garis antara dua titik.

Transformasi ini memungkinkan Anda untuk memanipulasi dan menganalisis data geospasial, memungkinkan operasi seperti membuat garis antar titik, menghitung properti spasial, dan banyak lagi.

## Transformasi deret waktu ke tabel
<a name="v10-panels-xform-funcs-seriestotable"></a>

Gunakan transformasi ini untuk mengubah hasil deret waktu menjadi tabel, mengubah kerangka data deret waktu menjadi bidang **Trend**. Bidang **Trend** kemudian dapat dirender menggunakan [jenis sel sparkline](v10-panels-table.md#v10-panels-table-cell-type), menghasilkan sparkline sebaris untuk setiap baris tabel. Jika ada beberapa kueri deret waktu, masing-masing akan menghasilkan bingkai data tabel terpisah. Ini dapat digabungkan menggunakan join atau merge transforms untuk menghasilkan satu tabel dengan beberapa sparkline per baris.

Untuk setiap nilai bidang **Trend** yang dihasilkan, fungsi perhitungan dapat dipilih. Defaultnya adalah **Nilai non-null Terakhir**. Nilai ini ditampilkan di sebelah sparkline dan digunakan untuk menyortir baris tabel.

## Analisis regresi
<a name="v10-panels-xform-funcs-regression"></a>

Gunakan transformasi ini untuk membuat bingkai data baru yang berisi nilai yang diprediksi oleh model statistik. Ini berguna untuk menemukan tren dalam data kacau. Ia bekerja dengan menyesuaikan fungsi matematika ke data, menggunakan regresi linier atau polinomial. Bingkai data kemudian dapat digunakan dalam visualisasi untuk menampilkan garis tren.

Ada dua model yang berbeda:
+  **Regresi linier** — Sesuai dengan fungsi linier ke data.
+  **Regresi polinomial** — Sesuai dengan fungsi polinomial dengan data.

**catatan**  
Transformasi ini saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

# Memecahkan masalah kueri
<a name="v10-panels-query-troubleshoot"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman ini memberikan informasi untuk memecahkan masalah dasbor umum.

**Saya mendapatkan hasil yang berbeda ketika saya mengatur ulang fungsi saya**

Urutan fungsi sangat penting. Sama seperti dalam matematika, urutan yang Anda tempatkan fungsi Anda dapat memengaruhi hasilnya.

**Periksa permintaan dan respons kueri Anda**

Masalah yang paling umum terkait dengan permintaan dan respons dari sumber data Anda. Bahkan jika itu terlihat seperti masalah bug atau visualisasi di Grafana, hampir selalu masalah dengan kueri sumber data atau respons sumber data. Mulailah dengan memeriksa permintaan dan respons panel Anda.

Untuk informasi selengkapnya, lihat [Periksa data permintaan dan respons](v10-panels-panel-inspector.md).

**Kueri saya lambat**

Berapa banyak titik data yang dikembalikan kueri Anda? Kueri yang mengembalikan banyak titik data akan lambat. Coba ini:
+ Dalam **opsi Query**, batasi **poin data Max** yang dikembalikan.
+ Dalam **opsi Query**, tingkatkan waktu **interval Min**.
+ Dalam kueri Anda, gunakan `group by` fungsi.

# Jenis perhitungan
<a name="v10-panels-calculation-types"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tabel berikut berisi daftar perhitungan yang dapat Anda lakukan di Grafana. Anda dapat menemukan perhitungan ini di tab **Transform** dan di bar gauge, gauge, dan visualisasi stat.


| Penghitungan | Deskripsi | 
| --- | --- | 
| Semua nol | Benar ketika semua nilai nol | 
| Semua nilai | Array dengan semua nilai | 
| Semua nilai unik | Array dengan semua nilai unik | 
| Semua nol | Benar ketika semua nilai 0 | 
| Ubah hitungan | Berapa kali nilai bidang berubah | 
| Hitungan | Jumlah nilai dalam bidang | 
| kuala | Perubahan nilai kumulatif, hanya menghitung kenaikan | 
| Perbedaan | Perbedaan antara nilai pertama dan terakhir dari suatu bidang | 
| Perbedaan persen | Persentase perubahan antara nilai pertama dan terakhir bidang | 
| Hitungan yang berbeda | Jumlah nilai unik dalam bidang | 
| Pertama | Nilai pertama dalam bidang | 
| Pertama\$1 (bukan null) | Pertama, bukan nilai null di bidang (juga tidak termasuk NaNs) | 
| Terakhir | Nilai terakhir dalam bidang | 
| Terakhir\$1 (bukan null) | Terakhir, bukan nilai null di bidang (juga tidak termasuk NaNs) | 
| Maks | Nilai maksimum bidang | 
| Berarti | Nilai rata-rata dari semua nilai dalam bidang | 
| Varians | Varians dari semua nilai dalam bidang | 
| StdDev | Standar deviasi dari semua nilai dalam bidang | 
| Min | Nilai minimum bidang | 
| Min (di atas nol) | Minimum, nilai positif dari suatu bidang | 
| Kisaran | Perbedaan antara nilai maksimum dan minimum bidang | 
| Langkah | Interval minimal antara nilai bidang | 
| Total | Jumlah semua nilai dalam bidang | 

# Konfigurasikan opsi panel
<a name="v10-panels-configure-panel-options"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel Grafana adalah representasi visual dari data yang dapat Anda sesuaikan dengan menentukan kueri sumber data, mengubah dan memformat data, dan mengonfigurasi pengaturan visualisasi.

Editor panel menyertakan pembuat kueri dan serangkaian opsi yang dapat Anda gunakan untuk mengubah data dan menambahkan informasi ke panel Anda.

Topik ini menjelaskan cara:
+ Buka panel untuk mengedit
+ Tambahkan judul dan deskripsi panel
+ Lihat model panel JSON
+ Konfigurasikan baris dan panel berulang

## Mengedit panel
<a name="v10-panels-edit-a-panel"></a>

Setelah menambahkan panel ke dasbor, Anda dapat membukanya kapan saja untuk mengubah atau memperbarui kueri, menambahkan transformasi data, dan mengubah pengaturan visualisasi.

**Untuk mengedit panel**

1. Buka dasbor yang berisi panel yang ingin Anda edit.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Pilih menu dan pilih **Edit**.

   Untuk menggunakan pintasan keyboard untuk membuka panel, arahkan kursor ke panel dan tekan. `e`

   Panel terbuka dalam mode edit.

## Tambahkan judul dan deskripsi ke panel
<a name="v10-panels-add-title-description"></a>

Tambahkan judul dan deskripsi ke panel untuk berbagi dengan pengguna informasi penting tentang visualisasi. Misalnya, gunakan deskripsi untuk mendokumentasikan tujuan visualisasi.

1. Edit panel.

1. Di panel opsi tampilan panel, cari bagian **Opsi panel**.

1. Masukkan **Judul**.

   Teks yang dimasukkan di bidang ini muncul di tooltip di editor panel dan di dasbor.

1. Tulis deskripsi panel dan data yang Anda tampilkan.

   Teks yang dimasukkan dalam bidang ini muncul di tooltip di sudut kiri atas panel.

   Anda dapat menggunakan [variabel yang telah Anda tentukan](v10-dash-variables.md) di bidang **Judul** dan **Deskripsi**, tetapi bukan [variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).

## Melihat model panel JSON
<a name="v10-panels-json-model"></a>

Jelajahi dan ekspor panel, data panel, dan model JSON bingkai data.

**Untuk melihat model panel JSON**

1. Buka dasbor yang berisi panel.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas.

1. Dari menu, pilih **Inspect > Panel JSON**.

1. Di bidang **Pilih sumber**, pilih salah satu opsi berikut:
   + **Panel JSON** - Menampilkan objek JSON yang mewakili panel.
   + **Data panel** - Menampilkan objek JSON yang mewakili data yang diteruskan ke panel.
   + **DataFrame struktur** — Menampilkan struktur data panel, termasuk transformasi, konfigurasi bidang, dan konfigurasi penggantian yang telah diterapkan.

1. Untuk menjelajahi JSON, pilih **>** untuk memperluas atau menciutkan bagian dari model JSON.

## Mengkonfigurasi panel berulang
<a name="v10-panels-configure-repeating-panels"></a>

Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor. Panel dinamis adalah panel yang dibuat sistem berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua panel di dasbor. Untuk informasi selengkapnya tentang panel berulang, lihat[Membuat dasbor](v10-dash-creating.md).

**catatan**  
Panel berulang membutuhkan variabel untuk memiliki satu atau lebih item yang dipilih; Anda tidak dapat mengulang panel nol kali untuk menyembunyikannya.

*Prekusit*
+ Pastikan bahwa kueri menyertakan variabel multi-nilai.

**Untuk mengkonfigurasi panel berulang**

1. Edit panel yang ingin Anda ulangi.

1. Pada panel opsi tampilan, pilih Opsi **panel > Opsi Ulangi**.

1. Pilih **arah**.
   + Pilih **horisontal** untuk mengatur panel side-by-side. Grafana menyesuaikan lebar panel berulang. Anda tidak dapat mencampur panel lain secara berurutan dengan panel berulang.
   + Pilih **vertikal** untuk mengatur panel dalam kolom. Lebar panel berulang sama dengan panel asli yang berulang.

1. Untuk menyebarkan perubahan ke semua panel, muat ulang dasbor.

# Konfigurasikan opsi standar
<a name="v10-panels-configure-standard-options"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Model data yang digunakan dalam Grafana adalah struktur tabel berorientasi kolumnar yang menyatukan deret waktu dan hasil kueri tabel. Setiap kolom dalam struktur ini disebut *bidang*. Bidang dapat mewakili satu deret waktu atau kolom tabel.

Opsi bidang memungkinkan Anda mengubah cara data ditampilkan dalam visualisasi Anda. Opsi dan penggantian yang Anda terapkan tidak mengubah data, mereka mengubah cara Grafana menampilkan data. Ketika Anda mengubah opsi, itu diterapkan ke semua bidang, yang berarti semua seri atau kolom. Misalnya, jika Anda mengubah unit menjadi persentase, maka semua bidang dengan nilai numerik ditampilkan dalam persentase.

Daftar lengkap opsi pemformatan bidang disertakan nanti dalam topik ini.

**catatan**  
Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini.

**Untuk mengkonfigurasi opsi standar**

1. Buka dasbor. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas dasbor.

1. Dari menu tindakan, pilih **Edit**.

1. Di panel opsi tampilan panel, cari bagian **Opsi standar**.

1. Pilih opsi standar yang ingin Anda terapkan.

1. Untuk melihat pratinjau perubahan Anda, pilih di luar kotak opsi bidang yang sedang Anda edit atau tekan **Enter**.

**Definisi opsi standar**

Bagian ini menjelaskan semua opsi standar yang tersedia.

Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini.

Sebagian besar opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan **Enter**.

**catatan**  
Grafana Labs terus bekerja untuk menambah dan memperluas opsi untuk semua visualisasi, jadi semua opsi mungkin tidak tersedia untuk semua visualisasi.

## Unit
<a name="v10-panels-standard-options-unit"></a>

Memungkinkan Anda memilih unit apa yang harus digunakan bidang. Pilih bidang **Unit**, lalu telusuri sampai Anda menemukan unit yang Anda inginkan. Unit yang Anda pilih diterapkan ke semua bidang kecuali waktu.

### Unit kustom
<a name="v10-panels-standard-options-custom-units"></a>

Anda dapat menggunakan dropdown unit untuk juga menentukan unit kustom, awalan kustom atau akhiran dan format waktu tanggal.

Untuk memilih unit kustom, masukkan unit dan pilih opsi **Custom: xxx** terakhir di dropdown.
+ **akhiran:** <suffix>untuk unit khusus yang harus mengikuti nilai.
+ **awalan:** <prefix>untuk unit kustom yang harus pergi sebelum nilai.
+ **time:** <format>Untuk format waktu tanggal kustom, ketik misalnya`time:YYYY-MM-DD`. Lihat [format](https://momentjs.com/docs/#/displaying/) dalam *Dokumentasi Moment.js* untuk sintaks format dan opsi.
+ **si:** <base scale><unit characters>untuk unit SI kustom. Sebagai contoh: `si: mF`. Ini sedikit lebih maju karena Anda dapat menentukan unit dan skala data sumber. Jadi jika data sumber Anda direpresentasikan sebagai milli (ribuan) sesuatu mengawali unit dengan karakter skala SI itu.
+ **count:** <unit>untuk unit hitungan kustom.
+ **mata uang:** <unit>untuk kustom unit mata uang.

Anda juga dapat menempelkan emoji asli di pemilih unit dan memilihnya sebagai unit khusus.

### Satuan string
<a name="v10-panels-standard-options-string-units"></a>

Grafana terkadang bisa terlalu agresif dalam mengurai string dan menampilkannya sebagai angka. **Untuk mengonfigurasi Grafana untuk menampilkan nilai string asli, buat penggantian bidang dan tambahkan properti unit dengan unit String.**

### Satuan skala
<a name="v10-panels-standard-options-scale-units"></a>

Secara default, Grafana secara otomatis menskalakan unit berdasarkan besarnya nilai. Misalnya, jika Anda memiliki nilai 0,14 kW, Grafana akan menampilkannya sebagai 140 W. Contoh lain adalah bahwa 3000 kW akan ditampilkan sebagai tiga MW. Jika Anda ingin menonaktifkan perilaku ini, Anda dapat mematikan sakelar **Scale units**.

## Min
<a name="v10-panels-standard-options-min"></a>

Memungkinkan Anda menetapkan nilai minimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk menghitung minimum secara otomatis.

## Maks
<a name="v10-panels-standard-options-max"></a>

Memungkinkan Anda menetapkan nilai maksimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk menghitung maksimum secara otomatis.

## Bidang min/maks
<a name="v10-panels-standard-options-fieldminmax"></a>

Secara default, min dan maks yang dihitung akan didasarkan pada minimum dan maksimum, di semua seri dan bidang. min/max Menghidupkan bidang akan menghitung min atau maks pada setiap bidang secara individual, berdasarkan minimum atau maksimum bidang itu.

## Desimal
<a name="v10-panels-standard-options-decimals"></a>

Tentukan jumlah desimal Grafana termasuk dalam nilai yang diberikan. Jika Anda membiarkan bidang ini kosong, Grafana secara otomatis memotong jumlah desimal berdasarkan nilainya. Misalnya 1.1234 akan ditampilkan sebagai 1.12 dan 100.456 akan ditampilkan sebagai 100.

**Untuk menampilkan semua desimal, atur unit ke String.**

## Nama tampilan
<a name="v10-panels-standard-options-displayname"></a>

Memungkinkan Anda mengatur judul tampilan semua bidang. Anda dapat menggunakan [variabel](v10-dash-variables.md) dalam judul bidang.

Ketika beberapa statistik, bidang, atau seri ditampilkan, bidang ini mengontrol judul di setiap stat. Anda dapat menggunakan ekspresi seperti **\$1 \$1\$1\$1field.name\$1** untuk hanya menggunakan nama seri atau nama bidang dalam judul.

Diberikan bidang dengan nama`Temp`, dan label`{"Loc"="PBI", "Sensor"="3"}`:


| Sintaksis ekspresi | Contoh | Render ke | Penjelasan | 
| --- | --- | --- | --- | 
| \$1\$1\$1\$1field.displayName\$1 | Sama seperti sintaks | Temp \$1Loc="PBI", Sensor="3"\$1 | Menampilkan nama bidang, dan label \$1\$1 jika ada. Jika hanya ada satu kunci label dalam respons, maka untuk bagian label, Grafana menampilkan nilai label tanpa tanda kurung yang terlampir. | 
| \$1\$1\$1\$1field.name\$1 | Sama seperti sintaks | Temp | Menampilkan nama bidang (tanpa label). | 
| \$1\$1\$1\$1field.labels\$1 | Sama seperti sintaks | Loc="PBI", Sensor="3" | Menampilkan label tanpa nama. | 
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Menampilkan nilai kunci label yang ditentukan. | 
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | Sama seperti Sintaks | PBI, 3 | Menampilkan nilai-nilai label yang dipisahkan oleh koma (tanpa kunci label). | 

Jika nilainya adalah string kosong setelah merender ekspresi untuk bidang tertentu, maka metode tampilan default digunakan.

## Skema warna
<a name="v10-panels-standard-options-color-scheme"></a>

Pilihan warna dan efeknya pada visualisasi tergantung pada visualisasi yang Anda kerjakan. Beberapa visualisasi memiliki pilihan warna yang berbeda.

Anda dapat menentukan satu warna, atau memilih skema warna kontinu (gradien), berdasarkan nilai. Warna kontinu menginterpolasi warna menggunakan persentase nilai relatif terhadap min dan maks.

Pilih salah satu palet berikut:


| Mode warna | Deskripsi | 
| --- | --- | 
| Warna tunggal | Tentukan satu warna, berguna dalam aturan penggantian | 
| Nuansa warna | Memilih nuansa warna tunggal, berguna dalam aturan penggantian | 
| Dari ambang batas | Menginformasikan Grafana untuk mengambil warna dari ambang yang cocok | 
| Palet klasik | Grafana akan menetapkan warna dengan mencari warna dalam palet dengan indeks seri. Berguna untuk Grafik dan diagram lingkaran dan visualisasi data kategoris lainnya | 
| Palet klasik (dengan nama seri) | Grafana akan menetapkan warna berdasarkan nama seri. Berguna ketika nama seri yang akan di-vsiualisasi bergantung pada data yang tersedia. | 
| Green-Yellow-Red (berdasarkan nilai) | Skema warna berkelanjutan | 
| Red-Yellow-Green (berdasarkan nilai) | Skema warna berkelanjutan | 
| Blue-Yellow-Red (berdasarkan nilai) | Skema warna berkelanjutan | 
| Kuning-Merah (berdasarkan nilai) | Skema warna berkelanjutan | 
| Biru-Ungu (berdasarkan nilai) | Skema warna berkelanjutan | 
| Kuning-Biru (berdasarkan nilai) | Skema warna berkelanjutan | 
| Blues (berdasarkan nilai) | Skema warna terus menerus (latar belakang panel ke biru) | 
| Merah (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel menjadi merah) | 
| Hijau (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel ke hijau) | 
| Ungu (berdasarkan nilai) | Skema warna terus menerus (warna latar belakang panel ke ungu) | 

## Tidak ada nilai
<a name="v10-panels-standard-options-no-value"></a>

Masukkan apa yang harus ditampilkan Grafana jika nilai bidang kosong atau nol. Nilai default adalah tanda hubung (-).

# Konfigurasikan legenda
<a name="v10-panels-configure-legend"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel menyertakan legenda yang dapat Anda gunakan untuk menafsirkan data yang ditampilkan dalam visualisasi. Setiap opsi legenda menambahkan konteks dan kejelasan pada data yang diilustrasikan dalam visualisasi.

Legenda didukung untuk visualisasi berikut:
+ [Bagan batang](v10-panels-bar-chart.md)
+ [Candlestick](v10-panels-candlestick.md)
+ [Histogram](v10-panels-histogram.md)
+ [Bagan pai](v10-panels-piechart.md)
+ [Garis waktu negara](v10-panels-state-timeline.md)
+ [Riwayat status](v10-panels-status-history.md)
+ [Deret waktu](v10-panels-time-series.md)
+ [Tren](v10-panels-trend.md)

[Geomaps](v10-panels-geomap.md) dan [Heatmaps](v10-panels-heatmap.md) juga memiliki legenda, tetapi mereka hanya menyediakan pilihan untuk menampilkan atau tidak menampilkan legenda, dan tidak mendukung opsi legenda lainnya.

## Opsi legenda
<a name="v10-panels-legend-options"></a>

Anda dapat menemukan opsi berikut di bawah **Legenda** bagian di panel edit panel.

**catatan**  
Tidak semua opsi yang tercantum berlaku untuk semua visualisasi dengan legenda.

**Visibilitas**

Atur apakah legenda ditampilkan atau tidak. Gunakan sakelar untuk mengaktifkan atau menonaktifkan legenda.

**Modus**

Atur format di mana legenda ditampilkan. Pilih antara:
+ **Daftar**
+ **Tabel**

Saat Anda memformat legenda sebagai tabel, informasi lain tentang legenda, seperti nilai terkait atau letaknya dalam visualisasi, mungkin juga ditampilkan.

**Penempatan**

Atur di mana pada visualisasi sebuah legenda ditampilkan. Pilih antara:
+ **Bawah**
+ **Kanan**

**Lebar**

Jika Anda mengatur penempatan legenda ke **Kanan**, opsi **Lebar** menjadi tersedia. Biarkan bidang kosong untuk memungkinkan Grafana mengatur lebar legenda secara otomatis, atau masukkan lembah di bidang.

**Nilai-nilai**

Anda dapat menambahkan lebih banyak konteks ke visualisasi dengan menambahkan nilai data seri atau [perhitungan](v10-panels-calculation-types.md) ke legenda. Anda dapat menambahkan nilai sebanyak yang Anda suka. Setelah menerapkan perubahan, Anda dapat menggulir legenda untuk melihat semua nilai.

## Mengubah warna seri
<a name="v10-panels-legend-change-color"></a>

Secara default, Grafana menetapkan warna data seri Anda, tetapi Anda dapat mengubahnya melalui legenda panel.

**Untuk mengubah warna seri**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Dalam legenda, pilih bilah warna yang terkait dengan seri.

1. Pilih warna yang telah ditetapkan sebelumnya di tab **Warna** atau atur warna khusus di tab **Kustom**, menggunakan pemilih atau nilai RGB.

1. Simpan dasbor.

## Mengisolasi data seri dalam visualisasi
<a name="v10-panels-legend-isolate"></a>

Visualisasi seringkali dapat menjadi kompleks secara visual, dan mencakup banyak seri data. Anda dapat menyederhanakan tampilan dengan menghapus data seri dari visualisasi melalui legenda, yang mengisolasi data yang ingin Anda lihat. **Saat Anda melakukan ini, Grafana secara otomatis membuat penggantian baru di tab Override.**

**Untuk mengisolasi data seri dalam visualisasi**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Dalam legenda, pilih label seri yang ingin Anda isolasi.

   Sistem menghapus dari tampilan semua data seri lainnya.

1. Untuk menambahkan data seri secara bertahap kembali ke seri terisolasi, tekan tombol **Ctrl** atau **Command** dan pilih label seri yang ingin Anda tambahkan.

1. Untuk menyimpan perubahan Anda sehingga muncul ke semua pemirsa panel, simpan dasbor.

Untuk kembali ke tampilan default yang menyertakan semua data, klik label seri dua kali.

## Seri penyortiran
<a name="v10-panels-legend-sort"></a>

Saat Anda memformat legenda sebagai tabel dan menambahkan nilai ke dalamnya, Anda dapat mengurutkan seri dalam tabel berdasarkan nilai-nilai tersebut.

**Untuk mengurutkan seri**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel yang ingin Anda kerjakan untuk menampilkan menu di sudut kanan atas panel.

1. Dari menu, pilih **Edit**.

1. Gulir ke bagian **Legenda** pada panel edit panel.

1. Di bawah **Nilai**, pilih nilai atau perhitungan yang ingin Anda tampilkan.

   Legenda sekarang menampilkan nilai.

1. Pilih header nama perhitungan di tabel legenda untuk mengurutkan nilai dalam tabel dalam urutan naik atau turun.

**catatan**  
Fitur ini hanya didukung di panel ini: diagram batang, histogram, deret waktu.

# Konfigurasikan tautan data
<a name="v10-panels-configure-data-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tautan data memungkinkan Anda memberikan konteks yang lebih terperinci ke tautan Anda. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilai di bawah kursor. Misalnya, jika visualisasi Anda menunjukkan empat server, Anda dapat menambahkan datalink ke satu atau dua server. Anda juga dapat menautkan panel menggunakan tautan data.

Tautan itu sendiri dapat diakses dengan berbagai cara tergantung pada visualisasi. Untuk visualisasi deret waktu, misalnya, Anda memilih titik atau garis data. Untuk visualisasi area yang luas, seperti stat, gauge, atau bar gauge, Anda dapat memilih di mana saja pada visualisasi untuk membuka menu konteks.

Jika hanya ada satu tautan data dalam visualisasi, memilih di mana saja pada visualisasi akan membuka tautan daripada menu konteks.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Peta panas
+ Histogram
+ Bagan pai
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Deret waktu
+ Tren

## Variabel tautan data
<a name="v10-panels-data-link-variables"></a>

Variabel dalam tautan data memungkinkan Anda mengirim orang ke dasbor terperinci dengan filter data yang diawetkan. Misalnya, Anda dapat menggunakan variabel untuk menentukan label, rentang waktu, seri, atau pemilihan variabel.

Untuk melihat daftar variabel yang tersedia, ketik `$` bidang **URL** tautan data.

Anda juga dapat menggunakan variabel template di tautan data Anda URLs, lihat[Variabel](v10-dash-variables.md).

### Variabel panel rentang waktu
<a name="v10-panels-time-range-panel-variables"></a>

Variabel ini memungkinkan Anda untuk memasukkan rentang waktu saat ini dalam URL tautan data.
+ `__url_time_range`— rentang waktu dasbor saat ini (mis.`?from=now-6h&to=now`)
+ `$__from`— Untuk informasi lebih lanjut, lihat[Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to`— Untuk informasi lebih lanjut, lihat[Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global).

### Variabel seri
<a name="v10-panels-series-variables"></a>

Variabel spesifik seri tersedia di bawah `__series` namespace:
+ `__series.name`— nama seri ke URL

### Variabel bidang
<a name="v10-panels-field-variables"></a>

Variabel khusus bidang tersedia di bawah namespace: `__field`
+ `__field.name`— nama bidang
+ `__field.labels.<LABEL>`— nilai label ke URL. Jika label Anda berisi titik-titik, maka gunakan `__field.labels["<LABEL>"]` sintaks.

### Variabel nilai
<a name="v10-panels-value-variables"></a>

Variabel spesifik nilai tersedia di bawah `__value` namespace:
+ `__value.time`— stempel waktu nilai (Unix ms epoch) ke URL (mis.) `?time=1560268814105`
+ `__value.raw`— nilai mentah
+ `__value.numeric`— representasi numerik dari suatu nilai
+ `__value.text`— representasi teks dari suatu nilai
+ `__value.calc`— nama perhitungan jika nilainya adalah hasil perhitungan

Menggunakan variabel spesifik nilai dalam tautan data dapat menunjukkan hasil yang berbeda tergantung pada opsi set mode Tooltip.

### Variabel data
<a name="v10-panels-data-variables"></a>

Untuk mengakses nilai dari bidang lain gunakan:
+ `__data.fields[i]`— Nilai bidang `i` (pada baris yang sama).
+ `__data.fields["NameOfField"]`— Nilai bidang menggunakan nama bukan indeks.
+ `__data.fields[i].labels.cluster`— Akses label bidang lain.

### Variabel template
<a name="v10-panels-template-variables"></a>

Saat menautkan ke dasbor lain yang menggunakan variabel template, pilih nilai variabel untuk siapa pun yang mengklik tautan.

`${var-myvar:queryparam}`— di mana `var-myvar` adalah nama variabel template yang cocok dengan satu di dasbor saat ini yang ingin Anda gunakan.


| Status variabel | Hasil di URL yang dibuat | 
| --- | --- | 
| memilih satu nilai | var-myvar=value1 | 
| memilih beberapa nilai | var-myvar=value1&var-myvar=value2 | 
| terpilih All | var-myvar=All | 

Jika Anda ingin menambahkan semua variabel dasbor saat ini ke URL, gunakan`${__all_variables}`.

## Menambahkan tautan data
<a name="v10-panels-add-a-datalink"></a>

Anda dapat menambahkan tautan data ke panel Anda.

1. Arahkan ke panel tempat Anda ingin menambahkan tautan data.

1. Arahkan kursor ke panel untuk menampilkan ikon menu di sudut kanan atas.

1. Dari menu, pilih **Edit** untuk membuka editor panel.

1. Di **panel Edit panel**, gulir ke bawah ke bagian **Tautan data** dan perluas.

1. Pilih **Tambahkan tautan**.

1. Di kotak dialog yang terbuka, masukkan **Judul**. Ini adalah label yang dapat dibaca manusia untuk tautan, yang akan ditampilkan di UI.

1. Masukkan **URL** atau variabel yang ingin Anda tautkan.

   Untuk menambahkan variabel tautan data, pilih bidang **URL** lalu masukkan `$` atau tekan Ctrl\$1Spasi atau Cmd\$1Spasi untuk melihat daftar variabel yang tersedia.

1. Jika Anda ingin tautan terbuka di tab baru, pilih **Buka di tab baru**.

1. Pilih **Simpan** untuk menyimpan perubahan dan menutup kotak dialog.

1. Simpan perubahan Anda ke dasbor.

# Konfigurasikan pemetaan nilai
<a name="v10-panels-configure-value-mappings"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Selain penggantian bidang, pemetaan nilai adalah teknik yang dapat Anda gunakan untuk mengubah bagaimana data muncul dalam visualisasi.

Pemetaan nilai melewati set pemformatan unit di [Opsi standar](v10-panels-configure-standard-options.md) editor panel, seperti warna atau jumlah tempat desimal yang ditampilkan. Saat pemetaan nilai hadir di panel, Grafana menampilkan ringkasannya di bagian **Pemetaan nilai** pada editor panel.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Histogram
+ Bagan pai
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Deret waktu
+ Tren

## Jenis pemetaan nilai
<a name="v10-panels-value-mappings-types"></a>

Grafana mendukung jenis pemetaan nilai berikut:
+ **Nilai** — Memetakan nilai tertentu ke teks dan warna. Misalnya, Anda dapat mengonfigurasi pemetaan nilai sehingga semua contoh nilai `10` muncul sebagai `Perfection!` bukan angka. Gunakan pemetaan **Nilai** saat Anda ingin memformat satu nilai.
+ **Rentang** - Memetakan rentang numerik ke teks dan warna. Misalnya, jika nilai berada dalam rentang tertentu, Anda dapat mengonfigurasi pemetaan nilai rentang untuk ditampilkan `Low` atau `High` bukan angka. Gunakan pemetaan **Rentang** saat Anda ingin memformat beberapa nilai kontinu.
+ **Regex** — Memetakan ekspresi reguler ke teks dan warna. Misalnya, jika nilainya`www.example.com`, Anda dapat mengonfigurasi pemetaan nilai regex sehingga Grafana menampilkan `www` dan memotong domain. Gunakan pemetaan **Regex** saat Anda ingin memformat teks dan warna nilai ekspresi reguler.
+ **Khusus** - Peta nilai khusus seperti`Null`, `NaN` (bukan angka), dan nilai Boolean seperti `true` dan `false` ke teks dan warna. Misalnya, Anda dapat mengonfigurasi pemetaan nilai khusus sehingga `null` nilai muncul sebagai`N/A`. Gunakan mappiong **Khusus** saat Anda ingin memformat uncommon, Boolean, atau nilai kosong.

## Menambahkan pemetaan nilai
<a name="v10-panels-value-mappings-add"></a>

Anda dapat menambahkan pemetaan nilai ke panel Anda.

**Untuk menambahkan pemetaan nilai**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu di sudut kanan atas panel.

1. Dari menu, pilih **Edit**.

1. Di bagian **Pemetaan nilai**, pilih **Tambahkan pemetaan nilai**.

1. Pilih **Tambahkan pemetaan baru**, lalu pilih salah satu dari berikut ini:
   + **Nilai** - Masukkan satu nilai untuk dicocokkan.
   + **Rentang** - Masukkan nilai awal dan akhir dari rentang yang cocok.
   + **Regex** - Masukkan pola ekspresi reguler untuk mencocokkan.
   + **Khusus** - Pilih nilai khusus untuk dicocokkan.

1. (Opsional) Masukkan teks tampilan.

1. (Opsional) Atur warnanya.

1. Pilih **Perbarui** untuk menyimpan pemetaan nilai.

Setelah Anda menambahkan pemetaan, tombol **Edit pemetaan nilai** menggantikan tombol **Tambah** pemetaan nilai. Pilih tombol edit untuk menambah atau memperbarui pemetaan.

# Konfigurasikan ambang batas
<a name="v10-panels-configure-thresholds"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Di dasbor, ambang batas adalah nilai atau batas yang Anda tetapkan untuk metrik yang dipantulkan secara visual saat terpenuhi atau terlampaui. Ambang batas adalah salah satu cara Anda dapat menata dan mewarnai visualisasi Anda secara kondisional berdasarkan hasil kueri.

Anda dapat menggunakan ambang batas untuk:
+ Garis kisi warna atau area kotak kotak dalam visualisasi deret waktu.
+ Warnai latar belakang atau nilai teks dalam visualisasi stat.
+ Tentukan warna wilayah dan wilayah dalam garis waktu negara bagian.
+ Garis warna dalam visualisasi deret waktu.
+ Warnai pengukur dan penanda ambang batas dalam pengukur.
+ Penanda warna dalam geomap.
+ Teks sel warna atau latar belakang dalam tabel.

**Visualisasi yang didukung**
+ Bagan batang
+ Pengukur batang
+ Candlestick
+ Kanvas
+ Pengukur
+ Geomap
+ Histogram
+ Stat
+ Garis waktu negara
+ Riwayat status
+ Tabel
+ Seri waktu
+ Tren

## Ambang batas default
<a name="v10-panels-thresholds-default"></a>

Pada visualisasi yang mendukung ambang batas, Grafana memiliki pengaturan ambang batas default berikut:
+ 80 = merah
+ Basis = hijau
+ Mode = Mutlak
+ Tampilkan ambang = Mati (untuk beberapa visualisasi)

  Untuk informasi selengkapnya, lihat [Tampilkan ambang batas](#v10-panels-thresholds-show).

## Opsi ambang batas
<a name="v10-panels-thresholds-options"></a>

Anda dapat mengatur opsi berikut untuk lebih menentukan bagaimana ambang batas terlihat.

### Nilai ambang batas
<a name="v10-panels-thresholds-value"></a>

Angka ini adalah nilai yang memicu ambang batas. Anda juga dapat mengatur warna yang terkait dengan ambang batas di bidang ini.

Nilai **dasar** mewakili minus tak terhingga. Secara default, itu diatur ke warna hijau, yang umumnya warna “baik”.

### Modus Ambang
<a name="v10-panels-thresholds-mode"></a>

Ada dua mode ambang batas:
+ Ambang batas **absolut** ditentukan oleh angka. Misalnya, 80 pada skala 1 hingga 150.
+ Ambang batas **persentase** didefinisikan relatif terhadap minimum atau maksimum. Misalnya, 80 persen.

### Tampilkan ambang batas
<a name="v10-panels-thresholds-show"></a>

**catatan**  
Opsi ini hanya didukung untuk grafik batang, kandil, deret waktu, dan visualisasi tren.

Tetapkan jika dan bagaimana ambang ditampilkan pada visualisasi dengan opsi berikut.
+ **Off** — Ambang batas tidak ditampilkan.
+ **Sebagai garis** — Ambang batas ditampilkan sebagai garis horizontal pada visualisasi.
+ **Sebagai garis (putus-putus)** — Ambang batas ditampilkan sebagai garis horizontal putus-putus.
+ **Sebagai wilayah yang diisi** - Ambang batas ditampilkan sebagai daerah horizontal.
+ **Sebagai daerah dan garis yang terisi** — Ambang batas ditampilkan sebagai daerah horizontal yang dipisahkan oleh garis.
+ **Sebagai daerah dan garis yang terisi (putus-putus)** — Ambang batas ditampilkan sebagai daerah horizontal yang dipisahkan oleh garis putus-putus.

## Menambahkan ambang batas
<a name="v10-panels-thresholds-add"></a>

Anda dapat menambahkan ambang batas sebanyak mungkin ke visualisasi yang Anda inginkan. Grafana secara otomatis mengurutkan nilai ambang dari tertinggi ke terendah.

**Untuk menambahkan ambang batas**

1. Arahkan ke panel yang ingin Anda perbarui.

1. Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu di sudut kanan atas.

1. Dari menu, pilih **Edit**.

1. Gulir ke bagian **Ambang**, atau masukkan `Thresholds` di bilah pencarian di bagian atas panel edit panel.

1. Pilih **\$1 Tambahkan ambang batas**.

1. Masukkan nilai ambang baru, atau gunakan panah atas dan bawah di sisi kanan bidang untuk menambah atau mengurangi nilai secara bertahap.

1. Klik lingkaran berwarna di sebelah kiri nilai ambang batas untuk membuka pemilih warna, tempat Anda dapat memperbarui warna ambang batas.

1. **Di bawah **mode Ambang**, pilih **Absolute** atau Persentase.**

1. Di bawah **Tampilkan ambang batas**, atur bagaimana ambang ditampilkan, atau matikan.

Untuk menghapus ambang batas, arahkan ke panel yang berisi ambang batas dan pilih ikon sampah di sebelah ambang batas yang ingin Anda hapus.

# Konfigurasikan penggantian bidang
<a name="v10-panels-configure-overrides"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Override memungkinkan Anda untuk menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. Ini dilakukan dengan menambahkan aturan penggantian yang menargetkan sekumpulan bidang tertentu dan yang masing-masing dapat menentukan beberapa opsi.

Misalnya, Anda menyetel unit untuk semua bidang yang menyertakan teks `bytes` dengan menambahkan penggantian menggunakan **Kolom dengan pencocokan nama regex** yang cocok dan kemudian menambahkan opsi Unit ke aturan penggantian.

## Contoh 1: Format suhu
<a name="v10-panels-overrides-format-temperature"></a>

Mari kita asumsikan bahwa kumpulan hasil kita adalah bingkai data yang terdiri dari dua bidang: `time` dan`temperature`.


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45,0 | 
| 2020-01-02 03:05:00 | 47.0 | 
| 2020-01-02 03:06:00 | 48,0 | 

Setiap bidang (kolom) dari struktur ini dapat memiliki opsi bidang yang diterapkan yang mengubah cara nilainya ditampilkan. Ini berarti Anda dapat, misalnya, mengatur Satuan ke Temperature > Celcius, menghasilkan tabel berikut:


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45.0 °C | 
| 2020-01-02 03:05:00 | 47.0 °C | 
| 2020-01-02 03:06:00 | 48.0 °C | 

Selain itu, tempat desimal tidak diperlukan, sehingga kami dapat menghapusnya. Anda dapat mengubah Desimal dari **auto** ke nol (**0**), menghasilkan tabel berikut:


| Waktu | suhu | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 
| 2020-01-02 03:05:00 | 47° C | 
| 2020-01-02 03:06:00 | 48° C | 

## Contoh 2: Format suhu dan kelembaban
<a name="v10-panels-overrides-format-humidity"></a>

Mari kita asumsikan bahwa kumpulan hasil kita adalah bingkai data yang terdiri dari empat bidang:`time`,`high temp`,`low temp`, dan`humidity`.


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45,0 | 30.0 | 67 | 
| 2020-01-02 03:05:00 | 47.0 | 34.0 | 68 | 
| 2020-01-02 03:06:00 | 48,0 | 31.0 | 68 | 

Mari tambahkan unit Celcius dan singkirkan tempat desimal. Ini menghasilkan tabel berikut:


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 30° C | 67° C | 
| 2020-01-02 03:05:00 | 47° C | 34° C | 68° C | 
| 2020-01-02 03:06:00 | 48° C | 31° C | 68° C | 

Bidang suhu terlihat bagus, tetapi kelembabannya sekarang harus diubah. Kita dapat memperbaikinya dengan menerapkan opsi field override ke bidang kelembaban dan mengubah unit menjadi Misc > percent (0-100).


| Waktu | suhu tinggi | suhu rendah | kelembaban | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45° C | 30° C | 67% | 
| 2020-01-02 03:05:00 | 47° C | 34° C | 68% | 
| 2020-01-02 03:06:00 | 48° C | 31° C | 68% | 

## Menambahkan penggantian bidang
<a name="v10-panels-overrides-add-a-field"></a>

Aturan penggantian bidang dapat menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu.

**Untuk menambahkan penggantian bidang**

1. Edit panel yang ingin Anda tambahkan override.

1. Di panel samping opsi panel, pilih **Tambahkan penggantian bidang** di bagian bawah panel.

1. Pilih bidang mana aturan penggantian akan diterapkan ke:
   + **Bidang dengan nama** - Pilih bidang dari daftar semua bidang yang tersedia. Properti yang Anda tambahkan ke aturan dengan pemilih ini hanya diterapkan ke bidang tunggal ini.
   + **Bidang dengan nama yang cocok dengan regex** - Tentukan bidang yang akan diganti dengan ekspresi reguler. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang di mana nama bidang cocok dengan regex. Ini memilih bidang untuk diganti, tetapi tidak mengganti nama bidang; untuk melakukan ini, gunakan transformasi [Rename](v10-panels-xform-functions.md) by regex.
   + **Bidang dengan tipe** - Pilih bidang berdasarkan jenis, seperti string, numerik, dan sebagainya. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang cocok dengan jenis yang dipilih.
   + **Bidang yang dikembalikan oleh kueri** — Pilih semua bidang yang dikembalikan oleh kueri tertentu, seperti A, B, atau C. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang dikembalikan oleh kueri yang dipilih.

1. Pilih **Tambahkan properti override**.

1. Pilih opsi bidang yang ingin Anda terapkan.

1. Masukkan opsi dengan menambahkan nilai di bidang. Untuk mengembalikan opsi ke nilai default, hapus teks putih di bidang.

1. Lanjutkan untuk menambahkan penggantian ke bidang ini dengan memilih **Tambahkan properti penggantian**, atau Anda dapat memilih **Tambahkan penggantian** dan pilih bidang lain untuk menambahkan penggantian.

1. Setelah selesai, pilih **Simpan** untuk menyimpan semua pengeditan panel ke dasbor.

## Menghapus penggantian bidang
<a name="v10-panels-overrides-delete-a-field"></a>

Hapus penggantian bidang saat Anda tidak lagi membutuhkannya. Saat Anda menghapus override, tampilan nilai default ke format aslinya. Perubahan ini berdampak pada dasbor dan pengguna dasbor yang mengandalkan panel yang terpengaruh.

**Untuk menghapus penggantian bidang**

1. Edit panel yang berisi penggantian yang ingin Anda hapus.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

1. Pilih penggantian yang ingin Anda hapus lalu pilih ikon sampah terkait.

## Melihat penggantian bidang
<a name="v10-panels-overrides-view"></a>

Anda dapat melihat penggantian bidang di opsi tampilan panel.

1. Edit panel yang berisi penggantian yang ingin Anda lihat.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

**catatan**  
Pengaturan override yang muncul di tab **Semua** sama dengan pengaturan yang muncul di tab **Overrides**.

## Mengedit penggantian bidang
<a name="v10-panels-overrides-edit-a-field"></a>

Edit penggantian bidang saat Anda ingin membuat perubahan pada setelan penggantian. Perubahan yang Anda buat segera berlaku.

**Untuk mengedit penggantian bidang**

1. Edit panel yang berisi penggantian yang ingin Anda edit.

1. Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian.

1. Temukan penggantian yang ingin Anda ubah.

1. Lakukan salah satu dari yang berikut:
   + Edit pengaturan pada penggantian yang ada atau parameter pemilihan bidang.
   + Hapus properti override yang ada dengan memilih **X** di sebelah properti.
   + Tambahkan properti override dengan memilih **Tambahkan properti override**.

# Visualisasi tersedia dalam Grafana versi 10
<a name="v10-panels-viz"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana menawarkan berbagai visualisasi untuk mendukung kasus penggunaan yang berbeda. Bagian dokumentasi ini menyoroti visualisasi bawaan, opsi dan penggunaan tipikal.

Panel umum untuk memulai, dan untuk mempelajari dasar-dasar menggunakan panel, adalah [Deret waktu](v10-panels-time-series.md) panel.

**catatan**  
Jika Anda tidak yakin visualisasi mana yang harus dipilih, Grafana dapat memberikan saran visualisasi berdasarkan kueri panel. Saat Anda memilih visualisasi, Grafana akan menampilkan pratinjau dengan visualisasi yang diterapkan.
+ Grafik & grafik
  + [Deret waktu](v10-panels-time-series.md) adalah visualisasi Grafik default dan utama.
  + [Garis waktu negara](v10-panels-state-timeline.md) untuk perubahan status dari waktu ke waktu.
  + [Riwayat status](v10-panels-status-history.md) untuk keadaan periodik dari waktu ke waktu.
  + [Bagan batang](v10-panels-bar-chart.md) menunjukkan data kategoris apa pun.
  + [Histogram](v10-panels-histogram.md) menghitung dan menunjukkan distribusi nilai dalam diagram batang.
  + [Heatmap](v10-panels-heatmap.md) memvisualisasikan data dalam dua dimensi, biasanya digunakan untuk besarnya suatu fenomena.
  + [Pie chart](v10-panels-piechart.md) biasanya digunakan di mana proporsionalitas penting.
  + [Candlestick](v10-panels-candlestick.md) biasanya untuk data keuangan di mana fokusnya adalah price/data pergerakan.
  + [Gauge](v10-panels-gauge.md) adalah visual bulat tradisional yang menunjukkan seberapa jauh satu metrik dari ambang batas.
  + [Tren](v10-panels-trend.md) untuk dataset yang memiliki urutan, numerik x yang bukan waktu.
  + [XY Chart](v10-panels-xychart.md) menyediakan cara untuk memvisualisasikan nilai x dan y arbitrer dalam grafik.
+ Statistik & angka
  + [Stat](v10-panels-stat.md) untuk statistik besar dan sparkline opsional.
  + [Bar gauge](v10-panels-bar-gauge.md) adalah bar gauge horizontal atau vertikal.
+ Lain-lain
  + [Tabel](v10-panels-table.md) adalah visualisasi tabel utama dan satu-satunya.
  + [Log](v10-panels-logs.md) adalah visualisasi utama untuk log.
  + [Grafik simpul](v10-panels-node-graph.md) untuk grafik atau jaringan terarah.
  + [Jejak](v10-panels-traces.md) adalah visualisasi utama untuk jejak.
  + [Grafik api](v10-panels-flamegraph.md) adalah visualisasi utama untuk pembuatan profil.
  + [Geomap](v10-panels-geomap.md) membantu Anda memvisualisasikan data geospasial.
  + [Datagrid](v10-panels-datagrid.md) memungkinkan Anda untuk membuat dan memanipulasi data, dan bertindak sebagai sumber data untuk panel lain.
+ Widget
  + [Daftar dasbor](v10-panels-dashboard-list.md) dapat mencantumkan dasbor.
  + [Daftar peringatan](v10-panels-alert-list.md) dapat mencantumkan peringatan.
  + [Teks](v10-panels-text.md) dapat menampilkan penurunan harga dan html.
  + [Berita](v10-panels-news.md) dapat menampilkan umpan RSS.

## Dapatkan lebih banyak
<a name="v10-panels-getmore"></a>

Anda dapat menambahkan lebih banyak jenis visualisasi dengan menginstal plugin panel dari file. [Temukan plugin dengan katalog plugin](grafana-plugins.md#plugin-catalog)

## Contoh
<a name="v10-panels-examples"></a>

Di bagian berikut Anda dapat menemukan contoh visualisasi.

## Grafik
<a name="v10-panels-ex-graphs"></a>

Untuk grafik garis, area, dan batang berbasis waktu, kami merekomendasikan visualisasi [deret waktu](v10-panels-time-series.md) default.

![\[Gambar yang menunjukkan contoh visualisasi deret waktu di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/time_series_example.png)


Untuk data kategoris, gunakan diagram [batang](v10-panels-bar-chart.md).

![\[Gambar yang menunjukkan contoh visualisasi diagram batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/barchart_example.png)


## Angka besar & statistik
<a name="v10-panels-ex-numbers"></a>

Visualisasi [stat](v10-panels-stat.md) menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau nilai warna menggunakan ambang batas atau skala warna.

![\[Gambar yang menunjukkan contoh visualisasi stat di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/stat_panel_example.png)


## Pengukur
<a name="v10-panels-ex-gauge"></a>

Jika Anda ingin menyajikan nilai yang berkaitan dengan nilai min dan maks, Anda memiliki dua opsi. Pertama [pengukur](v10-panels-gauge.md) radial standar:

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/gauge_example.png)


Kedua, Grafana juga memiliki [pengukur batang](v10-panels-bar-gauge.md) horizontal atau vertikal dengan tiga mode tampilan berbeda.

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Tabel
<a name="v10-panels-ex-table"></a>

Untuk menampilkan data dalam tata letak tabel, gunakan visualisasi [tabel](v10-panels-table.md).

![\[Gambar yang menunjukkan contoh visualisasi tabel di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/table_example.png)


## Bagan pai
<a name="v10-panels-ex-piechart"></a>

Untuk menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, gunakan visualisasi [diagram lingkaran](v10-panels-piechart.md).

![\[Gambar yang menunjukkan contoh visualisasi diagram lingkaran di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/pie_chart_example.png)


## Peta panas
<a name="v10-panels-ex-heatmaps"></a>

Untuk menampilkan distribusi nilai dari waktu ke waktu, gunakan [visualisasi peta panas](v10-panels-heatmap.md).

![\[Gambar yang menunjukkan contoh visualisasi peta panas di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Garis waktu negara
<a name="v10-panels-ex-state"></a>

[Garis waktu status](v10-panels-state-timeline.md) menunjukkan perubahan status diskrit dari waktu ke waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

![\[Gambar yang menunjukkan contoh visualisasi garis waktu status di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/state_timeline_example.png)


# Daftar peringatan
<a name="v10-panels-alert-list"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan daftar peringatan untuk menampilkan peringatan Anda. Anda dapat mengonfigurasi daftar untuk menampilkan status saat ini. Untuk informasi selengkapnya tentang peringatan, lihat[Peringatan di Grafana versi 10](v10-alerts.md).

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi
<a name="v10-panels-alert-list-options"></a>
+ **Mode grup** - Pilih antara **pengelompokan Default** untuk menampilkan instance peringatan yang dikelompokkan berdasarkan aturan peringatan mereka, dan **Pengelompokan khusus untuk mengelompokkan** instance peringatan dengan kumpulan label khusus.
+ **Item Maks** - Atur jumlah maksimum peringatan ke daftar.
+ **Urutkan urutan** - Pilih cara memesan peringatan yang ditampilkan.
  + **Abjad (asc)** — Urutan abjad
  + **Alfabetis (desc)** - Urutan abjad terbalik
  +  **Pentingnya** — Dengan kepentingan menurut nilai-nilai berikut, dengan 1 menjadi yang tertinggi:
    + `alerting`atau`firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused`atau`inactive`: 5
  + **Waktu (asc)** - Instans peringatan aktif terbaru terlebih dahulu.
  + **Waktu (desc)** - Instance peringatan aktif tertua terlebih dahulu.
+  **Peringatan dari dasbor ini** - Tampilkan peringatan hanya dari dasbor tempat daftar peringatan berada.

## Filter
<a name="v10-panels-alert-filter"></a>

Opsi ini memungkinkan Anda membatasi peringatan yang ditampilkan hanya untuk yang cocok dengan kueri, folder, atau tag yang Anda pilih:
+ **Nama peringatan** - Masukkan kueri nama peringatan.
+ **Label instance peringatan** - Filter instance peringatan menggunakan kueri label. Misalnya, `{severity="critical", instance=~"cluster-us-.+"}`.
+ **Folder** — Pilih folder. Hanya peringatan dari dasbor di folder yang dipilih yang akan ditampilkan.
+ **Sumber Data - Filter peringatan dari sumber** data yang dipilih.

## Filter negara
<a name="v10-panels-alert-state-filter"></a>

Pilih status peringatan mana yang akan ditampilkan di panel ini.
+ Peringatan/Penembakan
+ Tertunda
+ Tidak ada data
+ Normal
+ Kesalahan

# Daftar anotasi
<a name="v10-panels-annotations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Daftar Anotasi menampilkan daftar anotasi yang tersedia yang dapat Anda gunakan untuk melihat data beranotasi. Berbagai opsi tersedia untuk memfilter daftar berdasarkan tag dan pada dasbor saat ini.

## Kueri anotasi
<a name="v10-panels-annotations-query"></a>

Opsi berikut mengontrol kueri sumber untuk daftar anotasi.

**Filter Kueri**

Gunakan filter kueri untuk membuat daftar anotasi dari semua dasbor di organisasi Anda atau dasbor saat ini di mana panel ini berada. Ini memiliki opsi berikut:
+ Semua dasbor - Daftar anotasi dari semua dasbor di organisasi saat ini.
+ Dasbor ini - Batasi daftar ke anotasi di dasbor saat ini.

**Rentang waktu**

Gunakan opsi rentang waktu untuk menentukan apakah daftar harus dibatasi pada rentang waktu saat ini. Ini memiliki opsi berikut:
+ Tidak ada - tidak ada batas rentang waktu untuk kueri anotasi.
+ Dasbor ini - Batasi daftar ke rentang waktu dasbor tempat panel daftar anotasi tersedia.

**Tanda**

Gunakan opsi tag untuk memfilter anotasi berdasarkan tag. Anda dapat menambahkan beberapa tag untuk memperbaiki daftar.

**catatan**  
Secara opsional, biarkan daftar tag kosong dan filter dengan cepat dengan memilih tag yang terdaftar sebagai bagian dari hasil pada panel itu sendiri.

**Batasi**

Gunakan opsi batas untuk membatasi jumlah hasil yang dikembalikan.

## Tampilan
<a name="v10-panels-annotations-display"></a>

Opsi ini mengontrol metadata tambahan yang disertakan dalam tampilan panel anotasi.

**Tampilkan pengguna**

Gunakan opsi ini untuk menampilkan atau menyembunyikan pengguna mana yang membuat anotasi.

**Tampilkan waktu**

Gunakan opsi ini untuk menampilkan atau menyembunyikan waktu pembuatan anotasi.

**Tampilkan Tag**

Gunakan opsi ini untuk menampilkan atau menyembunyikan tag yang terkait dengan anotasi. *NB*: Anda dapat menggunakan tag untuk memfilter langsung daftar anotasi pada visualisasi itu sendiri.

## Tautkan perilaku
<a name="v10-panels-annotations-links"></a>

**Target tautan**

Gunakan opsi ini untuk memilih cara melihat data beranotasi. Ini memiliki opsi berikut.
+ Panel - Opsi ini akan membawa Anda langsung ke tampilan layar penuh panel dengan anotasi yang sesuai
+ Dasbor - Opsi ini akan memfokuskan anotasi dalam konteks dasbor lengkap

**Waktu sebelumnya**

Gunakan opsi ini untuk mengatur rentang waktu sebelum anotasi. Gunakan nilai string durasi seperti “1h” = 1 jam, “10m” = 10 menit, dll.

**Waktu setelahnya**

Gunakan opsi ini untuk mengatur rentang waktu setelah anotasi.

# Bagan batang
<a name="v10-panels-bar-chart"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Bagan batang memungkinkan Anda untuk membuat grafik data kategoris.

![\[Gambar yang menunjukkan contoh visualisasi bagan batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/barchart_example.png)


## Format data yang didukung
<a name="v10-panels-bar-chart-formats"></a>

Hanya satu frame data yang didukung dan perlu memiliki setidaknya satu bidang string yang akan digunakan sebagai kategori untuk sumbu X atau Y dan satu atau lebih bidang numerik. Berikut ini adalah contoh format data:


| Peramban | Pangsa pasar | 
| --- | --- | 
| Chrome | 50 | 
| Penjelajah Internet | 17.5 | 

Jika Anda memiliki lebih dari satu bidang numerik, panel menampilkan bilah yang dikelompokkan.

### Memvisualisasikan deret waktu atau beberapa set hasil
<a name="v10-panels-bar-chart-visualization"></a>

Jika Anda memiliki beberapa deret waktu atau tabel, pertama-tama Anda harus bergabung dengan mereka menggunakan gabungan, atau mengurangi transformasi. Misalnya, jika Anda memiliki beberapa deret waktu dan Anda ingin membandingkan nilai terakhir dan maksnya, tambahkan **Kurangi** transformasi dan tentukan **Maks** dan **Terakhir** sebagai opsi di bawah **Perhitungan**.

## Opsi bagan batang
<a name="v10-panels-bar-chart-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.

**Orientasi**
+ **Otomatis** — Grafana memutuskan orientasi batang berdasarkan dimensi panel.
+ **Horizontal** - Menjadikan sumbu X sebagai sumbu kategori.
+ **Vertikal — Menjadikan** sumbu Y sebagai sumbu kategori.

**Putar label centang sumbu x**

 Ketika grafik berorientasi vertikal, pengaturan ini memutar label di bawah bilah. Pengaturan ini berguna ketika label diagram batang panjang dan tumpang tindih.

**Panjang maksimum label centang sumbu X**

Menetapkan panjang maksimum label bagan batang. Label yang lebih panjang dari panjang maksimum dipotong dengan elips.

**Label batang spasi minimum**

Menetapkan jarak minimum antara label bar.

**Tampilkan nilai**

Mengontrol apakah nilai ditampilkan di atas atau di sebelah kiri bar.
+ **Auto** - Nilai ditampilkan jika ada spasi.
+ **Selalu** — Selalu tunjukkan nilai.
+ **Jangan pernah** - Jangan pernah menunjukkan nilai.

**Penumpukan**

Mengontrol penumpukan bagan batang.
+ **Off** — Bar tidak akan ditumpuk.
+ **Normal** — Bar akan ditumpuk di atas satu sama lain.
+ **Persen** — Bar akan ditumpuk di atas satu sama lain, dan tinggi setiap bar adalah persentase dari total tinggi tumpukan.

**Lebar kelompok**

Mengontrol lebar grup.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Lebar bar**

Mengontrol lebar bar.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Radius batang**

Mengontrol radius bar.
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**Sorot area penuh saat melayang**

Kontrol jika seluruh area sekitar bilah disorot saat Anda mengarahkan kursor ke bilah.

**Lebar garis**

Kontrol lebar garis bar.

**Isi opacity**

Mengontrol opasitas isian bilah.

**Mode gradien**

Mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.
+ **Tidak ada** - tidak ada pengisian gradien. Ini adalah pengaturan default.
+ **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+ **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip**

Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

**catatan**  
Anda dapat menggunakan override untuk menyembunyikan seri individual dari tooltip.

**Ukuran teks**

Masukkan nilai untuk mengubah ukuran teks pada diagram batang Anda.

## Opsi legenda
<a name="v10-panels-bar-chart-legend"></a>

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya, lihat [Konfigurasikan legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menempatkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih nilai data seri atau perhitungan standar untuk ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu. Untuk informasi selengkapnya, lihat [Konfigurasikan legenda](v10-panels-configure-legend.md).

## Opsi sumbu
<a name="v10-panels-bar-chart-axis"></a>

Gunakan pengaturan bidang berikut untuk menyempurnakan tampilan sumbu Anda. Beberapa opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter.

**Penempatan**

Mengatur penempatan sumbu Y.
+ **Otomatis** - Grafana secara otomatis menetapkan sumbu Y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, maka Grafana menetapkan sumbu kiri ke unit pertama dan kanan ke unit berikut.
+ **Kiri** - Tampilkan semua sumbu Y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu Y di sisi kanan.
+ **Tersembunyi** — Sembunyikan semua sumbu Y.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang](v10-panels-configure-overrides.md) yang menargetkan bidang tertentu.

**Label**

Tetapkan label teks sumbu Y. Jika Anda memiliki lebih dari satu sumbu Y, maka Anda dapat menetapkan label yang berbeda dengan override.

**Lebar**

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Ini membuatnya lebih mudah untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau diregangkan dalam kedekatan visual satu sama lain.

**Soft min dan soft max**

Tetapkan opsi soft min atau soft max untuk kontrol batas sumbu Y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu Y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah blip berubah menjadi pegunungan ketika data sebagian besar datar, dan min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik yang ditentukan.

Anda dapat mengatur min/max opsi standar untuk menentukan batas keras sumbu Y. Untuk informasi selengkapnya, lihat [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md).

**Tampilkan beberapa sumbu y**

Dalam beberapa kasus, Anda mungkin ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda mungkin ingin menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Anda dapat melakukan ini dengan [menambahkan penggantian bidang](v10-panels-configure-overrides.md). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

# Pengukur batang
<a name="v10-panels-bar-gauge"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pengukur batang menyederhanakan data Anda dengan mengurangi setiap bidang menjadi satu nilai. Anda memilih bagaimana Grafana menghitung reduksi.

Panel ini dapat menampilkan satu atau beberapa pengukur batang tergantung pada berapa banyak seri, baris, atau kolom yang dikembalikan kueri Anda.

![\[Gambar yang menunjukkan contoh visualisasi pengukur batang di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Opsi nilai
<a name="v10-panels-bar-gauge-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

**Hitung**

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).
+ **Bidang** - Pilih tampilan bidang di panel.

**Semua nilai**

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
+ **Bidang** - Pilih tampilan bidang di panel.

## Opsi pengukur batang
<a name="v10-panels-bar-gauge-options"></a>

Sesuaikan bagaimana pengukur batang ditampilkan.

**Orientasi**

Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari bawah ke atas.

**Mode tampilan**

Pilih mode tampilan.
+ **Gradien** — Tingkat ambang batas menentukan gradien.
+ **Retro LCD** — Pengukur dibagi menjadi sel-sel kecil yang menyala atau tidak menyala.
+ **Dasar** - Warna tunggal berdasarkan ambang pencocokan.

**Tampilan nilai**

Pilih mode tampilan nilai.
+ **Nilai warna** — Nilai warna ditentukan oleh nilai.
+ **Warna teks** - Warna nilai adalah warna teks default.
+ **Tersembunyi** — Nilai disembunyikan.

**Penempatan nama**

Pilih mode penempatan nama.

**catatan**  
Opsi ini hanya berlaku ketika orientasi pengukur batang horisontal. Ketika pengukur batang berada dalam orientasi vertikal, nama selalu ditempatkan di bagian bawah setiap pengukur batang.
+ **Otomatis** — Grafana menentukan penempatan terbaik.
+ **Atas** - Nama ditempatkan di bagian atas setiap pengukur batang.
+ **Kiri** — Nama ditempatkan di sebelah kiri setiap pengukur batang.

**Tampilkan area yang tidak terisi**

Pilih ini jika Anda ingin membuat wilayah bar yang tidak terisi sebagai abu-abu gelap. Tidak berlaku untuk mode tampilan LCD Retro.

**Ukuran bar**

Pilih mode ukuran bar.
+ **Otomatis** — Grafana menentukan ukuran pengukur batang terbaik.
+ **Manual** - Konfigurasikan ukuran pengukur batang secara manual.

**Lebar min**

Batasi lebar minimum kolom batang saat pengukur diorientasikan secara vertikal.

Secara otomatis menampilkan bilah gulir sumbu x ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

**Tinggi min**

Batasi ketinggian minimum baris batang saat pengukur diorientasikan secara horizontal.

Secara otomatis menampilkan bilah gulir sumbu y ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

**Tinggi maks**

Batasi ketinggian maksimum baris batang saat pengukur diorientasikan secara horizontal.

Secara otomatis menampilkan bilah gulir sumbu y ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran batang diatur ke manual.

# Candlestick
<a name="v10-panels-candlestick"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi Candlestick memungkinkan Anda untuk memvisualisasikan data yang mencakup sejumlah dimensi konsisten yang berfokus pada pergerakan harga. Panel Candlestick mencakup mode Open-High-Low-Close (OHLC), serta dukungan untuk dimensi tambahan berdasarkan data deret waktu.

![\[Gambar yang menunjukkan contoh visualisasi kandil di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


Visualisasi candlestick dibangun di atas dasar [Deret waktu](v10-panels-time-series.md) dan mencakup banyak pengaturan konfigurasi umum.

## Modus
<a name="v10-panels-candlestick-mode"></a>

Opsi mode memungkinkan Anda untuk beralih dimensi mana yang digunakan untuk visualisasi.
+ **Lilin** — Batasi dimensi panel ke dimensi terbuka, tinggi, rendah, dan dekat yang digunakan oleh visualisasi kandil.
+ **Volume** — Batasi dimensi panel ke dimensi volume.
+ **Keduanya** — Perilaku default untuk panel kandil. Ini mencakup visualisasi kandil dan volume.

## Gaya lilin
<a name="v10-panels-candlestick-style"></a>
+ **Lilin** — Gaya tampilan default, menciptakan visualisasi gaya lilin antara dimensi terbuka dan dekat.
+ **OHLC Bars** - Menampilkan empat dimensi inti nilai terbuka, tinggi, rendah, dan dekat.

## Strategi warna
<a name="v10-panels-candlestick-color"></a>
+ **Sejak Terbuka** — Perilaku default. Mode ini akan memanfaatkan warna *Naik* (bawah) jika pergerakan harga intra-periode positif. Dengan kata lain, jika nilai pada penutupan lebih besar atau sama dengan nilai pada open, warna *Up* digunakan.
+ **Sejak Penutupan Sebelumnya** — Metode tampilan alternatif di mana warna lilin didasarkan pada pergerakan harga antar-periode atau perubahan nilai. Dengan kata lain, jika nilai pada open lebih besar dari nilai sebelumnya pada close, warna *Up* digunakan. Jika nilai pada open lebih rendah dari nilai sebelumnya pada penutupan, warna *Down* digunakan. *Opsi ini juga memicu mode visualisasi kandil berongga*. Candlestick berongga menunjukkan bahwa pergerakan intra-periode positif (nilai lebih tinggi pada penutupan daripada saat terbuka), kandil yang diisi menunjukkan perubahan intra-periode negatif (nilai lebih rendah pada penutupan daripada pada pembukaan). Untuk mempelajari lebih lanjut, lihat [penjelasan perbedaannya](https://thetradingbible.com/how-to-read-hollow-candlesticks).

## Warna naik & turun
<a name="v10-panels-candlestick-updown"></a>

Opsi **warna Naik** **dan Bawah** memilih warna mana yang digunakan saat pergerakan harga naik atau turun. *Strategi Warna* di atas akan menentukan apakah pergerakan harga intra-periode atau antar-periode digunakan untuk memilih warna candle atau OHLC bar.

## Buka, tinggi, rendah, tutup
<a name="v10-panels-candlestick-ohlc"></a>

Panel kandil akan mencoba memetakan bidang ke dimensi yang sesuai.
+ **Buka** sesuai dengan nilai awal periode yang diberikan.
+ **Tinggi** sesuai dengan nilai tertinggi dari periode yang diberikan.
+ **Rendah** sesuai dengan nilai terendah dari periode tertentu.
+ **Tutup** sesuai dengan nilai akhir (akhir) dari periode yang diberikan.
+ **Volume** sesuai dengan jumlah sampel dalam periode tertentu. (misalnya jumlah perdagangan)

**catatan**  
Legenda kandil tidak menampilkan nilai-nilai ini.

Untuk memetakan dimensi ini dengan benar, tabel hasil kueri dari data Anda harus menyertakan *setidaknya* kolom berikut.
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

Jika data Anda tidak dapat dipetakan ke dimensi ini karena alasan tertentu (misalnya, karena nama kolom tidak sama), Anda dapat memetakannya secara manual menggunakan bidang **Buka**, **Tinggi**, **Rendah**, dan **Tutup** di bawah opsi **Candlestick** di editor panel.

## Bidang tambahan
<a name="v10-panels-candlestick-other"></a>

**Bidang tambahan**

Panel kandil didasarkan pada visualisasi deret waktu. Ini dapat memvisualisasikan dimensi data tambahan di luar terbuka, tinggi, rendah, dekat, dan volume. Opsi **Sertakan** dan **Abaikan** memungkinkannya untuk memvisualisasikan data lain yang disertakan seperti rata-rata bergerak sederhana, Bollinger band, dan lainnya, menggunakan gaya dan konfigurasi yang sama yang tersedia di. [Deret waktu](v10-panels-time-series.md)

# Kanvas
<a name="v10-panels-canvas"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Kanvas menggabungkan kekuatan Grafana dengan fleksibilitas elemen khusus. Kanvas adalah panel form-built yang dapat diperluas yang memungkinkan Anda menempatkan elemen secara eksplisit dalam tata letak statis dan dinamis. Ini memberdayakan Anda untuk merancang visualisasi khusus dan overlay data dengan cara yang tidak mungkin dilakukan dengan panel Grafana standar, semuanya dalam UI Grafana. Jika Anda telah menggunakan UI populer dan alat desain web, maka merancang panel Canvas akan terasa sangat akrab.

## Elemen
<a name="v10-panels-canvas-elements"></a>

Anda dapat menambahkan elemen-elemen ini di kanvas Anda. Menambahkan beberapa, dan berbagai jenis, elemen memungkinkan Anda menyesuaikan visualisasi dengan cara yang tidak mungkin dilakukan dengan visualisasi lainnya.

**Nilai metrik**

Elemen nilai metrik memungkinkan Anda dengan mudah memilih data yang ingin Anda tampilkan di kanvas. Elemen ini memiliki mode *edit* unik yang dapat dipicu baik melalui menu konteks **Edit** opsi atau dengan mengklik dua kali panel. Saat dalam mode edit Anda dapat memilih data bidang mana yang ingin Anda tampilkan.

**Teks**

Elemen teks memungkinkan Anda dengan mudah menambahkan teks ke kanvas. Elemen ini juga mendukung mode pengeditan, dipicu melalui mengklik dua kali atau opsi menu edit di menu konteks.

**elips**

Elemen elips memungkinkan Anda menambahkan elips dasar ke kanvas. Elemen elips dapat menampilkan teks (data tetap dan bidang) dan warna latar belakangnya dapat diubah berdasarkan ambang data.

**Persegi Panjang**

Elemen persegi panjang memungkinkan Anda untuk menambahkan persegi panjang dasar ke kanvas. Sebuah elemen persegi panjang dapat menampilkan teks (baik data tetap dan bidang) dan warna latar belakangnya dapat diubah berdasarkan ambang data.

**Ikon**

Elemen ikon memungkinkan Anda menambahkan ikon yang didukung ke kanvas. Ikon dapat memiliki warna yang ditetapkan berdasarkan ambang batas atau pemetaan nilai.

**Peladen**

Elemen server memungkinkan Anda dengan mudah mewakili satu server, tumpukan server, database, atau terminal. Elemen server mendukung warna status, warna bohlam, dan tingkat kedipan bohlam, semuanya dapat dikonfigurasi dengan nilai tetap atau bidang.

**Tombol**

Elemen tombol memungkinkan Anda menambahkan tombol dasar ke kanvas. Elemen tombol mendukung pemicu panggilan API dasar yang tidak diautentikasi. Pengaturan API ditemukan di editor elemen tombol. Anda juga dapat meneruskan variabel template di editor API.

**catatan**  
Memilih tombol hanya akan memicu panggilan API saat pengeditan sebaris dinonaktifkan. Lihat [Pengeditan kanvas](#v10-panels-canvas-editing).

## Koneksi
<a name="v10-panels-canvas-connections"></a>

Saat membuat kanvas, Anda dapat menghubungkan elemen bersama untuk membuat visualisasi yang lebih kompleks. Anda dapat membuat koneksi dengan menyeret dari jangkar koneksi satu elemen ke jangkar koneksi elemen lain. Anda juga dapat membuat koneksi ke latar belakang kanvas. Jangkar koneksi ditampilkan saat Anda mengarahkan kursor ke elemen dan pengeditan sebaris dihidupkan. Untuk menghapus koneksi, pilih koneksi dan kemudian tekan `Delete` atau`Backspace`.

Anda dapat mengatur ukuran dan warna koneksi berdasarkan nilai tetap atau bidang. Untuk melakukannya, masuk ke mode edit panel, pilih koneksi, dan ubah properti koneksi di editor panel.

## Pengeditan kanvas
<a name="v10-panels-canvas-editing"></a>

**Editor sebaris**

Anda dapat mengedit kanvas Anda sebaris saat dalam konteks mode dasbor.

**Pan dan zoom**

Anda dan nyalakan panning dan zoom di kanvas. Ini memungkinkan Anda untuk membuat dan menavigasi desain yang lebih kompleks.

**catatan**  
Pan dan zoom saat ini sedang dalam pratinjau oleh Grafana Labs. Support terbatas, dan perubahan yang melanggar mungkin terjadi sebelum ketersediaan umum.

**Menu konteks**

Menu konteks memungkinkan Anda melakukan tugas-tugas umum dengan cepat dan efisien. Fungsionalitas yang didukung termasuk membuka dan menutup editor inline, menduplikasi elemen, menghapus elemen, dan banyak lagi.

Menu konteks dipicu oleh tindakan klik kanan (atau setara) di atas panel atau elemen kanvas yang diberikan.

Saat mengklik *kanan panel*, Anda dapat mengatur gambar latar belakang dan dengan mudah menambahkan elemen ke kanvas.

Saat mengklik kanan *elemen*, Anda dapat mengedit, menghapus, dan menduplikasi elemen, atau memodifikasi posisi lapisan elemen.

## Opsi Kanvas
<a name="v10-panels-canvas-options"></a>

**Pengeditan sebaris**

Toggle pengeditan sebaris memungkinkan Anda mengunci atau membuka kunci panel kanvas. Saat dimatikan, panel kanvas menjadi *terkunci*, membekukan elemen di tempatnya dan mencegah modifikasi yang tidak diinginkan.

**Tautan data**

Kanvas mendukung tautan [data](v10-panels-configure-data-links.md). Anda dapat membuat tautan data untuk elemen nilai metrik dan menampilkannya untuk semua elemen yang menggunakan nama bidang dengan mengikuti langkah-langkah ini.

**Untuk membuat link data untuk elemen**

1. Tetapkan elemen yang akan diikat ke nilai bidang.

1. Matikan sakelar pengeditan sebaris.

1. Buat penggantian untuk **Fields dengan nama** dan pilih nama bidang elemen dari daftar.

1. Pilih tombol **\$1 Tambahkan properti ganti**.

1. Pilih **Datalinks > Datalinks** dari daftar.

1. Pilih **\$1 Tambahkan tautan**, tambahkan judul dan URL untuk tautan data.

1. Arahkan kursor ke elemen untuk menampilkan tooltip tautan data.

1. Pilih elemen untuk dapat membuka tautan data.

Jika beberapa elemen menggunakan nama bidang yang sama, dan Anda ingin mengontrol elemen mana yang menampilkan tautan data, Anda dapat membuat nama bidang unik menggunakan [Tambahkan bidang dari perhitungan](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) transformasi. Alias yang Anda buat dalam transformasi akan muncul sebagai bidang yang dapat Anda gunakan dengan elemen.

# Daftar dasbor
<a name="v10-panels-dashboard-list"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Daftar dasbor memungkinkan Anda menampilkan tautan dinamis ke dasbor lain. Daftar ini dapat dikonfigurasi untuk menggunakan dasbor berbintang, dasbor yang baru dilihat, kueri penelusuran, dan tag dasbor.

Pada setiap pemuatan dasbor, panel ini menanyakan daftar dasbor, selalu memberikan up-to-date hasil terbanyak.

**Pilihan**

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.
+ **Sertakan rentang waktu saat** ini - Pilih opsi ini untuk menyebarkan rentang waktu dasbor saat ini ke tautan dasbor. Saat pengguna memilih tautan, dasbor yang ditautkan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
+ **Sertakan nilai variabel template saat** ini - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri dalam tautan. Saat pengguna memilih tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari daftar. Untuk informasi selengkapnya, lihat [Variabel URL dasbor](v10-dash-dashboard-url-variables.md).
+ **Dibintangi** - Tampilkan dasbor berbintang dalam urutan abjad.
+ **Baru-baru ini dilihat** - Tampilkan dasbor yang baru dilihat dalam urutan abjad.
+ **Cari** - Tampilkan dasbor berdasarkan permintaan pencarian atau tag. Anda harus memasukkan setidaknya satu nilai dalam **Kueri** atau **Tag**. Untuk bidang **Query** dan **Tags**, interpolasi variabel didukung, misalnya, `$my_var` atau. `${my_var}`
+ **Tampilkan judul** - Pilihan daftar yang dipilih (Dibintangi, Baru dilihat, Pencarian) ditampilkan sebagai judul.
+ **Max item** - Menetapkan jumlah maksimum item untuk daftar per bagian. Misalnya, jika Anda meninggalkan ini pada nilai default 10 dan ditampilkan Dasbor Berbintang dan Baru dilihat, maka panel akan menampilkan hingga 20 dasbor total, sepuluh di setiap bagian.

**Cari**

Opsi ini hanya berlaku jika opsi **Pencarian** dipilih.
+ **Query** — Masukkan kueri yang ingin Anda cari. Kueri tidak peka huruf besar/kecil, dan sebagian nilai diterima.
+ **Folder** — Pilih folder dasbor yang ingin Anda tampilkan.
+ **Tag** — Di sinilah Anda memasukkan tag yang ingin Anda cari. *Tag yang ada tidak akan muncul saat Anda mengetik, dan mereka peka huruf besar/kecil.*

**catatan**  
Ketika beberapa tag dan string muncul, daftar dasbor menampilkan yang cocok dengan *semua* kondisi.

# Datagrid
<a name="v10-panels-datagrid"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

**catatan**  
Visualisasi grid data saat ini sedang dalam pratinjau oleh Grafana Labs. Support terbatas, dan perubahan yang melanggar mungkin terjadi sebelum ketersediaan umum.

Datagrids menawarkan Anda kemampuan untuk membuat, mengedit, dan menyempurnakan data dalam Grafana. Dengan demikian, panel ini dapat bertindak sebagai sumber data untuk panel lain di dalam dasbor.

![\[Gambar yang menunjukkan contoh visualisasi datagrid di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


Melalui itu, Anda dapat memanipulasi data yang ditanyakan dari sumber data apa pun, Anda dapat memulai dari batu tulis kosong, atau Anda dapat menarik data dari file yang diseret dan dijatuhkan. Anda kemudian dapat menggunakan panel sebagai visualisasi tabel sederhana, atau Anda dapat memodifikasi data—dan bahkan menghapusnya sama sekali—untuk membuat batu tulis kosong.

Mengedit kumpulan data mengubah sumber data untuk menggunakan sumber data **Grafana** bawaan, menggantikan pengaturan sumber data lama dan kueri terkait, sementara juga menyalin kumpulan data saat ini ke dalam model dasbor.

Anda kemudian dapat menggunakan panel sebagai sumber data untuk panel lain, dengan menggunakan sumber data **Dasbor** bawaan untuk menarik data datagrid. Ini memberikan pengalaman dasbor interaktif, di mana Anda dapat memodifikasi data dan melihat perubahan yang tercermin di panel lain.

Untuk informasi selengkapnya tentang sumber data **Grafana** dan **Dasbor**, lihat. [Sumber data khusus](AMG-data-sources.md#AMG-data-sources-special)

## Menu konteks
<a name="v10-panels-datagrid-context"></a>

Untuk memberikan pengalaman yang lebih efisien, datagrid memiliki menu konteks yang dapat diakses dengan mengklik kanan pada sel, header kolom, atau pemilih baris. Bergantung pada status datagrid Anda, menu konteks menawarkan opsi yang berbeda termasuk yang berikut ini.
+ Hapus atau hapus semua baris dan kolom.
+ Hapus semua data yang ada (membuat datagrid Anda kosong).
+ Memicu fungsionalitas pencarian, yang memungkinkan Anda menemukan kata kunci dalam kumpulan data.

Menghapus baris atau kolom akan menghapus data dari datagrid, sementara membersihkan baris atau kolom hanya akan menghapus data dari sel, membiarkan baris atau kolom utuh.

**Menu header**

Anda juga dapat mengakses menu header dengan memilih ikon dropdown di sebelah judul header. Dari sini, Anda tidak hanya dapat menghapus atau menghapus kolom, tetapi juga mengganti namanya, membekukannya, atau mengonversi jenis bidang kolom.

## Memilih seri
<a name="v10-panels-datagrid-selectseries"></a>

Jika ada beberapa seri, Anda dapat mengatur datagrid untuk menampilkan kumpulan data yang disukai menggunakan menu tarik-turun **Pilih seri** di opsi panel.

## Menggunakan datagrids
<a name="v10-panels-datagrid-using"></a>

Datagrids menawarkan berbagai cara untuk berinteraksi dengan data Anda. Anda dapat mengedit, memindahkan, menghapus, dan menghapus baris dan kolom; menggunakan fungsi pencarian bawaan untuk menemukan data tertentu; dan mengonversi jenis bidang atau membekukan gulir horizontal pada kolom tertentu.

**Menambahkan data**

Anda dapat menambahkan data ke datagrid dengan membuat kolom atau baris baru.

**Untuk menambahkan kolom baru**

1. Di panel yang ada, pilih tombol **\$1** di header tabel setelah kolom terakhir.

1. Tambahkan nama untuk kolom baru.

1. Pilih di mana saja di luar bidang atau tekan `Enter` untuk menyimpan kolom.

Sekarang Anda dapat menambahkan data di setiap sel.

Untuk menambahkan baris baru, pilih tombol **\$1** setelah baris terakhir. Tombol hadir di setiap sel setelah baris terakhir, dan memilihnya memicu pembuatan baris baru sambil juga mengaktifkan sel yang Anda pilih.

**Mengedit data**

Anda dapat memindahkan kolom dan baris sesuai kebutuhan.

**Untuk memindahkan kolom**

1. Tekan dan tahan header kolom yang perlu dipindahkan.

1. Seret kolom ke lokasi yang diinginkan.

1. Lepaskan kolom untuk menyelesaikan langkah.

Untuk memindahkan baris, pilih dan tahan pemilih baris dari kolom angka yang terletak di sisi paling kiri kisi, dan seret ke lokasi yang diinginkan. Lepaskan baris untuk menyelesaikan langkah.

**Memilih beberapa sel**

Anda dapat memilih beberapa sel dengan memilih satu sel, dan menyeret sel lain. Pilihan ini dapat digunakan untuk menyalin data dari sel yang dipilih atau untuk menghapusnya menggunakan `Delete` kunci.

**Menghapus atau menghapus beberapa baris atau kolom**

Untuk menghapus atau menghapus beberapa baris, Anda dapat melakukan hal berikut.

**Untuk menghapus atau menghapus beberapa baris atau kolom**

1. Arahkan kursor ke kolom angka (di sebelah kiri kolom pertama di kisi) untuk menampilkan kotak centang baris.

1. Pilih kotak centang untuk baris yang ingin Anda kerjakan. Untuk memilih beberapa baris berturut-turut, tekan dan tahan `Shift` tombol sambil mengklik baris pertama dan terakhir. Untuk memilih baris yang tidak berurutan, tekan dan tahan tombol `Ctrl` (atau`Cmd`) sambil mengklik baris yang diinginkan.

1. Klik kanan (atau setara) untuk mengakses menu konteks.

1. Pilih **Hapus baris** atau **Hapus baris**.

Aturan yang sama berlaku untuk kolom dengan mengklik header kolom.

Untuk menghapus semua baris, gunakan kotak centang **Pilih semua** di sudut kiri atas datagrid. Ini memilih semua baris dan memungkinkan Anda untuk menghapusnya menggunakan menu konteks.

# Grafik api
<a name="v10-panels-flamegraph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafik api memungkinkan Anda memvisualisasikan data profil. Dengan menggunakan visualisasi ini, profil dapat direpresentasikan sebagai grafik api, tabel, atau keduanya.

![\[Gambar yang menunjukkan contoh visualisasi grafik api di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## Mode grafik api
<a name="v10-panels-flamegraph-mode"></a>

Grafik api mengambil keuntungan dari sifat hierarkis data profil. Ini memadatkan data ke dalam format yang memungkinkan Anda untuk dengan mudah melihat jalur kode mana yang menghabiskan sebagian besar sumber daya sistem, seperti waktu CPU, objek yang dialokasikan, atau ruang saat mengukur memori. Setiap blok dalam grafik api mewakili panggilan fungsi dalam tumpukan dan lebarnya mewakili nilainya.

Bagian abu-abu adalah seperangkat fungsi yang mewakili nilai yang relatif kecil dan mereka diciutkan bersama menjadi satu bagian karena alasan kinerja.

Anda dapat mengarahkan kursor ke fungsi tertentu untuk melihat tooltip yang menunjukkan data tambahan tentang fungsi tersebut, seperti nilai fungsi, persentase nilai total, dan jumlah sampel dengan fungsi tersebut.

**Tindakan drop-down**

Anda dapat mengklik fungsi untuk menampilkan menu drop-down dengan tindakan tambahan: 
+ **Blok fokus** — Saat Anda memilih **blok Fokus**, blok, atau fungsi, diatur ke 100% dari lebar grafik api dan semua fungsi turunannya ditampilkan dengan lebarnya diperbarui relatif terhadap lebar fungsi induk. Ini membuatnya lebih mudah untuk menelusuri bagian yang lebih kecil dari grafik nyala api.
+ **Salin nama fungsi** — Saat Anda memilih **Salin nama fungsi**, nama lengkap fungsi yang diwakili blok disalin.
+ **Tampilan sandwich** - Tampilan sandwich memungkinkan Anda untuk menampilkan konteks fungsi yang diklik. Ini menunjukkan semua pemanggil fungsi di bagian atas dan semua panggilan di bagian bawah. Ini menunjukkan konteks agregat fungsi sehingga jika fungsi ada di beberapa tempat dalam grafik nyala, semua konteks ditampilkan dan digabungkan dalam tampilan sandwich.

**Bilah status**

 Bilah status menunjukkan metadata tentang grafik api dan modifikasi yang diterapkan saat ini, seperti bagian grafik mana yang fokus atau fungsi apa yang ditampilkan dalam tampilan sandwich. Klik **X** di pil bilah status untuk menghapus modifikasi itu.

## Toolbar
<a name="v10-panels-flamegraph-toolbar"></a>

**Cari**

Anda dapat menggunakan bidang pencarian untuk menemukan fungsi dengan nama tertentu. Semua fungsi dalam grafik api yang cocok dengan pencarian akan tetap berwarna sementara fungsi lainnya berwarna abu-abu.

**Pemetik skema warna**

Anda dapat beralih di antara fungsi pewarnaan berdasarkan nilainya atau dengan nama paketnya untuk mengikat fungsi secara visual dari paket yang sama bersama-sama.

**Sejajarkan teks**

Sejajarkan teks baik ke kiri atau ke kanan untuk menampilkan bagian yang lebih penting dari nama fungsi ketika tidak masuk ke dalam blok.

**Pemetik visualisasi**

Anda dapat memilih untuk hanya menampilkan grafik api, hanya tabel, atau keduanya secara bersamaan.

## Mode meja atas
<a name="v10-panels-flamegraph-toptablemode"></a>

Tabel atas menunjukkan fungsi dari profil dalam format tabel. Tabel ini memiliki tiga kolom: simbol, diri, dan total. Tabel diurutkan berdasarkan waktu mandiri secara default, tetapi dapat disusun ulang berdasarkan total waktu atau nama simbol dengan mengklik header kolom. Setiap baris mewakili nilai agregat untuk fungsi yang diberikan jika fungsi muncul di beberapa tempat di profil.

Ada juga tombol aksi di sebelah kiri untuk setiap baris. Tombol pertama mencari nama fungsi sementara tombol kedua menunjukkan tampilan sandwich fungsi.

## Data API
<a name="v10-panels-flamegraph-dataapi"></a>

Untuk merender grafik api, Anda harus memformat data frame data menggunakan [model set bersarang](https://wikipedia.org/wiki/Nested_set_model).

Model set bersarang memastikan setiap item dari grafik api dikodekan hanya dengan tingkat sarangnya sebagai nilai bilangan bulat, metadatanya, dan dengan urutannya dalam bingkai data. Ini berarti bahwa urutan item signifikan dan harus benar. Urutan adalah traversal kedalaman pertama dari item dalam grafik nyala yang membuat ulang grafik tanpa memerlukan nilai panjang variabel dalam bingkai data seperti dalam array anak-anak.

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| level | number | Tingkat bersarang item. Dengan kata lain berapa banyak item antara item ini dan item teratas dari grafik api. | 
| nilai | number | Nilai absolut atau kumulatif item. Ini diterjemahkan ke lebar item dalam grafik. | 
| label | string | Label yang akan ditampilkan untuk item tertentu. | 
| diri | number | Nilai diri yang biasanya merupakan nilai kumulatif item dikurangi jumlah nilai kumulatif dari anak-anak langsungnya. | 

# Pengukur
<a name="v10-panels-gauge"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pengukur adalah visualisasi nilai tunggal yang dapat mengulang pengukur untuk setiap seri, kolom, atau baris.

![\[Gambar yang menunjukkan contoh visualisasi pengukur di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/gauge_example.png)


## Opsi nilai
<a name="v10-panels-gauge-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

*Hitung*

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat[Jenis perhitungan](v10-panels-calculation-types.md).
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

*Semua nilai*

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Default adalah 5.000.
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

## Pengukur
<a name="v10-panels-gauge-gauge"></a>

Sesuaikan bagaimana pengukur ditampilkan.

**Orientasi**

Pilih arah susun.
+ **Otomatis** - Pengukur ditampilkan dalam baris dan kolom.
+ **Horizontal** - Pengukur menampilkan dari atas ke bawah.
+ **Vertikal** - Pengukur menampilkan kiri ke kanan.

**Tampilkan label ambang batas**

Kontrol jika nilai ambang ditampilkan.

**Tampilkan penanda ambang batas**

Kontrol jika pita ambang ditampilkan di luar pita nilai pengukur bagian dalam.

**Ukuran pengukur**

Pilih mode ukuran ukuran
+ **Otomatis** — Grafana menentukan ukuran pengukur terbaik.
+ **Manual** - Konfigurasikan ukuran pengukur secara manual.

**Lebar min**

Atur lebar minimum pengukur berorientasi vertikal.

Jika Anda menetapkan lebar minimum, bilah gulir sumbu x secara otomatis ditampilkan ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran pengukur diatur ke manual.

**Tinggi min**

Lihat ketinggian minimum pengukur berorientasi horizontal.

Jika Anda menetapkan ketinggian minimum, bilah gulir sumbu y secara otomatis ditampilkan ketika ada sejumlah besar data.

**catatan**  
Opsi ini hanya berlaku ketika ukuran pengukur diatur ke manual.

**Netral**

Tetapkan nilai awal dari mana setiap pengukur akan diisi.

## Ukuran teks
<a name="v10-panels-gauge-textsize"></a>

Sesuaikan ukuran teks pengukur.
+ **Judul** — Masukkan nilai numerik untuk ukuran judul gauge.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Geomap
<a name="v10-panels-geomap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Geomaps memungkinkan Anda untuk melihat dan menyesuaikan peta dunia menggunakan data geospasial. Anda dapat mengonfigurasi berbagai gaya overlay dan pengaturan tampilan peta untuk dengan mudah fokus pada karakteristik data berbasis lokasi yang penting.

**catatan**  
Anda dapat menambahkan data geospasial Anda sendiri di atas lapisan peta dasar yang disediakan oleh. AWS Lapisan basemap semuanya harus berasal. [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com) 

![\[Gambar yang menunjukkan contoh visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## Tampilan Peta
<a name="v10-panels-geomap-view"></a>

Tampilan peta mengontrol tampilan awal peta saat dasbor dimuat.

**Tampilan Awal**

Tampilan awal mengonfigurasi bagaimana GeoMap panel dirender saat panel pertama kali dimuat.
+ **Tampilan** menyetel pusat peta saat panel pertama kali dimuat.
  + **Sesuai dengan data** sesuai dengan tampilan peta berdasarkan luasan data lapisan Peta dan pembaruan saat data berubah.
    + Opsi **data** memungkinkan pemilihan luas berdasarkan data dari *Semua lapisan*, *Layer* tunggal, atau *nilai Terakhir* dari lapisan yang dipilih.
    + **Layer** dapat dipilih jika data pas dari *Layer* tunggal atau *nilai Terakhir* dari sebuah layer.
    + **Padding** menetapkan padding dalam persen relatif di luar jangkauan data (tidak tersedia saat melihat *nilai Terakhir* saja).
    + **Max Zoom** menetapkan tingkat zoom maksimum saat memasang data.
  + **Koordinat** menetapkan tampilan peta berdasarkan:
    + **Lintang**
    + **Bujur**
  + Tampilan default juga tersedia termasuk:
    + **(0°, 0°)**
    + **Amerika Utara**
    + **Amerika Selatan**
    + **Eropa**
    + **Afrika**
    + **Asia Barat**
    + **Asia Selatan**
    + **Asia Tenggara**
    + **Asia Timur**
    + **Australia**
    + **Oseania**
+ **Zoom** mengatur tingkat zoom awal.

## Lapisan peta
<a name="v10-panels-geomap-layers"></a>

Dukungan Geomaps menunjukkan beberapa lapisan. Setiap lapisan menentukan bagaimana Anda memvisualisasikan data geospasial di atas peta dasar.

**Jenis**

Ada tiga jenis layer peta untuk dipilih dalam visualisasi Geomap.
+ [Lapisan penanda](#v10-panels-geomap-markers)membuat penanda di setiap titik data.
+ [Lapisan peta panas](#v10-panels-geomap-heatmap)memvisualisasikan peta panas data.
+ [Lapisan GeoJSON](#v10-panels-geomap-geojson)membuat data statis dari file GeoJSON.
+ [Lapisan Malam/Hari (Alpha)](#v10-panels-geomap-nightday)membuat wilayah malam atau siang hari.
+ [Lapisan rute (pratinjau)](#v10-panels-geomap-route)membuat titik data sebagai rute.
+ [Lapisan foto (pratinjau)](#v10-panels-geomap-photos)membuat foto di setiap titik data.
+ [Lapisan jaringan (pratinjau)](#v10-panels-geomap-network)memvisualisasikan grafik jaringan dari data.

Ada juga dua jenis lapisan eksperimental (atau alfa).
+ **Ikon pada titik terakhir (alpha)** membuat ikon pada titik data terakhir.
+ **GeoJSON dinamis (alpha)** menata file GeoJSON berdasarkan hasil kueri.

**catatan**  
Lapisan ditandai *pratinjau* atau *alfa* dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Kontrol Lapisan**

Kontrol lapisan memungkinkan Anda membuat lapisan, mengubah namanya, menyusun ulang, dan menghapus lapisan.
+ **Tambahkan lapisan membuat lapisan** data tambahan yang dapat dikonfigurasi untuk geomap. Ketika Anda menambahkan layer, Anda diminta untuk memilih jenis layer. Anda dapat mengubah jenis lapisan di setiap titik selama konfigurasi panel.
+ Kontrol lapisan memungkinkan Anda untuk mengganti nama, menghapus, dan menyusun ulang lapisan panel.
  + **Edit nama layer** (ikon pensil) mengganti nama layer.
  + **Trash Bin** menghapus layer.
  + **Menyusun ulang** (enam dots/grab pegangan) memungkinkan Anda untuk mengubah urutan lapisan. Data pada lapisan yang lebih tinggi akan muncul di atas data pada lapisan bawah. Visualisasi akan memperbarui urutan layer saat Anda drag dan drop untuk membantu menyederhanakan memilih urutan layer.

Anda dapat menambahkan beberapa lapisan data ke satu panel geomap untuk membuat visualisasi yang kaya dan terperinci.

**Lokasi**

Geomaps membutuhkan sumber data geografis. Data ini berasal dari kueri database, dan ada empat opsi pemetaan untuk data Anda.
+ **Otomatis** secara otomatis mencari data lokasi. Gunakan opsi ini ketika kueri Anda didasarkan pada salah satu nama berikut untuk bidang data.
  + *geohash*: `geohash`
  + *garis lintang*:`latitude`, `lat`
  + *garis bujur*:`longitude`,, `lng` `lon`
  + *pencarian*: `lookup`
+ **Coords** menentukan bahwa kueri Anda menyimpan data koordinat. Anda akan mendapatkan diminta untuk memilih bidang data numerik untuk garis lintang dan bujur dari kueri database Anda.
+ **Geohash** menentukan bahwa kueri Anda menyimpan data geohash. Anda akan diminta untuk memilih bidang data string untuk geohash dari kueri database Anda.
+ **Pencarian** menentukan bahwa kueri Anda menyimpan data nama lokasi yang perlu dipetakan ke nilai. Anda akan diminta untuk memilih bidang pencarian dari kueri database Anda dan gazetteer. Gazetteer adalah direktori yang digunakan untuk memetakan data kueri Anda ke titik geografis.

## Lapisan penanda
<a name="v10-panels-geomap-markers"></a>

Lapisan penanda memungkinkan Anda untuk menampilkan titik data sebagai bentuk penanda yang berbeda seperti lingkaran, kotak, segitiga, bintang, dan banyak lagi.

Penanda memiliki banyak opsi penyesuaian.
+ **Ukuran** mengkonfigurasi ukuran spidol. Standarnya adalah`Fixed size`, yang membuat semua ukuran penanda sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur penanda berdasarkan data yang sesuai dengan bidang yang dipilih. `Min`dan ukuran `Max` penanda harus diatur sedemikian rupa sehingga lapisan Marker dapat menskalakan dalam kisaran ini.
+ **Simbol** memungkinkan Anda memilih simbol, ikon, atau grafik untuk membantu memberikan konteks visual tambahan pada data Anda. Pilih dari aset yang disertakan dengan Grafana seperti simbol sederhana atau pustaka Unicon. Anda juga dapat menentukan URL yang berisi aset gambar. Gambar harus berupa grafik vektor yang dapat diskalakan (SVG).
+ **Simbol Vertical Align** mengkonfigurasi perataan vertikal simbol relatif terhadap titik data. Perhatikan bahwa sudut rotasi simbol diterapkan terlebih dahulu di sekitar titik data, kemudian perataan vertikal diterapkan relatif terhadap rotasi simbol.
+ **Simbol Horizontal Align** mengkonfigurasi perataan horizontal simbol relatif terhadap titik data. Perhatikan bahwa sudut rotasi simbol diterapkan terlebih dahulu di sekitar titik data, kemudian perataan horizontal diterapkan relatif terhadap rotasi simbol.
+ **Warna** mengkonfigurasi warna spidol. Default `Fixed color` menetapkan semua penanda ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Fill opacity** mengonfigurasi transparansi setiap penanda.
+ **Sudut rotasi** mengkonfigurasi sudut rotasi setiap penanda. Defaultnya adalah **Nilai tetap**, yang membuat semua penanda berputar ke sudut yang sama terlepas dari datanya; Namun, ada juga opsi untuk mengatur rotasi penanda berdasarkan data yang sesuai dengan bidang yang dipilih.
+ **Label teks** mengonfigurasi label teks untuk setiap penanda.
+ **Tampilkan legenda** memungkinkan Anda beralih legenda untuk lapisan.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan peta panas
<a name="v10-panels-geomap-heatmap"></a>

Lapisan peta panas mengelompokkan berbagai titik data untuk memvisualisasikan lokasi dengan kepadatan berbeda.

![\[Gambar yang menunjukkan contoh peta panas menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


Untuk menambahkan layer heatmap:

Pilih pada menu dropdown di bawah Data Layer dan pilih. `Heatmap`

Mirip dengan`Markers`, Anda diminta dengan opsi untuk menentukan titik data mana yang akan divisualisasikan dan bagaimana Anda ingin memvisualisasikannya.
+ **Nilai berat** mengkonfigurasi intensitas kluster peta panas. **Nilai tetap menjaga nilai** bobot konstan di semua titik data. Nilai ini harus berada di kisaran 0-1. Mirip dengan Markers, ada opsi alternatif di dropdown untuk secara otomatis menskalakan nilai bobot tergantung pada nilai data.
+ **Radius** mengkonfigurasi ukuran kluster peta panas.
+ **Blur** mengkonfigurasi jumlah blur pada setiap cluster.
+ **Opacity** mengonfigurasi opacity setiap cluster.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan GeoJSON
<a name="v10-panels-geomap-geojson"></a>

Lapisan GeoJSON memungkinkan Anda untuk memilih dan memuat file GeoJSON statis dari sistem file.
+ URL **GeoJSON menyediakan pilihan file GeoJSON** yang dikirimkan bersama Grafana.
+ **Default Style** mengontrol gaya mana yang akan diterapkan bila tidak ada aturan di atas yang cocok.
  + **Warna** mengkonfigurasi warna gaya default
  + **Opacity mengonfigurasi opacity** default
+ **Aturan Gaya** menerapkan gaya berdasarkan properti fitur
  + **Aturan** memungkinkan Anda memilih *fitur*, *kondisi*, dan *nilai* dari file GeoJSON untuk menentukan aturan. Ikon tempat sampah dapat digunakan untuk menghapus aturan saat ini.
  + **Warna** mengkonfigurasi warna gaya untuk aturan saat ini
  + **Opacity** mengonfigurasi tingkat transparansi untuk aturan saat ini.
+ **Tambahkan aturan gaya** menciptakan aturan gaya tambahan.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

## Lapisan Malam/Hari (Alpha)
<a name="v10-panels-geomap-nightday"></a>

Lapisan Malam/Siang menampilkan wilayah siang dan malam berdasarkan rentang waktu saat ini.

![\[Gambar yang menunjukkan contoh layer malam/siang menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Pilihan**
+ **Tampilkan** beralih sumber waktu dari rentang waktu panel.
+ **Warna wilayah malam** memilih warna untuk wilayah malam.
+ **Tampilan ikon matahari** beralih matahari.
+ **Opacity** dari 0 (transparan) ke 1 (buram).
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

## Lapisan rute (pratinjau)
<a name="v10-panels-geomap-route"></a>

Lapisan Route membuat titik data sebagai rute.

**catatan**  
Lapisan Route saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

![\[Gambar yang menunjukkan contoh layer rute menggunakan visualisasi geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Pilihan**
+ **Ukuran** mengatur ketebalan rute. Nilai tetap secara default. Saat data bidang dipilih, Anda dapat mengatur rentang Min dan Maks di mana data bidang dapat diskalakan.
+ **Warna** mengatur warna rute. Atur ke warna tetap secara default, Anda juga dapat mengikat warna ke data bidang.
+ **Fill opacity** mengonfigurasi opacity rute.
+ **Label teks** mengonfigurasi label teks untuk setiap rute.
+ **Panah** mengkonfigurasi gaya panah untuk ditampilkan di sepanjang rute, dalam urutan data.
  + **Tidak ada**
  + **Maju**
  + **Membalikkan**
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - Gaya Garis Aliran](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html).

## Lapisan foto (pratinjau)
<a name="v10-panels-geomap-photos"></a>

Lapisan Foto membuat foto di setiap titik data.

**catatan**  
Lapisan Foto saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Pilihan**
+ Bidang **Sumber Gambar memungkinkan Anda memilih bidang** string yang berisi data gambar sebagai biner gambar yang dikodekan Base64 (). `data:image/png;base64,...`
+ **Jenis** mengatur gaya bingkai di sekitar gambar. Pilih antara:
  + **Persegi**
  + **Lingkaran**
  + **Berlabuh**
  + **Folio**
+ **Pangkas** beralih apakah gambar dipotong agar pas.
+ **Bayangan** mengubah bayangan kotak di belakang gambar.
+ **Perbatasan** menetapkan ukuran batas di sekitar gambar.
+ **Warna perbatasan menetapkan warna** perbatasan di sekitar gambar.
+ **Radius** mengatur ukuran keseluruhan gambar dalam piksel.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - Gaya Foto Gambar](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

## Lapisan jaringan (pratinjau)
<a name="v10-panels-geomap-network"></a>

Lapisan Jaringan membuat grafik jaringan. Lapisan ini mendukung format data yang sama didukung oleh visualisasi grafik node, dengan penambahan data geospasial yang disertakan dalam data node. Data geospasial digunakan untuk mencari dan merender node pada peta.

**catatan**  
Lapisan Jaringan saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

![\[Gambar yang menunjukkan contoh visualisasi jaringan dalam geomap di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**catatan**  
Lapisan Jaringan saat ini dalam pratinjau publik. Grafana Labs menawarkan dukungan terbatas, dan perubahan yang melanggar mungkin terjadi sebelum fitur tersedia secara umum.

**Pilihan**
+ **Panah** mengatur arah panah untuk ditampilkan untuk setiap tepi, dengan sumber makna maju ke target. Pilih antara:
  + **Tidak ada**
  + **Maju**
  + **Membalikkan**
  + **Keduanya**
+ **Tampilkan legenda** memungkinkan Anda beralih legenda untuk layer. Legenda hanya mendukung data node.
+ **Tooltip tampilan** memungkinkan Anda beralih tooltips untuk layer.

**Gaya simpul**
+ **Ukuran** mengkonfigurasi ukuran node. Defaultnya adalah **Ukuran tetap**, yang membuat semua ukuran node sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur node berdasarkan data yang sesuai dengan bidang yang dipilih. Ukuran node **Min** dan **Max** harus diatur sedemikian rupa sehingga node dapat diskalakan dalam kisaran ini.
+ **Warna** mengkonfigurasi warna node. Defaultnya adalah **Fixed color**, yang mengatur semua node ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Simbol** memungkinkan Anda memilih simbol, ikon, atau grafik untuk membantu memberikan konteks visual tambahan pada data Anda. Pilih dari aset yang disertakan dengan Grafana, seperti simbol sederhana atau pustaka Unicon. Anda juga dapat menentukan URL yang berisi aset gambar. Gambar harus berupa grafik vektor yang dapat diskalakan (SVG).
+ **Fill opacity** mengkonfigurasi transparansi setiap node.
+ **Sudut rotasi** mengkonfigurasi sudut rotasi setiap node. Defaultnya adalah **nilai Tetap**, yang membuat semua node berputar ke sudut yang sama terlepas dari data; Namun, ada juga opsi untuk mengatur rotasi node berdasarkan data yang sesuai dengan bidang yang dipilih.
+ **Label teks** mengonfigurasi label teks untuk setiap node.

**Gaya tepi**
+ **Ukuran** mengkonfigurasi lebar garis tepi. Defaultnya adalah **Ukuran tetap**, yang membuat semua lebar garis tepi sama terlepas dari datanya; Namun, ada juga opsi untuk mengukur tepi berdasarkan data yang sesuai dengan bidang yang dipilih. Ukuran tepi **Min** dan **Max** harus diatur sedemikian rupa sehingga ujung-ujungnya dapat diskalakan dalam kisaran ini.
+ **Warna** mengkonfigurasi warna tepi. Defaultnya adalah **warna Tetap**, yang mengatur semua tepi ke warna tertentu. Ada juga opsi untuk memiliki warna bersyarat tergantung pada nilai titik data bidang yang dipilih dan skema warna yang ditetapkan di bagian **Opsi standar**.
+ **Fill opacity** mengonfigurasi transparansi setiap tepi.
+ **Label teks** mengonfigurasi label teks untuk setiap tepi.

## Lapisan CARTO
<a name="v10-panels-geomap-carto"></a>

Lapisan CARTO tidak didukung di Grafana Terkelola Amazon.

## Lapisan ubin XYZ
<a name="v10-panels-geomap-xyz"></a>

Lapisan ubin XYZ tidak didukung di Grafana Terkelola Amazon.

## Buka lapisan Peta Jalan
<a name="v10-panels-geomap-osm"></a>

Lapisan Peta Jalan Terbuka (selain peta dasar default) tidak didukung di Grafana Terkelola Amazon.

## Lapisan ArcGIS
<a name="v10-panels-geomap-arcgis"></a>

Lapisan ArcGIS tidak didukung di Grafana Terkelola Amazon.

## Kontrol Peta
<a name="v10-panels-geomap-controls"></a>

Bagian kontrol peta berisi berbagai opsi untuk informasi peta dan hamparan alat.

**Zoom**

Opsi untuk kontrol zoom.

*Tampilkan kontrol zoom*

Menampilkan kontrol zoom di sudut kiri atas.

*Zoom roda mouse*

Menghidupkan atau mematikan menggunakan roda mouse untuk memperbesar atau memperkecil.

**Tampilkan atribusi**

Menampilkan atribusi untuk lapisan basemap di peta.

**Tampilkan skala**

Menampilkan informasi skala di sudut kiri bawah.

**catatan**  
Menampilkan unit dalam [m]/[km].

**Tampilkan alat ukur**

Menampilkan alat ukur di sudut kanan atas. Pengukuran hanya muncul ketika kontrol ini terbuka.
+ **Klik** untuk mulai mengukur
+ **Lanjutkan mengklik** untuk melanjutkan pengukuran
+ **Klik dua kali** untuk mengakhiri pengukuran

**catatan**  
Saat Anda mengubah jenis atau unit pengukuran, pengukuran sebelumnya akan dihapus dari peta.  
Jika kontrol ditutup dan kemudian dibuka kembali, pengukuran terbaru ditampilkan.  
Pengukuran dapat dimodifikasi dengan mengklik dan menyeretnya.

*Panjangnya*

Dapatkan panjang bola geometri. Panjang ini adalah jumlah dari jarak lingkaran besar antara koordinat. Untuk geometri multi-bagian, panjangnya adalah jumlah panjang setiap bagian. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran panjang:
+ **Metrik (m/km)**
+ **Kaki (ft)**
+ **Miles (mi)**
+ **Mil laut (nmi)**

*Luas*

Dapatkan area bola geometri. Area ini dihitung dengan asumsi bahwa tepi poligon adalah segmen lingkaran besar pada bola. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran area:
+ **Meter Persegi (m²)**
+ **Kilometer Persegi (km²)**
+ **Kaki Persegi (ft²)**
+ **Mil Persegi (mi²)**
+ **Hektar (acre)**
+ **Hektar (ha)**

**Tampilkan debug**

Menampilkan informasi debug di sudut kanan atas peta. Ini dapat berguna untuk men-debug atau memvalidasi sumber data.
+ **Zoom** menampilkan tingkat zoom peta saat ini.
+ **Pusat** menampilkan garis **bujur** saat ini, dan **garis lintang** pusat peta.

**Tooltip**
+ **Tidak ada** yang menampilkan tooltips hanya ketika titik data diklik.
+ **Detail** menampilkan tooltips saat pointer melayang di atas titik data.

# Peta panas
<a name="v10-panels-heatmap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel Heatmap memungkinkan Anda untuk melihat histogram dari waktu ke waktu. Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

![\[Gambar yang menunjukkan contoh visualisasi peta panas di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Hitung dari data
<a name="v10-panels-heatmap-calculate"></a>

Pengaturan ini menentukan apakah data sudah merupakan peta panas yang dihitung (dari sumber data/transformator), atau yang harus dihitung di panel.

**Ember X**

Pengaturan ini menentukan bagaimana sumbu X dibagi menjadi ember. Anda dapat menentukan interval waktu di input **Ukuran**. Misalnya, rentang waktu `1h` membuat sel selebar 1 jam pada sumbu X.

**Ember Y**

Pengaturan ini menentukan bagaimana sumbu Y dibagi menjadi ember.

**Skala Bucket Y**

Pilih salah satu skala nilai sumbu Y berikut:
+ **linier** — Skala linier.
+ **log (basis 2)** — Skala logaritmik dengan basis 2.
+ **log (basis 10)** — Skala logaritmik dengan basis 10.
+ **symlog - Skala** symlog.

## Sumbu Y
<a name="v10-panels-heatmap-y-axes"></a>

Mendefinisikan bagaimana sumbu Y ditampilkan

**Penempatan**
+ **Kiri** - Di sebelah kiri
+ **Kanan** - Di sebelah kanan
+ **Tersembunyi** - Tersembunyi

**Satuan**

Konfigurasi unit

**Desimal**

Pengaturan ini menentukan konfigurasi desimal.

**Nilai Min/Maks**

Pengaturan ini mengkonfigurasi rentang sumbu.

**Membalikkan**

Saat dipilih, sumbu muncul dalam urutan terbalik.

**Tampilkan beberapa sumbu y**

Dalam beberapa kasus, Anda mungkin ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda mungkin ingin menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Anda dapat melakukan ini dengan [menambahkan penggantian bidang](v10-panels-configure-overrides.md). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

## Warna
<a name="v10-panels-heatmap-colors"></a>

Spektrum warna mengontrol pemetaan antara jumlah nilai (di setiap bucket) dan warna yang ditetapkan untuk setiap bucket. Warna paling kiri pada spektrum mewakili jumlah minimum dan warna di sisi paling kanan mewakili jumlah maksimum. Beberapa skema warna secara otomatis terbalik saat menggunakan tema cahaya.

Anda juga dapat mengubah mode warna menjadi Opacity. Dalam hal ini, warnanya tidak akan berubah tetapi jumlah opasitas akan berubah dengan jumlah ember
+ **Modus**
  + **Skema** - Nilai bucket diwakili oleh warna sel.
    + **Skema** — Jika modenya adalah **Skema**, maka pilih skema warna.
  + **opacity** — Nilai bucket diwakili oleh opasitas sel. Sel buram berarti nilai maksimum.
    + **Warna - Warna** dasar sel.
    + **Skala** — Skala untuk memetakan nilai bucket ke opacity.
      + **linier** — Skala linier. Nilai bucket memetakan secara linier ke opacity.
      + **sqrt — Skala** daya. Opasitas sel dihitung sebagai`value ^ k`, di mana `k` adalah nilai **Eksponen** yang dikonfigurasi. Jika eksponen kurang dari`1`, Anda akan mendapatkan skala logaritmik. Jika eksponen lebih besar dari`1`, Anda akan mendapatkan skala eksponensial. Dalam hal`1`, skala akan sama dengan linier.
    + **Eksponen — nilai eksponen**, lebih besar dari. `0`

**Mulai/akhir warna dari nilai**

Secara default, Grafana menghitung warna sel berdasarkan nilai bucket minimum dan maksimum. Dengan Min dan Max Anda dapat menimpa nilai-nilai tersebut. Pertimbangkan nilai bucket sebagai sumbu Z dan Min dan Max sebagai Z-Min dan Z-Max, masing-masing.
+ **Mulai** - Nilai minimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket kurang dari Min, maka itu dipetakan ke warna “minimum”. Nilai min seri adalah nilai default.
+ **Akhir** - Nilai maksimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket lebih besar dari Max, maka itu dipetakan ke warna “maksimum”. Nilai maks seri adalah nilai default.

## Tampilan sel
<a name="v10-panels-heatmap-cell"></a>

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi tampilan tambahan
<a name="v10-panels-heatmap-options"></a>

**Tooltip**
+ **Tampilkan tooltip** - Tampilkan tooltip peta panas.
+ **Tampilkan Histogram - Tampilkan histogram** sumbu Y pada tooltip. Histogram mewakili distribusi nilai bucket untuk stempel waktu tertentu.
+ **Tampilkan skala warna** - Tampilkan skala warna pada tooltip. Skala warna mewakili pemetaan antara nilai bucket dan warna.

**Legenda**

Pilih apakah Anda ingin menampilkan legenda peta panas pada visualisasi.

**Teladan**

Mengatur warna yang digunakan untuk menampilkan data contoh.

# Histogram
<a name="v10-panels-histogram"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi histogram menghitung distribusi nilai dan menyajikannya sebagai diagram batang. Sumbu Y dan tinggi setiap batang mewakili jumlah nilai yang termasuk dalam setiap braket sedangkan sumbu X mewakili rentang nilai.

![\[Gambar yang menunjukkan contoh visualisasi histogram di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/histogram-example.png)


## Format yang didukung
<a name="v10-panels-histogram-formats"></a>

Visualisasi histogram mendukung deret waktu dan hasil tabel apa pun dengan satu atau lebih bidang numerik.

## Opsi tampilan
<a name="v10-panels-histogram-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.

**Ukuran ember**

Ukuran ember. Biarkan ini kosong untuk ukuran ember otomatis (\$1 10% dari rentang penuh).

**Ember offset**

Jika ember pertama tidak harus mulai dari nol. Offset bukan nol menggeser jendela agregasi. Misalnya, ember berukuran 5 yang 0—5, 5—10, 10—15 dengan offset default 0 akan menjadi 2—7, 7—12, 12—17 dengan offset 2; offset 0, 5, atau 10, dalam hal ini, secara efektif tidak akan melakukan apa-apa. Biasanya, opsi ini akan digunakan dengan ukuran bucket yang ditentukan secara eksplisit daripada otomatis. Agar pengaturan ini mempengaruhi, jumlah offset harus lebih besar dari 0 dan kurang dari ukuran bucket; nilai di luar rentang ini akan memiliki efek yang sama dengan nilai dalam rentang ini.

**Gabungkan seri**

Ini akan menggabungkan semua seri dan bidang menjadi histogram gabungan.

**Lebar garis**

Kontrol lebar garis bar.

**Isi opacity**

Mengontrol opasitas isian bilah.

**Mode gradien**

Atur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.
+  **Tidak ada** - Tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu Y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

## Opsi legenda
<a name="v10-panels-histogram-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Nilai Legenda**

Pilih perhitungan standar mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu. Untuk informasi selengkapnya, lihat [Jenis perhitungan](v10-panels-calculation-types.md).

**Perhitungan legenda**

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.

# Beberapa catatan
<a name="v10-panels-logs"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel log menunjukkan baris log dari sumber data yang mendukung log, seperti Elastic, Influx, dan Loki. Biasanya, Anda akan menggunakan panel ini di sebelah panel grafik untuk menampilkan output log dari proses terkait.

Panel log menunjukkan hasil kueri yang dimasukkan pada tab **Kueri**. Hasil dari beberapa kueri digabungkan dan diurutkan berdasarkan waktu. Anda dapat menggulir ke dalam panel jika sumber data mengembalikan lebih banyak baris daripada yang dapat ditampilkan.

Untuk membatasi jumlah baris yang dirender, Anda dapat menggunakan pengaturan **Titik data Maks** dalam **opsi Kueri**. Jika tidak disetel, sumber data biasanya akan memberlakukan batas default.

## Tingkat log
<a name="v10-panels-logs-level"></a>

Untuk log di mana label **level** ditentukan, kami menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, kami mencoba mencari tahu apakah kontennya cocok dengan ekspresi yang didukung (lihat di bawah untuk informasi lebih lanjut). Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang **tidak diketahui**. Untuk informasi selengkapnya, lihat [Tingkat log](v10-explore-logs.md#v10-explore-log-level).

## Rincian log
<a name="v10-panels-logs-details"></a>

Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Setiap bidang atau label memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Tautan data**

Dengan menggunakan tautan data, Anda dapat mengubah bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan yang dibuat terlihat sebagai tombol di bagian **Tautan** di dalam tampilan **detail Log**.

**Opsi tampilan**

Gunakan pengaturan berikut untuk menyempurnakan visualisasi Anda:
+ **Waktu** - Tampilkan atau sembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data.
+ **Label unik** - Tampilkan atau sembunyikan kolom label unik, yang hanya menampilkan label yang tidak umum.
+ **Label umum** - Tampilkan atau sembunyikan label umum
+ **Garis bungkus** - Alihkan pembungkus garis.
+ **Prettify JSON** - Atur ini `true` untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON.
+ **Aktifkan detail log** - Beralih opsi untuk melihat tampilan detail log untuk setiap baris log. Pengaturan default-nya adalah `true`.
+ **Urutan** - Menampilkan hasil dalam urutan waktu turun atau naik. Defaultnya adalah **Descending**, menampilkan log terbaru terlebih dahulu. Setel ke **Ascending** untuk menampilkan baris log tertua terlebih dahulu.

# Berita
<a name="v10-panels-news"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi berita menampilkan umpan RSS. Secara default, ini menampilkan artikel dari blog Grafana Labs, dan pengguna dapat mengubahnya dengan memasukkan URL umpan RSS yang berbeda.

Masukkan URL RSS di bagian **Tampilan**. Jenis visualisasi ini tidak menerima kueri lain, dan pengguna seharusnya tidak berharap untuk dapat menyinggung atau menanyakan data umpan RSS dengan cara apa pun menggunakan visualisasi ini.

**catatan**  
Umpan RSS dimuat oleh ujung depan Grafana tanpa proxy. Akibatnya, hanya umpan RSS yang dikonfigurasi dengan [header CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) yang sesuai yang akan dimuat. Jika umpan RSS yang Anda coba tampilkan gagal dimuat, pertimbangkan untuk menghosting ulang umpan RSS atau membuat proxy Anda sendiri.

# Grafik simpul
<a name="v10-panels-node-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafik node dapat memvisualisasikan grafik atau jaringan yang diarahkan. Mereka menggunakan tata letak gaya terarah untuk memposisikan node secara efektif, sehingga mereka dapat membantu menampilkan peta infrastruktur yang kompleks, hierarki, atau menjalankan diagram.

## Persyaratan data
<a name="v10-panels-node-graph-requirements"></a>

Grafik simpul membutuhkan bentuk data tertentu untuk dapat menampilkan simpul dan tepinya. Tidak semua sumber data atau kueri dapat divisualisasikan dengan grafik ini. Jika Anda ingin menggunakan ini sebagai pengembang sumber data, lihat bagian tentang API data.

Grafik simpul terdiri dari *node* dan *tepi*.
+ Sebuah *node* ditampilkan sebagai lingkaran. Sebuah node mungkin mewakili aplikasi, layanan, atau apa pun yang relevan dari perspektif aplikasi.
+ *Tepi* ditampilkan sebagai garis yang menghubungkan dua node. Koneksi mungkin permintaan, operasi, atau hubungan lain antara dua node.

Baik node dan edge dapat memiliki metadata atau statistik terkait. Sumber data mendefinisikan informasi dan nilai apa yang ditampilkan, sehingga sumber data yang berbeda dapat menunjukkan jenis nilai yang berbeda atau tidak menunjukkan beberapa nilai.

## Node
<a name="v10-panels-node-graph-nodes"></a>

Biasanya, node menunjukkan dua nilai statistik di dalam node dan dua pengidentifikasi tepat di bawah node, biasanya nama dan jenis. Node juga dapat menampilkan serangkaian nilai lain sebagai lingkaran warna di sekitar node, dengan bagian warna berbeda mewakili nilai yang berbeda yang harus menambahkan hingga 1. Misalnya, Anda dapat memiliki persentase kesalahan yang diwakili oleh bagian merah dari lingkaran.

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

**catatan**  
Grafik node hanya dapat menampilkan 1.500 node. Jika batas ini dilintasi, peringatan terlihat di sudut kanan atas, dan beberapa node akan disembunyikan. Anda dapat memperluas bagian tersembunyi dari grafik dengan mengklik penanda **node tersembunyi** dalam grafik.

## Tepi
<a name="v10-panels-node-graph-edges"></a>

Tepi juga dapat menunjukkan statistik saat Anda mengarahkan kursor ke tepi. Mirip dengan node, Anda dapat membuka menu konteks dengan detail dan tautan tambahan dengan memilih tepi.

Sumber data pertama yang mendukung visualisasi ini adalah sumber AWS X-Ray data untuk fitur peta layanannya. Untuk informasi selengkapnya, lihat [Connect ke sumber AWS X-Ray data](x-ray-data-source.md).

## Menavigasi grafik simpul
<a name="v10-panels-node-graph-navigation"></a>

**Panci**

Anda dapat menggeser dalam grafik simpul dengan memilih di luar node atau tepi mana pun dan menyeret pointer.

**Memperbesar atau memperkecil**

Anda dapat memperbesar dengan menggunakan tombol di sudut kiri atas grafik simpul, atau menggunakan roda mouse atau input gulir lainnya dengan tombol `Ctrl` (atau`Cmd`).

**Jelajahi node tersembunyi**

Jumlah node yang ditampilkan pada waktu tertentu terbatas untuk mempertahankan kinerja yang wajar. Node yang berada di luar batas ini tersembunyi di balik penanda yang dapat dipilih yang menunjukkan perkiraan jumlah node tersembunyi yang terhubung ke tepi itu. Anda dapat memilih penanda untuk memperluas grafik di sekitar simpul itu.

**Tampilan kisi**

Anda dapat beralih ke tampilan grid untuk memiliki gambaran yang lebih baik dari node yang paling menarik dalam grafik. Tampilan grid menunjukkan node dalam grid tanpa tepi dan dapat diurutkan berdasarkan statistik yang ditunjukkan di dalam node atau oleh statistik yang diwakili oleh batas berwarna dari node.

Untuk mengurutkan node, pilih statistik di dalam legenda. Penanda di sebelah nama stat (salah satu `˄` atau`˅`) menunjukkan stat mana yang saat ini digunakan untuk menyortir dan menyortir arah.

Pilih node dan kemudian pilih opsi **Tunjukkan dalam tata letak Grafik** untuk beralih kembali ke tata letak grafik dengan fokus pada simpul yang dipilih, untuk menunjukkannya dalam konteks grafik lengkap.

## Data API
<a name="v10-panels-node-graph-data-api"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Grafik Node minimal membutuhkan bingkai data yang menggambarkan tepi grafik. Secara default, grafik node akan menghitung node dan statistik apa pun berdasarkan bingkai data ini. Secara opsional, bingkai data kedua yang menjelaskan node dapat dikirim jika ada kebutuhan untuk menampilkan metadata spesifik node yang lebih spesifik. Anda harus mengatur `frame.meta.preferredVisualisationType = 'nodeGraph'` pada kedua frame data atau menamainya `nodes` dan `edges` masing-masing untuk grafik node untuk dirender.

**Tepi data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| id | string | Pengidentifikasi unik tepi. | 
| sumber | string | Id dari simpul sumber. | 
| target | string | Id dari target. | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| mainstat | string/nomor | Stat pertama ditampilkan di overlay saat melayang di atas tepi. Ini bisa berupa string yang menunjukkan nilai apa adanya atau bisa berupa angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan. | 
| Secondarystat | string/nomor | Sama seperti MainStat, tetapi ditampilkan tepat di bawahnya. | 
| detail\$1\$1\$1 | string/nomor | Bidang apa pun yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik di tepi. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia. | 

**Node data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| id | string | Pengidentifikasi unik dari node. ID ini direferensikan oleh edge di bidang sumber dan targetnya. | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| title | string | Nama node terlihat tepat di bawah node. | 
| subjudul | string | Tambahan, nama, jenis atau pengenal lain yang ditampilkan di bawah judul. | 
| mainstat | string/nomor | Stat pertama ditampilkan di dalam node itu sendiri. Ini bisa berupa string yang menunjukkan nilai apa adanya atau angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan.  | 
| Secondarystat | string/nomor | Sama seperti MainStat, tetapi ditampilkan di bawahnya di dalam node. | 
| busur\$1\$1\$1 | number | Setiap bidang yang diawali dengan `arc__` akan digunakan untuk membuat lingkaran warna di sekitar node. Semua nilai dalam bidang ini harus menambahkan hingga 1. Anda dapat menentukan warna menggunakan`config.color.fixedColor`. | 
| detail\$1\$1\$1 | string/nomor | Setiap bidang yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik pada node. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia. | 
| warna | string/nomor | Dapat digunakan untuk menentukan satu warna alih-alih menggunakan `arc__` bidang untuk menentukan bagian warna. Ini bisa berupa string (itu harus berupa string warna HTML yang dapat diterima), atau bisa berupa angka, dalam hal ini perilaku tergantung pada `field.config.color.mode` pengaturan. Ini dapat digunakan, misalnya, untuk membuat warna gradien yang dikendalikan oleh nilai bidang. | 
| ikon | string | Nama ikon untuk ditampilkan di dalam node bukan statistik default. Hanya ikon bawaan Grafana yang diizinkan (lihat ikon yang tersedia di [sini](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)). | 
| NodeRadius | number | Nilai radius dalam piksel. Digunakan untuk mengelola ukuran node. | 
| disorot | Boolean | Menetapkan apakah node harus disorot. Gunakan, misalnya, untuk mewakili jalur tertentu dalam grafik dengan menyoroti beberapa node dan tepi. Default ke `false`. | 

# Bagan pai
<a name="v10-panels-piechart"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

![\[Gambar yang menunjukkan contoh visualisasi diagram lingkaran di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/pie_chart_example.png)


Diagram lingkaran menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, dalam bentuk irisan kue. Panjang busur, luas dan sudut tengah irisan semuanya sebanding dengan nilai irisan, karena berkaitan dengan jumlah semua nilai. Jenis bagan ini paling baik digunakan ketika Anda menginginkan perbandingan cepat dari serangkaian kecil nilai dalam bentuk yang menyenangkan secara estetika.

## Opsi nilai
<a name="v10-panels-piechart-value"></a>

Gunakan opsi berikut untuk menyempurnakan nilai dalam visualisasi Anda.

**Tampilkan**

Pilih berapa banyak informasi yang akan ditampilkan.
+ **Hitung** — Mengurangi setiap nilai menjadi satu nilai per seri.
+ **Semua nilai** - Menampilkan setiap nilai dari satu seri.

**Perhitungan**

Pilih perhitungan untuk mengurangi setiap seri saat **Hitung** telah dipilih. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v10-panels-calculation-types.md).

**Batasi**

Saat menampilkan setiap nilai dari satu seri, ini membatasi jumlah nilai yang ditampilkan.

**Bidang**

Pilih setidaknya satu bidang untuk ditampilkan dalam visualisasi. Setiap nama bidang tersedia dalam daftar, atau Anda dapat memilih salah satu opsi berikut:
+ **Bidang numerik** - Semua bidang dengan nilai numerik.
+ **Semua bidang** — Semua bidang yang tidak dihapus oleh transformasi.
+ **Waktu** - Semua bidang dengan nilai waktu.

## Opsi diagram lingkaran
<a name="v10-panels-piechart-options"></a>

Gunakan opsi ini untuk menyempurnakan tampilan visualisasi Anda.

**Jenis diagram pai**

Pilih gaya tampilan diagram lingkaran. Bisa berupa:
+ **Pie** — Bagan lingkaran standar
+ **Donat** — Diagram lingkaran dengan lubang di tengah

**Label**

Pilih label untuk ditampilkan pada diagram lingkaran. Anda dapat memilih lebih dari satu.
+ **Nama - Nama** seri atau bidang.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Label ditampilkan dalam warna putih di atas badan bagan secara default. Anda dapat memilih warna grafik yang lebih gelap untuk membuatnya lebih terlihat. Nama atau angka panjang mungkin terpotong.

**Mode Tooltip**

Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

Gunakan override untuk menyembunyikan seri individual dari tooltip.

## Opsi legenda
<a name="v10-panels-piechart-legend"></a>

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

**Visibilitas legenda**

Gunakan sakelar **Visibilitas** untuk menampilkan atau menyembunyikan legenda.

**Mode legenda**

Atur mode tampilan legenda.
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih nilai untuk ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).

# Stat
<a name="v10-panels-stat"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Statistik menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau warna nilai menggunakan ambang batas atau penggantian.

![\[Gambar yang menunjukkan contoh visualisasi stat di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/stat_panel_example.png)


Secara default, Stat menampilkan salah satu dari berikut ini:
+ Hanya nilai untuk satu seri atau bidang.
+ Baik nilai dan nama untuk beberapa seri atau bidang.

Anda dapat menggunakan **mode Teks** untuk mengontrol apakah teks ditampilkan atau tidak.

## Penyesuaian tata letak otomatis
<a name="v10-panels-stat-automatic-adjust"></a>

Panel secara otomatis menyesuaikan tata letak tergantung pada lebar dan tinggi yang tersedia di dasbor. Secara otomatis menyembunyikan grafik (sparkline) jika panel menjadi terlalu kecil.

## Opsi nilai
<a name="v10-panels-stat-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.
+ **Hitung**

  Tampilkan nilai yang dihitung berdasarkan semua baris.
  + **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat [perhitungan standar](v10-panels-calculation-types.md).
  + **Bidang** - Pilih bidang yang ditampilkan dalam visualisasi.
+ **Semua nilai**

  Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
  + **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
  + **Bidang** - Pilih bidang yang ditampilkan dalam visualisasi.

## Gaya stat
<a name="v10-panels-stat-styles"></a>

Gaya visualisasi Anda.

**Orientasi**

Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.

**Modus teks**

Anda dapat menggunakan opsi mode Teks untuk mengontrol teks apa yang dirender visualisasi. Jika nilainya tidak penting, hanya nama dan warnanya, lalu ubah **mode Teks** menjadi **Nama**. Nilai akan tetap digunakan untuk menentukan warna dan ditampilkan dalam tooltip.
+ **Otomatis** - Jika data berisi beberapa seri atau bidang, tampilkan nama dan nilai.
+ **Nilai** - Tampilkan hanya nilai, jangan pernah nama. Nama ditampilkan di tooltip hover sebagai gantinya.
+ **Nilai dan nama** — Selalu tunjukkan nilai dan nama.
+ **Nama** - Tampilkan nama, bukan nilai. Nilai ditampilkan di tooltip hover.
+ **Tidak ada** - Tidak menunjukkan apa-apa (kosong). Nama dan nilai ditampilkan di tooltip hover.

**Tata letak yang luas**

Atur apakah tata letak lebar diaktifkan atau tidak. Tata letak lebar diaktifkan secara default.
+ **Aktif** - Tata letak lebar dihidupkan.
+ **Mati** - Tata letak lebar dimatikan.

**catatan**  
Opsi ini hanya berlaku ketika **mode Teks** diatur ke **Nilai dan nama**. Ketika tata letak lebar dihidupkan, nilai dan nama ditampilkan side-by-side dengan nilai di sebelah kanan, jika panel cukup lebar. Ketika tata letak lebar dimatikan, nilai selalu dirender di bawah nama.

**Modus warna**

Pilih mode warna.
+ **Tidak ada** - Tidak ada warna yang diterapkan pada nilai.
+ **Nilai** - Menerapkan warna ke nilai dan area grafik.
+ **Gradien Latar Belakang** - Menerapkan warna pada nilai, area grafik, dan latar belakang, dengan sedikit gradien latar belakang.
+ **Latar Belakang Solid** - Menerapkan warna ke nilai, area grafik, dan latar belakang, dengan warna latar belakang yang solid.

**Modus grafik**

Pilih grafik dan mode sparkline.
+ **Tidak ada** - Menyembunyikan grafik dan hanya menunjukkan nilainya.
+ **Area** - Menunjukkan grafik area di bawah nilai. Ini mengharuskan kueri Anda mengembalikan kolom waktu.

**Penjajaran teks**

Pilih mode penyelarasan.
+ **Otomatis** - Jika hanya satu nilai yang ditampilkan (tidak ada pengulangan), maka nilainya terpusat. Jika beberapa seri atau baris ditampilkan, maka nilainya sejajar kiri.
+ **Pusat** — Nilai Stat dipusatkan.

**Tunjukkan persen perubahan**

Tetapkan apakah perubahan persen ditampilkan atau tidak. Secara default itu tidak ditampilkan.

**catatan**  
Opsi ini tidak berlaku ketika pengaturan **Tampilkan**, di bawah **opsi Nilai**, diatur ke **Semua nilai**.

## Ukuran teks
<a name="v10-panels-stat-textsize"></a>

Sesuaikan ukuran teks pengukur.
+ **Judul** - Masukkan nilai numerik untuk ukuran judul pengukur.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Garis waktu negara
<a name="v10-panels-state-timeline"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Garis waktu status menunjukkan perubahan status diskrit dari waktu ke waktu. Setiap bidang atau seri dirender sebagai pita horisontal yang unik. Wilayah negara bagian dapat dirender dengan atau tanpa nilai. Panel ini bekerja dengan baik dengan status string atau boolean tetapi juga dapat digunakan dengan deret waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

![\[Gambar yang menunjukkan contoh visualisasi garis waktu status di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/state_timeline_example.png)


## Opsi garis waktu negara
<a name="v10-panels-state-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Gabungkan nilai berurutan yang sama**

Mengontrol apakah Grafana menggabungkan nilai yang identik jika keduanya bersebelahan.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam wilayah negara bagian. **Otomatis** akan merender nilai jika ada ruang yang cukup.

**Sejajarkan nilai**

Mengontrol penyelarasan nilai di dalam wilayah negara bagian.

**Tinggi baris**

Mengontrol ruang antar baris. 1 = tidak ada spasi = 0,5 = 50% ruang.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas wilayah negara bagian.

**Connect nilai null**

Pilih bagaimana nilai nol, yang merupakan celah dalam data, muncul pada grafik. Nilai nol dapat dihubungkan untuk membentuk garis kontinu atau diatur ke ambang batas di mana celah dalam data tidak lagi terhubung.
+ **Tidak pernah** — Titik data deret waktu dengan celah dalam data tidak pernah terhubung.
+ **Selalu** — Titik data deret waktu dengan celah dalam data selalu terhubung.
+ **Ambang batas** — Tentukan ambang batas di mana celah dalam data tidak lagi terhubung. Ini dapat berguna ketika celah yang terhubung dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan celah di luar rentang ini seharusnya tidak lagi terhubung.

**Putuskan nilai**

Pilih apakah akan menetapkan ambang batas di atas nilai mana dalam data harus terputus.
+ **Tidak pernah** — Titik data deret waktu dalam data tidak pernah terputus.
+ **Ambang batas** — Tentukan ambang batas di atas mana nilai dalam data terputus. Ini dapat berguna ketika nilai yang diinginkan dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan nilai di luar rentang ini seharusnya tidak lagi terhubung.

## Pemetaan nilai
<a name="v10-panels-state-timeline-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v10-panels-state-timeline-threshold"></a>

Visualisasi dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mengubah deret waktu menjadi daerah keadaan berwarna diskrit.

## Opsi legenda
<a name="v10-panels-state-timeline-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi **skema Warna** di bawah Opsi standar diatur ke **Warna tunggal** atau Palet **klasik**. Untuk melihat tanda kurung ambang batas dalam legenda, atur **skema Warna** ke **Dari ambang batas**.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode default.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Riwayat status
<a name="v10-panels-status-history"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Sejarah status menunjukkan keadaan periodik dari waktu ke waktu. Setiap bidang atau seri dirender sebagai baris horizontal. Kotak dirender dan dipusatkan di sekitar setiap nilai.

## Data yang didukung
<a name="v10-panels-status-history-supporteddata"></a>

Riwayat status bekerja dengan string, boolean, dan bidang numerik atau deret waktu. Diperlukan bidang waktu. Anda dapat menggunakan pemetaan nilai untuk mewarnai string atau menetapkan nilai teks ke rentang numerik.

## Opsi tampilan
<a name="v10-panels-status-history-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam kotak nilai. **Otomatis** akan merender nilai jika ada ruang yang cukup.

**Lebar kolom**

Mengontrol lebar kotak. 1 = ruang maksimum dan 0 = ruang minimum.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas pengisian wilayah negara bagian.

## Pemetaan nilai
<a name="v10-panels-status-history-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v10-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v10-panels-status-history-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mewarnai kotak. Anda juga dapat menggunakan skema warna gradien untuk mewarnai nilai.

## Opsi legenda
<a name="v10-panels-status-history-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi **skema Warna** di bawah Opsi standar diatur ke **Warna tunggal** atau Palet **klasik**. Untuk melihat tanda kurung ambang batas dalam legenda, atur **skema Warna** ke **Dari ambang batas**.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode default.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Tabel
<a name="v10-panels-table"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tabel sangat fleksibel, mendukung beberapa mode untuk deret waktu dan untuk tabel, anotasi, dan data JSON mentah. Visualisasi ini juga menyediakan pemformatan tanggal, pemformatan nilai, dan opsi pewarnaan.

![\[Gambar yang menunjukkan contoh visualisasi tabel di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/table_example.png)


**catatan**  
Anotasi dan peringatan tidak didukung dalam tabel.

## Urutkan kolom
<a name="v10-panels-table-sort"></a>

Pilih judul kolom untuk mengubah urutan pengurutan dari default ke turun ke naik. Setiap kali Anda memilih kolom, urutan pengurutan berubah ke opsi berikutnya dalam siklus. Anda dapat mengurutkan beberapa kolom dengan menahan `shift` tombol saat memilih kolom tambahan.

## Opsi tabel
<a name="v10-panels-table-options"></a>

**Tampilkan header**

Tampilkan atau sembunyikan nama kolom yang diimpor dari sumber data Anda.

## Lebar kolom
<a name="v10-panels-table-width"></a>

Secara default, Grafana secara otomatis menghitung lebar kolom berdasarkan ukuran tabel dan lebar kolom minimum. Opsi bidang ini dapat mengganti pengaturan dan menentukan lebar untuk semua kolom dalam piksel.

Misalnya, jika Anda masuk`100`, semua kolom akan diatur ke lebar 100 piksel (perubahan terjadi saat Anda keluar dari bidang).

## Lebar kolom minimum
<a name="v10-panels-table-min"></a>

Secara default, lebar minimum kolom tabel adalah 150 piksel. Opsi bidang ini dapat mengganti default itu dan akan menentukan lebar kolom minimum baru untuk panel tabel dalam piksel.

Misalnya, jika Anda menetapkan minimum ke`75`, semua kolom akan skala tidak lebih kecil dari 75 piksel lebar.

Untuk perangkat layar kecil, seperti smartphone atau tablet, Anda dapat mengurangi nilai `150` piksel default `50` untuk memungkinkan panel berbasis tabel dirender dengan benar di dasbor.

## Penyelarasan kolom
<a name="v10-panels-table-alignment"></a>

Pilih bagaimana Grafana harus menyelaraskan isi sel.
+ Otomatis (default)
+ Kiri
+ Pusat
+ Kanan

## Jenis sel
<a name="v10-panels-table-cell-type"></a>

Secara default, Grafana secara otomatis memilih pengaturan tampilan. Anda dapat mengganti pengaturan dengan memilih salah satu opsi berikut untuk mengatur default untuk semua bidang. Konfigurasi tambahan tersedia untuk beberapa jenis sel.

**catatan**  
Jika Anda mengatur ini di tab **Bidang**, maka jenis akan berlaku untuk semua bidang, termasuk bidang waktu. Anda dapat mengaturnya di tab **Override** untuk menerapkan perubahan ke satu atau beberapa bidang.

**Teks warna**

Jika ambang batas ditetapkan, maka teks bidang ditampilkan dalam warna ambang batas yang sesuai.

**Latar belakang warna (gradien atau padat)**

Jika ambang batas ditetapkan, maka latar belakang bidang ditampilkan dalam warna ambang batas yang sesuai.

**Gauge**

Sel dapat ditampilkan sebagai pengukur grafis, dengan beberapa jenis presentasi yang berbeda.
+ *Dasar* — Mode dasar akan menunjukkan pengukur sederhana dengan tingkat ambang batas yang menentukan warna pengukur.
+ *Gradien* — Tingkat ambang batas menentukan gradien.
+ *LCD* — Pengukur dibagi dalam sel-sel kecil yang menyala atau tidak menyala.

Selain itu, label yang ditampilkan di samping alat pengukur dapat diatur untuk diwarnai berdasarkan nilai, cocok dengan warna teks tema, atau disembunyikan.
+ **Nilai warna**
+ **Warna teks**
+ **Tersembunyi**

**Tampilan JSON**

Menampilkan nilai diformat sebagai kode. Jika nilai adalah objek tampilan JSON memungkinkan browsing objek JSON akan muncul di hover.

**Sparkline**

Menampilkan nilai yang diberikan sebagai sparkline. Membutuhkan [deret waktu untuk mengubah data tabel](v10-panels-xform-functions.md#v10-panels-xform-funcs-series).

## Periksa nilai sel
<a name="v10-panels-table-cell-value"></a>

Memungkinkan pemeriksaan nilai dari sel tabel. Nilai mentah disajikan dalam jendela modal.

**catatan**  
Pemeriksaan nilai sel hanya tersedia ketika mode tampilan sel diatur ke Otomatis, Teks warna, Latar belakang warna, atau Tampilan JSON.

## Filter kolom
<a name="v10-panels-table-col-filter"></a>

Anda dapat mengubah sementara bagaimana data kolom ditampilkan. Misalnya, Anda dapat mengurutkan nilai dari tertinggi ke terendah atau menyembunyikan nilai tertentu. Untuk informasi selengkapnya, lihat [Menyaring kolom tabel](#v10-panels-table-filter).

## Paginasi
<a name="v10-panels-table-pagination"></a>

Gunakan opsi ini untuk mengaktifkan atau menonaktifkan pagination. Ini adalah opsi front-end yang tidak memengaruhi kueri. Saat diaktifkan, ukuran halaman secara otomatis menyesuaikan dengan ketinggian tabel.

## Filter kolom tabel
<a name="v10-panels-table-filter"></a>

Jika Anda mengaktifkan **filter Kolom**, maka Anda dapat memfilter opsi tabel.

**Untuk mengaktifkan pemfilteran kolom**

1. Di Grafana, arahkan ke dasbor dengan tabel dengan kolom yang ingin Anda filter.

1. Pada panel tabel yang ingin Anda filter, buka editor panel.

1. Pilih tab **Bidang**.

1. Dalam opsi **Tabel**, aktifkan opsi **Filter kolom**.

Ikon filter (corong) muncul di sebelah setiap judul kolom.

**Nilai kolom filter**

Untuk memfilter nilai kolom, pilih ikon filter (corong) di sebelah judul kolom. Grafana menampilkan opsi filter untuk kolom itu.

Pilih kotak centang di sebelah nilai yang ingin Anda tampilkan. Masukkan teks di bidang pencarian di bagian atas untuk menampilkan nilai-nilai tersebut di layar sehingga Anda dapat memilihnya daripada menggulir untuk menemukannya.

Pilih dari beberapa operator untuk menampilkan nilai kolom:
+ **Berisi** - Cocokkan pola regex (operator secara default).
+ **Ekspresi** - Mengevaluasi ekspresi Boolean. Karakter `$` mewakili nilai kolom dalam ekspresi (misalnya,`$ >= 10 ≈& $ <= 12`).
+ **Operator perbandingan** — Anda dapat menggunakan operator perbandingan khas:`=`,`!=`,`<`,`<=`,`>`,`>=`.

Pilih kotak centang di atas **Ok** dan **Batal** tombol untuk menambah atau menghapus semua nilai yang ditampilkan dari filter.

**Hapus filter kolom**

Kolom dengan filter yang diterapkan memiliki corong biru yang ditampilkan di sebelah judul.

Untuk menghapus filter, pilih ikon corong biru dan kemudian pilih **Hapus filter**.

## Footer meja
<a name="v10-panels-table-footer"></a>

Anda dapat menggunakan footer tabel untuk menampilkan [perhitungan](v10-panels-calculation-types.md) pada bidang.

Setelah Anda mengaktifkan footer tabel, Anda dapat memilih **Perhitungan**, dan kemudian **Bidang** yang ingin Anda hitung.

Sistem menerapkan perhitungan ke semua bidang numerik jika Anda tidak memilih bidang.

**Hitung baris**

Jika Anda ingin menampilkan jumlah baris dalam kumpulan data alih-alih jumlah nilai di bidang yang dipilih, pilih **Hitung perhitungan dan aktifkan Hitung** **baris**.

# Teks
<a name="v10-panels-text"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi teks memungkinkan Anda untuk secara langsung memasukkan teks atau HTML di dasbor Anda. Ini dapat digunakan untuk menambahkan informasi kontekstual dan deskripsi atau menanamkan HTML kompleks.

**Modus**

**Mode** menentukan bagaimana konten yang disematkan muncul. Ini memiliki opsi berikut:
+ **Markdown** - Opsi ini memformat konten sebagai penurunan harga.
+ **HTML** - Pengaturan ini membuat konten sebagai HTML yang disanitasi.
+ **Kode** - Pengaturan ini membuat konten di dalam editor kode read-only. Pilih bahasa yang sesuai untuk menerapkan penyorotan sintaks ke teks yang disematkan.

**Variabel**

Variabel dalam konten akan diperluas untuk ditampilkan.

# Deret waktu
<a name="v10-panels-time-series"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

![\[Gambar yang menunjukkan contoh visualisasi deret waktu di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/time_series_example.png)


Visualisasi deret waktu adalah cara default dan utama untuk memvisualisasikan data deret waktu sebagai grafik. Mereka dapat membuat seri sebagai garis, titik, atau bar. Mereka cukup serbaguna untuk menampilkan hampir semua data deret waktu.

**catatan**  
Anda dapat memigrasikan visualisasi panel Grafik ke visualisasi deret Waktu. Untuk bermigrasi, pada tab **Panel**, pilih **Visualisasi deret waktu**. Grafana mentransfer semua pengaturan yang berlaku.

**Topics**
+ [Opsi tooltip](v10-time-series-panel-tooltip.md)
+ [Opsi legenda](v10-time-series-panel-legend.md)
+ [Gaya grafik](v10-time-series-graph.md)
+ [Opsi sumbu](v10-time-series-axis.md)
+ [Pilihan warna](v10-time-series-color.md)

# Opsi tooltip
<a name="v10-time-series-panel-tooltip"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Opsi tooltip mengontrol hamparan informasi yang muncul saat Anda mengarahkan kursor ke titik data dalam grafik.

**Mode Tooltip**
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

# Opsi legenda
<a name="v10-time-series-panel-legend"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Opsi legenda mengontrol nama seri dan statistik yang muncul di bawah atau di sebelah kanan grafik.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi lebih lanjut tentang legenda, lihat[Konfigurasikan legenda](v10-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Gaya grafik
<a name="v10-time-series-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan opsi ini untuk menentukan cara menampilkan data deret waktu Anda. Anda dapat menggunakan penggantian untuk menggabungkan beberapa gaya dalam grafik yang sama.
+ **Garis** — Menampilkan deret waktu sebagai garis pada grafik.
+ **Bar** — Menampilkan deret waktu sebagai serangkaian batang pada grafik, satu untuk setiap titik data.
+ **Poin** — Menampilkan deret waktu sebagai titik pada grafik, satu untuk setiap titik data.

## Penjajaran batang
<a name="v10-time-series-graph-bar"></a>

Atur posisi batang relatif terhadap titik data.di mana titik akan digambar pada grafik. Karena sebuah bar memiliki lebar, maka dapat ditempatkan sebelum, sesudah, atau dipusatkan pada titik. Pilihan untuk opsi ini adalah:
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-before.png)**Sebelum** — Bar ditarik sebelum titik. Titik ditempatkan di sudut belakang bar.
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-center.png)**Tengah** — Bar digambar di sekitar titik. Intinya ditempatkan di tengah bar. Ini adalah opsi default.
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/bar-alignment-after.png)**Setelah** — Bar ditarik setelah titik. titik ditempatkan di sudut depan bar.

## Lebar garis
<a name="v10-time-series-graph-linewidth"></a>

Lebar garis adalah slider yang mengontrol ketebalan untuk garis seri atau garis besar untuk bar.

## Isi opacity
<a name="v10-time-series-graph-fill"></a>

Mengatur opasitas warna isian. Isi digunakan, misalnya, untuk menunjukkan area di bawah garis dalam grafik garis, atau sebagai warna batang dalam grafik batang.

## Mode gradien
<a name="v10-time-series-graph-gradient"></a>

Mode gradien menentukan gradien fill, yang didasarkan pada warna seri. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Untuk informasi selengkapnya, lihat [Skema warna](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme).

Opsi mode gradien adalah:
+ **Tidak ada** - Tidak ada pengisian gradien. Ini adalah pengaturan default.
+ **Opacity** — Gradien opasitas di mana opasitas isian meningkat seiring dengan meningkatnya nilai sumbu Y.
+ **Hue** — Gradien halus yang didasarkan pada rona warna seri.
+ **Skema** - Gradien warna yang ditentukan oleh skema warna Anda. Pengaturan ini digunakan untuk area pengisian dan garis. Untuk informasi selengkapnya, lihat [Pilihan warna](v10-time-series-color.md).

Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.

## Tampilkan poin
<a name="v10-time-series-graph-showpoints"></a>

Anda dapat mengonfigurasi visualisasi Anda untuk menambahkan titik ke garis atau bilah, dengan opsi berikut.
+ **Otomatis** — Grafana menentukan apakah akan menunjukkan titik berdasarkan kepadatan data. Poin ditampilkan ketika densitasnya rendah.
+ **Selalu** — Poin ditampilkan, terlepas dari kepadatan data.
+ **Jangan pernah** — Jangan tunjukkan poin.

## Ukuran titik
<a name="v10-time-series-graph-pointsize"></a>

Mengatur ukuran titik, dari diameter 1 hingga 40 piksel.

## Interpolasi garis
<a name="v10-time-series-graph-interpolation"></a>

Pilih bagaimana Grafana menginterpolasi garis seri.

![\[Gambar yang menunjukkan berbagai cara menggambar garis antar titik di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/line-interpolation.png)


Opsinya adalah:
+ **Linear** — Poin digabungkan dengan garis lurus.
+ **Smooth** - Poin digabungkan dengan garis lengkung yang menghaluskan transisi antar titik.
+ **Langkah sebelumnya** - Garis ditampilkan sebagai langkah antar titik. Poin diberikan pada akhir langkah.
+ **Langkah setelah** - Garis ditampilkan sebagai langkah antar titik. Poin diberikan di awal langkah.

## Gaya garis
<a name="v10-time-series-graph-linestyle"></a>

Atur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

Pilihan untuk gaya garis adalah:
+ **Solid** - Tampilkan garis yang solid. Ini adalah pengaturan default.
+ **Dash** - Menampilkan garis putus-putus. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih panjang dan celah (panjang, celah) untuk garis garis. Jarak dasbor diatur ke 10, 10 secara default.
+ **Dots** - Tampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih panjang celah untuk spasi titik. Dot spasi diatur ke 10 secara default.

## Connect nilai null
<a name="v10-time-series-graph-null"></a>

Pilih bagaimana nilai nol, yang merupakan celah dalam data, muncul pada grafik. Nilai nol dapat dihubungkan untuk membentuk garis kontinu, atau diatur ke ambang batas di mana celah dalam data tidak lagi terhubung.

Pilihan untuk cara menghubungkan nilai null adalah:
+ **Tidak pernah** — Titik data deret waktu dengan celah dalam data tidak pernah terhubung.
+ **Selalu** — Titik data deret waktu dengan celah dalam data selalu terhubung.
+ **Ambang batas** — Tentukan ambang batas di mana celah dalam data tidak lagi terhubung. Ini dapat berguna ketika celah yang terhubung dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan celah di luar jangkauan seharusnya tidak lagi terhubung.

## Putuskan nilai
<a name="v10-time-series-graph-disconnect"></a>

Pilih apakah akan menambahkan kesenjangan antara nilai dalam data yang memiliki waktu di antara mereka di atas ambang batas yang ditentukan.

Pilihan untuk nilai pemutusan adalah:
+ **Tidak pernah** - Titik data deret waktu tidak pernah terputus.
+ **Ambang batas** — Tentukan ambang batas di atas mana nilai dalam data terputus. Ini dapat berguna ketika nilai yang diinginkan dalam data memiliki ukuran yang diketahui atau dalam rentang yang diketahui, dan nilai di luar rentang ini seharusnya tidak lagi terhubung.

## Seri tumpukan
<a name="v10-time-series-graph-stack"></a>

*Penumpukan* memungkinkan Grafana untuk menampilkan seri di atas satu sama lain. Berhati-hatilah saat menggunakan penumpukan dalam visualisasi karena dapat dengan mudah membuat grafik yang menyesatkan. Untuk membaca lebih lanjut tentang mengapa penumpukan mungkin bukan pendekatan terbaik, lihat [Masalah dengan Penumpukan](https://www.data-to-viz.com/caveat/stacking.html).

Pilihan untuk susun adalah:
+ **Mati** — Mematikan susun seri.
+ **Normal** — Seri tumpukan di atas satu sama lain.
+ **100%** - Tumpuk berdasarkan persentase, di mana semua seri bersama-sama menambahkan hingga 100%.

**Seri susun dalam kelompok**

Anda dapat mengganti perilaku penumpukan untuk menumpuk seri dalam grup. Untuk informasi selengkapnya tentang membuat penggantian, lihat[Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md).

**Untuk menumpuk seri dalam grup**

1. Edit panel dan pilih **Overrides**.

1. Buat penggantian bidang untuk opsi **seri Stack**.

1. Dalam mode susun, pilih **Normal**.

1. Beri nama grup susun tempat Anda ingin seri muncul.

   Opsi nama grup susun hanya tersedia saat Anda membuat penggantian.

## Isi di bawah ini untuk
<a name="v10-time-series-graph-fillbelow"></a>

Opsi **Isi di bawah untuk** mengisi area antara dua seri. Opsi ini hanya tersedia sebagai penggantian seri atau bidang.

Dengan menggunakan opsi ini Anda dapat mengisi area antara dua seri, bukan dari garis seri ke 0. Misalnya, jika Anda memiliki dua seri yang disebut *Max* dan *Min*, Anda dapat memilih seri *Max* dan menggantinya ke **Fill di bawah ini ke** seri *Min*. Ini hanya akan mengisi area antara dua baris seri.

# Opsi sumbu
<a name="v10-time-series-axis"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Opsi di bawah kategori sumbu mengubah cara sumbu x dan y dirender. Beberapa opsi tidak berlaku sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit. Anda juga dapat menekan`Enter`.

## Zona waktu
<a name="v10-time-series-axis-timezone"></a>

Atur zona waktu yang diinginkan untuk ditampilkan di sepanjang sumbu x.

## Penempatan
<a name="v10-time-series-axis-placement"></a>

Pilih penempatan sumbu Y. Opsinya adalah:
+ **Otomatis** - Secara otomatis menetapkan sumbu y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, Grafana menetapkan sumbu kiri ke unit pertama, dan sumbu kanan ke unit berikutnya.
+ **Kiri** - Tampilkan semua sumbu y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu y di sisi kanan.
+ **Tersembunyi** - Sembunyikan semua sumbu.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang yang](v10-panels-configure-overrides.md) menargetkan bidang tertentu.

## Label
<a name="v10-time-series-axis-label"></a>

Tetapkan label teks sumbu y. Jika Anda memiliki lebih dari satu sumbu y, maka Anda dapat menetapkan label yang berbeda menggunakan override.

## Lebar
<a name="v10-time-series-axis-width"></a>

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Pengaturan ini memudahkan Anda untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau membentang dalam jarak visual satu sama lain.

## Tampilkan garis kisi
<a name="v10-time-series-axis-gridlines"></a>

Atur visibilitas garis kisi sumbu.
+ **Otomatis** - Secara otomatis menampilkan garis kisi berdasarkan kepadatan data.
+ **Aktif** — Selalu tampilkan garis kisi.
+ **Mati** - Jangan pernah menampilkan garis kisi.

## Warna
<a name="v10-time-series-axis-color"></a>

Atur warna sumbu.
+ **Teks** - Mengatur warna berdasarkan warna teks tema.
+ **Seri** - Atur warna berdasarkan warna seri.

## Tampilkan perbatasan
<a name="v10-time-series-axis-border"></a>

Atur visibilitas batas sumbu.

## Penskalaan
<a name="v10-time-series-axis-scale"></a>

Atur bagaimana skala nilai sumbu y.
+ **Linear** — Membagi skala menjadi bagian yang sama.
+ **Logaritmik** — Gunakan skala logaritmik. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10).
+ **Symlog — Gunakan skala logaritmik** simetris. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10). Opsi ambang batas linier memungkinkan Anda untuk mengatur ambang batas di mana skala berubah dari linier ke logaritmik.

## Nol berpusat
<a name="v10-time-series-axis-centered"></a>

Mengatur sumbu y untuk dipusatkan pada nol.

## Soft min dan soft max
<a name="v10-time-series-axis-softminmax"></a>

Tetapkan opsi **Soft min** atau **soft max** untuk kontrol batas sumbu y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah variasi kecil dalam data diperbesar saat sebagian besar datar. Sebaliknya, nilai min dan maks yang keras membantu mencegah mengaburkan detail yang berguna dalam data dengan memotong lonjakan intermiten melewati titik tertentu.

Untuk menentukan batas keras sumbu y, tetapkan min/max opsi standar. Untuk informasi selengkapnya, lihat [Konfigurasi opsi standar](v10-panels-configure-standard-options.md).

## Transformasi
<a name="v10-time-series-axis-transform"></a>

Gunakan opsi ini untuk mengubah nilai seri tanpa memengaruhi nilai yang ditampilkan di tooltip, menu konteks, atau legenda. Anda memiliki dua opsi transformasi:
+ **Transformasi Y negatif** — Balikkan hasil ke nilai negatif pada sumbu Y.
+ **Konstan** — Tunjukkan nilai pertama sebagai garis konstan.

**catatan**  
Opsi transformasi hanya tersedia sebagai penggantian.

## Tampilkan beberapa sumbu y
<a name="v10-time-series-axis-multiple"></a>

Ada beberapa kasus di mana Anda ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda dapat menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Untuk menampilkan beberapa sumbu y, [tambahkan penggantian bidang](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

# Pilihan warna
<a name="v10-time-series-color"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Secara default, grafik menggunakan opsi [skema Warna](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme) standar untuk menetapkan warna seri. Anda juga dapat menggunakan legenda untuk membuka pemilih warna dengan memilih ikon warna seri legenda. Menyetel warna dengan cara ini secara otomatis membuat aturan penggantian yang menetapkan warna tertentu untuk seri tertentu.

Berikut ini adalah opsi tambahan yang dapat Anda gunakan untuk mengganti default warna seri.

## Palet klasik
<a name="v10-time-series-color-classic"></a>

Pengaturan yang paling umum adalah menggunakan **palet Klasik** untuk grafik. Skema ini secara otomatis memberikan warna untuk setiap bidang atau seri berdasarkan urutannya. Jika urutan bidang berubah dalam kueri Anda, warnanya juga berubah. Anda dapat mengonfigurasi warna secara manual untuk bidang tertentu menggunakan aturan penggantian.

## Warna tunggal
<a name="v10-time-series-color-single"></a>

Gunakan mode ini untuk menentukan warna. Anda juga dapat memilih ikon garis berwarna di sebelah setiap seri di Legenda untuk membuka pemilih warna. Ini secara otomatis membuat penggantian baru yang mengatur skema warna menjadi satu warna dan warna yang dipilih.

## Dengan skema warna nilai
<a name="v10-time-series-color-byvalue"></a>

Jika Anda memilih skema warna berdasarkan nilai seperti **Dari ambang batas (berdasarkan nilai)** atau **Green-Yellow-Red (berdasarkan nilai)**, **Seri warna berdasarkan opsi muncul**. Opsi ini mengontrol nilai mana (Terakhir, Min, Maks) yang akan digunakan untuk menetapkan seri warnanya.

## Mode gradien skema
<a name="v10-time-series-color-gradient"></a>

Opsi **mode Gradien** yang terletak di bawah **gaya Grafik** memiliki mode bernama **Skema**. Saat Anda mengaktifkan **Skema**, garis atau bilah menerima warna gradien yang ditentukan dari **skema Warna** yang dipilih.

**Dari ambang batas**

Jika **skema Warna** diatur ke **Dari ambang batas (berdasarkan nilai)** dan **mode Gradien** diatur ke **Skema**, maka warna garis atau batang berubah saat melewati ambang batas yang ditentukan. Anda hanya akan melihat warna yang tepat yang dipilih dalam skema.

**Skema warna gradien**

Menggunakan skema warna gradien *tanpa* mengatur **mode Gradien** ke **Skema**, berarti bahwa warna yang dipilih akan membentuk gradien antara warna yang dipilih, karena nilai dalam seri bergerak di antara ambang batas yang ditetapkan.

# Jejak
<a name="v10-panels-traces"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi jejak memungkinkan Anda mengikuti permintaan saat melintasi layanan di infrastruktur Anda. Visualisasi jejak menampilkan data jejak dalam diagram yang memungkinkan Anda menafsirkannya dengan mudah.

Untuk informasi lebih lanjut tentang jejak dan cara menggunakannya, lihat dokumentasi berikut:
+ [Menelusuri di Jelajahi](v10-explore-tracing.md)
+ [Sumber data tempo](tempo-data-source.md)
+ [Memulai dengan Tempo di Dokumentasi](https://grafana.com/docs/tempo/latest/getting-started/) Tempo *Grafana Labs*.

## Menambahkan panel dengan visualisasi penelusuran
<a name="v10-panels-traces-add"></a>

Setelah Anda memiliki data penelusuran yang tersedia di tumpukan Grafana Anda, Anda dapat menambahkan panel pelacakan ke dasbor Grafana Anda.

Menggunakan variabel dasbor,`traceID`, memungkinkan Anda membuat kueri untuk menampilkan jejak tertentu untuk ID jejak yang diberikan. Untuk informasi lebih lanjut tentang variabel dasbor, lihat [dokumentasi Variabel](v10-dash-variables.md). 

**Prasyarat**

Sebelum memulai, Anda memerlukan:
+ Ruang kerja Grafana yang Dikelola Amazon.
+ [Sumber data Tempo](tempo-data-source.md) yang terhubung ke ruang kerja Anda.

Untuk melihat dan menganalisis data jejak di dasbor, Anda perlu menambahkan visualisasi jejak ke dasbor Anda dan menentukan kueri menggunakan editor panel. Kueri menentukan data yang ditampilkan dalam visualisasi. Untuk informasi lebih lanjut tentang editor panel, lihat [dokumentasi Editor Panel](v10-panels-editor-overview.md).

Prosedur ini menggunakan variabel dasbor dan template untuk memungkinkan Anda memasukkan jejak IDs yang kemudian dapat divisualisasikan. Anda akan menggunakan variabel yang disebut `traceId` dan menambahkannya sebagai kueri template.

**Untuk menambahkan kueri visualisasi jejak**

1. Di ruang kerja Anda, buat dasbor baru atau buka dasbor yang ada tempat Anda ingin menambahkan visualisasi jejak.

1. Pilih **Tambahkan visualisasi** dari dasbor baru atau pilih **Tambah Panel** di dasbor yang ada.

1. Pilih sumber data penelusuran yang sesuai.

1. **Di kanan atas editor panel, pilih tab **Visualisasi**, dan pilih Jejak.**

1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda. Untuk informasi selengkapnya tentang editor panel, lihat[Konfigurasikan opsi panel](v10-panels-configure-panel-options.md).

1. Di editor kueri, pilih tab jenis kueri **TraceQL**.

1.  Masukkan `${traceId}` di bidang query TraceQL untuk membuat variabel dasbor. Variabel ini digunakan sebagai query template.

1. Pilih **Terapkan** di editor panel untuk menambahkan panel ke dasbor.

1. Buka **Pengaturan** dasbor dan tambahkan variabel baru yang disebut`traceId`, dari tipe variabel **Kustom**, berikan label, jika diperlukan. Pilih **Terapkan** untuk menambahkan variabel ke dasbor.

1. Verifikasi bahwa panel berfungsi dengan menggunakan ID jejak yang valid untuk sumber data yang digunakan untuk panel jejak dan mengedit ID di variabel dasbor.

## Menambahkan traceQL dengan visualisasi tabel
<a name="v10-panels-traces-traceql"></a>

Meskipun Anda dapat menambahkan visualisasi jejak ke dasbor, harus menambahkan jejak secara manual IDs sebagai variabel dasbor tidak praktis. Lebih berguna untuk dapat menggunakan kueri TraceQL untuk mencari jenis jejak tertentu dan kemudian memilih jejak yang sesuai dari hasil yang cocok.

**Prasyarat**

Prosedur ini mengasumsikan Anda telah menyelesaikan prosedur sebelumnya.

**Untuk menambahkan traceQL dengan visualisasi tabel**

1. Di dasbor yang sama tempat Anda menambahkan visualisasi jejak, pilih **Tambahkan panel** untuk menambahkan panel visualisasi baru.

1. Pilih sumber data jejak yang sama yang Anda gunakan di bagian sebelumnya.

1. **Di kanan atas editor panel, pilih tab **Visualisasi**, lalu pilih Tabel.**

1. Di editor kueri, pilih tab **TraceQL**.

1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda.

1. Tambahkan kueri TraceQL yang sesuai untuk mencari jejak yang ingin Anda visualisasikan di dasbor. Misalnya, berikut adalah kueri statis sederhana dari server yang disebut*my-server*.

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   Anda dapat menulis kueri TraceQL sebagai kueri template untuk memanfaatkan variabel dasbor lainnya, jika ada. Ini memungkinkan Anda membuat kueri dinamis berdasarkan variabel-variabel ini.

Ketika hasil dikembalikan dari kueri, hasilnya ditampilkan dalam tabel panel.

Hasil dalam visualisasi jejak mencakup tautan ke halaman **Jelajahi** yang membuat jejak. Anda dapat menambahkan tautan lain ke jejak di tabel yang mengisi variabel `traceId` dasbor saat dipilih, sehingga jejak divisualisasikan di dasbor yang sama.

Untuk membuat satu set link data di panel, gunakan prosedur berikut.

**Untuk menggunakan variabel untuk menambahkan tautan lain ke jejak**

1. Di menu sisi kanan, di bawah **Tautan data**, pilih **Tambahkan tautan**.

1. Tambahkan **Judul** untuk tautan data.

1. Temukan jalur ke dasbor dengan melihat di bilah alamat browser Anda saat dasbor lengkap sedang dirender. Karena ini adalah tautan ke dasbor di tumpukan Grafana yang sama, hanya jalur dasbor yang diperlukan.

   Misalnya, jika jalur Anda adalah:

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   Maka jalur ke dasbor adalah:

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. Di bidang **URL**, buat referensi mandiri ke dasbor yang berisi kedua panel. Referensi diri ini menggunakan nilai jejak yang dipilih dalam tabel untuk mengisi variabel dasbor. Gunakan jalur untuk dasbor dari langkah sebelumnya dan kemudian isi nilai `traceId` menggunakan hasil yang dipilih dari tabel TraceQL. ID jejak diekspos menggunakan bidang `traceID` data dalam hasil yang dikembalikan, jadi gunakan itu sebagai nilai untuk variabel dasbor. Contoh:

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. Pilih **Simpan** untuk menyimpan tautan data.

1. Pilih **Terapkan** dari editor panel untuk menerapkan panel ke dasbor.

1. Simpan dasbor.

Anda sekarang harus melihat daftar jejak yang cocok dalam visualisasi tabel. **Saat memilih bidang **traceID** **atau** SpanID akan memberi Anda opsi untuk membuka halaman Jelajahi untuk memvisualisasikan jejak atau mengikuti tautan data, memilih bidang lain (`Start time`seperti`Name`,, `Duration` atau) secara otomatis mengikuti tautan data, mengisi variabel dasbor, dan kemudian menunjukkan jejak yang relevan di `traceId` panel jejak.** 

# Tren
<a name="v10-panels-trend"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi tren harus digunakan untuk kumpulan data yang memiliki urutan, numerik X yang bukan waktu. Beberapa contoh adalah grafik fungsi, rpm/torque kurva, hubungan penawaran/permintaan, dan plot elevasi atau detak jantung di sepanjang jalur balapan (dengan x sebagai jarak atau durasi dari awal).

Visualisasi tren mendukung semua gaya visual dan opsi yang tersedia dalam [visualisasi deret waktu dengan pengecualian](v10-panels-time-series.md) berikut:
+ Tidak ada anotasi atau wilayah waktu
+ Tidak ada kursor bersama (atau crosshair)
+ Tidak ada sumbu x multi-zona waktu
+ Tidak ada kemampuan untuk mengubah rentang waktu dasbor melalui pemilihan seret

**X Pemilihan bidang**

Gunakan opsi ini untuk memilih bidang yang berisi peningkatan nilai numerik.

 Misalnya, Anda dapat mewakili tenaga mesin dan torsi versus kecepatan di mana kecepatan diplot pada sumbu x dan daya dan torsi diplot pada sumbu y.

# Grafik XY
<a name="v10-panels-xychart"></a>

Grafik XY menyediakan cara untuk memvisualisasikan nilai x dan y arbitrer dalam grafik sehingga Anda dapat dengan mudah menunjukkan hubungan antara dua variabel. Grafik XY biasanya digunakan untuk membuat plot pencar. Anda juga dapat menggunakannya untuk membuat bagan gelembung, di mana nilai bidang menentukan ukuran setiap gelembung.

![\[Gambar yang menunjukkan contoh visualisasi bagan XY di Grafana.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/viz/xy-chart-example.png)


## Format data yang didukung
<a name="v10-panels-xychart-formats"></a>

Anda dapat menggunakan semua jenis data tabular dengan setidaknya dua bidang numerik dalam bagan XY. Jenis visualisasi ini tidak memerlukan data waktu.

## Opsi panel
<a name="v10-panels-xychart-paneloptions"></a>

Di bagian **Opsi panel** panel panel editor, Anda mengatur opsi dasar seperti judul dan deskripsi panel. Anda juga dapat mengonfigurasi panel berulang di bagian ini. Untuk informasi selengkapnya, lihat [Konfigurasikan opsi panel](v10-panels-configure-panel-options.md).

## Opsi grafik XY
<a name="v10-panels-xychart-options"></a>

**Pemetaan seri**

Tetapkan bagaimana data seri dipetakan dalam bagan.
+ **Otomatis** - Secara otomatis menghasilkan seri dari semua frame data yang tersedia (atau dataset). Anda dapat memfilter untuk memilih hanya satu bingkai.
+ **Manual** — Secara eksplisit mendefinisikan seri dengan memilih dari frame data yang tersedia.

Bergantung pada pilihan pemetaan seri Anda, opsi **Frame**, **X-field**, dan **Y-field berbeda**. Bagian pemetaan seri Otomatis dan Manual menjelaskan opsi yang berbeda ini.

**Opsi pemetaan seri otomatis**

Saat Anda memilih **Otomatis** sebagai mode pemetaan seri Anda, opsi berikut sudah dikonfigurasi sebelumnya, tetapi Anda juga dapat mendefinisikannya sendiri.
+ **Frame** - Secara default bagan XY menampilkan semua frame data. Anda dapat memfilter untuk memilih hanya satu bingkai.
+ **X-field** - Pilih bidang mana yang diwakili X. Secara default, t nya adalah bidang angka pertama di setiap frame data.
+ **Y-field** — Setelah X-field diatur, secara default, semua bidang angka yang tersisa dalam frame data ditetapkan sebagai Y-field. Anda dapat menggunakan opsi ini untuk secara eksplisit memilih bidang mana yang akan digunakan untuk Y.

  Rangkaian bagan dihasilkan dari bidang-Y. Untuk membuat perubahan pada seri dalam bagan XY, lakukan penggantian ke bidang Y. Bidang apa pun yang Anda gunakan di bidang Ukuran atau bidang Warna tidak menghasilkan rangkaian.

  Anda juga dapat menggunakan penggantian untuk mengecualikan bidang-Y satu per satu. Untuk melakukannya, tambahkan penggantian dengan properti berikut untuk setiap bidang Y yang ingin dihapus:
  + Tipe ganti: **Bidang dengan nama**
  + Mengganti properti: **Seri> Sembunyikan di area**
  + Daerah: **Viz**

**Opsi pemetaan seri manual**

Ketika Anda memilih **Manual** sebagai mode seri Anda, Anda dapat menambahkan, mengedit, dan menghapus seri. Untuk mengelola seri, pilih bidang **Seri**. Untuk mengganti nama seri, pilih nama seri.

Dalam mode **Manual**, Anda harus mengatur opsi berikut:
+ **Frame** — Pilih frame data atau dataset Anda. Anda dapat menambahkan bingkai sebanyak yang Anda inginkan.
+ **X-field** - Pilih bidang mana yang diwakili X.
+ **Y-field** - Pilih bidang yang mewakili Y.

**Bidang ukuran**

Gunakan opsi ini untuk mengatur nilai bidang mana yang mengontrol ukuran titik dalam bagan. Nilai ini relatif terhadap min dan maks dari semua nilai dalam bingkai data.

Ketika Anda memilih opsi ini, Anda kemudian dapat mengatur opsi ukuran titik min dan maks.

**Bidang warna**

Gunakan opsi ini untuk mengatur nilai bidang mana yang mengontrol warna titik dalam bagan. Untuk menggunakan opsi nilai warna di bawah **opsi Standar**, Anda harus mengatur bidang ini.

Biasanya, opsi ini digunakan ketika Anda hanya memiliki satu seri yang ditampilkan di bagan.

**Tampilkan**

Tetapkan bagaimana nilai direpresentasikan dalam visualisasi.
+ **Poin** - Menampilkan nilai sebagai poin. Saat Anda memilih opsi ini, opsi ukuran titik juga ditampilkan.
+ **Garis** - Tambahkan garis di antara nilai. Saat Anda memilih opsi ini, gaya garis dan opsi lebar garis juga ditampilkan.
+ **Keduanya** - Menampilkan titik dan garis.

**Ukuran titik**

Mengatur ukuran semua titik dalam bagan, dari satu hingga 100 piksel dengan diameter. Ukuran default adalah lima piksel. Anda dapat mengatur penggantian untuk mengatur ukuran piksel berdasarkan seri (Y-field).

**Ukuran titik Min/Max**

Gunakan optinos ini untuk mengontrol ukuran titik minimum atau maksimum saat Anda telah mengatur opsi **bidang Ukuran**. Anda dapat mengganti opsi ini untuk seri tertentu.

**Gaya garis**

Atur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.
+ **Solid** - Menampilkan garis yang solid. Ini adalah pengaturan default.
+ **Dash** - Menampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar drop-down ditampilkan di mana Anda dapat memilih pengaturan panjang dan celah untuk garis garis. Secara default, panjang dan celah diatur ke`10, 10`.
+ **Dots** - Tampilkan garis putus-putus. Saat Anda memilih opsi ini, daftar drop-down ditampilkan di mana Anda dapat memilih spasi titik. Secara default, spasi titik diatur ke `0, 10` (angka pertama mewakili panjang titik, dan selalu nol).

**Lebar garis**

Mengatur lebar garis, dalam piksel.

## Opsi tooltip
<a name="v10-panels-xychart-tooltipoptions"></a>

Opsi tooltip mengontrol hamparan informasi yang muncul saat Anda mengarahkan kursor ke titik data dalam grafik.

**Mode Tooltip**
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

Gunakan override untuk menyembunyikan seri individual dari tooltip.

**Tinggi maks**

Atur ketinggian maksimum kotak tooltip. Defautl adalah 600 piksel.

## Opsi legenda
<a name="v10-panels-xychart-legendoptions"></a>

Opsi legenda mengontrol nama seri dan statistik yang muncul di bawah atau di sebelah kanan grafik. Untuk informasi lebih lanjut tentang legenda, lihat[Konfigurasikan legenda](v10-panels-configure-legend.md).

**Visibilitas**

Alihkan sakelar untuk mengaktifkan atau menonaktifkan legenda.

**Modus**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda.
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.

**Penempatan**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai-nilai**

Pilih [perhitungan standar](v10-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

**Lebar**

Kontrol seberapa lebar legenda ketika ditempatkan di sisi kanan visualisasi. Opsi ini hanya ditampilkan jika Anda mengatur penempatan legenda ke **Kanan**.

## Opsi sumbu
<a name="v10-panels-xychart-axis"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Opsi di bawah kategori sumbu mengubah cara sumbu x dan y dirender. Beberapa opsi tidak berlaku sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit. Anda juga dapat menekan`Enter`.

**Penempatan (sumbu y)**

Pilih penempatan sumbu Y. Opsinya adalah:
+ **Otomatis** - Secara otomatis menetapkan sumbu y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, Grafana menetapkan sumbu kiri ke unit pertama, dan sumbu kanan ke unit berikutnya.
+ **Kiri** - Tampilkan semua sumbu y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu y di sisi kanan.
+ **Tersembunyi** - Sembunyikan semua sumbu.

Untuk menyembunyikan sumbu secara selektif, [tambahkan penggantian bidang yang](v10-panels-configure-overrides.md) menargetkan bidang tertentu.

**Label**

Tetapkan label teks sumbu y. Jika Anda memiliki lebih dari satu sumbu y, maka Anda dapat menetapkan label yang berbeda menggunakan override.

**Lebar**

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Pengaturan ini memudahkan Anda untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau membentang dalam jarak visual satu sama lain.

**Tampilkan garis kisi**

Atur visibilitas garis kisi sumbu.
+ **Otomatis** - Secara otomatis menampilkan garis kisi berdasarkan kepadatan data.
+ **Aktif** — Selalu tampilkan garis kisi.
+ **Mati** - Jangan pernah menampilkan garis kisi.

**Warna**

Atur warna sumbu.
+ **Teks** - Mengatur warna berdasarkan warna teks tema.
+ **Seri** - Atur warna berdasarkan warna seri.

**Tampilkan perbatasan**

Atur visibilitas batas sumbu.

**Skala**

Atur bagaimana skala nilai sumbu y.
+ **Linear** — Membagi skala menjadi bagian yang sama.
+ **Logaritmik** — Gunakan skala logaritmik. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10).
+ **Symlog — Gunakan skala logaritmik** simetris. Ketika Anda memilih opsi ini, daftar muncul bagi Anda untuk memilih skala logaritmik biner (basis 2) atau umum (basis 10). Opsi ambang batas linier memungkinkan Anda untuk mengatur ambang batas di mana skala berubah dari linier ke logaritmik.

*Nol berpusat*

Mengatur sumbu y untuk dipusatkan pada nol.

**Soft min dan soft max**

Tetapkan opsi **Soft min** atau **soft max** untuk kontrol batas sumbu y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max dapat mencegah variasi kecil dalam data diperbesar saat sebagian besar datar. Sebaliknya, nilai min dan maks yang keras membantu mencegah mengaburkan detail yang berguna dalam data dengan memotong lonjakan intermiten melewati titik tertentu.

Untuk menentukan batas keras sumbu y, tetapkan min/max opsi standar. Untuk informasi selengkapnya, lihat [Konfigurasi opsi standar](v10-panels-configure-standard-options.md).

**Transformasi**

Gunakan opsi ini untuk mengubah nilai seri tanpa memengaruhi nilai yang ditampilkan di tooltip, menu konteks, atau legenda. Anda memiliki dua opsi transformasi:
+ **Transformasi Y negatif** — Balikkan hasil ke nilai negatif pada sumbu Y.
+ **Konstan** — Tunjukkan nilai pertama sebagai garis konstan.

**catatan**  
Opsi transformasi hanya tersedia sebagai penggantian.

**Tampilkan beberapa sumbu y**

Ada beberapa kasus di mana Anda ingin menampilkan beberapa sumbu y. Misalnya, jika Anda memiliki kumpulan data yang menunjukkan suhu dan kelembaban dari waktu ke waktu, Anda dapat menunjukkan dua sumbu y dengan unit berbeda untuk dua seri ini.

Untuk menampilkan beberapa sumbu y, [tambahkan penggantian bidang](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Ikuti langkah-langkah sebanyak yang diperlukan untuk menambahkan sumbu y sebanyak yang Anda butuhkan.

## Opsi standar
<a name="v10-panels-xychart-standard"></a>

**Opsi standar** di editor panel memungkinkan Anda mengubah cara data bidang ditampilkan dalam visualisasi Anda. Saat Anda menetapkan opsi standar, perubahan diterapkan ke semua bidang atau seri. Untuk kontrol yang lebih terperinci atas tampilan bidang, lihat. [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md)

Anda dapat menyesuaikan opsi standar berikut:
+ **Bidang min/maks** - Aktifkan **Bidang min/maks agar** Grafana menghitung min atau maks setiap bidang secara individual, berdasarkan nilai minimum atau maksimum bidang.
+ **Skema warna** - Mengatur satu atau beberapa warna untuk seluruh visualisasi Anda.

Untuk informasi selengkapnya, lihat [Konfigurasikan opsi standar](v10-panels-configure-standard-options.md).

## Tautan data
<a name="v10-panels-xychart-datalinks"></a>

Tautan data memungkinkan Anda menautkan ke panel, dasbor, dan sumber daya eksternal lainnya sambil mempertahankan konteks panel sumber. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilai di bawah kursor.

Untuk setiap tautan data, atur opsi berikut:
+ **Judul**
+ **URL**
+ **Buka di tab baru**

Untuk informasi selengkapnya, lihat [Konfigurasikan tautan data](v10-panels-configure-data-links.md).

## Penggantian lapangan
<a name="v10-panels-xychart-fieldoverrides"></a>

Override memungkinkan Anda untuk menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. Saat menambahkan aturan penggantian, Anda dapat menargetkan kumpulan bidang tertentu dan menentukan beberapa opsi untuk bagaimana bidang tersebut ditampilkan.

Pilih dari salah satu opsi penggantian berikut:
+ **Bidang dengan nama** - Pilih bidang dari daftar semua bidang yang tersedia.
+ **Bidang dengan nama yang cocok dengan regex** - Tentukan bidang yang akan diganti dengan ekspresi reguler.
+ **Bidang dengan tipe** - Pilih bidang berdasarkan jenis, seperti string, numerik, atau waktu.
+ **Bidang yang dikembalikan oleh kueri** - Pilih semua bidang yang dikembalikan oleh kueri tertentu.
+ **Bidang dengan nilai** - Pilih semua bidang yang dikembalikan oleh kondisi peredam yang ditentukan, seperti **Min**, **Maks**, **Hitungan**, atau **Total**.

Lihat informasi yang lebih lengkap di [Konfigurasikan penggantian bidang](v10-panels-configure-overrides.md).

# Jelajahi di Grafana versi 10
<a name="v10-explore"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

UI dasbor Grafana menyediakan fungsionalitas untuk membangun dasbor untuk visualisasi. *Jelajahi* strip dari opsi dasbor dan panel sehingga Anda dapat fokus pada kueri. Ini membantu Anda mengulangi sampai Anda memiliki kueri yang berfungsi dan kemudian Anda dapat membangun dasbor dari kueri.

**catatan**  
Jika Anda hanya ingin menjelajahi data Anda dan tidak ingin membuat dasbor, maka Jelajahi membuat ini jauh lebih mudah. Jika sumber data Anda mendukung data grafik dan tabel, Jelajahi menampilkan hasilnya baik sebagai grafik maupun tabel. Ini memungkinkan Anda untuk melihat tren dalam data dan detail lebih lanjut secara bersamaan.

Halaman ini akan membantu Anda mulai menjelajahi data Anda. Topik berikut memberi Anda detail lebih lanjut tentang fitur dan kegunaan spesifik untuk Jelajahi.
+ [Manajemen kueri di Jelajahi](v10-explore-manage.md)
+ [Log di Jelajahi](v10-explore-logs.md)
+ [Menelusuri Jelajahi](v10-explore-tracing.md)
+ [Editor korelasi di Jelajahi](v10-explore-correlations.md)
+ [Inspector di Explore](v10-explore-inspector.md)

## Mulai menjelajah
<a name="v10-explore-start"></a>

**catatan**  
Untuk mengakses Explore, Anda harus memiliki editor atau peran administrator.

**Untuk mengakses Jelajahi**

1. Di ruang kerja Grafana Anda, pilih item menu Jelajahi dari bilah menu sebelah kiri.

   Tab Jelajahi kosong terbuka.

   Sebagai alternatif, untuk memulai dengan kueri yang ada di panel, pilih opsi Jelajahi dari menu Panel. Ini membuka tab Jelajahi dengan kueri dari panel dan memungkinkan Anda untuk mengubah atau mengulangi kueri di luar dasbor Anda.

1. Pilih sumber data Anda dari dropdown di kiri atas.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (hanya untuk Admin).

1. Tulis kueri menggunakan editor kueri yang disediakan oleh sumber data yang dipilih.

   Untuk detail selengkapnya tentang kueri, lihat[Kueri dan transformasi data](v10-panels-query-xform.md).

1. Jalankan kueri menggunakan tombol di sudut kanan atas.

## Pisahkan dan bandingkan
<a name="v10-explore-compare"></a>

Tampilan terpisah menyediakan cara mudah untuk membandingkan visualisasi side-by-side atau melihat data terkait bersama-sama pada satu halaman.

**Buka bagian atas tampilan split**

1. Dalam tampilan Jelajahi, pilih tombol **Split** untuk menduplikasi kueri saat ini dan membagi halaman menjadi dua side-by-side kueri.
**catatan**  
Dimungkinkan untuk memilih sumber data lain untuk kueri baru yang, misalnya, memungkinkan Anda membandingkan kueri yang sama untuk dua server yang berbeda atau membandingkan lingkungan pementasan dengan lingkungan produksi.

   Dalam tampilan terpisah, pemilih waktu untuk kedua panel dapat ditautkan (jika Anda mengubah satu, yang lain juga akan diubah) dengan memilih tombol sinkronisasi waktu yang dilampirkan ke salah satu pemilih waktu. Menautkan pemetik waktu membuat waktu mulai dan akhir dari kueri tampilan terpisah tetap sinkron. Ini memastikan bahwa Anda melihat interval waktu yang sama di kedua panel terpisah.

1. Untuk menutup kueri yang baru dibuat, pilih tombol **Close Split**.

## Garis besar konten
<a name="v10-explore-outline"></a>

Garis besar konten adalah bilah navigasi samping yang melacak kueri dan visualisasi yang Anda buat di Jelajahi. Ini memungkinkan Anda untuk menavigasi di antara mereka dengan cepat.

Garis besar konten juga berfungsi dalam tampilan terpisah. Saat Anda berada dalam tampilan terpisah, garis besar konten dibuat untuk setiap panel.

**Untuk membuka garis besar konten**

1. Pilih tombol **Outline** di sudut kiri atas layar **Jelajahi**.

1. Pilih ikon panel apa pun di garis besar konten untuk menavigasi ke panel itu.

## Bagikan Jelajahi URLs
<a name="v10-explore-shareurl"></a>

Saat menggunakan Jelajahi, URL di bilah alamat browser diperbarui saat Anda membuat perubahan pada kueri. Anda dapat membagikan atau menandai URL ini.

**catatan**  
Jelajahi dapat menghasilkan relatif lama URLs. Anda juga dapat membuat dan membagikan [tautan singkat](#v10-explore-share) jika URL terlalu panjang untuk alat Anda.

**Menghasilkan Jelajahi URLs dari alat eksternal**

Karena Jelajahi URLs memiliki struktur yang ditentukan, Anda dapat membuat URL dari alat eksternal dan membukanya di Grafana. Struktur url adalah:

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

di mana:
+ `org_id`adalah ID organisasi
+ `schema_version`adalah versi skema (harus disetel ke versi terbaru, yaitu`1`.
+ `panes`adalah objek panel JSON yang dikodekan url, di mana setiap kunci adalah ID panel dan setiap nilai adalah objek yang cocok dengan skema berikut:

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**catatan**  
`to`Bidang `from` dan juga menerima rentang relatif seperti yang dijelaskan dalam [Pengaturan rentang waktu dasbor](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) topik.

## Bagikan tautan singkat
<a name="v10-explore-share"></a>

Kemampuan Share shortened link memungkinkan Anda membuat format /goto/:uid yang lebih kecil dan lebih sederhana URLs daripada menggunakan lebih lama dengan parameter kueri. URLs Untuk membuat tautan singkat ke hasil kueri, pilih opsi **Bagikan** di bilah alat Jelajahi. Tautan singkat yang tidak pernah digunakan akan otomatis dihapus setelah tujuh (7) hari. Jika tautan digunakan setidaknya sekali, itu tidak akan dihapus.

**Berbagi tautan singkat dengan waktu absolut**

Tautan pendek memiliki dua opsi: menjaga waktu relatif (misalnya, dari dua jam yang lalu ke waktu saat ini) atau waktu absolut (misalnya, dari jam 8 pagi hingga 10 pagi). Berbagi tautan singkat secara default akan menyalin rentang waktu yang dipilih, relatif atau absolut. Memilih tombol tarik-turun di sebelah tombol bagikan tautan pendek dan memilih salah satu opsi di bawah **Tautan URL Sinkronisasi Waktu akan memungkinkan Anda membuat tautan** pendek dengan waktu absolut, yang berarti siapa pun yang menerima tautan akan melihat data yang sama yang Anda lihat, bahkan jika mereka membuka tautan di lain waktu. Opsi ini tidak akan memengaruhi rentang waktu yang dipilih dalam tampilan Jelajahi Anda.

# Manajemen kueri di Jelajahi
<a name="v10-explore-manage"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat mengelola kueri yang telah Anda buat di Jelajahi, termasuk riwayat kueri yang telah Anda jalankan, dan kueri yang telah Anda bintangi.

## Riwayat kueri
<a name="v10-explore-manage-history"></a>

Riwayat kueri adalah daftar kueri yang Anda gunakan di Jelajahi. Riwayat disimpan dalam database Grafana dan tidak dibagikan dengan pengguna lain. Periode retensi untuk kueri dalam sejarah adalah dua minggu. Kueri yang berusia lebih dari dua minggu akan dihapus secara otomatis. Untuk membuka dan berinteraksi dengan riwayat Anda, pilih tombol **Riwayat kueri** di Jelajahi.

**catatan**  
Kueri berbintang (favorit) tidak tunduk pada periode retensi dua minggu dan tidak dihapus.

## Lihat riwayat kueri
<a name="v10-explore-manage-history-view"></a>

Riwayat kueri memungkinkan Anda melihat riwayat kueri Anda. Untuk setiap kueri individu, Anda dapat:
+ Jalankan kueri.
+ Buat and/or edit komentar.
+ Salin kueri ke clipboard.
+ Salin tautan singkat dengan kueri ke clipboard.
+ Bintang (favorit) kueri.

## Kelola kueri favorit
<a name="v10-explore-manage-history-favorites"></a>

Semua kueri yang telah dibintangi di tab Riwayat kueri ditampilkan di tab Berbintang. Ini memungkinkan Anda untuk mengakses kueri favorit Anda lebih cepat dan menggunakan kembali kueri ini tanpa mengetiknya dari awal.

## Menyortir riwayat kueri
<a name="v10-explore-manage-history-sort"></a>

Secara default, riwayat kueri menunjukkan kueri terbaru kepada Anda. Anda dapat mengurutkan riwayat Anda berdasarkan tanggal atau dengan nama sumber data dalam urutan naik atau turun.

**Untuk mengurutkan riwayat kueri Anda**

1. Pilih kolom **Urutkan kueri menurut**.

1. Pilih salah satu opsi berikut:
   + **Terbaru pertama**
   + **Tertua pertama**

## Memfilter riwayat kueri
<a name="v10-explore-manage-history-filter"></a>

Anda dapat memfilter riwayat kueri Anda di Riwayat kueri dan tab Berbintang ke sumber data tertentu.

**Untuk memfilter riwayat ke sumber data**

1. Pilih bidang **Filter kueri untuk sumber data tertentu**.

1. Pilih sumber data yang ingin Anda filter histori Anda. Anda dapat memilih beberapa sumber data.

**catatan**  
Kueri yang dijalankan menggunakan sumber data Campuran hanya akan muncul saat memfilter untuk Campuran, dan bukan saat memfilter berdasarkan sumber data masing-masing.

Di tab **Query history**, Anda juga dapat memfilter kueri berdasarkan tanggal menggunakan slider:
+ Gunakan slider vertikal untuk memfilter kueri berdasarkan tanggal.
+ Sesuaikan tanggal mulai dengan menyeret pegangan bawah.
+ Sesuaikan tanggal akhir dengan menyeret pegangan atas.

## Mencari dalam riwayat kueri
<a name="v10-explore-manage-history-search"></a>

Anda dapat mencari di riwayat Anda di seluruh kueri dan komentar Anda. Pencarian dimungkinkan untuk kueri di tab Query history dan tab Starred.

**Untuk mencari di riwayat kueri**

1. Pilih bidang **Permintaan pencarian**.

1. Masukkan istilah yang Anda cari ke dalam bidang pencarian.

## Pengaturan riwayat kueri
<a name="v10-explore-manage-history-settings"></a>

Anda dapat menyesuaikan riwayat kueri di tab Pengaturan. Opsi dijelaskan dalam tabel berikut.


| Pengaturan | Nilai default | 
| --- | --- | 
| Ubah tab aktif default | Tab riwayat kueri | 

**catatan**  
Pengaturan riwayat kueri bersifat global, dan diterapkan ke kedua panel dalam mode terpisah.

# Log di Jelajahi
<a name="v10-explore-logs"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Jelajahi memungkinkan Anda untuk menyelidiki log Anda di sumber data yang berbeda, termasuk:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Selama pemantauan infrastruktur dan respons insiden, Anda dapat menggali lebih dalam metrik dan log untuk menemukan penyebabnya. Jelajahi juga memungkinkan Anda untuk mengkorelasikan log dengan sinyal telemetri lain seperti metrik, jejak, atau profil, dengan melihatnya. side-by-side

Hasil kueri log ditampilkan sebagai garis log individual dan sebagai grafik yang menunjukkan volume log untuk periode waktu yang dipilih.

## Volume log
<a name="v10-explore-logs-volume"></a>

Saat bekerja dengan sumber data yang mendukung volume log rentang penuh, Jelajahi secara otomatis menampilkan grafik yang menunjukkan distribusi log untuk semua kueri log yang dimasukkan. Fitur ini saat ini didukung oleh OpenSearch dan sumber data Loki.

**catatan**  
Di Loki, volume log rentang penuh ini dirender oleh kueri metrik yang bisa mahal tergantung pada rentang waktu yang ditanyakan. Kueri ini bisa sangat menantang untuk diproses untuk instalasi Loki yang lebih kecil. Untuk mengurangi ini, Anda dapat menggunakan proxy seperti [nginx](https://www.nginx.com/) di depan Loki untuk mengatur batas waktu khusus (misalnya, 10 detik) untuk kueri ini. Kueri histogram volume log dapat diidentifikasi dengan mencari kueri dengan header HTTP `X-Query-Tags` dengan nilai`Source=logvolhist`; header ini ditambahkan oleh Grafana ke semua kueri histogram volume log.

Jika sumber data tidak mendukung pemuatan volume log rentang penuh, model log menghitung deret waktu dengan menghitung baris log dan mengaturnya ke dalam ember berdasarkan interval waktu yang dihitung secara otomatis. Stempel waktu dari baris log pertama digunakan untuk menambatkan awal volume log dalam hasil. **Akhir dari deret waktu berlabuh ke rentang To picker waktu.** Dengan cara ini, Anda masih dapat menganalisis dan memvisualisasikan data log secara efisien bahkan ketika sumber data tidak menawarkan dukungan jangkauan penuh.

## Beberapa catatan
<a name="v10-explore-logs-overview"></a>

Di bagian berikut, Anda akan menemukan penjelasan terperinci tentang cara memvisualisasikan dan berinteraksi dengan log individu di Jelajahi.

## Navigasi log
<a name="v10-explore-logs-navigation"></a>

Navigasi log, di sisi kanan baris log, dapat digunakan untuk dengan mudah meminta log tambahan. Anda dapat melakukan ini dengan mengklik tombol **Log lama** di bagian bawah navigasi. Ini sangat berguna ketika Anda mencapai batas garis dan Anda ingin melihat lebih banyak log. Setiap permintaan yang dijalankan dari navigasi kemudian ditampilkan dalam navigasi sebagai halaman terpisah. Setiap halaman menampilkan `from` dan `to` stempel waktu dari baris log masuk. Anda dapat melihat hasil sebelumnya dengan mengklik setiap halaman. Jelajahi cache lima permintaan terakhir yang dijalankan dari navigasi log, sehingga Anda tidak menjalankan kembali kueri yang sama saat mengklik halaman, menghemat waktu dan sumber daya.

## Opsi visualisasi
<a name="v10-explore-log-visualization-options"></a>

 Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan. 


| Opsi | Deskripsi | 
| --- | --- | 
| Waktu | Menampilkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data. | 
| Label unik | Menampilkan atau menyembunyikan kolom label unik yang hanya menyertakan label yang tidak umum. Semua label umum ditampilkan di atas. | 
| Bungkus garis | Setel ini ke true jika Anda ingin tampilan menggunakan pembungkus garis. Jika diatur kefalse, itu akan menghasilkan pengguliran horizontal. | 
| Mempercantik JSON |  Setel ini true untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON. | 
| Deduplikasi | Data log bisa sangat berulang dan Explore dapat membantu dengan menyembunyikan baris log duplikat. Ada beberapa algoritma deduplikasi berbeda yang dapat Anda gunakan. Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal. Pencocokan angka dilakukan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya. Tanda tangan adalah deduplikasi yang paling agresif karena menghapus semua huruf dan angka dan kecocokan pada spasi putih dan tanda baca yang tersisa. | 
| Menampilkan urutan hasil | Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama). | 

## Unduh baris log
<a name="v10-explore-download-log-lines"></a>

Untuk mengunduh hasil log dalam salah satu `txt` atau `json` format, gunakan tombol **Unduh**. Fitur ini memungkinkan Anda menyimpan data log untuk analisis lebih lanjut atau membagikannya dengan orang lain dalam format yang nyaman dan dapat diakses.

## Informasi meta hasil log
<a name="v10-explore-log-result-meta-information"></a>

Di atas baris log yang diterima, Anda dapat menemukan informasi meta penting, termasuk:
+ **Jumlah log yang diterima** - Menunjukkan jumlah total log yang diterima untuk kueri atau rentang waktu saat ini.
+ **Kesalahan** - Menampilkan kemungkinan kesalahan dalam hasil log Anda.
+ **Label umum** - Menampilkan label umum.
+ **Total byte diproses** - Merupakan ukuran kumulatif data log yang diproses dalam byte.

**catatan**  
Ketersediaan informasi meta tertentu mungkin tergantung pada sumber data, dan sebagai hasilnya, Anda hanya dapat melihat beberapa detail ini untuk sumber data tertentu.

## Melarikan diri dari baris baru
<a name="v10-explore-log-escaping-newlines"></a>

Jelajahi secara otomatis mendeteksi beberapa urutan lolos yang salah di baris log, seperti baris baru (`\n`,`\r`) atau tab (). `\t` Saat mendeteksi urutan seperti itu, Explore menyediakan opsi **Escape baris baru**.

**Untuk secara otomatis memperbaiki urutan lolos yang salah yang terdeteksi oleh Explore**

1. Pilih **Escape baris baru** untuk mengganti urutan.

1. Tinjau penggantian secara manual untuk mengkonfirmasi kebenarannya.

Jelajahi menggantikan urutan ini. Ketika melakukannya, opsi akan berubah dari **baris baru Escape** menjadi **Remove escaping**. Evaluasi perubahan karena parsing mungkin tidak akurat berdasarkan input yang diterima. Anda dapat mengembalikan penggantian dengan memilih **Hapus** escaping.

## Tingkat log
<a name="v10-explore-log-level"></a>

Untuk log di mana `level` label ditentukan, kami menggunakan nilai label ini untuk menentukan tingkat log dan memperbarui warna setiap baris log yang sesuai. Jika log tidak memiliki label level tertentu, kami mencoba mencari tahu apakah isinya cocok dengan ekspresi yang didukung (lihat tabel berikut untuk informasi selengkapnya). Level log selalu ditentukan oleh pertandingan pertama. Dalam kasus di mana Grafana tidak dapat menyimpulkan bidang level log, itu akan divisualisasikan dengan level log yang tidak diketahui.

**catatan**  
Jika Anda menggunakan sumber data Loki dan `level` merupakan bagian dari baris log Anda, Anda dapat menggunakan parser (JSON, logfmt, regex,..) untuk mengekstrak informasi level ke dalam label level yang digunakan untuk menentukan nilai level. Ini akan memungkinkan histogram untuk menunjukkan berbagai level log sebagai bilah terpisah.

**Tingkat log yang didukung dan pemetaan singkatan dan ekspresi tingkat log:** 


| Tingkat log | Warna | Ekspresi yang didukung | 
| --- | --- | --- | 
| kritis | ungu | muncul, fatal, waspada, kritik, kritis | 
| kesalahan | merah | err, eror, kesalahan | 
| memperingati | kuning | memperingatkan, memperingatkan | 
| info | hijau | info, informasi, informasi, pemberitahuan | 
| debug | biru | dbug, debug | 
| jejak | biru muda | jejak | 
| tidak diketahui | abu-abu | \$1 | 

## Sorot kata-kata yang dicari
<a name="v10-explore-highlight-searched-words"></a>

Saat kueri Anda menyertakan kata atau ekspresi tertentu untuk dicari, Explore akan menyorotnya di baris log untuk visibilitas yang lebih baik. Fitur penyorotan ini memudahkan untuk mengidentifikasi dan fokus pada konten yang relevan di log Anda.

**catatan**  
Kemampuan untuk menyorot kata pencarian dapat bervariasi tergantung pada sumber data. Untuk beberapa sumber data, penyorotan kata pencarian mungkin tidak tersedia.

## Tampilan detail log
<a name="v10-explore-log-details-view"></a>

Di Explore, setiap baris log memiliki bagian yang dapat diperluas yang disebut *Detail log* yang dapat dibuka dengan memilih baris log. Tampilan detail Log menyediakan informasi tambahan dan opsi eksplorasi dalam bentuk *Bidang* dan *Tautan* yang dilampirkan pada baris log, memungkinkan interaksi dan analisis yang lebih kuat.

**Bidang**

Dalam tampilan Detail log, Anda dapat memfilter bidang yang ditampilkan dengan dua cara: filter positif (untuk fokus pada bidang tertentu) dan filter negatif (untuk mengecualikan bidang tertentu). Filter ini akan memperbarui kueri terkait yang menghasilkan baris log, menambahkan ekspresi kesetaraan dan ketidaksetaraan yang sesuai. Jika sumber data memiliki dukungan, seperti halnya untuk Loki dan OpenSearch, detail log akan memeriksa apakah bidang sudah ada dalam tampilan kueri saat ini dan status aktif (hanya untuk filter positif), memungkinkan Anda untuk mengaktifkannya dari kueri, atau mengubah ekspresi filter dari positif ke negatif.

Anda dapat memilih subset bidang untuk divisualisasikan dalam daftar log alih-alih baris log lengkap dengan mengklik ikon mata. Setiap bidang memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Tautan**

Grafana menawarkan fungsionalitas tautan data atau korelasi, memungkinkan Anda mengonversi bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan ini dapat digunakan untuk menavigasi ke data terkait atau sumber daya eksternal, menyediakan cara yang mulus dan nyaman untuk mengeksplorasi informasi lebih lanjut.

## Konteks log
<a name="v10-explore-log-context"></a>

Konteks log menampilkan baris konteks tambahan di sekitar entri log yang cocok dengan kueri penelusuran tertentu. Ini dapat membantu dalam memahami konteks entri log, dan mirip dengan `-C` parameter dalam `grep` perintah.

Anda mungkin menemukan baris panjang teks yang membuatnya sulit untuk membaca dan menganalisis konteks di sekitar setiap entri log. Di sinilah sakelar **garis Bungkus** bisa berguna. Dengan mengaktifkan sakelar ini, Grafana akan secara otomatis membungkus baris teks yang panjang sehingga sesuai dengan lebar penampil yang terlihat. Ini dapat membuatnya lebih mudah untuk membaca dan memahami entri log. 

 Tombol **Buka dalam tampilan terpisah** memungkinkan Anda menjalankan kueri konteks untuk entri log di layar terpisah di tampilan Jelajahi. Memilih tombol ini akan membuka panel Jelajahi baru dengan kueri konteks yang ditampilkan di samping entri log, sehingga lebih mudah untuk menganalisis dan memahami konteks sekitarnya.

Kueri konteks log juga dapat dibuka di tab browser baru dengan menekan tombol `Ctrl` (or`Cmd`) sambil memilih tombol untuk membuka modal konteks. Saat dibuka di tab baru, filter yang dipilih sebelumnya juga diterapkan.

## Salin baris log
<a name="v10-explore-copy-log-line"></a>

Anda dapat dengan mudah menyalin konten baris log yang dipilih ke clipboard Anda dengan memilih tombol **Salin baris log**.

## Salin tautan ke baris log
<a name="v10-explore-copy-link-to-log-line"></a>

Menautkan baris log di Grafana memungkinkan Anda menavigasi dengan cepat ke entri log tertentu untuk analisis yang tepat. Dengan memilih tombol **Salin shortlink** untuk baris log, Anda dapat membuat dan menyalin URL pendek yang menyediakan akses langsung ke entri log yang tepat dalam rentang waktu absolut. Saat Anda membuka tautan, Grafana akan secara otomatis menggulir ke baris log yang sesuai dan menyorotnya dengan latar belakang biru, sehingga mudah untuk mengidentifikasi dan fokus pada informasi yang relevan.

**catatan**  
Ini hanya didukung di Loki dan sumber data lain yang menyediakan `id` bidang.

## Ekor langsung
<a name="v10-explore-log-live-tailing"></a>

Untuk melihat log real-time dari sumber data yang didukung, Anda dapat memanfaatkan fitur Live tailing di Jelajahi.

**Untuk melihat log secara real-time dengan live tailing**

1. Pilih tombol **Live** di toolbar Jelajahi untuk beralih ke tampilan Live tail.

1. Sementara dalam tampilan ekor langsung, log baru akan muncul dari bagian bawah layar, dan mereka akan memiliki latar belakang kontras yang memudar, memungkinkan Anda untuk dengan mudah melacak apa yang baru.

1. Jika Anda ingin menjeda tailing Langsung dan menjelajahi log sebelumnya tanpa gangguan, Anda dapat melakukannya dengan memilih tombol **Jeda** atau cukup menggulir tampilan log.

1. Untuk menghapus tampilan dan menghapus semua log dari tampilan, pilih tombol **Hapus log**. Tindakan ini akan mengatur ulang tampilan log dan memberi Anda batu tulis yang bersih untuk melanjutkan analisis log Anda.

1. Untuk melanjutkan Live tailing dan terus melihat log waktu nyata, pilih tombol **Lanjutkan**.

1. Jika Anda ingin keluar dari Live tailing dan kembali ke tampilan Jelajahi standar, pilih tombol **Stop**.

Dengan menggunakan fitur Live tailing, Anda dapat mengawasi log terbaru saat masuk, membuatnya lebih mudah untuk memantau peristiwa waktu nyata dan mendeteksi masalah dengan segera.

**Log sampel**

Jika sumber data yang dipilih mengimplementasikan sampel log, dan mendukung kueri log dan metrik, maka untuk kueri metrik Anda akan dapat secara otomatis melihat sampel baris log yang berkontribusi pada metrik yang divisualisasikan. Fitur ini saat ini didukung oleh sumber data Loki.

**Beralih dari metrik ke log**

 Jika Anda berasal dari sumber data metrik yang mengimplementasikan `DataSourceWithQueryExportSupport` (seperti Prometheus) ke sumber data logging yang mendukung `DataSourceWithQueryImportSupport` (seperti Loki), maka itu akan menyimpan label dari kueri Anda yang ada di log dan menggunakannya untuk menanyakan aliran log.

Misalnya, `grafana_alerting_active_alerts{job='grafana'}` kueri Prometheus berikut setelah beralih ke sumber data Loki, akan berubah menjadi. `{job='grafana'}` Ini akan mengembalikan potongan log dalam rentang waktu yang dipilih yang dapat grepped/text dicari.

# Menelusuri Jelajahi
<a name="v10-explore-tracing"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menggunakan Jelajahi untuk memvisualisasikan jejak dari melacak sumber data.

Sumber data berikut didukung.
+ [Tempo](tempo-data-source.md) (format konsumsi yang didukung:, Jaeger OpenTelemetry, dan Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Untuk informasi tentang cara mengonfigurasi kueri untuk sumber data yang tercantum di atas, lihat dokumentasi untuk sumber data tertentu.

## Editor kueri
<a name="v10-explore-trace-queryeditor"></a>

Anda dapat menanyakan dan mencari data penelusuran menggunakan editor kueri sumber data.

Setiap sumber data dapat memiliki editor kueri sendiri. Editor kueri untuk sumber data Tempo sedikit berbeda dari editor kueri untuk sumber data Jaeger.

Untuk informasi tentang kueri setiap sumber data, lihat dokumentasinya.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Penjelasan Trace View
<a name="v10-explore-trace-view"></a>

Bagian ini menjelaskan elemen dasbor Trace View.

**Header**

Header tampilan jejak memiliki elemen-elemen berikut:
+ Judul header - Menunjukkan nama rentang root dan ID jejak.
+ Pencarian — Sorotan mencakup teks yang dicari.
+ Metadata — Berbagai metadata tentang jejak.

**Minimap**

Menampilkan tampilan kental atau garis waktu jejak. Seret penunjuk Anda ke peta minimum untuk memperbesar rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Melayang di atas minimap, saat diperbesar, akan menampilkan tombol **Reset Selection yang mengatur ulang** zoom.

**Filter rentang**

Menggunakan filter rentang, Anda dapat memfilter rentang Anda di penampil garis waktu jejak. Semakin banyak filter yang Anda tambahkan, semakin spesifik rentang yang difilter.

Anda dapat menambahkan satu atau beberapa filter berikut:
+ Nama layanan sumber daya
+ Nama rentang
+ Durasi
+ Tag (yang mencakup tag, tag proses, dan bidang log)

Untuk hanya menampilkan rentang yang telah Anda cocokkan, pilih sakelar **Tampilkan kecocokan saja**.

**Garis Waktu**

Menampilkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen ini:
+ Perluas tombol anak — Memperluas atau menciutkan semua rentang anak dari rentang yang dipilih.
+ Nama layanan — Nama layanan yang mencatat rentang.
+ Nama operasi — Nama operasi yang diwakili oleh rentang ini.
+ Bilah durasi rentang — Representasi visual dari durasi operasi dalam jejak.

**Rincian rentang**

Memilih baris rentang menunjukkan detail rentang, termasuk yang berikut ini.
+ Nama operasi
+ Metadata rentang
+ Tag — Tag apa pun yang terkait dengan rentang ini.
+ Metadata proses — Metadata tentang proses yang mencatat rentang ini.
+ Log — Daftar log yang dicatat oleh rentang ini dan nilai kunci terkait. Dalam kasus Zipkin log bagian menunjukkan anotasi Zipkin.

**Lacak ke log**

Anda dapat menavigasi dari rentang dalam tampilan jejak langsung ke log yang relevan untuk rentang tersebut. Ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk petunjuk tentang cara mengkonfigurasi setiap sumber data.

Pilih ikon dokumen untuk membuka tampilan terpisah di Jelajahi dengan sumber data yang dikonfigurasi dan kueri log yang relevan untuk rentang tersebut.

**Lacak ke metrik**

**catatan**  
Fitur ini saat ini dalam versi beta

Anda dapat menavigasi formulir rentang dalam tampilan jejak langsung ke metrik yang relevan untuk rentang tersebut. Fitur ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk detail tentang konfigurasi.

**Lacak ke profil**

Menggunakan Trace to profiles, Anda dapat menggunakan kemampuan Grafana untuk mengkorelasikan sinyal yang berbeda dengan menambahkan fungsionalitas untuk menghubungkan antara jejak dan profil.

## Grafik simpul
<a name="v10-explore-trace-node-graph"></a>

Anda secara opsional dapat memperluas grafik simpul untuk jejak yang ditampilkan. Bergantung pada sumber data, ini dapat menunjukkan rentang jejak sebagai node dalam grafik, atau menambahkan beberapa konteks tambahan, termasuk grafik layanan berdasarkan jejak saat ini.

## Tampilan Grafik Layanan
<a name="v10-explore-trace-graph"></a>

Tampilan Grafik Layanan memvisualisasikan metrik rentang (melacak data untuk tarif, tingkat kesalahan, dan durasi (RED)) dan grafik layanan. Setelah persyaratan disiapkan, tampilan pra-konfigurasi ini segera tersedia.

Untuk informasi selengkapnya, lihat halaman sumber data [Tempo](tempo-data-source.md). Anda juga dapat melihat [halaman tampilan grafik layanan di dokumentasi](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) *Grafana Labs Tempo*.

## Data API
<a name="v10-explore-trace-dataapi"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Sumber data perlu mengembalikan data frame dan set`frame.meta.preferredVisualisationType = 'trace'`.

**Struktur bingkai data**

Bidang yang diperlukan;


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| TraceID | string | Pengidentifikasi untuk seluruh jejak. Seharusnya hanya ada satu jejak dalam bingkai data. | 
| SpanID | string | Pengidentifikasi untuk rentang saat ini. Rentang IDs harus unik per jejak. | 
| Orang tuaSpanid | string | spanId dari rentang induk untuk membuat hubungan induk anak dalam tampilan jejak. Bisa undefined untuk rentang root tanpa induk. | 
| serviceName | string | Nama layanan rentang ini adalah bagian dari. | 
| ServiceTags | TraceKeyValuePair[] | Daftar tag yang relevan untuk layanan ini. | 
| startTime | number | Waktu mulai rentang dalam waktu epoch milidetik. | 
| durasi | number | Durasi rentang dalam milidetik. | 

 Bidang opsional: 


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
| log | TraceLog[] | Daftar log yang terkait dengan rentang saat ini. | 
| tag | TraceKeyValuePair[] | Daftar tag yang terkait dengan rentang saat ini. | 
| peringatan | tali [] | Daftar peringatan yang terkait dengan rentang saat ini. | 
| StackTraces | tali [] | Daftar jejak tumpukan yang terkait dengan rentang saat ini. | 
| errorIconColor | string | Warna ikon kesalahan dalam rentang kasus ditandai denganerror: true. | 

Untuk detail tentang jenis lihat [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)dan [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)seterusnya GitHub.

# Editor korelasi di Jelajahi
<a name="v10-explore-correlations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Korelasi memungkinkan pengguna untuk membangun hubungan antara dua sumber data. Untuk informasi lebih lanjut, termasuk ikhtisar korelasi, lihat[Korelasi dalam Grafana versi 10](v10-correlations.md).

## Menciptakan korelasi
<a name="v10-explore-corr-create-a-correlation"></a>

Anda dapat membuat korelasi dari halaman Jelajahi.

**Untuk membuat korelasi**

1. Di ruang kerja Grafana Terkelola Amazon Anda, navigasikan ke halaman Jelajahi.

1. Pilih sumber data yang Anda inginkan untuk menjadi sumber untuk korelasi baru.

1. Jalankan kueri yang menghasilkan data dalam visualisasi yang didukung.
**catatan**  
[Visualisasi yang didukung adalah [Log](v10-panels-logs.md) dan Tabel.](v10-panels-table.md)

1. [Pilih **\$1 Tambahkan** di bilah alat atas dan pilih **Tambahkan korelasi** (Anda juga dapat memilih **Editor Korelasi** dari Palet Perintah.](v10-search.md#v10-search-palette)

   Jelajahi sekarang dalam mode Editor Korelasi yang ditunjukkan oleh batas biru dan bilah atas. Anda dapat keluar dari Editor Korelasi dengan memilih **Keluar** di bilah atas.

1. Sekarang Anda dapat membuat korelasi baru berikut untuk visualisasi dengan tautan yang dilampirkan ke data yang dapat Anda gunakan untuk membuat kueri baru:
   + *Log* - tautan ditampilkan di sebelah nilai bidang di dalam detail log untuk setiap baris log.
   + *Tabel* — setiap sel tabel adalah tautan.

1. Pilih tautan untuk menambahkan korelasi baru. Tautan dikaitkan dengan bidang yang digunakan sebagai bidang hasil korelasi. Untuk detail selengkapnya, lihat [Konfigurasi korelasi](v10-correlations-config.md).

1. Dalam tampilan terpisah yang terbuka, gunakan panel kanan untuk mengatur sumber kueri target korelasi. Untuk detail selengkapnya, lihat [Kueri target](v10-correlations-config.md#v10-correlations-config-target-query).

1. Buat kueri target menggunakan [sintaks variabel](v10-dash-variable-syntax.md) dengan variabel dari daftar yang disediakan di bagian atas panel. Daftar ini berisi nilai sampel dari baris data yang dipilih.

1. Berikan label dan deskripsi (opsional). Label akan digunakan sebagai nama tautan di dalam visualisasi dan dapat berisi variabel.

1. Berikan transformasi (opsional; lihat di bawah untuk detailnya).

1. Pilih **Simpan** di bilah alat atas untuk menyimpan korelasi dan keluar dari mode Editor Korelasi. Tautan yang digunakan untuk membuat korelasi diganti dengan tautan data di setiap baris. Saat tautan dipilih, kueri yang Anda tentukan akan berjalan di panel lain, dengan variabel diganti secara dinamis dengan nilai dari baris yang dipilih.

## Transformasi
<a name="v10-explore-corr-transformations"></a>

Transformasi memungkinkan Anda mengekstrak nilai yang ada di bidang dengan data lain. Misalnya, menggunakan transformasi, Anda dapat mengekstrak satu bagian dari baris log untuk digunakan dalam korelasi. Untuk detail lebih lanjut tentang transformasi dalam korelasi, lihat. [Transformasi Korelasi](v10-correlations-config.md#v10-correlations-config-transformations)

Setelah memilih salah satu tautan yang dihasilkan dalam mode editor, Anda dapat menambahkan transformasi dengan memilih **Tambahkan transformasi** di menu tarik-turun **Transformasi**.

**Untuk menggunakan transformasi dalam korelasi**

1. Pilih bidang untuk menerapkan transformasi. Pilih bagian bidang yang ingin Anda gunakan untuk transformasi. Misalnya, baris log. Setelah dipilih, nilai bidang ini akan digunakan untuk membantu Anda dalam membangun transformasi.

1. Pilih jenis transformasi. Lihat [Transformasi Korelasi](v10-correlations-config.md#v10-correlations-config-transformations) opsi dan pengaturan yang relevan. 

1. Berdasarkan pilihan Anda, Anda mungkin melihat satu atau lebih variabel terisi, atau Anda mungkin perlu memberikan lebih banyak spesifikasi dalam opsi yang ditampilkan.

1. Pilih **Tambahkan transformasi ke korelasi** untuk menambahkan variabel yang ditentukan ke daftar variabel yang tersedia.

**catatan**  
Untuk ekspresi reguler dalam kotak dialog ini, yang `mapValue` dimaksud dalam dokumentasi lain disebut `Variable Name` di sini. Grafana menyoroti teks apa pun yang cocok dengan ekspresi dalam nilai bidang. Gunakan grup pengambilan ekspresi reguler untuk memilih bagian mana dari kecocokan yang harus diekstraksi. Ketika ekspresi reguler yang valid disediakan, variabel dan nilai variabel tersebut muncul di bawah `Variable Name` bidang.

## Contoh korelasi
<a name="v10-explore-corr-examples"></a>

Contoh berikut menunjukkan cara membuat korelasi menggunakan Editor Korelasi di Jelajahi. Jika Anda ingin mengikuti contoh ini, pastikan untuk menyiapkan [sumber data pengujian](testdata-data-source.md).

### Membuat korelasi teks ke grafik
<a name="v10-explore-corr-text-to-graph"></a>

Contoh ini menunjukkan cara membuat korelasi menggunakan Editor Korelasi di Jelajahi.

Korelasi memungkinkan Anda menggunakan hasil dari satu kueri untuk menjalankan kueri baru di sumber data apa pun. Dalam contoh ini, Anda akan menjalankan kueri yang membuat data tabular. Data akan digunakan untuk menjalankan kueri berbeda yang menghasilkan hasil grafik.

Untuk mengikuti contoh ini, pastikan Anda telah menyiapkan [sumber data uji](testdata-data-source.md).

**Untuk membuat korelasi teks ke grafik**

1. **Di Grafana, navigasikan ke Jelajahi.**

1. Pilih **sumber data uji** dari menu tarik-turun di kiri atas halaman.

1. Pilih **\$1 Tambahkan** di menu tarik-turun ke kanan dan pilih **Tambahkan** korelasi.

1. Jelajahi sekarang dalam mode Editor Korelasi, ditunjukkan dengan batas biru.

1. Pilih skenario berikut dari menu tarik-turun skenario: File **CSV**.

1. Pilih file, **population\$1by\$1state.csv**. Setiap sel adalah tautan yang dapat Anda klik untuk mulai membuat korelasi baru.

1. Klik pada sel mana pun di `State` kolom untuk membuat korelasi baru yang melampirkan tautan data ke entri itu. Misalnya, pilih`California`.

1. Dalam tampilan terpisah, pilih sumber data yang sama yang Anda pilih di panel kiri. Helper di atas editor kueri berisi semua variabel yang tersedia Anda dapat menggunakan kueri target. Variabel berisi semua bidang data (kolom tabel) dari baris yang dipilih.

1. Di menu **Skenario**, pilih **Nilai Metrik CSV**. `String Input`Bidang di editor Query menyediakan variabel dengan nilai populasi untuk setiap tahun:`${1980},${2000},${2020}`. Ini akan menghasilkan grafik menggunakan nilai variabel.

1. Di bidang Query Editor **Alias**, masukkan`${State}`.

   Jalankan kueri untuk melihat bahwa itu menghasilkan grafik menggunakan nilai sampel dari variabel.

1. Pilih **Simpan** untuk menyimpan korelasi dan keluar dari Editor Korelasi.

   Setelah korelasi disimpan, Explore akan menjalankan kembali kueri di panel kiri. Dengan mengklik nama negara, kueri di sebelah kanan dijalankan kembali dengan nilai dari baris yang dimasukkan ke dalam CSV, sehingga mengubah grafik. Kueri dijalankan kembali dengan nilai yang diperbarui setiap kali Anda mengklik nama negara.

Anda dapat menerapkan langkah yang sama ke sumber data apa pun. Korelasi memungkinkan Anda membuat tautan dalam visualisasi untuk menjalankan kueri dinamis berdasarkan data yang dipilih. Dalam contoh ini kami menggunakan data yang dikembalikan oleh kueri untuk membangun kueri baru yang menghasilkan visualisasi yang berbeda menggunakan sumber data yang sama. Namun, Anda dapat membuat korelasi antara sumber data apa pun untuk membuat alur eksplorasi kustom.

### Membuat log ke korelasi tabel
<a name="v10-explore-corr-logs-to-table"></a>

Dalam contoh ini, Anda akan membuat korelasi untuk menunjukkan cara menggunakan transformasi untuk mengekstrak nilai dari baris log dan bidang lain.

Untuk mengikuti contoh ini, pastikan Anda telah menyiapkan [sumber data uji](testdata-data-source.md).

**Untuk membuat log ke korelasi tabel**

1. **Di Grafana, navigasikan ke Jelajahi.**

1. Pilih **sumber data uji** dari menu tarik-turun di kiri atas halaman.

1. Pilih **\$1 Tambahkan** di menu tarik-turun ke kanan dan pilih **Tambahkan** korelasi.

1. Jelajahi sekarang dalam mode Editor Korelasi, ditunjukkan dengan batas biru.

1. Di menu **Skenario**, pilih **Log**.

1. Perluas baris log untuk melihat tautan korelasi. Pilih `Correlate with hostname`.

1. Jelajahi terbuka dalam tampilan terpisah. Pilih sumber data yang sama yang Anda pilih di panel kiri. Helper di atas editor kueri berisi semua variabel yang tersedia Anda dapat menggunakan kueri target.

1. Perluas bagian transformasi, dan klik **Tambahkan transformasi**.

1. **Di menu tarik-turun **Bidang**, pilih pesan.** Baris log muncul sebagai contoh data.

1. Di bawah **Jenis**, pilih **Logfmt**. Ini mengisi daftar variabel.

1. Pilih **Tambahkan transformasi ke korelasi**.

1. Pilih **Tambahkan transformasi** lagi dan di bawah **Bidang**, pilih **nama host**.

1. Di bawah **Jenis**, pilih **Ekspresi reguler**.

1. Di bawah **Ekspresi**, masukkan yang berikut ini:`-([0-9]\*)`. Ini memilih nomor apa pun di sebelah kanan tanda hubung.

1. Di bawah **Nama Variabel**, masukkan yang berikut ini:`hostNumber`. Ini mengisi daftar variabel. 

1. Pilih **Tambahkan transformasi ke korelasi** untuk menambahkannya ke variabel lain.

1. Di editor sumber data, buka menu tarik-turun **Skenario** dan pilih Konten **CSV**.

1. Pada kotak teks di bawah ini, berikan yang berikut dan simpan korelasinya:

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   Ini menutup tampilan split dan menjalankan ulang kueri kiri. Perluas baris log apa pun untuk melihat tombol korelasi. *Memilih tombol korelasi membuka tampilan split dengan (bidang), `time` (diekstraksi dengan *logfmt* dari baris log), `msg` (diekstraksi dengan *regex* dari) dan `host number` (diekstraksi dengan logfmt dari baris log`hostname`). `status`*

# Inspector di Explore
<a name="v10-explore-inspector"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Inspektur membantu Anda memahami dan memecahkan masalah pertanyaan Anda. Anda dapat memeriksa data mentah, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), mengekspor hasil log dalam format TXT, dan melihat permintaan kueri.

## Inspector UI
<a name="v10-explore-inspector-ui"></a>

Inspektur memiliki tab berikut:
+ **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+ **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data.
+ **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin data JSON dan struktur bingkai data JSON.
+ **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri.
+ **Tab kesalahan** - Menampilkan kesalahan. Hanya terlihat ketika kueri mengembalikan kesalahan.

## Tugas Inspector
<a name="v10-explore-inspector-tasks"></a>

Anda dapat melakukan berbagai tugas di inspektur Jelajahi.

**Buka Inspector**

Setelah Anda menjalankan kueri yang ingin Anda periksa, pilih tombol **Inspector**.

Panel inspektur terbuka di bagian bawah layar.

**Periksa hasil kueri mentah**

Anda dapat melihat hasil kueri mentah, yaitu data yang dikembalikan oleh kueri dalam tabel.

Di tab **Inspector**, klik tab **Data**.

Untuk beberapa kueri atau untuk kueri beberapa node, ada opsi tambahan.
+ **Tampilkan bingkai data:** Pilih data set hasil yang ingin Anda lihat.
+ **Seri yang digabungkan dengan waktu:** Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Anda dapat mengklik judul kolom untuk mengurutkan data.

**Unduh hasil kueri mentah sebagai CSV**

Grafana menghasilkan file CSV di lokasi unduhan browser default Anda. Anda dapat membukanya di pemirsa pilihan Anda.

1. Di tab **Inspector**, dapatkan hasil kueri mentah dengan mengikuti petunjuk di atas.

1. Perbaiki pengaturan kueri hingga Anda dapat melihat data mentah yang ingin Anda ekspor.

1. Pilih **Unduh CSV**.

**Untuk mengunduh file CSV yang diformat khusus untuk Excel, perluas **opsi Data** dan kemudian aktifkan tombol **Unduh untuk Excel** sebelum Anda memilih opsi Unduh CSV.**

**Unduh hasil log sebagai TXT**

**Anda dapat menghasilkan file TXT dari log yang sedang Anda lihat, dengan memilih **Unduh log** di tab Inspector.**

**Unduh hasil jejak**

Berdasarkan tipe sumber data, Grafana menghasilkan file JSON untuk hasil jejak dalam salah satu format yang didukung: format Jaeger, Zipkin, atau OTLP.

1. Buka Inspector

1. Periksa hasil kueri log. Perbaiki hasilnya sampai Anda melihat log mentah yang ingin Anda ekspor.

1. Pilih **Unduh log**.

**Periksa kinerja kueri**

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

Statistik ditampilkan dalam format read-only.

**Lihat model JSON**

Anda dapat menjelajahi dan mengekspor data serta model JSON bingkai data.

**Untuk melihat model JSON**

1. Di panel Inspector, klik tab **JSON**.

1. Dari menu tarik-turun **Pilih sumber**, pilih salah satu opsi berikut:
   + **Data** - Menampilkan objek JSON yang mewakili data yang dikembalikan ke Explore.
   + **DataFrame struktur** - Menampilkan set hasil mentah.

1. Anda dapat memperluas atau menciutkan bagian JSON untuk melihat bagian terpisah. Anda juga dapat memilih opsi **Salin ke clipboard** untuk menyalin badan JSON dan menempelkannya ke aplikasi lain.

**Lihat permintaan mentah dan respons terhadap sumber data**

Saat Anda bekerja dengan Explore dan tab Inspector, Anda dapat melihat permintaan mentah dan data respons yang Anda hasilkan dengan kueri. Di Inspector, pilih tab **Query** dan pilih **Refresh** untuk melihat data mentah.

Grafana mengirimkan kueri ke server dan menampilkan hasilnya. Anda dapat menelusuri bagian-bagian tertentu dari kueri, memperluas atau menciutkan semuanya, atau menyalin data ke clipboard untuk digunakan dalam aplikasi lain.

# Korelasi dalam Grafana versi 10
<a name="v10-correlations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat tautan interaktif untuk visualisasi Jelajahi untuk menjalankan kueri yang terkait dengan data yang disajikan dengan menyiapkan Korelasi.

Korelasi mendefinisikan bagaimana data dalam satu sumber data digunakan untuk kueri data di sumber data lain. Beberapa contoh:
+ Nama aplikasi yang dikembalikan dalam sumber data log dapat digunakan untuk menanyakan metrik yang terkait dengan aplikasi tersebut dalam sumber data metrik.
+ Nama pengguna yang dikembalikan oleh sumber data SQL dapat digunakan untuk menanyakan log yang terkait dengan pengguna tertentu dalam sumber data log.

Jelajahi mengambil korelasi yang ditentukan pengguna untuk menampilkan tautan di dalam visualisasi. Anda dapat mengklik tautan untuk menjalankan kueri terkait dan melihat hasilnya di Jelajahi Tampilan Split.

Jelajahi visualisasi yang saat ini mendukung menampilkan tautan berdasarkan korelasi:
+ [Beberapa catatan](v10-panels-logs.md)
+ [Tabel](v10-panels-table.md)

[Anda dapat mengonfigurasi korelasi menggunakan halaman **Administrasi > Plugin dan data > Korelasi** di Grafana atau langsung di Jelajahi.](v10-explore-correlations.md)

**Topics**
+ [Konfigurasi korelasi](v10-correlations-config.md)
+ [Buat korelasi baru](v10-correlations-create.md)

# Konfigurasi korelasi
<a name="v10-correlations-config"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Setiap korelasi dikonfigurasi dengan opsi berikut: 

**Label**  
Label tautan, ditampilkan dalam visualisasi.

**Deskripsi**  
Deskripsi opsional.

**Sumber data sumber**  
Sumber hasil yang memiliki tautan yang ditampilkan.

**Bidang hasil**  
Mendefinisikan di mana tautan ditampilkan dalam visualisasi.

**Kueri target**  
Kueri target berjalan saat tautan diklik.

**Transformasi**  
Manipulasi opsional ke data sumber yang disertakan diteruskan ke kueri target.

Untuk detail tentang membuat korelasi, lihat [Membuat korelasi](v10-correlations-create.md).

## Sumber data sumber dan bidang hasil
<a name="v10-correlations-config-source-and-result"></a>

Tautan ditampilkan di Jelajahi visualisasi untuk hasil dari sumber data sumber korelasi. Tautan ditetapkan ke salah satu bidang dari hasil yang disediakan dalam konfigurasi korelasi (bidang hasil). Setiap visualisasi menampilkan bidang dengan tautan dengan cara yang berbeda. 

## Kueri target
<a name="v10-correlations-config-target-query"></a>

Kueri target dijalankan ketika tautan diklik dalam visualisasi. Anda dapat menggunakan editor kueri dari sumber data target yang dipilih untuk menentukan kueri target. Hasil data sumber dapat diakses di dalam kueri target dengan variabel.

### Variabel Korelasi
<a name="v10-correlations-config-variables"></a>

Anda dapat menggunakan variabel di dalam kueri target untuk mengakses data sumber yang terkait dengan kueri. Korelasi menggunakan sintaks [variabel Grafana](v10-dash-variable-syntax.md). Variabel diisi dengan nilai-nilai dari hasil sumber ketika link dipilih. Ada dua jenis variabel yang dapat Anda gunakan:
+ [Variabel bidang](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (untuk mengakses nilai bidang dan label).
+ Variabel korelasi (untuk mengakses nilai bidang dan transformasi).

Contoh: Jika hasil sumber berisi bidang yang disebut`employee`, nilai bidang dapat diakses dengan:
+ Variabel bidang`${__data.fields.employee}`.
+ Variabel korelasi yang memetakan nilai bidang di atas ke`${employee}`.

Selain memetakan nilai bidang ke nama variabel yang lebih pendek, lebih banyak variabel korelasi dapat dibuat dengan menerapkan transformasi ke bidang yang ada.

Korelasi membuat tautan data hanya jika semua variabel memiliki nilai di baris data yang dipilih. [Variabel global](v10-dash-variable-add.md#v10-dash-variable-add-global) adalah pengecualian untuk aturan ini dan tidak perlu diisi dari data yang dikembalikan. Variabel-variabel ini diinterpolasi secara otomatis oleh sumber data.

### Transformasi Korelasi
<a name="v10-correlations-config-transformations"></a>

Transformasi menyediakan cara untuk mengekstrak lebih banyak variabel dari nilai bidang. Output transformasi adalah seperangkat variabel baru yang dapat diakses sebagai variabel lainnya.

Ada dua jenis transformasi: logfmt dan ekspresi reguler.

Setiap transformasi menggunakan nilai bidang yang dipilih sebagai input. Output dari transformasi adalah seperangkat variabel baru berdasarkan jenis dan opsi transformasi.

### Transformasi Logfmt
<a name="v10-correlations-config-logfmt-transformation"></a>

[Transformasi logfmt mendekonstruksi nilai bidang yang berisi teks yang diformat dengan pasangan kunci/nilai logfmt.](https://brandur.org/logfmt) Setiap pasangan menjadi variabel dengan kunci menjadi nama variabel.

Transformasi logfmt hanya memerlukan menentukan nama bidang input jika Anda ingin transformasi diterapkan ke bidang yang berbeda dari bidang hasil. Contoh variabel keluaran untuk`field = "host=srv001 endpoint=/test app=foo"`:


| name | nilai | 
| --- | --- | 
| host | srv001 | 
| titik akhir | /uji | 
| aplikasi | foo | 

### Transformasi ekspresi reguler
<a name="v10-correlations-config-regular-expression-transformation"></a>

Transformasi ekspresi reguler mendekonstruksi nilai bidang berdasarkan ekspresi reguler yang disediakan.

Opsi transformasi ekspresi reguler:

**lapangan**  
Nama bidang masukan

**ekspresi**  
Ekspresi reguler. Grup tangkapan bernama dipetakan ke variabel yang cocok dengan nama grup. Jika grup pencocokan non-bernama digunakan variabel dibuat dari kecocokan pertama. Nilai mengesampingkan variabel yang cocok dengan bidang input atau variabel baru dibuat jika mapValue disediakan (lihat contoh dalam tabel berikut).

**MapValue**  
Digunakan dengan grup regex sederhana tanpa grup pencocokan bernama. Secara default, kecocokan pertama mengganti variabel dengan nama bidang yang digunakan sebagai input. Untuk mengubah perilaku default itu, Anda dapat menentukan properti mapValue. Nama yang disediakan digunakan untuk membuat variabel baru. Ini dapat berguna jika kueri target Anda memerlukan nilai yang tepat dan bagian dari nilai yang diekstraksi dengan transformasi.

Contoh: Dengan asumsi nama bidang yang dipilih adalah `employee` dan nilai bidang adalah`John Doe`.

Berbagai variabel keluaran berdasarkan ekspresi dan opsi mapValue:


| ekspresi | MapValue | variabel keluaran | komentar | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Tidak ada mapValue yang disediakan. Pencocokan pertama dipetakan ke variabel nama bidang yang ada (employee). | 
| /(\$1w\$1) (\$1w\$1)/ | name | name=John | Pencocokan pertama dipetakan ke variabel baru yang disebutname.  | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Ketika grup bernama digunakan mereka adalah nama variabel output dan mapValue diabaikan. | 
| /(?\$1w\$1) (?\$1w\$1)/ | name | firstName=John, lastName=Doe | Sama seperti di atas | 

# Buat korelasi baru
<a name="v10-correlations-create"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat korelasi di editor Jelajahi korelasi, atau menggunakan halaman **Administrasi** Grafana di ruang kerja Grafana Terkelola Amazon.

**Prasyarat**

Anda harus memiliki izin untuk menambahkan korelasi baru. Hanya pengguna dengan izin menulis ke sumber data yang dapat menentukan korelasi baru.

## Membuat korelasi di editor korelasi Explore
<a name="v10-correlations-create-explore"></a>

Anda dapat membuat korelasi di editor korelasi Jelajahi. Untuk detail selengkapnya, lihat [Menciptakan korelasi](v10-explore-correlations.md#v10-explore-corr-create-a-correlation).

## Membuat korelasi di halaman Administrasi
<a name="v10-correlations-create-administration"></a>

Anda dapat menggunakan halaman **Administrasi** konsol Grafana untuk membuat korelasi.

**Untuk membuat korelasi di halaman Administrasi**

1. Buka bagian **Administrasi** di Grafana.

1. Di bawah **Plugin dan data**, buka halaman **Korelasi**.

1. Pilih tombol **Tambah** di sudut kanan atas.

1. Berikan **label** untuk korelasi.

1. (Opsional) Berikan **deskripsi**.

1. Pergi ke halaman berikutnya.

1. Menyediakan **sumber data target**.

1. Berikan **kueri target** menggunakan variabel.

1. Pergi ke halaman berikutnya.

1. Menyediakan **sumber sumber data**.

1. Berikan **bidang hasil**.

1. Tambahkan transformasi jika Anda membutuhkan variabel yang bukan bidang di sumber data sumber.

1. Pilih **Tambah** untuk menambahkan transformasi baru.

1. Pilih jenis transformasi.

1. Konfigurasikan transformasi tergantung pada jenis yang dipilih.

1. Simpan korelasinya.

Anda dapat mengedit korelasi dengan cara yang sama, tetapi saat mengedit, Anda tidak dapat mengubah sumber data yang dipilih.

# Peringatan di Grafana versi 10
<a name="v10-alerts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Dengan Grafana v10, Grafana yang Dikelola Amazon menyertakan akses ke sistem peringatan yang diperbarui, peringatan Grafana, yang memusatkan informasi *peringatan dalam satu tampilan* yang dapat dicari. Grafana alert diperkenalkan sebagai fitur opsional di Grafana v8, dan GrafanaLabs telah mengumumkan penghapusan peringatan lama di versi 11.

**catatan**  
Dokumentasi ini mencakup peringatan Grafana. Untuk informasi tentang peringatan lama, lihat. [Peringatan dasbor klasik](old-alerts-overview.md)

Grafana Alerting memungkinkan Anda untuk belajar tentang masalah dalam sistem Anda beberapa saat setelah itu terjadi.

Pantau data metrik masuk atau entri log Anda dan atur sistem Peringatan Anda untuk melihat peristiwa atau keadaan tertentu, lalu kirim pemberitahuan saat hal-hal tersebut ditemukan.

Dengan cara ini, Anda menghilangkan kebutuhan untuk pemantauan manual dan memberikan garis pertahanan pertama terhadap pemadaman sistem atau perubahan yang dapat berubah menjadi insiden besar.

Dengan Grafana Alerting, Anda membuat kueri dan ekspresi dari berbagai sumber data — di mana pun data Anda disimpan — memberi Anda fleksibilitas untuk menggabungkan data dan peringatan tentang metrik dan log Anda dengan cara baru dan unik. Anda kemudian dapat membuat, mengelola, dan mengambil tindakan pada peringatan Anda dari satu tampilan yang terkonsolidasi, dan meningkatkan kemampuan tim Anda untuk mengidentifikasi dan menyelesaikan masalah dengan cepat.

Dengan aturan peringatan Mimir dan Loki, Anda dapat menjalankan ekspresi peringatan lebih dekat ke data Anda dan dalam skala besar, semuanya dikelola oleh UI Grafana yang sudah Anda kenal.

**catatan**  
Jika Anda bermigrasi dari Grafana versi sebelumnya, tempat Anda menggunakan peringatan Grafana lama, Anda mungkin merasa terbantu untuk melihat [perbedaan antara peringatan lama](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) dan peringatan Grafana baru.

## Fitur dan manfaat utama
<a name="v10-alerting-key-features"></a>

**Satu halaman untuk semua peringatan**

Satu halaman Peringatan Grafana menggabungkan peringatan dan peringatan yang dikelola Grafana yang berada di sumber data Anda yang kompatibel dengan Prometheus di satu tempat.

**Peringatan multi-dimensi**

Aturan peringatan dapat membuat beberapa instance peringatan individual per aturan peringatan, yang dikenal sebagai peringatan multi-dimensi, memberi Anda kekuatan dan fleksibilitas untuk mendapatkan visibilitas ke seluruh sistem Anda hanya dengan satu aturan peringatan. Anda melakukan ini dengan menambahkan label ke kueri Anda untuk menentukan komponen mana yang sedang dipantau dan menghasilkan beberapa instance peringatan untuk satu aturan peringatan. Misalnya, jika Anda ingin memantau setiap server dalam sebuah cluster, peringatan multi-dimensi akan mengingatkan pada setiap CPU, sedangkan peringatan standar akan mengingatkan pada keseluruhan server.

**Peringatan rute**

Rutekan setiap instance peringatan ke titik kontak tertentu berdasarkan label yang Anda tentukan. Kebijakan pemberitahuan adalah seperangkat aturan untuk di mana, kapan, dan bagaimana peringatan diarahkan ke titik kontak.

**Peringatan diam**

Keheningan menghentikan pemberitahuan agar tidak dibuat dan bertahan hanya untuk jangka waktu tertentu. Keheningan memungkinkan Anda untuk berhenti menerima pemberitahuan persisten dari satu atau beberapa aturan peringatan. Anda juga dapat menjeda sebagian peringatan berdasarkan kriteria tertentu. Silences memiliki bagian khusus mereka sendiri untuk organisasi dan visibilitas yang lebih baik, sehingga Anda dapat memindai aturan peringatan yang dijeda tanpa mengacaukan tampilan peringatan utama.

**Bisukan pengaturan waktu**

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan keheningan, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

## Rancang sistem Peringatan Anda
<a name="v10-alerting-design"></a>

Memantau sistem TI yang kompleks dan memahami apakah semuanya berjalan dan berjalan dengan benar adalah tugas yang sulit. Oleh karena itu, menyiapkan sistem manajemen peringatan yang efektif sangat penting untuk memberi tahu Anda ketika ada yang salah sebelum mulai memengaruhi hasil bisnis Anda.

Merancang dan mengonfigurasi pengaturan manajemen peringatan yang berfungsi membutuhkan waktu.

Berikut adalah beberapa tips tentang cara membuat pengaturan manajemen peringatan yang efektif untuk bisnis Anda:

**Mana metrik utama untuk bisnis Anda yang ingin Anda pantau dan waspada?**
+ Temukan peristiwa yang penting untuk diketahui dan tidak terlalu sepele atau sering sehingga penerima mengabaikannya.
+ Peringatan hanya boleh dibuat untuk acara besar yang membutuhkan perhatian atau intervensi segera.
+ Pertimbangkan kualitas daripada kuantitas.

**Jenis Alerting apa yang ingin Anda gunakan?**
+ Pilih antara Peringatan yang dikelola Grafana atau Grafana Mimir atau Peringatan yang dikelola Loki; atau keduanya.

**Bagaimana Anda ingin mengatur peringatan dan notifikasi Anda?**
+ Selektif tentang siapa yang Anda tetapkan untuk menerima peringatan. Pertimbangkan untuk mengirimnya ke siapa pun yang sedang menelepon atau saluran Slack tertentu.
+ Otomatiskan sejauh mungkin menggunakan API Peringatan atau peringatan sebagai kode (Terraform).

**Bagaimana Anda bisa mengurangi kelelahan waspada?**
+ Hindari peringatan yang bising dan tidak perlu dengan menggunakan keheningan, pengaturan waktu bisu, atau menjeda evaluasi aturan peringatan.
+ Sesuaikan aturan peringatan Anda secara terus-menerus untuk meninjau efektivitas. Hapus aturan peringatan untuk menghindari duplikasi atau peringatan yang tidak efektif.
+ Pikirkan baik-baik tentang tingkat prioritas dan tingkat keparahan.
+ Terus tinjau ambang batas dan aturan evaluasi Anda.

## Keterbatasan peringatan Grafana
<a name="v10-alerting-limitations"></a>
+ Saat menggabungkan aturan dari sistem lain, sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Amazon Managed Service untuk Prometheus, Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan dari sumber data lain yang didukung.

**Topics**
+ [Fitur dan manfaat utama](#v10-alerting-key-features)
+ [Rancang sistem Peringatan Anda](#v10-alerting-design)
+ [Keterbatasan peringatan Grafana](#v10-alerting-limitations)
+ [Gambaran umum](v10-alerting-overview.md)
+ [Mengatur Peringatan](v10-alerting-setup.md)
+ [Konfigurasikan peringatan](v10-alerting-configure.md)
+ [Kelola lansiran Anda](v10-alerting-manage.md)

# Gambaran umum
<a name="v10-alerting-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Baik Anda baru memulai atau pengguna Grafana Alerting yang lebih berpengalaman, pelajari lebih lanjut tentang dasar-dasar dan fitur yang tersedia yang membantu Anda membuat, mengelola, dan menanggapi peringatan; dan tingkatkan kemampuan tim Anda untuk menyelesaikan masalah dengan cepat.

## Prinsip
<a name="v10-alerting-overview-principles"></a>

Dalam sistem peringatan berbasis Prometheus, Anda memiliki generator peringatan yang membuat peringatan dan penerima peringatan yang menerima peringatan. Misalnya, Prometheus adalah generator peringatan dan bertanggung jawab untuk mengevaluasi aturan peringatan, sementara Alertmanager adalah penerima peringatan dan bertanggung jawab untuk mengelompokkan, menghambat, membungkam, dan mengirim pemberitahuan tentang penembakan dan peringatan yang diselesaikan.

Grafana Alerting dibangun di atas model Prometheus dalam merancang sistem peringatan. Ini memiliki generator peringatan internal yang bertanggung jawab untuk menjadwalkan dan mengevaluasi aturan peringatan, serta penerima peringatan internal yang bertanggung jawab untuk mengelompokkan, menghambat, membungkam, dan mengirim pemberitahuan. Grafana tidak menggunakan Prometheus sebagai generator peringatan karena Grafana Alerting perlu bekerja dengan banyak sumber data lain selain Prometheus. Namun, ia menggunakan Alertmanager sebagai penerima peringatan.

Peringatan dikirim ke penerima peringatan di mana mereka diarahkan, dikelompokkan, dihambat, dibungkam, dan diberitahukan. Di Grafana Alerting, penerima peringatan default adalah Alertmanager yang disematkan di dalam Grafana, dan disebut sebagai Grafana Alertmanager. Namun, Anda juga dapat menggunakan Alertmanager lainnya, dan ini disebut sebagai Manajer Peringatan [Eksternal](v10-alerting-setup-alertmanager.md).

## Dasar-dasar
<a name="v10-alerting-overview-fundamentals"></a>

Berikut ini memberikan ikhtisar tentang berbagai bagian peringatan Grafana.

### Aturan peringatan
<a name="v10-alerting-overview-alert-rules"></a>

Aturan peringatan adalah seperangkat kriteria yang menentukan kapan peringatan harus ditembakkan. Ini terdiri dari satu atau lebih pertanyaan dan ekspresi, suatu kondisi yang perlu dipenuhi, interval yang menentukan seberapa sering aturan peringatan dievaluasi, dan durasi di mana kondisi harus dipenuhi agar peringatan menyala.

Aturan peringatan dievaluasi selama intervalnya, dan setiap aturan peringatan dapat memiliki nol, satu, atau sejumlah peringatan yang ditembakkan pada satu waktu. Status aturan peringatan ditentukan oleh yang paling `severe` waspada, yang dapat berupa salah satu Normal, Tertunda, atau Penembakan. Misalnya, jika setidaknya satu dari peringatan aturan peringatan ditembakkan maka aturan peringatan juga diberlakukan. Kesehatan aturan siaga ditentukan oleh status evaluasi terbarunya. Ini bisa OK, Error, dan NoData.

Fitur yang sangat penting dari aturan peringatan adalah bahwa mereka mendukung anotasi dan label khusus. Ini memungkinkan Anda untuk instrumen peringatan dengan metadata tambahan seperti ringkasan dan deskripsi, dan menambahkan label tambahan untuk merutekan peringatan ke kebijakan pemberitahuan tertentu.

### Pemberitahuan
<a name="v10-alerting-overview-alerts"></a>

Peringatan diidentifikasi secara unik oleh kumpulan key/value pasangan yang disebut Label. Setiap kunci adalah nama label dan setiap nilai adalah nilai label. Misalnya, satu peringatan mungkin memiliki label `foo=bar` dan peringatan lain mungkin memiliki label`foo=baz`. Peringatan dapat memiliki banyak label seperti `foo=bar,bar=baz` tetapi tidak dapat memiliki label yang sama dua kali seperti`foo=bar,foo=baz`. Dua peringatan juga tidak dapat memiliki label yang sama, dan jika dua peringatan memiliki label yang sama seperti `foo=bar,bar=baz` dan `foo=bar,bar=baz` kemudian salah satu peringatan akan dibuang. Peringatan diselesaikan ketika kondisi dalam aturan peringatan tidak lagi terpenuhi, atau aturan peringatan dihapus.

Di Grafana Managed Alerts, peringatan bisa dalam status Normal, Tertunda, Peringatan, Tidak Ada Data atau Kesalahan. Di sumber Data Peringatan Terkelola, seperti Mimir dan Loki, peringatan bisa dalam Normal, Tertunda dan Peringatan, tetapi tidak atau Kesalahan. NoData 

### Titik kontak
<a name="v10-alerting-overview-contact-points"></a>

Titik kontak menentukan di mana pemberitahuan dikirim. Misalnya, Anda mungkin memiliki titik kontak yang mengirimkan pemberitahuan ke alamat email, ke Slack, ke sistem manajemen insiden (IRM) seperti Grafana OnCall atau Pagerduty, atau ke webhook.

Notifikasi yang dikirim dari titik kontak dapat disesuaikan menggunakan templat notifikasi. Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan struktur notifikasi. Template notifikasi tidak spesifik untuk integrasi individual atau titik kontak.

### Kebijakan pemberitahuan
<a name="v10-alerting-overview-notification-policies"></a>

Kebijakan pemberitahuan mengelompokkan peringatan dan kemudian merutekan mereka ke titik kontak. Mereka menentukan kapan pemberitahuan dikirim, dan seberapa sering pemberitahuan harus diulang.

Peringatan dicocokkan dengan kebijakan notifikasi menggunakan pencocokan label. Ini adalah ekspresi yang dapat dibaca manusia yang menyatakan jika label peringatan sama persis, tidak sama persis, berisi, atau tidak mengandung beberapa teks yang diharapkan. Misalnya, matcher `foo=bar` mencocokkan peringatan dengan label `foo=bar` sementara matcher `foo=~[a-zA-Z]+` mencocokkan peringatan dengan label apa pun yang disebut foo dengan nilai yang cocok dengan ekspresi reguler. `[a-zA-Z]+`

Secara default, peringatan hanya dapat mencocokkan satu kebijakan notifikasi. Namun, dengan `continue` fitur peringatan dapat dibuat untuk mencocokkan sejumlah kebijakan pemberitahuan pada saat yang sama. Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat [Kebijakan Pemberitahuan](v10-alerting-explore-notifications-policies-details.md).

### Keheningan dan pengaturan waktu bisu
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

Diam dan pengaturan waktu bisu memungkinkan Anda menjeda notifikasi untuk peringatan tertentu atau bahkan seluruh kebijakan notifikasi. Gunakan keheningan untuk menjeda notifikasi secara ad-hoc, seperti saat mengerjakan perbaikan untuk peringatan; dan gunakan pengaturan waktu bisu untuk menjeda notifikasi secara berkala, seperti selama jendela pemeliharaan terjadwal secara rutin.

**Topics**
+ [Prinsip](#v10-alerting-overview-principles)
+ [Dasar-dasar](#v10-alerting-overview-fundamentals)
+ [Sumber data dan peringatan Grafana](v10-alerting-overview-datasources.md)
+ [Peringatan pada data numerik](v10-alerting-overview-numeric.md)
+ [Label dan anotasi](v10-alerting-overview-labels.md)
+ [Tentang aturan peringatan](v10-alerting-explore-rules.md)
+ [Pengelola Peringatan](v10-alerting-explore-alertmanager.md)
+ [Titik kontak](v10-alerting-explore-contacts.md)
+ [Notifikasi](v10-alerting-explore-notifications.md)
+ [Memperingatkan ketersediaan tinggi](v10-alerting-explore-high-availability.md)

# Sumber data dan peringatan Grafana
<a name="v10-alerting-overview-datasources"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ada sejumlah sumber data yang kompatibel dengan Grafana Alerting. Setiap sumber data didukung oleh plugin. Peringatan Grafana mengharuskan plugin sumber data menjadi plugin *backend*, untuk mengevaluasi aturan menggunakan sumber data, karena mesin evaluasi berjalan di backend. Plugin juga harus menentukan bahwa mereka kompatibel dengan peringatan Grafana.

Sumber data ditambahkan dan diperbarui dari waktu ke waktu. Sumber data berikut diketahui kompatibel dengan peringatan Grafana.
+ [Connect ke sumber CloudWatch data Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect ke sumber data Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connect ke sumber data Amazon OpenSearch Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connect ke sumber data Google Cloud Monitoring](using-google-cloud-monitoring-in-grafana.md)
+ [Connect ke sumber data Graphite](using-graphite-in-AMG.md)
+ [Connect ke sumber data InfluxDB](using-influxdb-in-AMG.md)
+ [Connect ke sumber data Loki](using-loki-in-AMG.md)
+ [Connect ke sumber data Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [Connect ke sumber data MySQL](using-mysql-in-AMG.md)
+ [Connect ke sumber data OpenTSDB](using-opentsdb-in-AMG.md)
+ [Connect ke sumber data PostgreSQL](using-postgresql-in-AMG.md)
+ [Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka](prometheus-data-source.md)
+ [Connect ke sumber data Jaeger](jaeger-data-source.md)
+ [Connect ke sumber data Zipkin](zipkin-data-source.md)
+ [Connect ke sumber data Tempo](tempo-data-source.md)
+ [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md)

Untuk informasi selengkapnya tentang sumber data dan plugin sumber data di Grafana Terkelola Amazon, lihat. [Connect ke sumber data](AMG-data-sources.md)

# Peringatan pada data numerik
<a name="v10-alerting-overview-numeric"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini menjelaskan bagaimana Grafana menangani peringatan pada data numerik daripada deret waktu.

Di antara sumber data tertentu, data numerik yang bukan deret waktu dapat langsung disiagakan, atau diteruskan ke Server Side Expressions (SSE). Hal ini memungkinkan untuk lebih banyak pemrosesan dan menghasilkan efisiensi dalam sumber data, dan juga dapat menyederhanakan aturan peringatan. Saat memperingatkan data numerik alih-alih data deret waktu, tidak perlu mengurangi setiap deret waktu berlabel menjadi satu angka. Sebaliknya, nomor berlabel dikembalikan ke Grafana sebagai gantinya.

## Data tabular
<a name="v10-alerting-numeric-tabular"></a>

Fitur ini didukung dengan sumber data backend yang menanyakan data tabular:
+ Sumber data SQL seperti MySQL, Postgres, MSSQL, dan Oracle.
+ Layanan berbasis Azure Kusto: Azure Monitor (Log), Azure Monitor (Azure Resource Graph), dan Azure Data Explorer.

Kueri dengan peringatan terkelola Grafana atau SSE dianggap numerik dengan sumber data ini, jika:
+ Opsi “Format AS” diatur ke “Tabel” dalam kueri sumber data.
+ Respons tabel yang dikembalikan ke Grafana dari kueri hanya mencakup satu kolom numerik (misalnya int, double, float), dan kolom string tambahan opsional.

Jika ada kolom string, maka kolom tersebut menjadi label. Nama kolom menjadi nama label, dan nilai untuk setiap baris menjadi nilai label yang sesuai. Jika beberapa baris dikembalikan, maka setiap baris harus diidentifikasi secara unik labelnya.

## Contoh
<a name="v10-alerting-numeric-tabexample"></a>

Untuk tabel MySQL yang disebut “”: DiskSpace


| Waktu | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
| 2021-Juni-7 | web1 | /dll | 3 | 
| 2021-Juni-7 | web2 | /var | 4 | 
| 2021-Juni-7 | web3 | /var | 8 | 
| ... | ... | ... | ... | 

Anda dapat menanyakan pemfilteran data tepat waktu, tetapi tanpa mengembalikan deret waktu ke Grafana. Misalnya, peringatan yang akan memicu per Host, Disk ketika ada kurang dari 5% ruang kosong:

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
       SELECT
          Host, 
          Disk, 
          Avg(PercentFree) 
       FROM DiskSpace
       Group By
          Host, 
          Disk 
       Where __timeFilter(Time)
```

Query ini mengembalikan respon Tabel berikut untuk Grafana:


| Host | Disk | PercentFree | 
| --- | --- | --- | 
| web1 | /dll | 3 | 
| web2 | /var | 4 | 
| web3 | /var | 0 | 

Ketika kueri ini digunakan sebagai **kondisi** dalam aturan peringatan, maka bukan nol akan memperingatkan. Akibatnya, tiga instance peringatan dihasilkan:


| Label | Status | 
| --- | --- | 
| \$1host = web1, disk =/dll\$1 | Peringatan | 
| \$1host = web2, disk =/var\$1 | Peringatan | 
| \$1host = web3, disk =/var\$1 | Normal | 

# Label dan anotasi
<a name="v10-alerting-overview-labels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Label dan anotasi berisi informasi tentang peringatan. Baik label dan anotasi memiliki struktur yang sama: satu set nilai bernama; namun penggunaan yang dimaksudkan berbeda. Contoh label, atau anotasi yang setara, mungkin`alertname="test"`.

Perbedaan utama antara label dan anotasi adalah label digunakan untuk membedakan peringatan dari semua peringatan lainnya, sementara anotasi digunakan untuk menambahkan informasi tambahan ke peringatan yang ada.

Misalnya, pertimbangkan dua peringatan CPU tinggi: satu untuk `server1` dan satu lagi untuk`server2`. Dalam contoh seperti itu, kita mungkin memiliki label yang disebut `server` di mana peringatan pertama memiliki label `server="server1"` dan peringatan kedua memiliki label`server="server2"`. Namun, kami mungkin juga ingin menambahkan deskripsi ke setiap peringatan seperti`"The CPU usage for server1 is above 75%."`, di `75%` mana `server1` dan diganti dengan nama dan penggunaan CPU server (silakan lihat dokumentasi tentang [Templating label dan anotasi](v10-alerting-overview-labels-templating.md) cara melakukannya). Deskripsi semacam ini akan lebih cocok sebagai anotasi.

## Label
<a name="v10-alerting-overview-labels-labels"></a>

Label berisi informasi yang mengidentifikasi peringatan. Contoh label mungkin`server=server1`. Setiap peringatan dapat memiliki lebih dari satu label, dan set lengkap label untuk peringatan disebut set labelnya. Set label inilah yang mengidentifikasi peringatan.

Misalnya, peringatan mungkin memiliki label yang disetel `{alertname="High CPU usage",server="server1"}` sementara peringatan lain mungkin memiliki label yang disetel`{alertname="High CPU usage",server="server2"}`. Ini adalah dua peringatan terpisah karena meskipun `alertname` labelnya sama, `server` labelnya berbeda.

Label yang ditetapkan untuk peringatan adalah kombinasi label dari sumber data, label khusus dari aturan peringatan, dan sejumlah label yang dicadangkan seperti. `alertname`

**Label Kustom**

Label khusus adalah label tambahan dari aturan peringatan. Seperti anotasi, label khusus harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Dokumentasi tentang cara membuat template label kustom dapat ditemukan [di sini](v10-alerting-overview-labels-templating.md).

Saat menggunakan label khusus dengan templat, penting untuk memastikan bahwa nilai label tidak berubah di antara evaluasi berturut-turut dari aturan peringatan karena ini akan menghasilkan sejumlah besar peringatan berbeda. Namun, tidak apa-apa bagi template untuk menghasilkan nilai label yang berbeda untuk peringatan yang berbeda. Misalnya, jangan letakkan nilai kueri di label khusus karena ini akan berakhir dengan membuat kumpulan peringatan baru setiap kali nilainya berubah. Sebagai gantinya gunakan anotasi.

Penting juga untuk memastikan bahwa label yang ditetapkan untuk peringatan tidak memiliki dua atau lebih label dengan nama yang sama. Jika label kustom memiliki nama yang sama dengan label dari sumber data maka label tersebut akan menggantikan label tersebut. Namun, jika label khusus memiliki nama yang sama dengan label yang dicadangkan maka label khusus akan dihilangkan dari peringatan.

## Anotasi
<a name="v10-alerting-overview-labels-annotations"></a>

Anotasi adalah pasangan bernama yang menambahkan informasi tambahan ke peringatan yang ada. Ada sejumlah anotasi yang disarankan di Grafana `description` seperti`summary`,,`runbook_url`, `dashboardUId` dan. `panelId` Seperti label khusus, anotasi harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Jika anotasi berisi kode templat, templat dievaluasi sekali saat peringatan diaktifkan. Itu tidak dievaluasi ulang, bahkan ketika peringatan diselesaikan. Dokumentasi tentang cara membuat templat anotasi dapat ditemukan [di sini](v10-alerting-overview-labels-templating.md).

**Topics**
+ [Label](#v10-alerting-overview-labels-labels)
+ [Anotasi](#v10-alerting-overview-labels-annotations)
+ [Cara kerja pencocokan label](v10-alerting-overview-labels-matching.md)
+ [Label di Grafana Alerting](v10-alerting-overview-labels-alerting.md)
+ [Templating label dan anotasi](v10-alerting-overview-labels-templating.md)

# Cara kerja pencocokan label
<a name="v10-alerting-overview-labels-matching"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan label dan pencocokan label untuk menautkan aturan peringatan ke kebijakan pemberitahuan dan pembungkaman. Ini memungkinkan cara yang sangat fleksibel untuk mengelola instance peringatan Anda, menentukan kebijakan mana yang harus ditangani, dan peringatan mana yang akan dibungkam.

Pencocokan label terdiri dari 3 bagian yang berbeda, **label**, **nilai** dan **operator**.
+ Bidang **Label** adalah nama label yang cocok. Itu harus sama persis dengan nama label.
+ Bidang **Nilai** cocok dengan nilai yang sesuai untuk nama **Label** yang ditentukan. Bagaimana kecocokannya tergantung pada nilai **Operator**.
+ Bidang **Operator** adalah operator yang cocok dengan nilai label. Operator yang tersedia adalah:


| Operator | Deskripsi | 
| --- | --- | 
| `=` | Pilih label yang persis sama dengan nilainya. | 
| `!=` | Pilih label yang tidak sama dengan nilainya. | 
| `=~` | Pilih label yang sesuai dengan nilai regex-nya. | 
| `!~` | Pilih label yang tidak cocok dengan nilai. | 

Jika Anda menggunakan beberapa pencocokan label, mereka digabungkan menggunakan operator logis AND. Ini berarti bahwa semua pencocokan harus cocok untuk menautkan aturan ke kebijakan.

## Contoh
<a name="v10-alerting-overview-labels-matching-ex"></a>

Jika Anda menentukan kumpulan label berikut untuk peringatan Anda:

```
{ foo=bar, baz=qux, id=12 }
```

maka:
+ Pencocokan label yang didefinisikan sebagai `foo=bar` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `foo!=bar` *tidak* cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `id=~[0-9]+` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `baz!~[0-9]+` cocok dengan aturan peringatan ini.
+ Dua pencocokan label didefinisikan sebagai `foo=bar` dan `id=~[0-9]+` cocok dengan aturan peringatan ini.

## Kecualikan label
<a name="v10-alerting-overview-labels-matching-exclude"></a>

Anda juga dapat menulis pencocokan label untuk mengecualikan label.

Berikut adalah contoh yang menunjukkan cara mengecualikan label`team`. Anda dapat memilih di antara nilai-nilai ini untuk mengecualikan label.
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Label di Grafana Alerting
<a name="v10-alerting-overview-labels-alerting"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini menjelaskan mengapa label merupakan komponen mendasar dari peringatan.
+ Set lengkap label untuk peringatan adalah apa yang secara unik mengidentifikasi peringatan dalam peringatan Grafana.
+ Alertmanager menggunakan label untuk mencocokkan peringatan untuk keheningan dan grup peringatan dalam kebijakan notifikasi.
+ UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan selama evaluasi aturan tersebut.
+ Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.
+ Anda dapat menambahkan label ke [aturan peringatan](v10-alerting-configure.md). Label dapat dikonfigurasi secara manual, menggunakan fungsi templat, dan dapat mereferensikan label lain. Label yang ditambahkan ke aturan peringatan diutamakan jika terjadi tabrakan antar label (kecuali dalam kasus label yang dicadangkan Grafana, lihat di bawah untuk informasi lebih lanjut).

## Kompatibilitas Alertmanager eksternal
<a name="v10-alerting-overview-labels-alerting-external"></a>

Alertmanager bawaan Grafana mendukung kunci dan nilai label Unicode. [Jika Anda menggunakan Prometheus Alertmanager eksternal, kunci label harus kompatibel dengan model datanya.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) Ini berarti bahwa kunci label hanya boleh berisi **huruf ASCII**, **angka**, serta **garis bawah** dan cocok dengan regex. `[a-zA-Z_][a-zA-Z0-9_]*` Setiap karakter yang tidak valid akan dihapus atau diganti oleh mesin peringatan Grafana sebelum dikirim ke Alertmanager eksternal sesuai dengan aturan berikut:
+ `Whitespace`akan dihapus.
+ `ASCII characters`akan diganti dengan`_`.
+ `All other characters`akan diganti dengan representasi hex huruf kecil mereka. Jika ini adalah karakter pertama, itu akan diawali dengan`_`.

**catatan**  
Jika beberapa kunci label disanitasi ke nilai yang sama, duplikat akan memiliki hash pendek dari label asli yang ditambahkan sebagai akhiran.

## Label yang dipesan Grafana
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**catatan**  
Label yang diawali dengan `grafana_` dicadangkan oleh Grafana untuk penggunaan khusus. Jika label yang dikonfigurasi secara manual ditambahkan dimulai dengan `grafana_` itu akan ditimpa jika terjadi tabrakan.

Label yang dicadangkan Grafana dapat digunakan dengan cara yang sama seperti label yang dikonfigurasi secara manual. Daftar label cadangan yang tersedia saat ini adalah:


| Label | Deskripsi | 
| --- | --- | 
| grafana\$1folder | Judul folder yang berisi peringatan. | 

# Templating label dan anotasi
<a name="v10-alerting-overview-labels-templating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menggunakan template untuk menyertakan data dari kueri dan ekspresi dalam label dan anotasi. Misalnya, Anda mungkin ingin menyetel label tingkat keparahan untuk peringatan berdasarkan nilai kueri, atau menggunakan label instance dari kueri dalam anotasi ringkasan sehingga Anda tahu server mana yang mengalami penggunaan CPU tinggi.

Semua template harus ditulis dalam [teks/template](https://pkg.go.dev/text/template). Terlepas dari apakah Anda membuat template label atau anotasi, Anda harus menulis setiap templat sebaris di dalam label atau anotasi yang sedang Anda templating. Ini berarti Anda tidak dapat berbagi templat antara label dan anotasi, dan sebagai gantinya Anda harus menyalin templat di mana pun Anda ingin menggunakannya.

Setiap template dievaluasi setiap kali aturan peringatan dievaluasi, dan dievaluasi untuk setiap peringatan secara terpisah. Misalnya, jika aturan peringatan Anda memiliki anotasi ringkasan templat, dan aturan peringatan memiliki 10 peringatan pengaktifan, maka templat akan dieksekusi 10 kali, sekali untuk setiap peringatan. Anda harus mencoba untuk menghindari melakukan perhitungan mahal di template Anda sebanyak mungkin.

## Contoh
<a name="v10-alerting-overview-labels-templating-examples"></a>

Daripada menulis tutorial lengkap tentang text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template melihat dokumentasi [teks/template](https://pkg.go.dev/text/template).

**Cetak semua label, dipisahkan koma**

Untuk mencetak semua label, dipisahkan koma, cetak `$labels` variabel:

```
{{ $labels }}
```

Misalnya, diberi peringatan dengan label`alertname=High CPU usage`, `grafana_folder=CPU alerts` dan`instance=server1`, ini akan mencetak: 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Cetak semua label, satu per baris**

Untuk mencetak semua label, satu per baris, gunakan a `range` untuk mengulangi setiap key/value pasangan dan mencetaknya satu per satu. Di sini `$k` mengacu pada nama dan `$v` mengacu pada nilai label saat ini: 

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

Misalnya, diberi peringatan dengan label`alertname=High CPU usage`, `grafana_folder=CPU alerts` dan`instance=server1`, ini akan mencetak:

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Cetak label individual**

Untuk mencetak label individual, gunakan `index` fungsi dengan `$labels` variabel: 

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

Misalnya, diberi peringatan dengan label`instance=server1`, ini akan mencetak:

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Lihat [variabel \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) untuk informasi lebih lanjut.

**Mencetak nilai kueri**

Untuk mencetak nilai kueri instan, Anda dapat mencetak ID Ref menggunakan `index` fungsi dan `$values` variabel: 

```
{{ index $values "A" }}
```

Misalnya, diberikan kueri instan yang mengembalikan nilai 81.2345, ini akan mencetak:

```
81.2345
```

Untuk mencetak nilai kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan. Anda kemudian dapat mencetak hasil ekspresi pengurangan dengan menggunakan ID Ref sebagai gantinya. Misalnya, jika ekspresi reduksi mengambil rata-rata A dan memiliki ID Ref B, Anda akan menulis: 

```
{{ index $values "B" }}
```

**Cetak nilai manusiawi dari kueri**

Untuk mencetak nilai manusiawi dari kueri instan, gunakan `humanize` fungsi:

```
{{ humanize (index $values "A").Value }}
```

Misalnya, diberikan kueri instan yang mengembalikan nilai 81.2345, ini akan mencetak: 

```
81.234
```

Untuk mencetak nilai manusiawi dari kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan. Anda kemudian dapat mencetak hasil ekspresi pengurangan dengan menggunakan ID Ref sebagai gantinya. Misalnya, jika ekspresi reduksi mengambil rata-rata A dan memiliki ID Ref B, Anda akan menulis: 

```
{{ humanize (index $values "B").Value }}
```

**Cetak nilai kueri sebagai persentase**

Untuk mencetak nilai kueri instan sebagai persentase, gunakan `humanizePercentage` fungsi:

```
{{ humanizePercentage (index $values "A").Value }}
```

Fungsi ini mengharapkan nilai menjadi angka desimal antara 0 dan 1. Jika nilainya bukan angka desimal antara 0 dan 100, Anda dapat membaginya dengan 100 baik dalam kueri Anda atau menggunakan ekspresi matematika. Jika kueri adalah kueri rentang, Anda harus terlebih dahulu menguranginya dari deret waktu menjadi vektor instan dengan ekspresi pengurangan.

**Tetapkan tingkat keparahan dari nilai kueri**

Untuk menetapkan label keparahan dari nilai kueri gunakan pernyataan if dan fungsi lebih besar dari perbandingan. Pastikan untuk menggunakan desimal (`80.0`,, `50.0``0.0`, dll) saat melakukan perbandingan terhadap `$values` as text/template tidak mendukung pemaksaan tipe. Anda dapat menemukan daftar semua fungsi perbandingan yang didukung [di sini](https://pkg.go.dev/text/template#hdr-Functions).

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**Cetak semua label dari kondisi klasik**

Anda tidak dapat menggunakan `$labels` untuk mencetak label dari kueri jika Anda menggunakan kondisi klasik, dan harus menggunakannya `$values` sebagai gantinya. Alasan untuk ini adalah kondisi klasik buang label ini untuk menegakkan perilaku uni-dimensi (paling banyak satu peringatan per aturan peringatan). Jika kondisi klasik tidak membuang label ini, maka kueri yang mengembalikan banyak deret waktu akan menyebabkan peringatan menutup antara penembakan dan diselesaikan terus-menerus karena label akan berubah setiap kali aturan peringatan dievaluasi.

Sebagai gantinya, `$values` variabel berisi nilai yang dikurangi dari semua deret waktu untuk semua kondisi yang menyala. Misalnya, jika Anda memiliki aturan peringatan dengan kueri A yang mengembalikan dua deret waktu, dan kondisi klasik B dengan dua kondisi, maka `$values` akan berisi`B0`,`B1`, `B2` dan`B3`. Jika kondisi klasik B hanya memiliki satu kondisi, maka `$values` akan berisi just `B0` dan`B1`.

Untuk mencetak semua label dari semua deret waktu pengaktifan, gunakan templat berikut (pastikan untuk mengganti `B` dalam ekspresi reguler dengan ID Ref dari kondisi klasik jika berbeda): 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

Misalnya, kondisi klasik untuk dua deret waktu yang melebihi satu kondisi akan dicetak: 

```
B0: instance=server1
B1: instance=server2
```

Jika kondisi klasik memiliki dua kondisi atau lebih, dan deret waktu melebihi beberapa kondisi pada saat yang sama, maka labelnya akan diduplikasi untuk setiap kondisi yang terlampaui: 

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

Jika Anda perlu mencetak label unik, Anda harus mempertimbangkan untuk mengubah aturan peringatan Anda dari uni-dimensi ke multi-dimensi sebagai gantinya. Anda dapat melakukan ini dengan mengganti kondisi klasik Anda dengan ekspresi reduce dan matematika.

**Cetak semua nilai dari kondisi klasik**

Untuk mencetak semua nilai dari kondisi klasik, ambil contoh sebelumnya dan ganti `$v.Labels` dengan`$v.Value`: 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

Misalnya, kondisi klasik untuk dua deret waktu yang melebihi satu kondisi akan dicetak: 

```
B0: 81.2345
B1: 84.5678
```

Jika kondisi klasik memiliki dua atau lebih kondisi, dan deret waktu melebihi beberapa kondisi pada saat yang sama, maka `$values` akan berisi nilai-nilai semua kondisi: 

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## Variabel
<a name="v10-alerting-overview-labels-templating-variables"></a>

Variabel berikut tersedia untuk Anda saat membuat template label dan anotasi:

### Variabel label
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

`$labels`Variabel berisi semua label dari kueri. Misalnya, Anda memiliki kueri yang mengembalikan penggunaan CPU untuk semua server Anda, dan Anda memiliki aturan peringatan yang diaktifkan ketika salah satu server Anda telah melebihi 80% penggunaan CPU selama 5 menit terakhir. Anda ingin menambahkan anotasi ringkasan ke peringatan yang memberi tahu Anda server mana yang mengalami penggunaan CPU tinggi. Dengan `$labels` variabel Anda dapat menulis template yang mencetak kalimat yang dapat dibaca manusia seperti: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**catatan**  
Jika Anda menggunakan kondisi klasik maka tidak `$labels` akan berisi label apa pun dari kueri. Kondisi klasik membuang label ini untuk menegakkan perilaku uni-dimensi (paling banyak satu peringatan per aturan peringatan). Jika Anda ingin menggunakan label dari kueri di template Anda, ikuti contoh *Print all labels sebelumnya dari kondisi klasik*.

### Variabel nilai
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

`$value`Variabel adalah string yang berisi label dan nilai dari semua kueri instan; ambang batas, pengurangan dan ekspresi matematika, dan kondisi klasik dalam aturan peringatan. Ini tidak berisi hasil kueri rentang, karena ini dapat kembali dari 10 hingga 10.000 baris atau metrik. Jika ya, untuk kueri yang sangat besar, satu peringatan dapat menggunakan memori 10 detik dan Grafana akan kehabisan memori dengan sangat cepat. MBs 

Untuk mencetak `$value` variabel dalam ringkasan Anda akan menulis sesuatu seperti ini: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

Dan itu akan terlihat seperti ini:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

Di sini `var='A'` mengacu pada kueri instan dengan Ref ID A, `labels={instance=instance1}` mengacu pada label, dan `value=81.234` mengacu pada penggunaan CPU rata-rata selama 5 menit terakhir.

Jika Anda ingin mencetak hanya beberapa string alih-alih string penuh maka gunakan `$values` variabel. Ini berisi informasi yang sama seperti`$value`, tetapi dalam tabel terstruktur, dan jauh lebih mudah digunakan kemudian menulis ekspresi reguler untuk mencocokkan hanya teks yang Anda inginkan.

### Variabel nilai
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

`$values`Variabel adalah tabel yang berisi label dan nilai floating point dari semua kueri dan ekspresi instan, diindeks oleh Ref mereka. IDs

Untuk mencetak nilai kueri instan dengan Ref ID A:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

Misalnya, diberi peringatan dengan label `instance=server1` dan kueri instan dengan nilai`81.2345`, ini akan mencetak:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Jika kueri di Ref ID A adalah kueri rentang daripada kueri instan, tambahkan ekspresi pengurangan dengan Ref ID B dan ganti `(index $values "A")` dengan: `(index $values "B")`

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## Fungsi
<a name="v10-alerting-overview-labels-templating-functions"></a>

Fungsi-fungsi berikut tersedia untuk Anda saat membuat template label dan anotasi:

**args**

`args`Fungsi menerjemahkan daftar objek ke peta dengan kunci arg0, arg1 dll. Ini dimaksudkan untuk memungkinkan beberapa argumen diteruskan ke template.

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL eksternal**

`externalURL`Fungsi mengembalikan URL eksternal dari server Grafana.

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

`graphLink`Fungsi mengembalikan path ke tampilan grafis [Jelajahi di Grafana versi 10](v10-explore.md) untuk ekspresi yang diberikan dan sumber data.

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**memanusiakan**

`humanize`Fungsi memanusiakan angka desimal.

```
{{ humanize 1000.0 }}
```

```
1k
```

**manusia1024**

`humanize1024`Karya-karya yang mirip dengan `humanize` tetapi menggunakan 1024 sebagai basis daripada 1000.

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**HumanizeUrasi**

`humanizeDuration`Fungsi memanusiakan durasi dalam hitungan detik.

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**HumanizePersentase**

`humanizePercentage`Fungsi memanusiakan nilai rasio terhadap persentase.

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**HumanizeTimestamp**

`humanizeTimestamp`Fungsi ini memanusiakan stempel waktu Unix.

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**pertandingan**

`match`Fungsi ini cocok dengan teks terhadap pola ekspresi reguler.

```
{{ match "a.*" "abc" }}
```

```
true
```

**PathPrefix**

`pathPrefix`Fungsi mengembalikan jalur server Grafana.

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

`tableLink`Fungsi mengembalikan path ke tampilan tabular [Jelajahi di Grafana versi 10](v10-explore.md) untuk ekspresi yang diberikan dan sumber data.

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**judul**

`title`Fungsi ini mengkapitalisasi karakter pertama dari setiap kata.

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**ToLower**

`toLower`Fungsi mengembalikan semua teks dalam huruf kecil.

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**TouPper**

`toUpper`Fungsi mengembalikan semua teks dalam huruf besar.

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

`reReplaceAll`Fungsi menggantikan teks yang cocok dengan ekspresi reguler.

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Tentang aturan peringatan
<a name="v10-alerting-explore-rules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah instance peringatan akan diaktifkan. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan durasi di mana kondisi harus dipenuhi untuk mulai menembak.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, *kondisi* menetapkan ambang batas yang harus dipenuhi atau dilampaui data untuk membuat peringatan.

*Interval* menentukan seberapa sering aturan peringatan dievaluasi. *Durasi*, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan peringatan juga dapat menentukan perilaku peringatan tanpa adanya data.

**Topics**
+ [Jenis aturan peringatan](v10-alerting-explore-rules-types.md)
+ [Aturan perekaman](v10-alerting-explore-rule-recording.md)
+ [Pertanyaan dan kondisi](v10-alerting-explore-rules-queries.md)
+ [Contoh peringatan](v10-alerting-rules-instances.md)
+ [Ruang nama, folder, dan grup](v10-alerting-rules-grouping.md)
+ [Evaluasi aturan peringatan](v10-alerting-rules-evaluation.md)
+ [Keadaan dan kesehatan aturan peringatan](v10-alerting-explore-state.md)
+ [Templating pemberitahuan](v10-alerting-rules-notification-templates.md)

# Jenis aturan peringatan
<a name="v10-alerting-explore-rules-types"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana mendukung beberapa jenis aturan peringatan. Pelajari lebih lanjut tentang masing-masing jenis aturan peringatan, cara kerjanya, dan putuskan mana yang terbaik untuk kasus penggunaan Anda.

## Aturan terkelola Grafana
<a name="v10-alerting-explore-rule-types-grafana"></a>

Aturan terkelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data apa pun yang ada.

Selain mendukung beberapa sumber data, Anda dapat menambahkan [ekspresi](v10-panels-query-xform-expressions.md) untuk mengubah data Anda dan menyatakan kondisi peringatan.

Di Grafana, peringatan terkelola:
+ Aturan peringatan dibuat dalam Grafana, berdasarkan satu atau beberapa sumber data.
+ Aturan peringatan dievaluasi oleh mesin evaluasi aturan peringatan dari dalam Grafana.
+ Peringatan dikirimkan menggunakan Grafana Alertmanager internal.

**catatan**  
Anda juga dapat mengonfigurasi peringatan yang akan dikirimkan menggunakan Alertmanager eksternal, atau menggunakan Alertmanager internal dan eksternal. Untuk informasi selengkapnya, lihat [Menambahkan alertmanager eksternal](v10-alerting-setup-alertmanager.md).

## Aturan terkelola sumber data
<a name="v10-alerting-explore-rule-types-datasource"></a>

Untuk membuat aturan peringatan terkelola sumber data, Anda harus memiliki sumber data Prometheus atau Loki yang kompatibel. Anda dapat memeriksa apakah sumber data Anda mendukung pembuatan aturan melalui Grafana dengan menguji sumber data dan mengamati apakah Ruler API didukung.

Di sumber data, peringatan terkelola:
+ Aturan peringatan dibuat dan disimpan dalam sumber data itu sendiri.
+ Aturan peringatan hanya dapat dibuat berdasarkan data Prometheus.
+ Evaluasi dan pengiriman aturan peringatan didistribusikan di beberapa node untuk ketersediaan tinggi dan toleransi kesalahan.

## Pilih jenis aturan peringatan
<a name="v10-alerting-explore-rule-types-choose"></a>

Saat memilih jenis aturan peringatan yang akan digunakan, pertimbangkan perbandingan berikut antara aturan peringatan terkelola Grafana dan aturan peringatan terkelola sumber data.


| Fitur | Aturan peringatan yang dikelola Grafana | Aturan peringatan yang dikelola Loki/MIMIR | 
| --- | --- | --- | 
| Buat aturan peringatan berdasarkan data dari salah satu sumber data kami yang didukung | Ya | Tidak: Anda hanya dapat membuat aturan peringatan yang didasarkan pada data Prometheus. Sumber data harus mengaktifkan Ruler API.  | 
| Mencampur dan mencocokkan sumber data | Ya | Tidak | 
| Termasuk dukungan untuk aturan perekaman | Tidak | Ya | 
| Tambahkan ekspresi untuk mengubah data Anda dan mengatur kondisi peringatan | Ya | Tidak | 
| Gunakan gambar dalam notifikasi peringatan | Ya | Tidak | 
| Penskalaan | Lebih intensif sumber daya, tergantung pada database, dan cenderung menderita kesalahan sementara. Mereka hanya menskalakan secara vertikal. | Simpan aturan peringatan dalam sumber data itu sendiri dan izinkan penskalaan “tak terbatas”. Buat dan kirim pemberitahuan peringatan dari lokasi data Anda. | 
| Evaluasi dan pengiriman aturan peringatan | Evaluasi dan pengiriman aturan peringatan dilakukan dari dalam Grafana, menggunakan Alertmanager eksternal; atau keduanya. | Evaluasi aturan peringatan dan pengiriman peringatan didistribusikan, artinya tidak ada satu titik kegagalan. | 

# Aturan perekaman
<a name="v10-alerting-explore-rule-recording"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Aturan perekaman hanya tersedia untuk sumber data Prometheus atau Loki yang kompatibel.*

Aturan perekaman memungkinkan Anda untuk menghitung terlebih dahulu ekspresi yang sering dibutuhkan atau mahal secara komputasi dan menyimpan hasilnya sebagai rangkaian waktu baru. Ini berguna jika Anda ingin menjalankan peringatan pada data agregat atau jika Anda memiliki dasbor yang menanyakan ekspresi mahal secara komputasi berulang kali.

Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

Baca lebih lanjut tentang [aturan perekaman](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) di Prometheus.

# Pertanyaan dan kondisi
<a name="v10-alerting-explore-rules-queries"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Di Grafana, kueri memainkan peran penting dalam mengambil dan mengubah data dari sumber data yang didukung, yang mencakup database seperti MySQL dan PostgreSQL, database deret waktu seperti Prometheus, InfluxDB dan Graphite, dan layanan seperti, Amazon, Azure Monitor dan Google Cloud Monitoring. OpenSearch CloudWatch

Untuk informasi selengkapnya tentang sumber data yang didukung, lihat[Sumber data dan peringatan Grafana](v10-alerting-overview-datasources.md).

Proses mengeksekusi query melibatkan mendefinisikan sumber data, menentukan data yang diinginkan untuk diambil, dan menerapkan filter atau transformasi yang relevan. Bahasa kueri atau sintaks khusus untuk sumber data yang dipilih digunakan untuk membangun kueri ini.

Dalam Peringatan, Anda menentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

Aturan peringatan terdiri dari satu atau beberapa kueri dan ekspresi yang memilih data yang ingin Anda ukur.

Untuk informasi selengkapnya tentang kueri dan ekspresi, lihat[Kueri dan transformasi data](v10-panels-query-xform.md).

## Kueri sumber data
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Kueri di Grafana dapat diterapkan dengan berbagai cara, tergantung pada sumber data dan bahasa kueri yang digunakan. Setiap editor kueri sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Beberapa jenis komponen kueri yang umum meliputi: 

**Bidang metrik atau data** — Tentukan metrik atau bidang data tertentu yang ingin Anda ambil, seperti penggunaan CPU, lalu lintas jaringan, atau pembacaan sensor.

**Rentang waktu** - Tentukan rentang waktu yang ingin Anda ambil data, seperti jam terakhir, hari tertentu, atau rentang waktu khusus.

**Filter** — Terapkan filter untuk mempersempit data berdasarkan kriteria tertentu, seperti memfilter data dengan tag, host, atau aplikasi tertentu.

**Agregasi** — Lakukan agregasi pada data untuk menghitung metrik seperti rata-rata, jumlah, atau hitungan selama periode waktu tertentu.

**Pengelompokan** — Kelompokkan data berdasarkan dimensi atau tag tertentu untuk membuat tampilan atau rincian gabungan.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia [di sini](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) di forum Grafana Labs.

## Kueri ekspresi
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

Dalam Grafana, ekspresi digunakan untuk melakukan perhitungan, transformasi, atau agregasi pada data kueri sumber data. Ini memungkinkan Anda untuk membuat metrik khusus atau memodifikasi metrik yang ada berdasarkan operasi matematika, fungsi, atau ekspresi logis.

Dengan memanfaatkan kueri ekspresi, pengguna dapat melakukan tugas-tugas seperti menghitung persentase perubahan antara dua nilai, menerapkan fungsi seperti fungsi logaritmik atau trigonometri, menggabungkan data pada rentang waktu atau dimensi tertentu, dan menerapkan logika bersyarat untuk menangani skenario yang berbeda.

Di Peringatan, Anda hanya dapat menggunakan ekspresi untuk aturan peringatan yang dikelola Grafana. Untuk setiap ekspresi, Anda dapat memilih dari ekspresi matematika, kurangi, dan sampel ulang. Ini disebut aturan multi-dimensi, karena mereka menghasilkan peringatan terpisah untuk setiap seri.

Anda juga dapat menggunakan kondisi klasik, yang membuat aturan peringatan yang memicu peringatan tunggal ketika kondisinya terpenuhi. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

**catatan**  
Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

**Mengurangi**

Mengagregat nilai deret waktu dalam rentang waktu yang dipilih menjadi satu nilai.

**Matematika**

Melakukan matematika bentuk bebas functions/operations pada deret waktu dan data angka. Dapat digunakan untuk memproses data deret waktu atau untuk menentukan kondisi peringatan untuk data angka.

**Sampel ulang**

Menyelaraskan kembali rentang waktu ke set stempel waktu baru, ini berguna saat membandingkan data deret waktu dari sumber data yang berbeda di mana stempel waktu tidak akan sejajar.

**Ambang**

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi ambang batas.

Ekspresi ambang memungkinkan Anda membandingkan dua nilai tunggal. Ia kembali `0` ketika kondisinya salah dan `1` jika kondisinya benar. Fungsi ambang berikut tersedia:
+ Di atas (x> y)
+ Di bawah ini (x < y)
+ Berada dalam jangkauan (x> y1 DAN x < y2)
+ Berada di luar jangkauan (x < y1 AND x > y2)

**Kondisi klasik**

Memeriksa apakah ada data deret waktu yang cocok dengan kondisi peringatan.

**catatan**  
Kueri ekspresi kondisi klasik selalu menghasilkan satu instance peringatan saja, tidak peduli berapa banyak deret waktu yang memenuhi kondisi tersebut. Kondisi klasik ada terutama untuk alasan kompatibilitas dan harus dihindari jika memungkinkan.

## Agregasi
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana Alerting menyediakan fungsi agregasi berikut untuk memungkinkan Anda menyempurnakan kueri lebih lanjut.

Fungsi-fungsi ini hanya tersedia untuk ekspresi **kondisi **Reduce** dan Classic**.


| Fungsi | Ekspresi | Apa yang dilakukannya | 
| --- | --- | --- | 
| rata-rata | Kurangi/Klasik | Menampilkan rata-rata nilai | 
| min | Kurangi/Klasik | Menampilkan nilai terendah | 
| max | Kurangi/Klasik | Menampilkan nilai tertinggi | 
| sum | Kurangi/Klasik | Menampilkan jumlah semua nilai | 
| count | Kurangi/Klasik | Menghitung jumlah nilai dalam hasil | 
| last | Kurangi/Klasik | Menampilkan nilai terakhir | 
| median | Kurangi/Klasik | Menampilkan nilai median | 
| diff | Klasik | Menampilkan perbedaan antara nilai terbaru dan terlama | 
| diff\$1abs | Klasik | Menampilkan nilai absolut diff | 
| percent\$1diff | Klasik | Menampilkan nilai persentase perbedaan antara nilai terbaru dan tertua | 
| percent\$1diff\$1abs | Klasik | Menampilkan nilai absolut dari percent\$1diff | 
| count\$1non\$1null | Klasik | Menampilkan hitungan nilai dalam kumpulan hasil yang tidak null | 

## Kondisi peringatan
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

Kondisi peringatan adalah kueri atau ekspresi yang menentukan apakah peringatan akan diaktifkan atau tidak tergantung pada nilai yang dihasilkannya. Hanya ada satu kondisi yang akan menentukan pemicu peringatan.

Setelah Anda menentukan and/or ekspresi kueri Anda, pilih salah satunya sebagai kondisi aturan peringatan.

Ketika data kueri memenuhi kondisi yang ditentukan, Grafana memicu peringatan terkait, yang dapat dikonfigurasi untuk mengirim pemberitahuan melalui berbagai saluran seperti email, Slack, atau. PagerDuty Pemberitahuan memberi tahu Anda tentang kondisi yang dipenuhi, memungkinkan Anda untuk mengambil tindakan yang sesuai atau menyelidiki masalah yang mendasarinya.

Secara default, ekspresi terakhir yang ditambahkan digunakan sebagai kondisi peringatan.

## Ambang pemulihan
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

Untuk mengurangi kebisingan peringatan mengepak, Anda dapat mengatur ambang pemulihan yang berbeda dengan ambang peringatan.

Peringatan mengepak terjadi ketika metrik melayang di sekitar kondisi ambang peringatan dan dapat menyebabkan perubahan status yang sering, mengakibatkan terlalu banyak notifikasi yang dihasilkan.

Aturan peringatan yang dikelola Grafana dievaluasi untuk interval waktu tertentu. Selama setiap evaluasi, hasil kueri diperiksa terhadap ambang batas yang ditetapkan dalam aturan peringatan. Jika nilai metrik berada di atas ambang batas, aturan peringatan akan diaktifkan dan pemberitahuan dikirim. Ketika nilai berada di bawah ambang batas dan ada peringatan aktif untuk metrik ini, peringatan diselesaikan, dan pemberitahuan lain dikirim.

Mungkin sulit untuk membuat aturan peringatan untuk metrik yang bising. Yaitu, ketika nilai metrik terus berjalan di atas dan di bawah ambang batas. Ini disebut mengepak dan menghasilkan serangkaian pemberitahuan penembakan - diselesaikan - penembakan dan riwayat status peringatan yang bising.

Misalnya, jika Anda memiliki peringatan untuk latensi dengan ambang 1000ms dan jumlahnya berfluktuasi sekitar 1000 (katakanlah 980 -> 1010 -> 990 -> 1020, dan seterusnya) maka masing-masing akan memicu pemberitahuan.

Untuk mengatasi masalah ini, Anda dapat menetapkan ambang pemulihan (kustom), yang pada dasarnya berarti memiliki dua ambang, bukan satu. Peringatan dipicu ketika ambang pertama dilintasi dan diselesaikan hanya ketika ambang kedua dilintasi.

Misalnya, Anda dapat menetapkan ambang 1000ms dan ambang pemulihan 900 ms. Dengan cara ini, aturan peringatan hanya akan berhenti menembak ketika berada di bawah 900 ms dan kepakan berkurang.

# Contoh peringatan
<a name="v10-alerting-rules-instances"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Peringatan terkelola Grafana mendukung peringatan multi-dimensi. Setiap aturan peringatan dapat membuat beberapa instance peringatan. Ini sangat kuat jika Anda mengamati beberapa seri dalam satu ekspresi.

Pertimbangkan ekspresi PromQL berikut:

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Aturan yang menggunakan ekspresi ini akan membuat instance peringatan sebanyak jumlah yang CPUs kita amati setelah evaluasi pertama, memungkinkan satu aturan untuk melaporkan status setiap CPU.

# Ruang nama, folder, dan grup
<a name="v10-alerting-rules-grouping"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Peringatan dapat diatur menggunakan folder untuk aturan dan ruang nama yang dikelola Grafana untuk aturan dan nama grup Mimir, Loki, atau Prometheus.

**Ruang nama dan folder**

Saat membuat aturan yang dikelola Grafana, folder dapat digunakan untuk melakukan kontrol akses dan memberikan atau menolak akses ke semua aturan dalam folder tertentu.

Namespace berisi satu atau lebih grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama dan grup aturan Grafana Mimi atau Loki, dan mengedit interval evaluasi grup.

**Grup**

Aturan dalam grup dijalankan secara berurutan pada interval reguler, yang berarti tidak ada aturan yang akan dievaluasi pada saat yang sama, dan dalam urutan penampilan. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama aturan Grafana Mimir atau Loki atau ruang nama dan grup aturan Loki, dan mengedit interval evaluasi grup.

**Tip**  
Jika Anda ingin aturan dievaluasi secara bersamaan dan dengan interval yang berbeda, pertimbangkan untuk menyimpannya dalam kelompok yang berbeda.

**catatan**  
Aturan peringatan terkelola Grafana dievaluasi secara bersamaan, bukan secara berurutan.

# Evaluasi aturan peringatan
<a name="v10-alerting-rules-evaluation"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

Untuk melakukan ini, Anda perlu memastikan bahwa aturan peringatan Anda berada di grup evaluasi yang tepat dan menetapkan waktu periode tertunda yang paling sesuai untuk kasus penggunaan Anda.

## Kelompok evaluasi
<a name="v10-alerting-rules-evaluation-group"></a>

Setiap aturan peringatan adalah bagian dari kelompok evaluasi. Setiap kelompok evaluasi berisi interval evaluasi yang menentukan seberapa sering aturan peringatan diperiksa.

Aturan peringatan **terkelola sumber data** dalam grup yang sama dievaluasi satu demi satu, sementara aturan peringatan di grup yang berbeda dapat dievaluasi secara bersamaan. Fitur ini sangat berguna ketika Anda ingin memastikan bahwa aturan perekaman dievaluasi sebelum aturan peringatan apa pun.

Aturan peringatan yang **dikelola Grafana** dievaluasi pada saat yang sama, terlepas dari grup aturan peringatan. Interval evaluasi default diatur pada 10 detik, yang berarti bahwa aturan peringatan yang dikelola Grafana dievaluasi setiap 10 detik ke jendela 10 detik terdekat pada jam, misalnya, 10:00:00, 10:00:10, 10:00:20, dan seterusnya. Anda juga dapat mengonfigurasi interval evaluasi Anda sendiri, jika diperlukan.

**catatan**  
Grup evaluasi dan pengelompokan peringatan dalam kebijakan notifikasi adalah dua hal yang terpisah. Pengelompokan dalam kebijakan notifikasi memungkinkan beberapa lansiran yang berbagi label yang sama dikirim dalam pesan waktu yang sama.

## Periode tertunda
<a name="v10-alerting-rules-evaluation-pending-period"></a>

Dengan menetapkan periode tertunda, Anda dapat menghindari peringatan yang tidak perlu untuk masalah sementara.

Dalam periode tertunda, Anda memilih periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

**Contoh**

Bayangkan Anda memiliki interval evaluasi aturan peringatan yang ditetapkan setiap 30 detik dan periode tertunda hingga 90 detik.

Evaluasi akan terjadi sebagai berikut:

[00:30] Evaluasi pertama - kondisi tidak terpenuhi.

[01:00] Evaluasi kedua - kondisi dilanggar. Penghitung tertunda dimulai. **Peringatan mulai tertunda.**

[01:30] Evaluasi ketiga - kondisi dilanggar. Penghitung tertunda = 30-an. **Status tertunda.**

[02:00] Evaluasi keempat - kondisi dilanggar. Penghitung tertunda = 60an **Status tertunda.**

[02:30] Evaluasi kelima - kondisi dilanggar. Penghitung tertunda = 90-an. **Peringatan mulai menembak**

Jika aturan peringatan memiliki kondisi yang perlu dilanggar untuk jangka waktu tertentu sebelum mengambil tindakan, maka statusnya berubah sebagai berikut:
+ Ketika kondisi pertama kali dilanggar, aturan masuk ke status “tertunda”.
+ Aturan tetap dalam keadaan “tertunda” sampai kondisi telah dilanggar untuk jumlah waktu yang diperlukan - periode tertunda.
+ Setelah waktu yang diperlukan berlalu, aturan masuk ke keadaan “menembak”.
+ Jika kondisi tidak lagi rusak selama periode tertunda, aturan kembali ke keadaan normal.

**catatan**  
Jika Anda ingin melewati status tertunda, Anda cukup mengatur periode tertunda ke 0. Ini secara efektif melewatkan periode tertunda dan aturan peringatan Anda akan mulai menyala segera setelah kondisi dilanggar.

Saat aturan peringatan diaktifkan, instance peringatan akan dihasilkan, yang kemudian dikirim ke Alertmanager.

# Keadaan dan kesehatan aturan peringatan
<a name="v10-alerting-explore-state"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Keadaan dan kesehatan aturan peringatan membantu Anda memahami beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen utama: *status aturan peringatan, status* *instance peringatan*, dan *kesehatan aturan peringatan*. Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Status aturan peringatan**

Aturan peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam `Firing` keadaan `Pending` atau. | 
| Tertunda | Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Pending`. | 
| Menembak | Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Firing`. | 

**catatan**  
Peringatan akan bertransisi pertama ke `pending` dan kemudian`firing`, sehingga akan membutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

**Status contoh peringatan**

Instance peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Keadaan peringatan yang tidak menembak atau tertunda, semuanya berfungsi dengan benar. | 
| Tertunda | Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi. | 
| Peringatan | Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi. | 
| NoData | Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi. | 
| Kesalahan | Kesalahan yang terjadi saat mencoba mengevaluasi aturan peringatan. | 

**Pertahankan status terakhir**

Aturan peringatan dapat dikonfigurasi untuk mempertahankan status terakhir saat `NoData` atau `Error` status ditemui. Ini akan mencegah peringatan dari penembakan, dan dari penyelesaian dan penembakan kembali. Sama seperti evaluasi normal, aturan peringatan akan bertransisi dari `Pending` ke `Firing` setelah periode tertunda telah berlalu.

**Peringatan aturan kesehatan**

Aturan peringatan dapat memiliki satu status kesehatan berikut:


| Status | Deskripsi | 
| --- | --- | 
| Oke | Tidak ada kesalahan saat mengevaluasi aturan peringatan. | 
| Kesalahan | Terjadi kesalahan saat mengevaluasi aturan peringatan. | 
| NoData | Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan. | 

**Peringatan khusus untuk `NoData` dan `Error`**

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, Grafana Alerting akan menghasilkan instance peringatan yang memiliki label tambahan berikut:


| Label | Deskripsi | 
| --- | --- | 
| nama peringatan | Baik `DatasourceNoData` atau `DatasourceError` tergantung pada negara. | 
| datasource\$1uid | UID dari sumber data yang menyebabkan negara. | 

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa dengan menambahkan keheningan, rute ke titik kontak, dan sebagainya.

# Templating pemberitahuan
<a name="v10-alerting-rules-notification-templates"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pemberitahuan yang dikirim melalui titik kontak dibuat menggunakan templat notifikasi. Template default Grafana didasarkan pada [sistem template Go di mana beberapa bidang dievaluasi sebagai teks, sementara yang lain dievaluasi sebagai HTML (yang dapat memengaruhi pelolosan](https://golang.org/pkg/text/template)).

Template default [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) adalah referensi yang berguna untuk template kustom.

Karena sebagian besar bidang titik kontak dapat di-template, Anda dapat membuat templat khusus yang dapat digunakan kembali dan menggunakannya di beberapa titik kontak. Untuk mempelajari notifikasi kustom menggunakan templat, lihat[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

**Template bersarang**

Anda dapat menyematkan template dalam template lain.

Misalnya, Anda dapat menentukan fragmen template menggunakan `define` kata kunci.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Anda kemudian dapat menyematkan template kustom dalam fragmen ini menggunakan kata kunci. `template` Contoh:

```
Alert summary:
{{ template "mytemplate" . }}
```

Anda dapat menggunakan salah satu opsi templat bawaan berikut untuk menyematkan templat khusus.


| Nama | Catatan | 
| --- | --- | 
| `default.title` | Menampilkan informasi status tingkat tinggi. | 
| `default.message` | Menyediakan ringkasan pemformatan dan peringatan yang diselesaikan. | 
| `teams.default.message` | Mirip dengan`default.messsage`, diformat untuk Microsoft Teams. | 

**HTML dalam template notifikasi**

HTML dalam peringatan template notifikasi lolos. Kami tidak mendukung rendering HTML dalam notifikasi yang dihasilkan.

Beberapa notifier mendukung metode alternatif untuk mengubah tampilan dan nuansa notifikasi yang dihasilkan. Misalnya, Grafana menginstal template dasar untuk memperingatkan email. `<grafana-install-dir>/public/emails/ng_alert_notification.html` Anda dapat mengedit file ini untuk mengubah tampilan semua email peringatan.

# Pengelola Peringatan
<a name="v10-alerting-explore-alertmanager"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Alertmanager memungkinkan Anda mengelola dan merespons peringatan dengan cepat dan efisien. Ini menerima peringatan, menangani mutasi, penghambatan, pengelompokan, dan perutean dengan mengirimkan pemberitahuan melalui saluran pilihan Anda, misalnya, email atau Slack.

Di Grafana, Anda dapat menggunakan Grafana Alertmanager atau Alertmanager eksternal. Anda juga dapat menjalankan beberapa pengelola peringatan; keputusan Anda tergantung pada pengaturan Anda dan di mana peringatan Anda dihasilkan.

**Grafana Alertmanager**

Grafana Alertmanager adalah Alertmanager internal yang telah dikonfigurasi sebelumnya dan tersedia untuk dipilih secara default.

Grafana Alertmanager dapat menerima peringatan dari Grafana, tetapi tidak dapat menerima peringatan dari luar Grafana, misalnya, dari Mimir atau Loki.

**catatan**  
Aturan penghambatan tidak didukung di Grafana Alertmanager.

**Pengelola Peringatan Eksternal**

Jika Anda ingin menggunakan satu alertmanager untuk menerima semua peringatan Grafana, Loki, Mimir, dan Prometheus Anda, Anda dapat mengatur Grafana untuk menggunakan Alertmanager eksternal. Alertmanager eksternal ini dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

Berikut adalah dua contoh kapan Anda mungkin ingin mengonfigurasi manajer peringatan eksternal Anda sendiri dan mengirim peringatan Anda ke sana alih-alih Grafana Alertmanager:

1. Anda sudah memiliki pengelola peringatan di lokasi di infrastruktur Cloud Anda sendiri yang telah Anda atur dan masih ingin digunakan, karena Anda memiliki generator peringatan lain, seperti Prometheus.

1. Anda ingin menggunakan Prometheus on-premise dan Grafana yang dihosting untuk mengirim peringatan ke alertmanager yang sama yang berjalan di infrastruktur Cloud Anda.

Alertmanagers terlihat dari menu tarik-turun pada halaman Alerting Contact Points, dan Notification Policies.

Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.

# Titik kontak
<a name="v10-alerting-explore-contacts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Titik kontak berisi konfigurasi untuk mengirim pemberitahuan. Titik kontak adalah daftar integrasi, yang masing-masing mengirimkan pemberitahuan ke alamat email, layanan, atau URL tertentu. Titik kontak dapat memiliki beberapa integrasi dari jenis yang sama, atau kombinasi integrasi dari berbagai jenis. Misalnya, titik kontak dapat berisi integrasi Pagerduty; integrasi Amazon SNS dan Slack; atau integrasi Pagerduty, integrasi Slack, dan dua integrasi Amazon SNS. Anda juga dapat mengonfigurasi titik kontak tanpa integrasi; dalam hal ini tidak ada pemberitahuan yang dikirim.

Titik kontak tidak dapat mengirim pemberitahuan sampai telah ditambahkan ke kebijakan pemberitahuan. Kebijakan pemberitahuan hanya dapat mengirim peringatan ke satu titik kontak, tetapi titik kontak dapat ditambahkan ke sejumlah kebijakan pemberitahuan secara bersamaan. Ketika peringatan cocok dengan kebijakan notifikasi, peringatan dikirim ke titik kontak dalam kebijakan notifikasi tersebut, yang kemudian mengirimkan pemberitahuan ke setiap integrasi dalam konfigurasinya.

Titik kontak dapat dikonfigurasi untuk Grafana Alertmanager serta manajer peringatan eksternal.

Anda juga dapat menggunakan template notifikasi untuk menyesuaikan pesan notifikasi untuk jenis titik kontak.

**Jenis titik kontak yang didukung**

Tabel berikut mencantumkan jenis titik kontak yang didukung oleh Grafana.


| Nama | Tipe | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Tugas Pager | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

Untuk informasi lebih lanjut tentang titik kontak, lihat [Konfigurasikan titik kontak](v10-alerting-configure-contactpoints.md) dan[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

# Notifikasi
<a name="v10-alerting-explore-notifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Memilih bagaimana, kapan, dan di mana mengirim pemberitahuan peringatan Anda adalah bagian penting dari pengaturan sistem peringatan Anda. Keputusan ini akan berdampak langsung pada kemampuan Anda untuk menyelesaikan masalah dengan cepat dan tidak melewatkan sesuatu yang penting.

Sebagai langkah pertama, tentukan [titik kontak](v10-alerting-explore-contacts.md) Anda, yang menentukan ke mana harus mengirim pemberitahuan peringatan Anda. Titik kontak adalah satu set dari satu atau lebih integrasi yang digunakan untuk mengirimkan pemberitahuan. Tambahkan templat notifikasi ke titik kontak untuk digunakan kembali dan pesan yang konsisten di notifikasi Anda.

Selanjutnya, buat kebijakan notifikasi yang merupakan seperangkat aturan untuk di mana, kapan, dan bagaimana peringatan Anda diarahkan ke titik kontak. Dalam kebijakan pemberitahuan, Anda menentukan tempat mengirim pemberitahuan peringatan dengan memilih salah satu titik kontak yang Anda buat.

## Manajer Peringatan
<a name="v10-alerting-explore-notifications-alertmanager"></a>

Grafana menggunakan Alertmanagers untuk mengirim notifikasi untuk mengaktifkan dan menyelesaikan peringatan. [Grafana memiliki Alertmanager sendiri, disebut sebagai **Grafana** di antarmuka pengguna, tetapi juga mendukung pengiriman pemberitahuan dari Alertmanager lain juga, seperti Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Grafana Alertmanager menggunakan kebijakan notifikasi dan titik kontak untuk mengonfigurasi bagaimana dan di mana pemberitahuan dikirim; seberapa sering pemberitahuan harus dikirim; dan apakah semua peringatan harus dikirim dalam pemberitahuan yang sama, dikirim dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau sebagai pemberitahuan terpisah.

## Kebijakan pemberitahuan
<a name="v10-alerting-explore-notifications-policies"></a>

Kebijakan notifikasi mengontrol kapan dan di mana notifikasi dikirim. Kebijakan notifikasi dapat memilih untuk mengirim semua peringatan bersama-sama dalam pemberitahuan yang sama, mengirim peringatan dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau mengirim peringatan sebagai pemberitahuan terpisah. Anda dapat mengonfigurasi setiap kebijakan notifikasi untuk mengontrol seberapa sering pemberitahuan harus dikirim serta memiliki satu atau lebih waktu bisu untuk menghambat pemberitahuan pada waktu-waktu tertentu dalam sehari dan pada hari-hari tertentu dalam seminggu.

Kebijakan pemberitahuan diatur dalam struktur pohon di mana pada akar pohon ada kebijakan pemberitahuan yang disebut kebijakan default. Hanya ada satu kebijakan default dan kebijakan default tidak dapat dihapus.

Kebijakan perutean khusus adalah turunan dari kebijakan root dan dapat digunakan untuk mencocokkan semua peringatan atau subset peringatan berdasarkan sekumpulan label yang cocok. Kebijakan notifikasi cocok dengan peringatan ketika label yang cocok cocok dengan label dalam peringatan.

Kebijakan bersarang dapat memiliki kebijakan bersarangnya sendiri, yang memungkinkan pencocokan peringatan tambahan. Contoh kebijakan bersarang dapat mengirimkan peringatan infrastruktur ke tim Ops; sementara kebijakan anak mungkin mengirim peringatan prioritas tinggi ke Pagerduty dan peringatan prioritas rendah ke Slack.

Semua peringatan, terlepas dari labelnya, cocok dengan kebijakan default. Namun, ketika kebijakan default menerima peringatan, kebijakan tersebut akan melihat setiap kebijakan bersarang dan mengirimkan peringatan ke kebijakan bersarang pertama yang cocok dengan peringatan. Jika kebijakan bersarang memiliki kebijakan bersarang lebih lanjut, maka kebijakan tersebut dapat mencoba mencocokkan peringatan dengan salah satu kebijakan bersarangnya. Jika tidak ada kebijakan bersarang yang cocok dengan peringatan maka kebijakan itu sendiri adalah kebijakan yang cocok. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan peringatan, maka kebijakan defaultnya adalah kebijakan yang cocok.

Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat[Kebijakan pemberitahuan](v10-alerting-explore-notifications-policies-details.md).

## Template pemberitahuan
<a name="v10-alerting-explore-notifications-templating"></a>

Anda dapat menyesuaikan notifikasi dengan templat. Misalnya, template dapat digunakan untuk mengubah judul dan pesan notifikasi yang dikirim ke Slack.

Template tidak terbatas pada integrasi individu atau titik kontak, tetapi dapat digunakan dalam sejumlah integrasi di titik kontak yang sama dan bahkan integrasi di berbagai titik kontak. Misalnya, pengguna Grafana dapat membuat template yang disebut `custom_subject_or_title` dan menggunakannya untuk subjek templating di Pager Duty dan judul pesan Slack tanpa harus membuat dua templat terpisah.

Semua template notifikasi ditulis dalam [bahasa template Go](https://pkg.go.dev/text/template), dan berada di tab Titik kontak di halaman Peringatan.

Untuk informasi selengkapnya tentang menyesuaikan notifikasi, lihat[Sesuaikan notifikasi](v10-alerting-manage-notifications.md).

## Keheningan
<a name="v10-alerting-explore-notifications-silences"></a>

Anda dapat menggunakan keheningan untuk membisukan notifikasi dari satu atau beberapa aturan penembakan. Keheningan tidak menghentikan peringatan agar tidak ditembakkan atau diselesaikan, atau menyembunyikan peringatan penembakan di antarmuka pengguna. Keheningan berlangsung selama durasinya yang dapat dikonfigurasi dalam hitungan menit, jam, hari, bulan atau tahun.

Untuk informasi lebih rinci tentang menggunakan keheningan, lihat[Membungkam pemberitahuan peringatan](v10-alerting-silences.md).

# Kebijakan pemberitahuan
<a name="v10-alerting-explore-notifications-policies-details"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Kebijakan pemberitahuan memberi Anda cara yang fleksibel untuk merutekan peringatan ke berbagai penerima yang berbeda. Menggunakan pencocokan label, Anda dapat memodifikasi pengiriman pemberitahuan peringatan tanpa harus memperbarui setiap aturan peringatan individual.

Di bagian ini, Anda akan mempelajari lebih lanjut tentang cara kerja kebijakan notifikasi dan terstruktur, sehingga Anda dapat memaksimalkan pengaturan kebijakan notifikasi.

## Pohon kebijakan
<a name="v10-alerting-explore-notifications-policy-tree"></a>

Kebijakan pemberitahuan *bukan* daftar, melainkan disusun menurut struktur pohon. Ini berarti bahwa setiap kebijakan dapat memiliki kebijakan anak, dan sebagainya. Akar pohon kebijakan notifikasi disebut **kebijakan pemberitahuan Default**.

Setiap kebijakan terdiri dari sekumpulan pencocokan label (0 atau lebih) yang menentukan label mana yang mereka minati atau tidak ingin ditangani.

Untuk informasi selengkapnya tentang pencocokan label, lihat[Cara kerja pencocokan label](v10-alerting-overview-labels-matching.md).

**catatan**  
Jika Anda belum mengonfigurasi pencocokan label apa pun untuk kebijakan notifikasi, kebijakan notifikasi Anda akan cocok dengan *semua* instance peringatan. Hal ini dapat mencegah kebijakan anak dievaluasi kecuali Anda telah mengaktifkan **Lanjutkan pencocokan saudara kandung** pada kebijakan pemberitahuan.

## Perutean
<a name="v10-alerting-explore-notifications-routing"></a>

Untuk menentukan kebijakan notifikasi mana yang akan menangani instance peringatan mana, Anda harus mulai dengan melihat kumpulan kebijakan notifikasi yang ada, dimulai dengan kebijakan notifikasi default.

Jika tidak ada kebijakan selain kebijakan default yang dikonfigurasi, kebijakan default akan menangani instance peringatan.

Jika kebijakan selain kebijakan default ditentukan, kebijakan notifikasi tersebut akan mengevaluasi kebijakan pemberitahuan tersebut sesuai urutan yang ditampilkan.

Jika kebijakan notifikasi memiliki pencocokan label yang cocok dengan label instance peringatan, kebijakan tersebut akan turun ke kebijakan turunannya dan, jika ada, akan terus mencari kebijakan anak yang mungkin memiliki pencocokan label yang semakin mempersempit kumpulan label, dan seterusnya sampai tidak ada lagi kebijakan anak yang ditemukan.

Jika tidak ada kebijakan anak yang ditentukan dalam kebijakan pemberitahuan atau jika tidak ada kebijakan turunan yang memiliki pencocokan label yang cocok dengan label instance peringatan, kebijakan pemberitahuan induk akan digunakan.

Segera setelah kebijakan pencocokan ditemukan, sistem tidak terus mencari kebijakan pencocokan lainnya. Jika Anda ingin terus mencari kebijakan lain yang mungkin cocok, aktifkan **Lanjutkan pencocokan saudara kandung** pada kebijakan tertentu.

Terakhir, jika tidak ada kebijakan notifikasi yang dipilih, kebijakan notifikasi default akan digunakan.

### Contoh perutean
<a name="v10-alerting-explore-notifications-routing-example"></a>

Berikut adalah contoh pohon kebijakan notifikasi yang relatif sederhana dan beberapa contoh peringatan.

![\[Gambar yang menampilkan sekumpulan kebijakan notifikasi dalam struktur pohon, dan sekumpulan instance peringatan dengan label berbeda agar sesuai dengan kebijakan.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/notification-routing.png)


Berikut adalah rincian tentang bagaimana kebijakan ini dipilih:

**Pod yang terjebak CrashLoop** tidak memiliki `severity` label, jadi tidak ada kebijakan turunannya yang cocok. Itu memang memiliki `team=operations` label, jadi kebijakan pertama dicocokkan.

`team=security`Kebijakan ini tidak dievaluasi karena kami telah menemukan kecocokan dan **Lanjutkan pencocokan saudara kandung** tidak dikonfigurasi untuk kebijakan tersebut.

**Penggunaan Disk — 80%** memiliki `severity` label `team` dan a, dan cocok dengan kebijakan anak dari tim operasi.

**Entri log yang tidak sah** memiliki `team` label tetapi tidak cocok dengan kebijakan pertama (`team=operations`) karena nilainya tidak sama, sehingga akan terus mencari dan mencocokkan `team=security` kebijakan. Itu tidak memiliki kebijakan anak, sehingga `severity=high` label tambahan diabaikan.

## Warisan
<a name="v10-alerting-explore-notifications-inheritance"></a>

Selain kebijakan anak sebagai konsep yang berguna untuk merutekan instance peringatan, mereka juga mewarisi properti dari kebijakan induknya. Ini juga berlaku untuk setiap kebijakan yang merupakan kebijakan anak dari kebijakan pemberitahuan default.

Properti berikut diwarisi oleh kebijakan anak:
+ Titik kontak
+ Opsi pengelompokan
+ Opsi waktu
+ Bisukan pengaturan waktu

Masing-masing properti ini dapat ditimpa oleh kebijakan individual jika Anda ingin mengganti properti yang diwariskan.

Untuk mewarisi titik kontak dari kebijakan induk, biarkan kosong. **Untuk mengganti opsi pengelompokan yang diwariskan, aktifkan pengelompokan Override.** Untuk mengganti opsi waktu yang diwariskan, aktifkan **Override** pengaturan waktu umum.

### Contoh warisan
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

Contoh di bawah ini menunjukkan bagaimana pohon kebijakan notifikasi dari contoh sebelumnya memungkinkan kebijakan anak `team=operations` untuk mewarisi titik kontaknya.

Dengan cara ini, kita dapat menghindari keharusan menentukan titik kontak yang sama beberapa kali untuk setiap kebijakan anak.

![\[Gambar yang menunjukkan serangkaian kebijakan pemberitahuan dalam struktur pohon, dengan titik kontak yang ditetapkan ke beberapa kebijakan, tetapi dengan beberapa kebijakan anak mewarisi titik kontak orang tua mereka, daripada mendefinisikan sendiri.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/notification-inheritance.png)


## Opsi konfigurasi tambahan
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### Pengelompokan
<a name="v10-alerting-explore-notifications-grouping"></a>

Pengelompokan adalah fitur penting dari Grafana Alerting karena memungkinkan Anda untuk mengumpulkan peringatan yang relevan bersama-sama ke dalam jumlah notifikasi yang lebih kecil. Hal ini sangat penting jika pemberitahuan dikirimkan ke responden pertama, seperti insinyur on-call, di mana menerima banyak notifikasi dalam waktu singkat bisa sangat banyak dan dalam beberapa kasus dapat berdampak negatif pada kemampuan responden pertama untuk menanggapi suatu insiden. Misalnya, pertimbangkan pemadaman besar di mana banyak sistem Anda sedang down. Dalam hal ini, pengelompokan dapat menjadi perbedaan antara menerima 1 panggilan telepon dan 100 panggilan telepon.

Anda memilih bagaimana peringatan dikelompokkan bersama menggunakan opsi Grup menurut dalam kebijakan pemberitahuan. Secara default, kebijakan notifikasi di grup Grafana memberi peringatan bersama dengan aturan peringatan menggunakan `grafana_folder` label `alertname` dan (karena nama peringatan tidak unik di beberapa folder). Jika Anda ingin mengelompokkan peringatan dengan sesuatu selain aturan peringatan, ubah pengelompokan ke kombinasi label lainnya.

#### Nonaktifkan pengelompokan
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

Jika Anda ingin menerima setiap peringatan sebagai pemberitahuan terpisah, Anda dapat melakukannya dengan mengelompokkan berdasarkan label khusus yang disebut`...`. Ini berguna ketika peringatan Anda dikirim ke sistem otomatis, bukan responden pertama.

#### Satu grup untuk semua peringatan
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

Jika Anda ingin menerima semua peringatan bersama-sama dalam satu pemberitahuan, Anda dapat melakukannya dengan meninggalkan Grup dengan kosong.

### Opsi waktu
<a name="v10-alerting-explore-notifications-timing-options"></a>

Opsi waktu menentukan seberapa sering pemberitahuan dikirim untuk setiap grup peringatan. Ada tiga pengatur waktu yang perlu Anda ketahui: Tunggu grup, Interval grup, dan interval Ulangi.

#### Kelompok menunggu
<a name="v10-alerting-explore-notifications-group-wait"></a>

Penantian grup adalah jumlah waktu Grafana menunggu sebelum mengirim pemberitahuan pertama untuk grup peringatan baru. Semakin lama penantian Grup adalah semakin banyak waktu yang Anda miliki untuk peringatan lain tiba. Penantian Grup yang lebih pendek adalah semakin awal pemberitahuan pertama akan dikirim, tetapi berisiko mengirim pemberitahuan yang tidak lengkap. Anda harus selalu memilih penantian Grup yang paling masuk akal untuk kasus penggunaan Anda.

**Default** 30 detik

#### Interval kelompok
<a name="v10-alerting-explore-notifications-group-interval"></a>

Setelah pemberitahuan pertama dikirim untuk grup peringatan baru, Grafana memulai pengatur waktu interval Grup. Ini adalah jumlah waktu Grafana menunggu sebelum mengirim pemberitahuan tentang perubahan pada grup. Misalnya, peringatan penembakan lain mungkin baru saja ditambahkan ke grup sementara peringatan yang ada mungkin telah diselesaikan. Jika peringatan terlambat untuk dimasukkan dalam pemberitahuan pertama karena penantian Grup, peringatan tersebut akan disertakan dalam pemberitahuan berikutnya setelah interval Grup. Setelah Interval Grup berlalu, Grafana mengatur ulang pengatur waktu interval Grup. Ini berulang sampai tidak ada lagi peringatan di grup setelah grup dihapus.

**Default** 5 menit

#### Ulangi interval
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

Interval pengulangan memutuskan seberapa sering pemberitahuan diulang jika grup tidak berubah sejak pemberitahuan terakhir. Anda dapat menganggap ini sebagai pengingat bahwa beberapa peringatan masih menyala. Interval pengulangan terkait erat dengan interval Grup, yang berarti interval Ulangi Anda tidak hanya harus lebih besar dari atau sama dengan interval Grup, tetapi juga harus kelipatan interval Grup. Jika interval Ulangi bukan kelipatan interval Grup itu akan dipaksa menjadi satu. Misalnya, jika interval Grup Anda adalah 5 menit, dan interval Ulangi Anda adalah 9 menit, interval Ulangi akan dibulatkan ke kelipatan terdekat dari 5 yaitu 10 menit.

**Default** 4 jam

# Memperingatkan ketersediaan tinggi
<a name="v10-alerting-explore-high-availability"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana Terkelola Amazon dikonfigurasi untuk ketersediaan tinggi, termasuk menjalankan beberapa instance di beberapa zona ketersediaan untuk setiap ruang kerja yang Anda buat.

Grafana Alerting menggunakan model Prometheus untuk memisahkan evaluasi aturan peringatan dari pengiriman notifikasi. Dalam model ini evaluasi aturan peringatan dilakukan di generator peringatan dan pengiriman pemberitahuan dilakukan di penerima peringatan. Di Grafana Alerting, generator peringatan adalah Scheduler dan penerima adalah Alertmanager.

Dengan konfigurasi ketersediaan tinggi, semua aturan peringatan dievaluasi pada semua instance. Anda dapat menganggap evaluasi aturan peringatan sebagai duplikasi. Beginilah cara Grafana Alerting memastikan bahwa selama setidaknya satu instance Grafana berfungsi, aturan peringatan akan tetap dievaluasi dan pemberitahuan untuk peringatan akan tetap dikirim. Anda akan melihat duplikasi ini dalam sejarah negara bagian, dan merupakan cara yang baik untuk mengetahui apakah Anda menggunakan ketersediaan tinggi.

# Mengatur Peringatan
<a name="v10-alerting-setup"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Konfigurasikan fitur dan integrasi yang Anda butuhkan untuk membuat dan mengelola peringatan Anda.

**Prasyarat**

Sebelum Anda mengatur peringatan, Anda harus melakukan hal berikut.
+ Konfigurasikan [sumber data](AMG-data-sources.md) Anda.
+ Pastikan sumber data yang Anda pilih kompatibel dan didukung oleh peringatan [Grafana](v10-alerting-overview-datasources.md).

**Untuk mengatur peringatan**

1. Konfigurasikan [aturan peringatan](v10-alerting-configure.md).
   + Buat aturan peringatan terkelola Grafana atau terkelola sumber data dan aturan perekaman.

1. Konfigurasikan [titik kontak](v10-alerting-configure-contactpoints.md).
   + Periksa titik kontak default, dan perbarui kontak untuk sistem Anda.
   + Secara opsional, tambahkan titik kontak dan integrasi baru.

1. Konfigurasikan [kebijakan pemberitahuan](v10-alerting-explore-notifications-policies-details.md)
   + Periksa kebijakan pemberitahuan default, dan perbarui untuk sistem Anda.
   + Secara opsional, tambahkan kebijakan bersarang tambahan.
   + Secara opsional, tambahkan label dan pencocokan label untuk mengontrol perutean peringatan.

Topik berikut memberi Anda informasi lebih lanjut tentang opsi konfigurasi tambahan, termasuk mengonfigurasi pengelola peringatan eksternal dan merutekan peringatan yang dikelola Grafana di luar Grafana.

**Topics**
+ [Memigrasi peringatan dasbor klasik ke peringatan Grafana](v10-alerting-use-grafana-alerts.md)
+ [Menambahkan Alertmanager eksternal](v10-alerting-setup-alertmanager.md)
+ [Penyediaan sumber daya Peringatan Grafana](v10-alerting-setup-provision.md)

# Memigrasi peringatan dasbor klasik ke peringatan Grafana
<a name="v10-alerting-use-grafana-alerts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ruang kerja yang memilih untuk tidak menggunakan peringatan Grafana menggunakan. [Peringatan dasbor klasik](old-alerts-overview.md) Untuk beralih ke peringatan Grafana baru, Anda harus ikut serta dalam fitur tersebut. Untuk melihat detail tentang perbedaan antara peringatan dasbor klasik dan peringatan Grafana, lihat. [Peringatan Grafana vs peringatan dasbor lama](#v10-alerting-diff-old-new) GrafanaLabs telah mengumumkan bahwa peringatan dasbor klasik akan dihapus di versi 11.

Saat Anda menggunakan peringatan dasbor klasik, Grafana yang Dikelola Amazon menunjukkan pratinjau peringatan Grafana tempat Anda dapat meninjau dan memodifikasi peringatan yang ditingkatkan sebelum menyelesaikan peningkatan.

## Mempratinjau peringatan Grafana
<a name="v10-alerting-preview-grafana-alerts"></a>

Anda dapat melihat pratinjau peringatan Anda di peringatan Grafana sebelum bermigrasi. Di pratinjau, Anda dapat membuat perubahan pada peringatan yang akan mengubah migrasi.

**Untuk melihat pratinjau migrasi peringatan Grafana Anda**

1. Masuk ke ruang kerja Grafana Anda.

1. Dari menu sebelah kiri, pilih **Alerting (legacy)** untuk melihat peringatan Anda saat ini.

1. Dari menu sebelah kiri, pilih **Peringatan upgrade** untuk melihat lansiran Anda di Grafana alert.

   Dari tampilan ini, Anda dapat melihat seperti apa peringatan Anda setelah migrasi.

**catatan**  
Dari tampilan ini, Anda juga dapat membuat perubahan yang akan memengaruhi migrasi Anda. Untuk membatalkan perubahan yang Anda buat, pilih **Reset upgrade** di kanan atas halaman upgrade.

Saat Anda siap untuk meningkatkan lansiran Anda, lihat bagian selanjutnya.

## Bermigrasi ke sistem peringatan Grafana
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

Anda dapat mengonfigurasi instans Grafana Terkelola Amazon untuk menggunakan peringatan Grafana menggunakan API Grafana yang Dikelola Amazon Konsol Manajemen AWS, AWS CLI atau Amazon. Untuk detail tentang cara mengonfigurasi Grafana Terkelola Amazon, termasuk mengaktifkan atau menonaktifkan peringatan Grafana, lihat. [Konfigurasikan ruang kerja Grafana yang Dikelola Amazon](AMG-configure-workspace.md)

Saat peringatan Grafana diaktifkan, peringatan dasbor klasik yang ada bermigrasi dalam format yang kompatibel dengan peringatan Grafana. Di halaman Peringatan instans Grafana Anda, Anda dapat melihat peringatan yang dimigrasi bersama peringatan baru. Dengan peringatan Grafana, aturan peringatan yang dikelola Grafana Anda mengirim beberapa notifikasi, bukan satu peringatan saat dicocokkan.

Akses baca dan tulis ke peringatan dasbor klasik dan peringatan Grafana diatur oleh izin folder yang menyimpannya. Selama migrasi, izin peringatan dasbor klasik dicocokkan dengan izin aturan baru sebagai berikut:
+ Jika dasbor peringatan asli memiliki izin, migrasi akan membuat folder bernama dengan format ini `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` agar sesuai dengan izin dasbor asli (termasuk izin yang diwariskan dari folder).
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder, maka aturan tersebut ditautkan ke folder ini dan mewarisi izinnya.
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder Umum, maka aturan tersebut ditautkan ke folder Peringatan Umum, dan aturan mewarisi izin default.

**catatan**  
Karena tidak ada `Keep Last State` opsi untuk `NoData` peringatan Grafana, opsi ini menjadi `NoData` selama migrasi aturan klasik. Opsi `Keep Last State` untuk `Error` penanganan dimigrasikan ke opsi `Error` baru. Untuk mencocokkan perilaku`Keep Last State`, dalam kedua kasus, selama migrasi Grafana yang Dikelola Amazon secara otomatis membuat keheningan untuk setiap aturan peringatan dengan durasi satu tahun.

Saluran notifikasi dimigrasikan ke konfigurasi Alertmanager dengan rute dan penerima yang sesuai. Saluran pemberitahuan default ditambahkan sebagai titik kontak ke rute default. Saluran pemberitahuan yang tidak terkait dengan peringatan Dasbor apa pun masuk ke `autogen-unlinked-channel-recv` rute.

### Batasan
<a name="v10-alerting-use-grafana-alerts-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan peringatan dari sumber data lain yang didukung.
+ Migrasi bolak-balik antara peringatan Grafana dan peringatan dasbor klasik dapat mengakibatkan hilangnya data untuk fitur yang didukung dalam satu sistem, tetapi tidak yang lain.
**catatan**  
Jika Anda bermigrasi kembali ke peringatan dasbor klasik, Anda kehilangan semua perubahan yang dibuat pada konfigurasi peringatan yang dibuat saat peringatan Grafana diaktifkan, termasuk aturan peringatan baru yang dibuat.

## Peringatan Grafana vs peringatan dasbor lama
<a name="v10-alerting-diff-old-new"></a>

Diperkenalkan di Grafana 8, peringatan Grafana memiliki beberapa peningkatan dibandingkan peringatan dasbor lama.

### Peringatan multi-dimensi
<a name="v10-alerts-diff-multi-dimensional"></a>

Anda sekarang dapat membuat peringatan yang memberi Anda visibilitas seluruh sistem dengan satu aturan peringatan. Hasilkan beberapa instance peringatan dari satu aturan peringatan. Misalnya, Anda dapat membuat aturan untuk memantau penggunaan disk dari beberapa titik pemasangan pada satu host. Mesin evaluasi mengembalikan beberapa deret waktu dari satu kueri, dengan setiap deret waktu diidentifikasi oleh set labelnya.

### Buat peringatan di luar Dasbor
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

Tidak seperti lansiran dasbor lama, peringatan Grafana memungkinkan Anda membuat kueri dan ekspresi yang menggabungkan data dari berbagai sumber dengan cara yang unik. Anda masih dapat menautkan dasbor dan panel ke aturan peringatan menggunakan ID mereka dan dengan cepat memecahkan masalah sistem yang sedang diamati.

Karena peringatan terpadu tidak lagi terkait langsung dengan kueri panel, mereka tidak menyertakan gambar atau nilai kueri dalam email notifikasi. Anda dapat menggunakan templat notifikasi yang disesuaikan untuk melihat nilai kueri.

### Buat aturan peringatan Loki dan Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

Di Grafana Alerting, Anda dapat mengelola aturan peringatan Loki dan Grafana Mimir menggunakan UI dan API yang sama dengan lansiran terkelola Grafana Anda.

### Lihat dan cari peringatan dari sumber data yang kompatibel dengan Prometheus
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Peringatan untuk sumber data yang kompatibel dengan Prometheus sekarang terdaftar di bawah bagian peringatan Grafana. Anda dapat mencari label di beberapa sumber data untuk menemukan peringatan yang relevan dengan cepat.

### Peringatan khusus untuk status peringatan NoData dan Kesalahan
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting memperkenalkan konsep baru status peringatan. Ketika evaluasi aturan peringatan menghasilkan status NoData atau Kesalahan, Grafana Alerting akan menghasilkan peringatan khusus yang akan memiliki label berikut:
+ `alertname`dengan nilai DatasourceNoData atau DatasourceError tergantung pada negara.
+ `rulename`nama aturan peringatan yang dimiliki oleh peringatan khusus.
+ `datasource_uid`akan memiliki UID dari sumber data yang menyebabkan negara.
+ Semua label dan anotasi aturan peringatan asli

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa dengan menambahkan keheningan, rute ke titik kontak, dan sebagainya.

**catatan**  
Jika aturan menggunakan banyak sumber data dan satu atau banyak tidak mengembalikan data, peringatan khusus akan dibuat untuk setiap sumber data yang menyebabkan status peringatan.

# Menambahkan Alertmanager eksternal
<a name="v10-alerting-setup-alertmanager"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Siapkan Grafana untuk menggunakan Alertmanager eksternal sebagai Alertmanager tunggal untuk menerima semua peringatan Anda. Alertmanager eksternal ini kemudian dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

**catatan**  
Anda tidak dapat menggunakan Amazon Managed Service untuk Prometheus sebagai Alertmanager eksternal.

Setelah menambahkan alertmanager, Anda dapat menggunakan Grafana Alerting UI untuk mengelola keheningan, titik kontak, dan kebijakan notifikasi. Opsi dropdown di halaman ini memungkinkan Anda untuk beralih di antara manajer peringatan.

Manajer peringatan eksternal dikonfigurasi sebagai sumber data menggunakan Konfigurasi Grafana dari menu navigasi Grafana utama. Ini memungkinkan Anda untuk mengelola titik kontak dan kebijakan pemberitahuan manajer peringatan eksternal dari dalam Grafana dan juga mengenkripsi kredensi otentikasi dasar HTTP yang sebelumnya terlihat saat mengonfigurasi pengelola peringatan eksternal berdasarkan URL.

**catatan**  
Dimulai dengan Grafana 9.2, konfigurasi URL pengelola peringatan eksternal dari tab Admin di halaman Peringatan tidak digunakan lagi. Ini akan dihapus dalam rilis future.

**Untuk menambahkan Alertmanager eksternal**

1. Pilih **Koneksi** dari menu kiri utama.

1. Cari `Alertmanager`.

1. Pilih tombol **Buat sumber data baru**.

1. Isi bidang pada halaman, sesuai kebutuhan.

   Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.
**catatan**  
Prometheus, Grafana Mimir, dan implementasi Cortex dari Alertmanager didukung. Untuk Prometheus, titik kontak dan kebijakan notifikasi hanya-baca di UI Peringatan Grafana.

1. Pilih **Simpan & uji**.

# Penyediaan sumber daya Peringatan Grafana
<a name="v10-alerting-setup-provision"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Infrastruktur peringatan seringkali rumit, dengan banyak potongan pipa yang sering tinggal di tempat yang berbeda. Menskalakan ini di beberapa tim dan organisasi adalah tugas yang sangat menantang. Penyediaan Grafana Alerting membuat proses ini lebih mudah dengan memungkinkan Anda membuat, mengelola, dan memelihara data peringatan Anda dengan cara yang paling sesuai dengan organisasi Anda.

Ada dua opsi untuk dipilih:

1. Menyediakan sumber daya peringatan Anda menggunakan API HTTP Penyediaan Peringatan.
**catatan**  
Biasanya, Anda tidak dapat mengedit aturan peringatan yang disediakan API dari UI Grafana.  
Untuk mengaktifkan pengeditan, tambahkan x-disable-provenance header ke permintaan berikut saat membuat atau mengedit aturan peringatan Anda di API:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Menyediakan sumber peringatan Anda menggunakan Terraform.

**catatan**  
Saat ini, penyediaan Grafana Alerting mendukung aturan peringatan, titik kontak, pengaturan waktu bisu, dan templat. Sumber daya peringatan yang disediakan menggunakan penyediaan file atau Terraform hanya dapat diedit di sumber yang membuatnya dan bukan dari dalam Grafana atau sumber lainnya. Misalnya, jika Anda menyediakan sumber peringatan menggunakan file dari disk, Anda tidak dapat mengedit data di Terraform atau dari dalam Grafana.

**Topics**
+ [Buat dan kelola sumber daya peringatan menggunakan Terraform](v10-alerting-setup-provision-terraform.md)
+ [Melihat sumber peringatan yang disediakan di Grafana](v10-alerting-setup-provision-view.md)

# Buat dan kelola sumber daya peringatan menggunakan Terraform
<a name="v10-alerting-setup-provision-terraform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan Penyedia Grafana Terraform untuk mengelola sumber daya peringatan Anda dan menyediakannya ke dalam sistem Grafana Anda. Dukungan penyedia Terraform untuk Grafana Alerting memudahkan untuk membuat, mengelola, dan memelihara seluruh tumpukan Grafana Alerting Anda sebagai kode.

Untuk informasi lebih lanjut tentang mengelola sumber daya peringatan Anda menggunakan Terraform, lihat dokumentasi [Penyedia](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Grafana di dokumentasi Terraform.

Selesaikan tugas-tugas berikut untuk membuat dan mengelola sumber peringatan Anda menggunakan Terraform.

1. Buat kunci API untuk penyediaan.

1. Konfigurasikan penyedia Terraform.

1. Tentukan sumber peringatan Anda di Terraform.

1. Jalankan `terraform apply` untuk menyediakan sumber peringatan Anda.

## Prasyarat
<a name="v10-alerting-setup-provision-tf-prerequisites"></a>
+ Pastikan Anda memiliki [penyedia grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 atau lebih tinggi.
+ Pastikan Anda menggunakan Grafana 9.1 atau lebih tinggi. Jika Anda membuat instans Grafana Terkelola Amazon dengan Grafana versi 9, ini benar.

## Membuat kunci API untuk penyediaan
<a name="v10-alerting-setup-provision-tf-apikey"></a>

Anda dapat [membuat kunci API Grafana normal](Using-Grafana-APIs.md) untuk mengautentikasi Terraform dengan Grafana. Sebagian besar perkakas yang ada menggunakan kunci API akan secara otomatis bekerja dengan dukungan Grafana Alerting yang baru. Untuk informasi khusus tentang membuat kunci untuk digunakan dengan Terraform, lihat [Menggunakan Terraform untuk otomatisasi Grafana Terkelola Amazon](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/).

**Untuk membuat kunci API untuk penyediaan**

1. Buat akun layanan baru untuk pipeline CI Anda.

1. Tetapkan peran “Akses API Penyediaan aturan peringatan.”

1. Buat token akun layanan baru.

1. Beri nama dan simpan token untuk digunakan di Terraform.

Atau, Anda dapat menggunakan otentikasi dasar. Untuk melihat semua format autentikasi yang didukung, lihat Autentikasi [Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) di dokumentasi Terraform.

## Konfigurasikan penyedia Terraform
<a name="v10-alerting-setup-provision-tf-configure"></a>

[Dukungan Grafana Alerting disertakan sebagai bagian dari penyedia Grafana Terraform.](https://registry.terraform.io/providers/grafana/grafana/latest/docs)

Berikut ini adalah contoh yang dapat Anda gunakan untuk mengonfigurasi penyedia Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Penyediaan titik kontak dan templat
<a name="v10-alerting-setup-provision-tf-contacts"></a>

Titik kontak menghubungkan tumpukan peringatan ke dunia luar. Mereka memberi tahu Grafana cara terhubung ke sistem eksternal Anda dan di mana mengirimkan pemberitahuan. Ada lebih dari lima belas [integrasi](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) berbeda untuk dipilih. Contoh ini menggunakan titik kontak Slack.

**Untuk menyediakan titik kontak dan templat**

1. Salin blok kode ini ke file.tf di mesin lokal Anda. Ganti *<slack-webhook-url>* dengan URL webhook Slack Anda (atau detail titik kontak lainnya).

   Contoh ini menciptakan titik kontak yang mengirimkan pemberitahuan peringatan ke Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Masukkan teks untuk notifikasi Anda di bidang teks.

   `text`Bidang ini mendukung [Templating Go-style](https://pkg.go.dev/text/template). Ini memungkinkan Anda untuk mengelola templat notifikasi Grafana Alerting Anda langsung di Terraform.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail titik kontak Anda.

   Anda tidak dapat mengedit sumber daya yang disediakan melalui Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik kontak berfungsi dengan benar.

**catatan**  
Anda dapat menggunakan kembali template yang sama di banyak titik kontak. Pada contoh di atas, template bersama disematkan menggunakan pernyataan `{{ template "Alert Instance Template" . }}`  
Fragmen ini kemudian dapat dikelola secara terpisah di Terraform:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Kebijakan pemberitahuan penyediaan dan perutean
<a name="v10-alerting-setup-provision-tf-notifications"></a>

Kebijakan notifikasi memberi tahu Grafana cara merutekan instance peringatan, sebagai lawan dari where. Mereka menghubungkan peringatan penembakan ke titik kontak yang Anda tentukan sebelumnya menggunakan sistem label dan pencocokan.

**Untuk menyediakan kebijakan pemberitahuan dan perutean**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, peringatan dikelompokkan berdasarkan`alertname`, yang berarti bahwa setiap pemberitahuan yang berasal dari peringatan yang memiliki nama yang sama, dikelompokkan ke dalam pesan Slack yang sama.

   Jika Anda ingin merutekan pemberitahuan tertentu secara berbeda, Anda dapat menambahkan sub-kebijakan. Sub-kebijakan memungkinkan Anda menerapkan perutean ke peringatan yang berbeda berdasarkan pencocokan label. Dalam contoh ini, kami menerapkan waktu bisu ke semua peringatan dengan label a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Di bidang mute\$1timings, tautkan waktu bisu ke kebijakan notifikasi Anda.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail kebijakan notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik notifikasi berfungsi dengan benar.

## Ketentuan waktu bisu
<a name="v10-alerting-setup-provision-tf-mutetiming"></a>

Pengaturan waktu bisu memberikan kemampuan untuk membisukan pemberitahuan peringatan untuk periode waktu yang ditentukan.

**Untuk menyediakan timing bisu**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, pemberitahuan peringatan dimatikan pada akhir pekan.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail waktu bisu Anda.

1. Referensikan waktu bisu yang baru dibuat dalam kebijakan notifikasi menggunakan `mute_timings` bidang. Ini akan menerapkan waktu bisu Anda ke beberapa atau semua notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa waktu bisu berfungsi dengan benar.

## Aturan peringatan ketentuan
<a name="v10-alerting-setup-provision-tf-rules"></a>

[Aturan peringatan](v10-alerting-configure.md) memungkinkan Anda untuk memperingatkan terhadap sumber data Grafana apa pun. Ini bisa berupa sumber data yang sudah Anda konfigurasikan, atau Anda dapat [menentukan sumber data Anda di Terraform bersama aturan](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) peringatan Anda.

**Untuk menyediakan aturan peringatan**

1. Buat sumber data untuk kueri dan folder untuk menyimpan aturan Anda.

   Dalam contoh ini, sumber [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md) data digunakan.

   Peringatan dapat didefinisikan terhadap sumber data backend apa pun di Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Tentukan aturan peringatan.

   Untuk informasi selengkapnya tentang aturan peringatan, lihat [cara membuat lansiran yang dikelola Grafana.](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/)

1. Buat grup aturan yang berisi satu atau beberapa aturan.

   Dalam contoh ini, grup `grafana_rule_group` sumber daya digunakan.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Buka UI Grafana dan periksa aturan peringatan Anda.

   Anda dapat melihat apakah aturan peringatan menyala. Anda juga dapat melihat visualisasi setiap tahapan kueri aturan peringatan.

   Saat peringatan diaktifkan, Grafana merutekan notifikasi melalui kebijakan yang Anda tetapkan.

   Misalnya, jika Anda memilih Slack sebagai titik kontak, [Alertmanager](https://github.com/prometheus/alertmanager) tertanam Grafana secara otomatis memposting pesan ke Slack.

# Melihat sumber peringatan yang disediakan di Grafana
<a name="v10-alerting-setup-provision-view"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat memverifikasi bahwa sumber peringatan Anda dibuat di Grafana.

**Untuk melihat sumber daya yang Anda sediakan di Grafana**

1. Buka instance Grafana Anda.

1. Arahkan ke Peringatan.

1. Klik folder sumber peringatan, misalnya, Aturan peringatan.

   Sumber daya yang disediakan diberi label **Provisioned**, sehingga jelas bahwa mereka tidak dibuat secara manual.

**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Grafana. Anda hanya dapat mengubah properti sumber daya dengan mengubah file penyediaan dan memulai ulang Grafana atau melakukan hot reload. Ini mencegah perubahan yang dilakukan pada sumber daya yang akan ditimpa jika file disediakan lagi atau hot reload dilakukan.

# Konfigurasikan peringatan
<a name="v10-alerting-configure"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Konfigurasikan fitur dan integrasi yang Anda butuhkan untuk membuat dan mengelola peringatan Anda.

**Topics**
+ [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Konfigurasikan aturan peringatan terkelola sumber data](v10-alerting-configure-datasourcemanaged.md)
+ [Konfigurasikan aturan perekaman](v10-alerting-configure-recordingrules.md)
+ [Konfigurasikan titik kontak](v10-alerting-configure-contactpoints.md)
+ [Konfigurasikan kebijakan pemberitahuan](v10-alerting-configure-notification-policies.md)

# Konfigurasikan aturan peringatan terkelola Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Aturan yang dikelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data kami yang didukung. Selain mendukung beberapa sumber data, Anda juga dapat menambahkan ekspresi untuk mengubah data Anda dan mengatur kondisi peringatan. Menggunakan gambar dalam pemberitahuan peringatan juga didukung. Ini adalah satu-satunya jenis aturan yang memungkinkan peringatan dari beberapa sumber data dalam satu definisi aturan.

Beberapa instance peringatan dapat dibuat sebagai hasil dari satu aturan peringatan (juga dikenal sebagai peringatan multi-dimensi).

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan.

Jika Anda menghapus sumber peringatan yang dibuat di UI, Anda tidak dapat mengambilnya lagi. Untuk membuat cadangan konfigurasi Anda dan untuk dapat memulihkan sumber daya peringatan yang dihapus, buat sumber daya peringatan Anda menggunakan Terraform, atau API Peringatan.

Dalam prosedur berikut, kami akan melalui proses pembuatan aturan peringatan yang dikelola Grafana Anda.

Untuk membuat aturan peringatan yang dikelola Grafana, gunakan alur pembuatan peringatan di ruang kerja dan ikuti langkah-langkah berikut untuk membantu Anda.

**Tetapkan nama aturan peringatan**

1. Pilih **Peringatan** -> **Aturan peringatan** -> **\$1 Aturan peringatan baru**.

1. Masukkan nama untuk mengidentifikasi aturan peringatan Anda.

   Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.

Selanjutnya, tentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

**Untuk menentukan query dan kondisi**

1. Pilih sumber data.

1. Dari **pilihan** dropdown, tentukan rentang [waktu](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**catatan**  
Grafana Alerting hanya mendukung rentang waktu relatif tetap, misalnya,. `now-24hr: now`  
Ini tidak mendukung rentang waktu absolut: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` atau rentang waktu semi-relatif:`now/d to: now`.

1. Tambahkan kueri.

   Untuk menambahkan beberapa [kueri](v10-panels-query-xform.md#v10-panels-query-xform-add), pilih **Tambahkan kueri**.

   Semua aturan peringatan dikelola oleh Grafana secara default. Jika Anda ingin beralih ke aturan peringatan yang dikelola sumber data, klik **Beralih ke aturan peringatan yang dikelola sumber data**.

1. Tambahkan satu atau lebih [ekspresi](v10-panels-query-xform-expressions.md).

   1. Untuk setiap ekspresi, pilih salah satu **kondisi Klasik** untuk membuat aturan peringatan tunggal, atau pilih dari opsi **Matematika**, **Kurangi**, dan **Sampel Ulang** untuk menghasilkan peringatan terpisah untuk setiap seri.
**catatan**  
Saat menggunakan Prometheus, Anda dapat menggunakan vektor instan dan fungsi bawaan, jadi Anda tidak perlu menambahkan ekspresi tambahan.

   1. Pilih **Pratinjau** untuk memverifikasi bahwa ekspresi berhasil.

1. [Opsional] Untuk menambahkan ambang pemulihan, aktifkan **ambang pemulihan kustom** dan isi nilai kapan aturan peringatan Anda harus berhenti diaktifkan.

   Anda hanya dapat menambahkan satu ambang pemulihan dalam kueri dan itu harus menjadi kondisi peringatan.

1. Pilih **Tetapkan sebagai kondisi peringatan** pada kueri atau ekspresi yang ingin Anda tetapkan sebagai kondisi peringatan Anda.

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

Untuk melakukan ini, Anda perlu memastikan bahwa aturan peringatan Anda berada di grup evaluasi yang tepat dan menetapkan waktu periode tertunda yang paling sesuai untuk kasus penggunaan Anda.

**Untuk mengatur perilaku evaluasi peringatan**

1. Pilih folder atau pilih **\$1 Folder baru**.

1. Pilih grup evaluasi atau klik **\$1 Grup evaluasi baru**.

   Jika Anda membuat grup evaluasi baru, tentukan interval untuk grup.

   Semua aturan dalam kelompok yang sama dievaluasi secara bersamaan selama interval waktu yang sama.

1. Masukkan periode yang tertunda.

   Periode yang tertunda adalah periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

   Setelah kondisi terpenuhi, peringatan masuk ke status **Pending**. **Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke status **Firing**, jika tidak maka akan kembali ke keadaan Normal.**

1. Aktifkan notifikasi peringatan jeda, jika diperlukan.
**catatan**  
Jeda evaluasi aturan peringatan untuk mencegah peringatan berisik saat menyetel peringatan Anda. Menjeda menghentikan evaluasi aturan peringatan dan tidak membuat instance peringatan apa pun. Ini berbeda dengan pengaturan waktu bisu, yang menghentikan pemberitahuan agar tidak dikirimkan, tetapi masih memungkinkan evaluasi aturan peringatan dan pembuatan instance peringatan.  
Anda dapat menjeda evaluasi aturan peringatan untuk mencegah peringatan berisik saat menyetel peringatan Anda. Menjeda menghentikan evaluasi aturan peringatan dan tidak membuat instance peringatan apa pun. Ini berbeda dengan pengaturan waktu bisu, yang menghentikan pemberitahuan agar tidak dikirimkan, tetapi masih memungkinkan evaluasi aturan peringatan dan pembuatan instance peringatan.

1. Di **Konfigurasikan tidak ada data dan penanganan kesalahan**, konfigurasikan perilaku peringatan tanpa adanya data.

   Gunakan pedoman nanti di bagian ini.

Tambahkan label ke aturan peringatan Anda untuk menetapkan kebijakan notifikasi mana yang harus menangani instance peringatan pengaktifan Anda.

Semua aturan dan instance peringatan, terlepas dari labelnya, cocok dengan kebijakan pemberitahuan default. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan label dalam aturan peringatan atau instance peringatan, maka kebijakan notifikasi default adalah kebijakan yang cocok.

**Untuk mengonfigurasi notifikasi**

1. Tambahkan label jika Anda ingin mengubah cara pemberitahuan Anda dirutekan.

   Tambahkan label khusus dengan memilih pasangan kunci-nilai yang ada dari drop-down, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

1. Pratinjau pengaturan perutean instance peringatan Anda.

   Berdasarkan label yang ditambahkan, instance peringatan dirutekan ke kebijakan notifikasi yang ditampilkan.

   Perluas setiap kebijakan pemberitahuan untuk melihat detail selengkapnya.

1. Pilih **Lihat detail** untuk melihat detail perutean peringatan dan pratinjau.

Tambahkan [anotasi](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) untuk memberikan lebih banyak konteks pada peringatan dalam pesan pemberitahuan peringatan Anda.

Anotasi menambahkan metadata untuk memberikan informasi lebih lanjut tentang peringatan dalam pesan pemberitahuan peringatan Anda. Misalnya, tambahkan anotasi **Ringkasan** untuk memberi tahu Anda nilai mana yang menyebabkan peringatan diaktifkan atau server mana itu terjadi.

**Untuk menambahkan anotasi**

1. [Opsional] Tambahkan ringkasan.

   Ringkasan singkat tentang apa yang terjadi dan mengapa.

1. [Opsional] Tambahkan deskripsi.

   Deskripsi tentang apa yang dilakukan aturan peringatan.

1. [Opsional] Tambahkan URL Runbook.

   Halaman web tempat Anda menyimpan runbook untuk peringatan

1. [Opsional] Tambahkan anotasi khusus

1. [Opsional] Tambahkan dasbor dan tautan panel.

   Menautkan peringatan ke panel di dasbor.

1. Pilih **Simpan aturan**.

**Aturan tunggal dan multi-dimensi**

Untuk peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multi-dimensi.
+ **Aturan dengan kondisi klasik**

  Gunakan ekspresi kondisi klasik untuk membuat aturan yang memicu peringatan tunggal saat kondisinya terpenuhi. Untuk kueri yang mengembalikan beberapa seri, Grafana tidak melacak status peringatan setiap seri. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.
+ **Aturan multi-dimensi**

  Untuk menghasilkan peringatan terpisah untuk setiap seri, buat aturan multi-dimensi. Gunakan`Math`,`Reduce`, atau `Resample` ekspresi untuk membuat aturan multi-dimensi. Contoh:
  + Tambahkan `Reduce` ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai (tidak diperlukan untuk [aturan yang menggunakan data numerik](v10-alerting-overview-numeric.md)).
  + Tambahkan `Math` ekspresi dengan kondisi untuk aturan. Tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan `0` if rule tidak boleh diaktifkan, atau angka positif jika harus diaktifkan. Beberapa contoh: `$B > 70` jika harus menyala jika nilai B query/expression lebih dari 70. `$B < $C * 100`dalam hal itu harus menyala jika nilai B kurang dari nilai C dikalikan dengan 100. Jika kueri yang dibandingkan memiliki beberapa seri dalam hasilnya, seri dari kueri yang berbeda dicocokkan jika mereka memiliki label yang sama atau satu adalah bagian dari yang lain.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di [https://community.grafana.com/t/ - - template-variables-are-not /2514](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514). supported-in-alert-queries while-setting-up-alert

**Konfigurasikan tidak ada data dan penanganan kesalahan**

Konfigurasikan perilaku peringatan saat evaluasi aturan peringatan Anda tidak menampilkan data atau kesalahan.

**catatan**  
Aturan peringatan yang dikonfigurasi untuk diaktifkan ketika evaluasi tidak mengembalikan data atau kesalahan hanya menyala ketika seluruh durasi periode evaluasi telah selesai. **Ini berarti bahwa alih-alih segera menyala ketika kondisi aturan peringatan dilanggar, aturan peringatan menunggu hingga waktu yang ditetapkan sebagai bidang For telah selesai dan kemudian menyala, mengurangi kebisingan peringatan dan memungkinkan masalah ketersediaan data sementara.**

Jika evaluasi aturan peringatan Anda tidak mengembalikan data, Anda dapat mengatur status pada aturan peringatan Anda untuk muncul sebagai berikut:


| Tidak ada Data | Deskripsi | 
| --- | --- | 
| Tidak ada Data | Membuat peringatan baru DatasourceNoData dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 
| Peringatan | Menetapkan status aturan peringatan keAlerting. Aturan peringatan menunggu sampai waktu yang ditetapkan di bidang For telah selesai sebelum ditembakkan. | 
| Oke | Menetapkan status aturan peringatan keNormal. | 

Jika evaluasi Anda menampilkan kesalahan, Anda dapat mengatur status pada aturan peringatan Anda untuk muncul sebagai berikut:


| Kesalahan | Deskripsi | 
| --- | --- | 
| Kesalahan | Membuat instance peringatan DatasourceError dengan nama dan UID dari aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label. | 
| Peringatan | Menetapkan status aturan peringatan keAlerting. Aturan peringatan menunggu sampai waktu yang ditetapkan di bidang For telah selesai sebelum ditembakkan. | 
| Oke | Menetapkan status aturan peringatan keNormal. | 

**Selesaikan contoh peringatan basi**

Instance peringatan dianggap basi jika dimensi atau deretnya telah hilang dari hasil kueri seluruhnya selama dua interval evaluasi.

Instance peringatan basi yang berada di `Error` status`Alerting`/`NoData`/secara otomatis ditandai sebagai `Resolved` dan `grafana_state_reason` anotasi ditambahkan ke instance peringatan dengan alasannya. `MissingSeries`

**Buat peringatan dari panel**

Buat peringatan dari jenis panel apa pun. Ini berarti Anda dapat menggunakan kembali kueri di panel dan membuat peringatan berdasarkan pada mereka.

1. Arahkan ke dasbor di bagian **Dasbor**.

1. Di sudut kanan atas panel, pilih tiga titik (elips).

1. Dari menu tarik-turun, pilih **Lainnya...** dan kemudian pilih Aturan **peringatan baru**.

Ini akan membuka formulir aturan peringatan, memungkinkan Anda untuk mengkonfigurasi dan membuat peringatan Anda berdasarkan kueri panel saat ini.

# Konfigurasikan aturan peringatan terkelola sumber data
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Buat aturan peringatan untuk instance Grafana Mimir atau Loki eksternal yang mengaktifkan API penggaris; ini disebut aturan peringatan terkelola sumber data.

**catatan**  
Aturan peringatan untuk instance Grafana Mimir atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.  
Jika Anda menghapus sumber peringatan yang dibuat di UI, Anda tidak dapat mengambilnya lagi. Untuk membuat cadangan konfigurasi Anda dan untuk dapat memulihkan sumber daya peringatan yang dihapus, buat sumber daya peringatan Anda menggunakan Terraform, atau API Peringatan.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus atau Loki. Jika tidak, Anda tidak akan dapat membuat atau memperbarui aturan peringatan terkelola Grafana Mimir.
+ Untuk sumber data Grafana Mimir dan Loki, aktifkan Ruler API dengan mengonfigurasi layanan masing-masing.
  + **Loki** - Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan aturan lainnya.
  + **Grafana Mimir** - gunakan awalan. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui peringatan UI.**

Dalam prosedur berikut, kami akan memandu Anda melalui proses pembuatan aturan peringatan terkelola sumber data Anda.

Untuk membuat aturan peringatan yang dikelola sumber data, gunakan alur pembuatan peringatan di ruang kerja dan ikuti langkah-langkah berikut untuk membantu Anda.

**Untuk menyetel nama aturan peringatan**

1. Pilih **Peringatan** -> **Aturan peringatan** -> **\$1 Aturan peringatan baru**.

1. Masukkan nama untuk mengidentifikasi aturan peringatan Anda.

   Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.

Tentukan kueri untuk mendapatkan data yang ingin Anda ukur dan kondisi yang perlu dipenuhi sebelum aturan peringatan diaktifkan.

**Untuk menentukan kueri dan kondisi**

1. Semua aturan peringatan dikelola oleh Grafana secara default. Untuk beralih ke aturan peringatan terkelola sumber data, pilih **Beralih ke aturan peringatan yang dikelola sumber data**.

1. Pilih sumber data dari daftar drop-down.

   Anda juga dapat memilih **Buka pemilih sumber data lanjutan** untuk melihat opsi lainnya, termasuk menambahkan sumber data (Khusus admin).

1. Masukkan kueri PromQL atau LogQL.

1. Pilih **Pratinjau lansiran.**

Gunakan evaluasi aturan peringatan untuk menentukan seberapa sering aturan peringatan harus dievaluasi dan seberapa cepat aturan tersebut harus mengubah statusnya.

**Untuk mengatur perilaku evaluasi peringatan**

1. Pilih namespace atau pilih **\$1 Namespace baru**.

1. Pilih grup evaluasi atau pilih **\$1 Grup evaluasi baru**.

   Jika Anda membuat grup evaluasi baru, tentukan interval untuk grup.

   Semua aturan dalam kelompok yang sama dievaluasi secara berurutan selama interval waktu yang sama.

1. Masukkan periode yang tertunda.

   Periode yang tertunda adalah periode di mana aturan peringatan dapat melanggar kondisi sampai menyala.

   Setelah suatu kondisi terpenuhi, peringatan masuk ke `Pending` negara bagian. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke status, jika tidak, `Firing` kondisi akan kembali ke status. `Normal`

Tambahkan label ke aturan peringatan Anda untuk menetapkan kebijakan notifikasi mana yang harus menangani instance peringatan pengaktifan Anda.

Semua aturan dan instance peringatan, terlepas dari labelnya, cocok dengan kebijakan pemberitahuan default. Jika tidak ada kebijakan bersarang, atau tidak ada kebijakan bersarang yang cocok dengan label dalam aturan peringatan atau instance peringatan, maka kebijakan notifikasi default adalah kebijakan yang cocok.

**Mengonfigurasi notifikasi**
+ Tambahkan label jika Anda ingin mengubah cara pemberitahuan Anda dirutekan.

  Tambahkan label khusus dengan memilih pasangan kunci-nilai yang ada dari drop-down, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

Tambahkan [anotasi](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) untuk memberikan lebih banyak konteks pada peringatan di notifikasi peringatan Anda.

Anotasi menambahkan metadata untuk memberikan informasi lebih lanjut tentang peringatan di notifikasi peringatan Anda. Misalnya, tambahkan `Summary` anotasi untuk memberi tahu Anda nilai mana yang menyebabkan peringatan diaktifkan atau server mana itu terjadi.

**Untuk menambahkan anotasi**

1. [Opsional] Tambahkan ringkasan.

   Ringkasan singkat tentang apa yang terjadi dan mengapa.

1. [Opsional] Tambahkan deskripsi.

   Deskripsi tentang apa yang dilakukan aturan peringatan.

1. [Opsional] Tambahkan URL Runbook.

   Halaman web tempat Anda menyimpan runbook untuk peringatan

1. [Opsional] Tambahkan anotasi khusus

1. [Opsional] Tambahkan dasbor dan tautan panel.

   Menautkan peringatan ke panel di dasbor.

1. Pilih **Simpan aturan**.

# Konfigurasikan aturan perekaman
<a name="v10-alerting-configure-recordingrules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat dan mengelola aturan perekaman untuk instans Grafana Mimir atau Loki eksternal. Aturan perekaman menghitung ekspresi yang sering dibutuhkan atau ekspresi mahal secara komputasi terlebih dahulu dan menyimpan hasilnya sebagai rangkaian waktu baru. Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

**catatan**  
Aturan perekaman dijalankan sebagai aturan instance, dan dijalankan setiap 10 detik.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus atau Loki. Anda akan membuat atau memperbarui aturan peringatan di sumber data Anda.
+ Untuk sumber data Grafana Mimir dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
  + **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
  + **Grafana Mimir** — Gunakan awalan. `/prometheus` Sumber data Prometheus mendukung Grafana Mimir dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk membuat aturan perekaman**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih **Peringatan, Aturan Peringatan**.**

1. Pilih **Aturan perekaman baru**.

1. Tetapkan nama aturan.

   Nama aturan perekaman harus berupa nama metrik Prometheus dan tidak mengandung spasi putih.

1. Tentukan kueri
   + Pilih sumber data Loki atau Prometheus Anda.
   + Masukkan kueri.

1. Tambahkan namespace dan grup.
   + Dari tarik-turun **Namespace**, pilih namespace aturan yang ada atau tambahkan yang baru. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi.
   + Dari dropdown **Grup**, pilih grup yang ada di dalam namespace yang dipilih atau tambahkan yang baru. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Tambahkan label.
   + Tambahkan label kustom memilih pasangan kunci-nilai yang ada dari dropdown, atau tambahkan label baru dengan memasukkan kunci atau nilai baru.

1. Pilih **Simpan aturan** untuk menyimpan aturan, atau **Simpan aturan dan keluar** untuk menyimpan aturan dan kembali ke halaman Peringatan.

# Konfigurasikan titik kontak
<a name="v10-alerting-configure-contactpoints"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan titik kontak untuk menentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan.

**catatan**  
Anda dapat membuat dan mengedit titik kontak untuk peringatan terkelola Grafana. Titik kontak untuk lansiran terkelola sumber data bersifat hanya-baca.

## Bekerja dengan titik kontak
<a name="v10-alerting-configure-contactpoints-working"></a>

Prosedur berikut menunjukkan cara menambahkan, mengedit, menghapus, dan menguji titik kontak.

**Untuk menambahkan titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak**.

1. Dari menu tarik-turun **Pilih Alertmanager**, pilih Alertmanager. Grafana Alertmanager dipilih secara default.

1. Pada tab **Poin Kontak**, pilih **\$1 Tambahkan titik kontak**.

1. Masukkan **Nama** untuk titik kontak.

1. Dari **Integrasi**, pilih jenis, dan isi kolom wajib berdasarkan jenis itu. Misalnya, jika Anda memilih Slack, masukkan saluran Slack dan pengguna yang harus dihubungi.

1. Jika tersedia untuk titik kontak yang Anda pilih, pilih **Pengaturan opsional** yang diinginkan untuk menentukan pengaturan tambahan.

1. Di bawah **Pengaturan pemberitahuan**, pilih **Nonaktifkan pesan yang diselesaikan** secara opsional jika Anda tidak ingin diberi tahu saat peringatan diselesaikan.

1. Untuk menambahkan integrasi titik kontak lainnya, pilih **Tambahkan integrasi titik kontak** dan ulangi langkah-langkah untuk setiap jenis titik kontak yang diperlukan.

1. Simpan perubahan Anda.

**Untuk mengedit titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diedit, lalu pilih **Edit**.

1. Perbarui titik kontak, lalu simpan perubahan Anda.

Anda dapat menghapus titik kontak yang tidak digunakan oleh kebijakan pemberitahuan.

**Untuk menghapus titik kontak**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pada **titik Kontak**, pilih titik kontak yang akan dihapus, lalu pilih **Lainnya**, **Hapus**.

1. Di kotak dialog konfirmasi, pilih **Ya, hapus**.

**catatan**  
Jika titik kontak digunakan oleh kebijakan notifikasi, Anda harus menghapus kebijakan notifikasi atau mengeditnya untuk menggunakan titik kontak yang berbeda sebelum menghapus titik kontak.

Setelah titik kontak Anda dibuat, Anda dapat mengirim pemberitahuan pengujian untuk memverifikasi bahwa itu dikonfigurasi dengan benar.

**Untuk mengirim pemberitahuan pengujian**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pada **titik Kontak**, pilih titik kontak yang akan diuji, lalu pilih **Edit**. Anda juga dapat membuat titik kontak baru jika diperlukan.

1. Pilih **Uji** untuk membuka dialog pengujian titik kontak.

1. Pilih apakah akan mengirim pemberitahuan pengujian yang telah ditentukan sebelumnya atau pilih **Kustom** untuk menambahkan anotasi dan label kustom Anda sendiri dalam pemberitahuan pengujian.

1. Pilih **Kirim pemberitahuan pengujian** untuk menguji peringatan dengan titik kontak yang diberikan.

## Konfigurasikan integrasi titik kontak
<a name="v10-alerting-configure-contactpoints-integration"></a>

Konfigurasikan integrasi titik kontak di Grafana untuk memilih saluran komunikasi pilihan Anda untuk menerima notifikasi saat aturan peringatan diaktifkan. Setiap integrasi memiliki opsi konfigurasi dan proses penyiapannya sendiri. Dalam kebanyakan kasus, ini melibatkan penyediaan kunci API atau URL Webhook.

Setelah dikonfigurasi, Anda dapat menggunakan integrasi sebagai bagian dari titik kontak Anda untuk menerima pemberitahuan setiap kali peringatan Anda mengubah statusnya. Di bagian ini, kami akan membahas langkah-langkah dasar untuk mengonfigurasi integrasi, menggunakan PagerDuty sebagai contoh, sehingga Anda dapat mulai menerima peringatan waktu nyata dan tetap mengikuti data pemantauan Anda.

**Daftar integrasi yang didukung**

Tabel berikut mencantumkan jenis titik kontak yang didukung oleh Grafana.


| Nama | Tipe | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Tugas Pager | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**Mengkonfigurasi PagerDuty untuk peringatan**

Untuk mengatur PagerDuty, Anda harus memberikan kunci integrasi. Berikan detail berikut.


| Pengaturan | Deskripsi | 
| --- | --- | 
| Kunci Integrasi | Kunci integrasi untuk PagerDuty | 
| Kepelikan | Level untuk notifikasi dinamis. Default-nya adalah critical. | 
| Detail Kustom | Detail tambahan tentang acara tersebut | 

`CustomDetails`Bidang adalah objek yang berisi pasangan kunci-nilai arbitrer. Detail yang ditentukan pengguna digabungkan dengan yang digunakan secara default.

Nilai default untuk `CustomDetails` adalah:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

Dalam kasus kunci duplikat, detail yang ditentukan pengguna menimpa yang default.

# Konfigurasikan kebijakan pemberitahuan
<a name="v10-alerting-configure-notification-policies"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Kebijakan pemberitahuan menentukan bagaimana peringatan diarahkan ke titik kontak.

Kebijakan memiliki struktur pohon, di mana setiap kebijakan dapat memiliki satu atau lebih kebijakan bersarang. Setiap kebijakan, kecuali kebijakan default, juga dapat mencocokkan label peringatan tertentu.

Setiap peringatan dievaluasi oleh kebijakan default dan selanjutnya oleh setiap kebijakan bersarang.

Jika Anda mengaktifkan `Continue matching subsequent sibling nodes` opsi untuk kebijakan bersarang, evaluasi akan berlanjut bahkan setelah satu atau beberapa kecocokan. Pengaturan konfigurasi kebijakan induk dan informasi titik kontak mengatur perilaku peringatan yang tidak cocok dengan kebijakan turunan mana pun. Kebijakan default mengatur peringatan apa pun yang tidak cocok dengan kebijakan bersarang.

Untuk informasi selengkapnya tentang kebijakan notifikasi, lihat[Notifikasi](v10-alerting-explore-notifications.md).

Prosedur berikut menunjukkan cara membuat dan mengelola kebijakan notifikasi.

**Untuk mengedit kebijakan pemberitahuan default**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Pilih Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Kebijakan default**, pilih**...** , **Sunting**.

1. Di **titik kontak default**, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.

1. Di **Grup menurut**, pilih label untuk mengelompokkan peringatan berdasarkan. Jika beberapa peringatan dicocokkan dengan kebijakan ini, maka mereka dikelompokkan berdasarkan label ini. Pemberitahuan dikirim per grup. Jika bidang kosong (default), maka semua notifikasi dikirim dalam satu grup. Gunakan label khusus, `...` untuk mengelompokkan peringatan berdasarkan semua label (yang secara efektif menonaktifkan pengelompokan).

1. Di **Opsi waktu**, pilih dari opsi berikut.
   + **Tunggu grup** — Saatnya menunggu untuk menyangga peringatan dari grup yang sama sebelum mengirim pemberitahuan awal. Waktu default-nya adalah 30 detik.
   + **Interval grup** — Interval waktu minimum antara dua pemberitahuan untuk grup. Default adalah 5 menit.
   + **Interval pengulangan** — Interval waktu minimum sebelum mengirim ulang pemberitahuan jika tidak ada peringatan baru yang ditambahkan ke grup. Defaultnya adalah 4 jam.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

Untuk membuat kebijakan notifikasi baru, Anda harus mengikuti struktur pohonnya. Kebijakan baru yang dibuat di batang pohon (kebijakan default), adalah cabang pohon. Setiap cabang dapat memiliki kebijakan bersarang mereka sendiri. Inilah sebabnya mengapa Anda akan selalu menambahkan kebijakan **bersarang** baru, baik di bawah kebijakan default, atau di bawah kebijakan yang sudah bersarang.

**Untuk menambahkan kebijakan bersarang baru**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Pilih Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. **Untuk menambahkan kebijakan spesifik tingkat atas, buka bagian Perutean khusus (misalnya ke kebijakan default, atau ke kebijakan lain yang ada di mana Anda ingin menambahkan kebijakan bersarang baru) dan pilih \$1 Kebijakan bersarang baru.**

1. Di bagian label yang cocok, tambahkan satu atau beberapa aturan untuk mencocokkan label peringatan.

1. Di menu tarik-turun **Titik kontak**, pilih titik kontak untuk mengirim pemberitahuan jika peringatan hanya cocok dengan kebijakan khusus ini dan bukan kebijakan bersarang apa pun.

1. Secara opsional, aktifkan **Lanjutkan pencocokan node saudara berikutnya** untuk terus mencocokkan kebijakan saudara kandung bahkan setelah peringatan cocok dengan kebijakan saat ini. Ketika opsi ini diaktifkan, Anda bisa mendapatkan lebih dari satu pemberitahuan untuk satu peringatan.

1. Secara opsional, aktifkan **pengelompokan Override** untuk menentukan pengelompokan yang sama dengan kebijakan default. Jika opsi tidak diaktifkan, pengelompokan kebijakan default akan digunakan.

1. Secara opsional, aktifkan **Ganti pengaturan waktu umum** untuk mengganti opsi waktu yang dikonfigurasi dalam kebijakan pemberitahuan grup.

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk mengedit kebijakan bersarang**

1. **Di menu sebelah kiri, pilih Alerting.**

1. Pilih **Kebijakan pemberitahuan**.

1. Pilih kebijakan yang ingin Anda edit, lalu pilih**...** , **Sunting**.

1. Buat perubahan apa pun (seperti saat menambahkan kebijakan bersarang).

1. Simpan perubahan Anda.

**Mencari kebijakan**

Anda dapat mencari di dalam pohon kebijakan berdasarkan *pencocokan Label atau titik* *kontak*.
+ Untuk mencari berdasarkan titik kontak, masukkan nama sebagian atau lengkap titik kontak di bidang **Cari berdasarkan titik kontak**. Kebijakan yang menggunakan titik kontak tersebut akan disorot di antarmuka pengguna.
+ Untuk mencari berdasarkan label, masukkan pencocokan label yang valid di kolom input **Cari berdasarkan pencocokan**. Beberapa matcher dapat dimasukkan, dipisahkan dengan koma. Misalnya, masukan pencocokan yang valid bisa `severity=high, region=~EMEA|NA` jadi.
**catatan**  
Saat mencari berdasarkan label, semua kebijakan yang cocok akan sama persis. Pertandingan sebagian dan pertandingan gaya regeks tidak didukung.

# Kelola lansiran Anda
<a name="v10-alerting-manage"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setelah menyiapkan aturan peringatan, titik kontak, dan kebijakan notifikasi, Anda dapat menggunakan peringatan Grafana untuk mengelola lansiran Anda dalam praktik.

**Topics**
+ [Sesuaikan notifikasi](v10-alerting-manage-notifications.md)
+ [Kelola titik kontak](v10-alerting-manage-contactpoints.md)
+ [Membungkam pemberitahuan peringatan](v10-alerting-silences.md)
+ [Lihat dan filter aturan peringatan](v10-alerting-manage-rules-viewfilter.md)
+ [Bisukan waktu](v10-alerting-manage-muting.md)
+ [Lihat keadaan dan kesehatan aturan peringatan](v10-alerting-manage-rulestate.md)
+ [Lihat dan filter menurut grup peringatan](v10-alerting-manage-viewfiltergroups.md)
+ [Lihat kesalahan pemberitahuan](v10-alerting-manage-viewnotificationerrors.md)

# Sesuaikan notifikasi
<a name="v10-alerting-manage-notifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Sesuaikan notifikasi Anda dengan templat notifikasi.

Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan format pesan di notifikasi.

Template notifikasi tidak terkait dengan integrasi titik kontak tertentu, seperti Amazon SNS atau Slack. Namun, Anda dapat memilih untuk membuat templat notifikasi terpisah untuk integrasi titik kontak yang berbeda.

Anda dapat menggunakan template notifikasi untuk:
+ Menambahkan, menghapus, atau mengurutkan ulang informasi dalam pemberitahuan termasuk ringkasan, deskripsi, label dan anotasi, nilai, dan tautan
+ Format teks dalam huruf tebal dan miring, dan tambahkan atau hapus jeda baris

Anda tidak dapat menggunakan templat notifikasi untuk:
+ Ubah desain notifikasi di layanan pesan instan seperti Slack dan Microsoft Teams

**Topics**
+ [Menggunakan bahasa template Go](v10-alerting-notifications-go-templating.md)
+ [Buat templat notifikasi](v10-alerting-create-templates.md)
+ [Menggunakan template notifikasi](#v10-alerting-use-notification-templates)
+ [Referensi templat](v10-alerting-template-reference.md)

# Menggunakan bahasa template Go
<a name="v10-alerting-notifications-go-templating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda menulis template notifikasi dalam bahasa template Go, [teks/template](https://pkg.go.dev/text/template).

Bagian ini memberikan ikhtisar bahasa template Go dan template penulisan dalam teks/template.

## Dot
<a name="v10-go-dot"></a>

Di text/template sana ada kursor khusus yang disebut titik, dan ditulis sebagai`.`. Anda dapat menganggap kursor ini sebagai variabel yang nilainya berubah tergantung di mana dalam template itu digunakan. Misalnya, pada awal template notifikasi `.` mengacu pada `ExtendedData` objek, yang berisi sejumlah bidang termasuk`Alerts`,,`Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` dan`ExternalURL`. Namun, dot mungkin merujuk ke sesuatu yang lain saat digunakan dalam daftar di `range` atas, saat digunakan di dalam`with`, atau saat menulis templat fitur untuk digunakan di templat lain. Anda dapat melihat contoh ini di[Buat templat notifikasi](v10-alerting-create-templates.md), dan semua data dan fungsi di[Referensi templat](v10-alerting-template-reference.md).

## Membuka dan menutup tag
<a name="v10-go-openclosetags"></a>

Dalam teks/template, template dimulai dengan `{{` dan diakhiri dengan `}}` terlepas dari apakah template mencetak variabel atau menjalankan struktur kontrol seperti pernyataan if. Ini berbeda dari bahasa templating lainnya seperti Jinja di mana pencetakan variabel menggunakan `{{` dan `}}` dan struktur kontrol menggunakan `{%` dan. `%}`

## Cetak
<a name="v10-go-print"></a>

Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak nilai titik, bidang titik, hasil fungsi, dan nilai [variabel](#v10-go-variables). Misalnya, untuk mencetak `Alerts` bidang di mana titik mengacu pada `ExtendedData` Anda akan menulis yang berikut:

```
{{ .Alerts }}
```

## Iterasi di atas peringatan
<a name="v10-go-iterate-alerts"></a>

Untuk mencetak hanya label setiap peringatan, bukan semua informasi tentang peringatan, Anda dapat menggunakan a `range` untuk mengulangi peringatan di: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Di dalam rentang titik tidak lagi mengacu pada`ExtendedData`, tetapi ke`Alert`. Anda dapat menggunakan `{{ .Labels }}` untuk mencetak label setiap peringatan. Ini berfungsi karena `{{ range .Alerts }}` perubahan titik untuk merujuk ke peringatan saat ini dalam daftar peringatan. Ketika rentang selesai titik diatur ulang ke nilai yang dimilikinya sebelum dimulainya rentang, yang dalam contoh ini adalah`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Ulangi anotasi dan label
<a name="v10-go-iterate-labels"></a>

Mari kita menulis template untuk mencetak label setiap peringatan dalam format`The name of the label is $name, and the value is $value`, di mana `$name` dan `$value` berisi nama dan nilai setiap label.

Seperti pada contoh sebelumnya, gunakan rentang untuk mengulangi peringatan `.Alerts` sedemikian rupa sehingga titik mengacu pada peringatan saat ini dalam daftar peringatan, dan kemudian gunakan rentang kedua pada label yang diurutkan sehingga titik diperbarui untuk kedua kalinya untuk merujuk ke label saat ini. Di dalam rentang kedua gunakan `.Name` dan `.Value` untuk mencetak nama dan nilai setiap label:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Fungsi indeks
<a name="v10-go-index"></a>

Untuk mencetak anotasi atau label tertentu, gunakan `index` fungsi.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Jika pernyataan
<a name="v10-go-if"></a>

Anda dapat menggunakan pernyataan if dalam template. Misalnya, untuk mencetak `There are no alerts` jika tidak ada peringatan di `.Alerts` Anda akan menulis yang berikut:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Dengan
<a name="v10-go-with"></a>

Dengan mirip dengan pernyataan if, namun tidak seperti pernyataan if, `with` pembaruan titik untuk merujuk ke nilai with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variabel
<a name="v10-go-variables"></a>

Variabel dalam text/template harus dibuat dalam template. Misalnya, untuk membuat variabel yang disebut `$variable` dengan nilai titik saat ini Anda akan menulis yang berikut ini:

```
{{ $variable := . }}
```

Anda dapat menggunakan `$variable` di dalam rentang atau `with` dan itu akan merujuk ke nilai titik pada saat variabel didefinisikan, bukan nilai titik saat ini.

Misalnya, Anda tidak dapat menulis templat yang digunakan `{{ .Labels }}` dalam rentang kedua karena di sini titik mengacu pada label saat ini, bukan peringatan saat ini:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Anda dapat memperbaikinya dengan mendefinisikan variabel yang disebut `$alert` dalam rentang pertama dan sebelum rentang kedua:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Rentang dengan indeks
<a name="v10-go-rangeindex"></a>

Anda bisa mendapatkan indeks setiap peringatan dalam rentang dengan mendefinisikan indeks dan variabel nilai di awal rentang:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Tentukan templat
<a name="v10-go-define"></a>

Anda dapat menentukan template yang dapat digunakan dalam template lain, menggunakan `define` dan nama template dalam tanda kutip ganda. Anda tidak boleh mendefinisikan template dengan nama yang sama dengan template lain, termasuk template default seperti`__subject`,`__text_values_list`,`__text_alert_list`, `default.title` dan`default.message`. Jika templat telah dibuat dengan nama yang sama dengan templat default, atau templat di templat notifikasi lain, Grafana mungkin menggunakan salah satu templat. Grafana tidak mencegah, atau menampilkan pesan kesalahan, ketika ada dua atau lebih templat dengan nama yang sama.

```
{{ define "print_labels" }}
{{ end }}
```

## Jalankan template
<a name="v10-go-execute"></a>

Anda dapat mengeksekusi template yang ditentukan dalam template Anda menggunakan`template`, nama template dalam tanda kutip ganda, dan kursor yang harus diteruskan ke template:

```
{{ template "print_labels" . }}
```

## Meneruskan data ke template
<a name="v10-go-passdata"></a>

Dalam titik template mengacu pada nilai yang diteruskan ke template.

Misalnya, jika templat dilewatkan daftar peringatan penembakan maka dot mengacu pada daftar peringatan penembakan tersebut:

```
{{ template "print_alerts" .Alerts }}
```

Jika templat dilewatkan label yang diurutkan untuk peringatan maka dot mengacu pada daftar label yang diurutkan:

```
{{ template "print_labels" .SortedLabels }}
```

Ini berguna saat menulis templat yang dapat digunakan kembali. Misalnya, untuk mencetak semua peringatan, Anda dapat menulis yang berikut ini:

```
{{ template "print_alerts" .Alerts }}
```

Kemudian untuk mencetak hanya peringatan penembakan Anda dapat menulis ini:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Ini berfungsi karena keduanya `.Alerts` dan `.Alerts.Firing` merupakan daftar peringatan.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Komentar
<a name="v10-go-comments"></a>

Anda dapat menambahkan komentar dengan `{{/*` dan`*/}}`:

```
{{/* This is a comment */}}
```

Untuk mencegah komentar menambahkan jeda baris gunakan:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Lekukan
<a name="v10-go-indentation"></a>

Anda dapat menggunakan lekukan, baik tab maupun spasi, dan jeda baris, untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Namun, lekukan dalam template juga akan ada dalam teks. Selanjutnya kita akan melihat cara menghapusnya.

## Hapus spasi dan jeda baris
<a name="v10-go-removespace"></a>

 text/template Digunakan `{{-` dan `-}}` untuk menghapus spasi depan dan trailing dan jeda garis.

Misalnya, saat menggunakan lekukan dan jeda baris untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Lekukan dan jeda baris juga akan ada dalam teks:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Anda dapat menghapus lekukan dan jeda baris dari teks yang berubah `}}` menjadi `-}}` di awal setiap rentang:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Indentasi dan jeda baris dalam template sekarang tidak ada dari teks:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Buat templat notifikasi
<a name="v10-alerting-create-templates"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Buat templat notifikasi yang dapat digunakan kembali untuk dikirim ke titik kontak Anda.

Anda dapat menambahkan satu atau beberapa templat ke templat notifikasi Anda.

Nama template notifikasi Anda harus unik. Anda tidak dapat memiliki dua templat dengan nama yang sama di templat notifikasi yang sama atau di templat notifikasi yang berbeda. Hindari mendefinisikan template dengan nama yang sama dengan template default, seperti:`__subject`,, `__text_values_list``__text_alert_list`, `default.title` dan`default.message`.

Di tab Titik kontak, Anda dapat melihat daftar templat notifikasi Anda.

## Membuat template notifikasi
<a name="v10-alerting-creating-templates"></a>

**Untuk membuat template notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Pilih nama untuk template notifikasi, seperti`email.subject`.

1. Tulis konten template di bidang konten.

   Contoh:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Simpan perubahan Anda.

   `{{ define "email.subject" }}`(di `email.subject` mana nama template Anda) dan `{{ end }}` secara otomatis ditambahkan ke awal dan akhir konten.

**Untuk membuat template notifikasi yang berisi lebih dari satu template**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**.

1. Masukkan nama untuk template notifikasi keseluruhan. Misalnya, `email`.

1. Tulis setiap templat di bidang Konten, termasuk `{{ define "name-of-template" }}` dan `{{ end }}` di awal dan akhir setiap templat. Anda dapat menggunakan nama deskriptif untuk setiap templat di templat notifikasi, misalnya, `email.subject` atau`email.message`. Dalam hal ini, jangan gunakan kembali nama template notifikasi yang Anda masukkan di atas.

   Bagian selanjutnya menunjukkan contoh rinci untuk template yang mungkin Anda buat.

1. Klik Simpan.

## Templat pemberitahuan pratinjau
<a name="v10-alerting-preview-templates"></a>

Pratinjau bagaimana template notifikasi Anda akan terlihat sebelum menggunakannya di titik kontak Anda, membantu Anda memahami hasil template yang Anda buat serta memberi Anda kesempatan untuk memperbaiki kesalahan sebelum menyimpan template.

**catatan**  
Pratinjau notifikasi hanya tersedia untuk Grafana Alertmanager.

**Untuk melihat pratinjau templat notifikasi**

1. Pilih **Peringatan, Titik** **kontak**.

1. Pilih tab **Template Pemberitahuan**, lalu **\$1 Tambahkan templat notifikasi**, atau edit templat yang ada.

1. Tambahkan atau perbarui konten template Anda.

   Data default disediakan dan Anda dapat menambahkan atau mengedit data peringatan ke dalamnya serta instance peringatan. Anda dapat menambahkan data peringatan langsung di jendela data Payload itu sendiri, atau klik **Pilih instance peringatan** atau **Tambahkan peringatan khusus**.

1. [Opsional] Untuk menambahkan data peringatan dari instance peringatan yang ada:

   1. Pilih **Pilih instans peringatan**.

   1. Arahkan kursor ke instance peringatan untuk melihat informasi selengkapnya tentang setiap instance peringatan/

   1. Pilih **Konfirmasi** untuk menambahkan instance peringatan ke payload.

1. [Opsional] Untuk menambahkan data peringatan menggunakan editor data Peringatan, pilih **Tambahkan data khusus**:

   1. Tambahkan anotasi, label khusus, atau atur dasbor atau panel.

   1. Alihkan Penembakan atau diselesaikan, tergantung pada apakah Anda ingin menambahkan peringatan yang diaktifkan atau diselesaikan ke notifikasi Anda.

   1. Pilih **Tambahkan data peringatan**.

   1. Pilih **Refresh preview** untuk melihat seperti apa konten template Anda nantinya dan data payload yang sesuai.

   Jika ada kesalahan dalam template Anda, mereka ditampilkan di Pratinjau dan Anda dapat memperbaikinya sebelum menyimpan.

1. Simpan perubahan Anda.

## Membuat template untuk subjek pesan
<a name="v10-alerting-create-template-subject"></a>

Buat templat untuk subjek email yang berisi jumlah peringatan yang ditembakkan dan diselesaikan, seperti dalam contoh ini:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk subjek email**

1. Buat template yang disebut `email.subject` dengan konten berikut:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke bidang **Subjek** dengan `template` kata kunci.

   ```
   {{ template "email.subject" . }}
   ```

## Membuat template untuk pesan email
<a name="v10-alerting-create-template-message"></a>

Buat templat untuk pesan email yang berisi ringkasan semua peringatan yang diaktifkan dan diselesaikan, seperti dalam contoh ini:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Untuk membuat template untuk pesan email**

1. Buat template notifikasi yang disebut `email` dengan dua templat dalam konten: `email.message_alert` dan`email.message`.

   `email.message_alert`Template digunakan untuk mencetak label dan nilai untuk setiap peringatan yang diaktifkan dan diselesaikan sementara `email.message` template berisi struktur email.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Text Body** dengan `template` kata kunci.

   ```
   {{ template "email.message" . }}
   ```

## Membuat template untuk judul pesan Slack
<a name="v10-alerting-create-template-slack-title"></a>

Buat template untuk judul pesan Slack yang berisi jumlah peringatan yang diaktifkan dan diselesaikan, seperti pada contoh berikut:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk judul pesan Slack**

1. Buat template yang disebut `slack.title` dengan konten berikut:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Jalankan template dari bidang judul dalam integrasi titik kontak Anda.

   ```
   {{ template "slack.title" . }}
   ```

## Membuat template untuk konten pesan Slack
<a name="v10-alerting-create-template-slack-message"></a>

Buat template untuk konten pesan Slack yang berisi deskripsi semua peringatan yang diaktifkan dan diselesaikan, termasuk label, anotasi, dan URL Dasbor.

**catatan**  
Template ini hanya untuk peringatan terkelola Grafana. Untuk menggunakan template untuk lansiran terkelola sumber data, hapus referensi ke DashboardURL dan SilenceUrl. [Untuk informasi selengkapnya tentang mengonfigurasi notifikasi Prometheus, lihat dokumentasi Prometheus tentang notifikasi.](https://prometheus.io/docs/alerting/latest/notifications/)

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Untuk membuat template untuk konten pesan Slack**

1. Buat template yang disebut `slack` dengan dua template dalam konten: `slack.print_alert` dan`slack.message`.

   `slack.print_alert`Template digunakan untuk mencetak label, anotasi, dan dasbordURL sementara `slack.message` template berisi struktur notifikasi.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Jalankan template dari bidang isi teks dalam integrasi titik kontak Anda:

   ```
   {{ template "slack.message" . }}
   ```

## Template email dan Slack dengan template bersama
<a name="v10-alerting-create-shared-templates"></a>

Alih-alih membuat template notifikasi terpisah untuk setiap titik kontak, seperti email dan Slack, Anda dapat berbagi template yang sama.

Misalnya, jika Anda ingin mengirim email dengan subjek ini dan pesan Slack dengan judul ini`1 firing alerts, 0 resolved alerts`, Anda dapat membuat templat bersama.

**Untuk membuat template bersama**

1. Buat template yang disebut `common.subject_title` dengan konten berikut:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Untuk email, jalankan template dari bidang subjek dalam integrasi titik kontak email Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Untuk Slack, jalankan template dari bidang judul di integrasi titik kontak Slack Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

## Menggunakan template notifikasi
<a name="v10-alerting-use-notification-templates"></a>

Gunakan templat di titik kontak untuk menyesuaikan notifikasi Anda.

**Untuk menggunakan template saat membuat titik kontak**

1. Dari menu **Peringatan**, pilih tab **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih **Baru**. Sebagai alternatif, Anda dapat mengedit titik kontak yang ada dengan memilih ikon **Edit**.

1. Masukkan templat yang ingin Anda gunakan di bidang, seperti **Pesan** atau **Subjek**. Untuk memasukkan templat, gunakan formulir`{{ template "template_name" . }}`, ganti *template\$1name* dengan nama templat yang ingin Anda gunakan.

1. Pilih **Simpan titik kontak**.

# Referensi templat
<a name="v10-alerting-template-reference"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Bagian ini memberikan informasi referensi untuk membuat template Anda.

**Peringatan (tipe)**

Jenis peringatan berisi data berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Status  |  string  |  `firing` atau `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Label  |  KeyValue  |  Satu set label yang dilampirkan pada peringatan.  | \$1\$1 .Labels \$1\$1 | 
|  Anotasi  |  KeyValue  |  Satu set anotasi yang dilampirkan pada peringatan.  | \$1\$1 .Annotations \$1\$1 | 
| Nilai | KeyValue | Nilai dari semua ekspresi, termasuk Kondisi Klasik | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  waktu.waktu  |  Waktu peringatan mulai menembak.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  waktu.waktu  |  Hanya atur jika waktu akhir peringatan diketahui. Jika tidak, atur ke periode batas waktu yang dapat dikonfigurasi sejak peringatan terakhir diterima.  | \$1\$1 .EndsAt \$1\$1 | 
|  GeneratorURL  |  string  |  Tautan balik ke Grafana atau Alertmanager eksternal.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  SilenceUrl  |  string  |  Tautan untuk membungkam peringatan (dengan label untuk peringatan ini telah diisi sebelumnya). Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  DashboardURL  |  string  |  Tautkan ke dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  PanelURL  |  string  |  Tautkan ke panel dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Sidik jari  |  string  |  Sidik jari yang dapat digunakan untuk mengidentifikasi peringatan.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  string  |  String yang berisi label dan nilai setiap ekspresi yang dikurangi dalam peringatan.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

 ExtendedData Objek berisi properti berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Penerima  |  `string`  |  Nama titik kontak yang mengirimkan notifikasi.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Statusnya adalah `firing` jika setidaknya satu peringatan ditembakkan, jika tidak`resolved`.  |  `{{ .Status }}`  | 
|  Pemberitahuan  |  `[]Alert`  |  Daftar semua peringatan yang ditembakkan dan diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts }} alerts`  | 
|  Peringatan penembakan  |  `[]Alert`  |  Daftar semua peringatan penembakan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Peringatan terselesaikan  |  `[]Alert`  |  Daftar semua peringatan yang diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Label yang mengelompokkan peringatan ini termasuk pemberitahuannya.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Label yang umum untuk semua peringatan dalam notifikasi ini.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Anotasi umum untuk semua peringatan dalam pemberitahuan ini.  |  `{{ .CommonAnnotations }}`  | 
|  URL eksternal  |  `string`  |  Tautan ke ruang kerja Grafana atau Alertmanager yang mengirimkan pemberitahuan ini.  |  `{{ .ExternalURL }}`  | 

**KeyValue jenis**

`KeyValue`Tipe adalah satu set pasangan key/value string yang mewakili label dan anotasi.

Selain akses langsung dari data yang disimpan sebagai a`KeyValue`, ada juga metode untuk menyortir, menghapus, dan mengubah data.


| Nama | Pendapat | Pengembalian | Catatan | Contoh | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Daftar yang diurutkan dari pasangan string kunci dan nilai  |    | `{{ .Annotations.SortedPairs }}` | 
|  Menghapus  |  [] string  |  KeyValue  |  Mengembalikan salinan Key/Value peta tanpa kunci yang diberikan.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nama  |    |  [] string  |  Daftar nama  | `{{ .Names }}` | 
|  Nilai  |    |  [] string  |  Daftar nilai  | `{{ .Values }}` | 

**Waktu**

Waktu dari [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)paket Go. Anda dapat mencetak waktu dalam sejumlah format berbeda. Misalnya, untuk mencetak waktu peringatan diaktifkan dalam format`Monday, 1st January 2022 at 10:00AM`, Anda menulis template berikut:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Anda dapat menemukan referensi untuk format waktu Go [di sini](https://pkg.go.dev/time#pkg-constants).

# Kelola titik kontak
<a name="v10-alerting-manage-contactpoints"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tampilan daftar **titik Kontak** mencantumkan semua titik kontak dan templat notifikasi yang ada.

Pada tab **Titik kontak**, Anda dapat:
+ Cari nama dan jenis titik kontak dan integrasi.
+ Lihat semua titik kontak dan integrasi yang ada.
+ Lihat berapa banyak kebijakan notifikasi yang digunakan untuk setiap titik kontak, dan arahkan langsung ke kebijakan notifikasi yang ditautkan.
+ Lihat status pengiriman notifikasi.
+ Ekspor titik kontak individu atau semua titik kontak dalam format JSON, YAMAL, atau Terraform.
+ Hapus titik kontak yang tidak digunakan oleh kebijakan notifikasi.

Pada tab **Template notifikasi**, Anda dapat:
+ Lihat, edit, salin, atau hapus templat notifikasi yang ada.

# Membungkam pemberitahuan peringatan
<a name="v10-alerting-silences"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menekan pemberitahuan peringatan dengan *diam*. Keheningan hanya menghentikan pemberitahuan agar tidak dibuat: Keheningan tidak mencegah aturan peringatan dievaluasi, dan mereka tidak menghentikan peringatan instance agar tidak ditampilkan di antarmuka pengguna. Saat Anda membungkam peringatan, Anda menentukan jendela waktu untuk ditekan.

**catatan**  
Untuk menekan pemberitahuan peringatan pada interval waktu reguler, misalnya, selama periode pemeliharaan rutin, gunakan [Bisukan waktu](v10-alerting-manage-muting.md) bukan diam.

**Untuk menambahkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences.**

1. Pilih Alertmanager dari dropdown **Alertmanager**.

1. Pilih **Buat Keheningan**.

1. Pilih tanggal mulai dan berakhir di **Silence start and end** untuk menunjukkan kapan keheningan akan berlaku dan kapan harus berakhir.

1. Sebagai alternatif untuk mengatur waktu akhir, di **Durasi**, tentukan berapa lama keheningan diberlakukan. Ini secara otomatis memperbarui waktu akhir di bidang **Mulai dan Akhir Diam**.

1. Di bidang **Label** dan **Nilai**, masukkan satu atau beberapa *Label Pencocokan*. Matcher menentukan aturan mana yang berlaku untuk keheningan. Setiap peringatan yang cocok (dalam status aktif), akan ditampilkan di bidang Instance **lansiran yang terpengaruh**.

1. Secara opsional, tambahkan **Komentar** yang menjelaskan keheningan.

1. Pilih **Kirim**.

**Untuk mengedit keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Temukan keheningan yang ingin Anda edit, lalu pilih **Edit** (ikon pena).

1. Buat perubahan yang diinginkan, lalu pilih **Kirim** untuk menyimpan perubahan Anda.

Anda dapat mengedit keheningan yang ada dengan memilih ikon **Edit** (pena).

**Untuk membuat tautan URL ke formulir diam**

Saat menautkan ke formulir diam, berikan label pencocokan default dan komentar melalui `matcher` dan parameter `comment` kueri. `matcher`Parameter harus dalam format berikut di `[label][operator][value]` mana `operator` parameter dapat berupa salah satu dari yang berikut: `=` (sama, bukan regex), (tidak sama, bukan regex), `!=` (sama, regex), `=~` (tidak sama, regex). `!~` URL dapat berisi banyak parameter kueri dengan kunci`matcher`. Misalnya, untuk menautkan ke formulir diam dengan label `severity=critical` & `cluster!~europe-.*` komentar yang cocok`Silence critical EU alerts`, buat URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Untuk menautkan ke halaman diam baru untuk Alertmanager eksternal, tambahkan parameter kueri `alertmanager`

**Untuk menghilangkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Pilih keheningan yang ingin Anda akhiri, dan pilih **Unsilence**. Ini mengakhiri penindasan peringatan.
**catatan**  
Unsilencing mengakhiri penindasan peringatan, seolah-olah waktu akhir ditetapkan untuk waktu saat ini. Keheningan yang telah berakhir (secara otomatis atau manual) dipertahankan dan terdaftar selama lima hari. Anda tidak dapat menghapus keheningan dari daftar secara manual.

# Lihat dan filter aturan peringatan
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana. Aturan peringatan untuk sumber data yang kompatibel dengan Prometheus juga tercantum di sini. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

Bagian Mimir/Cortex/Loki aturan mencantumkan semua aturan untuk sumber data Mimir, Cortex, atau Loki. Aturan peringatan cloud juga tercantum di bagian ini.

Saat mengelola volume peringatan yang besar, Anda dapat menggunakan kemampuan pencarian aturan peringatan yang diperluas untuk memfilter folder, grup evaluasi, dan aturan. Selain itu, Anda dapat memfilter aturan peringatan berdasarkan propertinya seperti label, status, jenis, dan kesehatan.

## Lihat aturan peringatan
<a name="v10-alerting-manage-rules-view"></a>

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

**Untuk melihat detail peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih **Peringatan, Aturan Peringatan**.** Secara default, tampilan daftar ditampilkan.

1. Di **View as**, Anda dapat beralih antara tampilan Dikelompokkan, Daftar, dan Status dengan memilih opsi yang Anda inginkan.

1. Perluas baris aturan untuk melihat label aturan, anotasi, sumber data, kueri aturan, dan daftar instance peringatan yang dihasilkan dari aturan.

Dari halaman ini, Anda juga dapat membuat salinan aturan peringatan untuk membantu Anda menggunakan kembali aturan yang ada.

## Aturan peringatan ekspor
<a name="v10-alerting-manage-rules-export"></a>

Anda dapat mengekspor aturan ke YAMAL atau JSON di ruang kerja Grafana.
+ Pilih ikon **grup aturan Ekspor** di samping setiap grup aturan peringatan untuk diekspor ke YAMG, JSON, atau Terraform.
+ Pilih **Ekspor aturan** untuk mengekspor semua aturan peringatan terkelola Grafana ke YAMG, JSON, atau Terraform.
+ Pilih **Lainnya**, **Ubah ekspor** di samping setiap aturan peringatan individu dalam grup untuk mengedit aturan peringatan yang disediakan dan mengekspor versi yang dimodifikasi.

## Lihat definisi kueri untuk peringatan yang disediakan
<a name="v10-alerting-manage-rules-querydef"></a>

Lihat definisi kueri hanya-baca untuk peringatan yang disediakan. Periksa dengan cepat apakah kueri aturan peringatan Anda benar, tanpa menyelam ke repositori “as-code” Anda untuk definisi aturan.

**Tampilan yang dikelompokkan**

Tampilan yang dikelompokkan menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \$1. `namespace` `group` Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

**Tampilan negara**

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

## Memfilter aturan peringatan
<a name="v10-alerting-manage-rules-filter"></a>

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.

**Untuk memfilter aturan peringatan**

1. Dari **Pilih sumber data**, pilih sumber data.. Anda dapat melihat aturan peringatan yang menanyakan sumber data yang dipilih.

1. Di **Cari berdasarkan label**, masukkan kriteria pencarian menggunakan pemilih label. Misalnya, `environment=production;region=~US|EU,severity!=warning`.

1. Dari **Filter peringatan menurut negara**, pilih status peringatan yang ingin Anda lihat. Anda dapat melihat aturan peringatan yang cocok dengan status itu. Aturan yang cocok dengan negara bagian lain disembunyikan.

# Bisukan waktu
<a name="v10-alerting-manage-muting"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan diam, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.

## Bisukan waktu vs Keheningan
<a name="v10-alerting-manage-muting-compare"></a>

Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.


| Bisukan waktu | Pembisuan | 
| --- | --- | 
| Menggunakan definisi interval waktu yang dapat terulang kembali. | Memiliki waktu mulai dan berakhir yang tetap. | 
| Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan. | Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak. | 

## Menambahkan waktu bisu
<a name="v10-alerting-manage-muting-add"></a>

Anda dapat membuat pengaturan waktu bisu di ruang kerja Grafana Anda.

**Untuk menambahkan waktu bisu**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Pengaturan Waktu Bisu**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Pilih tombol **\$1 Tambahkan waktu bisu**.

1. Isi formulir untuk membuat [interval waktu](#v10-alerting-manage-muting-interval) yang sesuai dengan waktu bisu Anda.

1. Simpan waktu bisu Anda.

## Menambahkan waktu bisu ke kebijakan notifikasi
<a name="v10-alerting-manage-muting-add-notif"></a>

Setelah Anda memiliki waktu bisu, Anda menggunakannya dengan menambahkannya ke kebijakan notifikasi yang ingin Anda bisukan secara berkala.

**Untuk menambahkan waktu bisu ke kebijakan notifikasi**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Kebijakan pemberitahuan**, lalu pilih tab **Kebijakan Pemberitahuan**.

1. **Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, dan pilih...** , **Sunting**.

1. Dari menu tarik-turun **Pengaturan waktu bisu**, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.

1. Simpan perubahan Anda.

## Interval waktu
<a name="v10-alerting-manage-muting-interval"></a>

Interval waktu adalah durasi tertentu di mana peringatan ditekan. Durasi biasanya terdiri dari rentang waktu tertentu dan hari-hari dalam seminggu, bulan, atau tahun. 

Opsi interval waktu Support adalah:
+ **Rentang waktu** — Waktu termasuk waktu mulai dan eksklusif waktu akhir (di UTC, jika tidak ada lokasi yang dipilih, jika tidak ada waktu setempat.
+ **Lokasi** - Menetapkan lokasi untuk waktu—rentang waktu ditampilkan dalam waktu lokal untuk lokasi tersebut.
+ **Hari dalam seminggu** — Hari atau rentang hari dalam seminggu. Misalnya, `monday:thursday`.
+ **Hari dalam sebulan** — Tanggal dalam sebulan. Nilai dapat berkisar dari `1` -`31`. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi `-1` mewakili hari terakhir bulan itu.
+ **Bulan** — Bulan dalam setahun baik numerik nama bulan kalender lengkap. Misalnya, `1, may:august`.
+ **Tahun** — Tahun atau tahun untuk interval. Misalnya, `2023:2024`.

Masing-masing elemen ini dapat berupa daftar, dan setidaknya satu item dalam elemen harus dipenuhi untuk menjadi kecocokan. Bidang juga mendukung rentang, menggunakan`:`. Misalnya, `monday:thursday`.

Jika bidang dibiarkan kosong, setiap saat akan cocok dengan bidang. Untuk sekejap untuk mencocokkan interval waktu penuh, semua bidang harus cocok. Waktu bisu dapat berisi beberapa interval waktu.

Jika Anda ingin menentukan durasi yang tepat, tentukan semua opsi yang diperlukan untuk durasi tersebut. Misalnya, jika Anda ingin membuat interval waktu untuk Senin pertama setiap bulan, untuk bulan Maret, Juni, September, dan Desember, antara jam 12:00 dan 24:00 UTC, spesifikasi interval waktu Anda dapat berupa:
+ Rentang waktu:
  + Waktu mulai: `12:00`
  + Waktu akhir: `24:00`
+ Hari dalam seminggu: `monday`
+ Bulan: `3, 6, 9, 12`
+ Hari dalam sebulan: `1:7`

# Lihat keadaan dan kesehatan aturan peringatan
<a name="v10-alerting-manage-rulestate"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Keadaan dan kesehatan aturan peringatan memberi Anda beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen:
+ [Status aturan peringatan](#v10-alerting-manage-rulestate-state)
+ [Status contoh peringatan](#v10-alerting-manage-rulestate-instance)
+ [Peringatan aturan kesehatan](#v10-alerting-manage-rulestate-health)

Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Untuk melihat keadaan dan kesehatan aturan peringatan Anda**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Aturan peringatan** untuk melihat daftar peringatan yang ada.

1. Pilih aturan peringatan untuk melihat keadaan dan kesehatannya.

## Status aturan peringatan
<a name="v10-alerting-manage-rulestate-state"></a>

Aturan peringatan dapat berada di salah satu negara bagian berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam firing keadaan pending atau. | 
| Tertunda | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahpending. | 
| Menembak | Setidaknya satu seri waktu yang dikembalikan oleh mesin evaluasi adalahfiring. | 

**catatan**  
Peringatan beralih pertama ke `pending` dan kemudian`firing`, sehingga dibutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

## Status contoh peringatan
<a name="v10-alerting-manage-rulestate-instance"></a>

Instance peringatan dapat berada di salah satu status berikut:


| Status | Deskripsi | 
| --- | --- | 
| Normal | Keadaan peringatan yang bukan pending ataufiring. Semuanya bekerja seperti yang diharapkan. | 
| Tertunda | Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi. | 
| Peringatan | Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi. | 
| Tidak ada data | Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi. | 
| Peringatan | Terjadi kesalahan saat mencoba mengevaluasi aturan peringatan. | 

## Pertahankan status terakhir
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Aturan peringatan dapat dikonfigurasi untuk mempertahankan status terakhir saat `Error` status `NoData` atau ditemui. Ini akan mencegah peringatan dari penembakan, dan dari penyelesaian dan penembakan kembali. Sama seperti evaluasi normal, aturan peringatan akan bertransisi dari `pending` ke `firing` setelah periode tertunda telah berlalu.

## Peringatan aturan kesehatan
<a name="v10-alerting-manage-rulestate-health"></a>

Aturan peringatan dapat memiliki salah satu status kesehatan berikut.


| Status | Deskripsi | 
| --- | --- | 
| Ok | Tidak ada kesalahan saat mengevaluasi aturan peringatan. | 
| Kesalahan | Terjadi kesalahan saat mengevaluasi aturan peringatan. | 
| NoData | Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan. | 
| \$1status\$1, KeepLast | Aturan akan menerima status lain, tetapi dikonfigurasi untuk mempertahankan status terakhir dari aturan peringatan. | 

## Peringatan khusus untuk NoData dan Kesalahan
<a name="v10-alerting-manage-rulestate-special"></a>

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, peringatan Grafana akan menghasilkan instance peringatan yang memiliki label tambahan berikut.


| Label | Deskripsi | 
| --- | --- | 
| nama peringatan | Entah DatasourceNoData atauDatasourceError, tergantung negara. | 
| datasource\$1uid | UID dari sumber data yang menyebabkan negara. | 

**catatan**  
Anda perlu mengatur tidak ada data atau penanganan kesalahan ke `NoData` atau `Error` dalam aturan peringatan, seperti yang dijelaskan dalam [Konfigurasikan aturan peringatan terkelola Grafana](v10-alerting-configure-grafanamanaged.md) topik, untuk menghasilkan label tambahan.

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa, termasuk menambahkan keheningan, perutean ke titik kontak, dan sebagainya.

# Lihat dan filter menurut grup peringatan
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grup peringatan menampilkan peringatan yang dikelompokkan dari instance Alertmanager. Secara default, aturan peringatan dikelompokkan berdasarkan kunci label untuk kebijakan default dalam kebijakan notifikasi. Mengelompokkan aturan peringatan umum ke dalam satu grup peringatan mencegah aturan peringatan duplikat dipecat.

Anda dapat melihat grup peringatan dan juga memfilter aturan peringatan yang sesuai dengan kriteria tertentu.

**Untuk melihat grup peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih Peringatan.**

1. Pilih **Grup** untuk melihat grup yang ada.

1. Dari tarik-turun **Alertmanager**, pilih Alertmanager eksternal sebagai sumber data Anda.

1. Dari **grup Kustom menurut** tarik-turun, pilih kombinasi label untuk melihat pengelompokan selain default. Ini berguna untuk men-debug dan memverifikasi pengelompokan kebijakan pemberitahuan Anda.

Jika peringatan tidak berisi label yang ditentukan baik dalam pengelompokan kebijakan root atau pengelompokan kustom, maka peringatan akan ditambahkan ke grup catch all dengan header. `No grouping`

Anda dapat memfilter peringatan berdasarkan label atau status peringatan.

**Untuk memfilter berdasarkan label**
+ Di **Penelusuran**, masukkan label yang ada untuk melihat peringatan yang cocok dengan label.

  Misalnya, `environment=production,region=~US|EU,severity!=warning`.

**Untuk memfilter menurut negara**
+ Di **Negara Bagian**, pilih dari Status Aktif, Ditekan, atau Tidak Diproses untuk melihat peringatan yang cocok dengan status yang Anda pilih. Semua peringatan lainnya disembunyikan.

# Lihat kesalahan pemberitahuan
<a name="v10-alerting-manage-viewnotificationerrors"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Lihat kesalahan pemberitahuan dan pahami mengapa kesalahan tersebut gagal dikirim atau tidak diterima.

**catatan**  
Fitur ini hanya didukung untuk Grafana Alertmanager.

**Untuk melihat kesalahan pemberitahuan**

1. Dari menu sebelah kiri, pilih **Alerting** lalu **Contact points**.

   Jika ada titik kontak yang gagal, pesan di sudut kanan ruang kerja memberi tahu Anda bahwa ada kesalahan, dan berapa banyak.

1. Pilih titik kontak untuk melihat rincian kesalahan untuk titik kontak tersebut.

   Detail kesalahan ditampilkan jika Anda mengarahkan kursor ke ikon Kesalahan.

   Jika titik kontak memiliki lebih dari satu integrasi, Anda melihat semua kesalahan untuk setiap integrasi yang terdaftar.

1. Di kolom Health, periksa status notifikasi.

   Ini bisa berupa OK, Tidak ada upaya, atau Kesalahan.

# Bekerja di Grafana versi 9
<a name="using-grafana-v9"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Saat Anda membuat ruang kerja Grafana, Anda memiliki opsi versi Grafana mana yang akan digunakan. Topik berikut menjelaskan penggunaan ruang kerja Grafana yang menggunakan Grafana versi 9.

**Topics**
+ [Dasbor di Grafana versi 9](v9-dashboards.md)
+ [Panel dan visualisasi dalam Grafana versi 9](v9-panels.md)
+ [Jelajahi di Grafana versi 9](v9-explore.md)
+ [Peringatan di Grafana versi 9](v9-alerts.md)

# Dasbor di Grafana versi 9
<a name="v9-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Dasbor adalah satu set dari satu atau lebih [panel](v9-panels.md) yang diatur dan disusun menjadi satu atau lebih baris. Grafana dikirimkan dengan berbagai panel sehingga mudah untuk membuat kueri yang tepat, dan menyesuaikan visualisasi sehingga Anda dapat membuat dasbor yang sempurna untuk kebutuhan Anda. Setiap panel dapat berinteraksi dengan data dari apa pun yang dikonfigurasi[Connect ke sumber data](AMG-data-sources.md).

Snapshot dasbor bersifat statis. Kueri dan ekspresi tidak dapat dijalankan kembali dari snapshot. Akibatnya, jika Anda memperbarui variabel apa pun dalam kueri atau ekspresi Anda, itu tidak akan mengubah data dasbor Anda.

**Topics**
+ [Menggunakan dasbor](v9-dash-using-dashboards.md)
+ [Membangun dasbor](v9-dash-building-dashboards.md)
+ [Mengelola dasbor](v9-dash-managing-dashboards.md)
+ [Berbagi dasbor dan panel](v9-dash-sharing.md)
+ [Mengelola daftar putar](v9-dash-managing-playlists.md)
+ [Menambahkan dan mengelola variabel dasbor](v9-dash-variables.md)
+ [Menilai penggunaan dasbor](v9-dash-assess-dashboard-usage.md)
+ [Mencari Dasbor di Grafana versi 9](v9-search.md)

# Menggunakan dasbor
<a name="v9-dash-using-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini memberikan ikhtisar fitur dasbor dan pintasan, dan menjelaskan cara menggunakan pencarian dasbor.

## Fitur
<a name="v9-dash-features"></a>

Anda dapat menggunakan dasbor untuk menyesuaikan presentasi data Anda dengan cara berikut.


|  Fitur  |  Deskripsi  | 
| --- | --- | 
| **1. Rumah** | Klik ikon beranda Grafana untuk diarahkan ke halaman beranda yang dikonfigurasi dalam instance Grafana. | 
| **2. Judul** | Saat Anda mengklik judul dasbor, Anda dapat mencari dasbor yang terdapat di folder saat ini. | 
| **3. Berbagi dasbor** | Gunakan opsi ini untuk membagikan dasbor saat ini dengan tautan atau snapshot. Anda juga dapat mengekspor definisi dasbor dari modal saham. | 
| **4. Menambahkan panel baru** | Gunakan opsi ini untuk menambahkan panel, baris dasbor, atau panel perpustakaan ke dasbor saat ini. | 
| **5. Pengaturan dasbor** | Gunakan opsi ini untuk mengubah nama dasbor, folder, dan tag dan mengelola variabel dan kueri anotasi. Untuk informasi selengkapnya tentang setelan dasbor, lihat[Memodifikasi pengaturan dasbor](v9-dash-modify-settings.md). | 
| **6. Dropdown pemilih waktu** |  Klik untuk memilih opsi rentang waktu relatif dan mengatur rentang waktu absolut kustom. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7. Memperkecil rentang waktu**  | Klik untuk memperkecil rentang waktu. Untuk informasi selengkapnya tentang cara menggunakan kontrol rentang waktu, lihat[Pengaturan rentang waktu dasbor](#v9-dash-setting-dashboard-time-range).  | 
| **8. Dasbor penyegaran** | Klik untuk segera memicu kueri dan menyegarkan data dasbor. | 
| **9. Menyegarkan interval waktu dasbor** | Klik untuk memilih interval waktu penyegaran otomatis dasbor. | 
| **10. Mode tampilan**  | Klik untuk menampilkan dasbor di layar besar seperti TV atau kios. Mode tampilan menyembunyikan informasi yang tidak relevan seperti menu navigasi.  | 
| **11. Panel dasbor** |  Blok bangunan utama dasbor adalah panel. Untuk menambahkan panel baru, baris dasbor, atau panel pustaka, klik **Tambahkan panel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12. Legenda grafik** | Ubah warna seri, sumbu y, dan visibilitas seri langsung dari legenda. | 
| **13. Pencarian dasbor** | Klik **Cari** untuk mencari dasbor berdasarkan nama atau judul panel. | 
| **14. Baris dasbor** | Baris dasbor adalah pembagi logis dalam dasbor yang mengelompokkan panel bersama-sama. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## Pintasan keyboard
<a name="v9-dash-keyboard-shortcuts"></a>

Grafana memiliki sejumlah pintasan keyboard yang tersedia. **Untuk menampilkan semua pintasan keyboard yang tersedia untuk Anda, tekan?** atau **h** pada keyboard Anda.
+ `Ctrl+S`menyimpan dasbor saat ini. 
+ `f`membuka pencari dasbor/pencarian. 
+  `d+k`beralih mode kios (menyembunyikan menu). 
+ `d+e`memperluas semua baris. 
+ `d+s`membuka pengaturan dasbor. 
+ `Ctrl+K`membuka palet perintah.
+ `Esc`keluar dari panel saat dalam tampilan layar penuh atau mode edit. Juga mengembalikan Anda ke dasbor dari pengaturan dasbor.

**Panel terfokus**

Untuk menggunakan pintasan yang menargetkan panel tertentu, arahkan kursor ke panel dengan penunjuk Anda.
+ `e`beralih tampilan edit panel 
+ `v`beralih tampilan layar penuh panel 
+ `ps`membuka fitur berbagi panel 
+ `pd`panel duplikat 
+ `pr`menghapus panel 
+ `pl`beralih legenda panel 

## Pengaturan rentang waktu dasbor
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana menyediakan beberapa cara untuk mengelola rentang waktu data yang divisualisasikan, untuk dasbor, panel dan juga untuk peringatan.

Bagian ini menjelaskan unit waktu dan rentang relatif yang didukung, kontrol waktu umum, pengaturan waktu di seluruh dasbor, dan pengaturan waktu khusus panel.

**Satuan waktu dan rentang relatif**

Grafana mendukung satuan waktu berikut:`s (seconds)`,,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)` `M (months)``Q (quarters)`, dan. `y (years)` 

Operator minus memungkinkan Anda untuk mundur dalam waktu, relatif terhadap sekarang. Jika Anda ingin menampilkan periode penuh unit (hari, minggu, atau bulan), tambahkan `/<time unit>` ke akhir. Untuk melihat periode fiskal, penggunaan `fQ (fiscal quarter)` dan satuan `fy (fiscal year)` waktu.

Operator plus memungkinkan Anda untuk melangkah maju dalam waktu, relatif terhadap sekarang. Misalnya, Anda dapat menggunakan fitur ini untuk melihat data yang diprediksi di masa mendatang.

Tabel berikut memberikan contoh rentang relatif.


| Contoh rentang relatif | Dari | Ke | 
| --- | --- | --- | 
| 5 menit terakhir |  `now-5m`  |  `now`  | 
| Hari sejauh ini |  `now/d`  |  `now`  | 
| Minggu ini |  `now/w`  |  `now/w`  | 
| Minggu ini sejauh ini |  `now/w`  |  `now`  | 
| Bulan ini |  `now/M`  |  `now/M`  | 
| Bulan ini sejauh ini |  `now/M`  |  `now`  | 
| Bulan Sebelumnya |  `now-1M/M`  |  `now-1M/M`  | 
| Tahun ini sejauh ini |  `now/Y`  |  `now`  | 
| Tahun ini |  `now/Y`  |  `now/Y`  | 
| Tahun fiskal sebelumnya |  `now-1y/fy`  |  `now-1y/fy`  | 

**catatan**  
 Grafana Alerting tidak mendukung stempel waktu masa `now+n` depan dan `now-1n/n` untuk *awal n hingga akhir n* stempel waktu. 

**Kontrol rentang waktu umum**

Kontrol waktu dasbor dan panel memiliki antarmuka pengguna yang umum. Berikut ini menjelaskan kontrol rentang waktu umum.
+ Rentang waktu saat ini, juga disebut *pemilih waktu*, menunjukkan rentang waktu yang saat ini ditampilkan di dasbor atau panel yang Anda lihat. Arahkan kursor ke lapangan untuk melihat stempel waktu yang tepat dalam rentang dan sumbernya (seperti browser lokal). Klik *rentang waktu saat ini* untuk mengubahnya. Anda dapat mengubah waktu saat ini menggunakan *rentang waktu relatif*, seperti 15 menit terakhir, atau rentang waktu absolut, seperti `2020-05-14 00:00:00` untuk`2020-05-15 23:59:59`.
+ **Rentang waktu relatif** dapat dipilih dari daftar **rentang waktu relatif**. Anda dapat memfilter daftar menggunakan bidang input di bagian atas. Beberapa contoh rentang waktu termasuk *30 menit terakhir*, *12 jam terakhir*, *7 hari terakhir*, *2 tahun terakhir*, *Kemarin*, *Hari sebelum kemarin*, *Hari ini minggu lalu*, *Hari ini sejauh* *ini, Minggu ini sejauh* ini, dan *Bulan ini sejauh* ini.
+ **Rentang waktu absolut** dapat diatur dalam dua cara: Mengetik nilai waktu yang tepat atau nilai waktu relatif ke dalam bidang **Dari** dan **Ke** dan mengklik **Terapkan rentang waktu**, atau mengklik rentang tanggal atau tanggal dari kalender yang ditampilkan saat Anda mengklik **Dari** atau **Ke** bidang. Untuk menerapkan pilihan Anda, klik **Terapkan rentang waktu**.

*Fitur rentang waktu lainnya*

1. **Untuk memperkecil, klik **Cmd\$1Z atau Ctrl\$1Z**.** Klik ikon untuk melihat rentang waktu yang lebih besar di dasbor atau visualisasi panel.

1. Untuk menggunakan fitur zoom in, klik dan seret untuk memilih rentang waktu dalam visualisasi yang ingin Anda lihat.

**catatan**  
Zoom in hanya berlaku untuk visualisasi grafik. 

*Segarkan dasbor*

Klik ikon **Segarkan dasbor** untuk segera menjalankan setiap kueri di dasbor dan menyegarkan visualisasi. Grafana membatalkan permintaan yang tertunda saat Anda memicu penyegaran.

Secara default, Grafana tidak secara otomatis menyegarkan dasbor. Kueri berjalan sesuai jadwal mereka sendiri sesuai dengan pengaturan panel. Namun, jika Anda ingin menyegarkan dasbor secara teratur, klik panah bawah di sebelah ikon **Refresh dashboard** dan kemudian pilih interval penyegaran.

**Kontrol rentang waktu menggunakan URL**

Anda dapat mengontrol rentang waktu dasbor dengan memberikan parameter kueri berikut di URL dasbor.
+ `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms, atau waktu [relatif](#v9-dash-setting-dashboard-time-range).
+ `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms, atau waktu relatif.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

# Membangun dasbor
<a name="v9-dash-building-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setelah Anda membuat ruang kerja Grafana dan masuk, Anda dapat membuat dasbor dan memodifikasi pengaturan agar sesuai dengan kebutuhan Anda. 

**Topics**
+ [Membuat dasbor](v9-dash-creating.md)
+ [Tambahkan atau edit panel](v9-dash-edit-panels.md)
+ [Memodifikasi pengaturan dasbor](v9-dash-modify-settings.md)
+ [Variabel URL dasbor](v9-dash-dashboard-url-variables.md)
+ [Menambahkan panel pustaka ke dasbor Anda](v9-dash-manage-library-panels.md)
+ [Mengelola riwayat versi dasbor](v9-dash-manage-version-history.md)
+ [Mengelola tautan dasbor](v9-dash-manage-dashboard-links.md)
+ [Dasbor model JSON](v9-dash-dashboard-json-model.md)

# Membuat dasbor
<a name="v9-dash-creating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

**Membuat dasbor**

Dasbor dan panel memungkinkan Anda menampilkan data Anda dalam bentuk visual menggunakan Grafana. Setiap panel membutuhkan setidaknya satu kueri untuk menampilkan visualisasi. Sebelum Anda memulai, selesaikan prasyarat berikut.
+ Pastikan Anda memiliki izin yang tepat. Untuk informasi selengkapnya tentang izin, lihat [Pengguna, tim, dan izin](Grafana-administration-authorization.md).
+ Identifikasi dasbor yang ingin Anda tambahkan panel.
+ Memahami bahasa kueri dari sumber data target.
+ Pastikan bahwa sumber data yang Anda tulis kueri telah ditambahkan.

 Untuk membuat dasbor:

1. **Masuk ke Grafana, arahkan kursor Anda ke **Dasbor, dan klik \$1 Dasbor** Baru.**

1. Klik **Tambahkan panel baru**.

1. Di baris pertama tab **Query**, klik daftar dropdown dan pilih sumber data.

1. Tulis atau buat kueri dalam bahasa kueri sumber data Anda.

1. Dalam daftar **Visualisasi**, pilih jenis visualisasi. Grafana menampilkan pratinjau hasil kueri Anda dengan visualisasi yang diterapkan. Untuk informasi selengkapnya, lihat [Opsi visualisasi](v9-panels-viz.md).

1. Sesuaikan pengaturan panel dengan cara berikut.
   + [Konfigurasikan pemetaan nilai](v9-panels-configure-value-mappings.md)
   + [Opsi khusus visualisasi](v9-panels-viz.md)
   + [Ganti nilai bidang](v9-panels-configure-overrides.md)
   + [Konfigurasikan ambang batas](v9-panels-configure-thresholds.md)
   + [Konfigurasikan opsi standar](v9-panels-configure-standard-options.md)
**catatan**  
Sebagian besar visualisasi memerlukan beberapa penyesuaian sebelum mereka menampilkan informasi yang Anda butuhkan dengan benar.

1. Tambahkan catatan untuk menggambarkan visualisasi (atau jelaskan perubahan Anda) dan kemudian klik **Simpan** di sudut kanan atas halaman.
**catatan**  
Catatan sangat membantu jika Anda perlu mengembalikan dasbor ke versi sebelumnya.

**Mengkonfigurasi baris berulang**

Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua baris di dasbor. Untuk informasi selengkapnya tentang panel berulang, lihat [Mengonfigurasi panel berulang.]()

Anda juga dapat mengulang baris jika Anda memiliki variabel yang ditetapkan dengan `Multi-value` atau `Include all values` dipilih.

Sebelum Anda memulai, pastikan bahwa kueri menyertakan variabel multi-nilai, maka Anda harus menyelesaikan langkah-langkah berikut.

1. Pada halaman beranda dasbor, klik **Tambahkan panel**.

1. Pada kotak dialog **Add a panel**, klik **Add a new row**.

1. Arahkan kursor ke judul baris dan klik ikon roda gigi.

1. Pada kotak dialog **Opsi Baris**, tambahkan judul dan pilih variabel yang ingin Anda tambahkan baris berulang.
**catatan**  
 Untuk memberikan konteks kepada pengguna dasbor, tambahkan variabel ke judul baris. 

**Untuk memindahkan panel**

1. Buka dasbor.

1. Klik judul panel dan seret panel ke lokasi baru. Anda dapat menempatkan panel di dasbor di lokasi mana pun.

**Untuk mengubah ukuran panel**

1. Buka dasbor.

1. Untuk menyesuaikan ukuran panel, klik dan seret sudut kanan bawah panel. Anda dapat mengukur panel dasbor sesuai dengan kebutuhan Anda.

# Tambahkan atau edit panel
<a name="v9-dash-edit-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setelah Anda membuat dasbor, Anda dapat menambahkan, mengedit, atau menghapus panel kapan saja.
+ **Lihat dasbor**: Untuk melihat dasbor, dari menu **Beranda**, pilih **Dasbor**, lalu pilih dasbor yang ingin Anda lihat. Anda mungkin harus memperluas folder yang berisi dasbor.
+ **Tambahkan panel**: Untuk menambahkan panel ke dasbor, pilih ikon **Add panel** di bilah menu di dekat bagian atas halaman.
+ **Edit panel** Untuk mengedit panel yang ada di dasbor, pilih ikon menu yang muncul saat Anda mengarahkan kursor ke panel, lalu pilih **Edit**.
+ **Hapus panel** Untuk menghapus panel yang ada di dasbor, pilih ikon menu yang muncul saat Anda mengarahkan kursor ke panel, lalu pilih **Hapus**.

# Memodifikasi pengaturan dasbor
<a name="v9-dash-modify-settings"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman pengaturan dasbor memungkinkan Anda untuk:
+ Edit properti dasbor umum, termasuk pengaturan waktu.
+ Tambahkan kueri anotasi.
+ Tambahkan variabel dasbor.
+ Tambahkan tautan.
+ Lihat model JSON dasbor

Untuk mengakses halaman pengaturan dasbor:

1. Buka dasbor dalam mode edit.

1. Klik **Pengaturan dasbor** (ikon roda gigi) yang terletak di bagian atas halaman.

**Memodifikasi pengaturan waktu dasbor**

Sesuaikan pengaturan waktu dasbor saat Anda ingin mengubah zona waktu dasbor, waktu browser lokal, dan tentukan interval waktu penyegaran otomatis.

**Untuk memodifikasi pengaturan waktu dasbor**

1. Pada halaman Pengaturan **dasbor**, pilih **Umum**.

1. Arahkan ke bagian **Opsi Waktu**.

1. Tentukan pengaturan waktu sesuai dengan deskripsi berikut.

1. Timezone menentukan zona waktu lokal dari layanan atau sistem yang Anda pantau. Ini dapat membantu ketika memantau sistem atau layanan yang beroperasi di beberapa zona waktu.
   + Grafana menggunakan zona waktu *default* yang dipilih untuk profil pengguna, tim, atau organisasi. Jika tidak ada zona waktu yang ditentukan untuk profil pengguna, tim yang menjadi anggota pengguna, atau organisasi, maka Grafana menggunakan waktu browser lokal.
   + Zona waktu yang dikonfigurasi untuk browser pengguna yang melihat, *waktu browser lokal*, digunakan. Ini biasanya zona waktu yang sama seperti yang diatur di komputer.
   + Gunakan [zona waktu standar ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), termasuk UTC.
+ **Penyegaran otomatis** menyesuaikan opsi yang ditampilkan untuk waktu relatif dan opsi penyegaran otomatis Entri dipisahkan koma dan menerima unit waktu yang valid.
+ **Sekarang penundaan** mengesampingkan `now` waktu dengan memasukkan waktu tunda. Gunakan opsi ini untuk mengakomodasi penundaan yang diketahui dalam agregasi data untuk menghindari nilai nol.
+ **Sembunyikan pemilih waktu** menghapus tampilan pemilih waktu Grafana.

**catatan**  
Untuk memiliki kontrol waktu, data Anda harus menyertakan kolom waktu. Lihat dokumentasi untuk [sumber data](AMG-data-sources.md) spesifik Anda untuk informasi selengkapnya tentang menyertakan kolom waktu.

**Menambahkan kueri anotasi**

Kueri anotasi adalah kueri yang membuat kueri untuk acara. Peristiwa ini dapat divisualisasikan dalam grafik di dasbor sebagai garis vertikal bersama dengan ikon kecil yang dapat Anda arahkan kursor untuk melihat informasi acara.

**Untuk menambahkan n kueri anotasi**

1. Pada halaman **Pengaturan dasbor**, pilih **Anotasi**.

1. Pilih **Tambahkan kueri anotasi**. 

1. Masukkan nama dan pilih sumber data.

1. Lengkapi sisa formulir untuk membuat kueri dan anotasi.

UI editor kueri berubah berdasarkan sumber data yang Anda pilih. lihat dokumentasi [sumber data](AMG-data-sources.md) untuk detail tentang cara membuat kueri.

**Menambahkan variabel**

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Untuk informasi selengkapnya tentang variabel, lihat [Variabel](v9-dash-variables.md).

1. Pada halaman **pengaturan Dasbor**, klik **Variabel** di menu bagian sisi kiri dan kemudian tombol **Tambahkan variabel**.

1. Di bagian **Umum**, nama variabel. Ini adalah nama yang nantinya akan Anda gunakan dalam kueri.

1. Pilih variabel **Type**.
**catatan**  
Jenis variabel yang Anda pilih memengaruhi bidang mana yang Anda isi di halaman.

1. Tentukan variabel dan klik **Perbarui**.

**Menambahkan tautan**

Tautan dasbor memungkinkan Anda menempatkan tautan ke dasbor dan situs web lain langsung di bawah header dasbor. Tautan menyediakan navigasi yang mudah ke dasbor dan konten terkait lainnya. 

1.  Pada halaman **pengaturan Dasbor**, klik **Tautan** di menu bagian sebelah kiri dan kemudian tombol **Tambahkan tautan**. 

1.  Masukkan judul dan dan di bidang **Jenis**, pilih **Dasbor** atau **Tautan**. 

1.  Untuk menambahkan tautan dasbor, tambahkan tag opsional, pilih salah satu opsi tautan dasbor, dan klik **Terapkan**. 
**catatan**  
Tag berguna untuk membuat dropdown dinamis dasbor yang semuanya memiliki tag tertentu. 

1.  Untuk menambahkan tautan, tambahkan URL dan teks tooltip yang muncul saat pengguna mengarahkan kursor ke tautan, pilih ikon yang muncul di sebelah tautan, dan pilih salah satu opsi tautan dasbor. 

**Lihat dasbor model JSON** 

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbornya. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, kueri panel, dan sebagainya. 

Untuk melihat model JSON dasbor, pada halaman **pengaturan Dasbor**, klik **JSON**.

Untuk informasi selengkapnya tentang bidang JSON, lihat bidang [JSON](v9-dash-dashboard-json-model.md).

# Variabel URL dasbor
<a name="v9-dash-dashboard-url-variables"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana dapat menerapkan nilai variabel yang diteruskan sebagai parameter kueri di dasbor. URLs Untuk informasi selengkapnya, lihat [Mengelola tautan dasbor](v9-dash-manage-dashboard-links.md) serta [Template dan variabel](v9-dash-variables.md).

**Melewati variabel sebagai parameter kueri**

Grafana menafsirkan parameter string kueri yang diawali dengan variabel di `var-` dasbor yang diberikan.

Misalnya, di URL ini: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Parameter query `var-example=value` merupakan contoh variabel dashboard dengan nilai`value`.

**Melewati beberapa nilai untuk variabel**

Untuk melewatkan beberapa nilai, ulangi parameter variabel sekali untuk setiap nilai.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana menafsirkan `var-example=value1&var-example=value2` sebagai contoh variabel dasbor dengan dua nilai: dan. `value1` `value2`

**Menambahkan variabel ke tautan dasbor**

Grafana dapat menambahkan variabel ke tautan dasbor saat Anda membuatnya dari pengaturan dasbor. Untuk informasi selengkapnya dan langkah-langkah untuk menambahkan variabel, lihat [Mengelola tautan dasbor](v9-dash-manage-dashboard-links.md).

**Melewati filter ad hoc**

Filter ad hoc menerapkan filter kunci atau nilai ke semua kueri metrik yang menggunakan sumber data tertentu. Untuk informasi selengkapnya, lihat [Filter ad hoc]().

Untuk meneruskan filter ad hoc sebagai parameter kueri, gunakan sintaks variabel untuk meneruskan variabel filter ad hoc, dan juga berikan kunci, operator sebagai nilai, dan nilai sebagai daftar yang dipisahkan pipa.

Misalnya, di URL ini:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Parameter kueri `var-adhoc=key|=|value` menerapkan filter ad hoc yang dikonfigurasi sebagai variabel dasbor adhoc menggunakan `example_key` kunci, `=` operator, dan nilainya. `example_value`

**catatan**  
Saat berbagi URLs dengan filter ad hoc, ingatlah untuk menyandikan URL. Dalam contoh di atas, ganti pipa `(|)` dengan `%7C` dan operator kesetaraan `(=)` dengan` %3D`.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengatur rentang waktu dasbor, gunakan parameter`from`,`to`,`time`, dan `time.window` kueri. Karena ini bukan variabel, mereka tidak memerlukan `var-` awalan.

# Menambahkan panel pustaka ke dasbor Anda
<a name="v9-dash-manage-library-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel perpustakaan adalah panel yang dapat digunakan kembali yang dapat Anda gunakan di dasbor apa pun. Saat Anda mengubah panel pustaka, perubahan menyebar ke semua contoh di mana panel digunakan. Panel perpustakaan merampingkan penggunaan kembali panel di beberapa dasbor.

Anda dapat menyimpan panel perpustakaan di folder bersama dasbor yang disimpan.

**Membuat panel perpustakaan**

Saat Anda membuat panel pustaka, panel di dasbor sumber juga dikonversi ke panel perpustakaan. Anda perlu menyimpan dasbor asli setelah panel dikonversi.

1. Buka panel dalam mode edit.

1. Dalam opsi tampilan panel, klik opsi panah bawah untuk membawa perubahan pada visualisasi.

1. Untuk membuka kotak dialog **Buat**, klik opsi **Panel perpustakaan**, lalu klik **Buat panel perpustakaan**.

1. Di **nama panel Perpustakaan**, masukkan nama.

1. Di **Simpan di folder**, pilih folder untuk menyimpan panel perpustakaan.

1. Untuk menyimpan perubahan, klik **Buat panel pustaka**.

1. Untuk menyimpan dasbor, klik **Simpan**.

Setelah panel perpustakaan dibuat, Anda dapat memodifikasi panel menggunakan dasbor apa pun yang muncul. Setelah Anda menyimpan perubahan, semua instance panel pustaka mencerminkan modifikasi ini.

**Menambahkan panel pustaka ke dasbor**

Tambahkan panel pustaka Grafana ke dasbor saat Anda ingin memberikan visualisasi kepada pengguna dasbor lainnya.

1. Arahkan kursor ke opsi **Dasbor** di menu sebelah kiri, lalu pilih **Dasbor baru** dari opsi tarik-turun. Kotak dialog **Add panel** akan terbuka.

1. Klik opsi **Tambahkan panel** dari pustaka panel. Anda akan melihat daftar panel perpustakaan Anda.

1. Filter daftar atau cari untuk menemukan panel yang ingin Anda tambahkan.

1. Klik panel untuk menambahkannya ke dasbor.

**Membatalkan tautan panel pustaka**

Putuskan tautan panel pustaka saat Anda ingin membuat perubahan pada panel dan tidak memengaruhi contoh panel pustaka lainnya.

1. Arahkan kursor ke **Dasbor** di menu sebelah kiri, lalu klik **Panel Perpustakaan**.

1. Pilih panel perpustakaan yang sedang digunakan di dasbor yang berbeda.

1. Pilih panel yang ingin Anda putuskan tautannya.

1. Klik judul panel dan kemudian klik **Edit**. Panel akan terbuka dalam mode edit.

1. Klik opsi **Putuskan Tautan** di sudut kanan atas halaman.

**Melihat daftar panel pustaka**

Putuskan tautan panel pustaka saat Anda ingin membuat perubahan pada panel dan tidak memengaruhi contoh panel pustaka lainnya.

1. Arahkan kursor ke opsi **Dasbor** di menu sebelah kiri, lalu klik **Panel Perpustakaan**. Anda dapat melihat daftar panel pustaka yang ditentukan sebelumnya.

1. Cari panel perpustakaan tertentu jika Anda tahu namanya. Anda juga dapat memfilter panel berdasarkan folder atau jenis.

**Menghapus panel pustaka**

Hapus panel perpustakaan saat Anda tidak lagi membutuhkannya.

1. Arahkan kursor ke **Dasbor** di menu sebelah kiri, dan pilih **Panel Perpustakaan**.

1. Pilih panel yang ingin Anda hapus.

1. Klik ikon hapus di sebelah nama pustaka.

# Mengelola riwayat versi dasbor
<a name="v9-dash-manage-version-history"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Setiap kali Anda menyimpan versi dasbor Anda, salinan versi itu disimpan sehingga versi dasbor Anda sebelumnya tidak pernah hilang. Daftar versi ini tersedia dengan memasukkan pengaturan dasbor dan kemudian memilih **Versi** di menu sebelah kiri.

Fitur riwayat versi dasbor memungkinkan Anda membandingkan dan mengembalikan ke versi dasbor yang disimpan sebelumnya.

**Membandingkan dua versi dasbor**

Untuk membandingkan dua versi dasbor, pilih dua versi dari daftar yang ingin Anda bandingkan. Klik **Bandingkan versi** untuk melihat perbedaan antara dua versi.

Setelah mengklik tombol, Anda akan dibawa ke tampilan diff. Secara default, Anda akan melihat ringkasan tekstual perubahan.

Jika Anda ingin melihat perbedaan JSON mentah yang mewakili dasbor Anda, Anda dapat melakukannya juga dengan mengklik tombol **View JSON Diff** di bagian bawah.

Jika Anda ingin mengembalikan ke versi yang Anda bedakan, Anda dapat melakukannya dengan mengklik <x>tombol **Pulihkan ke versi** di kanan atas.

**Memulihkan ke versi dasbor yang disimpan sebelumnya**

Jika Anda perlu mengembalikan ke versi dasbor yang disimpan sebelumnya, Anda dapat mengklik tombol **Pulihkan** di sebelah kanan baris dalam daftar versi dasbor, atau klik <x>tombol **Pulihkan ke versi** yang muncul di tampilan diff. Mengklik tombol akan memunculkan pop-up berikut yang meminta Anda untuk mengonfirmasi pemulihan.

Setelah memulihkan ke versi sebelumnya, versi baru akan dibuat yang berisi data yang sama persis dengan versi sebelumnya, hanya dengan nomor versi yang berbeda. Ini ditunjukkan di **kolom Catatan** untuk baris di versi dasbor baru. Ini dilakukan hanya untuk memastikan versi dasbor Anda sebelumnya tidak terpengaruh oleh perubahan.

# Mengelola tautan dasbor
<a name="v9-dash-manage-dashboard-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat menggunakan tautan untuk menavigasi antara dasbor yang umum digunakan atau untuk menghubungkan orang lain ke visualisasi Anda. Tautan memungkinkan Anda membuat pintasan ke dasbor, panel, dan bahkan situs web eksternal lainnya.

Grafana mendukung tautan dasbor, tautan panel, dan tautan data. Tautan dasbor ditampilkan di bagian atas dasbor. Tautan panel dapat diakses dengan mengklik ikon di sudut kiri atas panel.

**Memilih tautan mana yang akan digunakan**

Mulailah dengan mencari tahu bagaimana Anda saat ini menavigasi antar dasbor. Jika Anda sering melompat di antara satu set dasbor dan berjuang untuk menemukan konteks yang sama di masing-masing, tautan dapat membantu mengoptimalkan alur kerja Anda.

Langkah selanjutnya adalah mencari tahu jenis tautan mana yang tepat untuk alur kerja Anda. Meskipun semua jenis tautan di Grafana digunakan untuk membuat pintasan ke dasbor lain atau situs web eksternal, mereka bekerja dalam konteks yang berbeda.
+ Jika tautan terkait dengan sebagian besar jika tidak semua panel di dasbor, gunakan tautan dasbor.
+ Jika Anda ingin menelusuri panel tertentu, gunakan tautan panel.
+ Jika Anda ingin menautkan ke situs eksternal, Anda dapat menggunakan tautan dasbor atau tautan panel.
+ Jika Anda ingin menelusuri seri tertentu, atau bahkan pengukuran tunggal, gunakan tautan data.

**Mengontrol rentang waktu menggunakan URL**

Untuk mengontrol rentang waktu panel atau dasbor, Anda dapat memberikan parameter kueri di URL dasbor:
+ `from`mendefinisikan batas bawah rentang waktu, ditentukan dalam ms epoch.
+ `to`mendefinisikan batas atas rentang waktu, ditentukan dalam ms epoch.
+ `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.

**Tautan dasbor**

Saat Anda membuat tautan dasbor, Anda dapat menyertakan rentang waktu dan variabel template saat ini untuk langsung melompat ke konteks yang sama di dasbor lain. Dengan cara ini, Anda tidak perlu khawatir apakah orang yang Anda kirimi tautan melihat data yang tepat. Untuk jenis tautan lainnya, lihat [Variabel tautan data]().

Tautan dasbor juga dapat digunakan sebagai pintasan ke sistem eksternal, seperti mengirimkan [ GitHub masalah dengan nama dasbor saat ini](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).

Setelah menambahkan tautan dasbor, itu akan muncul di sudut kanan atas dasbor Anda.

**Menambahkan tautan ke dasbor**

Tambahkan tautan ke dasbor lain di bagian atas dasbor Anda saat ini.

1. Saat melihat dasbor yang ingin Anda tautkan, klik roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Klik **Tautan** dan kemudian klik **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di **Type**, pilih **dasbor**.

1. Pilih opsi tautan dari berikut ini.
   + **Dengan tag**: Masukkan tag untuk membatasi dasbor yang ditautkan hanya dengan tag yang Anda masukkan. Jika tidak, Grafana menyertakan tautan ke semua dasbor lainnya.
   + **Sebagai dropdown**: Jika Anda menautkan ke banyak dasbor, maka Anda mungkin ingin memilih opsi ini dan menambahkan judul opsional ke dropdown. Jika tidak, Grafana menampilkan tautan dasbor berdampingan di bagian atas dasbor Anda.
   + **Rentang waktu**: Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
   + **Nilai variabel**: Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan. Untuk informasi selengkapnya, lihat [Variabel URL Dasbor](v9-dash-dashboard-url-variables.md).
   + **Buka di tab baru**: Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru.

1. Klik **Tambah**.

**Menambahkan tautan URL ke dasbor**

Tambahkan tautan ke URL di bagian atas dasbor Anda saat ini. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

1. Saat melihat dasbor yang ingin Anda tautkan, klik roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**.

1. Klik **Tautan** dan kemudian klik **Tambahkan Tautan Dasbor** atau **Baru**.

1. Di Ketik, pilih **Tautan**.

1. Pilih opsi tautan dari berikut ini.
   + **URL**: Masukkan URL yang ingin Anda tautkan. Bergantung pada target, Anda mungkin ingin menyertakan nilai bidang. Untuk informasi lebih lanjut, lihat contoh [Github](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests) ini.
   + **Judul**: Masukkan judul yang ingin ditampilkan tautannya.
   + **Tooltip**: Masukkan tooltip yang ingin ditampilkan tautannya.
   + **Ikon**: Pilih ikon yang ingin ditampilkan dengan tautan.
   + **Rentang waktu**: Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna mengklik tautan, dasbor yang ditautkan akan terbuka dengan rentang waktu yang ditentukan.
     + `from`mendefinisikan batas bawah rentang waktu, ditentukan dalam ms epoch.
     + `to`mendefinisikan batas atas rentang waktu, ditentukan dalam ms epoch.
     + `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
   + **Nilai variabel**: Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna mengklik tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan. 

     Format variabel adalah sebagai berikut: 

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **Buka di tab baru**: Pilih opsi ini jika Anda ingin tautan dasbor terbuka di tab atau jendela baru

1. Klik **Tambah**.

**Memperbarui tautan dasbor**

Untuk mengubah atau memperbarui tautan dasbor yang ada, ikuti prosedur ini.

1. Di **pengaturan Dasbor,** pada tab **Tautan**, klik tautan yang ada yang ingin Anda edit.

1. Ubah pengaturan dan kemudian klik **Perbarui**.

**Menduplikasi tautan dasbor**

Untuk menduplikasi tautan dasbor yang ada, klik ikon duplikat di samping tautan yang ada yang ingin Anda duplikat.

**Menghapus tautan dasbor**

Untuk menghapus tautan dasbor yang ada, klik ikon sampah di samping ikon duplikat yang ingin Anda hapus.

**Tautan panel**

Setiap panel dapat memiliki rangkaian tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana.

Untuk melihat tautan panel yang tersedia, klik ikon di sudut kiri atas panel.
+ **Menambahkan tautan panel**: Setiap panel dapat memiliki kumpulan tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna diperbesar pada data yang tepat di Grafana. Klik ikon di sudut kiri atas panel untuk melihat tautan panel yang tersedia.

  1. Arahkan kursor ke panel yang ingin Anda tambahkan tautannya lalu tekan. `e` **Atau klik panah tarik-turun di sebelah judul panel dan kemudian klik Edit.**

  1. Pada tab **Panel**, gulir ke bawah ke bagian **Tautan**. 

  1. Perluas **Tautan** dan kemudian klik **Tambahkan tautan**.

  1. Masukkan **Judul**. **Judul** adalah label yang dapat dibaca manusia untuk tautan yang akan ditampilkan di UI.

  1. Masukkan **URL** yang ingin Anda tautkan. Anda bahkan dapat menambahkan salah satu variabel template yang ditentukan di dasbor. Tekan `Ctrl+Space` atau `Cmd+Space` dan klik di bidang URL untuk melihat variabel yang tersedia. Dengan menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan.

     Anda juga dapat menggunakan variabel waktu.
     + `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms.
     + `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam epoch ms.
     + `time`dan `time.window` mendefinisikan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam ms. Misalnya `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000.
+ **Memperbarui tautan panel**

  1. Pada tab **Panel**, temukan tautan yang ingin Anda ubah.

  1. Klik ikon **Edit** (pensil) untuk membuka jendela Edit link.

  1. Buat perubahan yang diperlukan.

  1. Klik **Simpan** untuk menyimpan perubahan dan menutup jendela.

  1. Klik **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor.
+ **Menghapus tautan panel**

  1. Pada tab **Panel**, temukan tautan yang ingin Anda ubah.

  1. Klik ikon **X** di sebelah tautan yang ingin Anda hapus.

  1. Klik **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor.

# Dasbor model JSON
<a name="v9-dash-dashboard-json-model"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Dasbor di Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbornya. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, dan kueri panel.

Untuk melihat JSON dasbor.

1. Arahkan ke dasbor.

1. Di menu navigasi atas, klik ikon **Pengaturan dasbor** (roda gigi).

1. Klik **Model JSON**.

**Bidang JSON**

Saat pengguna membuat dasbor baru, objek JSON dasbor baru diinisialisasi dengan bidang berikut.

**catatan**  
Dalam JSON berikut, id ditampilkan sebagai null, yang merupakan nilai default yang ditetapkan untuk itu sampai dashboard disimpan. Setelah dasbor disimpan, nilai integer ditetapkan ke `id` bidang.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Berikut ini menjelaskan setiap bidang di dashboard JSON.


| Nama | Penggunaan | 
| --- | --- | 
| **id** | pengidentifikasi numerik unik untuk dasbor (dihasilkan oleh db) | 
| **uid** | pengidentifikasi dasbor unik yang dapat dihasilkan oleh siapa saja. string (8-40) | 
| **judul** | judul dasbor saat ini | 
| **tag** | tag yang terkait dengan dasbor, array string | 
| **gaya** | tema dashboard, seperti *gelap* atau *terang* | 
| **zona waktu** | *zona waktu dasbor, seperti *utc* atau browser* | 
| **dapat diedit** | jika dasbor dapat diedit atau tidak | 
| **GraphToolTip** | 0 tanpa crosshair bersama atau tooltip (default), 1 untuk crosshair bersama, 2 untuk crosshair bersama dan tooltip bersama | 
| **waktu** | rentang waktu untuk dasbor, seperti *6 jam* *terakhir atau 7 hari* terakhir | 
| **pemetik waktu** | [metadata timepicker, lihat bagian timepicker untuk detailnya](#v9-dash-dashboard-json-model) | 
| **templating** | template metadata, lihat bagian [templating](#v9-dash-dashboard-json-model) untuk detailnya | 
| **anotasi** | metadata anotasi, lihat [anotasi](v9-panels-annotate-visualizations.md) untuk cara menambahkannya | 
| **menyegarkan** | interval penyegaran otomatis | 
| **SchemaVersion** | versi skema JSON (bilangan bulat), bertambah setiap kali pembaruan Grafana membawa perubahan pada skema tersebut | 
| **versi** | versi dasbor (integer), bertambah setiap kali dasbor diperbarui | 
| **panel** | panel array (lihat di bawah untuk detailnya) | 

**Panel**

Panel adalah blok bangunan dasbor. Ini terdiri dari kueri sumber data, jenis grafik, alias, dan banyak lagi. Panel JSON terdiri dari array objek JSON, masing-masing mewakili panel yang berbeda. Sebagian besar bidang umum untuk semua panel tetapi beberapa bidang tergantung pada jenis panel. Berikut ini adalah contoh panel JSON dari panel teks.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Ukuran dan posisi panel**

Properti GridPOS menjelaskan ukuran panel dan posisi dalam koordinat grid.
+ `w`: 1—24 (lebar dasbor dibagi menjadi 24 kolom)
+ `h`: Dalam satuan tinggi grid, masing-masing mewakili 30 piksel.
+ `x`: Posisi x, dalam satuan yang sama dengan`w`.
+ `y`: Posisi y, dalam satuan yang sama dengan`h`.

Grid memiliki gravitasi negatif yang bergerak ke atas panel jika ada ruang kosong di atas panel.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Templating**

`templating`Bidang berisi array variabel template dengan nilai yang disimpan bersama dengan beberapa metadata lainnya.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# Mengelola dasbor
<a name="v9-dash-managing-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Dasbor adalah satu set dari satu atau lebih [panel](v9-panels.md) yang secara visual menyajikan data Anda dalam satu atau lebih baris.

Untuk informasi selengkapnya tentang membuat dasbor, lihat [Menambahkan dan mengatur panel]().

## Membuat folder dasbor
<a name="v9-dash-create-dashboard-folder"></a>

Folder membantu Anda mengatur dan mengelompokkan dasbor, yang berguna ketika Anda memiliki banyak dasbor atau beberapa tim menggunakan instance Grafana yang sama.

**Prasyarat**

Pastikan Anda memiliki izin Admin Grafana. Untuk informasi selengkapnya tentang izin dasbor, lihat Izin [dasbor](Grafana-administration-authorization.md).

**Untuk membuat folder dasbor**

1. Masuk ke Grafana dan di menu samping, klik **Dasbor** > Folder baru

1. Masukkan nama unik dan klik **Buat**.

**catatan**  
Saat Anda menyimpan dasbor, Anda dapat memilih folder untuk dasbor yang akan disimpan atau membuat folder baru.

## Mengelola dasbor dan folder
<a name="v9-dash-manage-dashboard-folder"></a>

Pada halaman **Kelola dasbor dan folder**, Anda dapat:
+ Buat folder
+ Membuat sebuah Dasbor
+ Pindahkan dasbor ke folder
+ Hapus beberapa dasbor
+ Arahkan ke halaman folder tempat Anda dapat menetapkan izin folder dan dasbor

**Halaman folder dasbor**

Anda dapat menyelesaikan tugas-tugas berikut di halaman **Folder Dasbor**:
+ Memindahkan atau menghapus dasbor dalam folder.
+ Ganti nama folder (tersedia di bawah tab **Pengaturan**).
+ Tetapkan izin ke folder (yang diwarisi oleh dasbor di folder).

Untuk menavigasi ke halaman folder dasbor, klik roda gigi yang muncul saat Anda mengarahkan kursor ke folder di daftar hasil pencarian dasbor atau halaman **Kelola dasbor dan** folder.

**Izin dasbor**

Anda dapat menetapkan izin ke folder. Izin apa pun yang Anda tetapkan diwarisi oleh dasbor di folder. Daftar Kontrol Akses (ACL) digunakan di mana **Peran Organisasi**, **Tim**, dan **Pengguna** dapat diberikan izin.

Lihat [izin](Grafana-permissions.md) untuk informasi selengkapnya.

## Mengekspor dan mengimpor dasbor
<a name="v9-dash-export-import-dashboards"></a>

Anda dapat menggunakan Grafana UI atau HTTP API untuk mengekspor dan mengimpor dasbor.

**Mengekspor dasbor**

Tindakan ekspor dasbor membuat file Grafana JSON yang berisi semua yang Anda butuhkan, termasuk tata letak, variabel, gaya, sumber data, kueri, dan sebagainya, sehingga Anda nantinya dapat mengimpor dasbor.

**catatan**  
Grafana mengunduh file JSON ke mesin lokal Anda. 

1. Buka dasbor yang ingin Anda ekspor.

1. Pilih ikon bagikan.

1. Pilih **Ekspor**.

1. Pilih **Simpan ke file.**

**Membuat dasbor portabel**

Jika Anda ingin mengekspor dasbor untuk digunakan orang lain, Anda dapat menambahkan variabel template untuk hal-hal seperti awalan metrik (gunakan variabel konstan) dan nama server.

Variabel template dari jenis ini `Constant` akan secara otomatis disembunyikan di dasbor, dan juga akan ditambahkan sebagai input yang diperlukan saat dasbor diimpor.

**Mengimpor dasbor**

1. Pilih **Dasbor** di menu samping.

1. Pilih **Baru**, lalu pilih **Impor** dari menu tarik-turun.

1. Lakukan salah satu langkah berikut.
   + Unggah file JSON dasbor.
   + Tempel URL dasbor [Grafana.com](https://grafana.com/).
   + Rekatkan teks JSON dasbor langsung ke area teks.

   Proses impor memungkinkan Anda mengubah nama dasbor, memilih sumber data yang ingin digunakan dasbor, dan menentukan awalan metrik apa pun (jika dasbor menggunakannya).

## Memecahkan masalah dasbor
<a name="v9-dash-troubleshooting"></a>

Bagian ini memberikan informasi untuk membantu Anda memecahkan masalah dasbor umum. 

**Dashboard lambat**

Jika dasbor Anda lambat, pertimbangkan hal berikut:
+ Apakah Anda mencoba merender lusinan (atau ratusan atau ribuan) deret waktu pada grafik? Ini dapat menyebabkan browser tertinggal. Coba gunakan fungsi seperti HighestMax (dalam Graphite) untuk mengurangi seri yang dikembalikan.
+ Terkadang nama seri bisa sangat besar. Ini menyebabkan ukuran respons yang lebih besar. Coba gunakan alias untuk mengurangi ukuran nama seri yang dikembalikan.
+ Apakah Anda menanyakan banyak deret waktu atau untuk jangka waktu yang lama? Kedua kondisi ini dapat menyebabkan Grafana atau sumber data Anda menarik banyak data, yang dapat memperlambatnya.
+ Ini bisa menjadi beban tinggi pada infrastruktur jaringan Anda. Jika kelambatan tidak konsisten, ini mungkin masalahnya.

**Masalah kecepatan penyegaran dasbor**

Secara default, Grafana menanyakan sumber data Anda setiap 30 detik. Menyetel kecepatan refresh rendah di dasbor Anda memberi tekanan yang tidak perlu pada backend. Dalam banyak kasus, kueri ini sering tidak diperlukan karena data tidak dikirim ke sistem sehingga perubahan akan terlihat.

Jika Anda memiliki masalah ini, solusi berikut direkomendasikan.
+ Jangan aktifkan penyegaran otomatis di dasbor, panel, atau variabel kecuali Anda membutuhkannya. Pengguna dapat menyegarkan browser mereka secara manual, atau Anda dapat mengatur kecepatan refresh untuk jangka waktu yang masuk akal (seperti sangat sepuluh menit atau setiap jam).
+ Jika diperlukan, maka atur kecepatan refresh menjadi satu menit sekali. Pengguna selalu dapat menyegarkan dasbor secara manual.
+ Jika dasbor Anda memiliki periode waktu yang lebih lama (seperti satu minggu), maka penyegaran otomatis mungkin tidak diperlukan.

**Menangani atau merender data nol salah atau membingungkan**

Beberapa aplikasi mempublikasikan data sebentar-sebentar. Misalnya, mereka hanya memposting metrik ketika suatu peristiwa terjadi. Secara default, grafik Grafana menghubungkan garis antara titik data.

# Berbagi dasbor dan panel
<a name="v9-dash-sharing"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana memungkinkan Anda untuk berbagi dasbor dan panel dengan pengguna lain dalam suatu organisasi dan dalam situasi tertentu, secara publik di Web. Anda dapat berbagi menggunakan:
+ Tautan langsung
+ Sebuah snapshot
+ Tautan ekspor (hanya untuk dasbor)

Anda harus memiliki izin penampil resmi untuk melihat gambar yang diberikan oleh tautan langsung.

Izin yang sama juga diperlukan untuk melihat tautan yang disematkan kecuali Anda mengaktifkan izin akses anonim untuk instance Grafana Anda.

Saat Anda membagikan panel atau dasbor sebagai snapshot, snapshot (yang merupakan panel atau dasbor saat Anda mengambil snapshot) tersedia untuk umum di web. Siapa pun yang memiliki tautan ke sana dapat mengaksesnya. Karena snapshot tidak memerlukan otorisasi apa pun untuk melihat, Grafana menghapus informasi yang terkait dengan akun asalnya, serta data sensitif apa pun dari snapshot.

## Berbagi dasbor
<a name="v9-dash-share-dashboard"></a>

Anda dapat membagikan dasbor sebagai tautan langsung atau sebagai snapshot. Anda juga dapat mengekspor dasbor.

**catatan**  
Jika Anda mengubah dasbor, pastikan Anda menyimpan perubahan sebelum berbagi.

1. Arahkan ke halaman beranda instans Grafana Anda.

1. Klik ikon bagikan di navigasi atas.

   Kotak dialog berbagi akan terbuka dan menampilkan tab **Tautan**.

**Berbagi tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda juga dapat membagikan URL yang dipersingkat.

1. Klik **Salin**. Tindakan ini menyalin URL default atau yang dipersingkat ke clipboard.

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

**Menerbitkan snapshot**

Snapshot dasbor membagikan dasbor interaktif secara publik. Grafana menghapus data sensitif seperti kueri (metrik, templat, dan anotasi) dan tautan panel, hanya menyisakan data metrik yang terlihat dan nama seri yang disematkan di dasbor. Snapshot dasbor dapat diakses oleh siapa saja yang memiliki tautan.

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

1. Klik **Cuplikan Lokal.**

1. Grafana menghasilkan tautan snapshot. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

**Mengekspor dasbor**

Dasbor Grafana dapat dengan mudah diekspor dan diimpor. Untuk informasi selengkapnya, lihat [Mengekspor dan mengimpor dasbor](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards).

## Berbagi panel
<a name="v9-dash-share-panel"></a>

Anda dapat berbagi panel sebagai tautan langsung, atau sebagai snapshot. Anda juga dapat membuat panel perpustakaan menggunakan opsi **Bagikan** pada panel apa pun.

1. Klik judul panel untuk membuka menu panel.

1. Klik **Bagikan**. Kotak dialog berbagi akan terbuka dan menampilkan tab **Tautan**.

**Menggunakan tautan langsung**

Tab **Link** menunjukkan rentang waktu saat ini, variabel template, dan tema default. Anda dapat mengaktifkan URL singkat untuk dibagikan secara opsional. 

1. Klik **Salin** untuk menyalin URL default atau yang dipersingkat ke clipboard. 

1. Kirim URL yang disalin ke pengguna Grafana dengan otorisasi untuk melihat tautan.

1. Anda juga secara opsional mengklik **Tautan langsung gambar yang dirender** untuk berbagi gambar panel.

**Mengkueri parameter string untuk gambar yang dirender sisi server**
+ **lebar**: Lebar dalam piksel. Defaultnya adalah 800.
+ **tinggi**: Tinggi dalam piksel. Defaultnya adalah 400.
+ **tz**: Zona waktu dalam format di `UTC%2BHH%3AMM` mana HH dan MM diimbangi dalam beberapa jam dan menit setelah UTC.
+ **batas waktu**: Jumlah detik. Batas waktu dapat ditingkatkan jika kueri untuk panel membutuhkan lebih dari 30 detik default.
+ **skala**: Nilai numerik untuk mengkonfigurasi faktor skala perangkat. Default-nya adalah 1. Gunakan nilai yang lebih tinggi untuk menghasilkan gambar yang lebih detail (DPI yang lebih tinggi). Didukung di Grafana v7.0\$1.

**Menerbitkan snapshot**

Snapshot panel membagikan panel interaktif secara publik. Grafana menghapus data sensitif hanya menyisakan data metrik yang terlihat dan nama seri yang disematkan di dasbor. Snapshot panel dapat diakses oleh siapa saja yang memiliki tautan

Anda dapat mempublikasikan snapshot ke instans lokal Anda.

1. Dalam kotak dialog **Share Panel**, klik **Snapshot** untuk membuka tab.

1. Klik **Cuplikan Lokal.** Grafana menghasilkan tautan snapshot.

1. Salin tautan snapshot, dan bagikan di dalam organisasi Anda atau secara publik di web.

Jika Anda membuat snapshot secara tidak sengaja, klik **Hapus snapshot untuk menghapus snapshot** dari instance Grafana Anda.

**Membuat panel perpustakaan**

Untuk membuat panel pustaka dari kotak dialog **Share Panel**.

1. Klik **Panel Perpustakaan**.

1. Di **nama panel Perpustakaan**, masukkan nama.

1. Di **Simpan dalam folder**, pilih folder untuk menyimpan panel perpustakaan. Secara default, folder **Umum** dipilih.

1. Klik **Buat panel pustaka** untuk menyimpan perubahan Anda.

1. Klik **Simpan** untuk menyimpan dasbor.

# Mengelola daftar putar
<a name="v9-dash-managing-playlists"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Daftar putar* adalah daftar dasbor yang ditampilkan secara berurutan. Anda dapat menggunakan daftar putar untuk membangun kesadaran situasional atau untuk menyajikan metrik Anda kepada tim atau pengunjung Anda. Grafana secara otomatis menskalakan dasbor ke resolusi apa pun, yang membuatnya sempurna untuk layar besar. Anda dapat mengakses fitur daftar putar dari menu samping Grafana di submenu **Dasbor**.

## Mengakses, berbagi, dan mengendalikan daftar putar
<a name="v9-dash-access-share-control-playlist"></a>

Gunakan informasi di bagian ini untuk mengakses daftar putar yang ada. Mulai dan kendalikan tampilan daftar putar menggunakan salah satu dari lima mode yang tersedia.

**Mengakses daftar putar**

1. Arahkan kursor Anda ke menu samping Grafana.

1. Klik **Daftar Putar**.

   Anda akan melihat daftar daftar putar yang ada.

**Memulai daftar putar**

Anda dapat memulai daftar putar dalam lima mode tampilan berbeda. Mode tampilan menentukan bagaimana menu dan bilah navigasi muncul di dasbor.

Secara default, setiap dasbor ditampilkan untuk jumlah waktu yang dimasukkan di bidang **Interval**, yang Anda atur saat membuat atau mengedit daftar putar. Setelah Anda memulai daftar putar, Anda dapat mengontrolnya dengan bilah navigasi di bagian atas halaman.

Daftar putar menampilkan setiap dasbor untuk waktu yang ditentukan di `Interval` bidang, diatur saat membuat atau mengedit daftar putar. Setelah daftar putar dimulai, Anda dapat mengontrolnya menggunakan bilah navigasi di bagian atas layar Anda.

1. Akses halaman playlist untuk melihat daftar playlist yang ada.

1. Temukan daftar putar yang ingin Anda mulai, lalu klik **Mulai daftar putar**.

   Kotak dialog daftar putar mulai akan terbuka.

1. Pilih salah satu dari lima mode daftar putar yang tersedia berdasarkan informasi dalam tabel berikut.

1. Klik Mulai.


| Modus | Deskripsi | 
| --- | --- | 
| Modus normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modus TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Mode TV (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Mode kios |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Mode kios (dengan panel auto fit) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**Mengontrol daftar putar**

Anda dapat mengontrol daftar putar dalam mode **Normal** atau **TV** setelah dimulai, menggunakan bilah navigasi di bagian atas layar Anda. Tekan `Esc` tombol di keyboard Anda untuk menghentikan daftar putar.


| Tombol | Tindakan | 
| --- | --- | 
| Berikutnya (panah kanan ganda) | Maju ke dasbor berikutnya. | 
| Kembali (panah kiri) | Kembali ke dasbor sebelumnya. | 
| Berhenti (persegi) | Mengakhiri daftar putar, dan keluar ke dasbor saat ini. | 
| Mode tampilan siklus (ikon monitor) | Memutar tampilan dasbor dalam mode tampilan yang berbeda. | 
| Rentang waktu | Menampilkan data dalam rentang waktu. Ini dapat diatur untuk menampilkan 5 menit terakhir hingga 5 tahun yang lalu, atau rentang waktu khusus, menggunakan panah bawah. | 
| Segarkan (panah lingkaran) | Muat ulang dasbor, untuk menampilkan data saat ini. Ini dapat diatur untuk memuat ulang secara otomatis setiap 5 detik hingga 1 hari, menggunakan panah tarik-turun. | 

## Membuat daftar putar
<a name="v9-dash-create-playlist"></a>

Anda dapat membuat daftar putar untuk menyajikan dasbor secara berurutan dengan urutan yang ditetapkan dan interval waktu antar dasbor.

1. Klik **Daftar putar baru** di halaman daftar putar.

1. Masukkan nama deskriptif di kotak teks **Nama**.

1. Masukkan interval waktu di kotak teks **Interval**.
**catatan**  
Dasbor yang Anda tambahkan tercantum dalam urutan berurutan.

1. Di **Dasbor**, tambahkan dasbor yang ada ke daftar putar menggunakan opsi tarik-turun **Tambahkan berdasarkan judul** dan **Tambahkan berdasarkan tag**.

1. Opsional:
   + Cari dasbor dengan namanya, ekspresi reguler, atau tag.
   + Filter hasil Anda berdasarkan status atau tag berbintang.
   + Atur ulang urutan dasbor yang telah Anda tambahkan menggunakan ikon panah atas dan bawah.
   + Hapus dasbor dari daftar putar dengan mengklik ikon **X** di samping dasbor.

1. Klik **Simpan** untuk menyimpan perubahan Anda.

## Menyimpan daftar putar
<a name="v9-dash-save-playlist"></a>

Anda dapat menyimpan daftar putar dan menambahkannya ke halaman **Daftar Putar** Anda, tempat Anda dapat memulainya.

**penting**  
Pastikan semua dasbor yang ingin Anda tampilkan di daftar putar ditambahkan saat membuat atau mengedit daftar putar sebelum menyimpannya.

1. Untuk mengakses fitur daftar putar, arahkan kursor ke menu samping Grafana.

1. Klik **Daftar Putar** untuk melihat daftar putar yang tersedia untuk Anda.

1. Klik pada daftar putar pilihan Anda.

1. Edit daftar putar.

1. Periksa apakah daftar putar memiliki **Nama**, **Interval**, dan setidaknya satu **Dasbor** yang ditambahkan ke dalamnya.

1. Klik **Simpan** untuk menyimpan perubahan Anda.

## Mengedit atau menghapus daftar putar
<a name="v9-dash-edit-delete-playlist"></a>

Anda dapat mengedit daftar putar dengan memperbarui namanya, interval waktu, dan dengan menambahkan, menghapus, dan mengatur ulang urutan dasbor.

**Mengedit daftar putar**

1. Klik **Edit daftar putar** di halaman daftar putar.

1. Perbarui nama dan interval waktu, lalu tambahkan atau hapus dasbor dari daftar putar menggunakan instruksi di Buat daftar putar, di atas.

1. Klik **Simpan** untuk menyimpan perubahan Anda.

**Menghapus daftar putar**

1. Klik **Daftar Putar**.

1. Klik **Hapus** di samping daftar putar yang ingin Anda hapus.

**Mengatur ulang pesanan dasbor**

1. Di sebelah dasbor yang ingin Anda pindahkan, klik panah atas atau bawah.

1. Klik **Simpan** untuk menyimpan perubahan Anda.

**Menghapus dasbor**

1. Klik **Hapus** untuk menghapus dasbor dari daftar putar.

1. Klik **Simpan** untuk menyimpan perubahan Anda.

## Berbagi daftar putar dalam mode tampilan
<a name="v9-dash-share-playlist-view-mode"></a>

Anda dapat membagikan daftar putar dengan menyalin alamat tautan pada mode tampilan yang Anda inginkan, dan menempelkan URL ke tujuan Anda.

1. **Dari submenu **Dasbor**, klik Daftar Putar.**

1. Klik **Mulai daftar putar di samping daftar** putar yang ingin Anda bagikan.

1. Di dropdown, klik kanan mode tampilan yang Anda inginkan.

1. Klik **Salin Alamat Tautan** untuk menyalin URL ke clipboard Anda.

1. Tempelkan URL ke tujuan Anda.

# Menambahkan dan mengelola variabel dasbor
<a name="v9-dash-variables"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Variabel adalah placeholder untuk suatu nilai. Anda dapat menggunakan variabel dalam kueri metrik dan judul panel. Jadi saat Anda mengubah nilainya, menggunakan dropdown di bagian atas dasbor, kueri metrik panel Anda akan berubah untuk mencerminkan nilai baru.

Variabel memungkinkan Anda membuat dasbor yang lebih interaktif dan dinamis. Alih-alih hard-coding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Dropdown ini memudahkan untuk mengubah data yang ditampilkan di dasbor Anda.

Ini bisa sangat berguna bagi administrator yang ingin mengizinkan pemirsa Grafana menyesuaikan visualisasi dengan cepat tetapi tidak ingin memberi mereka izin pengeditan penuh. Grafana Viewers dapat menggunakan variabel.

Variabel dan template juga memungkinkan Anda untuk dasbor sumber tunggal. Jika Anda memiliki beberapa sumber data atau server yang identik, Anda dapat membuat satu dasbor dan menggunakan variabel untuk mengubah apa yang Anda lihat. Ini sangat menyederhanakan pemeliharaan dan pemeliharaan.

**Template**

Template adalah kueri yang berisi variabel. Misalnya, jika Anda mengelola dasbor untuk memantau beberapa server, Anda dapat membuat dasbor untuk setiap server, atau Anda dapat membuat satu dasbor dan menggunakan panel dengan kueri templat, seperti berikut ini.

```
wmi_system_threads{instance=~"$server"}
```

<varname>Nilai variabel selalu disinkronkan ke URL menggunakan sintaks var- =value.

**Contoh**

Variabel tercantum dalam daftar dropdown di bagian atas layar. Pilih variabel yang berbeda untuk melihat bagaimana visualisasi berubah.

Untuk melihat pengaturan variabel, navigasikan ke **Pengaturan Dasbor > Variabel**. Klik variabel dalam daftar untuk melihat pengaturannya. 

Variabel dapat digunakan dalam judul, deskripsi, panel teks, dan kueri. Kueri dengan teks yang dimulai dengan `$` adalah template. Tidak semua panel akan memiliki kueri template.

**Praktik terbaik variabel**
+ Daftar dropdown variabel ditampilkan dalam urutan mereka tercantum dalam daftar variabel di pengaturan **Dashboard**.
+ Letakkan variabel yang akan sering Anda ubah di bagian atas, sehingga akan ditampilkan terlebih dahulu (paling kiri di dasbor).

# Menambahkan dan mengelola variabel
<a name="v9-dash-variable-add"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Tabel berikut mencantumkan jenis variabel yang dikirimkan bersama Grafana.


| Jenis variabel | Deskripsi | 
| --- | --- | 
|  Kueri  |  Daftar nilai yang dihasilkan kueri seperti nama metrik, nama server, sensor IDs, pusat data, dan sebagainya. Tambahkan variabel kueri.  | 
|  Khusus  |  Tentukan opsi variabel secara manual menggunakan daftar yang dipisahkan koma. Tambahkan variabel kustom.  | 
|  Kotak teks  |  Menampilkan kolom input teks gratis dengan nilai default opsional. Tambahkan variabel kotak teks.  | 
|  Konstan  |  Tentukan konstanta tersembunyi. Tambahkan variabel konstan.  | 
|  Sumber data  |  Ubah sumber data dengan cepat untuk seluruh dasbor. Tambahkan variabel sumber data.  | 
|  Interval  |  Variabel interval mewakili rentang waktu. Tambahkan variabel interval.  | 
|  Filter ad hoc  |  Filter nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik untuk sumber data (Prometheus, Loki, InfluxDB, dan Elasticsearch saja). Tambahkan filter ad hoc.  | 
|  Variabel global  |  Variabel bawaan yang dapat digunakan dalam ekspresi di editor kueri. Lihat variabel global.  | 
|  Variabel yang dirantai  |  Kueri variabel dapat berisi variabel lain. Lihat variabel Chained.  | 

## Memasuki opsi Umum
<a name="v9-dash-variable-options"></a>

Anda harus memasukkan opsi umum untuk semua jenis variabel yang Anda buat.

**Untuk memasukkan opsi umum**

1. Arahkan ke dasbor yang ingin Anda buat variabel dan pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman.

1. Pada tab **Variables**, pilih **New**.

1. Masukkan **Nama** untuk variabel.

1. Dalam daftar **Type**, pilih **Query**.

1. (Opsional) Di **Label**, masukkan nama tampilan dropdown variabel.

   Jika Anda tidak memasukkan nama tampilan, maka label dropdown adalah nama variabel.

1. Pilih opsi **Sembunyikan**:
   + **Tidak ada pilihan (kosong):** Variabel dropdown menampilkan variabel **Nama** atau nilai **Label**.
   + **Label:** Variabel dropdown hanya menampilkan nilai variabel yang dipilih dan panah bawah.
   + **Variabel:** Tidak ada dropdown variabel yang ditampilkan di dasbor.

## Menambahkan variabel kueri
<a name="v9-dash-variable-add-query"></a>

Variabel kueri memungkinkan Anda menulis kueri sumber data yang dapat mengembalikan daftar nama metrik, nilai tag, atau kunci. Misalnya, variabel kueri mungkin mengembalikan daftar nama server, sensor IDs, atau pusat data. Nilai variabel berubah saat mereka secara dinamis mengambil opsi dengan kueri sumber data.

Variabel kueri umumnya hanya didukung untuk string. Jika kueri Anda mengembalikan angka atau tipe data lainnya, Anda mungkin perlu mengonversinya menjadi string untuk menggunakannya sebagai variabel. Untuk sumber data Azure, misalnya, Anda dapat menggunakan fungsi [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) untuk tujuan ini.

Ekspresi kueri dapat berisi referensi ke variabel lain dan pada dasarnya membuat variabel terkait. Grafana mendeteksi ini dan secara otomatis menyegarkan variabel ketika salah satu variabel tertaut berubah.

**catatan**  
Ekspresi kueri berbeda untuk setiap sumber data. Untuk informasi selengkapnya, lihat dokumentasi untuk [sumber data](AMG-data-sources.md) Anda.

**Untuk menambahkan variabel kueri**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target untuk kueri.

1. Dalam daftar **Refresh**, pilih kapan variabel harus memperbarui opsi.
   + Saat **Memuat Dasbor:** Menanyakan sumber data setiap kali dasbor dimuat. Ini memperlambat pemuatan dasbor, karena kueri variabel perlu diselesaikan sebelum dasbor dapat diinisialisasi.
   + **Pada Perubahan Rentang Waktu:** Menanyakan sumber data saat rentang waktu dasbor berubah. Hanya gunakan opsi ini jika kueri opsi variabel Anda berisi filter rentang waktu atau bergantung pada rentang waktu dasbor.

1. Di bidang **Query**, masukkan kueri.
   + Bidang kueri bervariasi sesuai dengan sumber data Anda. Beberapa sumber data memiliki editor kueri khusus.
   + Jika Anda membutuhkan lebih banyak ruang dalam editor kueri bidang input tunggal, arahkan kursor Anda ke garis di sudut kanan bawah bidang dan seret ke bawah untuk memperluas.

1. (Opsional) Di bidang **Regex**, ketik ekspresi regex untuk memfilter atau menangkap bagian tertentu dari nama yang dikembalikan oleh kueri sumber data Anda. Untuk melihat contoh, lihat [Filter variabel dengan regex](#v9-dash-variable-add-filter).

1. Dalam daftar **Urutkan**, pilih urutan pengurutan untuk nilai yang akan ditampilkan dalam daftar dropdown. Opsi default, **Dinonaktifkan**, berarti urutan opsi yang dikembalikan oleh kueri sumber data Anda akan digunakan.

1. (Opsional) Masukkan [Pilihan Pilihan](#v9-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel khusus
<a name="v9-dash-variable-add-custom"></a>

Gunakan variabel *kustom* untuk nilai yang tidak berubah, seperti angka atau string.

Misalnya, jika Anda memiliki nama server atau nama Wilayah yang tidak pernah berubah, Anda mungkin ingin membuatnya sebagai variabel kustom daripada variabel kueri. Karena mereka tidak berubah, Anda dapat menggunakannya dalam [variabel berantai daripada variabel](#v9-dash-variable-add-chained) kueri lainnya. Itu akan mengurangi jumlah kueri yang harus dikirim Grafana ketika variabel berantai diperbarui.

**Untuk menambahkan variabel kustom**

1. Masukkan opsi umum, seperti di atas.

1. Dalam 

   **Nilai dipisahkan oleh daftar koma**, masukkan nilai untuk variabel ini dalam daftar dipisahkan koma. Anda dapat menyertakan angka, string, atau pasangan kunci-nilai yang dipisahkan oleh spasi dan titik dua. Misalnya, `key1 : value1,key2 : value2`.

1. (Opsional) Masukkan [Pilihan Pilihan](#v9-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel kotak teks
<a name="v9-dash-variable-add-text"></a>

Variabel *kotak teks* menampilkan bidang input teks gratis dengan nilai default opsional. Ini adalah variabel yang paling fleksibel, karena Anda dapat memasukkan nilai apa pun. Gunakan jenis variabel ini jika Anda memiliki metrik dengan kardinalitas tinggi atau jika Anda ingin memperbarui beberapa panel di dasbor secara bersamaan.

**Untuk menambahkan variabel kotak teks**

1. Masukkan opsi umum, seperti di atas.

1. (Opsional) Di bidang **Nilai default**, pilih nilai default untuk variabel. Jika Anda tidak memasukkan apa pun di bidang ini, Grafana menampilkan kotak teks kosong bagi pengguna untuk mengetik teks.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel konstan
<a name="v9-dash-variable-add-constant"></a>

Variabel *konstan* memungkinkan Anda untuk menentukan konstanta tersembunyi. Ini berguna untuk awalan jalur metrik untuk dasbor yang ingin Anda bagikan. Saat Anda mengekspor dasbor, variabel konstan dikonversi ke opsi impor.

Variabel konstan *tidak* fleksibel. Setiap variabel konstan hanya memiliki satu nilai, dan tidak dapat diperbarui kecuali Anda memperbarui pengaturan variabel.

Variabel konstan berguna ketika Anda memiliki nilai kompleks yang perlu Anda sertakan dalam kueri tetapi tidak ingin mengetik ulang di setiap kueri. Misalnya, jika Anda memiliki jalur server yang disebut`i-0b6a61efe2ab843gg`, maka Anda bisa menggantinya dengan variabel yang disebut`$path_gg`.

**Untuk menambahkan variabel konstan**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan nilai variabel. Anda dapat memasukkan huruf, angka, dan simbol. Anda bahkan dapat menggunakan wildcard jika Anda menggunakan [format mentah](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel sumber data
<a name="v9-dash-variable-add-datasource"></a>

Variabel *sumber data* memungkinkan Anda mengubah sumber data dengan cepat untuk seluruh dasbor. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda.

**Untuk menambahkan variabel sumber data**

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Jenis**, pilih sumber data target untuk variabel.

1. (Opsional) Dalam **filter nama Instance**, masukkan filter regex untuk contoh sumber datanya untuk dipilih dalam daftar dropdown nilai variabel. Biarkan bidang ini kosong untuk menampilkan semua instance.

1. (Opsional) Masukkan [Pilihan Pilihan](#v9-dash-variable-add-selection).

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

## Menambahkan variabel interval
<a name="v9-dash-variable-add-internal"></a>

Gunakan variabel *interval* untuk mewakili rentang waktu seperti`1m`,`1h`, atau`1d`. Anda dapat menganggapnya sebagai *grup di seluruh dasbor berdasarkan* perintah waktu. Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan Opsi Otomatis untuk mengembalikan sejumlah titik data per rentang waktu.

Anda dapat menggunakan variabel interval sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB), interval histogram tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Grafit).

**Untuk menambahkan variabel interval**

1. Masukkan opsi umum, seperti di atas.

1. Di bidang **Nilai**, masukkan interval rentang waktu yang ingin Anda tampilkan di daftar dropdown variabel. Unit waktu berikut didukung:`s (seconds)`,,`m (minutes)`,`h (hours)`, `d (days)``w (weeks)`,`M (months)`, dan`y (years)`. Anda juga dapat menerima atau mengedit nilai default:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Opsional) Nyalakan **Opsi Otomatis** jika Anda ingin menambahkan `auto` opsi ke daftar. Opsi ini memungkinkan Anda untuk menentukan berapa kali rentang waktu saat ini harus dibagi untuk menghitung rentang `auto` waktu saat ini. Jika Anda menyalakannya, maka dua opsi lagi muncul:
   + **Jumlah langkah -** Pilih berapa kali rentang waktu saat ini akan dibagi untuk menghitung nilainya, mirip dengan opsi kueri **poin data maks**. Misalnya, jika rentang waktu yang terlihat saat ini adalah 30 menit, maka `auto` interval mengelompokkan data menjadi 30 peningkatan satu menit. Nilai default adalah 30 langkah.
   + **Interval Min -** Ambang minimum di bawah mana interval hitungan langkah tidak akan membagi waktu. Untuk melanjutkan contoh 30 menit, jika interval minimum diatur ke 2m, maka Grafana akan mengelompokkan data menjadi 15 kenaikan dua menit.

1. Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Contoh variabel interval**

Contoh berikut menunjukkan variabel template `myinterval` dalam fungsi Graphite:

```
summarize($myinterval, sum, false)
```

## Menambahkan filter ad hoc
<a name="v9-dash-variable-add-adhoc"></a>

Filter *ad hoc memungkinkan Anda menambahkan filter* nilai kunci yang secara otomatis ditambahkan ke semua kueri metrik yang menggunakan sumber data yang ditentukan. Tidak seperti variabel lain, Anda tidak menggunakan filter ad hoc dalam kueri. Sebagai gantinya, Anda menggunakan filter ad hoc untuk menulis filter untuk kueri yang ada.

**catatan**  
Variabel filter ad hoc hanya berfungsi dengan sumber data Prometheus, Loki, InfluxDB, dan Elasticsearch.

1. Masukkan opsi umum, seperti di atas.

1. Dalam daftar **Sumber data**, pilih sumber data target.

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor.

**Buat filter ad hoc**

Filter ad hoc adalah salah satu opsi variabel paling kompleks dan fleksibel yang tersedia. Alih-alih daftar opsi variabel reguler, variabel ini memungkinkan Anda membuat kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor.

## Konfigurasikan opsi pemilihan variabel
<a name="v9-dash-variable-add-selection"></a>

**Pilihan Pilihan** adalah fitur yang dapat Anda gunakan untuk mengelola pilihan opsi variabel. Semua opsi pilihan adalah opsional, dan mereka mati secara default.

### Variabel multi-nilai
<a name="v9-dash-variable-add-selection-multi"></a>

Menginterpolasi variabel dengan beberapa nilai yang dipilih rumit karena tidak langsung bagaimana memformat beberapa nilai menjadi string yang valid dalam konteks tertentu di mana variabel digunakan. Grafana mencoba menyelesaikan ini dengan mengizinkan setiap plugin sumber data untuk memberi tahu mesin interpolasi template format apa yang akan digunakan untuk beberapa nilai.

**catatan**  
Opsi **Kustom semua nilai** pada variabel harus kosong agar Grafana memformat semua nilai menjadi satu string. Jika dibiarkan kosong, maka Grafana menggabungkan (menambahkan bersama) semua nilai dalam kueri. Misalnya, `value1,value2,value3`. Jika `all` nilai kustom digunakan, maka sebaliknya nilainya akan menjadi `*` atau`all`.

**Variabel multi-nilai dengan sumber data Grafit**

Grafit menggunakan ekspresi glob. *Variabel dengan beberapa nilai akan, dalam hal ini, diinterpolasi `{host1,host2,host3}` seolah-olah nilai variabel saat ini adalah *host1, host2**, dan host3*.*

**Variabel multi-nilai dengan sumber data Prometheus atau InfluxDB**

InfluxDB dan Prometheus menggunakan ekspresi regex, sehingga variabel yang sama akan diinterpolasi sebagai. `(host1|host2|host3)` Setiap nilai juga akan lolos dari regex. Jika tidak, nilai dengan karakter kontrol regex akan merusak ekspresi regex.

**Variabel multi-nilai dengan sumber data Elastis**

Elasticsearch menggunakan sintaks kueri lucene, sehingga variabel yang sama akan diformat sebagai. `("host1" OR "host2" OR "host3")` Dalam hal ini, setiap nilai harus diloloskan sehingga nilainya hanya berisi kata-kata kontrol lucene dan tanda kutip.

**Memecahkan masalah variabel multi-nilai**

Pelarian dan pemformatan otomatis dapat menyebabkan masalah dan sulit untuk memahami logika di baliknya. Khusus untuk InfluxDB dan Prometheus di mana penggunaan sintaks regex mengharuskan variabel digunakan dalam konteks operator regex.

Jika Anda tidak ingin Grafana melakukan pelolosan dan pemformatan regex otomatis ini, maka Anda harus melakukan salah satu hal berikut:
+ Matikan **opsi **Multi-nilai** atau Sertakan Semua**.
+ Gunakan [format variabel mentah](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

### Sertakan Semua opsi
<a name="v9-dash-variable-add-multi-all"></a>

Grafana menambahkan `All` opsi ke daftar dropdown variabel. Jika pengguna memilih opsi ini, maka semua opsi variabel dipilih.

### Kustom semua nilai
<a name="v9-dash-variable-add-multi-custom"></a>

Opsi ini hanya terlihat jika **opsi Sertakan Semua** dipilih.

Masukkan sintaks regex, gumpalan, atau lucene di bidang **Kustom semua nilai** untuk menentukan nilai opsi. `All`

Secara default `All` nilai mencakup semua opsi dalam ekspresi gabungan. Ini bisa menjadi sangat panjang dan dapat memiliki masalah kinerja. Terkadang lebih baik untuk menentukan nilai semua kustom, seperti regex wildcard.

Untuk memiliki sintaks regex, gumpalan, atau lucene khusus di opsi **Kustom semua nilai**, itu tidak pernah lolos sehingga Anda harus memikirkan nilai yang valid untuk sumber data Anda.

## Variabel global
<a name="v9-dash-variable-add-global"></a>

Grafana memiliki variabel bawaan global yang dapat digunakan dalam ekspresi di editor kueri. Topik ini mencantumkannya dalam urutan abjad dan mendefinisikannya. Variabel ini berguna dalam kueri, tautan dasbor, tautan panel, dan tautan data.

**\$1 \$1\$1dasbor**

Variabel ini adalah nama dasbor saat ini.

**\$1\$1\$1from dan \$1\$1\$1to**

Grafana memiliki dua variabel rentang waktu bawaan: `$__from` dan. `$__to` Mereka saat ini selalu diinterpolasi sebagai milidetik epoch secara default, tetapi Anda dapat mengontrol pemformatan tanggal.


| Sintaksis | Contoh hasil | Deskripsi | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoch unix milidetik  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Tidak ada argumen, default ke ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoch detik Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Format tanggal kustom apa pun yang tidak menyertakan karakter:  | 

Sintaks di atas juga berfungsi dengan`${__to}`.

**\$1 \$1\$1interval**

*Anda dapat menggunakan `$__interval` variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, MySQL, Postgres, MSSQL), interval histogram Tanggal (untuk Elasticsearch), atau sebagai parameter fungsi ringkasan (untuk Graphite).*

Grafana secara otomatis menghitung interval yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ketika ada lebih banyak titik data daripada yang dapat ditampilkan pada grafik, kueri dapat dibuat lebih efisien dengan mengelompokkan dengan interval yang lebih besar. Misalnya, jika Anda melihat grafik data senilai 3 bulan, Anda mungkin tidak dapat melihat detail pada tingkat menit. Pengelompokan berdasarkan jam atau hari membuat kueri lebih efisien tanpa mempengaruhi apa yang ditunjukkan grafik. `$__interval`Itu dihitung menggunakan rentang waktu dan lebar grafik (jumlah piksel).

Perhitungan Perkiraan: `(to - from) / resolution`

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, maka interval dapat dihitung menjadi `2m` - titik dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, maka intervalnya mungkin `1d` (1 hari) - poin dikelompokkan berdasarkan hari.

Dalam sumber data InfluxDB, variabel warisan `$interval` adalah variabel yang sama. `$__interval`harus digunakan sebagai gantinya.

Sumber data InfluxDB dan Elasticsearch memiliki `Group by time interval` bidang yang digunakan untuk membuat kode keras interval atau untuk menetapkan batas minimum untuk `$__interval` variabel (dengan menggunakan sintaks ->). `>` `>10m`

**\$1 \$1\$1interval\$1ms**

Variabel ini adalah `$__interval` variabel dalam milidetik, bukan string yang diformat interval waktu. Misalnya, jika `$__interval` adalah `20m` maka `$__interval_ms` adalah`1200000`.

**\$1\$1\$1org**

Variabel ini adalah ID dari organisasi saat ini. `${__org.name}`adalah nama organisasi saat ini.

**\$1 \$1\$1pengguna**

`${__user.id}`adalah ID pengguna saat ini. `${__user.login}`adalah pegangan login dari pengguna saat ini. `${__user.email}`adalah email untuk pengguna saat ini.

**\$1 \$1\$1kisaran**

Saat ini hanya didukung untuk sumber data Prometheus dan Loki. Variabel ini mewakili rentang untuk dasbor saat ini. Itu dihitung oleh`to - from`. Ini memiliki milidetik dan representasi kedua disebut `$__range_ms` dan`$__range_s`.

**\$1 \$1\$1rate\$1interval**

Saat ini hanya didukung untuk sumber data Prometheus. `$__rate_interval`Variabel dimaksudkan untuk digunakan dalam fungsi laju.

**\$1 TimeFilter atau \$1 \$1\$1TimeFilter**

`$timeFilter`Variabel mengembalikan rentang waktu yang dipilih saat ini sebagai ekspresi. Misalnya, `Last 7 days` ekspresi interval rentang waktu adalah`time > now() - 7d`.

Ini digunakan di beberapa tempat, termasuk:
+ Klausul WHERE untuk sumber data InfluxDB. Grafana menambahkannya secara otomatis ke kueri InfluxDB saat dalam mode Query Editor. Anda dapat menambahkannya secara manual dalam mode Editor Teks:`WHERE $timeFilter`.
+ Kueri log Analytics di sumber data Azure Monitor.
+ Kueri SQL di MySQL, Postgres, dan MSSQL.
+ `$__timeFilter`Variabel ini digunakan dalam sumber data MySQL.

## Variabel yang dirantai
<a name="v9-dash-variable-add-chained"></a>

*Variabel berantai*, juga disebut *variabel terkait atau variabel* *bersarang, adalah variabel* kueri dengan satu atau lebih variabel lain dalam kueri variabelnya. Bagian ini menjelaskan cara kerja variabel berantai dan menyediakan tautan ke dasbor contoh yang menggunakan variabel berantai.

Kueri variabel berantai berbeda untuk setiap sumber data, tetapi premisnya sama untuk semua. Anda dapat menggunakan kueri variabel berantai di sumber data apa pun yang memungkinkan mereka.

Dasbor templat tertaut yang sangat kompleks dimungkinkan, sedalam 5 atau 10 level. Secara teknis, tidak ada batasan seberapa dalam atau kompleks Anda dapat pergi, tetapi semakin banyak tautan yang Anda miliki, semakin besar beban kueri.

**Praktik dan kiat terbaik**

Praktik berikut akan membuat dasbor dan variabel Anda lebih mudah digunakan.

**Membuat variabel terkait baru**
+ Variabel rantai membuat parent/child dependensi. Anda dapat membayangkan mereka sebagai tangga atau pohon.
+ Cara termudah untuk membuat variabel berantai baru adalah dengan menyalin variabel yang ingin Anda dasarkan pada yang baru. Dalam daftar variabel, klik ikon **variabel Duplikat** di sebelah kanan entri variabel untuk membuat salinan. Anda kemudian dapat menambahkan ke kueri untuk variabel induk.
+ Variabel baru yang dibuat dengan cara ini muncul di bagian bawah daftar. Anda mungkin perlu menyeretnya ke posisi yang berbeda dalam daftar untuk memasukkannya ke dalam urutan logis.

**Urutan variabel**

Anda dapat mengubah urutan variabel dalam daftar variabel dasbor dengan mengklik panah atas dan bawah di sisi kanan setiap entri. Grafana mencantumkan dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, dengan variabel di bagian atas di paling kiri.
+ Buat daftar variabel yang tidak memiliki dependensi di bagian atas, sebelum variabel anak mereka.
+ Setiap variabel harus mengikuti yang bergantung padanya.
+ Ingat tidak ada indikasi di UI variabel mana yang memiliki hubungan ketergantungan. Buat daftar variabel dalam urutan logis untuk memudahkan pengguna lain (dan diri Anda sendiri).

**Pertimbangan kompleksitas**

Semakin banyak lapisan ketergantungan yang Anda miliki dalam variabel, semakin lama waktu yang dibutuhkan untuk memperbarui dasbor setelah Anda mengubah variabel.

Misalnya, jika Anda memiliki serangkaian empat variabel tertaut (negara, Wilayah, server, metrik) dan Anda mengubah nilai variabel root (negara), maka Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor.

## Kelola variabel
<a name="v9-dash-variable-add-manage"></a>

Halaman variabel memungkinkan Anda [menambahkan](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) variabel dan mengelola variabel yang ada. Hal ini juga memungkinkan Anda untuk [memeriksa](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) variabel dan mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel lain atau dashboard.

**Pindah:** Anda dapat memindahkan variabel ke atas atau ke bawah daftar menggunakan drag and drop.

**Clone:** Untuk mengkloning variabel, klik ikon klon dari kumpulan ikon di sebelah kanan. Ini menciptakan salinan variabel dengan nama variabel asli diawali dengan`copy_of_`.

**Hapus:** Untuk menghapus variabel, klik ikon sampah dari kumpulan ikon di sebelah kanan.

## Filter variabel dengan regex
<a name="v9-dash-variable-add-filter"></a>

Menggunakan opsi Regex Query, Anda memfilter daftar opsi yang dikembalikan oleh kueri variabel atau memodifikasi opsi yang dikembalikan.

Halaman ini menunjukkan cara menggunakan regex ke filter/modify nilai dalam dropdown variabel.

Menggunakan Opsi Kueri Regex, Anda memfilter daftar opsi yang dikembalikan oleh kueri Variabel atau memodifikasi opsi yang dikembalikan. Untuk informasi selengkapnya, lihat panduan Mozilla tentang [ekspresi Reguler](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Contoh berikut menunjukkan pemfilteran pada daftar opsi berikut

```
backend_01
backend_02
backend_03
backend_04
```

**Filter sehingga hanya opsi yang diakhiri dengan `01` atau `02` dikembalikan**

Regex:

```
/
(
01|02 
) 
$/
```

Hasil:

```
backend_01
backend_02
```

**Filter dan ubah opsi menggunakan grup tangkapan regex untuk mengembalikan bagian teks**

Regex:

```
/.* 
(
01|02 
)
/
```

Hasil:

```
01
02
```

**Filter dan modifikasi - Contoh Prometheus**

Daftar opsi:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex:

```
/. *instance="
(
[^"]*
)
.*/
```

Hasil:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filter dan modifikasi menggunakan teks bernama dan grup penangkap nilai**

Menggunakan grup tangkapan bernama, Anda dapat menangkap bagian 'teks' dan 'nilai' terpisah dari opsi yang dikembalikan oleh kueri variabel. Hal ini memungkinkan daftar dropdown variabel berisi nama ramah untuk setiap nilai yang dapat dipilih.

Misalnya, saat menanyakan metrik `node_hwmon_chip_names` Prometheus, nilainya jauh lebih ramah `chip_name` daripada nilainya. `chip` Jadi hasil query variabel berikut:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Melewati Regex berikut:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Akan menghasilkan daftar dropdown berikut:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Hanya `text` dan `value` menangkap nama grup yang didukung.

## 
<a name="v9-dash-variable-add-inspect"></a>

Halaman variabel memungkinkan Anda dengan mudah mengidentifikasi apakah variabel sedang direferensikan (atau digunakan) dalam variabel atau dasbor lain.

Setiap variabel yang direferensikan atau digunakan memiliki tanda centang hijau di sebelahnya, sementara variabel yang tidak direferensikan memiliki ikon peringatan oranye di sebelahnya. Selain itu, semua variabel yang direferensikan memiliki ikon ketergantungan di sebelah tanda centang hijau. Anda dapat memilih ikon untuk melihat peta ketergantungan. Peta ketergantungan dapat dipindahkan. Anda dapat memperbesar atau memperkecil dengan roda mouse atau yang setara.

# Sintaks variabel
<a name="v9-dash-variable-syntax"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Judul panel dan kueri metrik dapat merujuk ke variabel menggunakan dua sintaks yang berbeda.
+ `$varname`— Sintaks ini mudah dibaca, tetapi tidak memungkinkan Anda untuk menggunakan variabel di tengah kata.

  **Contoh:** `apps.frontend.$server.requests.count`
+ `${var_name}`— Gunakan sintaks ini ketika Anda ingin menggunakan variabel di tengah ekspresi.
+ `${var_name:<format>}`— Format ini memberi Anda kontrol lebih besar atas bagaimana Grafana menafsirkan nilai. Untuk informasi selengkapnya, lihat *Opsi format variabel lanjutan*.
+ `[[varname]]`- Jangan gunakan. Sintaks ini sudah tua dan sudah usang. Ini akan dihapus dalam rilis future.

Sebelum kueri dikirim ke sumber data Anda, kueri *diinterpolasi*, artinya variabel diganti dengan nilai saat ini. Selama interpolasi, nilai variabel mungkin *lolos* agar sesuai dengan sintaks bahasa kueri dan di mana ia digunakan. Misalnya, variabel yang digunakan dalam ekspresi regex dalam kueri InfluxDB atau Prometheus akan diloloskan regex.

**Opsi format variabel lanjutan**

Pemformatan interpolasi variabel tergantung pada sumber data, tetapi ada beberapa situasi di mana Anda mungkin ingin mengubah format default.

Misalnya, default untuk sumber data MySQL adalah menggabungkan beberapa nilai sebagai dipisahkan koma dengan tanda kutip:. `'server01','server02'` Dalam beberapa kasus, Anda mungkin ingin memiliki string yang dipisahkan koma tanpa tanda kutip:. `server01,server02` Anda dapat mewujudkannya dengan opsi pemformatan variabel lanjutan yang tercantum di bawah ini.

**Sintaks umum**

Sintaks: `${var_name:option}`

Jika ada opsi pemformatan yang tidak valid ditentukan, maka `glob` adalah opsi. default/fallback 

**CSV**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Didistribusikan - OpenTSDB**

Memformat variabel dengan beberapa nilai dalam format khusus untuk OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Kutipan ganda**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `"` di setiap nilai dengan `\"` dan mengutip setiap nilai dengan. `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Grafit**

Memformat variabel dengan beberapa nilai menjadi gumpalan (untuk kueri Grafit).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Memformat variabel dengan beberapa nilai dalam format Lucene untuk Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Kode Persentase**

Memformat variabel tunggal dan multivalued untuk digunakan dalam parameter URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Pipa**

Memformat variabel dengan beberapa nilai menjadi string yang dipisahkan pipa.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Mentah**

Menonaktifkan pemformatan khusus sumber data, seperti tanda kutip tunggal dalam kueri SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Memformat variabel dengan beberapa nilai menjadi string regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `\'` dan mengutip setiap nilai dengan. `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Memformat variabel tunggal dan multi-nilai menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `''` dan mengutip setiap nilai dengan. `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Teks**

Memformat variabel tunggal dan multi-nilai ke dalam representasi teks mereka. Untuk satu variabel, itu hanya akan mengembalikan representasi teks. Untuk variabel multi-nilai, itu akan mengembalikan representasi teks yang digabungkan dengan`+`.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parameter kueri**

Memformat variabel tunggal dan multi-nilai ke dalam representasi parameter kueri mereka. Contoh: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Menilai penggunaan dasbor
<a name="v9-dash-assess-dashboard-usage"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Wawasan penggunaan memungkinkan Anda untuk memiliki pemahaman yang lebih baik tentang bagaimana instance Grafana Anda digunakan.

Fitur wawasan penggunaan mengumpulkan sejumlah data agregat dan menyimpannya dalam database.
+ Tampilan dasbor (agregat dan per pengguna)
+ Kesalahan sumber data
+ Kueri sumber data

Data gabungan memberi Anda akses ke beberapa fitur, termasuk wawasan dasbor dan sumber data, indikator keberadaan, pengurutan dasbor menggunakan data wawasan, dan memvisualisasikan data wawasan penggunaan di dasbor.

Fitur ini juga menghasilkan log rinci yang dapat diekspor ke Loki.

## Dasbor dan wawasan sumber data
<a name="v9-dash-insights"></a>

Untuk setiap dasbor dan sumber data, Anda dapat mengakses informasi penggunaan.

**Wawasan dasbor**

Untuk melihat informasi penggunaan dasbor, klik **Wawasan dasbor** di bilah atas.

Wawasan dasbor menunjukkan informasi berikut.
+ **Statistik**: Jumlah kueri dan kesalahan harian selama 30 hari terakhir.
+ **Pengguna & aktivitas**: Jumlah tampilan harian selama 30 hari terakhir; aktivitas terakhir di dasbor dan pengguna terbaru (dengan batas 20).

**Wawasan sumber data**

Wawasan sumber data memberikan informasi tentang bagaimana sumber data telah digunakan dalam 30 hari terakhir, seperti:
+ Pertanyaan per hari
+ Kesalahan per hari
+ Waktu muat kueri per hari (dirata-ratakan dalam ms)

Untuk menemukan wawasan sumber data:

1. Pergi ke tampilan daftar **sumber data**.

1. Klik pada **Sumber data**.

1. Klik tab **Wawasan**.

## Indikator kehadiran
<a name="v9-dash-presence-indicator"></a>

Saat Anda masuk dan melihat dasbor, Anda dapat mengetahui siapa yang melihat dasbor yang sama dengan Anda melalui indikator kehadiran, yang menampilkan avatar pengguna yang baru saja berinteraksi dengan dasbor. Jangka waktu default adalah 10 menit. Untuk melihat nama pengguna, arahkan kursor ke avatar pengguna. Avatar berasal dari [Gravatar](https://gravatar.com/) berdasarkan email pengguna.

Ketika ada lebih banyak pengguna aktif di dasbor daripada yang dapat masuk dalam indikator kehadiran, klik **ikon\$1X**. Melakukan hal ini akan membuka wawasan dasbor, yang berisi detail lebih lanjut tentang aktivitas pengguna terbaru.

## Menyortir dasbor dengan menggunakan data wawasan
<a name="v9-dash-sort-dashboards"></a>

Di tampilan penelusuran, Anda dapat menggunakan data wawasan untuk membantu menemukan dasbor yang paling sering digunakan, rusak, dan tidak digunakan.
+ Kesalahan total
+ Kesalahan 30 hari
+ Tampilan total
+ Tampilan 30 hari

# Mencari Dasbor di Grafana versi 9
<a name="v9-search"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat mencari dasbor berdasarkan nama dasbor dan judul panel. Saat Anda mencari dasbor, sistem mengembalikan semua dasbor yang tersedia dalam instance Grafana, meskipun Anda tidak memiliki izin untuk melihat konten dasbor.

## Cari dasbor menggunakan nama dasbor
<a name="v9-search-by-name"></a>

Masukkan bagian mana pun dari nama dasbor di bilah pencarian. Pencarian mengembalikan hasil untuk setiap kecocokan string sebagian secara real-time, saat Anda mengetik.

Pencarian dasbor adalah:
+ Real-time
+ *Tidak* peka huruf besar/kecil
+ Fungsional di seluruh dasbor yang disimpan dan berbasis file.

**Tip**  
Anda dapat menggunakan tombol panah keyboard untuk menavigasi hasil dan tekan `Enter` untuk membuka dasbor yang dipilih.

## Cari dasbor menggunakan judul panel
<a name="v9-search-by-title"></a>

Anda dapat mencari dasbor dengan judul panel yang muncul di dasbor. Jika judul panel cocok dengan kueri penelusuran Anda, dasbor akan muncul di hasil penelusuran.

## Filter hasil pencarian dasbor berdasarkan tag
<a name="v9-search-by-tag"></a>

Tag adalah cara yang bagus untuk mengatur dasbor Anda, terutama karena jumlah dasbor bertambah. Anda dapat menambahkan dan mengelola tag di **Pengaturan** dasbor.

Saat Anda memilih beberapa tag, Grafana menampilkan dasbor yang menyertakan semua tag yang dipilih.

Untuk memfilter hasil pencarian dasbor dengan tag, selesaikan salah satu langkah berikut:
+ Untuk memfilter hasil pencarian dasbor berdasarkan tag, pilih tag yang muncul di kolom kanan hasil pencarian.

  Anda dapat melanjutkan pemfilteran dengan memilih tag tambahan.
+ Untuk melihat daftar semua tag yang tersedia, klik menu dropdown **Filter by tags** dan pilih tag.

  Semua tag akan ditampilkan, dan ketika Anda memilih tag, pencarian dasbor akan langsung disaring.

**Tip**  
Saat hanya menggunakan keyboard, tekan `tab` tombol dan arahkan ke menu dropdown **Filter by tag**, tekan tombol panah bawah untuk mengaktifkan menu dan menemukan tag, dan tekan `Enter` untuk memilih tag.

# Panel dan visualisasi dalam Grafana versi 9
<a name="v9-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 *Panel* adalah blok bangunan visualisasi dasar di Grafana. Setiap panel memiliki editor kueri khusus untuk sumber data yang dipilih di panel. Editor kueri memungkinkan Anda membuat kueri yang mengembalikan data yang ingin Anda visualisasikan. 

 Ada berbagai macam pilihan styling dan format untuk setiap panel. Panel dapat diseret, dijatuhkan, dan diubah ukurannya untuk mengatur ulang mereka di dasbor. 

 Sebelum Anda menambahkan panel, pastikan Anda telah mengonfigurasi sumber data. 

Jenis panel tambahan mungkin tersedia dengan menginstal [plugin tambahan ke ruang](grafana-plugins.md) kerja Anda.
+  Untuk detail tentang penggunaan sumber data tertentu, lihat[Connect ke sumber data](AMG-data-sources.md). 

**Topics**
+ [Ikhtisar editor panel](v9-panels-editor-overview.md)
+ [Konfigurasikan opsi panel](v9-panels-configure-panel-options.md)
+ [Konfigurasikan opsi standar](v9-panels-configure-standard-options.md)
+ [Kueri dan transformasi data](v9-panels-query-xform.md)
+ [Konfigurasikan ambang batas](v9-panels-configure-thresholds.md)
+ [Konfigurasikan tautan data](v9-panels-configure-data-links.md)
+ [Konfigurasikan penggantian bidang](v9-panels-configure-overrides.md)
+ [Konfigurasikan pemetaan nilai](v9-panels-configure-value-mappings.md)
+ [Konfigurasikan legenda](v9-panels-configure-legend.md)
+ [Jenis perhitungan](v9-panels-calculation-types.md)
+ [Visualisasi anotasi](v9-panels-annotate-visualizations.md)
+ [Panel memeriksa tampilan](v9-panels-panel-inspector.md)
+ [Visualisasi tersedia dalam Grafana versi 9](v9-panels-viz.md)

# Ikhtisar editor panel
<a name="v9-panels-editor-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Bagian ini menjelaskan area editor panel Grafana. 
+  Header panel: Bagian header mencantumkan dasbor tempat panel muncul dan kontrol berikut: 
  +  **Ikon pengaturan dasbor (roda gigi):** Klik untuk mengakses pengaturan dasbor. 
  +  **Buang:** Buang perubahan yang telah Anda buat pada panel sejak terakhir kali Anda menyimpan dasbor. 
  +  **Simpan:** Menyimpan perubahan yang Anda buat ke panel. 
  +  **Terapkan: Menerapkan** perubahan yang Anda buat dan menutup editor panel, mengembalikan Anda ke dasbor. Anda harus menyimpan dasbor untuk mempertahankan perubahan yang diterapkan. 
+  Pratinjau visualisasi: Bagian pratinjau visualisasi berisi opsi berikut: 
  +  **Tampilan tabel:** Mengkonversi visualisasi ke tabel sehingga Anda dapat melihat data. Tampilan tabel sangat membantu untuk pemecahan masalah. Tampilan ini hanya berisi data mentah. Ini tidak termasuk transformasi yang mungkin telah Anda terapkan pada data atau opsi pemformatan yang tersedia dalam visualisasi [Tabel](v9-panels-table.md). 
  +  **Isi: Pratinjau** visualisasi mengisi ruang yang tersedia. Jika Anda mengubah lebar panel samping atau tinggi panel bawah, visualisasi berubah untuk mengisi ruang yang tersedia. 
  +  **Aktual:** Pratinjau visualisasi akan memiliki ukuran yang tepat seperti ukuran di dasbor. Jika tidak cukup ruang yang tersedia, visualisasi akan mengurangi menjaga rasio aspek. 
  +  **Kontrol rentang waktu:** **Default** adalah zona waktu lokal browser atau zona waktu yang dipilih pada tingkat yang lebih tinggi. 
+  Bagian data: Bagian data berisi tab tempat Anda memasukkan kueri, mengubah data, dan membuat aturan peringatan (jika berlaku). 
  +  **Tab kueri:** Pilih sumber data Anda dan masukkan kueri di sini. 
  +  **Tab Transform:** Terapkan transformasi data. 
  +  **Tab peringatan:** Tulis aturan peringatan. 
+  Opsi tampilan panel: Bagian opsi tampilan berisi tab tempat Anda mengonfigurasi hampir setiap aspek visualisasi data Anda. 

## Buka panel periksa laci
<a name="v9-panels-editor-open-panel"></a>

 Laci inspeksi membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat melihat data mentah untuk panel apa pun, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, dan mengekspor panel dan data JSON. 

 **Catatan:** Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri. 

 Inspektur panel terdiri dari opsi-opsi berikut: 
+  Panel memeriksa tampilan laci membuka laci di sisi kanan. Klik panah di sudut kanan atas untuk memperluas atau mengurangi panel laci. 
+  **Tab data -** Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default. 
+  **Tab Statistik -** Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan. 
+  **Tab JSON -** Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana. 
+  **Tab kueri -** Menunjukkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data. 
+  **Tab kesalahan -** Menampilkan kesalahan. Hanya terlihat ketika kueri mengembalikan kesalahan. 

# Konfigurasikan opsi panel
<a name="v9-panels-configure-panel-options"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Panel Grafana adalah antarmuka pengguna yang Anda gunakan untuk menentukan kueri sumber data, dan mengubah serta memformat data yang muncul dalam visualisasi. 

 Editor panel menyertakan pembuat kueri dan serangkaian opsi yang dapat Anda gunakan untuk mengubah data dan menambahkan informasi ke panel Anda. 

 Topik ini menjelaskan cara: 
+  Buka panel untuk mengedit 
+  Tambahkan judul dan deskripsi panel 
+  Lihat model panel JSON 
+  Tambahkan baris dan panel berulang 

## Mengedit panel
<a name="v9-panels-edit-a-panel"></a>

 Setelah menambahkan panel ke dasbor, Anda dapat membukanya kapan saja untuk mengubah atau memperbarui kueri, menambahkan transformasi data, dan mengubah pengaturan visualisasi. 

1.  Buka dasbor yang berisi panel yang ingin Anda edit. 

1.  Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas. 

1.  Klik menu dan pilih **Edit**. 

    **Untuk menggunakan pintasan keyboard untuk membuka panel, arahkan kursor ke panel dan tekan e.** 

    Panel terbuka dalam mode edit. 

## Tambahkan judul dan deskripsi ke panel
<a name="v9-panels-add-title-description"></a>

 Tambahkan judul dan deskripsi ke panel untuk berbagi dengan pengguna informasi penting tentang visualisasi. Misalnya, gunakan deskripsi untuk mendokumentasikan tujuan visualisasi. 

1.  Edit panel. 

1.  Di panel opsi tampilan panel, cari bagian **Opsi panel**. 

1.  Masukkan **Judul**. 

    Teks yang dimasukkan dalam bidang ini muncul di bagian atas panel Anda di editor panel dan di dasbor. 

1.  Tulis deskripsi panel dan data yang Anda tampilkan. 

    Teks yang dimasukkan dalam bidang ini muncul di tooltip di sudut kiri atas panel. 

    Anda dapat menggunakan [variabel yang telah Anda tentukan](v9-dash-variables.md) di bidang **Judul** dan **Deskripsi**, tetapi bukan [variabel global](v9-dash-variable-add.md#v9-dash-variable-add-global).

    

## Lihat model panel JSON
<a name="v9-panels-json-model"></a>

 Jelajahi dan ekspor panel, data panel, dan model JSON bingkai data. 

1.  Buka dasbor yang berisi panel. 

1.  Arahkan kursor ke bagian mana pun dari panel untuk menampilkan menu tindakan di sudut kanan atas. 

1.  Klik menu dan pilih **Inspect > Panel JSON**. 

1.  Di bidang **Pilih sumber**, pilih salah satu opsi berikut: 
   +  **Panel JSON:** Menampilkan objek JSON yang mewakili panel. 
   +  **Data panel:** Menampilkan objek JSON yang mewakili data yang diteruskan ke panel. 
   +  **DataFrame struktur:** Menampilkan set hasil mentah dengan transformasi, konfigurasi bidang, dan konfigurasi penggantian yang diterapkan. 

1.  Untuk menjelajahi JSON, klik **>** untuk memperluas atau menciutkan bagian dari model JSON. 

## Konfigurasikan panel berulang
<a name="v9-panels-configure-repeating-panels"></a>

 Anda dapat mengonfigurasi Grafana untuk menambahkan panel atau baris secara dinamis ke dasbor. Panel dinamis adalah panel yang dibuat sistem berdasarkan nilai variabel. Variabel secara dinamis mengubah kueri Anda di semua panel di dasbor.

**catatan**  
Panel berulang membutuhkan variabel untuk memiliki satu atau lebih item yang dipilih; Anda tidak dapat mengulangi panel nol kali untuk menyembunyikannya. 

 **Sebelum Anda mulai:** 
+  Pastikan bahwa kueri menyertakan variabel multi-nilai. 

 **Untuk mengkonfigurasi panel berulang:** 

1. Edit panel yang ingin Anda ulangi.

1.  Pada panel opsi tampilan, klik Opsi **panel > Ulangi opsi**. 

1.  Pilih **arah**. 
   +  Pilih **horizontal** untuk mengatur panel side-by-side. Grafana menyesuaikan lebar panel berulang. Saat ini, Anda tidak dapat mencampur panel lain secara berurutan dengan panel berulang. 
   +  Pilih **vertikal** untuk mengatur panel dalam kolom. Lebar panel berulang sama dengan panel asli yang berulang. 

1.  Untuk menyebarkan perubahan ke semua panel, muat ulang dasbor. 

# Konfigurasikan opsi standar
<a name="v9-panels-configure-standard-options"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Model data yang digunakan dalam Grafana adalah struktur tabel berorientasi kolumnar yang menyatukan deret waktu dan hasil kueri tabel. Setiap kolom dalam struktur ini disebut *bidang*. Bidang dapat mewakili satu deret waktu atau kolom tabel. 

 Opsi bidang memungkinkan Anda mengubah cara data ditampilkan dalam visualisasi Anda. Opsi dan penggantian yang Anda terapkan tidak mengubah data, mereka mengubah cara Grafana menampilkan data. Ketika Anda mengubah opsi, itu diterapkan ke semua bidang, yang berarti semua seri atau kolom. Misalnya, jika Anda mengubah unit menjadi persentase, maka semua bidang dengan nilai numerik ditampilkan dalam persentase. 

 Untuk daftar lengkap opsi pemformatan bidang, lihat [Definisi opsi standar](#v9-panels-standard-options-definitions).

**catatan**  
 Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini. 

1.  Buka dasbor, klik judul panel, dan klik **Edit**. 

1.  Di panel opsi tampilan panel, cari bagian **Opsi standar**. 

1.  Pilih opsi standar yang ingin Anda terapkan. 

1.  Untuk melihat pratinjau perubahan Anda, klik di luar kotak opsi bidang yang sedang Anda edit atau tekan **Enter**. 

## Definisi opsi standar
<a name="v9-panels-standard-options-definitions"></a>

 Bagian ini menjelaskan semua opsi standar yang tersedia. 

 Anda dapat menerapkan opsi standar ke sebagian besar panel Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini. 

 Sebagian besar opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter. 

**catatan**  
 Kami terus berupaya menambah dan memperluas opsi untuk semua visualisasi, jadi semua opsi mungkin tidak tersedia untuk semua visualisasi. 

### Unit
<a name="v9-panels-standard-options-unit"></a>

 Memungkinkan Anda memilih unit apa yang harus digunakan bidang. Klik di bidang **Unit**, lalu telusuri sampai Anda menemukan unit yang Anda inginkan. Unit yang Anda pilih diterapkan ke semua bidang kecuali waktu. 

#### Unit kustom
<a name="v9-panels-standard-options-custom-units"></a>

 Anda dapat menggunakan dropdown unit untuk juga menentukan unit kustom, awalan kustom atau akhiran dan format waktu tanggal. 

 Untuk memilih unit kustom, masukkan unit dan pilih opsi **Custom: xxx** terakhir di dropdown. 
+  **akhiran:** <suffix>untuk unit khusus yang harus mengejar nilai. 
+  **awalan:** <prefix>untuk unit kustom yang harus pergi sebelum nilai. 
+  **waktu:** <format>Untuk format waktu tanggal kustom ketik misalnya **waktu:** YYYY-MM-DD. Lihat [format](https://momentjs.com/docs/#/displaying/) untuk sintaks format dan opsi.
+  **si:** <base scale><unit characters>untuk unit SI kustom. Misalnya: **si: mF**. Yang ini sedikit lebih maju karena Anda dapat menentukan unit dan skala data sumber. Jadi jika data sumber Anda direpresentasikan sebagai milli (ribuan) sesuatu mengawali unit dengan karakter skala SI itu. 
+  **count:** <unit>untuk unit hitungan kustom. 
+  **mata uang:** <unit>untuk kustom unit mata uang. 

 Anda juga dapat menempelkan emoji asli di pemilih unit dan memilihnya sebagai unit khusus. 

#### Satuan string
<a name="v9-panels-standard-options-string-units"></a>

 Grafana terkadang bisa terlalu agresif dalam mengurai string dan menampilkannya sebagai angka. **Untuk mengonfigurasi Grafana untuk menampilkan nilai string asli, buat penggantian bidang dan tambahkan properti unit dengan unit String.** 

### Min
<a name="v9-panels-standard-options-min"></a>

 Memungkinkan Anda menetapkan nilai minimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk perhitungan otomatis berdasarkan semua seri dan bidang. 

### Maks
<a name="v9-panels-standard-options-max"></a>

 Memungkinkan Anda menetapkan nilai maksimum yang digunakan dalam perhitungan ambang persentase. Biarkan kosong untuk perhitungan otomatis berdasarkan semua seri dan bidang. 

### Desimal
<a name="v9-panels-standard-options-decimals"></a>

 Tentukan jumlah desimal Grafana termasuk dalam nilai yang diberikan. Jika Anda membiarkan bidang ini kosong, Grafana secara otomatis memotong jumlah desimal berdasarkan nilainya. Misalnya 1.1234 akan ditampilkan sebagai 1.12 dan 100.456 akan ditampilkan sebagai 100. 

 **Untuk menampilkan semua desimal, atur unit ke String.** 

### Nama tampilan
<a name="v9-panels-standard-options-displayname"></a>

 Memungkinkan Anda mengatur judul tampilan semua bidang. Anda dapat menggunakan [variabel](v9-dash-variables.md).

 Ketika beberapa statistik, bidang, atau seri ditampilkan, bidang ini mengontrol judul di setiap stat. Anda dapat menggunakan ekspresi seperti **\$1 \$1\$1\$1field.name\$1** untuk hanya menggunakan nama seri atau nama bidang dalam judul. 

 Diberikan bidang dengan nama Temp, dan label \$1"loc"="PBI”, “Sensor"="3"\$1 


|  Sintaksis ekspresi  |  Contoh  |  Render ke  |  Penjelasan  | 
| --- | --- | --- | --- | 
|  \$1 \$1\$1\$1field.displayName\$1  |  Sama seperti sintaks  |  Suhu \$1loc="PBI”, Sensor="3"\$1  |  Menampilkan nama bidang, dan label di \$1\$1 jika ada. Jika hanya ada satu kunci label dalam respons, maka untuk bagian label, Grafana menampilkan nilai label tanpa tanda kurung yang terlampir.  | 
|  \$1 \$1\$1\$1field.name\$1  |  Sama seperti sintaks  |  Temp  |  Menampilkan nama bidang (tanpa label).  | 
|  \$1 \$1\$1\$1field.labels\$1  |  Sama seperti sintaks  |  loc="PBI”, Sensor = “3"  |  Menampilkan label tanpa nama.  | 
|  \$1 \$1\$1\$1field.labels.x\$1  |  \$1 \$1\$1\$1field.labels.loc\$1  |  PBI  |  Menampilkan nilai kunci label yang ditentukan.  | 
|  \$1 \$1\$1\$1field.labels. \$1\$1nilai\$1  |  Sama seperti Sintaks  |  PBI, 3  |  Menampilkan nilai-nilai label yang dipisahkan oleh koma (tanpa kunci label).  | 

 Jika nilainya adalah string kosong setelah merender ekspresi untuk bidang tertentu, maka metode tampilan default digunakan. 

### Skema warna
<a name="v9-panels-standard-options-color-scheme"></a>

 Pilihan warna dan efeknya pada visualisasi tergantung pada visualisasi yang Anda kerjakan. Beberapa visualisasi memiliki pilihan warna yang berbeda. 

 Anda dapat menentukan satu warna, atau memilih skema warna kontinu (gradien), berdasarkan nilai. Warna kontinu menginterpolasi warna menggunakan persentase nilai relatif terhadap min dan maks. 

 Pilih salah satu palet berikut: 


|  Modus warna  |  Deskripsi  | 
| --- | --- | 
|  Warna tunggal  |  Tentukan satu warna, berguna dalam aturan penggantian  | 
|  Dari ambang batas  |  Menginformasikan Grafana untuk mengambil warna dari ambang yang cocok  | 
|  Palet klasik  |  Grafana akan menetapkan warna dengan mencari warna dalam palet dengan indeks seri. Berguna untuk Grafik dan diagram lingkaran dan visualisasi data kategoris lainnya  | 
|  Green-Yellow-Red (berdasarkan nilai)  |  Skema warna berkelanjutan  | 
|  Blue-Yellow-Red (berdasarkan nilai)  |  Skema warna berkelanjutan  | 
|  Blues (berdasarkan nilai)  |  Skema warna terus menerus (latar belakang panel ke biru)  | 
|  Merah (berdasarkan nilai)  |  Skema warna terus menerus (warna latar belakang panel ke biru)  | 
|  Hijau (berdasarkan nilai)  |  Skema warna terus menerus (warna latar belakang panel ke biru)  | 
|  Ungu (berdasarkan nilai)  |  Skema warna terus menerus (warna latar belakang panel ke biru)  | 

### Tidak ada nilai
<a name="v9-panels-standard-options-no-value"></a>

 Masukkan apa yang harus ditampilkan Grafana jika nilai bidang kosong atau nol. Nilai default adalah tanda hubung (-). 

# Kueri dan transformasi data
<a name="v9-panels-query-xform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana mendukung banyak jenis sumber [data](AMG-data-sources.md). *Kueri* sumber data mengembalikan data yang *dapat* diubah dan divisualisasikan oleh Grafana. Setiap sumber data menggunakan bahasa kueri sendiri, dan plugin sumber data masing-masing menerapkan antarmuka pengguna yang membangun kueri yang disebut editor kueri.

## Tentang pertanyaan
<a name="v9-panels-query-xform-about"></a>

Panel Grafana berkomunikasi dengan sumber data melalui kueri, yang mengambil data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data.

Anda dapat mengonfigurasi frekuensi kueri dan batas pengumpulan data dalam opsi sumber data panel. Grafana mendukung hingga 26 kueri per panel.

Anda dapat menemukan informasi selengkapnya tentang bahasa kueri setiap sumber [data di bagian Sumber data](AMG-data-sources.md).

**Editor kueri**

Setiap *editor kueri* sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Untuk detail tentang fitur editor kueri unik sumber data tertentu, lihat dokumentasinya:
+ Untuk sumber data yang disertakan dengan Grafana, lihat Sumber [data bawaan](AMG-data-sources-builtin.md).
+ Untuk sumber data yang disertakan dengan edisi Grafana Enterprise, lihat. [Connect ke sumber data Enterprise](AMG-data-sources-enterprise.md)

**Sintaks kueri**

Sumber data menggunakan bahasa kueri yang berbeda untuk meminta data. Untuk detail tentang bahasa kueri unik sumber data tertentu, lihat dokumentasinya.

**Contoh PostgreSQL:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**Contoh PromQL:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Sumber data khusus**

**Grafana juga mencakup tiga sumber data khusus: **Grafana**, **Campuran**, dan Dasbor.** Untuk detailnya, lihat Sumber data

## Navigasikan tab kueri
<a name="v9-panels-query-xform-navigate"></a>

Tab **Query** panel terdiri dari elemen-elemen berikut:
+ **Pemilih sumber data** - Memilih sumber data untuk kueri.
+ **Opsi kueri:** — Menetapkan parameter pengambilan data maksimum dan interval waktu menjalankan kueri.
+ **Tombol inspektur kueri:** — Membuka panel inspektur kueri, tempat Anda dapat melihat dan mengoptimalkan kueri Anda.
+ **Daftar editor kueri:** — Daftar kueri yang telah Anda tulis.
+ **Ekspresi:** — Menggunakan pembuat ekspresi untuk membuat ekspresi peringatan. Untuk informasi selengkapnya tentang ekspresi, lihat[Tulis kueri ekspresi](v9-panels-query-xform-expressions.md).

## Tambahkan kueri
<a name="v9-panels-query-xform-add"></a>

Kueri mengembalikan data yang divisualisasikan Grafana di panel dasbor. Saat Anda membuat panel, Grafana secara otomatis memilih sumber data default.

**Untuk menambahkan kueri**

1. Edit panel tempat Anda menambahkan kueri.

1. Pilih tab **Kueri**.

1. Pilih menu tarik-turun **Sumber data** dan pilih sumber data.

1. Pilih **opsi Kueri** untuk mengonfigurasi jumlah maksimum titik data yang Anda butuhkan. Untuk informasi selengkapnya tentang opsi kueri, lihat[Opsi kueri](#v9-panels-query-xform-options).

1. Tulis kueri menggunakan editor kueri.

1. Pilih **Terapkan**.

Grafana menanyakan sumber data dan memvisualisasikan data.

## Kelola kueri
<a name="v9-panels-query-xform-manage"></a>

Grafana mengatur kueri dalam baris kueri yang dapat dilipat. Setiap baris kueri berisi editor kueri dan diidentifikasi dengan huruf (A, B, C, dan sebagainya).

Untuk mengelola kueri, Anda dapat menyalin kueri, menyembunyikan kueri, menghapus kueri, menyusun ulang kueri, dan beralih bantuan untuk editor kueri.

## Opsi kueri
<a name="v9-panels-query-xform-options"></a>

Pilih **Opsi kueri** di sebelah pemilih sumber data untuk melihat pengaturan sumber data yang dipilih. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini.

Grafana menetapkan default yang ditampilkan dalam teks abu-abu gelap. Perubahan ditampilkan dalam teks putih. Untuk mengembalikan bidang ke pengaturan default, hapus teks putih dari bidang.

Opsi kueri sumber data panel meliputi:
+ **Titik data maksimum** - Jika sumber data mendukungnya, ini menetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, maka sumber data mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata, maks, atau fungsi lain.

  Anda dapat membatasi jumlah poin untuk meningkatkan kinerja kueri atau menghaluskan garis yang divisualisasikan. Nilai default adalah lebar (atau jumlah piksel) grafik, karena Anda hanya dapat memvisualisasikan titik data sebanyak panel grafik memiliki ruang untuk ditampilkan.

  Dengan streaming data, Grafana menggunakan nilai titik data maksimal untuk buffer bergulir. Streaming adalah aliran data yang berkelanjutan, dan buffering membagi aliran menjadi beberapa bagian. Misalnya, Loki mengalirkan data dalam mode tailing langsungnya.
+ **Interval min** - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, yang biasanya merupakan interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak mendapat manfaat dari interval yang lebih rendah dari itu. Anda juga dapat mengatur ini ke minimum yang lebih tinggi daripada interval scrape untuk mengambil kueri yang lebih kasar dan berfungsi dengan baik.
+ **Interval** - Menetapkan rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu.

  Grafana secara otomatis menghitung interval yang sesuai yang dapat Anda gunakan sebagai variabel dalam kueri templat. Variabel diukur dalam detik (`$__interval`) atau milidetik (`$__interval_ms`).

  Interval biasanya digunakan dalam fungsi agregasi seperti jumlah atau rata-rata. Misalnya, ini adalah kueri Prometheus yang menggunakan variabel interval:. `rate(http_requests_total[$__interval])`

  Interval otomatis ini dihitung berdasarkan lebar grafik. Saat pengguna memperkecil visualisasi, interval tumbuh, menghasilkan agregasi yang lebih kasar. Demikian juga, jika pengguna memperbesar, intervalnya berkurang, menghasilkan agregasi yang lebih halus.

  Untuk informasi selengkapnya, lihat [Variabel global](v9-dash-variable-add.md#v9-dash-variable-add-global).
+ **Waktu relatif** — Mengganti rentang waktu relatif untuk panel individu, yang menyebabkannya berbeda dari apa yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Anda dapat menggunakan ini untuk menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Pergeseran waktu** — Mengganti rentang waktu untuk panel individu dengan menggeser awal dan akhir relatif terhadap pemilih waktu. Misalnya, Anda dapat menggeser rentang waktu panel menjadi dua jam lebih awal dari pemilih waktu dasbor.
**catatan**  
Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/v9-panels-query-xform.html)
+ Batas **waktu cache** — *(Terlihat hanya jika tersedia di sumber data)* Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Tentukan nilai ini sebagai nilai numerik dalam hitungan detik.

# Tulis kueri ekspresi
<a name="v9-panels-query-xform-expressions"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data.

## Tentang ekspresi
<a name="v9-panels-query-about"></a>

Ekspresi sisi server memungkinkan Anda memanipulasi data yang dikembalikan dari kueri dengan matematika dan operasi lainnya. Ekspresi membuat data baru dan tidak memanipulasi data yang dikembalikan oleh sumber data, selain dari beberapa restrukturisasi data kecil untuk membuat input data yang dapat diterima untuk ekspresi.

**Menggunakan ekspresi**

Ekspresi terutama digunakan oleh [Grafana](v9-alerts.md) Alerting. Pemrosesan dilakukan sisi server, sehingga ekspresi dapat beroperasi tanpa sesi browser. Namun, ekspresi juga dapat digunakan dengan sumber data backend dan visualisasi.

**catatan**  
Ekspresi tidak berfungsi dengan peringatan dasbor lama.

Ekspresi dimaksudkan untuk menambah sumber data dengan memungkinkan kueri dari sumber data yang berbeda untuk digabungkan atau dengan menyediakan operasi yang tidak tersedia di sumber data.

**catatan**  
Jika memungkinkan, Anda harus melakukan pemrosesan data di dalam sumber data. Menyalin data dari penyimpanan ke server Grafana untuk diproses tidak efisien, sehingga ekspresi ditargetkan pada pemrosesan data ringan.

Ekspresi bekerja dengan kueri sumber data yang mengembalikan deret waktu atau data angka. Mereka juga beroperasi pada data [multi-dimensi](getting-started-grafanaui.md#time-series-dimensions). Misalnya, kueri yang mengembalikan beberapa seri, di mana setiap seri diidentifikasi oleh label atau tag.

Ekspresi individu mengambil satu atau lebih kueri atau ekspresi lain sebagai input dan menambahkan data ke hasilnya. Setiap ekspresi atau kueri individu diwakili oleh variabel yang merupakan pengidentifikasi bernama yang dikenal sebagai ReFID-nya (misalnya, huruf `A` default atau). `B`

Untuk mereferensikan output dari ekspresi individu atau kueri sumber data dalam ekspresi lain, pengidentifikasi ini digunakan sebagai variabel.

**Jenis ekspresi**

Ekspresi bekerja dengan dua jenis data.
+ Koleksi deret waktu.
+ Kumpulan angka, di mana setiap nomor adalah item.

Setiap koleksi dikembalikan dari kueri atau ekspresi sumber data tunggal dan diwakili oleh ReFID. Setiap koleksi adalah satu set, di mana setiap item dalam set diidentifikasi secara unik oleh dimensinya yang disimpan sebagai [label](getting-started-grafanaui.md#labels) atau pasangan nilai kunci.

**Kueri sumber data**

Ekspresi sisi server hanya mendukung kueri sumber data untuk sumber data backend. Data umumnya diasumsikan diberi label data deret waktu. Di masa depan kami bermaksud menambahkan pernyataan data tipe pengembalian kueri (nomor atau deret waktu) sehingga ekspresi dapat menangani kesalahan dengan lebih baik.

Kueri sumber data, bila digunakan dengan ekspresi, dijalankan oleh mesin ekspresi. Ketika melakukan ini, ia merestrukturisasi data menjadi satu deret waktu atau satu angka per frame data. Jadi misalnya jika menggunakan sumber data yang mengembalikan beberapa seri pada satu bingkai dalam tampilan tabel, Anda mungkin melihat itu terlihat berbeda saat dijalankan dengan ekspresi.

Saat ini, satu-satunya format seri non-waktu (angka) yang didukung saat menggunakan bingkai data adalah Anda memiliki respons tabel yang mengembalikan bingkai data tanpa waktu, kolom string, dan satu kolom angka:


| Loc | Host | AVG\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

Contoh di atas akan menghasilkan angka yang bekerja dengan ekspresi. Kolom string menjadi label dan kolom nomor nilai yang sesuai. Misalnya `{"Loc": "MIA", "Host": "A"}` dengan nilai 1.

**Operasi**

Anda dapat menggunakan operasi berikut dalam ekspresi: matematika, kurangi, dan sampel ulang.

**Matematika**

Matematika adalah untuk rumus matematika bentuk bebas pada deret waktu atau data angka. Operasi matematika mengambil angka dan deret waktu sebagai masukan dan mengubahnya menjadi angka dan deret waktu yang berbeda.

Data dari kueri atau ekspresi lain direferensikan dengan awalan ReFID dengan tanda dolar, misalnya. `$A` Jika variabel memiliki spasi dalam nama, maka Anda dapat menggunakan sintaks kurung kurung seperti. `${my variable}`

Konstanta numerik bisa dalam desimal (`2.24`), oktal (dengan nol terkemuka seperti`072`), atau hex (dengan seperti 0x terkemuka). `0x2A` Eksponensial dan tanda juga didukung (misalnya,). `-0.8e-2`

**Operator**

Operator aritmatika (`+`, biner dan unary`-`,,`*`,`/`,`%`, eksponen`**`), relasional (,`<`,,,`>`,`<=`) `==``!=`, `>=` dan logis (,, dan unary) `&&` didukung`||`. `!`

Bagaimana operasi berperilaku dengan data tergantung pada apakah itu adalah data angka atau deret waktu.

Dengan operasi biner`$A || $B`, seperti `$A + $B` atau, operator diterapkan dengan cara berikut tergantung pada jenis data:
+ Jika keduanya `$A` dan `$B` merupakan angka, maka operasi dilakukan antara dua angka.
+ Jika satu variabel adalah angka, dan variabel lainnya adalah deret waktu, maka operasi antara nilai setiap titik dalam deret waktu dan angka dilakukan.
+ Jika keduanya `$A` dan `$B` merupakan data deret waktu, maka operasi antara setiap nilai dalam dua seri dilakukan untuk setiap cap waktu yang ada di keduanya `$A` dan`$B`. `Resample`Operasi ini dapat digunakan untuk menyusun stempel waktu.

Ringkasan:
+ Nomor nomor OP = angka
+ Nomor seri OP = seri
+ Seri OP seri = seri

Karena ekspresi bekerja dengan beberapa seri atau angka yang diwakili oleh satu variabel, operasi biner juga melakukan penyatuan (gabungan) antara dua variabel. Ini dilakukan berdasarkan label pengenal yang terkait dengan setiap seri atau nomor individu.

Jadi jika Anda memiliki angka dengan label seperti `{host=web01}` in `$A` dan nomor lain `$B` dengan label yang sama maka operasi dilakukan antara dua item dalam setiap variabel, dan hasilnya akan berbagi label yang sama. Aturan untuk perilaku serikat ini adalah sebagai berikut:
+ Item tanpa label akan bergabung dengan apa pun.
+ Jika keduanya `$A` dan `$B` masing-masing hanya berisi satu item (satu seri, atau satu nomor), mereka akan bergabung.
+ Jika label adalah matematika yang tepat, mereka akan bergabung.
+ Jika label adalah bagian dari yang lain, misalnya item di `$A` diberi label `{host=A,dc=MIA}` dan item di `$B` diberi label, `{host=A}` mereka akan bergabung.
+ Jika dalam variabel seperti `$A` ada kunci tag yang berbeda untuk setiap item, perilaku bergabung tidak terdefinisi.

Operator relasional dan logis mengembalikan 0 untuk false 1 untuk true.

**Fungsi Matematika**

Sementara sebagian besar fungsi ada dalam operasi ekspresi sendiri, operasi matematika memang memiliki beberapa fungsi yang mirip dengan operator matematika atau simbol. Ketika fungsi dapat mengambil angka atau seri, dari jenis yang sama dengan argumen akan dikembalikan. Ketika itu adalah seri, operasi dilakukan untuk nilai setiap titik dalam seri.

*perut*

abs mengembalikan nilai absolut dari argumennya yang dapat berupa angka atau seri. Misalnya, `abs(-1)` atau `abs($A)`.

*is\$1inf*

is\$1inf mengambil angka atau seri dan mengembalikan `1` `Inf` nilai (negatif atau positif) dan `0` untuk nilai lainnya. Sebagai contoh, `is_inf($A)`.

**catatan**  
Jika Anda perlu secara khusus memeriksa ketidakterbatasan negatif misalnya, Anda dapat melakukan perbandingan seperti`$A == infn()`.

*is\$1nan*

is\$1nan mengambil angka atau seri dan mengembalikan `1` `NaN` nilai dan `0` nilai lainnya. Sebagai contoh, `is_nan($A)`. Fungsi ini `NaN` ada karena tidak sama dengan`NaN`.

*adalah\$1null*

is\$1null mengambil angka atau seri dan mengembalikan `1` `null` nilai dan nilai lainnya`0`. Sebagai contoh, `is_null($A)`.

*is\$1number*

is\$1number mengambil angka atau seri dan mengembalikan `1` untuk semua nilai bilangan real dan `0` untuk nilai lainnya (yaitu`null`,, `Inf+``Inf-`, dan`NaN`). Sebagai contoh, `is_number($A)`.

*log*

Log mengembalikan logaritma natural dari argumennya yang dapat berupa angka atau seri. Jika nilainya kurang dari 0, `NaN` dikembalikan. Misalnya, `log(-1)` atau `log($A)`.

*inf, infn, nan, dan null*

Fungsi inf, infn, nan, dan null semuanya mengembalikan satu nilai nama. Mereka terutama ada untuk pengujian. Contoh:`null()`.

*bulat*

Round mengembalikan nilai integer bulat. Misalnya, `round(3.123)` atau `round($A)`.

*ceil*

Ceil membulatkan angka ke nilai integer terdekat. Misalnya, `ceil(3.123)` mengembalikan `4`.

*lantai*

Lantai membulatkan angka ke bawah ke nilai integer terdekat. Misalnya,`floor(3.123`) kembali`3`.

**Mengurangi**

Reduce mengambil satu atau lebih deret waktu yang dikembalikan dari kueri atau ekspresi dan mengubah setiap seri menjadi satu nomor. Label deret waktu disimpan sebagai label pada setiap angka yang dikurangi yang dikeluarkan.

*Bidang:*
+ **Fungsi — Fungsi** reduksi yang digunakan
+ **Input** - Variabel (ReFID (seperti`A`)) untuk sampel ulang
+ **Mode** - Memungkinkan perilaku kontrol fungsi reduksi ketika seri berisi nilai non-numerik (null, NaN, \$1-Inf)

**Fungsi Reduksi**

*Hitungan*

Hitung mengembalikan jumlah poin di setiap seri.

*Berarti*

Mean mengembalikan total semua nilai dalam setiap seri dibagi dengan jumlah poin dalam seri itu. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Min dan Max*

Min dan Max mengembalikan nilai terkecil atau terbesar dalam seri masing-masing. Dalam `strict` mode jika ada nilai dalam seri nol atau nan, atau jika seri kosong, NaN dikembalikan.

*Jumlah*

Jumlah mengembalikan total semua nilai dalam seri. Jika seri memiliki panjang nol, jumlahnya akan menjadi 0. Dalam `strict` mode jika ada nilai NaN atau Null dalam seri, NaN dikembalikan.

*Terakhir*

Terakhir mengembalikan nomor terakhir dalam seri. Jika seri tidak memiliki nilai maka kembali NaN.

**Mode Pengurangan**

*Ketat*

Dalam mode Ketat, seri input diproses apa adanya. Jika ada nilai dalam seri non-numerik (null, NaN atau \$1-Inf), NaN dikembalikan.

*Jatuhkan Non-Numerik*

Dalam mode ini semua nilai non-numerik (null, NaN atau \$1-Inf) dalam seri input disaring sebelum menjalankan fungsi reduksi.

*Ganti Non-Numerik*

Dalam mode ini semua nilai non-numerik diganti dengan nilai yang telah ditentukan sebelumnya.

**Sampel ulang**

Sampel ulang mengubah stempel waktu di setiap deret waktu agar memiliki interval waktu yang konsisten. Kasus penggunaan utama adalah agar Anda dapat mengambil sampel ulang deret waktu yang tidak berbagi stempel waktu yang sama sehingga matematika dapat dilakukan di antara mereka. Ini dapat dilakukan dengan mengambil sampel ulang masing-masing dari dua seri, dan kemudian dalam operasi Matematika yang merujuk variabel sampel ulang.

*Bidang:*
+ **Input** - Variabel data deret waktu (ReFID (seperti`A`)) untuk sampel ulang
+ **Sampel ulang** ke — Durasi waktu untuk mengambil sampel ulang, misalnya `10s.` Satuan dapat berupa `s` detik, menit, `m` `h` berjam-jam, berhari-hari, `d` `w` berminggu-minggu, dan `y` bertahun-tahun.
+ **Downsample** - Fungsi reduksi untuk digunakan ketika ada lebih dari satu titik data per sampel jendela. Lihat operasi reduksi untuk detail perilaku.
+ **Upsample** — Metode yang digunakan untuk mengisi sampel jendela yang tidak memiliki titik data.
  + **pad** diisi dengan nilai yang diketahui terakhir
  + **isi ulang** dengan nilai yang diketahui berikutnya
  + **fillna** untuk mengisi jendela sampel kosong dengan NaNs

## Tulis ekspresi
<a name="v9-panels-query-write"></a>

Jika sumber data Anda mendukungnya, Grafana menampilkan tombol **Ekspresi dan menampilkan ekspresi** yang ada dalam daftar editor kueri.

**Untuk menulis ekspresi**

1. Buka panelnya.

1. Di bawah kueri, pilih **Ekspresi**.

1. Di bidang **Operasi**, pilih jenis ekspresi yang ingin Anda tulis.

1. Tulis ekspresinya.

1. Pilih **Terapkan**.

## Kasus khusus
<a name="v9-panels-query-special"></a>

Ketika sumber data yang ditanyakan tidak mengembalikan seri atau angka, mesin ekspresi kembali`NoData`. Misalnya, jika permintaan berisi dua kueri sumber data yang digabungkan dengan ekspresi, jika `NoData` dikembalikan oleh setidaknya salah satu kueri sumber data, maka hasil yang dikembalikan untuk seluruh kueri adalah. `NoData` Untuk informasi selengkapnya tentang cara Grafana Alerting memproses `NoData` hasil, lihat. [Tidak menangani data atau kasus kesalahan](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)

# Bagikan hasil kueri dengan panel lain
<a name="v9-panels-query-share"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana memungkinkan Anda menggunakan hasil kueri dari satu panel untuk panel lain di dasbor. Berbagi hasil kueri di seluruh panel mengurangi jumlah kueri yang dibuat ke sumber data Anda, yang dapat meningkatkan kinerja dasbor Anda.

Sumber data Dasbor memungkinkan Anda memilih panel di dasbor yang berisi kueri yang ingin Anda bagikan hasilnya. Alih-alih mengirim kueri terpisah untuk setiap panel, Grafana mengirim satu kueri dan panel lainnya menggunakan hasil kueri untuk membangun visualisasi.

Strategi ini dapat secara drastis mengurangi jumlah kueri yang dibuat ketika Anda misalnya memiliki beberapa panel yang memvisualisasikan data yang sama.

**Untuk berbagi hasil kueri**

1. [Buat dasbor](v9-dash-creating.md).

1. Ubah judul menjadi`Source panel`. Anda akan menggunakan panel ini sebagai sumber untuk panel lainnya.

1. Tentukan kueri atau kueri yang ingin Anda bagikan.

   Jika Anda tidak memiliki sumber data yang tersedia, gunakan sumber **TestData**data, yang mengembalikan deret waktu acak yang dapat Anda gunakan untuk pengujian.

1. Tambahkan panel kedua dan pilih sumber data **Dasbor** di editor kueri.

1. Dalam **daftar Gunakan hasil dari panel**, pilih panel pertama yang Anda buat.

Semua query didefinisikan dalam panel sumber sekarang tersedia untuk panel baru. Kueri yang dibuat di panel sumber dapat dibagikan dengan beberapa panel.

Anda dapat mengklik salah satu kueri untuk pergi ke panel tempat mereka ditentukan.

# Mengubah data
<a name="v9-panels-xform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Transformasi adalah cara ampuh untuk memanipulasi data yang dikembalikan oleh kueri sebelum sistem menerapkan visualisasi. Menggunakan transformasi, Anda dapat:
+ Ganti nama bidang
+ Bergabunglah dengan data deret waktu
+ Lakukan operasi matematika di seluruh kueri
+ Gunakan output dari satu transformasi sebagai masukan ke transformasi lain

Untuk pengguna yang mengandalkan beberapa tampilan dari kumpulan data yang sama, transformasi menawarkan metode yang efisien untuk membuat dan memelihara banyak dasbor.

Anda juga dapat menggunakan output dari satu transformasi sebagai masukan ke transformasi lain, yang menghasilkan peningkatan kinerja.

**catatan**  
Terkadang sistem tidak dapat membuat grafik data yang diubah. Ketika itu terjadi, klik tombol **Tampilan tabel** di atas visualisasi untuk beralih ke tampilan tabel data. Ini dapat membantu Anda memahami hasil akhir dari transformasi Anda.

## Jenis transformasi
<a name="v9-panels-xform-types"></a>

Grafana menyediakan sejumlah cara agar Anda dapat mengubah data. Ada daftar lengkap fungsi transformasi di bawah ini.

## Urutan transformasi
<a name="v9-panels-xform-order"></a>

Ketika ada beberapa transformasi, Grafana menerapkannya dalam urutan yang terdaftar. Setiap transformasi menciptakan set hasil yang kemudian diteruskan ke transformasi berikutnya dalam pipa pemrosesan.

Urutan di mana Grafana menerapkan transformasi secara langsung berdampak pada hasil. Misalnya, jika Anda menggunakan transformasi Reduce untuk memadatkan semua hasil dari satu kolom menjadi satu nilai, maka Anda hanya dapat menerapkan transformasi ke nilai tunggal itu.

## Tambahkan fungsi transformasi ke data
<a name="v9-panels-xform-add"></a>

Langkah-langkah berikut memandu Anda dalam menambahkan transformasi ke data.

**Untuk menambahkan transformasi ke panel**

1. Arahkan ke panel tempat Anda ingin menambahkan satu atau lebih transformasi.

1. Pilih judul panel dan kemudian klik **Edit**.

1. Pilih tab **Transformasi**.

1. Pilih transformasi. Baris transformasi muncul di mana Anda mengonfigurasi opsi transformasi.

1. Untuk menerapkan transformasi lain, Pilih **Tambahkan transformasi**. Transformasi ini bekerja pada set hasil yang dikembalikan oleh transformasi sebelumnya.

## Debug transformasi
<a name="v9-panels-xform-debug"></a>

Untuk melihat input dan set hasil output transformasi, pilih ikon bug di sisi kanan baris transformasi.

Set hasil input dan output dapat membantu Anda men-debug transformasi.

## Hapus transformasi
<a name="v9-panels-xform-delete"></a>

Kami menyarankan Anda menghapus transformasi yang tidak Anda butuhkan. Saat Anda menghapus transformasi, Anda menghapus data dari visualisasi.

Prasyarat:

Identifikasi semua dasbor yang bergantung pada transformasi dan informasikan pengguna dasbor yang terkena dampak.

**Untuk menghapus transformasi**

1. Buka panel untuk mengedit.

1. Pilih tab **Transformasi**.

1. Pilih ikon sampah di sebelah transformasi yang ingin Anda hapus.

## Fungsi transformasi
<a name="v9-panels-xform-functions"></a>

Anda dapat melakukan transformasi berikut pada data Anda.

**Tambahkan bidang dari perhitungan**

Gunakan transformasi ini untuk menambahkan bidang baru yang dihitung dari dua bidang lainnya. Setiap transformasi memungkinkan Anda menambahkan satu bidang baru.
+ **Mode** - Pilih mode:
  + **Kurangi baris** - Terapkan perhitungan yang dipilih pada setiap baris bidang yang dipilih secara independen.
  + **Opsi biner** — Terapkan operasi matematika dasar (jumlah, kalikan, dll) pada nilai dalam satu baris dari dua bidang yang dipilih.
+ **Nama bidang** - Pilih nama bidang yang ingin Anda gunakan dalam perhitungan untuk bidang baru.
+ **Perhitungan** - Jika Anda memilih mode **Kurangi baris**, maka bidang **Perhitungan** akan muncul. Klik di bidang untuk melihat daftar pilihan perhitungan yang dapat Anda gunakan untuk membuat bidang baru. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v9-panels-calculation-types.md).
+ **Operasi** — Jika Anda memilih mode **opsi biner**, maka bidang **Operasi** akan muncul. Bidang ini memungkinkan Anda melakukan operasi matematika dasar pada nilai dalam satu baris dari dua bidang yang dipilih. Anda juga dapat menggunakan nilai numerik untuk operasi biner.
+ **Alias** — (Opsional) Masukkan nama bidang baru Anda. Jika Anda membiarkan ini kosong, maka bidang akan diberi nama agar sesuai dengan perhitungan.
+ **Ganti semua bidang** — (Opsional) Pilih opsi ini jika Anda ingin menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi.

**Bidang gabungan**

Transformasi ini menggabungkan semua bidang dari semua frame menjadi satu hasil. Pertimbangkan dua pertanyaan ini.

Kueri A:


| Temp | Waktu aktif | 
| --- | --- | 
|  15.4  |  1230233  | 

Kueri B:


| AQI | Kesalahan | 
| --- | --- | 
|  3.2  |  5  | 

Setelah Anda menggabungkan bidang, bingkai data akan menjadi:


| Temp | Waktu aktif | AQI | Kesalahan | 
| --- | --- | --- | --- | 
|  15.4  |  1230233  |  3.2  |  5  | 

**Config dari hasil kueri**

Transformasi ini memungkinkan Anda untuk memilih satu query dan dari itu mengekstrak opsi standar seperti **Min**, **Max**, **Unit** dan **Thresholds** dan menerapkannya ke hasil query lainnya. Ini memungkinkan konfigurasi visualisasi berbasis kueri dinamis.

Jika Anda ingin mengekstrak konfigurasi unik untuk setiap baris dalam hasil kueri konfigurasi, cobalah transformasi baris ke bidang.

**Pilihan**
+ **Query Config** - Pilih kueri yang mengembalikan data yang ingin Anda gunakan sebagai konfigurasi.
+ **Terapkan ke** - Pilih bidang atau seri apa yang akan diterapkan konfigurasi.
+ **Terapkan ke opsi** - Biasanya jenis bidang atau nama bidang regex tergantung pada opsi apa yang Anda pilih di **Terapkan** ke.

**Mengkonversi jenis bidang**

Transformasi ini mengubah jenis bidang bidang yang ditentukan.
+ **Bidang** - Pilih dari bidang yang tersedia
+ **as** — Pilih yang akan FieldType dikonversi ke
  + **Numerik** — upaya untuk membuat nilai angka
  + **String** - akan membuat nilai string
  + **Waktu** — mencoba mengurai nilai sebagai waktu
    + Akan menampilkan opsi untuk menentukan sebagai input oleh string DateFormat seperti yyyy-mm-dd atau DD MM YYYY hh: mm: ss
  + **Boolean** - akan membuat nilai-nilai Boolean

Misalnya kueri berikut dapat dimodifikasi dengan memilih bidang waktu, sebagai Waktu, dan Format Tanggal sebagai YYYY.


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
|  7/1/2017  |  atas  |  25  | 
|  8/2/2018  |  di bawah ini  |  22  | 
|  9/2/2019  |  di bawah ini  |  29  | 
|  10/4/2020  |  atas  |  22  | 

Hasilnya:


| Waktu | Tandai | Nilai | 
| --- | --- | --- | 
|  1/1/2017  |  atas  |  25  | 
|  1/1/2018  |  di bawah ini  |  22  | 
|  1/1/2019  |  di bawah ini  |  29  | 
|  1/1/2020  |  atas  |  22  | 

**Filter data berdasarkan nama**

Gunakan transformasi ini untuk menghapus bagian dari hasil kueri.

Grafana menampilkan bidang **Identifier**, diikuti oleh bidang yang dikembalikan oleh kueri Anda.

Anda dapat menerapkan filter dengan salah satu dari dua cara:
+ Masukkan ekspresi regex.
+ Pilih bidang untuk beralih pemfilteran pada bidang itu. Bidang yang difilter ditampilkan dengan teks abu-abu gelap, bidang tanpa filter memiliki teks putih.

**Filter data berdasarkan kueri**

Gunakan transformasi ini di panel yang memiliki beberapa kueri, jika Anda ingin menyembunyikan satu atau beberapa kueri.

Grafana menampilkan surat identifikasi kueri dalam teks abu-abu gelap. Klik pengenal kueri untuk beralih pemfilteran. Jika surat kueri berwarna putih, maka hasilnya akan ditampilkan. Jika surat kueri gelap, maka hasilnya disembunyikan.

**catatan**  
Transformasi ini tidak tersedia untuk Graphite karena sumber data ini tidak mendukung korelasi data yang dikembalikan dengan kueri.

**Filter data berdasarkan nilai**

Transformasi ini memungkinkan Anda untuk memfilter data Anda secara langsung di Grafana dan menghapus beberapa titik data dari hasil kueri Anda. Anda memiliki opsi untuk menyertakan atau mengecualikan data yang cocok dengan satu atau beberapa kondisi yang Anda tentukan. Kondisi diterapkan pada bidang yang dipilih.

Transformasi ini berguna jika sumber data Anda tidak memfilter secara native berdasarkan nilai. Anda juga dapat menggunakan ini untuk mempersempit nilai untuk ditampilkan jika Anda menggunakan kueri bersama.

Kondisi yang tersedia untuk semua bidang adalah:
+ **Regex - Cocokkan ekspresi regex**
+ **Apakah Null** - Cocokkan jika nilainya nol
+ **Is Not Null** — Cocokkan jika nilainya tidak null
+ **Sama** - Cocokkan jika nilainya sama dengan nilai yang ditentukan
+ **Berbeda** - cocok jika nilainya berbeda dari nilai yang ditentukan

Kondisi yang tersedia untuk bidang angka adalah:
+ **Lebih besar** — Cocokkan jika nilainya lebih besar dari nilai yang ditentukan
+ **Lower** — Cocokkan jika nilainya lebih rendah dari nilai yang ditentukan
+ **Lebih besar atau sama** — Cocokkan jika nilainya lebih besar atau sama
+ **Lebih rendah atau sama** - Cocokkan jika nilainya lebih rendah atau sama
+ **Rentang** - Cocokkan rentang antara minimum dan maksimum yang ditentukan, termasuk min dan maks

Pertimbangkan kumpulan data berikut:


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
|  7/7/2020 11:34:23AM  |  32  |  101  | 
|  7/7/2020 11:34:22AM  |  28  |  125  | 
|  7/7/2020 11:34:21AM  |  26  |  110  | 
|  7/7/2020 11:34:20AM  |  23  |  98  | 
|  7/7/2020 10:32:24AM  |  31  |  95  | 
|  7/7/2020 10:31:22AM  |  20  |  85  | 
|  7/7/2020 9:30:57AM  |  19  |  101  | 

Jika Anda **Sertakan** titik data yang memiliki suhu di bawah 30° C, konfigurasi akan terlihat sebagai berikut:
+ **Jenis Filter** - `Include`
+ **Kondisi** — Baris yang `Temperature` cocok `Lower Than 30`

Dan Anda akan mendapatkan hasil berikut, di mana hanya suhu di bawah 30° C yang disertakan:


| Waktu | Temperatur | Ketinggian | 
| --- | --- | --- | 
|  7/7/2020 11:34:22AM  |  28  |  125  | 
|  7/7/2020 11:34:21AM  |  26  |  110  | 
|  7/7/2020 11:34:20AM  |  23  |  98  | 
|  7/7/2020 10:31:22AM  |  20  |  85  | 
|  7/7/2020 9:30:57AM  |  19  |  101  | 

Anda dapat menambahkan lebih dari satu kondisi ke filter. Misalnya, Anda mungkin ingin memasukkan data hanya jika ketinggiannya lebih besar dari 100. Untuk melakukannya, tambahkan kondisi itu ke konfigurasi berikut:
+ Jenis filter - `Include` baris yang `Match All` mengkondisikan
+ Kondisi 1 — Baris yang `Temperature` cocok `Lower` dengan `30`
+ Kondisi 2 — Baris yang `Altitude` cocok `Greater` dengan `100`

Bila Anda memiliki lebih dari satu kondisi, Anda dapat memilih apakah Anda ingin tindakan (sertakan/kecualikan) diterapkan pada baris yang **Cocokkan semua** kondisi atau **Cocokkan salah** satu kondisi yang Anda tambahkan.

Pada contoh di atas kami memilih **Match all** karena kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30 DAN ketinggian lebih tinggi dari 100. Jika kita ingin memasukkan baris yang memiliki suhu lebih rendah dari 30 ATAU ketinggian lebih tinggi dari 100 sebagai gantinya, maka kita akan memilih **Match any**. Ini akan mencakup baris pertama dalam data asli, yang memiliki suhu 32° C (tidak cocok dengan kondisi pertama) tetapi ketinggian 101 (yang cocok dengan kondisi kedua), sehingga disertakan.

Kondisi yang tidak valid atau tidak lengkap dikonfigurasi diabaikan.

**Grup oleh**

Transformasi ini mengelompokkan data dengan nilai bidang (kolom) tertentu dan memproses perhitungan pada setiap grup. Klik untuk melihat daftar pilihan perhitungan.

Berikut adalah contoh data asli.


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  server 1  |  80  |  Matikan  | 
|  7/7/2020 11:34:20AM  |  server 3  |  62  |  OK  | 
|  7/7/2020 10:32:20AM  |  server 2  |  90  |  Overload  | 
|  7/7/2020 10:31:22AM  |  server 3  |  55  |  OK  | 
|  7/7/2020 9:30:57AM  |  server 3  |  62  |  Rebooting  | 
|  7/7/2020 9:30:05AM  |  server 2  |  88  |  OK  | 
|  7/7/2020 9:28:06AM  |  server 1  |  80  |  OK  | 
|  7/7/2020 9:25:05AM  |  server 2  |  88  |  OK  | 
|  7/7/2020 9:23:07AM  |  server 1  |  86  |  OK  | 

Transformasi ini berjalan dalam dua langkah. Pertama, Anda menentukan satu atau beberapa bidang untuk mengelompokkan data berdasarkan. Ini akan mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya. Misalnya jika kita mengelompokkan berdasarkan bidang ID Server, maka itu akan mengelompokkan data dengan cara ini:


| Waktu | ID Server | Suhu CPU | Status Server | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  server 1  |  80  |  Matikan  | 
|  7/7/2020 9:28:06AM  |  server 1  |  80  |  OK  | 
|  7/7/2020 9:23:07AM  |  server 1  |  86  |  OK  | 
|  7/7/2020 10:32:20AM  |  server 2  |  90  |  Overload  | 
|  7/7/2020 9:30:05AM  |  server 2  |  88  |  OK  | 
|  7/7/2020 9:25:05AM  |  server 2  |  88  |  OK  | 
|  7/7/2020 11:34:20AM  |  server 3  |  62  |  OK  | 
|  7/7/2020 10:31:22AM  |  server 3  |  55  |  OK  | 
|  7/7/2020 9:30:57AM  |  server 3  |  62  |  Rebooting  | 

Semua baris dengan nilai ID Server yang sama dikelompokkan bersama.

Setelah memilih bidang mana Anda ingin mengelompokkan data Anda, Anda dapat menambahkan berbagai perhitungan pada bidang lain, dan menerapkan perhitungan untuk setiap kelompok baris. Misalnya, kita bisa menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Jadi kita dapat menambahkan perhitungan *rata-rata* yang diterapkan pada bidang Suhu CPU untuk mendapatkan yang berikut:


| ID Server | Suhu CPU (rata-rata) | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  88,6  | 
|  server 3  |  59,6  | 

Dan kita dapat menambahkan lebih dari satu perhitungan. Misalnya:
+ Untuk bidang Waktu, kita dapat menghitung nilai *Terakhir*, untuk mengetahui kapan titik data terakhir diterima untuk setiap server
+ Untuk bidang Status Server, kita dapat menghitung nilai *Terakhir* untuk mengetahui berapa nilai status terakhir untuk setiap server
+ Untuk bidang Temperatur, kita juga dapat menghitung nilai *Terakhir* untuk mengetahui berapa suhu yang dipantau terbaru untuk setiap server

Kami kemudian akan mendapatkan:


| ID Server | Suhu CPU (rata-rata) | Suhu CPU (terakhir) | Waktu (terakhir) | Status Server (terakhir) | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  7/7/2020 11:34:20AM  |  Matikan  | 
|  server 2  |  88,6  |  90  |  7/7/2020 10:32:20AM  |  Overload  | 
|  server 3  |  59,6  |  62  |  7/7/2020 11:34:20AM  |  OK  | 

Transformasi ini memungkinkan Anda untuk mengekstrak informasi penting dari deret waktu Anda dan menampilkannya dengan cara yang nyaman.

**Bergabung dengan bidang**

Gunakan transformasi ini untuk menggabungkan beberapa hasil menjadi satu tabel. Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang waktu bersama.

*Gabung batin*

Gabungan bagian dalam menggabungkan data dari beberapa tabel di mana semua tabel berbagi nilai yang sama dari bidang yang dipilih. Jenis gabungan ini mengecualikan data di mana nilai tidak cocok di setiap hasil.

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri (menggabungkan pada bidang gabungan yang diteruskan atau kolom pertama kali) menjadi satu hasil, dan jatuhkan baris di mana gabungan yang berhasil tidak dapat terjadi.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi gabungan batin.

Kueri A:


| Waktu | Pekerjaan | Waktu aktif | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  25260122  | 
|  7/7/2020 11:24:20AM  |  postgre  |  123001233  | 
|  7/7/2020 11:14:20AM  |  postgre  |  345001233  | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  server 1  |  15  | 
|  7/7/2020 11:24:20AM  |  server 2  |  5  | 
|  7/7/2020 11:04:20AM  |  server 3  |  10  | 

Hasil setelah menerapkan transformasi gabungan batin terlihat seperti berikut:


| Waktu | Pekerjaan | Waktu aktif | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  25260122  |  server 1  |  15  | 
|  7/7/2020 11:24:20AM  |  postgre  |  123001233  |  server 2  |  5  | 

*Bergabung di luar*

Gabungan luar mencakup semua data dari gabungan dalam dan baris di mana nilai tidak cocok di setiap input. Sementara gabungan bagian dalam bergabung dengan Kueri A dan Kueri B pada bidang waktu, gabungan luar mencakup semua baris yang tidak cocok di bidang waktu.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel sebelum menerapkan transformasi gabungan luar.

Kueri A:


| Waktu | Pekerjaan | Waktu aktif | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  25260122  | 
|  7/7/2020 11:24:20AM  |  postgre  |  123001233  | 
|  7/7/2020 11:14:20AM  |  postgre  |  345001233  | 

Kueri B:


| Waktu | Server | Kesalahan | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  server 1  |  15  | 
|  7/7/2020 11:24:20AM  |  server 2  |  5  | 
|  7/7/2020 11:04:20AM  |  server 3  |  10  | 

Hasil setelah menerapkan transformasi gabungan luar terlihat seperti berikut:


| Waktu | Pekerjaan | Waktu aktif | Server | Kesalahan | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 11:04:20AM  |    |    |  server 3  |  10  | 
|  7/7/2020 11:14:20AM  |  postgre  |  345001233  |    |    | 
|  7/7/2020 11:34:20AM  |  simpul  |  25260122  |  server 1  |  15  | 
|  7/7/2020 11:24:20AM  |  postgre  |  123001233  |  server 2  |  5  | 

**Label ke bidang**

Transformasi ini mengubah hasil deret waktu yang menyertakan label atau tag ke dalam tabel di mana setiap kunci label dan nilai disertakan dalam hasil tabel. Label dapat ditampilkan baik sebagai kolom atau sebagai nilai baris.

Diberikan hasil query dari dua deret waktu:
+ Seri 1 - label Server = Server A, DataCenter = EU
+ Seri 2 - label Server = Server B, DataCenter = EU

Dalam mode **Kolom**, hasilnya terlihat seperti ini:


| Waktu | Server | Pusat data | Nilai | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  Server A  |  EU  |  1  | 
|  7/7/2020 11:34:20AM  |  Peladen B  |  EU  |  2  | 

Dalam mode “Baris”, hasilnya memiliki tabel untuk setiap seri dan menunjukkan setiap nilai label seperti ini:


| label | nilai | 
| --- | --- | 
|  Server  |  Server A  | 
|  Pusat data  |  EU  | 


| label | nilai | 
| --- | --- | 
|  Server  |  Peladen B  | 
|  Pusat data  |  EU  | 

*Nama bidang nilai*

Jika Anda memilih Server sebagai **nama bidang Nilai**, maka Anda akan mendapatkan satu bidang untuk setiap nilai label Server.


| Waktu | Pusat data | Server A | Peladen B | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  EU  |  1  |  2  | 

*Perilaku penggabungan*

Label ke bidang transformator secara internal adalah dua transformasi terpisah. Tindakan pertama pada seri tunggal dan mengekstrak label ke bidang. Yang kedua adalah transformasi gabungan yang menggabungkan semua hasil menjadi satu tabel. Transformasi gabungan mencoba bergabung di semua bidang yang cocok. Langkah penggabungan ini diperlukan dan tidak dapat dimatikan. 

**catatan**  
Transformasi *gabungan* dapat digunakan sendiri, dan dijelaskan secara rinci di bawah ini.

Untuk mengilustrasikan hal ini, berikut adalah contoh di mana Anda memiliki dua kueri yang mengembalikan deret waktu tanpa label yang tumpang tindih.
+ Seri 1 - label server = Servera
+ Seri 2 - label DataCenter = EU

Ini pertama-tama akan menghasilkan dua tabel ini:


| Waktu | Server | Nilai | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  ServerA  |  10  | 


| Waktu | Pusat data | Nilai | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  EU  |  20  | 

Setelah bergabung:


| Waktu | Server | Nilai | Pusat data | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  ServerA  |  10  |    | 
|  7/7/2020 11:34:20AM  |    |  20  |  EU  | 

**Gabungkan**

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel. Nilai yang dapat digabungkan digabungkan ke dalam baris yang sama. Nilai dapat digabungkan jika bidang bersama berisi data yang sama.

Dalam contoh di bawah ini, kita memiliki dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

Kueri A:


| Waktu | Pekerjaan | Waktu aktif | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  25260122  | 
|  7/7/2020 11:24:20AM  |  postgre  |  123001233  | 

Kueri B:


| Waktu | Pekerjaan | Kesalahan | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  15  | 
|  7/7/2020 11:24:20AM  |  postgre  |  5  | 

Berikut adalah hasilnya setelah menerapkan transformasi Merge:


| Waktu | Pekerjaan | Kesalahan | Waktu aktif | 
| --- | --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  simpul  |  15  |  25260122  | 
|  7/7/2020 11:24:20AM  |  postgre  |  5  |  123001233  | 

**Mengatur bidang**

Gunakan transformasi ini untuk mengganti nama, menyusun ulang, atau menyembunyikan bidang yang dikembalikan oleh kueri.

**catatan**  
Transformasi ini hanya berfungsi di panel dengan satu kueri. Jika panel Anda memiliki beberapa kueri, maka Anda harus menerapkan transformasi gabungan Luar atau menghapus kueri tambahan.

Grafana menampilkan daftar bidang yang dikembalikan oleh kueri. Anda dapat:
+ Ubah urutan bidang dengan mengarahkan kursor ke bidang. Kursor berubah menjadi tangan dan kemudian Anda dapat menyeret bidang ke tempat barunya.
+ Sembunyikan atau tampilkan bidang dengan mengklik ikon mata di sebelah nama bidang.
+ Ganti nama bidang dengan mengetikkan nama baru di kotak Ganti nama.

**Partisi berdasarkan nilai**

Transformasi ini dapat membantu menghilangkan kebutuhan akan beberapa kueri ke sumber data yang sama dengan `WHERE` klausa yang berbeda saat membuat grafik beberapa seri. Pertimbangkan tabel SQL metrik dengan data berikut:


| Waktu | Region | Nilai | 
| --- | --- | --- | 
|  10/20/2022 12:00:00PM  |  AS  |  1520  | 
|  10/20/2022 12:00:00PM  |  EU  |  2936  | 
|  10/20/2022 1:00:00AM  |  AS  |  1327  | 
|  10/20/2022 1:00:00AM  |  EU  |  912  | 

Sebelum v9.3, jika Anda ingin merencanakan garis tren merah untuk AS dan yang biru untuk UE di TimeSeries panel yang sama, Anda mungkin harus membaginya menjadi dua kueri:

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

Ini juga mengharuskan Anda untuk mengetahui sebelumnya wilayah mana yang benar-benar ada dalam tabel metrik.

Dengan transformator *Partition by values*, Anda sekarang dapat mengeluarkan satu kueri dan membagi hasilnya dengan nilai unik dalam satu atau lebih kolom (`fields`) pilihan Anda. Contoh berikut menggunakan `Region`.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Waktu | Region | Nilai | 
| --- | --- | --- | 
|  10/20/2022 12:00:00PM  |  AS  |  1520  | 
|  10/20/2022 1:00:00AM  |  AS  |  1327  | 


| Waktu | Region | Nilai | 
| --- | --- | --- | 
|  10/20/2022 12:00:00PM  |  EU  |  2936  | 
|  10/20/2022 1:00:00AM  |  EU  |  912  | 

**Kurangi**

Transformasi *Reduce* menerapkan perhitungan untuk setiap bidang dalam frame dan mengembalikan nilai tunggal. Bidang waktu dihapus saat menerapkan transformasi ini.

Pertimbangkan masukannya:

Kueri A:


| Waktu | Temp | Waktu aktif | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  12.3  |  256122  | 
|  7/7/2020 11:24:20AM  |  15.4  |  1230233  | 

Kueri B:


| Waktu | AQI | Kesalahan | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  6.5  |  15  | 
|  7/7/2020 11:24:20AM  |  3.2  |  5  | 

Trafo reduksi memiliki dua mode:
+ **Seri ke baris** - Membuat baris untuk setiap bidang dan kolom untuk setiap perhitungan.
+ **Mengurangi bidang** - Menjaga struktur bingkai yang ada, tetapi menciutkan setiap bidang menjadi satu nilai.

Misalnya, jika Anda menggunakan perhitungan **Pertama** dan **Terakhir** dengan transformasi **Seri ke baris**, maka hasilnya adalah:


| Bidang | Pertama | Terakhir | 
| --- | --- | --- | 
|  Temp  |  12.3  |  15.4  | 
|  Waktu aktif  |  256122  |  1230233  | 
|  AQI  |  6.5  |  3.2  | 
|  Kesalahan  |  15  |  5  | 

Kolom Reduce dengan perhitungan Terakhir, menghasilkan dua frame, masing-masing dengan satu baris:

Kueri A:


| Temp | Waktu aktif | 
| --- | --- | 
|  15.4  |  1230233  | 

Kueri B:


| AQI | Kesalahan | 
| --- | --- | 
|  3.2  |  5  | 

**Ganti nama dengan regex**

Gunakan transformasi ini untuk mengganti nama bagian dari hasil kueri menggunakan ekspresi reguler dan pola penggantian.

Anda dapat menentukan ekspresi reguler, yang hanya diterapkan pada kecocokan, bersama dengan pola pengganti yang mendukung referensi kembali. Misalnya, bayangkan Anda memvisualisasikan penggunaan CPU per host dan Anda ingin menghapus nama domain. Anda dapat mengatur regex ke `([^\.]+)\..+` dan pola penggantian ke`$1`, `web-01.example.com` akan menjadi. `web-01`

**Baris ke bidang**

Transformasi baris ke bidang mengubah baris menjadi bidang terpisah. Ini dapat berguna karena bidang dapat ditata dan dikonfigurasi secara individual. Ini juga dapat menggunakan bidang tambahan sebagai sumber untuk konfigurasi bidang dinamis atau memetakannya ke label bidang. Label tambahan kemudian dapat digunakan untuk menentukan nama tampilan yang lebih baik untuk bidang yang dihasilkan.

Transformasi ini mencakup tabel bidang yang mencantumkan semua bidang dalam data yang dikembalikan oleh kueri konfigurasi. Tabel ini memberi Anda kontrol atas bidang apa yang harus dipetakan ke setiap properti konfigurasi (opsi \$1Gunakan sebagai\$1\$1). Anda juga dapat memilih nilai mana yang akan dipilih jika ada beberapa baris dalam data yang dikembalikan.

Transformasi ini membutuhkan:
+ Satu bidang untuk digunakan sebagai sumber nama bidang.

  Secara default, transformasi menggunakan bidang string pertama sebagai sumber. Anda dapat mengganti pengaturan default ini dengan memilih **Nama bidang** di kolom **Use as** untuk bidang yang ingin Anda gunakan sebagai gantinya.
+ Satu bidang untuk digunakan sebagai sumber nilai.

  Secara default, transformasi menggunakan bidang angka pertama sebagai sumber. Tetapi Anda dapat mengganti pengaturan default ini dengan memilih **Nilai bidang** di kolom **Gunakan sebagai** kolom untuk bidang yang ingin Anda gunakan sebagai gantinya.

Berguna saat memvisualisasikan data di:
+ Pengukur
+ Stat
+ Bagan pai

*Petakan bidang tambahan ke label*

Jika bidang tidak dipetakan ke properti konfigurasi Grafana akan secara otomatis menggunakannya sebagai sumber untuk label pada bidang keluaran-

Contoh:


| Nama | DataCenter | Nilai | 
| --- | --- | --- | 
|  ServerA  |  AS  |  100  | 
|  ServerB  |  EU  |  200  | 

Output:


| ServerA (label: DataCenter: AS) | ServerB (label: DataCenter: EU) | 
| --- | --- | 
|  10  |  20  | 

Label tambahan sekarang dapat digunakan dalam nama tampilan bidang memberikan nama bidang yang lebih lengkap.

Jika Anda ingin mengekstrak konfigurasi dari satu kueri dan menerapkannya ke kueri lain, Anda harus menggunakan konfigurasi dari transformasi hasil kueri.

*Contoh*

Masukan:


| Nama | Nilai | Maks | 
| --- | --- | --- | 
|  ServerA  |  10  |  100  | 
|  ServerB  |  20  |  200  | 
|  ServerC  |  30  |  300  | 

Output:


| ServerA (konfigurasi: maks = 100) | ServerB (konfigurasi: maks = 200) | ServerC (konfigurasi: maks = 300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

Seperti yang Anda lihat setiap baris dalam data sumber menjadi bidang terpisah. Setiap bidang sekarang juga memiliki set opsi konfigurasi maks. Opsi seperti Min, Max, Unit dan Thresholds adalah bagian dari konfigurasi bidang dan jika diatur seperti ini akan digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

**Siapkan deret waktu**

Mempersiapkan transformasi deret waktu berguna ketika sumber data mengembalikan data deret waktu dalam format yang tidak didukung oleh panel yang ingin Anda gunakan.

Transformasi ini membantu Anda mengatasi masalah ini dengan mengonversi data deret waktu dari format lebar ke format panjang atau sebaliknya.

Pilih opsi **deret waktu Multi-frame** untuk mengubah kerangka data deret waktu dari format lebar ke format panjang.

Pilih opsi **Wide time series** untuk mengubah kerangka data deret waktu dari format panjang ke format lebar.

**Seri ke baris**

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri data deret waktu menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel.

Hasil dari transformasi ini akan berisi tiga kolom: Waktu, Metrik, dan Nilai. Kolom Metrik ditambahkan sehingga Anda dapat dengan mudah melihat dari mana kueri metrik berasal. Sesuaikan nilai ini dengan mendefinisikan Label pada kueri sumber.

Pada contoh di bawah ini, kami memiliki dua pertanyaan yang mengembalikan data deret waktu. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

Kueri A:


| Waktu | Temperatur | 
| --- | --- | 
|  7/7/2020 11:34:20AM  |  25  | 
|  7/7/2020 10:31:22AM  |  22  | 
|  7/7/2020 9:30:05AM  |  19  | 

Kueri B:


| Waktu | Kelembaban | 
| --- | --- | 
|  7/7/2020 11:34:20AM  |  24  | 
|  7/7/2020 10:32:20AM  |  29  | 
|  7/7/2020 9:30:57AM  |  33  | 

Berikut adalah hasil setelah menerapkan Seri ke transformasi baris.


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  Temperatur  |  25  | 
|  7/7/2020 11:34:20AM  |  Kelembaban  |  22  | 
|  7/7/2020 10:32:20AM  |  Kelembaban  |  29  | 
|  7/7/2020 10:31:22AM  |  Temperatur  |  22  | 
|  7/7/2020 9:30:57AM  |  Kelembaban  |  33  | 
|  7/7/2020 9:30:05AM  |  Temperatur  |  19  | 

**Urutkan berdasarkan**

Transformasi ini akan mengurutkan setiap frame dengan bidang yang dikonfigurasi, Ketika `reverse` dicentang, nilai akan kembali dalam urutan yang berlawanan.

**Batasi**

Gunakan transformasi ini untuk membatasi jumlah baris yang ditampilkan.

Pada contoh di bawah ini, kami memiliki respons berikut dari sumber data:


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  Temperatur  |  25  | 
|  7/7/2020 11:34:20AM  |  Kelembaban  |  22  | 
|  7/7/2020 10:32:20AM  |  Kelembaban  |  29  | 
|  7/7/2020 10:31:22AM  |  Temperatur  |  22  | 
|  7/7/2020 9:30:57AM  |  Kelembaban  |  33  | 
|  7/7/2020 9:30:05AM  |  Temperatur  |  19  | 

Berikut adalah hasil setelah menambahkan transformasi Limit dengan nilai '3':


| Waktu | Metrik | Nilai | 
| --- | --- | --- | 
|  7/7/2020 11:34:20AM  |  Temperatur  |  25  | 
|  7/7/2020 11:34:20AM  |  Kelembaban  |  22  | 
|  7/7/2020 10:32:20AM  |  Kelembaban  |  29  | 

# Memecahkan masalah kueri
<a name="v9-panels-query-troubleshoot"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman ini memberikan informasi untuk memecahkan masalah dasbor umum.

**Saya mendapatkan hasil yang berbeda ketika saya mengatur ulang fungsi saya**

Urutan fungsi sangat penting. Sama seperti dalam matematika, urutan yang Anda tempatkan fungsi Anda dapat memengaruhi hasilnya.

**Periksa permintaan dan respons kueri Anda**

Masalah yang paling umum terkait dengan permintaan dan respons dari sumber data Anda. Bahkan jika itu terlihat seperti masalah bug atau visualisasi di Grafana, hampir selalu masalah dengan kueri sumber data atau respons sumber data. Mulailah dengan memeriksa permintaan dan respons panel Anda.

Untuk informasi selengkapnya, lihat [Periksa data permintaan dan respons](v9-panels-panel-inspector.md).

**Kueri saya lambat**

Berapa banyak titik data yang dikembalikan kueri Anda? Kueri yang mengembalikan banyak titik data akan lambat. Coba ini:
+ Dalam **opsi Query**, batasi **poin data Max** yang dikembalikan.
+ Dalam **opsi Query**, tingkatkan waktu **interval Min**.
+ Dalam kueri Anda, gunakan `group by` fungsi.

# Konfigurasikan ambang batas
<a name="v9-panels-configure-thresholds"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Bagian ini mencakup informasi tentang penggunaan ambang batas dalam visualisasi Anda. Anda akan belajar tentang ambang batas dan defaultnya, cara menambah atau menghapus ambang batas, dan menambahkan ambang batas ke panel lama. 

## Tentang ambang batas
<a name="v9-panels-thresholds-about"></a>

 Ambang batas adalah nilai yang Anda tentukan untuk metrik yang tercermin secara visual di dasbor saat nilai ambang terpenuhi atau terlampaui. 

 Ambang batas menyediakan satu metode bagi Anda untuk menata dan mewarnai visualisasi Anda secara kondisional berdasarkan hasil kueri. Anda dapat menerapkan ambang batas untuk sebagian besar, tetapi tidak semua, visualisasi. Untuk informasi lebih lanjut tentang visualisasi, lihat panel [Visualisasi](v9-panels.md).

 Anda dapat menggunakan ambang batas untuk: 
+  Garis kisi warna atau area kotak kotak dalam visualisasi [Time-series](v9-panels-time-series.md) 
+  Garis warna dalam visualisasi [deret waktu](v9-panels-time-series.md) 
+  Warnai latar belakang atau nilai teks dalam [visualisasi Stat](v9-panels-stat.md) 
+  [Warnai pengukur dan penanda ambang batas dalam visualisasi Gauge](v9-panels-gauge.md) 
+  Penanda warna dalam visualisasi [Geomap](v9-panels-geomap.md) 
+  Teks sel warna atau latar belakang dalam [visualisasi Tabel](v9-panels-table.md) 
+  Tentukan warna daerah dan wilayah dalam visualisasi [timeline Negara](v9-panels-state-timeline.md) 

 Ada dua jenis ambang batas: 
+  Ambang batas **absolut** ditentukan oleh angka. Misalnya, 80 pada skala 1 hingga 150. 
+  Ambang batas **persentase** didefinisikan relatif terhadap minimum atau maksimum. Misalnya, 80 persen. 

### Ambang batas default
<a name="v9-panels-thresholds-default"></a>

 Pada visualisasi yang mendukungnya, Grafana menetapkan nilai ambang batas default: 
+  80 = merah 
+  Basis = hijau 
+  Mode = Mutlak 

 Nilai **dasar** mewakili minus tak terhingga. Ini umumnya warna “baik”. 

## Menambah atau menghapus ambang
<a name="v9-panels-thresholds-add-delete"></a>

 Anda dapat menambahkan ambang batas sebanyak mungkin ke panel yang Anda inginkan. Grafana secara otomatis mengurutkan nilai ambang dari tertinggi ke terendah. 

 Hapus ambang ketika tidak lagi relevan dengan operasi bisnis Anda. Saat Anda menghapus ambang batas, sistem menghapus ambang batas dari semua visualisasi yang menyertakan ambang batas. 

1.  Untuk menambahkan ambang batas: 

   1.  Edit panel yang ingin Anda tambahkan ambang batas. 

   1.  Di panel sisi opsi, cari bagian Ambang batas dan klik **\$1** Tambahkan **ambang batas**. 

   1.  Pilih warna, angka, dan mode ambang batas. Mode ambang batas berlaku untuk semua ambang batas pada panel ini. 

   1.  Untuk panel deret waktu, pilih opsi **Tampilkan ambang batas**. 

1.  Untuk menghapus ambang batas, arahkan ke panel yang berisi ambang batas dan klik ikon sampah di sebelah ambang batas yang ingin Anda hapus. 

## Tambahkan ambang batas ke panel grafik lama
<a name="v9-panels-thresholds-legacy-graph"></a>

 Dalam visualisasi panel Grafik, ambang memungkinkan Anda menambahkan garis atau bagian ke grafik agar lebih mudah dikenali saat grafik melewati ambang batas. 

1.  Arahkan ke panel grafik yang ingin Anda tambahkan ambang batas. 

1.  Pada tab **Panel**, klik **Ambang batas**. 

1.  Klik **Tambahkan ambang batas**. 

1.  Lengkapi bidang-bidang berikut: 
   +  **T1 -** Kedua nilai diperlukan untuk menampilkan ambang batas. 
     +  **lt** atau **gt** - **Pilih** lt untuk kurang dari atau **gt** untuk lebih besar dari untuk menunjukkan ambang batas yang berlaku. 
     +  **Nilai -** Masukkan nilai ambang batas. Grafana menggambar garis ambang sepanjang sumbu Y pada nilai itu. 
   +  **Warna -** Pilih kondisi yang sesuai dengan warna, atau tentukan warna Anda sendiri. 
     +  **kustom -** Anda menentukan warna isian dan warna garis. 
     +  **kritis -** Isi dan warna garis merah. 
     +  **peringatan -** Isi dan warna garis berwarna kuning. 
     +  **ok -** Isi dan warna garis berwarna hijau. 
   +  **Isi -** Mengontrol apakah pengisian ambang ditampilkan. 
   +  **Baris -** Mengontrol apakah garis ambang ditampilkan. 
   +  **Y-Axis -** Pilih **kiri** atau **kanan**. 

1.  Klik **Simpan** untuk menyimpan perubahan di dasbor. 

# Konfigurasikan tautan data
<a name="v9-panels-configure-data-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Anda dapat menggunakan variabel tautan data atau tautan data untuk membuat tautan antar panel. 

## Variabel tautan data
<a name="v9-panels-data-link-variables"></a>

 Anda dapat menggunakan variabel dalam tautan data untuk merujuk ke bidang seri, label, dan nilai. Untuk informasi selengkapnya tentang tautan data, lihat[Tautan data](#v9-panels-data-links).

 Untuk melihat daftar variabel yang tersedia, ketik **\$1** di bidang **URL** tautan data untuk melihat daftar variabel yang dapat Anda gunakan. 

**catatan**  
 Variabel ini berubah di 6.4, jadi jika Anda memiliki versi Grafana yang lebih lama, gunakan pemilih versi untuk memilih dokumen untuk versi Grafana yang lebih lama. 

 Anda juga dapat menggunakan variabel template di tautan data Anda URLs, lihat[Menambahkan dan mengelola variabel dasbor](v9-dash-variables.md).

## Variabel panel rentang waktu
<a name="v9-panels-time-range-panel-variables"></a>

 Variabel ini memungkinkan Anda untuk memasukkan rentang waktu saat ini dalam URL tautan data. 
+  **\$1\$1url\$1time\$1range - rentang** **waktu dasbor saat ini (mis.? dari=sekarang-6h&to=sekarang**) 
+  **\$1\$1\$1from dan \$1\$1\$1to - Untuk informasi** lebih lanjut, lihat. [Variabel global](v9-dash-variable-add.md#v9-dash-variable-add-global)

## Variabel seri
<a name="v9-panels-series-variables"></a>

 Variabel spesifik seri tersedia di bawah **namespace \$1\$1series**: 
+  **\$1\$1series.name - nama** seri ke URL 

## Variabel bidang
<a name="v9-panels-field-variables"></a>

 **Variabel khusus bidang tersedia di bawah \$1\$1field namespace:** 
+  **\$1\$1field.name - nama** bidang 
+  **\$1\$1field.labels. **<LABEL>- nilai label ke URL. <LABEL>Jika label Anda berisi titik, gunakan sintaks **\$1\$1field.labels [” “].** 

## Variabel nilai
<a name="v9-panels-value-variables"></a>

 Variabel spesifik nilai tersedia di bawah **\$1\$1value** namespace: 
+  **\$1\$1value.time** **- stempel waktu nilai (Unix ms epoch) ke URL (yaitu? waktu=1560268814105)** 
+  **\$1\$1value.raw - nilai mentah** 
+  **\$1\$1value.numeric - representasi numerik** dari suatu nilai 
+  **\$1\$1value.text** - representasi teks dari nilai 
+  **\$1\$1value.calc** - nama perhitungan jika nilainya adalah hasil perhitungan 

## Variabel template
<a name="v9-panels-template-variables"></a>

 Saat menautkan ke dasbor lain yang menggunakan variabel template, pilih nilai variabel untuk siapa pun yang mengklik tautan. 

 **\$1 \$1var-myvar:queryparam\$1** - di mana **var-myvar** adalah nama variabel template yang cocok dengan satu di dasbor saat ini yang ingin Anda gunakan. 


|  Status variabel  |  Hasil di URL yang dibuat  | 
| --- | --- | 
|  memilih satu nilai  |  var-myvar=nilai1  | 
|  memilih beberapa nilai  |  var-myvar=value1&var-myvar=nilai2  | 
|  dipilih Semua  |  var-myvar=Semua  | 

 Jika Anda ingin menambahkan semua variabel dasbor saat ini ke URL, maka gunakan **\$1 \$1\$1\$1all\$1variable**\$1. 

## Tautan data
<a name="v9-panels-data-links"></a>

 Tautan data memungkinkan Anda memberikan konteks yang lebih terperinci ke tautan Anda. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilai di bawah kursor. Misalnya, jika visualisasi Anda menunjukkan empat server, Anda dapat menambahkan tautan data ke satu atau dua server. 

 Tautan itu sendiri dapat diakses dengan berbagai cara tergantung pada visualisasi. Untuk Grafik Anda perlu mengklik titik atau garis data, untuk panel seperti Stat, Gauge, atau Bar Gauge Anda dapat mengklik di mana saja pada visualisasi untuk membuka menu konteks. 

 Anda dapat menggunakan variabel dalam tautan data untuk mengirim orang ke dasbor terperinci dengan filter data yang diawetkan. Misalnya, Anda dapat menggunakan variabel untuk menentukan rentang waktu, seri, dan pemilihan variabel. Untuk informasi selengkapnya, lihat [Variabel tautan data](#v9-panels-data-link-variables).

### Saran Typeahead
<a name="v9-panels-typeahead-suggestions"></a>

 Saat membuat atau memperbarui tautan data, tekan Cmd\$1Spasi atau Ctrl\$1Spasi pada keyboard Anda untuk membuka saran typeahead agar lebih mudah menambahkan variabel ke URL Anda. 

### Tambahkan tautan data
<a name="v9-panels-add-a-datalink"></a>

1.  **Arahkan kursor ke panel yang ingin Anda tambahkan tautannya lalu tekan e.** **Atau klik panah tarik-turun di sebelah judul panel dan kemudian klik Edit.** 

1.  Pada tab Bidang, gulir ke bawah ke bagian Tautan data. 

1.  Perluas tautan Data dan kemudian klik **Tambahkan tautan**. 

1.  Masukkan **Judul**. **Judul** adalah label yang dapat dibaca manusia untuk tautan yang akan ditampilkan di UI. 

1.  Masukkan **URL** yang ingin Anda tautkan. 

    Anda bahkan dapat menambahkan salah satu variabel template yang ditentukan di dasbor. Klik di bidang **URL** lalu ketik **\$1** atau tekan Ctrl\$1Spasi atau Cmd\$1Spasi untuk melihat daftar variabel yang tersedia. Dengan menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan. Untuk informasi selengkapnya, lihat [Variabel tautan data](#v9-panels-data-link-variables).

1.  Jika Anda ingin tautan terbuka di tab baru, pilih **Buka di tab baru**. 

1.  Klik **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Klik **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

### Perbarui tautan data
<a name="v9-panels-update-a-datalink"></a>

1.  Pada tab Bidang, temukan tautan yang ingin Anda ubah. 

1.  Klik ikon Edit (pensil) untuk membuka jendela Edit link. 

1.  Buat perubahan yang diperlukan. 

1.  Klik **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Klik **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

### Hapus tautan data
<a name="v9-panels-delete-a-datalink"></a>

1.  Pada tab Bidang, temukan tautan yang ingin Anda hapus. 

1.  Klik ikon **X** di sebelah tautan yang ingin Anda hapus. 

1.  Klik **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

# Konfigurasikan penggantian bidang
<a name="v9-panels-configure-overrides"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Override memungkinkan Anda untuk menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. Ini dilakukan dengan menambahkan aturan penggantian yang menargetkan sekumpulan bidang tertentu dan yang masing-masing dapat menentukan beberapa opsi. 

 Misalnya, Anda menyetel unit untuk semua bidang yang menyertakan teks “byte” dengan menambahkan penggantian menggunakan **Bidang dengan pencocokan regex pencocokan nama** dan kemudian menambahkan opsi Unit ke aturan penggantian. 

## Contoh 1: Format suhu
<a name="v9-panels-overrides-format-temperature"></a>

 Mari kita asumsikan bahwa kumpulan hasil kita adalah kerangka data yang terdiri dari dua bidang: waktu dan suhu. 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0  | 
|  2020-01-02 03:05:00  |  47.0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 Setiap bidang (kolom) dari struktur ini dapat memiliki opsi bidang yang diterapkan yang mengubah cara nilainya ditampilkan. Ini berarti Anda dapat, misalnya, mengatur Satuan ke Temperature > Celcius, menghasilkan tabel berikut: 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0 °C  | 
|  2020-01-02 03:05:00  |  47.0° C  | 
|  2020-01-02 03:06:00  |  48.0 °C  | 

 Selain itu, tempat desimal tidak diperlukan, sehingga kami dapat menghapusnya. Anda dapat mengubah Desimal dari **auto** ke nol (**0**), menghasilkan tabel berikut: 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45° C  | 
|  2020-01-02 03:05:00  |  47° C  | 
|  2020-01-02 03:06:00  |  48° C  | 

## Contoh 2: Format suhu dan kelembaban
<a name="v9-panels-overrides-format-humidity"></a>

 Mari kita asumsikan bahwa kumpulan hasil kita adalah kerangka data yang terdiri dari empat bidang: waktu, suhu tinggi, suhu rendah, dan kelembaban. 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45,0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47.0  |  34.0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31.0  |  68  | 

 Mari tambahkan unit Celcius dan singkirkan tempat desimal. Ini menghasilkan tabel berikut: 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45° C  |  30° C  |  67° C  | 
|  2020-01-02 03:05:00  |  47° C  |  34° C  |  68° C  | 
|  2020-01-02 03:06:00  |  48° C  |  31° C  |  68° C  | 

 Bidang suhu terlihat bagus, tetapi kelembabannya sekarang harus diubah. Kita dapat memperbaikinya dengan menerapkan opsi field override ke bidang kelembaban dan mengubah unit menjadi Misc > percent (0-100). 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45° C  |  30° C  |  67%  | 
|  2020-01-02 03:05:00  |  47° C  |  34° C  |  68%  | 
|  2020-01-02 03:06:00  |  48° C  |  31° C  |  68%  | 

## Tambahkan penggantian bidang
<a name="v9-panels-overrides-add-a-field"></a>

 Aturan penggantian bidang dapat menyesuaikan pengaturan visualisasi untuk bidang atau seri tertentu. 

1.  Edit panel yang ingin Anda tambahkan override. 

1.  Di panel samping opsi panel, klik **Tambahkan penggantian bidang** di bagian bawah panel. 

1.  Pilih bidang mana aturan penggantian akan diterapkan ke: 
   +  **Bidang dengan nama:** Pilih bidang dari daftar semua bidang yang tersedia. Properti yang Anda tambahkan ke aturan dengan pemilih ini hanya diterapkan ke bidang tunggal ini. 
   +  **Bidang dengan nama yang cocok dengan regex:** Tentukan bidang yang akan diganti dengan ekspresi reguler. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang di mana nama bidang cocok dengan regex. 
   +  **Bidang dengan tipe:** Pilih bidang berdasarkan jenis, seperti string, numerik, dan sebagainya. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang cocok dengan jenis yang dipilih. 
   +  **Bidang yang dikembalikan oleh kueri:** Pilih semua bidang yang dikembalikan oleh kueri tertentu, seperti A, B, atau C. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang dikembalikan oleh kueri yang dipilih. 

1.  Klik **Tambahkan properti ganti**. 

1.  Pilih opsi bidang yang ingin Anda terapkan. 

1.  Masukkan opsi dengan menambahkan nilai di bidang. Untuk mengembalikan opsi ke nilai default, hapus teks putih di bidang. 

1.  Lanjutkan untuk menambahkan penggantian ke bidang ini dengan mengklik **Tambahkan properti penggantian**, atau Anda dapat mengklik **Tambahkan penggantian** dan memilih bidang lain untuk menambahkan penggantian. 

1.  Setelah selesai, klik **Simpan** untuk menyimpan semua pengeditan panel ke dasbor. 

## Hapus penggantian bidang
<a name="v9-panels-overrides-delete-a-field"></a>

 Hapus penggantian bidang saat Anda tidak lagi membutuhkannya. Saat Anda menghapus override, tampilan nilai default ke format aslinya. Perubahan ini berdampak pada dasbor dan pengguna dasbor yang mengandalkan panel yang terpengaruh. 

1.  Edit panel yang berisi penggantian yang ingin Anda hapus. 

1.  Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian. 

1.  Klik override yang ingin Anda hapus dan kemudian klik ikon sampah terkait. 

## Lihat penggantian bidang
<a name="v9-panels-overrides-view"></a>

 Anda dapat melihat penggantian bidang di opsi tampilan panel. 

1.  Edit panel yang berisi penggantian yang ingin Anda lihat. 

1.  Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian. 

 Pengaturan override yang muncul di tab **Semua** sama dengan pengaturan yang muncul di tab **Overrides**. 

## Mengedit penggantian bidang
<a name="v9-panels-overrides-edit-a-field"></a>

 Edit penggantian bidang saat Anda ingin membuat perubahan pada setelan penggantian. Perubahan yang Anda buat segera berlaku. 

1.  Edit panel yang berisi penggantian yang ingin Anda edit. 

1.  Di panel samping opsi panel, gulir ke bawah hingga Anda melihat penggantian. 

1.  Temukan penggantian yang ingin Anda ubah. 

1.  Lakukan salah satu dari yang berikut: 
   +  Edit pengaturan pada penggantian yang ada atau parameter pemilihan bidang. 
   +  Hapus properti override yang ada dengan mengklik **X** di sebelah properti. 
   +  Tambahkan properti override dengan mengklik **Tambahkan properti override**. 

# Konfigurasikan pemetaan nilai
<a name="v9-panels-configure-value-mappings"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Selain penggantian bidang, pemetaan nilai adalah teknik yang dapat Anda gunakan untuk mengubah perlakuan visual data yang muncul dalam visualisasi. 

 Nilai yang dipetakan melalui pemetaan nilai melewati pemformatan unit. Ini berarti bahwa nilai teks yang dipetakan ke nilai numerik tidak diformat menggunakan unit yang dikonfigurasi. 

 Jika pemetaan nilai ada di panel, maka Grafana menampilkan ringkasan di panel samping editor panel. 

**catatan**  
 Pemetaan nilai baru tidak kompatibel dengan beberapa visualisasi, seperti Grafik (lama), Teks, dan Peta Heatmap. 

## Jenis pemetaan nilai
<a name="v9-panels-value-mappings-types"></a>

 Grafana mendukung pemetaan nilai berikut: 
+  **Nilai:** Memetakan nilai teks ke warna atau teks tampilan yang berbeda. **Misalnya, Anda dapat mengonfigurasi pemetaan nilai sehingga semua instance dari nilai **10** muncul sebagai Kesempurnaan\$1** ketimbang angka. 
+  **Rentang:** Memetakan rentang numerik ke teks tampilan dan warna. Misalnya, jika nilai berada dalam rentang tertentu, Anda dapat mengonfigurasi pemetaan nilai rentang untuk menampilkan **Rendah** atau **Tinggi** daripada angka. 
+  **Regex:** Memetakan ekspresi reguler ke teks pengganti dan warna. **Misalnya, jika nilainya adalah **www.example.com**, Anda dapat mengonfigurasi pemetaan nilai regex sehingga Grafana menampilkan www dan memotong domain.** 
+  Nilai **khusus** Peta Khusus seperti **Null**, **NaN** (bukan angka), dan nilai boolean seperti **true** dan **false** ke teks tampilan dan warna. **Misalnya, Anda dapat mengonfigurasi pemetaan nilai khusus sehingga nilai **null muncul sebagai N/A**.** 

 Anda juga dapat menggunakan titik-titik di sebelah kiri untuk menyeret dan menyusun ulang pemetaan nilai dalam daftar. 

## Memetakan nilai
<a name="v9-panels-value-mappings-map-a-value"></a>

 Petakan nilai saat Anda ingin memformat satu nilai. 

1.  Buka panel yang ingin Anda petakan nilainya. 

1.  Dalam opsi tampilan panel, cari bagian **Pemetaan nilai** dan klik **Tambahkan pemetaan nilai**. 

1.  Klik **Tambahkan pemetaan baru** dan kemudian pilih **Nilai**. 

1.  Masukkan nilai untuk Grafana untuk mencocokkan. 

1.  (Opsional) Masukkan teks tampilan. 

1.  (Opsional) Atur warnanya. 

1.  Klik **Perbarui** untuk menyimpan pemetaan nilai. 

## Memetakan rentang
<a name="v9-panels-value-mappings-map-a-range"></a>

 Petakan berbagai nilai saat Anda ingin memformat beberapa nilai kontinu. 

1.  Edit panel yang ingin Anda petakan berbagai nilai. 

1.  Dalam opsi tampilan panel, di bagian **Pemetaan nilai**, klik **Tambahkan pemetaan nilai**. 

1.  Klik **Tambahkan pemetaan baru** dan kemudian pilih **Rentang**. 

1.  Masukkan nilai awal dan akhir dalam rentang agar Grafana cocok. 

1.  (Opsional) Masukkan teks tampilan. 

1.  (Opsional) Atur warnanya. 

1.  Klik **Perbarui** untuk menyimpan pemetaan nilai. 

## Memetakan ekspresi reguler
<a name="v9-panels-value-mappings-map-a-regex"></a>

 Petakan ekspresi reguler saat Anda ingin memformat teks dan warna nilai ekspresi reguler. 

1.  Edit panel yang ingin Anda petakan ekspresi reguler. 

1.  Di bagian **Pemetaan nilai** pada opsi tampilan panel, klik **Tambahkan pemetaan nilai**. 

1.  Klik **Tambahkan pemetaan baru** dan kemudian pilih **Regex**. 

1.  Masukkan pola ekspresi reguler agar Grafana cocok. 

1.  (Opsional) Masukkan teks tampilan. 

1.  (Opsional) Atur warnanya. 

1.  Klik **Perbarui** untuk menyimpan pemetaan nilai. 

## Petakan nilai khusus
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 Petakan nilai khusus saat Anda ingin memformat nilai yang tidak biasa, boolean, atau kosong. 

1.  Edit panel yang ingin Anda petakan nilai khusus. 

1.  Dalam opsi tampilan panel, cari bagian **Pemetaan nilai** dan klik **Tambahkan pemetaan nilai**. 

1.  Klik **Tambahkan pemetaan baru** dan kemudian pilih **Khusus**. 

1.  Pilih nilai khusus untuk Grafana untuk dicocokkan. 

1.  (Opsional) Masukkan teks tampilan. 

1.  (Opsional) Atur warnanya. 

1.  Klik **Perbarui** untuk menyimpan pemetaan nilai. 

## Mengedit pemetaan nilai
<a name="v9-panels-value-mappings-edit-a-value"></a>

 Anda dapat mengubah pemetaan nilai kapan saja. 

1.  Edit panel yang berisi pemetaan nilai yang ingin Anda edit. 

1.  Di opsi tampilan panel, di bagian **Pemetaan nilai, klik Edit pemetaan** **nilai**. 

1.  Buat perubahan dan klik **Perbarui**. 

# Konfigurasikan legenda
<a name="v9-panels-configure-legend"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel menyertakan legenda yang dapat Anda gunakan untuk menafsirkan data yang ditampilkan dalam visualisasi. Setiap opsi legenda menambahkan konteks dan kejelasan pada data yang diilustrasikan dalam visualisasi.

## Mengisolasi data seri dalam visualisasi
<a name="v9-panels-legend-isolate"></a>

Visualisasi seringkali dapat menjadi kompleks secara visual, dan mencakup banyak seri data. Anda dapat menyederhanakan tampilan dengan menghapus data seri dari visualisasi, yang mengisolasi data yang ingin Anda lihat. **Grafana secara otomatis membuat penggantian baru di tab Override.**

Ketika Anda menerapkan perubahan Anda, perubahan visualisasi muncul untuk semua pengguna panel.

**Untuk mengisolasi data seri dalam visualisasi**

1. Buka panel.

1. Dalam legenda, pilih label seri yang ingin Anda isolasi.

   Sistem menghapus dari tampilan semua data seri lainnya.

1. Untuk menambahkan data seri secara bertahap ke seri terisolasi, tekan tombol **Ctrl** atau **Command** dan pilih label seri yang ingin Anda tambahkan.

1. Untuk kembali ke tampilan default yang menyertakan semua data, klik label seri dua kali.

1. Untuk menyimpan perubahan Anda sehingga muncul ke semua pemirsa panel, pilih **Terapkan**.

Topik ini saat ini berlaku untuk visualisasi berikut:
+ [Bagan batang](v9-panels-bar-chart.md)
+ [Histogram](v9-panels-histogram.md)
+ [Bagan pai](v9-panels-piechart.md)
+ [Garis waktu negara](v9-panels-state-timeline.md)
+ [Riwayat status](v9-panels-status-history.md)
+ [Deret waktu](v9-panels-time-series.md)

## Menambahkan nilai ke legenda
<a name="v9-panels-legend-add-values"></a>

Sebagai cara untuk menambahkan lebih banyak konteks ke visualisasi, Anda dapat menambahkan nilai data seri ke legenda. Anda dapat menambahkan nilai sebanyak yang Anda inginkan; setelah menerapkan perubahan, Anda dapat menggulir legenda secara horizontal untuk melihat semua nilai.

**Untuk menambahkan nilai ke legenda**

1. Edit panel.

1. Di panel opsi tampilan panel, cari bagian **Legenda**.

1. Di bidang **Nilai legenda**, pilih nilai yang ingin Anda tampilkan di legenda.

1. Pilih **Terapkan** untuk menyimpan perubahan Anda, navigasikan kembali ke dasbor.

## Mengubah warna seri
<a name="v9-panels-legend-change-color"></a>

Secara default, Grafana menentukan warna data seri Anda, yang dapat Anda ubah.

**Untuk mengubah warna seri**

1. Edit panel.

1. Dalam legenda, pilih bilah warna yang terkait dengan seri.

1. Pilih warna yang telah ditetapkan sebelumnya atau warna khusus dari palet warna.

1. Pilih **Terapkan** untuk menyimpan perubahan Anda, navigasikan kembali ke dasbor.

## Sortir seri
<a name="v9-panels-legend-sort"></a>

Anda dapat mengubah mode legenda ke **Tabel** dan memilih [Jenis perhitungan](v9-panels-calculation-types.md) untuk ditampilkan dalam legenda. Pilih header nama perhitungan di tabel legenda untuk mengurutkan nilai dalam tabel dalam urutan naik atau turun.

Urutan pengurutan mempengaruhi posisi batang di panel bagan Batang serta urutan deret bertumpuk di panel Time series dan Bar chart.

**catatan**  
Fitur ini hanya didukung di panel ini: Bar chart, Histogram, Time series, XY Chart.

# Jenis perhitungan
<a name="v9-panels-calculation-types"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Tabel berikut berisi daftar perhitungan yang dapat Anda lakukan di Grafana. Anda dapat menemukan perhitungan ini di tab **Transform** dan di bar gauge, gauge, dan visualisasi stat. 


|  Penghitungan  |  Deskripsi  | 
| --- | --- | 
|  Semua nol  |  Benar ketika semua nilai nol  | 
|  Semua nol  |  Benar ketika semua nilai 0  | 
|  Ubah hitungan  |  Berapa kali nilai bidang berubah  | 
|  Hitungan  |  Jumlah nilai dalam bidang  | 
|  kuala  |  Perubahan nilai kumulatif, hanya menghitung kenaikan  | 
|  Perbedaan  |  Perbedaan antara nilai pertama dan terakhir dari suatu bidang  | 
|  Persentase perbedaan  |  Persentase perubahan antara nilai pertama dan terakhir bidang  | 
|  Hitungan yang berbeda  |  Jumlah nilai unik dalam bidang  | 
|  Pertama (bukan null)  |  Pertama, bukan nilai null di bidang  | 
|  Maks  |  Nilai maksimum bidang  | 
|  Berarti  |  Nilai rata-rata dari semua nilai dalam bidang  | 
|  Varians  |  Varians dari semua nilai dalam bidang  | 
|  StdDev  |  Standar deviasi dari semua nilai dalam bidang  | 
|  Min  |  Nilai minimum bidang  | 
|  Min (di atas nol)  |  Minimum, nilai positif dari suatu bidang  | 
|  Kisaran  |  Perbedaan antara nilai maksimum dan minimum bidang  | 
|  Langkah  |  Interval minimal antara nilai bidang  | 
|  Total  |  Jumlah semua nilai dalam bidang  | 

# Visualisasi anotasi
<a name="v9-panels-annotate-visualizations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anotasi menyediakan cara untuk menandai titik pada grafik dengan peristiwa kaya. Saat Anda mengarahkan kursor ke anotasi, Anda bisa mendapatkan deskripsi acara dan tag acara. Bidang teks dapat menyertakan tautan ke sistem lain dengan lebih detail.

**Anotasi asli**

Grafana hadir dengan penyimpanan anotasi asli dan kemampuan untuk menambahkan peristiwa anotasi langsung dari panel grafik atau melalui HTTP API.

**Menambahkan anotasi**

1. Di dasbor, klik pada panel **Time series**. Menu konteks akan muncul.

1. Di menu konteks, klik **Tambahkan anotasi**.

1. Tambahkan deskripsi anotasi, dan secara opsional, tag.

1. Klik **Simpan**.

Atau, untuk menambahkan anotasi, `Ctrl+Click` atau `Cmd+Click` pada panel **deret Waktu** dan popover **Tambahkan anotasi akan** muncul.

**Menambahkan anotasi wilayah**

1. Di dasbor, `Ctrl+Click` atau `Cmd+Click` di panel **Time series**.

1. Di menu konteks, klik **Tambahkan anotasi**.

1. Tambahkan deskripsi anotasi, dan secara opsional, tag.

1. Klik **Simpan**.

**Mengedit anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel **Time series**.

1. Klik ikon edit (pensil) di tooltip anotasi.

1. Ubah deskripsi, dan secara opsional, tag.

1. Klik **Simpan**.

**Menghapus anotasi**

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel **Time series**.

1. Klik ikon sampah di tooltip anotasi.

**Kueri bawaan**

Setelah Anda menambahkan anotasi, mereka akan tetap terlihat. Ini karena kueri anotasi bawaan yang ada di semua dasbor. Kueri anotasi ini akan mengambil semua peristiwa anotasi yang berasal dari dasbor saat ini dan menampilkannya di panel tempat mereka dibuat. Ini termasuk anotasi riwayat status peringatan. Anda dapat menghentikan anotasi agar tidak diambil dan digambar dengan membuka pengaturan **Anotasi** (melalui menu roda Dashboard) dan memodifikasi kueri bernama. `Annotations & Alerts (Built-in)`

Saat Anda menyalin dasbor menggunakan fitur **Save** As, itu akan mendapatkan id dasbor baru sehingga anotasi yang dibuat di dasbor sumber tidak lagi terlihat pada salinan. Anda masih dapat menunjukkannya jika Anda menambahkan **Kueri Anotasi** baru dan memfilter berdasarkan tag. Ini hanya berfungsi jika anotasi di dasbor sumber memiliki tag untuk difilter.

**Menanyakan dengan tag**

**Anda dapat membuat kueri baru untuk mengambil anotasi dari penyimpanan anotasi asli melalui sumber `-- Grafana --` data dengan menyetel Filter menurut ke.** `Tags`

Grafana v8.1 dan versi yang lebih baru juga mendukung typeahead dari tag yang ada, menyediakan setidaknya satu tag.

Misalnya, buat nama kueri anotasi `outages` dan tentukan tag`outage`. Kueri ini akan menampilkan semua anotasi (dari dasbor apa pun atau melalui API) dengan tag pemadaman. Jika beberapa tag didefinisikan dalam kueri anotasi, maka Grafana hanya akan menampilkan anotasi yang cocok dengan semua tag. Untuk mengubah perilaku, aktifkan`Match any`, dan Grafana akan menampilkan anotasi yang berisi salah satu tag yang Anda berikan.

Di Grafana v5.3\$1 dimungkinkan untuk menggunakan variabel template dalam kueri tag. Jadi, jika Anda memiliki dasbor yang menampilkan statistik untuk layanan yang berbeda dan variabel template yang menentukan layanan mana yang akan ditampilkan, Anda sekarang dapat menggunakan variabel template yang sama dalam kueri anotasi Anda untuk hanya menampilkan anotasi untuk layanan tersebut.

**Menanyakan sumber data lainnya**

Peristiwa anotasi diambil melalui kueri anotasi. Untuk menambahkan kueri anotasi baru ke dasbor, buka menu pengaturan dasbor, lalu pilih **Anotasi**. Ini akan membuka tampilan pengaturan anotasi dasbor. Untuk membuat kueri anotasi baru, tekan tombol **Baru**.

Tentukan nama untuk kueri anotasi. Nama ini diberikan ke sakelar (kotak centang) yang memungkinkan Anda mengaktifkan atau menonaktifkan menampilkan peristiwa anotasi dari kueri ini. Misalnya Anda mungkin memiliki dua kueri anotasi bernama `Deploys` dan. `Outages` Toggle akan memungkinkan Anda untuk memutuskan anotasi apa yang akan ditampilkan.

**Detail kueri anotasi**

Opsi kueri anotasi berbeda untuk setiap sumber data. Untuk informasi tentang anotasi dalam sumber data tertentu, lihat topik [sumber data](AMG-data-sources.md) tertentu.

# Panel memeriksa tampilan
<a name="v9-panels-panel-inspector"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Tampilan inspeksi panel, yang dapat Anda buka melalui menu panel, membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat memeriksa data mentah untuk panel Grafana apa pun, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, dan mengekspor panel dan data JSON. 

**catatan**  
 Tidak semua jenis panel menyertakan semua tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri. 

 Inspektur panel terdiri dari opsi-opsi berikut: 

1.  Inspektur panel menampilkan **Inspect: [NameOfPanelBeingInspected]** di bagian atas panel. Klik panah di sudut kanan atas untuk memperluas atau mengurangi panel. 

1.  **Tab data -** Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang seperti penggantian dan pemetaan nilai tidak diterapkan secara default. 

1.  **Tab Statistik -** Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan. 

1.  **Tab JSON -** Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana. 

1.  **Tab kueri -** Menunjukkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data. 

1.  **Tab kesalahan -** Menampilkan kesalahan. Hanya terlihat ketika kueri mengembalikan kesalahan. 

## Unduh hasil kueri mentah
<a name="v9-panels-raw-query-results"></a>

 Grafana menghasilkan file CSV yang berisi data Anda, termasuk transformasi apa pun ke data tersebut. Anda dapat memilih untuk melihat data sebelum atau setelah panel menerapkan opsi bidang atau penggantian opsi bidang. 

1.  Edit panel yang berisi data kueri yang ingin Anda unduh. 

1.  Di editor kueri, klik **Query Inspector**. 

1.  Klik **Data**. 

    Jika panel Anda berisi beberapa kueri atau kueri beberapa node, maka Anda memiliki opsi tambahan. 
   +  **Pilih hasil**: Pilih data set hasil yang ingin Anda lihat. 
   +  **Mengubah data** 
   +  **Bergabung berdasarkan waktu**: Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Klik judul kolom untuk menyusun ulang data. 

1.  Untuk melihat data sebelum sistem menerapkan penggantian bidang, klik toggle Data yang **diformat.** 

1.  Untuk mengunduh file CSV yang diformat khusus untuk Excel, klik tombol **Unduh untuk Excel**. 

1.  Klik **Unduh CSV**. 

## Periksa kinerja kueri
<a name="v9-panels-query-performance"></a>

 Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah. 

1.  Edit panel yang berisi kueri dengan kinerja yang ingin Anda periksa. 

1.  Di editor kueri, klik **Query Inspector**. 

1.  Klik **Statistik.** 

 Statistik ditampilkan dalam format read-only. 

## Periksa permintaan dan respons kueri
<a name="v9-panels-query-request-response"></a>

 Periksa permintaan kueri dan data respons saat Anda ingin memecahkan masalah kueri yang mengembalikan hasil yang tidak terduga, atau gagal mengembalikan hasil yang diharapkan. 

1.  Edit panel yang berisi kueri yang ingin Anda ekspor. 

1.  Di editor kueri, klik **Query Inspector**. 

1.  Klik **Segarkan**. 

    Panel diisi dengan data respons. 

1.  Lakukan penyesuaian, seperlunya dan jalankan kembali kueri. 

1.  Untuk mengunduh permintaan kueri dan data respons, klik ikon **Salin ke clipboard** dan tempel hasilnya ke aplikasi lain. 

# Visualisasi tersedia dalam Grafana versi 9
<a name="v9-panels-viz"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana menawarkan berbagai visualisasi untuk mendukung kasus penggunaan yang berbeda. Bagian dokumentasi ini menyoroti panel bawaan, opsi, dan penggunaan khasnya.

Panel umum untuk memulai, dan untuk mempelajari dasar-dasar menggunakan panel, adalah [Panel deret waktu](v9-panels-time-series.md) panel.

**Topics**
+ [Panel daftar peringatan](v9-panels-alert-list.md)
+ [Panel anotasi](v9-panels-annotations.md)
+ [Panel bagan batang](v9-panels-bar-chart.md)
+ [Pengukur batang](v9-panels-bar-gauge.md)
+ [Panel kandil](v9-panels-candlestick.md)
+ [Panel kanvas](v9-panels-canvas.md)
+ [Panel jam](v9-panels-clock.md)
+ [Daftar dasbor](v9-panels-dashboard-list.md)
+ [Panel pengukur](v9-panels-gauge.md)
+ [Panel geomap](v9-panels-geomap.md)
+ [Panel grafik](v9-panels-graph.md)
+ [Panel peta panas](v9-panels-heatmap.md)
+ [Panel histogram](v9-panels-histogram.md)
+ [Panel log](v9-panels-logs.md)
+ [Panel berita](v9-panels-news.md)
+ [Panel grafik simpul](v9-panels-node-graph.md)
+ [Panel bagan pai](v9-panels-piechart.md)
+ [Panel yang cepat](v9-panels-plotly.md)
+ [Panel Sankey](v9-panels-sankey.md)
+ [Panel pencar](v9-panels-scatter.md)
+ [Panel stat](v9-panels-stat.md)
+ [Panel garis waktu negara](v9-panels-state-timeline.md)
+ [Panel riwayat status](v9-panels-status-history.md)
+ [Panel meja](v9-panels-table.md)
+ [Panel teks](v9-panels-text.md)
+ [Panel deret waktu](v9-panels-time-series.md)
+ [Panel Jejak (Beta)](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# Panel daftar peringatan
<a name="v9-panels-alert-list"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel daftar peringatan menampilkan peringatan dasbor Anda. Anda dapat mengonfigurasi daftar untuk menampilkan status saat ini atau perubahan status terbaru. Untuk informasi selengkapnya tentang peringatan, lihat[Peringatan di Grafana versi 9](v9-alerts.md).

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi
<a name="v9-panels-alert-list-options"></a>
+  **Mode grup** - Pilih **pengelompokan Default** untuk menampilkan instance peringatan yang dikelompokkan berdasarkan aturan peringatan mereka, atau **Pengelompokan khusus untuk mengelompokkan** instance peringatan dengan kumpulan label khusus.
+  **Item Maks** - Atur jumlah maksimum peringatan ke daftar.
+  **Urutkan urutan** - Pilih cara memesan peringatan yang ditampilkan.
  +  **Abjad (asc)** - Urutan abjad
  +  **Alfabetis (desc)** - Urutan abjad terbalik
  +  **Pentingnya** — Dengan kepentingan menurut nilai-nilai berikut, dengan 1 menjadi yang tertinggi:
    + `alerting`atau`firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused`atau`inactive`: 5
+  **Peringatan dari dasbor ini** - Tampilkan peringatan hanya dari dasbor tempat daftar peringatan berada.

## Filter
<a name="v9-panels-alert-filter"></a>

Gunakan opsi berikut untuk memfilter peringatan agar sesuai dengan kueri, folder, atau tag yang Anda pilih:
+  **Nama peringatan** - Masukkan kueri nama peringatan. 
+  **Label instance peringatan** - Filter instance peringatan menggunakan kueri label. Misalnya, `{severity="critical", instance=~"cluster-us-.+"}`.
+  **Folder** — Pilih folder. Hanya peringatan dari dasbor di folder yang dipilih yang akan ditampilkan.
+  **Sumber Data - Filter peringatan dari sumber** data yang dipilih. 

## Filter negara
<a name="v9-panels-alert-state-filter"></a>

Pilih status peringatan mana yang akan ditampilkan di panel ini.
+ Peringatan/Penembakan
+ Tertunda
+ Tidak ada data
+ Normal
+ Kesalahan

# Panel anotasi
<a name="v9-panels-annotations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel Anotasi menampilkan daftar anotasi yang tersedia yang dapat Anda gunakan untuk melihat data beranotasi. Berbagai opsi tersedia untuk memfilter daftar berdasarkan tag dan pada dasbor saat ini.

## Kueri anotasi
<a name="v9-panels-annotations-query"></a>

Opsi berikut mengontrol kueri sumber untuk daftar anotasi.

**Filter Kueri**

Gunakan filter kueri untuk membuat daftar anotasi dari semua dasbor di organisasi Anda atau dasbor saat ini di mana panel ini berada. Ini memiliki opsi berikut:
+ Semua dasbor - Daftar anotasi dari semua dasbor di organisasi saat ini.
+ Dasbor ini - Batasi daftar ke anotasi di dasbor saat ini.

**Rentang waktu**

Gunakan opsi rentang waktu untuk menentukan apakah daftar harus dibatasi pada rentang waktu saat ini. Ini memiliki opsi berikut:
+ Tidak ada - tidak ada batas rentang waktu untuk kueri anotasi.
+ Dasbor ini - Batasi daftar ke rentang waktu dasbor tempat panel daftar anotasi tersedia.

**Tanda**

Gunakan opsi tag untuk memfilter anotasi berdasarkan tag. Anda dapat menambahkan beberapa tag untuk memperbaiki daftar.

**catatan**  
Secara opsional, biarkan daftar tag kosong dan filter dengan cepat dengan memilih tag yang terdaftar sebagai bagian dari hasil pada panel itu sendiri.

*Batasi*

Gunakan opsi batas untuk membatasi jumlah hasil yang dikembalikan.

## Tampilan
<a name="v9-panels-annotations-display"></a>

Opsi ini mengontrol metadata tambahan yang disertakan dalam tampilan panel anotasi.

**Tampilkan pengguna**

Gunakan opsi ini untuk menampilkan atau menyembunyikan pengguna mana yang membuat anotasi.

**Tampilkan waktu**

Gunakan opsi ini untuk menampilkan atau menyembunyikan waktu waktu pembuatan anotasi.

**Tampilkan Tag**

Gunakan opsi ini untuk menampilkan atau menyembunyikan tag yang terkait dengan anotasi. *NB*: Anda dapat menggunakan tag untuk memfilter langsung daftar anotasi pada panel itu sendiri.

## Tautkan perilaku
<a name="v9-panels-annotations-links"></a>

**Target tautan**

Gunakan opsi ini untuk memilih cara melihat data beranotasi. Ini memiliki opsi berikut.
+ Panel - Opsi ini akan membawa Anda langsung ke tampilan layar penuh panel dengan anotasi yang sesuai
+ Dasbor - Opsi ini akan memfokuskan anotasi dalam konteks dasbor lengkap

**Waktu sebelumnya**

Gunakan opsi ini untuk mengatur rentang waktu sebelum anotasi. Gunakan nilai string durasi seperti “1h” = 1 jam, “10m” = 10 menit, dll.

**Waktu setelahnya**

Gunakan opsi ini untuk mengatur rentang waktu setelah anotasi.

# Panel bagan batang
<a name="v9-panels-bar-chart"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel ini memungkinkan Anda untuk membuat grafik data kategoris.

## Format data yang didukung
<a name="v9-panels-bar-chart-formats"></a>

Hanya satu frame data yang didukung dan perlu memiliki setidaknya satu bidang string yang akan digunakan sebagai kategori untuk sumbu X atau Y dan satu atau lebih bidang numerik. Berikut ini adalah contoh format data:


|  Peramban  |  Pangsa pasar  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

Jika Anda memiliki lebih dari satu bidang numerik, panel menampilkan bilah yang dikelompokkan.

### Memvisualisasikan deret waktu atau beberapa set hasil
<a name="v9-panels-bar-chart-visualization"></a>

Jika Anda memiliki beberapa deret waktu atau tabel, pertama-tama Anda harus bergabung dengan mereka menggunakan gabungan, atau mengurangi transformasi. Misalnya, jika Anda memiliki beberapa deret waktu dan Anda ingin membandingkan nilai terakhir dan maksnya, tambahkan **Kurangi** transformasi dan tentukan **Maks** dan **Terakhir** sebagai opsi di bawah **Perhitungan**.

## Opsi bagan batang
<a name="v9-panels-bar-chart-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Orientasi**
+  **Otomatis** — Grafana memutuskan orientasi batang berdasarkan dimensi panel.
+  **Horizontal** - Menjadikan sumbu X sebagai sumbu kategori.
+  **Vertikal — Menjadikan** sumbu Y sebagai sumbu kategori.

**Panjang maksimum label centang sumbu X** menetapkan panjang maksimum label bagan batang. Label yang lebih panjang dari panjang maksimum terpotong (dengan elips).

**Label batang spasi minimum** menetapkan jarak minimum antara label batang.

**Tampilkan nilai**

Mengontrol apakah nilai ditampilkan di atas atau di sebelah kiri bar.
+  **Auto** - Nilai ditampilkan jika ada spasi.
+  **Selalu** — Selalu tunjukkan nilai.
+  **Jangan pernah** - Jangan pernah menunjukkan nilai.

**Penumpukan**

Mengontrol penumpukan bagan batang.
+  **Off** — Bar tidak akan ditumpuk.
+  **Normal** — Bar akan ditumpuk di atas satu sama lain.
+  **Persen** - Batang akan ditumpuk di atas satu sama lain, dan tinggi setiap batang adalah persentase dari total tinggi tumpukan (semua tumpukan batang akan memiliki ketinggian yang sama, menambahkan hingga 100 persen).

**Lebar grup** mengontrol lebar grup. 0 = min dan 1 = lebar maks.

**Lebar bar** mengontrol lebar bar. 0 = min dan 1 = lebar maks.

**Radius batang** mengontrol jari-jari batang, 0 = minimum dan 0,5 = radius maksimum.

**Sorot area penuh pada kontrol hover** jika area sekitar bilah disorot saat Anda mengarahkan kursor ke bilah dengan penunjuk.

**Lebar garis** mengontrol lebar garis bar.

**Fill opacity** mengontrol opasitas isian bilah.

**Mode gradien** mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan **Fill opacity**.
+  **Tidak ada** - tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip** — Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+  **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

**catatan**  
Anda dapat menggunakan override untuk menyembunyikan seri individual dari tooltip.

**Mode legenda** — Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya, lihat [Konfigurasikan legenda](v9-panels-configure-legend.md).
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** — Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Perhitungan legenda** — Pilih perhitungan standar mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

**Ukuran teks** - Masukkan nilai untuk mengubah ukuran teks pada bagan batang Anda.

**Axis** - Gunakan pengaturan bidang berikut untuk menyempurnakan tampilan sumbu Anda. Beberapa opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter.
+  **Penempatan** - Mengatur penempatan sumbu Y.
+  **Otomatis** - Grafana secara otomatis menetapkan sumbu Y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, maka Grafana menetapkan sumbu kiri ke unit pertama dan kanan ke unit berikut.
+  **Kiri** - Tampilkan semua sumbu Y di sisi kiri.
+  **Kanan** - Tampilkan semua sumbu Y di sisi kanan.
+  **Tersembunyi** — Sembunyikan semua sumbu Y.
+  **Label** - Tetapkan label teks sumbu Y. Jika Anda memiliki lebih dari satu sumbu Y, maka Anda dapat menetapkan label yang berbeda dengan override.
+  **Lebar** - Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

  Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Ini membuatnya lebih mudah untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau diregangkan dalam kedekatan visual satu sama lain.
+  **Soft min dan soft max** - Tetapkan opsi soft min dan soft max untuk kontrol batas sumbu Y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu Y secara otomatis berdasarkan kumpulan data.

  Pengaturan soft min dan soft max dapat mencegah blip berubah menjadi pegunungan ketika data sebagian besar datar, dan min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik yang ditentukan.

  Anda dapat mengatur min/max opsi standar untuk menentukan batas keras sumbu Y.

# Pengukur batang
<a name="v9-panels-bar-gauge"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pengukur batang menyederhanakan data Anda dengan mengurangi setiap bidang menjadi satu nilai. Anda memilih bagaimana Grafana menghitung reduksi.

Panel ini dapat menampilkan satu atau beberapa pengukur batang tergantung pada berapa banyak seri, baris, atau kolom yang dikembalikan kueri Anda.

## Opsi nilai
<a name="v9-panels-bar-gauge-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan** — Pilih cara Grafana menampilkan data Anda.

**Hitung** - Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat Jenis perhitungan.
+ **Bidang** - Pilih tampilan bidang di panel.

**Semua nilai** - Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
+ **Bidang** - Pilih tampilan bidang di panel.

## Opsi pengukur batang
<a name="v9-panels-bar-gauge-options"></a>

Sesuaikan bagaimana pengukur batang ditampilkan.

**Orientasi** — Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari bawah ke atas.

**Mode tampilan** - Pilih mode tampilan.
+ **Gradien** — Tingkat ambang batas menentukan gradien.
+ **Retro LCD** — Pengukur dibagi menjadi sel-sel kecil yang menyala atau tidak menyala.
+ **Dasar** - Warna tunggal berdasarkan ambang pencocokan.

**Tampilkan area yang tidak terisi** - Pilih ini jika Anda ingin membuat wilayah bar yang tidak terisi sebagai abu-abu gelap. Tidak berlaku untuk mode tampilan LCD Retro.

**Lebar min**

Batasi lebar minimum kolom batang dalam arah vertikal.

Secara otomatis menampilkan bilah gulir sumbu x ketika ada sejumlah besar data.

**Tinggi min**

Batasi ketinggian minimum baris batang dalam arah horizontal.

Secara otomatis menampilkan bilah gulir sumbu y ketika ada sejumlah besar data.

# Panel kandil
<a name="v9-panels-candlestick"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel Candlestick memungkinkan Anda untuk memvisualisasikan data yang mencakup sejumlah dimensi konsisten yang berfokus pada pergerakan harga. Panel Candlestick mencakup mode Open-High-Low-Close (OHLC), serta dukungan untuk dimensi tambahan berdasarkan data deret waktu.

Panel Candlestick dibangun di atas fondasi [Panel deret waktu](v9-panels-time-series.md) dan mencakup banyak pengaturan konfigurasi umum.

**Modus**

Opsi mode memungkinkan Anda untuk beralih dimensi mana yang digunakan untuk visualisasi.
+ **Lilin** membatasi dimensi panel ke dimensi terbuka, tinggi, rendah, dan dekat yang digunakan oleh visualisasi kandil.
+ **Volume** membatasi dimensi panel ke dimensi volume.
+ **Keduanya** adalah perilaku default untuk panel kandil. Ini mencakup visualisasi kandil dan volume.

**Gaya lilin**
+ **Lilin** adalah gaya tampilan default dan menciptakan visualisasi gaya lilin antara dimensi terbuka dan dekat.
+ **OHLC Bars** menampilkan empat dimensi inti nilai terbuka, tinggi, rendah, dan dekat.

**Strategi warna**
+ **Karena Open** adalah perilaku default. Mode ini akan memanfaatkan warna *Naik* (bawah) jika pergerakan harga intra-periode positif. Dengan kata lain, jika nilai pada penutupan lebih besar atau sama dengan nilai pada open, warna *Up* digunakan.
+ **Karena Prior Close** adalah metode tampilan alternatif di mana warna lilin didasarkan pada pergerakan harga interperiod atau perubahan nilai. Dengan kata lain, jika nilai pada open lebih besar dari nilai sebelumnya pada close, warna *Up* digunakan. Jika nilai pada open lebih rendah dari nilai sebelumnya pada penutupan, warna *Down* digunakan. *Opsi ini juga memicu mode visualisasi kandil berongga*. Candlestick berongga menunjukkan bahwa pergerakan intra-periode positif (nilai lebih tinggi pada penutupan daripada saat terbuka), kandil yang diisi menunjukkan perubahan intra-periode negatif (nilai lebih rendah pada penutupan daripada pada pembukaan). Untuk mempelajari lebih lanjut, lihat [penjelasan perbedaannya](https://thetradingbible.com/how-to-read-hollow-candlesticks).

**Warna Atas & Bawah**

Opsi **warna Naik** **dan Bawah** memilih warna mana yang digunakan saat pergerakan harga naik atau turun. *Strategi Warna* di atas akan menentukan apakah pergerakan harga intra-periode atau antar-periode digunakan untuk memilih warna candle atau OHLC bar.

**Buka, Tinggi, Rendah, Tutup**

Panel kandil akan mencoba memetakan bidang ke dimensi yang sesuai. Opsi **Buka**, **Tinggi**, **Rendah**, dan **Tutup** memungkinkan Anda memetakan data Anda ke dimensi ini jika panel tidak dapat melakukannya.

**catatan**  
Nilai-nilai ini disembunyikan dari legenda.
+ **Buka** sesuai dengan nilai awal periode yang diberikan.
+ **Tinggi** sesuai dengan nilai tertinggi dari periode yang diberikan.
+ **Rendah** sesuai dengan nilai terendah dari periode tertentu.
+ **Tutup** sesuai dengan nilai akhir (akhir) dari periode yang diberikan.
+ **Volume** sesuai dengan jumlah sampel dalam periode tertentu. (misalnya jumlah perdagangan)

**Bidang tambahan**

Panel kandil didasarkan pada panel deret waktu. Ini dapat memvisualisasikan dimensi data tambahan di luar open, high, low, close, dan volume Opsi **Include** and **Ignore** memungkinkan panel untuk memvisualisasikan data lain yang disertakan seperti simple moving average, Bollinger band dan banyak lagi, menggunakan gaya dan konfigurasi yang sama yang tersedia di. [Panel deret waktu](v9-panels-time-series.md)

# Panel kanvas
<a name="v9-panels-canvas"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Canvas adalah panel baru yang menggabungkan kekuatan Grafana dengan fleksibilitas elemen khusus. Visualisasi kanvas adalah panel form-built yang dapat diperluas yang memungkinkan Anda menempatkan elemen secara eksplisit dalam tata letak statis dan dinamis. Ini memberdayakan Anda untuk merancang visualisasi khusus dan overlay data dengan cara yang tidak mungkin dilakukan dengan panel Grafana standar, semuanya dalam UI Grafana. Jika Anda telah menggunakan UI populer dan alat desain web, maka merancang panel Canvas akan terasa sangat akrab.

## Elemen
<a name="v9-panels-canvas-elements"></a>

**Nilai metrik**

Elemen nilai metrik memungkinkan Anda untuk dengan mudah memilih data yang ingin Anda tampilkan di kanvas. Elemen ini memiliki mode “edit” unik yang dapat dipicu baik melalui opsi menu konteks “Edit” atau dengan mengklik dua kali. Saat dalam mode edit Anda dapat memilih data bidang mana yang ingin Anda tampilkan.

**Teks**

Elemen teks memungkinkan Anda untuk dengan mudah menambahkan teks ke kanvas. Elemen ini juga mendukung mode pengeditan, dipicu melalui mengklik dua kali atau opsi menu edit di menu konteks.

**Persegi Panjang**

Elemen persegi panjang memungkinkan Anda untuk menambahkan persegi panjang dasar ke kanvas. Elemen persegi panjang mendukung menampilkan teks (baik data tetap dan bidang) serta dapat mengubah warna latar belakang berdasarkan ambang data.

**Ikon**

Elemen ikon memungkinkan Anda untuk menambahkan ikon yang didukung ke kanvas. Ikon dapat memiliki warna yang ditetapkan berdasarkan ambang batas atau pemetaan nilai.

## Pengeditan Kanvas
<a name="v9-panels-canvas-editing"></a>

**Editor sebaris**

Canvas memperkenalkan pengalaman pengeditan baru. Anda sekarang dapat mengedit panel kanvas Anda sebaris saat dalam konteks mode dasbor.

**Menu konteks**

Menu konteks memberi Anda akses ke tugas-tugas umum. Fungsionalitas yang didukung termasuk membuka dan menutup editor inline, menduplikasi elemen, menghapus elemen, dan banyak lagi.

Menu konteks dipicu oleh tindakan klik kanan di atas panel atau elemen kanvas yang diberikan. Saat mengklik kanan panel, Anda dapat mengatur gambar latar belakang dan dengan mudah menambahkan elemen ke kanvas.

Saat mengklik kanan elemen, Anda dapat mengedit, menghapus, dan menduplikasi elemen, atau memodifikasi posisi lapisan elemen.

## Opsi Kanvas
<a name="v9-panels-canvas-options"></a>

**Pengeditan sebaris**

Toggle pengeditan sebaris memungkinkan Anda mengunci atau membuka kunci panel kanvas. Ketika dimatikan panel kanvas menjadi *terkunci*, membekukan elemen di tempat dan mencegah modifikasi yang tidak diinginkan.

# Panel jam
<a name="v9-panels-clock"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel jam menunjukkan waktu saat ini atau hitungan mundur. Ini memperbarui setiap detik.
+ **Mode** — Defaultnya adalah **waktu**. Jika Anda memilih **hitung mundur**, atur Batas **Waktu Hitung Mundur untuk memulai hitungan mundur**.
+ **12 atau 24 jam** - Pilihan untuk menampilkan waktu adalah format 12 jam dan format 24 jam.
+ **Zona waktu** — Zona waktu disediakan oleh perpustakaan zona waktu momen. Defaultnya adalah zona waktu di komputer Anda.
+ **Batas Waktu Hitung Mundur** **- Tentukan waktu dan tanggal untuk menghitung mundur, jika Anda telah mengatur **Mode** ke hitungan mundur.**
+ **Teks Akhir Hitung Mundur** - Tentukan teks yang akan ditampilkan saat hitungan mundur berakhir.
+ **Opsi pemformatan Tanggal/Waktu** - Sesuaikan ukuran font, berat, dan pemformatan. date/time Jika Anda menunjukkan hitungan mundur dan tidak ingin melihat detik berdetak turun, ubah format waktu menjadi `hh:mm` jam 24 jam atau jam 12 `h:mm A` jam. Untuk daftar lengkap opsi, lihat [Tampilan](https://momentjs.com/docs/#/displaying/).
+ **Bg Color** - Pilih warna latar belakang untuk jam.

# Daftar dasbor
<a name="v9-panels-dashboard-list"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi daftar dasbor memungkinkan Anda menampilkan tautan dinamis ke dasbor lain. Daftar ini dapat dikonfigurasi untuk menggunakan dasbor berbintang, dasbor yang baru dilihat, kueri penelusuran, dan tag dasbor.

Pada setiap pemuatan dasbor, panel ini menanyakan daftar dasbor, selalu memberikan up-to-date hasil terbanyak.

**Pilihan**

Gunakan opsi ini untuk menyempurnakan visualisasi Anda.
+ **Dibintangi** - Tampilkan dasbor berbintang dalam urutan abjad.
+ **Baru-baru ini dilihat** - Tampilkan dasbor yang baru dilihat dalam urutan abjad.
+ **Cari** - Tampilkan dasbor berdasarkan permintaan pencarian atau tag. Anda harus memasukkan setidaknya satu nilai dalam **Kueri** atau **Tag**. Untuk bidang **Query** dan **Tags**, interpolasi variabel didukung, misalnya, `$my_var` atau. `${my_var}`
+ **Tampilkan judul** - Pilihan daftar yang dipilih (Dibintangi, Baru dilihat, Pencarian) ditampilkan sebagai judul.
+ **Max item** - Menetapkan jumlah maksimum item untuk daftar per bagian. Misalnya, jika Anda meninggalkan ini pada nilai default 10 dan ditampilkan Dasbor Berbintang dan Baru dilihat, maka panel akan menampilkan hingga 20 dasbor total, sepuluh di setiap bagian.

**Cari**

Opsi ini hanya berlaku jika opsi **Pencarian** dipilih.
+ **Query** — Masukkan kueri yang ingin Anda cari. Kueri tidak peka huruf besar/kecil, dan sebagian nilai diterima.
+ **Folder** — Pilih folder dasbor yang ingin Anda tampilkan.
+ **Tag** — Di sinilah Anda memasukkan tag yang ingin Anda cari. *Tag yang ada tidak akan muncul saat Anda mengetik, dan mereka peka huruf besar/kecil.*

**catatan**  
Ketika beberapa tag dan string muncul, daftar dasbor menampilkan yang cocok dengan *semua* kondisi.

# Panel pengukur
<a name="v9-panels-gauge"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gauge adalah visualisasi nilai tunggal yang dapat mengulang pengukur untuk setiap seri, kolom atau baris.

**Opsi nilai**

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

**Hitung**

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat[Jenis perhitungan](v9-panels-calculation-types.md).
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

**Semua nilai**

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
+ **Bidang** - Pilih bidang yang akan ditampilkan di panel.

**Gauge**

Sesuaikan bagaimana pengukur ditampilkan.
+ **Tampilkan label ambang batas** - Kontrol jika nilai ambang ditampilkan.
+ **Tampilkan penanda ambang batas** — Kontrol jika pita ambang ditampilkan di luar pita nilai pengukur bagian dalam.

**Ukuran teks**

Sesuaikan ukuran teks pengukur.
+ **Judul** — Masukkan nilai numerik untuk ukuran judul gauge.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Panel geomap
<a name="v9-panels-geomap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel Geomap memungkinkan Anda untuk melihat dan menyesuaikan peta dunia menggunakan data geospasial. Anda dapat mengonfigurasi berbagai gaya overlay dan pengaturan tampilan peta untuk dengan mudah fokus pada karakteristik data berbasis lokasi yang penting.

## Tampilan Peta
<a name="v9-panels-geomap-view"></a>

Tampilan peta mengontrol tampilan awal peta saat dasbor dimuat.

**Tampilan Awal**

Tampilan awal mengonfigurasi bagaimana GeoMap panel dirender saat panel pertama kali dimuat.
+ **Tampilan** menyetel pusat peta saat panel pertama kali dimuat.
  + **Sesuai dengan data** sesuai dengan tampilan peta berdasarkan luasan data lapisan Peta dan pembaruan saat data berubah.
    + Opsi **data** memungkinkan pemilihan luas berdasarkan data dari “Semua lapisan”, satu “Lapisan”, atau “Nilai terakhir” dari lapisan yang dipilih.
    + **Layer** dapat dipilih jika memasang data dari satu “Layer” atau “Nilai terakhir” dari sebuah layer.
    + **Padding** menetapkan padding dalam persen relatif di luar jangkauan data (tidak tersedia saat melihat “Nilai terakhir” saja).
    + **Max Zoom** menetapkan tingkat zoom maksimum saat memasang data.
  + **Koordinat** menetapkan tampilan peta berdasarkan:
    + **Lintang**
    + **Bujur**
  + Tampilan Default juga tersedia termasuk:
    + **(0°, 0°)**
    + **Amerika Utara**
    + **Amerika Selatan**
    + **Eropa**
    + **Afrika**
    + **Asia Barat**
    + **Asia Selatan**
    + **Asia Tenggara**
    + **Asia Timur**
    + **Australia**
    + **Oseania**
+ **Zoom** mengatur tingkat zoom awal.

## Lapisan peta
<a name="v9-panels-geomap-layers"></a>

Visualisasi Geomap mendukung menampilkan beberapa lapisan. Setiap lapisan menentukan bagaimana Anda memvisualisasikan data geospasial di atas peta dasar.

**Jenis**

Ada tiga jenis layer peta untuk dipilih dalam visualisasi Geomap.
+ [Lapisan penanda](#v9-panels-geomap-markers)membuat penanda di setiap titik data.
+ [Lapisan peta panas](#v9-panels-geomap-heatmap)memvisualisasikan peta panas data.
+ [Lapisan GeoJSON](#v9-panels-geomap-geojson)membuat data statis dari file GeoJSON.

Ada juga lima jenis lapisan yang saat ini dalam alfa.
+ [Lapisan Malam/Hari (Alpha)](#v9-panels-geomap-nightday)membuat wilayah malam atau siang hari.
+ **Ikon pada titik terakhir (alpha)** membuat ikon pada titik data terakhir.
+ **Dynamic GeoJSON (alpha)** menata file GeoJSON berdasarkan hasil kueri.
+ **Route (alpha)** membuat titik data sebagai rute.
+ [Lapisan foto (Alpha)](#v9-panels-geomap-photos)membuat foto di setiap titik data.

**Kontrol Lapisan**

Kontrol lapisan memungkinkan Anda membuat lapisan, mengubah namanya, menyusun ulang, dan menghapus lapisan.
+ **Add layer menciptakan lapisan** data tambahan yang dapat dikonfigurasi untuk visualisasi Geomap. Ketika Anda menambahkan layer, Anda diminta untuk memilih jenis layer. Anda dapat mengubah jenis lapisan di setiap titik selama konfigurasi panel. Lihat bagian **Layer Types** di atas untuk detail pada setiap jenis layer.
+ Kontrol lapisan memungkinkan Anda untuk mengganti nama, menghapus, dan menyusun ulang lapisan panel.
  + **Edit nama layer** (ikon pensil) mengganti nama layer.
  + **Trash Bin** menghapus layer.
  + **Menyusun ulang** (enam titik/pegangan ambil) memungkinkan Anda untuk mengubah urutan lapisan. Data pada lapisan yang lebih tinggi akan muncul di atas data pada lapisan bawah. Panel akan memperbarui urutan layer saat Anda drag dan drop untuk membantu menyederhanakan memilih urutan layer.

Anda dapat menambahkan beberapa lapisan data ke satu panel Geomap untuk membuat visualisasi yang kaya dan terperinci.

**Lokasi**

Panel Geomap membutuhkan sumber data geografis. Data ini berasal dari kueri database, dan ada empat opsi pemetaan untuk data Anda.
+ **Otomatis** secara otomatis mencari data lokasi. Gunakan opsi ini ketika kueri Anda didasarkan pada salah satu nama berikut untuk bidang data.
  + geohash: “geohash”
  + garis lintang: “garis lintang”, “lat”
  + bujur: “bujur”, “lng”, “lon”
  + pencarian: “pencarian”
+ **Coords** menentukan bahwa kueri Anda menyimpan data koordinat. Anda akan diminta untuk memilih bidang data numerik untuk garis lintang dan bujur dari kueri database Anda.
+ **Geohash** menentukan bahwa kueri Anda menyimpan data geohash. Anda akan diminta untuk memilih bidang data string untuk geohash dari kueri database Anda.
+ **Pencarian** menentukan bahwa kueri Anda menyimpan data nama lokasi yang perlu dipetakan ke nilai. Anda akan diminta untuk memilih bidang pencarian dari kueri database Anda dan gazetteer. Gazetteer adalah direktori yang digunakan untuk memetakan data kueri Anda ke titik geografis.

## Lapisan penanda
<a name="v9-panels-geomap-markers"></a>

Lapisan penanda memungkinkan Anda untuk menampilkan titik data sebagai bentuk penanda yang berbeda seperti lingkaran, kotak, segitiga, bintang, dan banyak lagi.

Penanda memiliki banyak opsi penyesuaian.
+ **Marker Color** mengkonfigurasi warna penanda. Default `Single color` menyimpan semua titik satu warna. Ada opsi alternatif untuk memiliki beberapa warna tergantung pada nilai titik data dan ambang batas yang ditetapkan di `Thresholds` bagian tersebut.
+ **Ukuran Penanda** mengkonfigurasi ukuran penanda. Defaultnya adalah`Fixed size`, yang membuat semua ukuran penanda sama terlepas dari titik datanya. Namun, ada juga opsi untuk menskalakan lingkaran ke titik data yang sesuai. `Min`dan ukuran `Max` penanda harus diatur sedemikian rupa sehingga lapisan Marker dapat menskalakan dalam kisaran ini.
+ **Marker Shape** memungkinkan Anda memilih bentuk, ikon, atau grafik untuk membantu memberikan konteks visual tambahan pada data Anda. Pilih dari aset yang disertakan dengan Grafana seperti bentuk sederhana atau pustaka Unicon. Anda juga dapat menentukan URL yang berisi aset gambar. Gambar harus berupa grafik vektor yang dapat diskalakan (SVG).
+ **Fill opacity** mengonfigurasi transparansi setiap penanda.

## Lapisan peta panas
<a name="v9-panels-geomap-heatmap"></a>

Lapisan peta panas mengelompokkan berbagai titik data untuk memvisualisasikan lokasi dengan kepadatan berbeda. Untuk menambahkan layer heatmap:

Klik pada menu dropdown di bawah Data Layer dan pilih. `Heatmap`

Mirip dengan`Markers`, Anda diminta dengan opsi untuk menentukan titik data mana yang akan divisualisasikan dan bagaimana Anda ingin memvisualisasikannya.
+ **Nilai berat** mengkonfigurasi intensitas kluster peta panas. `Fixed value`menyimpan nilai bobot konstan di semua titik data. Nilai ini harus berada dalam kisaran 0 \$1 1. Mirip dengan Markers, ada opsi alternatif di dropdown untuk secara otomatis menskalakan nilai bobot tergantung pada nilai data.
+ **Radius** mengkonfigurasi ukuran kluster peta panas.
+ **Blur** mengkonfigurasi jumlah blur pada setiap cluster.

## Lapisan GeoJSON
<a name="v9-panels-geomap-geojson"></a>

Lapisan GeoJSON memungkinkan Anda untuk memilih dan memuat file GeoJSON statis dari sistem file.
+ URL **GeoJSON menyediakan pilihan file GeoJSON** yang dikirimkan bersama Grafana.
+ **Default Style** mengontrol gaya mana yang akan diterapkan bila tidak ada aturan di atas yang cocok.
  + **Warna** mengkonfigurasi warna gaya default
  + **Opacity mengonfigurasi opacity** default
+ **Aturan Gaya** menerapkan gaya berdasarkan properti fitur
  + **Aturan** memungkinkan Anda memilih *fitur*, *kondisi*, dan *nilai* dari file GeoJSON untuk menentukan aturan. Ikon tempat sampah dapat digunakan untuk menghapus aturan saat ini.
  + **Warna** mengkonfigurasi warna gaya untuk aturan saat ini
  + **Opacity** mengonfigurasi tingkat transparansi untuk aturan saat ini
+ **Tambahkan aturan gaya** menciptakan aturan gaya tambahan.

## Lapisan CARTO
<a name="v9-panels-geomap-carto"></a>

Lapisan CARTO berasal dari peta dasar [CARTO](https://carto.com/about-us/) Raster.

**Pilihan**
+ **Tema**

   Pilih tema, baik tema **Terang**, tema **Gelap**, atau tema **Otomatis**.
+ **Tampilkan label** menunjukkan detail Negara di bagian atas peta.
+ **Opacity** dari 0 (transparan) ke 1 (buram)

## Lapisan ubin XYZ
<a name="v9-panels-geomap-xyz"></a>

Lapisan ubin XYZ adalah peta dari lapisan ubin generik.

**catatan**  
Untuk informasi selengkapnya tentang lapisan ubin generik, lihat [Peta Web](https://en.wikipedia.org/wiki/Tiled_web_map) Ubin, dan [Daftar Server Ubin Peta Jalan Terbuka](https://wiki.openstreetmap.org/wiki/Tile_servers).

**Pilihan**
+ **Templat URL**
**catatan**  
Tetapkan url server ubin yang valid, dengan \$1z\$1/\$1x\$1/\$1y\$1 misalnya:`https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ **Atribusi** menetapkan string referensi untuk lapisan jika ditampilkan dalam kontrol [peta](#v9-panels-geomap-controls)
+ **Opacity** dari 0 (transparan) ke 1 (buram)

## Buka lapisan Peta Jalan
<a name="v9-panels-geomap-osm"></a>

Peta dari [Open Street Map](https://www.openstreetmap.org/about), database dunia geografis kolaboratif dan gratis.

**Pilihan**
+ **Opacity** dari 0 (transparan) ke 1 (buram)

## Lapisan ArcGIS
<a name="v9-panels-geomap-arcgis"></a>

Lapisan [ArcGIS adalah](https://services.arcgisonline.com/arcgis/rest/services) lapisan dari [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS. MapServer

**Pilihan**
+ **Server Instance** untuk memilih dari jenis peta berikut.
  + Peta Jalan Dunia
  + Citra Dunia
  + Dunia Fisik
  + Topografi
  + Topografi Amerika Serikat
  + Samudra Dunia
  + Kustom MapServer (lihat [XYZ](#v9-panels-geomap-xyz) untuk pemformatan)
    + Templat URL
    + Atribusi
+ **Opacity** dari 0 (transparan) ke 1 (buram)

## Lapisan Malam/Hari (Alpha)
<a name="v9-panels-geomap-nightday"></a>

Lapisan Malam/Siang menampilkan wilayah siang dan malam berdasarkan rentang waktu saat ini.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

**Pilihan**
+ **Tampilkan** sumber waktu beralih dari rentang waktu panel
+ **Warna wilayah malam** memilih warna untuk wilayah malam
+ **Tampilan matahari** beralih ikon matahari
+ **Opacity** dari 0 (transparan) ke 1 (buram)

## Lapisan foto (Alpha)
<a name="v9-panels-geomap-photos"></a>

Lapisan Foto membuat foto di setiap titik data.

**catatan**  
Untuk informasi selengkapnya, lihat [Ekstensi untuk OpenLayers - Gaya Foto Gambar](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

**Pilihan**
+ **Bidang Sumber Gambar**

  Pilih bidang string yang berisi data gambar dalam salah satu format berikut:
  + **Gambar URLs**
  + **Base64 dikodekan gambar biner** () `data:image/png;base64,…`
+ **Baik**

   pilih gaya bingkai di sekitar gambar
  + **Persegi**
  + **Lingkaran**
  + **Berlabuh**
  + **Folio**
+ **Pangkas** sakelar jika gambar dipotong agar pas
+ **Bayangan** beralih bayangan kotak di belakang gambar
+ **Perbatasan** mengatur ukuran perbatasan di sekitar gambar
+ **Warna perbatasan mengatur warna** perbatasan di sekitar gambar
+ **Radius** mengatur ukuran keseluruhan gambar dalam piksel

## Kontrol Peta
<a name="v9-panels-geomap-controls"></a>

Antarmuka kontrol peta berisi opsi berikut untuk informasi peta dan hamparan alat.

**Zoom**

Bagian ini menjelaskan masing-masing kontrol zoom.

*Tampilkan kontrol zoom*

Menampilkan kontrol zoom di sudut kiri atas.

*Zoom roda mouse*

Menghidupkan atau mematikan menggunakan roda mouse untuk memperbesar atau memperkecil.

**Tampilkan atribusi**

Menampilkan atribusi untuk lapisan basemap di peta.

**Tampilkan skala**

Menampilkan informasi skala di sudut kiri bawah.

**catatan**  
Menampilkan unit dalam [m]/[km].

**Tampilkan alat ukur**

Menampilkan alat ukur di sudut kanan atas. Pengukuran hanya muncul ketika kontrol ini terbuka.
+ **Klik** untuk mulai mengukur
+ **Lanjutkan mengklik** untuk melanjutkan pengukuran
+ **Klik dua kali** untuk mengakhiri pengukuran

**catatan**  
Saat Anda mengubah jenis atau unit pengukuran, pengukuran sebelumnya akan dihapus dari peta.  
Jika kontrol ditutup dan kemudian dibuka kembali, pengukuran terbaru ditampilkan.  
Pengukuran dapat dimodifikasi dengan mengklik dan menyeretnya.

*Panjangnya*

Dapatkan panjang bola geometri. Panjang ini adalah jumlah dari jarak lingkaran besar antara koordinat. Untuk geometri multi-bagian, panjangnya adalah jumlah dari panjang setiap bagian. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran panjang:
+ **Metrik (m/km)**
+ **Kaki (ft)**
+ **Miles (mi)**
+ **Mil laut (nmi)**

*Luas*

Dapatkan area bola geometri. Area ini dihitung dengan asumsi bahwa tepi poligon adalah segmen lingkaran besar pada bola. Geometri diasumsikan dalam 'EPSG:3857'.

Anda dapat memilih unit berikut untuk pengukuran area:
+ **Meter Persegi (m²)**
+ **Kilometer Persegi (km²)**
+ **Kaki Persegi (ft²)**
+ **Mil Persegi (mi²)**
+ **Hektar (acre)**
+ **Hektar (ha)**

**Tampilkan debug**

Menampilkan informasi debug di sudut kanan atas peta. Ini dapat berguna untuk men-debug atau memvalidasi sumber data.
+ **Zoom** menampilkan tingkat zoom peta saat ini.
+ **Pusat** menampilkan garis **bujur** saat ini, dan **garis lintang** pusat peta.

**Tooltip**
+ **Tidak ada** yang menampilkan tooltips hanya ketika titik data diklik.
+ **Detail** menampilkan tooltips saat pointer melayang di atas titik data.

# Panel grafik
<a name="v9-panels-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel grafik dapat dirender sebagai garis, jalur titik, atau serangkaian batang. Jenis grafik ini cukup serbaguna untuk menampilkan hampir semua data deret waktu.

## Opsi data dan bidang
<a name="v9-panels-graph-data-and-field-options"></a>

Saat menggunakan visualisasi grafik, Anda dapat menerapkan opsi berikut:
+  [Mengubah data](v9-panels-xform.md) 
+ Peringatan. Ini adalah satu-satunya jenis visualisasi yang memungkinkan Anda mengatur peringatan. Untuk informasi selengkapnya, lihat [Peringatan di Grafana versi 9](v9-alerts.md).
+  [Konfigurasikan ambang batas](v9-panels-configure-thresholds.md) 

## Opsi tampilan
<a name="v9-panels-graph-display-options"></a>

Untuk menyempurnakan visualisasi Anda, gunakan pengaturan berikut:
+  **Bars** - Menampilkan nilai sebagai diagram batang. 
+  **Garis** - Menampilkan nilai sebagai grafik garis. 
+  **Lebar garis** - Tentukan lebar garis untuk seri. Default-nya adalah 1.
+  **Tangga** — Gambarlah titik-titik yang berdekatan sebagai tangga.
+  **Isi area** - Tentukan jumlah isian warna untuk seri. Defaultnya adalah 1; 0 tidak ada.
+  **Fill gradient** — Tentukan derajat gradien pada area fill. Defaultnya adalah 0, yang tidak ada gradien; 10 adalah gradien curam.
+  **Poin** - Menampilkan poin untuk nilai. 
+  **Radius titik** — Kontrol seberapa besar titiknya.
+  **Ambang batas peringatan** - Menampilkan ambang peringatan dan Wilayah pada panel.

### Penumpukan dan nilai null
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **Stack** — Setiap seri ditumpuk di atas yang lain.
+  **Persen** — Setiap seri diambil sebagai persentase dari total semua seri. Opsi ini tersedia saat **Stack** dipilih.
+  **Nilai nol** - Tentukan bagaimana nilai null ditampilkan. *Ini adalah pengaturan yang penting.* Lihat catatan di bawah ini.
  +  **terhubung** - Jika ada celah dalam seri, yang berarti satu atau lebih nilai nol, garis akan melewati celah dan terhubung ke nilai non-null berikutnya. 
  +  **null** Jika ada celah dalam seri, yang berarti nilai nol, garis dalam grafik akan rusak dan menunjukkan celah. Ini adalah pengaturan default.
  +  **null as zero** — Jika ada celah dalam seri, yang berarti nilai nol, itu akan ditampilkan sebagai nilai nol di panel grafik.

**penting**  
Jika Anda memantau beban CPU server dan beban mencapai 100 persen, server akan mengunci, dan agen yang mengirim statistik tidak akan dapat mengumpulkan statistik beban. Hal ini menyebabkan celah dalam metrik, dan menggunakan pengaturan *nol* default berarti Grafana yang Dikelola Amazon akan menunjukkan celah dan menunjukkan bahwa ada sesuatu yang salah. Jika ini diatur ke *terhubung*, akan mudah untuk melewatkan sinyal ini. 

### Tooltip arahkan
<a name="v9-panels-graph-hover-tooltip"></a>

Gunakan pengaturan ini untuk mengubah tampilan tooltip yang muncul saat Anda menjeda visualisasi grafik.
+  **Mode** - Menentukan berapa banyak seri yang ditampilkan tooltip hover.
  +  **Semua seri** - Tooltip hover menunjukkan semua seri dalam grafik. Dalam daftar seri di tooltip, ruang kerja Grafana menyoroti seri yang Anda jeda dengan huruf tebal.
  +  **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda jeda dalam grafik.
+  **Urutkan urutan** - Mengurutkan urutan seri di tooltip hover jika Anda telah memilih **Semua mode seri**. Saat Anda menjeda pada grafik, Grafana Terkelola Amazon menampilkan nilai yang terkait dengan garis. Umumnya, pengguna paling tertarik pada nilai tertinggi atau terendah. Menyortir nilai-nilai ini dapat membuatnya lebih mudah untuk menemukan data yang Anda inginkan.
  +  **Tidak ada** - Urutan seri di tooltip ditentukan oleh urutan pengurutan dalam kueri Anda. Misalnya, Anda dapat mengurutkan seri menurut abjad berdasarkan nama seri.
  +  **Peningkatan** - Seri di tooltip hover diurutkan berdasarkan nilai dan urutan yang meningkat, dengan nilai terendah di bagian atas daftar.
  +  **Penurunan** - Seri di tooltip hover diurutkan berdasarkan nilai dan dalam urutan menurun, dengan nilai tertinggi di bagian atas daftar.

## Penggantian seri
<a name="v9-panels-graph-series-overrides"></a>

Penggantian seri memungkinkan seri dalam panel grafik dirender secara berbeda dari yang lain. Anda dapat menyesuaikan opsi tampilan per seri atau dengan menggunakan aturan regex. Misalnya, satu seri dapat memiliki lebar garis yang lebih tebal untuk membuatnya menonjol atau dipindahkan ke sumbu Y kanan.

Anda dapat menambahkan beberapa penggantian seri.

**Untuk menambahkan penggantian seri**

1. Pilih **Tambahkan penggantian seri**.

1. Di **Alias atau regex**, ketik atau pilih seri. Pilih bidang untuk melihat daftar seri yang tersedia.

   Misalnya, `/Network.*/` akan cocok dengan dua seri bernama `Network out` dan`Network in`.

1. Pilih **\$1** dan kemudian pilih gaya untuk diterapkan ke seri. Anda dapat menambahkan beberapa gaya ke setiap entri.
+  **Bar** - Tampilkan seri sebagai grafik batang. 
+  **Garis** - Tampilkan seri sebagai grafik garis. 
+  **Isi garis** - Tampilkan grafik garis dengan isian area. 
+  **Isi gradien** - Tentukan jumlah gradien pengisian area.
+  **Lebar garis** - Atur lebar garis.
+  **Mode titik nol** - Gunakan opsi ini untuk mengabaikan nilai nol atau menggantinya dengan nol. Ini penting jika Anda ingin mengabaikan celah dalam data Anda.
+  **Isi di bawah ini untuk** - Isi area antara dua seri.
+  **Garis tangga** — Tampilkan seri sebagai garis tangga.
+  **Tanda hubung** - Tampilkan garis dengan tanda hubung. 
+  **Seri Tersembunyi** - Sembunyikan seri. 
+  **Dash Length** - Atur panjang garis di garis.
+  **Dash Space** - Atur panjang spasi di antara tanda hubung di garis.
+  **Poin** - Tampilkan seri sebagai poin terpisah.
+  **Point Radius** - Atur radius untuk rendering titik.
+  **Stack** - Mengatur kelompok tumpukan untuk seri.
+  **Warna** - Atur warna seri.
+  **Sumbu Y - Atur** sumbu y seri.
+  **Z-index** - Mengatur seri z-index (urutan rendering). Opsi ini penting ketika Anda melapisi gaya yang berbeda, seperti diagram batang dan bagan area.
+  Transform — Ubah nilai menjadi negatif untuk dirender di bawah sumbu y.
+  **Legenda** — Kontrol apakah seri ditampilkan dalam legenda.
+  **Sembunyikan di tooltip** - Kontrol apakah seri ditampilkan dalam tooltip grafik.

## Sumbu
<a name="v9-panels-graph-axes"></a>

Gunakan opsi ini untuk mengontrol tampilan sumbu dalam visualisasi.

### Kiri Y/Right Y
<a name="v9-panels-graph-left-yright-y"></a>

Opsi identik untuk kedua sumbu y.
+  **Tampilkan** - Pilih untuk menampilkan atau menyembunyikan sumbu.
+  **Unit** — Pilih unit tampilan untuk nilai y.
+  **Skala** — Pilih skala yang akan digunakan untuk nilai y: **linier**, atau **logaritmik**. Defaultnya adalah **linier**.
+  **Y-Min** — Nilai y minimum. Defaultnya adalah **auto**.
+  **Y-Max** — Nilai Y maksimum. Defaultnya adalah **auto**.
+  **Desimal** — Tentukan berapa banyak desimal yang ditampilkan untuk nilai y. Defaultnya adalah **auto**. 
+  **Label** - Tentukan label sumbu y. Defaultnya adalah “”,

### Sumbu Y
<a name="v9-panels-graph-y-axes"></a>
+  **Sejajarkan** - Sejajarkan sumbu y kiri dan kanan berdasarkan nilai. Defaultnya tidak dicentang/salah.
+  **Level** - Masukkan nilai yang akan digunakan untuk penyelarasan sumbu y kiri dan kanan, mulai dari Y = 0. Default-nya adalah 0. Opsi ini tersedia saat **Align** dipilih. 

### Sumbu X
<a name="v9-panels-graph-x-axis"></a>
+  **Tampilkan** - Pilih untuk menampilkan atau menyembunyikan sumbu.
+  **Mode** — Mode tampilan benar-benar mengubah visualisasi panel grafik. Ini seperti tiga panel dalam satu. Mode utama adalah mode deret waktu dengan waktu pada sumbu x. Dua mode lainnya adalah mode bagan batang dasar dengan seri pada sumbu x, bukan waktu dan mode histogram.
  +  **Waktu** (default) — Sumbu x mewakili waktu dan data dikelompokkan berdasarkan waktu (misalnya, berdasarkan jam, atau menit).
  +  **Seri** — Data dikelompokkan berdasarkan seri, dan bukan berdasarkan waktu. Sumbu y masih mewakili nilainya.
    +  **Nilai** - Ini adalah jenis agregasi yang akan digunakan untuk nilai. Defaultnya adalah **total** (menjumlahkan nilai bersama-sama).
  +  **Histogram** — Opsi ini mengubah grafik menjadi histogram. Histogram adalah jenis bagan batang yang mengelompokkan angka ke dalam rentang, sering disebut ember atau tempat sampah. Bilah yang lebih tinggi menunjukkan bahwa lebih banyak data jatuh dalam kisaran itu.

    Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)
    +  **Bucket** — Mengatur jumlah bucket untuk mengelompokkan nilai berdasarkan. Jika dibiarkan kosong, Grafana yang Dikelola Amazon mencoba menghitung jumlah ember yang sesuai.
    +  **X-Min** — Menyaring nilai dari histogram yang kurang dari batas minimum ini.
    +  **X-Max** — Memfilter nilai yang lebih besar dari batas maksimum ini.

## Legenda
<a name="v9-panels-graph-legend"></a>

Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.

### Opsi
<a name="v9-panels-graph-legends-options"></a>
+  **Tampilkan** — Bersihkan untuk menyembunyikan legenda. Default dipilih (true).
+  **Sebagai Tabel** - Pilih untuk menampilkan legenda dalam tabel. Default dicentang (true).
+  **Ke kanan** — Pilih untuk menampilkan legenda di sebelah kanan.
+  Lebar - Masukkan lebar minimum untuk legenda dalam piksel. Opsi ini tersedia saat **Ke kanan** dipilih.

### Nilai
<a name="v9-panels-graph-values"></a>

Nilai tambahan dapat ditampilkan di samping nama legenda.
+  **Min** — Nilai minimum yang dikembalikan dari kueri metrik.
+  **Max** — Nilai maksimum yang dikembalikan dari kueri metrik.
+  **Rata-rata** — Nilai rata-rata yang dikembalikan dari kueri metrik.
+  **Current** - Nilai terakhir yang dikembalikan dari kueri metrik.
+  **Total — Jumlah** semua nilai yang dikembalikan dari kueri metrik.
+  **Desimal** - Berapa banyak desimal yang ditampilkan untuk nilai legenda dan tooltips grafik hover.

Grafana Terkelola Amazon menghitung nilai legenda di sisi klien. Nilai legenda ini bergantung pada jenis agregasi atau konsolidasi titik yang digunakan kueri metrik Anda. Semua nilai legenda di atas tidak bisa benar pada saat bersamaan.

Misalnya, jika Anda memplot tingkat permintaan/detik seperti itu, yang mungkin menggunakan rata-rata sebagai agregator, Total dalam legenda tidak akan mewakili jumlah total permintaan. Ini hanya jumlah dari semua titik data yang diterima oleh Grafana yang Dikelola Amazon. 

### Sembunyikan seri
<a name="v9-panels-graph-hide-series"></a>

Sembunyikan seri ketika semua nilai seri dari kueri metrik memiliki nilai tertentu.
+  **Dengan hanya nol - value=null (default** tidak dicentang)
+  **Dengan hanya nol - nilai = nol** (default tidak dicentang)

### Wilayah waktu
<a name="v9-panels-graph-time-regions"></a>

Anda dapat menyorot wilayah waktu tertentu pada grafik untuk membuatnya lebih mudah dilihat, misalnya, akhir pekan, jam kerja, dan jam di luar kerja. Semua wilayah waktu yang dikonfigurasi mengacu pada waktu UTC.

# Panel peta panas
<a name="v9-panels-heatmap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel Heatmap memungkinkan Anda untuk melihat histogram dari waktu ke waktu. Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

## Hitung dari data
<a name="v9-panels-heatmap-calculate"></a>

Pengaturan ini menentukan apakah data sudah merupakan peta panas yang dihitung (dari sumber data/transformator), atau yang harus dihitung di panel.

**Ember X**

Pengaturan ini menentukan bagaimana sumbu X dibagi menjadi ember. Anda dapat menentukan interval waktu di input **Ukuran**. Misalnya, rentang waktu `1h` membuat sel selebar 1 jam pada sumbu X.

**Ember Y**

Pengaturan ini menentukan bagaimana sumbu Y dibagi menjadi ember.

**Skala Bucket Y**

Pilih salah satu skala nilai sumbu Y berikut:
+ **linier** — Skala linier.
+ **log (basis 2)** — Skala logaritmik dengan basis 2.
+ **log (basis 10)** — Skala logaritmik dengan basis 10.

## Sumbu Y
<a name="v9-panels-heatmap-y-axes"></a>

Mendefinisikan bagaimana sumbu Y ditampilkan

 **Penempatan**
+ **Kiri** - Di sebelah kiri
+ **Kanan** - Di sebelah kanan
+ **Tersembunyi** - Tersembunyi

**Satuan**

Konfigurasi unit

**Desimal**

Pengaturan ini menentukan konfigurasi desimal.

**Nilai Min/Maks**

Pengaturan ini mengkonfigurasi rentang sumbu.

**Membalikkan**

Saat dipilih, sumbu muncul dalam urutan terbalik.

## Warna
<a name="v9-panels-heatmap-colors"></a>

Spektrum warna mengontrol pemetaan antara jumlah nilai (di setiap bucket) dan warna yang ditetapkan untuk setiap bucket. Warna paling kiri pada spektrum mewakili jumlah minimum dan warna di sisi paling kanan mewakili jumlah maksimum. Beberapa skema warna secara otomatis terbalik saat menggunakan tema cahaya.

Anda juga dapat mengubah mode warna menjadi Opacity. Dalam hal ini, warnanya tidak akan berubah tetapi jumlah opasitas akan berubah dengan jumlah ember
+ **Modus**
  + **Skema** - Nilai bucket diwakili oleh warna sel.
    + **Skema** — Jika modenya adalah **skema**, maka pilih skema warna.
  + **opacity** — Nilai bucket diwakili oleh opasitas sel. Sel buram berarti nilai maksimum.
    + **Warna - Warna** dasar sel.
    + **Skala** — Skala untuk memetakan nilai bucket ke opacity.
      + **linier** — Skala linier. Nilai bucket memetakan secara linier ke opacity.
      + **sqrt — Skala** daya. Opasitas sel dihitung sebagai`value ^ k`, di mana `k` adalah nilai **Eksponen** yang dikonfigurasi. Jika eksponen kurang dari`1`, Anda akan mendapatkan skala logaritmik. Jika eksponen lebih besar dari`1`, Anda akan mendapatkan skala eksponensial. Dalam hal`1`, skala akan sama dengan linier.
    + **Eksponen — nilai eksponen**, lebih besar dari. `0`

**Mulai/akhir warna dari nilai**

Secara default, Grafana menghitung warna sel berdasarkan nilai bucket minimum dan maksimum. Dengan Min dan Max Anda dapat menimpa nilai-nilai tersebut. Pertimbangkan nilai bucket sebagai sumbu Z dan Min dan Max sebagai Z-Min dan Z-Max, masing-masing.
+ **Mulai** - Nilai minimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket kurang dari Min, maka itu dipetakan ke warna “minimum”. Nilai min seri adalah nilai default.
+ **Akhir** - Nilai maksimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket lebih besar dari Max, maka itu dipetakan ke warna “maksimum”. Nilai maks seri adalah nilai default.

## Tampilan sel
<a name="v9-panels-heatmap-cell"></a>

Gunakan pengaturan tampilan sel untuk menyempurnakan visualisasi sel di peta panas Anda.

## Opsi tampilan tambahan
<a name="v9-panels-heatmap-options"></a>

**Tooltip**
+ **Tampilkan tooltip** - Tampilkan tooltip peta panas.
+ **Tampilkan Histogram - Tampilkan histogram** sumbu Y pada tooltip. Histogram mewakili distribusi nilai bucket untuk stempel waktu tertentu.

**Legenda**

Pilih apakah Anda ingin menampilkan legenda peta panas pada visualisasi.

**Contoh**

Mengatur warna yang digunakan untuk menampilkan data contoh.

# Panel histogram
<a name="v9-panels-histogram"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi histogram menghitung distribusi nilai dan menyajikannya sebagai diagram batang. Sumbu Y dan tinggi setiap batang mewakili jumlah nilai yang termasuk dalam setiap braket sedangkan sumbu X mewakili rentang nilai.

Visualisasi histogram mendukung deret waktu dan hasil tabel apa pun dengan satu atau lebih bidang numerik.

## Format yang didukung
<a name="v9-panels-histogram-formats"></a>

Visualisasi histogram mendukung deret waktu dan hasil tabel apa pun dengan satu atau lebih bidang numerik.

## Opsi tampilan
<a name="v9-panels-histogram-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Ukuran ember**

Ukuran ember. Biarkan ini kosong untuk ukuran ember otomatis (\$1 10% dari rentang penuh).

**Ember offset**

Jika ember pertama tidak harus mulai dari nol. Offset bukan nol menggeser jendela agregasi. Misalnya, ember berukuran 5 yang 0—5, 5—10, 10—15 dengan offset default 0 akan menjadi 2—7, 7—12, 12—17 dengan offset 2; offset 0, 5, atau 10, dalam hal ini, secara efektif tidak akan melakukan apa-apa. Biasanya, opsi ini akan digunakan dengan ukuran bucket yang ditentukan secara eksplisit daripada otomatis. Agar pengaturan ini mempengaruhi, jumlah offset harus lebih besar dari 0 dan kurang dari ukuran bucket; nilai di luar rentang ini akan memiliki efek yang sama dengan nilai dalam rentang ini.

**Gabungkan seri**

Ini akan menggabungkan semua seri dan bidang menjadi histogram gabungan.

**Lebar garis** mengontrol lebar garis bar.

**Fill opacity** mengontrol opasitas isian bilah.

**Mode gradien** mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan Fill opacity.
+  **Tidak ada** - Tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu Y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip** Saat Anda mengarahkan kursor ke grafik, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku:
+  **Single** - Tooltip hover hanya menampilkan seri yang Anda arahkan.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** - Jangan tampilkan tooltip. 

**catatan**  
Gunakan override untuk menyembunyikan seri individual dari tooltip.

## Opsi legenda
<a name="v9-panels-histogram-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Nilai Legenda**

Pilih perhitungan standar mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu. Untuk informasi selengkapnya, lihat [Jenis perhitungan](v9-panels-calculation-types.md).

**Perhitungan legenda**

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.

# Panel log
<a name="v9-panels-logs"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel log menunjukkan baris log dari sumber data yang mendukung log, seperti Elastic, Influx, dan Loki. Biasanya, Anda akan menggunakan panel ini di sebelah panel grafik untuk menampilkan output log dari proses terkait.

Panel log menunjukkan hasil kueri yang dimasukkan pada tab **Kueri**. Hasil dari beberapa kueri digabungkan dan diurutkan berdasarkan waktu. Anda dapat menggulir ke dalam panel jika sumber data mengembalikan lebih banyak baris daripada yang dapat ditampilkan.

Untuk membatasi jumlah baris yang dirender, Anda dapat menggunakan pengaturan **Titik data Maks** dalam **opsi Kueri**. Jika tidak diatur, sumber data biasanya akan memberlakukan batas default.

## Tingkat log
<a name="v9-panels-logs-level"></a>

Untuk log di mana label **level** ditentukan, kami menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, kami mencoba mencari tahu apakah kontennya cocok dengan ekspresi yang didukung (lihat di bawah untuk informasi lebih lanjut). Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang **tidak diketahui**. Untuk informasi selengkapnya, lihat [Visualisasi log](v9-explore-logs.md#v9-explore-logs-viz).

## Rincian log
<a name="v9-panels-logs-details"></a>

Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Setiap bidang atau label memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Tautan data**

Dengan menggunakan tautan data, Anda dapat mengubah bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan yang dibuat terlihat sebagai tombol di bagian **Tautan** di dalam tampilan **detail Log**.

**Opsi tampilan**

Gunakan pengaturan berikut untuk menyempurnakan visualisasi Anda:
+  **Waktu** - Tampilkan atau sembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data.
+  **Label unik** - Tampilkan atau sembunyikan kolom label unik, yang hanya menampilkan label yang tidak umum.
+ **Label umum** - Tampilkan atau sembunyikan label umum
+  **Garis bungkus** - Alihkan pembungkus garis. 
+ **Prettify JSON** - Atur ini `true` untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON.
+ **Aktifkan detail log** - Beralih opsi untuk melihat tampilan detail log untuk setiap baris log. Pengaturan default-nya adalah `true`.
+  **Urutan** - Menampilkan hasil dalam urutan waktu turun atau naik. Defaultnya adalah **Descending**, menampilkan log terbaru terlebih dahulu. Setel ke **Ascending** untuk menampilkan baris log tertua terlebih dahulu.

# Panel berita
<a name="v9-panels-news"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel ini menampilkan umpan RSS. Secara default, ini menampilkan artikel dari blog Grafana Labs.

Masukkan URL RSS di bagian **Tampilan**. Jenis panel ini tidak menerima pertanyaan lain.

**catatan**  
Umpan RSS dimuat oleh ujung depan Grafana tanpa proxy. Akibatnya, hanya umpan RSS yang dikonfigurasi dengan [header CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) yang sesuai yang akan dimuat. Jika umpan RSS yang Anda coba tampilkan gagal dimuat, pertimbangkan untuk menghosting ulang umpan RSS atau membuat proxy Anda sendiri.

# Panel grafik simpul
<a name="v9-panels-node-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel grafik simpul memvisualisasikan grafik atau jaringan yang diarahkan. Ini menggunakan tata letak gaya terarah untuk memposisikan node secara efektif sehingga dapat membantu menampilkan peta infrastruktur yang kompleks, hierarki, atau menjalankan diagram.

## Persyaratan data
<a name="v9-panels-node-graph-requirements"></a>

Panel grafik node membutuhkan bentuk data tertentu untuk dapat menampilkan node dan tepinya. Tidak semua sumber data atau kueri dapat divisualisasikan di panel ini.

Visualisasi grafik Node terdiri dari *node* dan *tepi*.
+ Sebuah *node* ditampilkan sebagai lingkaran. Sebuah node mungkin mewakili aplikasi, layanan, atau apa pun yang relevan dari perspektif aplikasi.
+ *Tepi* ditampilkan sebagai garis yang menghubungkan dua node. Koneksi mungkin permintaan, operasi, atau hubungan lain antara dua node.

Baik node dan edge dapat memiliki metadata atau statistik terkait. Sumber data mendefinisikan informasi dan nilai apa yang ditampilkan, sehingga sumber data yang berbeda dapat menunjukkan jenis nilai yang berbeda atau tidak menunjukkan beberapa nilai.

## Node
<a name="v9-panels-node-graph-nodes"></a>

Biasanya, node menunjukkan dua nilai statistik di dalam node dan dua pengidentifikasi tepat di bawah node, biasanya nama dan jenis. Node juga dapat menunjukkan set nilai lain sebagai lingkaran warna di sekitar node, dengan bagian warna yang berbeda mewakili nilai yang berbeda yang harus menambahkan hingga 1. Misalnya, Anda dapat memiliki persentase kesalahan yang diwakili oleh bagian merah dari lingkaran.

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

**catatan**  
Grafik node hanya dapat menampilkan 1.500 node. Jika batas ini dilintasi, peringatan terlihat di sudut kanan atas, dan beberapa node akan disembunyikan. Anda dapat memperluas bagian tersembunyi dari grafik dengan mengklik penanda **node tersembunyi** dalam grafik.

## Tepi
<a name="v9-panels-node-graph-edges"></a>

Tepi juga dapat menunjukkan statistik saat Anda mengarahkan kursor ke tepi. Mirip dengan node, Anda dapat membuka menu konteks dengan detail dan tautan tambahan dengan memilih tepi.

Sumber data pertama yang mendukung visualisasi ini adalah sumber AWS X-Ray data untuk fitur peta layanannya. Untuk informasi selengkapnya, lihat [Connect ke sumber AWS X-Ray data](x-ray-data-source.md).

## Menavigasi grafik simpul
<a name="v9-panels-node-graph-navigation"></a>

Anda dapat menggeser dalam grafik simpul dengan memilih di luar node atau tepi mana pun dan menyeret pointer.

Anda dapat memperbesar dengan menggunakan tombol di sudut kiri atas grafik simpul.

**Node tersembunyi**

Jumlah node yang ditampilkan pada waktu tertentu terbatas untuk mempertahankan kinerja yang wajar. Node yang berada di luar batas ini tersembunyi di balik penanda yang dapat diklik yang menunjukkan perkiraan jumlah node tersembunyi yang terhubung ke tepi itu. Anda dapat memilih penanda untuk memperluas grafik di sekitar simpul itu.

**Tampilan kisi**

Anda dapat beralih ke tampilan grid untuk memiliki gambaran yang lebih baik dari node yang paling menarik dalam grafik. Tampilan grid menunjukkan node dalam grid tanpa tepi dan dapat diurutkan berdasarkan statistik yang ditunjukkan di dalam node atau oleh statistik yang diwakili oleh batas berwarna dari node.

Untuk mengurutkan node, pilih statistik di dalam legenda. Penanda di sebelah nama stat menunjukkan stat mana yang saat ini digunakan untuk menyortir dan menyortir arah.

Pilih node dan kemudian **Tampilkan dalam tata letak Grafik** opsi untuk beralih kembali ke tata letak grafik dengan fokus pada simpul yang dipilih, untuk menunjukkannya dalam konteks grafik lengkap.

## Data API
<a name="v9-panels-node-graph-data-api"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Grafik Node minimal membutuhkan bingkai data yang menggambarkan tepi grafik. Secara default, grafik node akan menghitung node dan statistik apa pun berdasarkan bingkai data ini. Secara opsional, bingkai data kedua yang menjelaskan node dapat dikirim jika ada kebutuhan untuk menampilkan metadata spesifik node yang lebih spesifik. Anda harus mengatur `frame.meta.preferredVisualisationType = 'nodeGraph'` pada kedua frame data atau menamainya `nodes` dan `edges` masing-masing untuk grafik node untuk dirender.

**Tepi data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  id  |  string  |  Pengidentifikasi unik tepi.  | 
|  sumber  |  string  |  Id dari simpul sumber.  | 
|  target  |  string  |  Id dari target.  | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  mainstat  |  string/nomor  |  Stat pertama ditampilkan di overlay saat melayang di atas tepi. Ini bisa berupa string yang menunjukkan nilai apa adanya atau bisa berupa angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan  | 
|  Secondarystat  |  string/nomor  |  Sama seperti MainStat, tetapi ditampilkan tepat di bawahnya.  | 
|  detail\$1\$1\$1  |  string/nomor  |  Bidang apa pun yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik di tepi. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia.  | 

**Node data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  id  |  string  |  Pengidentifikasi unik dari node. ID ini direferensikan oleh edge di bidang sumber dan targetnya.  | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  title  |  string  |  Nama node terlihat tepat di bawah node.  | 
|  subjudul  |  string  |  Tambahan, nama, jenis atau pengenal lain yang ditampilkan di bawah judul.  | 
|  mainstat  |  string/nomor  |  Stat pertama ditampilkan di dalam node itu sendiri. Ini bisa berupa string yang menunjukkan nilai apa adanya atau angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan.  | 
|  Secondarystat  |  string/nomor  |  Sama seperti MainStat, tetapi ditampilkan di bawahnya di dalam node.  | 
|  busur\$1\$1\$1  |  number  |  Setiap bidang yang diawali dengan `arc__` akan digunakan untuk membuat lingkaran warna di sekitar node. Semua nilai dalam bidang ini harus menambahkan hingga 1. Anda dapat menentukan warna menggunakan`config.color.fixedColor`.  | 
|  detail\$1\$1\$1  |  string/nomor  |  Setiap bidang yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik pada node. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia.  | 

# Panel bagan pai
<a name="v9-panels-piechart"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Diagram lingkaran menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, dalam bentuk irisan kue. Panjang busur, luas dan sudut tengah irisan semuanya sebanding dengan nilai irisan, karena berkaitan dengan jumlah semua nilai. Jenis bagan ini paling baik digunakan ketika Anda menginginkan perbandingan cepat dari serangkaian kecil nilai dalam bentuk yang menyenangkan secara estetika.

## Opsi nilai
<a name="v9-panels-piechart-value"></a>

Gunakan opsi berikut untuk menyempurnakan nilai dalam visualisasi Anda.

**Tampilkan**

Pilih berapa banyak informasi yang akan ditampilkan.
+ **Hitung** — Mengurangi setiap nilai menjadi satu nilai per seri.
+ **Semua nilai** - Menampilkan setiap nilai dari satu seri.

**Perhitungan**

Pilih perhitungan untuk mengurangi setiap seri saat Hitung telah dipilih. Untuk informasi tentang perhitungan yang tersedia, lihat [Jenis perhitungan](v9-panels-calculation-types.md).

**Batasi**

Saat menampilkan setiap nilai dari satu seri, ini membatasi jumlah nilai yang ditampilkan.

**Bidang**

Pilih bidang atau bidang mana yang akan ditampilkan dalam visualisasi. Setiap nama bidang tersedia dalam daftar, atau Anda dapat memilih salah satu opsi berikut:
+ **Bidang numerik** - Semua bidang dengan nilai numerik.
+ **Semua bidang** — Semua bidang yang tidak dihapus oleh transformasi.
+ **Waktu** - Semua bidang dengan nilai waktu.

## Opsi diagram lingkaran
<a name="v9-panels-piechart-options"></a>

Gunakan opsi ini untuk menyempurnakan tampilan visualisasi Anda.

**Jenis diagram pai**

Pilih gaya tampilan diagram lingkaran. Bisa berupa:
+ **Pie** — Bagan lingkaran standar
+ **Donat** — Diagram lingkaran dengan lubang di tengah

**Label**

Pilih label untuk ditampilkan pada diagram lingkaran. Anda dapat memilih lebih dari satu.
+ **Nama - Nama** seri atau bidang.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Label ditampilkan dalam warna putih di atas badan bagan secara default. Anda dapat memilih warna grafik yang lebih gelap untuk membuatnya lebih terlihat. Nama atau angka panjang mungkin terpotong.

**Mode Tooltip**

Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+ **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+ **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+ **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

Gunakan override untuk menyembunyikan seri individual dari tooltip.

**Mode legenda**

Gunakan pengaturan ini untuk menentukan bagaimana legenda muncul dalam visualisasi Anda. Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v9-panels-configure-legend.md).
+ **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+ **Tabel** - Menampilkan legenda sebagai tabel.
+ **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda**

Pilih tempat untuk menampilkan legenda.
+ **Bawah** - Di bawah grafik.
+ **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v9-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

Pilih nilai yang akan ditampilkan dalam legenda. Anda dapat memilih lebih dari satu.
+ **Persentase** — Persentase keseluruhan.
+ **Nilai — Nilai** numerik mentah.

Untuk informasi selengkapnya tentang legenda, lihat [Mengonfigurasi legenda](v9-panels-configure-legend.md).

# Panel yang cepat
<a name="v9-panels-plotly"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel Plotly merender bagan menggunakan [Plotly, pustaka](https://plotly.com/javascript/) grafik javascript open source.

Bidang **Data**, **Layout**, dan **Config** cocok dengan parameter umum yang dijelaskan dalam dokumentasi [Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Mereka harus dalam format JSON.

Data yang disediakan oleh sumber data dapat diubah melalui skrip yang ditentukan pengguna sebelum disuntikkan dalam bagan Plotly. Skrip ini mencakup 2 argumen.
+ `data`— Data yang dikembalikan oleh sumber data.
+ `variables`— Objek yang berisi [variabel Grafana](templates-and-variables.md) di dasbor saat ini (variabel pengguna dan beberapa variabel global ini:`__from`,, `__to``__interval`, dan`__interval_ms`).

Script harus mengembalikan objek dengan satu atau lebih properti berikut:`data`,`layout`, `config` dan`frames`. Berikut adalah contohnya.

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

Objek yang dikembalikan oleh skrip dan JSON yang disediakan di bidang *Data*, *Layout* dan *Config* akan digabungkan (deep merge).

Jika tidak ada skrip yang disediakan, panel hanya akan menggunakan bidang *Data*, *Layout* dan *Config*.

# Panel Sankey
<a name="v9-panels-sankey"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel Sankey menunjukkan diagram Sankey, yang bagus untuk memvisualisasikan data aliran, dengan lebar aliran sebanding dengan metrik yang dipilih. Gambar berikut menunjukkan diagram Sankey dengan dua kelompok sumber dan tujuan.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/sankey-panel.png)


**Cara kerjanya**

Panel sankey membutuhkan setidaknya 2 kolom data, sumber dan tujuan untuk aliran. Kueri Anda harus mengelompokkan data Anda ke dalam setidaknya dua grup. Panel akan menggambar tautan dari kolom pertama titik data, ke yang terakhir dalam urutan kueri. Ketebalan tautan akan sebanding dengan nilai yang ditetapkan oleh metrik dalam kueri.

**Menyesuaikan**
+ **Tautan** - Saat ini ada dua opsi untuk warna tautan: multi atau tunggal. Ini multi-warna secara default. Untuk memilih satu warna untuk tautan, alihkan opsi warna **Single Link saja dan pilih warna** Anda dari pemilih warna Grafana.
+ **Node** - Anda dapat mengubah warna node persegi panjang dengan mengubah opsi **warna Node**
+ **Lebar Node** - Lebar node dapat disesuaikan dengan slider **Lebar Node** atau memasukkan angka di kotak input. Angka ini harus berupa bilangan bulat.
+ **Node Padding** — Padding vertikal antar node dapat disesuaikan dengan slider **Node Padding** atau memasukkan angka di kotak input. Angka ini harus berupa bilangan bulat. Jika tautan Anda terlalu tipis, coba sesuaikan nomor ini
+ **Header** - Header kolom dapat diubah dengan menggunakan penggantian **Nama Tampilan** di panel editor. Mereka akan menjadi warna yang sama yang Anda pilih untuk **warna Teks**
+ **Sankey Layout** - Tata letak tautan Sankey dapat disesuaikan sedikit menggunakan slider **iterasi Layout**. Angka ini harus berupa bilangan bulat dan merupakan jumlah iterasi relaksasi yang digunakan untuk menghasilkan tata letak.

# Panel pencar
<a name="v9-panels-scatter"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel pencar menunjukkan plot X/Y pencar untuk data tabel dengan antarmuka yang lebih sederhana daripada panel grafik lainnya. Berbeda dengan panel grafik, panel pencar tidak memerlukan data untuk berada dalam deret waktu. Panel pencar membutuhkan dataset yang diformat tabel dengan dua atau lebih kolom numerik data.

Salah satunya dapat ditetapkan ke sumbu X. Satu atau lebih dapat ditetapkan ke serangkaian nilai sumbu Y dan data yang dihasilkan diplot sebagai serangkaian titik. Setiap seri secara opsional juga dapat menunjukkan garis regresi menggunakan salah satu dari sejumlah kecocokan statistik terbaik.

**Membuat panel pencar**

Prosedur berikut menjelaskan cara membuat plot pencar menggunakan panel pencar. Untuk contoh ini, kita akan mengasumsikan bahwa ada data, seperti pada tabel berikut yang disebut `HEIGHT` dengan tiga kolom nilai numerik,`Age`,`Boys`, dan`Girls`, menunjukkan tinggi rata-rata anak laki-laki dan perempuan berdasarkan usia.


| Umur | Tinggi Anak Laki-Laki | Tinggi Gadis | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121.1  |  120,8  | 
|  8  |  126.3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152.6  | 
|  14  |  159,9  |  155.1  | 
|  15  |  164.4  |  156,7  | 
|  16  |  167.3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Untuk membuat plot pencar dengan panel pencar**

1. Di dasbor Grafana Anda, pilih **Tambah** Panel.

1. Untuk Query, tulis kueri yang akan mengembalikan data yang dibutuhkan. Dalam hal ini, Anda akan menggunakan kueri seperti`SELECT * FROM HEIGHT`.

1. Pilih visualisasi **Scatter**.

Ini akan membuat plot pencar, menggunakan kolom pertama sebagai sumbu X, dan kolom numerik lainnya sebagai sumbu Y.

**Opsi konfigurasi**

Panel pencar menyediakan empat opsi konfigurasi kustom berikut.
+ **Sumbu X** - Anda dapat memilih bidang mana yang akan digunakan sebagai sumbu X, serta luas dan judul dan informasi tampilan untuk sumbu.
+ **Sumbu Y** - Anda dapat memilih bidang mana yang akan ditampilkan pada sumbu Y, termasuk opsi tampilan untuk setiap bidang, dan informasi perluasan dan judul untuk sumbu. Anda juga dapat memilih untuk menampilkan garis regresi untuk setiap bidang. Lihat informasi berikut untuk detail selengkapnya tentang konfigurasi garis regresi.
+ **Legenda** — Anda dapat mengaktifkan atau menonaktifkan legenda untuk panel, serta memilih ukuran teks dalam legenda.
+ **Tampilan** - Anda dapat mengatur opsi lain untuk bagan, termasuk warna kisi dan gaya perbatasan.

**Konfigurasi garis regresi**

Setiap dataset sumbu Y dapat menampilkan garis, selain titik-titik individual. Ada lima opsi untuk jenis garis.
+ **Tidak ada** - Jangan menampilkan garis regresi.
+ **Sederhana** — Menampilkan garis regresi yang menghubungkan titik dataset.
+ **Linear** - Menampilkan garis lurus, menggunakan kuadrat terkecil, metode yang paling cocok.
+ **Eksponensial** - Menampilkan garis regresi paling cocok eksponensial.
+ **Daya** - Menampilkan garis regresi yang paling sesuai dengan daya.

# Panel stat
<a name="v9-panels-stat"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel Stat menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau warna nilai menggunakan ambang batas.

Secara default, panel Stat menampilkan salah satu dari berikut ini:
+ Hanya nilai untuk satu seri atau bidang.
+ Baik nilai dan nama untuk beberapa seri atau bidang.

Anda dapat menggunakan **mode Teks** untuk mengontrol apakah teks ditampilkan atau tidak.

## Penyesuaian tata letak otomatis
<a name="v9-panels-stat-automatic-adjust"></a>

Panel secara otomatis menyesuaikan tata letak tergantung pada lebar dan tinggi yang tersedia di dasbor. Secara otomatis menyembunyikan grafik (sparkline) jika panel menjadi terlalu kecil.

## Opsi nilai
<a name="v9-panels-stat-value"></a>

Gunakan opsi berikut untuk menyempurnakan bagaimana visualisasi Anda menampilkan nilai:

**Tampilkan**

Pilih cara Grafana menampilkan data Anda.

**Hitung**

Tampilkan nilai yang dihitung berdasarkan semua baris.
+ **Perhitungan** — Pilih fungsi peredam yang akan digunakan Grafana untuk mengurangi banyak bidang menjadi satu nilai. Untuk daftar perhitungan yang tersedia, lihat [perhitungan standar](v9-panels-calculation-types.md).
+ **Bidang** - Pilih tampilan bidang di panel.

**Semua nilai**

Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, maka Anda juga dapat membatasi jumlah baris yang akan ditampilkan.
+ **Batas** — Jumlah maksimum baris yang akan ditampilkan. Defaultnya adalah 5.000.
+ **Bidang** - Pilih tampilan bidang di panel.

## Gaya stat
<a name="v9-panels-stat-styles"></a>

Gaya visualisasi Anda.

**Orientasi**

Pilih arah susun.
+ **Otomatis** — Grafana memilih apa yang dianggapnya sebagai orientasi terbaik.
+ **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
+ **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.

**Mode teks**

Anda dapat menggunakan opsi mode Teks untuk mengontrol teks apa yang dirender panel. Jika nilainya tidak penting, hanya nama dan warnanya, lalu ubah **mode Teks** menjadi **Nama**. Nilai akan tetap digunakan untuk menentukan warna dan ditampilkan dalam tooltip.
+ **Otomatis** - Jika data berisi beberapa seri atau bidang, tampilkan nama dan nilai.
+ **Nilai** - Tampilkan hanya nilai, jangan pernah nama. Nama ditampilkan di tooltip hover sebagai gantinya.
+ **Nilai dan nama** — Selalu tunjukkan nilai dan nama.
+ **Nama** - Tampilkan nama, bukan nilai. Nilai ditampilkan di tooltip hover.
+ **Tidak ada** - Tidak menunjukkan apa-apa (kosong). Nama dan nilai ditampilkan di tooltip hover.

**Mode warna**

Pilih mode warna.
+ **Nilai** - Warna hanya nilai dan area grafik.
+ **Latar Belakang** - Warna latar belakang juga.

**Modus grafik**

Pilih grafik dan mode sparkline.
+ **Tidak ada** - Menyembunyikan grafik dan hanya menunjukkan nilainya.
+ **Area** - Menunjukkan grafik area di bawah nilai. Ini mengharuskan kueri Anda mengembalikan kolom waktu.

**Penjajaran teks**

Pilih mode penyelarasan.
+ **Otomatis** - Jika hanya satu nilai yang ditampilkan (tidak ada pengulangan), maka nilainya terpusat. Jika beberapa seri atau baris ditampilkan, maka nilainya sejajar kiri.
+ **Pusat** — Nilai Stat terpusat.

Ukuran teks

Sesuaikan ukuran teks pengukur.
+ **Judul** — Masukkan nilai numerik untuk ukuran judul gauge.
+ **Nilai** - Masukkan nilai numerik untuk ukuran nilai pengukur.

# Panel garis waktu negara
<a name="v9-panels-state-timeline"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel timeline status menunjukkan perubahan status diskrit dari waktu ke waktu. Setiap bidang atau seri dirender sebagai pita horisontal yang unik. Wilayah negara bagian dapat dirender dengan atau tanpa nilai. Panel ini bekerja dengan baik dengan status string atau boolean tetapi juga dapat digunakan dengan deret waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

## Opsi garis waktu negara
<a name="v9-panels-state-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Gabungkan nilai berurutan yang sama**

Mengontrol apakah Grafana menggabungkan nilai yang identik jika keduanya bersebelahan.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam wilayah negara bagian. Otomatis akan merender nilai jika ada ruang yang cukup.

**Sejajarkan nilai**

Mengontrol penyelarasan nilai di dalam wilayah negara bagian.

**Tinggi baris**

Mengontrol ruang antar baris. 1 = tidak ada spasi = 0,5 = 50% ruang.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas wilayah negara bagian.

## Pemetaan nilai
<a name="v9-panels-state-timeline-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v9-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v9-panels-state-timeline-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mengubah deret waktu menjadi daerah keadaan berwarna diskrit.

## Opsi legenda
<a name="v9-panels-state-timeline-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah Opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v9-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Panel riwayat status
<a name="v9-panels-status-history"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi riwayat Status menunjukkan keadaan periodik dari waktu ke waktu. Setiap bidang atau seri dirender sebagai baris horizontal. Kotak dirender dan dipusatkan di sekitar setiap nilai.

Visualisasi riwayat status bekerja dengan string, boolean, dan bidang numerik atau deret waktu. Diperlukan bidang waktu. Anda dapat menggunakan pemetaan nilai untuk mewarnai string atau menetapkan nilai teks ke rentang numerik.

## Opsi tampilan
<a name="v9-panels-status-history-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam kotak nilai. Otomatis akan merender nilai jika ada ruang yang cukup.

**Lebar kolom** mengontrol lebar kotak. 1 = maks dan 0 = lebar Min.

**Lebar garis** mengontrol lebar garis wilayah negara bagian.

**Fill opacity** mengontrol opasitas pengisian wilayah negara bagian.

## Pemetaan nilai
<a name="v9-panels-status-history-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Konfigurasikan pemetaan nilai](v9-panels-configure-value-mappings.md)

## Data deret waktu dengan ambang batas
<a name="v9-panels-status-history-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mewarnai kotak. Anda juga dapat menggunakan skema warna gradien untuk mewarnai nilai.

## Opsi legenda
<a name="v9-panels-status-history-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah Opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Nilai legenda**

Pilih [perhitungan standar](v9-panels-calculation-types.md) mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

# Panel meja
<a name="v9-panels-table"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Visualisasi panel tabel sangat fleksibel, mendukung beberapa mode untuk deret waktu dan untuk tabel, anotasi, dan data JSON mentah. Panel ini juga menyediakan pemformatan tanggal, pemformatan nilai, dan opsi pewarnaan.

## Kolom urutkan
<a name="v9-panels-table-sort"></a>

Klik judul kolom untuk mengubah urutan pengurutan dari default menjadi turun ke naik. Setiap kali Anda mengklik, urutan pengurutan berubah ke opsi berikutnya dalam siklus. Anda hanya dapat mengurutkan berdasarkan satu kolom pada satu waktu.

## Opsi tabel
<a name="v9-panels-table-options"></a>

**Tampilkan header**

Tampilkan atau sembunyikan nama kolom yang diimpor dari sumber data Anda.

## Lebar kolom
<a name="v9-panels-table-width"></a>

Secara default, Grafana secara otomatis menghitung lebar kolom berdasarkan ukuran tabel dan lebar kolom minimum. Opsi bidang ini dapat mengganti pengaturan dan menentukan lebar untuk semua kolom dalam piksel.

Misalnya, jika Anda masuk `100` di bidang, maka ketika Anda mengklik di luar bidang, semua kolom akan diatur ke lebar 100 piksel.

## Lebar kolom minimum
<a name="v9-panels-table-min"></a>

Secara default, lebar minimum kolom tabel adalah 150 piksel. Opsi bidang ini dapat mengganti default itu dan akan menentukan lebar kolom minimum baru untuk panel tabel dalam piksel.

Misalnya, jika Anda masuk `75` di bidang, maka ketika Anda mengklik di luar bidang, semua kolom akan skala tidak lebih kecil dari 75 piksel lebar.

Untuk perangkat layar kecil, seperti ponsel cerdas atau tablet, kurangi nilai `150` piksel default `50` agar panel berbasis tabel dapat dirender dengan benar di dasbor.

## Penyelarasan kolom
<a name="v9-panels-table-alignment"></a>

Pilih bagaimana Grafana harus menyelaraskan isi sel:
+ Otomatis (default)
+ Kiri
+ Pusat
+ Kanan

## Jenis sel
<a name="v9-panels-table-cell-type"></a>

Secara default, Grafana secara otomatis memilih pengaturan tampilan. Anda dapat mengganti pengaturan dengan memilih salah satu opsi berikut untuk mengatur default untuk semua bidang. Konfigurasi tambahan tersedia untuk beberapa jenis sel.

**catatan**  
Jika Anda mengatur ini di tab **Bidang**, maka jenis akan berlaku untuk semua bidang, termasuk bidang waktu. Anda dapat mengaturnya di tab **Override** untuk menerapkan perubahan ke satu atau beberapa bidang.

**Teks warna**

Jika ambang batas ditetapkan, maka teks bidang ditampilkan dalam warna ambang batas yang sesuai.

**Latar belakang warna (gradien atau padat)**

Jika ambang batas ditetapkan, maka latar belakang bidang ditampilkan dalam warna ambang batas yang sesuai.

**Gauge**

Sel dapat ditampilkan sebagai pengukur grafis, dengan beberapa jenis presentasi yang berbeda.

**Basic**

Mode dasar akan menunjukkan pengukur sederhana dengan tingkat ambang batas yang menentukan warna pengukur.

**Gradien**

Tingkat ambang batas menentukan gradien.

**LCD**

Pengukur dibagi dalam sel-sel kecil yang menyala atau tidak menyala.

**Tampilan JSON**

Menampilkan nilai diformat sebagai kode. Jika nilai adalah objek tampilan JSON memungkinkan browsing objek JSON akan muncul di hover.

## Periksa nilai sel
<a name="v9-panels-table-cell-value"></a>

Memungkinkan pemeriksaan nilai dari sel tabel. Nilai mentah disajikan dalam jendela modal.

**catatan**  
Pemeriksaan nilai sel hanya tersedia ketika mode tampilan sel diatur ke Otomatis, Teks warna, latar belakang warna atau Tampilan JSON.

## Filter kolom
<a name="v9-panels-table-col-filter"></a>

Anda dapat mengubah sementara bagaimana data kolom ditampilkan. Misalnya, Anda dapat mengurutkan nilai dari tertinggi ke terendah atau menyembunyikan nilai tertentu. Untuk informasi selengkapnya, lihat [Filter kolom tabel](#v9-panels-table-filter), di bawah ini.

## Paginasi
<a name="v9-panels-table-pagination"></a>

Gunakan opsi ini untuk mengaktifkan atau menonaktifkan pagination. Ini adalah opsi front-end yang tidak memengaruhi kueri. Saat diaktifkan, ukuran halaman secara otomatis menyesuaikan dengan ketinggian tabel.

## Filter kolom tabel
<a name="v9-panels-table-filter"></a>

Jika Anda mengaktifkan **filter Kolom**, maka Anda dapat memfilter opsi tabel.

**Untuk mengaktifkan pemfilteran kolom**

1. Di Grafana, arahkan ke dasbor dengan tabel dengan kolom yang ingin Anda filter.

1. Pada panel tabel yang ingin Anda filter, buka editor panel.

1. Pilih tab **Bidang**.

1. Dalam opsi **Tabel**, nyalakan opsi **Filter kolom**.

Ikon filter muncul di sebelah setiap judul kolom.

**Filter nilai kolom**

Untuk memfilter nilai kolom, pilih ikon filter (corong) di sebelah judul kolom. Grafana menampilkan opsi filter untuk kolom itu.

Pilih kotak centang di sebelah nilai yang ingin Anda tampilkan. Masukkan teks di bidang pencarian di bagian atas untuk menampilkan nilai-nilai tersebut di layar sehingga Anda dapat memilihnya daripada menggulir untuk menemukannya.

**Hapus filter kolom**

Kolom dengan filter yang diterapkan memiliki corong biru yang ditampilkan di sebelah judul.

Untuk menghapus filter, pilih ikon corong biru dan kemudian pilih Hapus filter.

## Footer meja
<a name="v9-panels-table-footer"></a>

Anda dapat menggunakan footer tabel untuk menampilkan [perhitungan](v9-panels-calculation-types.md) pada bidang.

Setelah Anda mengaktifkan footer tabel, Anda dapat memilih **Perhitungan**, dan kemudian **Bidang** yang ingin Anda hitung.

Sistem menerapkan perhitungan ke semua bidang numerik jika Anda tidak memilih bidang.

**Hitung baris**

Jika Anda ingin menampilkan jumlah baris dalam kumpulan data alih-alih jumlah nilai di bidang yang dipilih, pilih **Hitung perhitungan dan aktifkan Hitung** **baris**.

# Panel teks
<a name="v9-panels-text"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel teks memungkinkan Anda untuk secara langsung memasukkan teks atau HTML di dasbor Anda. Ini dapat digunakan untuk menambahkan informasi kontekstual dan deskripsi atau menanamkan HTML kompleks.

**Modus**

Mode menentukan bagaimana konten yang disematkan muncul. Ini memiliki opsi berikut
+ **Markdown** - Opsi ini memformat konten sebagai penurunan harga.
+ **HTML** - Pengaturan ini membuat konten sebagai HTML yang disanitasi.
+ **Kode** - Pengaturan ini membuat konten di dalam editor kode read-only. Pilih bahasa yang sesuai untuk menerapkan penyorotan sintaks ke teks yang disematkan.

**Variabel**

Variabel dalam konten akan diperluas untuk ditampilkan.

# Panel deret waktu
<a name="v9-panels-time-series"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel deret waktu dapat membuat deret waktu sebagai garis, jalur titik, atau serangkaian batang. Jenis grafik ini cukup serbaguna untuk menampilkan hampir semua data deret waktu.

**catatan**  
Anda dapat memigrasikan visualisasi panel Grafik ke visualisasi deret Waktu. Untuk bermigrasi, pada tab **Panel**, pilih **Visualisasi deret waktu**. Grafana mentransfer semua pengaturan yang berlaku.

**Topics**
+ [Opsi tooltip](v9-time-series-panel-tooltip.md)
+ [Opsi legenda](v9-time-series-panel-legend.md)
+ [Opsi gaya grafik](v9-time-series-graph.md)
+ [Opsi sumbu](v9-time-series-axis.md)
+ [Pilihan warna](v9-time-series-color.md)

# Opsi tooltip
<a name="v9-time-series-panel-tooltip"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Saat Anda mengarahkan kursor ke grafik, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku:
+  **Single** - Tooltip hover hanya menampilkan seri yang Anda arahkan.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam grafik. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** - Jangan tampilkan tooltip. 

# Opsi legenda
<a name="v9-time-series-panel-legend"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

**Mode legenda** — Pilih bagaimana legenda muncul.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah opsi default.
+  **Tabel** - Menampilkan legenda sebagai tabel. 
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** — Pilih tempat untuk menampilkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik. 

**Perhitungan legenda**

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Lihat informasi yang lebih lengkap di [Jenis perhitungan](v9-panels-calculation-types.md).

# Opsi gaya grafik
<a name="v9-time-series-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

**Gaya grafik**

Gunakan opsi ini untuk menentukan cara menampilkan data deret waktu Anda. Anda dapat menggunakan penggantian untuk menggabungkan beberapa gaya dalam grafik yang sama. Ada tiga pilihan gaya. Beberapa opsi gaya lainnya hanya berlaku untuk gaya grafik tertentu.
+ **Garis** — Menampilkan deret waktu sebagai garis pada grafik.
+ **Bar** — Menampilkan deret waktu sebagai serangkaian batang pada grafik, satu untuk setiap titik data.
+ **Poin** — Menampilkan deret waktu sebagai titik pada grafik, satu untuk setiap titik data.

**Penjajaran batang**

Untuk grafik batang,, atur posisi batang, relatif terhadap titik yang akan digambar pada grafik. Karena sebuah bar memiliki lebar, maka dapat ditempatkan sebelum, sesudah, atau dipusatkan pada titik. Pilihan untuk opsi ini adalah **Sebelum**, **Tengah**, atau **Setelah**.

**Lebar garis**

Mengatur ketebalan garis untuk grafik Garis, atau ketebalan garis besar untuk setiap batang dalam grafik batang.

**Isi opacity**

Mengatur opasitas warna isian. Isi digunakan, misalnya, untuk menunjukkan area di bawah garis dalam grafik garis, atau sebagai warna batang dalam grafik batang.

**Mode gradien**

Mode gradien menentukan isi gradien, yang didasarkan pada warna seri. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Untuk informasi selengkapnya, lihat [Skema warna](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme). Opsi mode gradien adalah:
+ **Tidak ada** - Tidak ada pengisian gradien.
+ **Opacity** — Gradien opasitas di mana opasitas isian meningkat seiring dengan meningkatnya nilai sumbu Y.
+ **Hue** — Gradien yang didasarkan pada rona warna seri.
+ **Skema** - Gradien warna yang ditentukan oleh skema warna Anda. Pengaturan ini dapat digunakan oleh isian dan garis. Untuk informasi selengkapnya, lihat [Pilihan warna](v9-time-series-color.md).

Tampilan gradien juga dimodifikasi oleh pengaturan **Fill opacity**. 

**Tampilkan poin**

Anda dapat mengonfigurasi visualisasi Anda untuk menambahkan titik ke grafik garis atau batang. Anda dapat memilih **Selalu**, **Tidak Pernah**, atau **Otomatis**. Saat menggunakan **Otomatis**, Grafana menentukan apakah akan menunjukkan titik berdasarkan kepadatan data. Jika kepadatan data cukup rendah, poin ditampilkan.

**Ukuran titik**

Mengatur ukuran titik yang ditarik, dari diameter 1 hingga 40 piksel.

**Interpolasi garis**

Pilih bagaimana Grafana menginterpolasi garis seri. Pilihannya adalah **Linear**, **Smooth**, **Step before**, dan **Step after**.

**Gaya garis**

Atur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

Tampilan gaya garis dipengaruhi oleh pengaturan untuk **Lebar garis** dan **opasitas Isi**.

Pilihan untuk gaya garis adalah **Solid**, **Dash**, dan **Dots**.

**Connect nilai null**

Pilih bagaimana nilai nol (celah dalam data) muncul pada grafik. Nilai nol dapat dihubungkan untuk membentuk garis kontinu atau, secara opsional, menetapkan ambang batas di mana celah dalam data seharusnya tidak lagi terhubung. Anda dapat memilih untuk **Jangan pernah** menghubungkan titik data dengan celah, **Selalu** sambungkan titik data dengan celah, atau atur **Ambang batas** di mana celah dalam data seharusnya tidak lagi terhubung.

**Seri tumpukan**

*Penumpukan* memungkinkan Grafana untuk menampilkan seri di atas satu sama lain. Berhati-hatilah saat menggunakan penumpukan dalam visualisasi karena dapat dengan mudah membuat grafik yang menyesatkan. Untuk membaca lebih lanjut tentang mengapa penumpukan mungkin bukan pendekatan terbaik, lihat [Masalah dengan Penumpukan](https://www.data-to-viz.com/caveat/stacking.html).

Opsi untuk menumpuk adalah:
+ **Mati** — Mematikan susun seri.
+ **Normal** — Seri tumpukan di atas satu sama lain.
+ **100%** - Tumpuk berdasarkan persentase, di mana semua seri bersama-sama menambahkan hingga 100%.

**Seri tumpukan dalam kelompok**

Anda dapat mengganti perilaku penumpukan untuk menumpuk seri dalam grup. Untuk informasi selengkapnya tentang membuat override, lihat[Konfigurasikan penggantian bidang](v9-panels-configure-overrides.md). Saat membuat override, beri nama grup susun yang Anda inginkan untuk menjadi bagian dari seri.

**Isi di bawah ini untuk**

Opsi **Isi di bawah untuk** mengisi area antara dua seri. Opsi ini hanya tersedia sebagai penggantian seri atau bidang. Dengan menggunakan opsi ini Anda dapat mengisi area antara dua seri, bukan dari garis seri ke 0. Misalnya, jika Anda memiliki dua seri yang disebut *Max* dan *Min*, Anda dapat memilih seri **Max** dan menggantinya ke **Fill di bawah ini ke** seri **Min**.. Ini hanya akan mengisi area antara dua baris seri.

# Opsi sumbu
<a name="v9-time-series-axis"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Opsi di bawah kategori sumbu mengubah cara sumbu X dan Y dirender. Beberapa opsi tidak berlaku sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit. Anda juga bisa atau menekan`Enter`.

**Penempatan**

Pilih penempatan sumbu Y. Opsinya adalah:
+ **Otomatis** — Grafana secara otomatis menetapkan sumbu Y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, Grafana menetapkan sumbu kiri ke unit pertama, dan sumbu kanan ke unit berikutnya.
+ **Kiri** - Tampilkan semua sumbu Y di sisi kiri.
+ **Kanan** - Tampilkan semua sumbu Y di sisi kanan.
+ **Tersembunyi** — Sembunyikan semua sumbu Y.

Untuk menetapkan sumbu untuk setiap bidang atau seri, [tambahkan penggantian bidang](v9-panels-configure-overrides.md).

**Label**

Tetapkan label teks sumbu Y. Jika Anda memiliki lebih dari satu sumbu Y, maka Anda dapat menetapkan label yang berbeda menggunakan override.

**Lebar**

Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Pengaturan ini memudahkan Anda untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau membentang dalam jarak visual satu sama lain.

**Soft min dan soft max**

Tetapkan opsi **Soft min** atau **soft max** untuk kontrol batas sumbu Y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu Y secara otomatis berdasarkan kumpulan data.

Pengaturan soft min dan soft max memungkinkan visibilitas menjadi perubahan kecil saat perubahan besar tidak ada. Min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik tertentu.

Untuk menentukan batas keras sumbu Y, Anda dapat mengatur min/max opsi standar. Untuk informasi selengkapnya, lihat [Konfigurasi opsi standar](v9-panels-configure-standard-options.md).

**Skala**

Atur bagaimana skala sumbu Y. Pilihannya adalah **Linear** atau **Logaritmik**. Jika Anda memilih logaritmik, Anda dapat memilih lebih lanjut antara skala logaritmik basis 2 atau basis 10.

**Transformasi**

Anda dapat mengganti seri untuk menerapkan transformasi ke nilai pada grafik (tanpa memengaruhi nilai atau nilai yang mendasarinya dalam tooltips, menu konteks, atau legenda). Anda memiliki dua opsi transformasi:
+ **Transformasi Y negatif** — Balikkan hasil ke nilai negatif pada sumbu Y.
+ **Konstan** — Tunjukkan nilai pertama sebagai garis konstan.

# Pilihan warna
<a name="v9-time-series-color"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Secara default, grafik menggunakan opsi [skema Warna](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme) standar untuk menetapkan warna seri. Anda juga dapat menggunakan legenda untuk membuka pemilih warna dengan mengklik ikon warna seri legenda. Menyetel warna dengan cara ini secara otomatis membuat aturan penggantian yang menetapkan warna tertentu untuk seri tertentu.

Berikut ini adalah opsi tambahan yang dapat Anda gunakan untuk mengganti default warna seri.

**Palet Klasik**

Pengaturan yang paling umum adalah menggunakan **palet Klasik** untuk grafik. Skema ini secara otomatis memberikan warna untuk setiap bidang atau seri berdasarkan urutannya. Jika urutan bidang berubah dalam kueri Anda, warnanya juga berubah. Anda dapat mengonfigurasi warna secara manual untuk bidang tertentu menggunakan aturan penggantian.

**Warna tunggal**

Gunakan mode ini untuk menentukan warna. Anda juga dapat mengklik ikon garis berwarna di sebelah setiap seri di Legenda untuk membuka pemilih warna. Ini secara otomatis membuat penggantian baru yang mengatur skema warna menjadi satu warna dan warna yang dipilih.

**Dengan skema warna nilai**

Jika Anda memilih skema warna berdasarkan nilai seperti **Dari ambang batas (berdasarkan nilai)** atau **Green-Yellow-Red (berdasarkan nilai)**, **Seri warna berdasarkan opsi muncul**. Opsi ini mengontrol nilai mana (Terakhir, Min, Maks) yang akan digunakan untuk menetapkan seri warnanya.

**Mode gradien skema**

Opsi **mode Gradien** yang terletak di bawah **gaya Grafik** memiliki mode bernama **Skema**. Saat Anda mengaktifkan **Skema**, garis atau bilah menerima warna gradien yang ditentukan dari **skema Warna** yang dipilih.

**Dari ambang batas**

Jika **skema Warna** diatur ke **Dari ambang batas (berdasarkan nilai)** dan **mode Gradien** diatur ke **Skema**, maka warna garis atau batang berubah saat melewati ambang batas yang ditentukan. Anda hanya akan melihat warna yang tepat yang dipilih dalam skema.

**Skema warna gradien**

Menggunakan skema warna gradien *tanpa* mengatur **mode Gradien** ke **Skema**, berarti bahwa warna yang dipilih akan membentuk gradien antara warna yang dipilih, karena nilai dalam seri bergerak di antara ambang batas yang ditetapkan.

# Panel Jejak (Beta)
<a name="v9-panels-traces"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Jejak* adalah visualisasi yang memungkinkan Anda melacak dan mencatat permintaan saat melintasi layanan di infrastruktur Anda.

Untuk informasi lebih lanjut tentang jejak, lihat[Menelusuri Jelajahi](v9-explore-tracing.md).

# WindRose
<a name="v9-panels-windrose"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 WindRose Panel menerima data deret waktu mentah mengubah data dan memetakannya dalam WindRose bagan.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/windrose.png)


## Opsi
<a name="v9-panels-windrose-options"></a>

 WindRose Panel mendukung opsi berikut:
+ Frekuensi sumbu
+ Gaya sumbu (derajat atau kompas)
+ Skala (linier, persegi, log)

# Jelajahi di Grafana versi 9
<a name="v9-explore"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

UI dasbor Grafana menyediakan fungsionalitas untuk membangun dasbor untuk visualisasi. *Jelajahi* strip dari opsi dasbor dan panel sehingga Anda dapat fokus pada kueri. Ini membantu Anda mengulangi sampai Anda memiliki kueri yang berfungsi dan kemudian Anda dapat membangun dasbor dari kueri.

**catatan**  
Jika Anda hanya ingin menjelajahi data Anda dan tidak ingin membuat dasbor, maka Jelajahi membuat ini jauh lebih mudah. Jika sumber data Anda mendukung data grafik dan tabel, Jelajahi menampilkan hasilnya baik sebagai grafik maupun tabel. Ini memungkinkan Anda untuk melihat tren dalam data dan detail lebih lanjut pada saat yang bersamaan.

## Mulai menjelajah
<a name="v9-explore-start"></a>

**catatan**  
Untuk mengakses Explore, Anda harus memiliki editor atau peran administrator.

**Untuk mengakses Jelajahi**

1. Di ruang kerja Grafana Anda, pilih item menu Jelajahi dari bilah menu sebelah kiri.

   Tab Jelajahi kosong terbuka.

   Sebagai alternatif, untuk memulai dengan kueri yang ada di panel, pilih opsi Jelajahi dari menu Panel. Ini membuka tab Jelajahi dengan kueri dari panel dan memungkinkan Anda untuk mengubah atau mengulangi kueri di luar dasbor Anda.

1. Pilih sumber data Anda dari dropdown di kiri atas. [Prometheus](prometheus-data-source.md) memiliki implementasi Explore kustom, sumber data lainnya menggunakan editor kueri standar mereka.

1. Di bidang kueri, tulis kueri Anda untuk menjelajahi data Anda. Ada tiga tombol di samping bidang kueri, tombol bening (X), tombol tambahkan kueri (\$1) dan tombol hapus kueri (-). Sama seperti editor kueri biasa, Anda dapat menambah dan menghapus beberapa kueri.

   Untuk detail selengkapnya tentang kueri, lihat[Kueri dan transformasi data](v9-panels-query-xform.md).

## Pisahkan dan bandingkan
<a name="v9-explore-compare"></a>

Tampilan split menyediakan cara mudah untuk membandingkan grafik dan tabel side-by-side atau untuk melihat data terkait bersama-sama pada satu halaman.

**Buka tampilan terpisah atas**

1. Dalam tampilan Jelajahi, pilih tombol **Split** untuk menduplikasi kueri saat ini dan membagi halaman menjadi dua side-by-side kueri.
**catatan**  
Dimungkinkan untuk memilih sumber data lain untuk kueri baru yang misalnya, memungkinkan Anda membandingkan kueri yang sama untuk dua server yang berbeda atau membandingkan lingkungan pementasan dengan lingkungan produksi.

   Dalam tampilan terpisah, pemilih waktu untuk kedua panel dapat ditautkan (jika Anda mengubah satu, yang lain juga akan diubah) dengan memilih tombol sinkronisasi waktu yang dilampirkan ke salah satu pemilih waktu. Menautkan pemetik waktu membuat waktu mulai dan akhir dari kueri tampilan terpisah tetap sinkron. Ini memastikan bahwa Anda melihat interval waktu yang sama di kedua panel terpisah.

1. Untuk menutup kueri yang baru dibuat, klik tombol Close Split.

## Bagikan tautan yang dipersingkat
<a name="v9-explore-share"></a>

Kemampuan Share shortened link memungkinkan Anda untuk membuat format /goto/:uid URLs yang lebih kecil dan lebih sederhana daripada menggunakan lebih lama dengan parameter kueri. URLs Untuk membuat tautan singkat ke hasil kueri, pilih opsi **Bagikan** di bilah alat Jelajahi. Tautan singkat yang tidak pernah digunakan akan otomatis dihapus setelah tujuh (7) hari.

# Manajemen kueri di Jelajahi
<a name="v9-explore-manage"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Untuk membantu men-debug kueri, Explore memungkinkan Anda untuk menyelidiki permintaan dan tanggapan kueri, serta statistik kueri, melalui inspektur Query. Fungsionalitas ini mirip dengan tugas inspektur panel [Memeriksa kinerja kueri](v9-panels-panel-inspector.md#v9-panels-query-performance) dan [Memeriksa permintaan kueri dan data respons](v9-panels-panel-inspector.md#v9-panels-query-request-response).

## Riwayat kueri
<a name="v9-explore-manage-history"></a>

Riwayat kueri adalah daftar kueri yang Anda gunakan di Jelajahi. Riwayat disimpan dalam database Grafana dan tidak dibagikan dengan pengguna lain. Periode retensi untuk kueri dalam sejarah adalah dua minggu. Kueri yang berusia lebih dari dua minggu akan dihapus secara otomatis. Untuk membuka dan berinteraksi dengan riwayat Anda, pilih tombol **Riwayat kueri** di Jelajahi.

**catatan**  
Kueri berbintang (favorit) tidak tunduk pada periode retensi dua minggu dan tidak dihapus.

**Lihat riwayat kueri**

Riwayat kueri memungkinkan Anda melihat riwayat kueri Anda. Untuk setiap kueri individu, Anda dapat:
+ Jalankan kueri.
+ Buat and/or edit komentar.
+ Salin kueri ke clipboard.
+ Salin tautan singkat dengan kueri ke clipboard.
+ Bintang (favorit) kueri.

**Kelola kueri favorit**

Semua kueri yang telah dibintangi di tab Riwayat kueri ditampilkan di daftar Berbintang. Ini memungkinkan Anda untuk mengakses kueri favorit Anda lebih cepat dan menggunakan kembali kueri ini tanpa mengetiknya dari awal.

**Menyortir riwayat kueri**

Secara default, riwayat kueri menunjukkan kueri terbaru kepada Anda. Anda dapat mengurutkan riwayat Anda berdasarkan tanggal atau dengan nama sumber data dalam urutan naik atau turun.

**Untuk mengurutkan riwayat kueri Anda**

1. Pilih kolom **Urutkan kueri menurut**.

1. Pilih salah satu opsi berikut:
   + Terbaru pertama
   + Tertua pertama

**Memfilter riwayat kueri**

Anda dapat memfilter riwayat kueri Anda di Riwayat kueri dan tab Berbintang ke sumber data tertentu.

**Memfilter riwayat ke sumber data**

1. Pilih bidang **Filter kueri untuk sumber data tertentu**.

1. Pilih sumber data yang ingin Anda filter histori Anda. Anda dapat memilih beberapa sumber data.

Di tab **Query history**, Anda juga dapat memfilter kueri berdasarkan tanggal menggunakan slider:
+ Gunakan slider vertikal untuk memfilter kueri berdasarkan tanggal.
+ Sesuaikan tanggal mulai dengan menyeret pegangan atas.
+ Sesuaikan tanggal akhir dengan menyeret pegangan atas.

**Mencari dalam riwayat kueri**

Anda dapat mencari di riwayat Anda di seluruh kueri dan komentar Anda. Pencarian dimungkinkan untuk kueri di tab Query history dan tab Starred.

**Untuk mencari di riwayat kueri**

1. Pilih bidang **Permintaan pencarian**.

1. Masukkan istilah yang Anda cari ke dalam bidang pencarian.

**Pengaturan riwayat kueri**

Anda dapat menyesuaikan riwayat kueri di tab Pengaturan. Opsi dijelaskan dalam tabel di bawah ini.


| Pengaturan | Nilai default | 
| --- | --- | 
| Ubah tab aktif default | Tab riwayat kueri | 

**catatan**  
Pengaturan riwayat kueri bersifat global, dan diterapkan ke kedua panel dalam mode terpisah.

## Fitur khusus Prometheus
<a name="v9-explore-manage-prometheus"></a>

Jelajahi fitur pengalaman kueri khusus untuk Prometheus. *Ketika kueri dijalankan, itu benar-benar menjalankan dua kueri, kueri Prometheus normal untuk grafik dan Kueri Instan untuk tabel.* Kueri Instan mengembalikan nilai terakhir untuk setiap deret waktu yang menunjukkan ringkasan data yang baik yang ditunjukkan dalam grafik.

**Penjelajah metrik**

Di sisi kiri bidang kueri, pilih **Metrik** untuk membuka Metric Explorer. Ini menunjukkan menu hierarkis dengan metrik yang dikelompokkan berdasarkan awalan mereka. Misalnya, semua metrik Alertmanager dikelompokkan di bawah awalan. `alertmanager` Ini adalah titik awal yang baik jika Anda hanya ingin menjelajahi metrik mana yang tersedia.

**Bidang kueri**

Bidang Query mendukung pelengkapan otomatis untuk nama dan fungsi metrik, sebanding dengan editor kueri Prometheus standar. Anda dapat menekan tombol Enter untuk membuat baris baru dan Shift\$1Enter untuk menjalankan kueri.

Menu pelengkapan otomatis dapat dipicu dengan menekan Ctrl\$1Space. Menu Pelengkapan Otomatis berisi bagian Riwayat baru dengan daftar kueri yang baru saja dijalankan.

Saran dapat muncul di bawah bidang kueri - pilih untuk memperbarui kueri Anda dengan perubahan yang disarankan.
+ Untuk penghitung (metrik yang meningkat secara monoton), fungsi laju akan disarankan.
+ Untuk ember, fungsi histogram akan disarankan.
+ Untuk merekam aturan, mungkin untuk memperluas aturan.

**Filter tabel**

Pilih tombol filter di kolom **label** panel Tabel untuk menambahkan filter ke ekspresi kueri. Anda dapat menambahkan filter untuk beberapa kueri juga - filter ditambahkan untuk semua kueri.

# Log di Jelajahi
<a name="v9-explore-logs"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Seiring dengan metrik, Explore memungkinkan Anda untuk menyelidiki log Anda di sumber data berikut:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Selama pemantauan infrastruktur dan respons insiden, Anda dapat menggali lebih dalam metrik dan log untuk menemukan penyebabnya. Jelajahi juga memungkinkan Anda untuk mengkorelasikan metrik dan log dengan melihatnya. side-by-side Ini menciptakan alur kerja debugging baru.

1. Menerima peringatan.

1. Telusuri dan periksa metrik.

1. Telusuri lagi dan cari log yang terkait dengan metrik dan interval waktu (dan di masa depan, jejak terdistribusi).

## Visualisasi log
<a name="v9-explore-logs-viz"></a>

Hasil kueri log ditampilkan sebagai histogram dalam grafik dan log individu dijelaskan di bagian berikut.

Jika sumber data mendukung histogram volume log rentang penuh, grafik dengan distribusi log untuk semua kueri log yang dimasukkan ditampilkan secara otomatis. Fitur ini saat ini didukung oleh OpenSearch dan sumber data Loki.

**catatan**  
Di Loki, histogram volume log rentang penuh ini dirender oleh kueri metrik yang bisa mahal tergantung pada rentang waktu yang ditanyakan. Kueri ini bisa sangat menantang bagi instalasi Loki yang lebih kecil untuk diproses. Untuk mengurangi ini, kami sarankan menggunakan proxy seperti [nginx](https://www.nginx.com/) di depan Loki untuk menetapkan batas waktu khusus (misalnya 10 detik) untuk kueri ini. Kueri histogram volume log dapat diidentifikasi dengan mencari kueri dengan header HTTP `X-Query-Tags` dengan nilai`Source=logvolhist`; header ini ditambahkan oleh Grafana ke semua kueri histogram volume log.

Jika sumber data tidak mendukung pemuatan histogram volume log rentang penuh, model log menghitung deret waktu berdasarkan jumlah baris log yang diselimuti oleh interval waktu yang dihitung secara otomatis, dan stempel waktu baris log pertama kemudian menambatkan awal histogram dari hasil. **Akhir dari deret waktu berlabuh ke rentang To picker waktu.**

**Tingkat log**

Untuk log di mana label level ditentukan, Grafana menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, log mencoba mencari tahu apakah kontennya cocok dengan ekspresi yang didukung (lihat di bawah untuk informasi selengkapnya). Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang tidak diketahui.

**Tip**  
Jika Anda menggunakan sumber data Loki dan `level` ada di log-line Anda, gunakan parser (JSON, logfmt, regex,..) untuk mengekstrak informasi level ke dalam label level yang digunakan untuk menentukan level log. Ini akan memungkinkan histogram untuk menunjukkan berbagai level log di bar terpisah.

**Tingkat log yang didukung dan pemetaan singkatan dan ekspresi tingkat log:**


| Ekspresi yang didukung | Tingkat log | Warna | 
| --- | --- | --- | 
| muncul | kritis | ungu | 
| mematikan | kritis | ungu | 
| pemberitahuan | kritis | ungu | 
| kritikan | kritis | ungu | 
| kritis | kritis | ungu | 
| keliru | kesalahan | merah | 
| eror | kesalahan | merah | 
| kesalahan | kesalahan | merah | 
| menegur | memperingati | kuning | 
| memperingati | memperingati | kuning | 
| info | info | hijau | 
| informasi | info | hijau | 
| melihat | info | hijau | 
| dbug | debug | biru | 
| debug | debug | biru | 
| jejak | jejak | biru muda | 
| \$1 | tidak diketahui | abu-abu | 

## Navigasi log
<a name="v9-explore-logs-nav"></a>

Antarmuka navigasi log, di sebelah baris log, dapat digunakan untuk meminta lebih banyak log. Anda dapat melakukan ini dengan memilih tombol **Log lama** di bagian bawah navigasi. Ketika Anda mencapai batas baris dan Anda ingin melihat lebih banyak log, Anda dapat menggunakan ini untuk mengambil lebih banyak log. Setiap permintaan ditampilkan dalam navigasi sebagai halaman terpisah. Setiap halaman menunjukkan stempel waktu dari dan ke baris log yang masuk. Anda dapat melihat hasil sebelumnya dengan mengklik halaman untuk melihat. Jelajahi cache lima permintaan terakhir yang dijalankan dari navigasi log, sehingga tidak menjalankan kembali kueri yang sama saat mengklik halaman tersebut.

## Opsi visualisasi
<a name="v9-explore-logs-vis-options"></a>

Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan.

**Waktu**

Menampilkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data.

**Label unik**

Menampilkan atau menyembunyikan kolom label unik yang hanya menyertakan label yang tidak umum. Semua label umum ditampilkan di atas.

**Bungkus garis**

Setel ini ke True jika Anda ingin tampilan menggunakan pembungkus garis. Jika disetel ke False, itu akan menghasilkan pengguliran horizontal.

**Mempercantik JSON**

Setel ini `true` untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON.

**Deduplikasi**

Data log bisa sangat berulang dan Explore dapat membantu dengan menyembunyikan baris log duplikat. Ada beberapa algoritma deduplikasi berbeda yang dapat Anda gunakan:
+ **Tepat** - Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal.
+ **Angka** — Cocokkan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya.
+ **Tanda tangan** — Deduplikasi yang paling agresif, ini menghapus semua huruf dan angka dan kecocokan pada spasi putih dan tanda baca yang tersisa.

**Balik urutan hasil**

Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama).

**Label dan bidang yang terdeteksi**

Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Untuk semua label, kami telah menambahkan kemampuan untuk memfilter (filter positif) dan menyaring (filter negatif) label yang dipilih. Setiap bidang atau label juga memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.

**Melarikan diri dari baris baru**

Jelajahi secara otomatis mendeteksi beberapa urutan lolos yang salah di baris log, seperti baris baru (`\n`,`\r`) atau tab (). `\t` Saat mendeteksi urutan seperti itu, Jelajahi menyediakan opsi “Escape newlines”.

Jelajahi dapat secara otomatis memperbaiki urutan lolos yang salah yang telah dideteksi

**Untuk secara otomatis memperbaiki urutan escape**

1. Pilih **Escape baris baru** untuk mengganti urutan.

1. Tinjau penggantian secara manual untuk mengkonfirmasi kebenarannya.

Jelajahi menggantikan urutan ini. Ketika melakukannya, opsi akan berubah dari **baris baru Escape** menjadi **Remove escaping**. Evaluasi perubahan karena parsing mungkin tidak akurat berdasarkan input yang diterima. Anda dapat mengembalikan penggantian dengan memilih **Hapus** escaping.

**Tautan data**

Dengan menggunakan tautan data, Anda dapat mengubah bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan yang dibuat terlihat sebagai tombol di bagian **Tautan** di dalam tampilan **detail Log**.

**Alihkan visibilitas bidang**

Perluas garis log dan klik ikon mata untuk menampilkan atau menyembunyikan bidang.

## Fitur khusus Loki
<a name="v9-explore-logs-loki"></a>

Loki adalah sistem agregasi log open source dari Grafana Labs. Loki dirancang agar hemat biaya, karena tidak mengindeks isi log, melainkan satu set label untuk setiap aliran log. Log dari Loki ditanyakan dengan cara yang mirip dengan kueri dengan pemilih label di Prometheus. Ini menggunakan label untuk mengelompokkan aliran log yang dapat dibuat agar sesuai dengan label Prometheus Anda. [Untuk informasi lebih lanjut tentang Grafana Loki, Anda dapat melihat Grafana Loki Github.](https://github.com/grafana/loki)

Untuk informasi selengkapnya, lihat [Loki](using-loki-in-AMG.md) tentang cara menanyakan data log.

**Beralih dari metrik ke log**

Jika Anda beralih dari kueri Prometheus ke kueri log (Anda dapat melakukan pemisahan terlebih dahulu agar metrik dan log Anda berdampingan) maka itu akan menyimpan label dari kueri Anda yang ada di log dan menggunakannya untuk menanyakan aliran log. Misalnya, jika Anda memiliki kueri Prometheus berikut:

```
grafana_alerting_active_alerts{job="grafana"}
```

setelah beralih ke sumber data Log, itu akan berubah menjadi:

```
{job="grafana"}
```

Ini akan mengembalikan potongan log dalam rentang waktu yang dipilih yang dapat dicari.

## Log sampel
<a name="v9-explore-logs-sample"></a>

Jika sumber data yang dipilih mengimplementasikan sampel log, dan mendukung kueri log dan metrik, maka untuk kueri metrik Anda akan dapat secara otomatis melihat sampel baris log yang berkontribusi pada metrik yang divisualisasikan. Fitur ini saat ini didukung oleh sumber data Loki.

**Ekor langsung**

Gunakan fitur Live tailing untuk melihat log real-time pada sumber data yang didukung.

Pilih tombol **Live** di toolbar Jelajahi untuk beralih ke tampilan Live tail.

Sementara di Live tail view log baru akan datang dari bagian bawah layar dan akan memiliki latar belakang kontras yang memudar sehingga Anda dapat melacak apa yang baru. Pilih tombol **Jeda** atau gulir tampilan log untuk menjeda tailing Langsung dan jelajahi log sebelumnya tanpa gangguan. Pilih tombol **Lanjutkan** untuk melanjutkan Live tailing atau pilih tombol **Stop** untuk keluar dari Live tailing dan kembali ke tampilan Jelajahi standar.

# Menelusuri Jelajahi
<a name="v9-explore-tracing"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Jelajahi memungkinkan Anda memvisualisasikan jejak dari melacak sumber data.

Sumber data berikut didukung.
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Untuk informasi tentang cara mengonfigurasi kueri untuk sumber data yang tercantum di atas, lihat dokumentasi untuk sumber data tertentu.

## Penjelasan Trace View
<a name="v9-explore-trace-view"></a>

Bagian ini menjelaskan elemen dasbor Trace View.

**Header**

Header dari tampilan jejak memiliki elemen-elemen berikut
+ Judul header: Menampilkan nama rentang root dan ID jejak.
+ Pencarian: Sorotan mencakup teks yang dicari.
+ Metadata: Berbagai metadata tentang jejak.

**Minimap**

Menampilkan tampilan kental atau garis waktu jejak. Seret penunjuk Anda ke peta mini untuk memperbesar rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Melayang di atas minimap, saat diperbesar, akan menampilkan tombol Reset Selection yang mengatur ulang zoom.

**Garis Waktu**

Menampilkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen ini:
+ Perluas tombol anak: Memperluas atau menciutkan semua rentang anak dari rentang yang dipilih.
+ Nama layanan: Nama layanan mencatat rentang.
+ Nama operasi: Nama operasi yang diwakili oleh rentang ini.
+ Bilah durasi rentang: Representasi visual dari durasi operasi dalam jejak.

**Rincian rentang**

Mengklik di mana saja pada baris rentang menunjukkan detail rentang, termasuk yang berikut ini.
+ Nama operasi
+ Metadata rentang
+ Tags: Setiap tag yang terkait dengan rentang ini.
+ Metadata proses: Metadata tentang proses yang mencatat rentang ini.
+ Log: Daftar log yang dicatat oleh rentang ini dan nilai kunci terkait. Dalam kasus Zipkin log bagian menunjukkan anotasi Zipkin.

**Grafik simpul**

Anda secara opsional dapat memperluas grafik simpul untuk jejak yang ditampilkan. Bergantung pada sumber data, ini dapat menunjukkan rentang jejak sebagai node dalam grafik, atau menambahkan beberapa konteks tambahan, termasuk grafik layanan berdasarkan jejak saat ini.

**Lacak ke log**

Anda dapat menavigasi dari rentang dalam tampilan jejak langsung ke log yang relevan untuk rentang tersebut. Ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk petunjuk tentang cara mengkonfigurasi setiap sumber data.

Klik ikon dokumen untuk membuka tampilan terpisah di Jelajahi dengan sumber data yang dikonfigurasi dan kueri log yang relevan untuk rentang tersebut.

## Tampilan Grafik Layanan
<a name="v9-explore-trace-graph"></a>

Tampilan Grafik Layanan memvisualisasikan metrik rentang (melacak data untuk tarif, tingkat kesalahan, dan durasi (RED)) dan grafik layanan. Setelah persyaratan disiapkan, tampilan pra-konfigurasi ini segera tersedia.

Untuk informasi selengkapnya, lihat halaman sumber data [Tempo](tempo-data-source.md). Anda juga dapat melihat [halaman tampilan grafik layanan](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) di *dokumentasi Tempo*.

# Inspector di Explore
<a name="v9-explore-inspector"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Inspektur membantu Anda memahami dan memecahkan masalah pertanyaan Anda. Anda dapat memeriksa data mentah, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), mengekspor hasil log dalam format TXT, dan melihat permintaan kueri.

## Inspector UI
<a name="v9-explore-inspector-ui"></a>

Inspektur memiliki tab berikut:
+ **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+ **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana menanyakan sumber data.
+ **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin data JSON dan struktur bingkai data JSON.
+ **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri.
+ **Tab kesalahan** - Menampilkan kesalahan. Hanya terlihat ketika kueri mengembalikan kesalahan.

## Tugas Inspector
<a name="v9-explore-inspector-tasks"></a>

Anda dapat melakukan berbagai tugas di inspektur Jelajahi.

**Buka Inspector**

Setelah Anda menjalankan kueri yang ingin Anda periksa, pilih tombol **Inspector**.

Panel inspektur terbuka di bagian bawah layar.

*Periksa hasil kueri mentah*

Anda dapat melihat hasil kueri mentah yang merupakan data yang dikembalikan oleh kueri dalam tabel.

Di tab **Inspector**, klik tab **Data**.

Untuk beberapa kueri atau untuk kueri beberapa node, ada opsi tambahan.
+ **Tampilkan bingkai data:** Pilih data set hasil yang ingin Anda lihat.
+ **Seri yang digabungkan dengan waktu:** Lihat data mentah dari semua kueri Anda sekaligus, satu set hasil per kolom. Anda dapat mengklik judul kolom untuk mengurutkan data.

**Unduh hasil kueri mentah sebagai CSV**

Setelah Anda melihat hasil kueri mentah, Anda dapat menghasilkan file CSV dari hasil. Anda akan mendapatkan file CSV dari hasil yang Anda lihat, jadi pastikan untuk menyempurnakan hasilnya untuk mendapatkan hasil yang Anda inginkan sebelum membuat file CSV.

**Untuk menghasilkan file CSV, pilih **Unduh CSV** di tab Inspector.**

**Untuk mengunduh file CSV yang diformat khusus untuk Excel, perluas **opsi Data** dan kemudian aktifkan tombol **Unduh untuk Excel** sebelum Anda memilih opsi Unduh CSV.**

*Unduh hasil log sebagai TXT*

**Anda dapat menghasilkan file TXT dari log yang sedang Anda lihat, dengan memilih **Unduh log** di tab Inspector.**

**Unduh hasil jejak**

Berdasarkan tipe sumber data, Grafana dapat menghasilkan file JSON untuk hasil jejak dalam salah satu format yang didukung: format Jaeger, Zipkin, atau OTLP.

Untuk mengunduh jejak, pilih **Unduh jejak** di tab **Inspector**.

**Periksa kinerja kueri**

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

Statistik adalah read-only.

**Lihat model JSON**

Anda dapat menjelajahi dan mengekspor data serta model JSON bingkai data.

**Untuk melihat model JSON**

1. Di panel Inspector, klik tab **JSON**.

1. Dari menu tarik-turun **Pilih sumber**, pilih salah satu opsi berikut:
   + **Data** - Menampilkan objek JSON yang mewakili data yang dikembalikan ke Explore.
   + **DataFrame struktur** - Menampilkan set hasil mentah.

1. Anda dapat memperluas atau menciutkan bagian JSON untuk melihat bagian terpisah. Anda juga dapat memilih opsi **Salin ke clipboard** untuk menyalin badan JSON dan menempelkannya ke aplikasi lain.

**Lihat permintaan mentah dan respons terhadap sumber data**

Saat Anda bekerja dengan Explore dan tab Inspector, Anda dapat melihat permintaan mentah dan data respons yang Anda hasilkan dengan kueri. Di Inspector, pilih tab **Query** dan pilih **Refresh** untuk melihat data mentah.

Grafana mengirimkan kueri ke server dan menampilkan hasilnya. Anda dapat menelusuri bagian-bagian tertentu dari kueri, memperluas atau menciutkan semuanya, atau menyalin data ke clipboard untuk digunakan dalam aplikasi lain.

# Peringatan di Grafana versi 9
<a name="v9-alerts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana alert memberi Anda peringatan yang kuat dan dapat ditindaklanjuti yang membantu Anda mempelajari masalah dalam sistem beberapa saat setelah terjadi, meminimalkan gangguan pada layanan Anda.

Grafana yang Dikelola Amazon mencakup akses ke sistem peringatan yang diperbarui, peringatan Grafana, yang *memusatkan informasi peringatan* dalam satu tampilan yang dapat dicari. Ini mencakup fitur-fitur berikut:
+ Buat dan kelola peringatan Grafana dalam tampilan terpusat.
+ Buat dan kelola peringatan terkelola Cortex dan Loki melalui satu antarmuka.
+ Lihat informasi peringatan dari Prometheus, Layanan Terkelola Amazon untuk Prometheus, dan sumber data lain yang kompatibel dengan Alertmanager.

Saat Anda membuat ruang kerja Grafana Terkelola Amazon, Anda memiliki pilihan untuk menggunakan peringatan Grafana, atau. [Peringatan dasbor klasik](old-alerts-overview.md) Bagian ini mencakup peringatan Grafana.

**catatan**  
Jika Anda membuat ruang kerja dengan peringatan Klasik diaktifkan, dan ingin beralih ke peringatan Grafana, Anda dapat [beralih di antara](v9-alerting-use-grafana-alerts.md) dua sistem peringatan. .

## Keterbatasan peringatan Grafana
<a name="v9-alert-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Amazon Managed Service yang tersedia untuk Prometheus, Prometheus, Loki, dan Alertmanager. Mungkin tidak dapat mengambil aturan dari sumber data lain yang didukung.
+ Aturan peringatan yang ditentukan di Grafana, bukan di Prometheus, mengirim beberapa pemberitahuan ke titik kontak Anda. Jika Anda menggunakan peringatan Grafana asli, kami sarankan Anda tetap menggunakan peringatan dasbor klasik dan tidak mengaktifkan fitur peringatan Grafana baru. Jika Anda ingin melihat Peringatan yang ditentukan dalam sumber data Prometheus Anda, maka kami sarankan Anda mengaktifkan Peringatan Grafana, yang hanya mengirimkan satu pemberitahuan untuk peringatan yang dibuat di Prometheus Alertmanager.
**catatan**  
Batasan ini tidak lagi menjadi batasan di ruang kerja Grafana Terkelola Amazon yang mendukung Grafana v10.4 dan yang lebih baru.

**Topics**
+ [Keterbatasan peringatan Grafana](#v9-alert-limitations)
+ [Gambaran umum](v9-alerting-overview.md)
+ [Menjelajahi peringatan](v9-alerting-explore.md)
+ [Mengatur Peringatan](v9-alerting-setup.md)
+ [Memigrasi peringatan dasbor klasik ke peringatan Grafana](v9-alerting-use-grafana-alerts.md)
+ [Kelola aturan peringatan Anda](v9-alerting-managerules.md)
+ [Mengelola notifikasi peringatan](v9-alerting-managenotifications.md)

# Gambaran umum
<a name="v9-alerting-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Berikut ini memberi Anda gambaran umum tentang cara kerja Grafana Alerting dan memperkenalkan Anda pada beberapa konsep kunci yang bekerja bersama dan membentuk inti dari mesin peringatan yang fleksibel dan kuat.

1. **Sumber data**

   Terhubung ke data yang akan digunakan dengan memberi peringatan. Data ini sering merupakan data deret waktu, untuk peringatan, dan menunjukkan rincian sistem yang akan dipantau dan dianalisis. Untuk informasi selengkapnya, lihat [sumber data](AMG-data-sources-builtin.md).

1. **Aturan peringatan**

   Tetapkan kriteria evaluasi yang menentukan apakah instance peringatan akan diaktifkan. Aturan peringatan terdiri dari satu atau lebih kueri dan ekspresi untuk menarik data dari sumber data, kondisi yang menjelaskan apa yang merupakan kebutuhan untuk peringatan, frekuensi evaluasi, dan secara opsional, durasi di mana kondisi harus dipenuhi untuk peringatan untuk menyala.

   Peringatan terkelola Grafana mendukung peringatan multi-dimensi, yang berarti bahwa setiap aturan peringatan dapat membuat beberapa instance peringatan. Ini sangat kuat jika Anda mengamati beberapa seri dalam satu ekspresi.

1. **Label**

   Cocokkan aturan peringatan dan instance-nya dengan kebijakan pemberitahuan dan pembungkaman. Mereka juga dapat digunakan untuk mengelompokkan peringatan Anda berdasarkan tingkat keparahan.

1. **Kebijakan pemberitahuan**

   Tetapkan di mana, kapan, dan bagaimana peringatan diarahkan untuk memberi tahu tim Anda saat peringatan menyala. Setiap kebijakan pemberitahuan menentukan satu set pencocokan label untuk menunjukkan peringatan mana yang menjadi tanggung jawab mereka. Kebijakan notifikasi memiliki titik kontak yang ditetapkan untuk itu yang terdiri dari satu atau beberapa notifier.

1. **Titik kontak**

   Tentukan bagaimana kontak Anda diberi tahu saat peringatan menyala. Kami mendukung banyak ChatOps alat untuk memastikan peringatan datang ke tim Anda.

## Fitur
<a name="v9-alerting-features"></a>

**Satu halaman untuk semua peringatan**

Satu halaman Peringatan Grafana menggabungkan peringatan dan peringatan yang dikelola Grafana yang berada di sumber data Anda yang kompatibel dengan Prometheus di satu tempat.

**Peringatan multi-dimensi**

Aturan peringatan dapat membuat beberapa instance peringatan individual per aturan peringatan, yang dikenal sebagai peringatan multi-dimensi, memberi Anda kekuatan dan fleksibilitas untuk mendapatkan visibilitas ke seluruh sistem Anda hanya dengan satu peringatan.

**Peringatan perutean**

Rutekan setiap instance peringatan ke titik kontak tertentu berdasarkan label yang Anda tentukan. Kebijakan pemberitahuan adalah seperangkat aturan untuk di mana, kapan, dan bagaimana peringatan diarahkan ke titik kontak.

**Membungkam peringatan**

Keheningan memungkinkan Anda untuk berhenti menerima pemberitahuan terus-menerus dari satu atau beberapa aturan peringatan. Anda juga dapat menjeda sebagian peringatan berdasarkan kriteria tertentu. Silences memiliki bagian khusus mereka sendiri untuk organisasi dan visibilitas yang lebih baik, sehingga Anda dapat memindai aturan peringatan yang dijeda tanpa mengacaukan tampilan peringatan utama.

**Bisukan waktu**

Dengan pengaturan waktu bisu, Anda dapat menentukan interval waktu saat Anda tidak ingin notifikasi baru dibuat atau dikirim. Anda juga dapat membekukan pemberitahuan peringatan untuk periode waktu berulang, seperti selama periode pemeliharaan.

# Menjelajahi peringatan
<a name="v9-alerting-explore"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Baik Anda memulai atau memperluas implementasi Grafana Alerting, pelajari lebih lanjut tentang konsep utama dan fitur yang tersedia yang membantu Anda membuat, mengelola, dan mengambil tindakan pada peringatan Anda dan meningkatkan kemampuan tim Anda untuk menyelesaikan masalah dengan cepat.

Pertama-tama, mari kita lihat berbagai jenis aturan peringatan yang ditawarkan Grafana Alerting.

## Jenis aturan peringatan
<a name="v9-alerting-explore-rule-types"></a>

**Aturan yang dikelola Grafana**

Aturan yang dikelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data kami yang didukung. Selain mendukung beberapa sumber data, Anda juga dapat menambahkan ekspresi untuk mengubah data Anda dan mengatur kondisi peringatan. Ini adalah satu-satunya jenis aturan yang memungkinkan peringatan dari beberapa sumber data dalam satu definisi aturan.

**Aturan Mimir dan Loki**

Untuk membuat peringatan Mimir atau Loki, Anda harus memiliki sumber data Prometheus atau Loki yang kompatibel. Anda dapat memeriksa apakah sumber data Anda mendukung pembuatan aturan melalui Grafana dengan menguji sumber data dan mengamati apakah API penggaris didukung.

**Aturan perekaman**

Aturan perekaman hanya tersedia untuk sumber data Prometheus atau Loki yang kompatibel. Aturan perekaman memungkinkan Anda untuk menghitung terlebih dahulu ekspresi yang sering dibutuhkan atau mahal secara komputasi dan menyimpan hasilnya sebagai rangkaian waktu baru. Ini berguna jika Anda ingin menjalankan peringatan pada data agregat atau jika Anda memiliki dasbor yang menanyakan ekspresi mahal secara komputasi berulang kali.

## Konsep dan fitur utama
<a name="v9-alerting-explore-features"></a>

Tabel berikut mencakup daftar konsep kunci, fitur, dan definisinya, yang dirancang untuk membantu Anda memaksimalkan Grafana Alerting.


| Konsep atau fitur kunci | Definisi | 
| --- | --- | 
|  Sumber data untuk Peringatan  |  Pilih sumber data yang ingin Anda kueri dan visualisasikan metrik, log, dan jejak.  | 
|  Penyediaan untuk Peringatan  |  Kelola sumber daya peringatan Anda dan sediakan ke dalam sistem Grafana Anda menggunakan penyediaan file atau Terraform.  | 
|  Pengelola Peringatan  |  Mengelola perutean dan pengelompokan instance peringatan.  | 
|  Aturan peringatan  |  Seperangkat kriteria evaluasi kapan aturan peringatan harus ditembakkan. Aturan peringatan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan durasi di mana kondisi terpenuhi. Aturan peringatan dapat menghasilkan beberapa instance peringatan.  | 
|  Contoh peringatan  |  Sebuah instance peringatan adalah contoh dari aturan peringatan. Aturan peringatan satu dimensi memiliki satu contoh peringatan. Aturan peringatan multidimensi memiliki satu atau lebih contoh peringatan. Aturan peringatan tunggal yang cocok dengan beberapa hasil, seperti CPU terhadap 10 VMs, dihitung sebagai beberapa (dalam hal ini 10) instance peringatan. Jumlah ini dapat bervariasi dari waktu ke waktu. Misalnya, aturan peringatan yang memantau penggunaan CPU untuk semua VMs dalam sistem memiliki lebih banyak instance peringatan seperti VMs yang ditambahkan. Untuk informasi selengkapnya tentang kuota instance peringatan, lihat. [Kuota mencapai kesalahan](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached)  | 
|  Grup peringatan  |  Alertmanager mengelompokkan instance peringatan secara default menggunakan label untuk kebijakan notifikasi root. Ini mengontrol de-duplikasi dan grup instance peringatan, yang dikirim ke titik kontak.  | 
|  Titik kontak  |  Tentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan.  | 
|  Templating pesan  |  Buat templat khusus yang dapat digunakan kembali dan gunakan di titik kontak.  | 
|  Kebijakan pemberitahuan  |  Set aturan untuk di mana, kapan, dan bagaimana peringatan dikelompokkan dan diarahkan ke titik kontak.  | 
|  Label dan pencocokan label  |  Label secara unik mengidentifikasi aturan peringatan. Mereka menghubungkan aturan peringatan dengan kebijakan pemberitahuan dan pembungkaman, menentukan kebijakan mana yang harus menanganinya dan aturan peringatan mana yang harus dibungkam.  | 
|  Keheningan  |  Hentikan pemberitahuan dari satu atau beberapa contoh peringatan. Perbedaan antara keheningan dan waktu bisu adalah bahwa keheningan hanya berlangsung hanya untuk jendela waktu tertentu sedangkan waktu bisu dimaksudkan untuk berulang pada jadwal. Menggunakan pencocokan label untuk membungkam instance peringatan.  | 
|  Bisukan waktu  |  Tentukan interval waktu saat Anda tidak ingin notifikasi baru dibuat atau dikirim. Anda juga dapat membekukan notifikasi peringatan untuk periode waktu berulang, seperti selama periode pemeliharaan. Harus ditautkan ke kebijakan pemberitahuan yang ada.  | 

# Sumber data
<a name="v9-alerting-explore-datasources"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ada sejumlah [sumber data](AMG-data-sources-builtin.md) yang kompatibel dengan Grafana Alerting. Setiap sumber data didukung oleh plugin. Anda dapat menggunakan salah satu sumber data bawaan yang tercantum di bawah ini.

Ini adalah sumber data yang kompatibel dengan dan didukung oleh Grafana yang Dikelola Amazon.
+ [Connect ke sumber data Alertmanager](data-source-alertmanager.md)
+ [Connect ke sumber CloudWatch data Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect ke sumber data Amazon OpenSearch Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connect ke sumber AWS IoT SiteWise data](using-iotsitewise-in-AMG.md)
+ [Connect ke sumber AWS IoT TwinMaker data](AMG-iot-twinmaker.md)
+ [Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka](prometheus-data-source.md)
+ [Connect ke sumber data Amazon Timestream](timestream-datasource.md)
+ [Connect ke sumber data Amazon Athena](AWS-Athena.md)
+ [Connect ke sumber data Amazon Redshift](AWS-Redshift.md)
+ [Connect ke sumber AWS X-Ray data](x-ray-data-source.md)
+ [Connect ke sumber data Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connect ke sumber data Google Cloud Monitoring](using-google-cloud-monitoring-in-grafana.md)
+ [Connect ke sumber data Graphite](using-graphite-in-AMG.md)
+ [Connect ke sumber data InfluxDB](using-influxdb-in-AMG.md)
+ [Connect ke sumber data Loki](using-loki-in-AMG.md)
+ [Connect ke sumber data Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [Connect ke sumber data MySQL](using-mysql-in-AMG.md)
+ [Connect ke sumber data OpenTSDB](using-opentsdb-in-AMG.md)
+ [Connect ke sumber data PostgreSQL](using-postgresql-in-AMG.md)
+ [Connect ke sumber data Jaeger](jaeger-data-source.md)
+ [Connect ke sumber data Zipkin](zipkin-data-source.md)
+ [Connect ke sumber data Tempo](tempo-data-source.md)
+ [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md)

# Tentang aturan peringatan
<a name="v9-alerting-explore-rules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah instance peringatan akan diaktifkan. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan opsional, durasi di mana kondisi terpenuhi.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi atau dilampaui peringatan untuk membuat peringatan.

Interval menentukan seberapa sering aturan peringatan dievaluasi. Durasi, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan peringatan juga dapat menentukan perilaku peringatan tanpa adanya data.

**Topics**
+ [Jenis aturan peringatan](v9-alerting-explore-rules-types.md)
+ [Contoh peringatan](v9-alerting-rules-instances.md)
+ [Ruang nama dan grup](v9-alerting-rules-grouping.md)
+ [Templating pemberitahuan](v9-alerting-rules-notification-templates.md)

# Jenis aturan peringatan
<a name="v9-alerting-explore-rules-types"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana mendukung beberapa jenis aturan peringatan. Bagian berikut akan menjelaskan kelebihan dan kekurangannya dan membantu Anda memilih jenis peringatan yang tepat untuk kasus penggunaan Anda.

Aturan terkelola Grafana

Aturan yang dikelola Grafana adalah jenis aturan peringatan yang paling fleksibel. Mereka memungkinkan Anda membuat peringatan yang dapat bertindak berdasarkan data dari sumber data apa pun yang ada.

Selain mendukung sumber data apa pun, Anda dapat menambahkan [ekspresi](v9-panels-query-xform-expressions.md) untuk mengubah data Anda dan menyatakan kondisi peringatan.

Aturan Mimir, Loki dan Cortex

Untuk membuat peringatan Mimir, Loki, atau Cortex, Anda harus memiliki sumber data Prometheus yang kompatibel. Anda dapat memeriksa apakah sumber data Anda kompatibel dengan menguji sumber data dan memeriksa detailnya jika API penggaris didukung.

Aturan perekaman

Aturan perekaman hanya tersedia untuk sumber data Prometheus yang kompatibel seperti Mimir, Loki, dan Cortex.

Aturan perekaman memungkinkan Anda menyimpan hasil ekspresi ke rangkaian deret waktu baru. Ini berguna jika Anda ingin menjalankan peringatan pada data agregat atau jika Anda memiliki dasbor yang menanyakan ekspresi yang sama berulang kali.

Baca lebih lanjut tentang [aturan perekaman](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) di Prometheus.

# Contoh peringatan
<a name="v9-alerting-rules-instances"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Peringatan terkelola Grafana mendukung peringatan multi-dimensi. Setiap aturan peringatan dapat membuat beberapa instance peringatan. Ini sangat kuat jika Anda mengamati beberapa seri dalam satu ekspresi.

Pertimbangkan ekspresi PromQL berikut:

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Aturan yang menggunakan ekspresi ini akan membuat instance peringatan sebanyak jumlah yang CPUs diamati selama evaluasi, memungkinkan satu aturan untuk melaporkan status setiap CPU.

# Ruang nama dan grup
<a name="v9-alerting-rules-grouping"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Peringatan dapat diatur menggunakan Folder untuk aturan dan ruang nama yang dikelola Grafana untuk aturan dan nama grup Mimir, Loki, atau Prometheus.

**Ruang nama**

Saat membuat aturan yang dikelola Grafana, folder dapat digunakan untuk melakukan kontrol akses dan memberikan atau menolak akses ke semua aturan dalam folder tertentu.

**Grup**

Semua aturan dalam kelompok dievaluasi pada **interval** yang sama.

Aturan peringatan dan aturan perekaman dalam grup akan selalu dievaluasi **secara berurutan**, artinya tidak ada aturan yang akan dievaluasi pada saat yang sama dan dalam urutan penampilan.

**Tip**  
Jika Anda ingin aturan dievaluasi secara bersamaan dan dengan interval yang berbeda, pertimbangkan untuk menyimpannya dalam kelompok yang berbeda.

# Templating pemberitahuan
<a name="v9-alerting-rules-notification-templates"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Pemberitahuan yang dikirim melalui titik kontak dibuat menggunakan templat notifikasi. Template default Grafana didasarkan pada [sistem template Go di mana beberapa bidang dievaluasi sebagai teks, sementara yang lain dievaluasi sebagai HTML (yang dapat memengaruhi pelolosan](https://golang.org/pkg/text/template)).

Template default [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) adalah referensi yang berguna untuk template kustom.

Karena sebagian besar bidang titik kontak dapat di-template, Anda dapat membuat templat khusus yang dapat digunakan kembali dan menggunakannya di beberapa titik kontak. Untuk mempelajari notifikasi kustom menggunakan templat, lihat[Sesuaikan notifikasi](v9-alerting-notifications.md).

**Template bersarang**

Anda dapat menyematkan template dalam template lain.

Misalnya, Anda dapat menentukan fragmen template menggunakan `define` kata kunci.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Anda kemudian dapat menyematkan template kustom dalam fragmen ini menggunakan kata kunci. `template` Contoh:

```
Alert summary:
{{ template "mytemplate" . }}
```

Anda dapat menggunakan salah satu opsi templat bawaan berikut untuk menyematkan templat khusus.


| Nama | Catatan | 
| --- | --- | 
|  `default.title`  |  Menampilkan informasi status tingkat tinggi.  | 
|  `default.message`  |  Menyediakan ringkasan pemformatan dan peringatan yang diselesaikan.  | 
|  `teams.default.message`  |  Mirip dengan`default.messsage`, diformat untuk Microsoft Teams.  | 

**HTML dalam template notifikasi**

HTML dalam peringatan template notifikasi lolos. Kami tidak mendukung rendering HTML dalam notifikasi yang dihasilkan.

Beberapa notifier mendukung metode alternatif untuk mengubah tampilan dan nuansa notifikasi yang dihasilkan. Misalnya, Grafana menginstal template dasar untuk memperingatkan email. `<grafana-install-dir>/public/emails/ng_alert_notification.html` Anda dapat mengedit file ini untuk mengubah tampilan semua email peringatan.

# Peringatan pada data numerik
<a name="v9-alerting-explore-numeric"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini menjelaskan bagaimana Grafana menangani peringatan pada data numerik daripada deret waktu.

Di antara sumber data tertentu, data numerik yang tidak deret waktu dapat langsung disiagakan, atau diteruskan ke Server Side Expressions (SSE). Hal ini memungkinkan untuk lebih banyak pemrosesan dan menghasilkan efisiensi dalam sumber data, dan juga dapat menyederhanakan aturan peringatan. Saat memperingatkan data numerik alih-alih data deret waktu, tidak perlu mengurangi setiap deret waktu berlabel menjadi satu angka. Sebaliknya, nomor berlabel dikembalikan ke Grafana sebagai gantinya.

**Data Tabular**

Fitur ini didukung dengan sumber data backend yang menanyakan data tabular:
+ Sumber data SQL seperti MySQL, Postgres, MSSQL, dan Oracle.
+ Layanan berbasis Azure Kusto: Azure Monitor (Log), Azure Monitor (Azure Resource Graph), dan Azure Data Explorer.

Kueri dengan peringatan terkelola Grafana atau SSE dianggap numerik dengan sumber data ini, jika:
+ Opsi “Format AS” diatur ke “Tabel” dalam kueri sumber data.
+ Respons tabel yang dikembalikan ke Grafana dari kueri hanya mencakup satu kolom numerik (misalnya int, double, float), dan kolom string tambahan opsional.

Jika ada kolom string, maka kolom tersebut menjadi label. Nama kolom menjadi nama label, dan nilai untuk setiap baris menjadi nilai label yang sesuai. Jika beberapa baris dikembalikan, maka setiap baris harus diidentifikasi secara unik labelnya.

**Contoh**

Untuk tabel MySQL yang disebut “”: DiskSpace


| Waktu | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
|  2021-Juni-7  |  web1  |  /dll  |  3  | 
|  2021-Juni-7  |  web2  |  /var  |  4  | 
|  2021-Juni-7  |  web3  |  /var  |  8  | 
|  ...  |  ...  |  ...  |  ...  | 

Anda dapat menanyakan pemfilteran data tepat waktu, tetapi tanpa mengembalikan deret waktu ke Grafana. Misalnya, peringatan yang akan memicu per Host, Disk ketika ada kurang dari 5% ruang kosong:

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)
```

Query ini mengembalikan respon Tabel berikut untuk Grafana:


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /dll  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

Ketika kueri ini digunakan sebagai **kondisi** dalam aturan peringatan, maka bukan nol akan memperingatkan. Akibatnya, tiga instance peringatan dihasilkan:


| Label | Status | 
| --- | --- | 
|  \$1host = web1, disk =/dll\$1  |  Peringatan  | 
|  \$1host = web2, disk =/var\$1  |  Peringatan  | 
|  \$1host = web3, disk =/var\$1  |  Normal  | 

# Label dan anotasi
<a name="v9-alerting-explore-labels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Label dan anotasi berisi informasi tentang peringatan. Baik label dan anotasi memiliki struktur yang sama: satu set nilai bernama; namun penggunaan yang dimaksudkan berbeda. Contoh label, atau anotasi yang setara, mungkin`alertname="test"`.

Perbedaan utama antara label dan anotasi adalah label digunakan untuk membedakan peringatan dari semua peringatan lainnya, sementara anotasi digunakan untuk menambahkan informasi tambahan ke peringatan yang ada.

Misalnya, pertimbangkan dua peringatan CPU tinggi: satu untuk `server1` dan satu lagi untuk`server2`. Dalam contoh seperti itu, kita mungkin memiliki label yang disebut `server` di mana peringatan pertama memiliki label `server="server1"` dan peringatan kedua memiliki label`server="server2"`. Namun, kami mungkin juga ingin menambahkan deskripsi ke setiap peringatan seperti`"The CPU usage for server1 is above 75%."`, di `75%` mana `server1` dan diganti dengan nama dan penggunaan CPU server (silakan lihat dokumentasi tentang [Templating label dan anotasi](v9-alerting-explore-labels-templating.md) cara melakukannya). Deskripsi semacam ini akan lebih cocok sebagai anotasi.

## Label
<a name="v9-alerting-explore-labels-labels"></a>

Label berisi informasi yang mengidentifikasi peringatan. Contoh label mungkin`server=server1`. Setiap peringatan dapat memiliki lebih dari satu label, dan set lengkap label untuk peringatan disebut set labelnya. Set label inilah yang mengidentifikasi peringatan.

Misalnya, peringatan mungkin memiliki label yang disetel `{alertname="High CPU usage",server="server1"}` sementara peringatan lain mungkin memiliki label yang disetel`{alertname="High CPU usage",server="server2"}`. Ini adalah dua peringatan terpisah karena meskipun `alertname` labelnya sama, `server` labelnya berbeda.

Label yang ditetapkan untuk peringatan adalah kombinasi label dari sumber data, label khusus dari aturan peringatan, dan sejumlah label yang dicadangkan seperti. `alertname`

**Label Kustom**

Label khusus adalah label tambahan dari aturan peringatan. Seperti anotasi, label khusus harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Dokumentasi tentang cara membuat template label kustom dapat ditemukan [di sini](v9-alerting-explore-labels-templating.md).

Saat menggunakan label khusus dengan templat, penting untuk memastikan bahwa nilai label tidak berubah di antara evaluasi berturut-turut dari aturan peringatan karena ini akan menghasilkan sejumlah besar peringatan berbeda. Namun, tidak apa-apa bagi template untuk menghasilkan nilai label yang berbeda untuk peringatan yang berbeda. Misalnya, jangan letakkan nilai kueri di label khusus karena ini akan berakhir dengan membuat kumpulan peringatan baru setiap kali nilainya berubah. Sebagai gantinya gunakan anotasi.

Penting juga untuk memastikan bahwa label yang ditetapkan untuk peringatan tidak memiliki dua atau lebih label dengan nama yang sama. Jika label kustom memiliki nama yang sama dengan label dari sumber data maka label tersebut akan menggantikan label tersebut. Namun, jika label khusus memiliki nama yang sama dengan label yang dicadangkan maka label khusus akan dihilangkan dari peringatan.

## Anotasi
<a name="v9-alerting-explore-labels-annotations"></a>

Anotasi adalah pasangan bernama yang menambahkan informasi tambahan ke peringatan yang ada. Ada sejumlah anotasi yang disarankan di Grafana `description` seperti`summary`,,`runbook_url`, `dashboardUId` dan. `panelId` Seperti label khusus, anotasi harus memiliki nama, dan nilainya dapat berisi kombinasi teks dan kode templat yang dievaluasi saat peringatan diaktifkan. Jika anotasi berisi kode templat, templat dievaluasi sekali saat peringatan diaktifkan. Itu tidak dievaluasi ulang, bahkan ketika peringatan diselesaikan. Dokumentasi tentang cara membuat templat anotasi dapat ditemukan [di sini](v9-alerting-explore-labels-templating.md).

# Cara kerja pencocokan label
<a name="v9-alerting-explore-labels-matching"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan label dan pencocokan label untuk menautkan aturan peringatan ke kebijakan pemberitahuan dan pembungkaman. Ini memungkinkan cara yang sangat fleksibel untuk mengelola instance peringatan Anda, menentukan kebijakan mana yang harus ditangani, dan peringatan mana yang akan dibungkam.

**Pencocokan label terdiri dari 3 bagian yang berbeda, **label**, **nilai** dan operator.**
+ Bidang **Label** adalah nama label yang cocok. Itu harus sama persis dengan nama label.
+ Bidang **Nilai** cocok dengan nilai yang sesuai untuk nama **Label** yang ditentukan. Bagaimana kecocokannya tergantung pada nilai **Operator**.
+ Bidang **Operator** adalah operator yang cocok dengan nilai label. Operator yang tersedia adalah:


| Operator | Deskripsi | 
| --- | --- | 
|  `=`  |  Pilih label yang persis sama dengan nilainya.  | 
|  `!=`  |  Pilih label yang tidak sama dengan nilainya.  | 
|  `=~`  |  Pilih label yang sesuai dengan nilai regex-nya.  | 
|  `!~`  |  Pilih label yang tidak cocok dengan nilai.  | 

Jika Anda menggunakan beberapa pencocokan label, mereka digabungkan menggunakan operator logis AND. Ini berarti bahwa semua pencocokan harus cocok untuk menautkan aturan ke kebijakan.

**Contoh skenario**

Jika Anda menentukan kumpulan label berikut untuk peringatan Anda:

```
{ foo=bar, baz=qux, id=12 }
```

maka:
+ Pencocokan label yang didefinisikan sebagai `foo=bar` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `foo!=bar` *tidak* cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `id=~[0-9]+` cocok dengan aturan peringatan ini.
+ Pencocokan label yang didefinisikan sebagai `baz!~[0-9]+` cocok dengan aturan peringatan ini.
+ Dua pencocokan label didefinisikan sebagai `foo=bar` dan `id=~[0-9]+` cocok dengan aturan peringatan ini.

# Label di Grafana Alerting
<a name="v9-alerting-explore-labels-alerting"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Topik ini menjelaskan mengapa label merupakan komponen mendasar dari peringatan.
+ Set lengkap label untuk peringatan adalah apa yang secara unik mengidentifikasi peringatan dalam peringatan Grafana.
+ Alertmanager menggunakan label untuk mencocokkan peringatan untuk keheningan dan grup peringatan dalam kebijakan notifikasi.
+ UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan selama evaluasi aturan tersebut.
+ Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.
+ Anda dapat menambahkan label ke [aturan peringatan](v9-alerting-managerules.md). Label dapat dikonfigurasi secara manual, menggunakan fungsi templat, dan dapat mereferensikan label lain. Label yang ditambahkan ke aturan peringatan diutamakan jika terjadi tabrakan antar label (kecuali dalam kasus label yang dicadangkan Grafana, lihat di bawah untuk informasi lebih lanjut).

**Kompatibilitas Alertmanager Eksternal**

Alertmanager bawaan Grafana mendukung kunci dan nilai label Unicode. [Jika Anda menggunakan Prometheus Alertmanager eksternal, kunci label harus kompatibel dengan model datanya.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) Ini berarti bahwa kunci label hanya boleh berisi **huruf ASCII**, **angka**, serta **garis bawah** dan cocok dengan regex. `[a-zA-Z_][a-zA-Z0-9_]*` Setiap karakter yang tidak valid akan dihapus atau diganti oleh mesin peringatan Grafana sebelum dikirim ke Alertmanager eksternal sesuai dengan aturan berikut:
+ `Whitespace`akan dihapus.
+ `ASCII characters`akan diganti dengan`_`.
+ `All other characters`akan diganti dengan representasi hex huruf kecil mereka. Jika ini adalah karakter pertama, itu akan diawali dengan`_`.

**catatan**  
Jika beberapa kunci label disanitasi ke nilai yang sama, duplikat akan memiliki hash pendek dari label asli yang ditambahkan sebagai akhiran.

**Label yang dipesan Grafana**

**catatan**  
Label yang diawali dengan `grafana_` dicadangkan oleh Grafana untuk penggunaan khusus. Jika label yang dikonfigurasi secara manual ditambahkan dimulai dengan `grafana_` itu dapat ditimpa jika terjadi tabrakan.

Label yang dicadangkan Grafana dapat digunakan dengan cara yang sama seperti label yang dikonfigurasi secara manual. Daftar label cadangan yang tersedia saat ini adalah:


| Label | Deskripsi | 
| --- | --- | 
|  grafana\$1folder  |  Judul folder yang berisi peringatan.  | 

# Templating label dan anotasi
<a name="v9-alerting-explore-labels-templating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Di Grafana, Anda membuat template label dan anotasi seperti yang Anda lakukan di Prometheus. Jika Anda telah menggunakan Prometheus sebelumnya maka Anda harus terbiasa dengan `$labels` variabel `$value` dan, yang berisi label dan nilai peringatan. Anda dapat menggunakan variabel yang sama di Grafana, bahkan jika peringatan tidak menggunakan sumber data Prometheus. Jika Anda belum pernah menggunakan Prometheus sebelumnya maka jangan khawatir karena masing-masing variabel ini, dan cara membuat template mereka, akan dijelaskan saat Anda mengikuti sisa halaman ini.

## Bahasa Templating Go
<a name="v9-alerting-explore-labels-templating-go"></a>

[Template untuk label dan anotasi ditulis dalam bahasa template Go, teks/template.](https://pkg.go.dev/text/template)

**Membuka dan menutup tag**

Dalam teks/template, template dimulai dengan `{{` dan diakhiri dengan `}}` terlepas dari apakah template mencetak variabel atau menjalankan struktur kontrol seperti pernyataan if. Ini berbeda dari bahasa templating lainnya seperti Jinja di mana pencetakan variabel menggunakan `{{` dan `}}` dan struktur kontrol menggunakan `{%` dan. `%}`

**Cetak**

Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak hasil fungsi atau nilai variabel. Misalnya, untuk mencetak `$labels` variabel Anda akan menulis yang berikut:

```
{{ $labels }}
```

**Iterasi di atas label**

Untuk mengulangi setiap label di `$labels` Anda dapat menggunakan. `range` Di sini `$k` mengacu pada nama dan `$v` mengacu pada nilai label saat ini. Misalnya, jika kueri Anda mengembalikan label `instance=test` maka `$k` akan `instance` dan `$v` akan menjadi`test`.

```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```

## Label, nilai dan nilai variabel
<a name="v9-alerting-explore-labels-templating-variables"></a>

**Variabel label**

`$labels`Variabel berisi label dari kueri. Misalnya, kueri yang memeriksa apakah instance sedang down mungkin mengembalikan label instance dengan nama instance yang sedang down. Misalnya, Anda memiliki aturan peringatan yang menyala ketika salah satu instance Anda telah mati selama lebih dari 5 menit. Anda ingin menambahkan ringkasan ke peringatan yang memberi tahu Anda instance mana yang sedang down. Dengan `$labels` variabel, Anda dapat membuat ringkasan yang mencetak label instance dalam ringkasan:

```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```

**Label dengan titik-titik**

Jika label yang ingin Anda cetak berisi titik (penghentian penuh atau titik) dalam namanya menggunakan titik yang sama di templat tidak akan berfungsi:

```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```

Ini karena template mencoba menggunakan bidang yang tidak ada yang dipanggil`name`. `$labels.instance` Anda sebaiknya menggunakan `index` fungsi, yang mencetak label `instance.name` dalam `$labels` variabel:

```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```

**Variabel nilai**

`$value`Variabel bekerja berbeda dari Prometheus. Dalam `$value` Prometheus adalah nomor floating point yang berisi nilai ekspresi, tetapi di Grafana itu adalah string yang berisi label dan nilai dari semua ekspresi Ambang, Kurangi dan Matematika, dan Kondisi Klasik untuk aturan peringatan ini. Ini tidak berisi hasil kueri, karena ini dapat kembali dari 10 hingga 10.000 baris atau metrik.

Jika Anda menggunakan `$value` variabel dalam ringkasan peringatan:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```

Ringkasannya mungkin terlihat seperti berikut:

```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```

Di sini `var='B'` mengacu pada ekspresi dengan RefiD B. Di Grafana, semua kueri dan ekspresi diidentifikasi oleh ReFID yang mengidentifikasi setiap kueri dan ekspresi dalam aturan peringatan. Demikian pula `labels={service=api}` mengacu pada label, dan `value=6.789` mengacu pada nilai.

Anda mungkin telah mengamati bahwa tidak ada ReFID A. Itu karena di sebagian besar aturan peringatan ReFID A mengacu pada kueri, dan karena kueri dapat mengembalikan banyak baris atau deret waktu mereka tidak termasuk dalam. `$value`

**Variabel nilai**

Jika `$value` variabel berisi lebih banyak informasi daripada yang Anda butuhkan, Anda dapat mencetak label dan nilai ekspresi individu menggunakan`$values`. Tidak seperti`$value`, `$values` variabel adalah tabel objek yang berisi label dan nilai floating point dari setiap ekspresi, diindeks oleh ReFID mereka.

Jika Anda mencetak nilai ekspresi dengan ReFID `B` dalam ringkasan peringatan:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```

Ringkasan hanya akan berisi nilai:

```
api has an over 5% of responses with 5xx errors: 6.789%
```

Namun, saat `{{ $values.B }}` mencetak angka 6.789, itu sebenarnya adalah string karena Anda mencetak objek yang berisi label dan nilai untuk RefiD B, bukan nilai floating point B. Untuk menggunakan nilai floating point dari RefiD B Anda harus menggunakan bidang dari. `Value` `$values.B` Jika Anda memanusiakan nilai floating point dalam ringkasan peringatan:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```

**Tidak ada data, kesalahan runtime, dan batas waktu**

Jika kueri dalam aturan peringatan Anda tidak mengembalikan data, atau gagal karena kesalahan sumber data atau batas waktu, maka ekspresi Threshold, Reduce atau Math apa pun yang menggunakan kueri itu juga tidak akan mengembalikan data atau kesalahan. Ketika ini terjadi ungkapan ini akan absen dari`$values`. Merupakan praktik yang baik untuk memeriksa apakah ReFID ada sebelum menggunakannya karena jika tidak, template Anda akan rusak jika kueri Anda tidak mengembalikan data atau kesalahan. Anda dapat melakukan ini menggunakan pernyataan if:

```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```

## Kondisi Klasik
<a name="v9-alerting-explore-labels-templating-classic"></a>

Jika aturan menggunakan Classic Conditions bukan Threshold, Reduce dan Math ekspresi, maka `$values` variabel diindeks oleh kedua ID Ref dan posisi kondisi dalam Kondisi Klasik. Misalnya, jika Anda memiliki Kondisi Klasik dengan ReFID B yang berisi dua kondisi, maka `$values` akan berisi dua kondisi `B0` dan. `B1`

```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```

## Fungsi
<a name="v9-alerting-explore-labels-templating-functions"></a>

Fungsi-fungsi berikut juga tersedia saat memperluas label dan anotasi:

**args**

`args`Fungsi menerjemahkan daftar objek ke peta dengan kunci arg0, arg1 dll Ini dimaksudkan untuk memungkinkan beberapa argumen diteruskan ke template.

**Contoh**

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL eksternal**

`externalURL`Fungsi mengembalikan URL eksternal dari server Grafana seperti yang dikonfigurasi dalam file ini (s).

**Contoh**

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

`graphLink`Fungsi mengembalikan path ke tampilan grafis [Jelajahi di Grafana versi 9](v9-explore.md) untuk ekspresi yang diberikan dan sumber data.

**Contoh**

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**memanusiakan**

`humanize`Fungsi memanusiakan angka desimal.

**Contoh**

```
{{ humanize 1000.0 }}
```

```
1k
```

**manusia1024**

`humanize1024`Karya-karya yang mirip dengan `humanize` tetapi menggunakan 1024 sebagai basis daripada 1000.

**Contoh**

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**HumanizeUrasi**

`humanizeDuration`Fungsi memanusiakan durasi dalam hitungan detik.

**Contoh**

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**HumanizePersentase**

`humanizePercentage`Fungsi memanusiakan nilai rasio terhadap persentase.

**Contoh**

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**HumanizeTimestamp**

`humanizeTimestamp`Fungsi ini memanusiakan stempel waktu Unix.

**Contoh**

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**pertandingan**

`match`Fungsi ini cocok dengan teks terhadap pola ekspresi reguler.

**Contoh**

```
{{ match "a.*" "abc" }}
```

```
true
```

**PathPrefix**

`pathPrefix`Fungsi mengembalikan path dari server Grafana seperti yang dikonfigurasi dalam file ini (s).

**Contoh**

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

`tableLink`Fungsi mengembalikan path ke tampilan tabular [Jelajahi di Grafana versi 9](v9-explore.md) untuk ekspresi yang diberikan dan sumber data.

**Contoh**

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**judul**

`title`Fungsi ini mengkapitalisasi karakter pertama dari setiap kata.

**Contoh**

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**ToLower**

`toLower`Fungsi mengembalikan semua teks dalam huruf kecil.

**Contoh**

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**TouPper**

`toUpper`Fungsi mengembalikan semua teks dalam huruf besar.

**Contoh**

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

`reReplaceAll`Fungsi menggantikan teks yang cocok dengan ekspresi reguler.

**Contoh**

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Keadaan dan kesehatan aturan peringatan
<a name="v9-alerting-explore-state"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Keadaan dan kesehatan aturan peringatan membantu Anda memahami beberapa indikator status utama tentang peringatan Anda.

Ada tiga komponen utama: *status aturan peringatan, status* *instance peringatan*, dan *kesehatan aturan peringatan*. Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Status aturan peringatan**

Aturan peringatan dapat berada di salah satu dari status berikut:


| Status | Deskripsi | 
| --- | --- | 
|  Normal  |  Tak satu pun dari deret waktu yang dikembalikan oleh mesin evaluasi dalam `Firing` keadaan `Pending` atau.  | 
|  Tertunda  |  Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Pending`.  | 
|  Menembak  |  Setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi adalah`Firing`.  | 

**catatan**  
Peringatan akan bertransisi pertama ke `pending` dan kemudian`firing`, sehingga akan membutuhkan setidaknya dua siklus evaluasi sebelum peringatan diaktifkan.

**Status contoh peringatan**

Instance peringatan dapat berada di salah satu dari status berikut:


| Status | Deskripsi | 
| --- | --- | 
|  Normal  |  Keadaan peringatan yang tidak menembak atau tertunda, semuanya berfungsi dengan benar.  | 
|  Tertunda  |  Status peringatan yang telah aktif kurang dari durasi ambang batas yang dikonfigurasi.  | 
|  Peringatan  |  Status peringatan yang telah aktif lebih lama dari durasi ambang batas yang dikonfigurasi.  | 
|  NoData  |  Tidak ada data yang diterima untuk jendela waktu yang dikonfigurasi.  | 
|  Kesalahan  |  Kesalahan yang terjadi saat mencoba mengevaluasi aturan peringatan.  | 

**Peringatan aturan kesehatan**

Aturan peringatan dapat memiliki satu status kesehatan berikut:


| Status | Deskripsi | 
| --- | --- | 
|  Oke  |  Tidak ada kesalahan saat mengevaluasi aturan peringatan.  | 
|  Kesalahan  |  Terjadi kesalahan saat mengevaluasi aturan peringatan.  | 
|  NoData  |  Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan.  | 

**Peringatan khusus untuk `NoData` dan `Error`**

Saat evaluasi aturan peringatan menghasilkan status `NoData` atau`Error`, Grafana Alerting akan menghasilkan instance peringatan yang memiliki label tambahan berikut:


| Label | Deskripsi | 
| --- | --- | 
|  nama peringatan  |  Baik `DatasourceNoData` atau `DatasourceError` tergantung pada negara.  | 
|  datasource\$1uid  |  UID dari sumber data yang menyebabkan negara.  | 

Anda dapat menangani peringatan ini dengan cara yang sama seperti peringatan biasa dengan menambahkan keheningan, rute ke titik kontak, dan sebagainya.

# Titik kontak
<a name="v9-alerting-explore-contacts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan titik kontak untuk menentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan. Titik kontak dapat memiliki satu atau lebih jenis titik kontak, misalnya, email, Slack, webhook, dan sebagainya. Ketika aturan peringatan diaktifkan, pemberitahuan dikirim ke semua jenis titik kontak yang terdaftar untuk titik kontak. Titik kontak dapat dikonfigurasi untuk Grafana Alertmanager serta manajer peringatan eksternal.

Anda juga dapat menggunakan template notifikasi untuk menyesuaikan pesan notifikasi untuk jenis titik kontak.

**Jenis titik kontak yang didukung**

Tabel berikut mencantumkan jenis titik kontak yang didukung oleh Grafana.


| Nama | Tipe | 
| --- | --- | 
|  Amazon SNS  |  `sns`  | 
|  OpsGenie  |  `opsgenie`  | 
|  Tugas Pager  |  `pagerduty`  | 
|  Slack  |  `slack`  | 
|  VictorOps  |  `victorops`  | 

Untuk informasi lebih lanjut tentang titik kontak, lihat [Bekerja dengan titik kontak](v9-alerting-contact-points.md) dan[Sesuaikan notifikasi](v9-alerting-notifications.md).

# Notifikasi
<a name="v9-alerting-explore-notifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana menggunakan Alertmanagers untuk mengirim notifikasi untuk mengaktifkan dan menyelesaikan peringatan. [Grafana memiliki Alertmanager sendiri, disebut sebagai “Grafana” di antarmuka pengguna, tetapi juga mendukung pengiriman pemberitahuan dari Alertmanager lain juga, seperti Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Grafana Alertmanager menggunakan kebijakan notifikasi dan titik kontak untuk mengonfigurasi bagaimana dan di mana pemberitahuan dikirim; seberapa sering pemberitahuan harus dikirim; dan apakah semua peringatan harus dikirim dalam pemberitahuan yang sama, dikirim dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau sebagai pemberitahuan terpisah.

## Kebijakan pemberitahuan
<a name="v9-alerting-explore-notifications-policies"></a>

Kebijakan notifikasi mengontrol kapan dan di mana notifikasi dikirim. Kebijakan notifikasi dapat memilih untuk mengirim semua peringatan bersama-sama dalam pemberitahuan yang sama, mengirim peringatan dalam pemberitahuan yang dikelompokkan berdasarkan kumpulan label, atau mengirim peringatan sebagai pemberitahuan terpisah. Anda dapat mengonfigurasi setiap kebijakan notifikasi untuk mengontrol seberapa sering pemberitahuan harus dikirim serta memiliki satu atau lebih waktu bisu untuk menghambat pemberitahuan pada waktu-waktu tertentu dalam sehari dan pada hari-hari tertentu dalam seminggu.

Kebijakan pemberitahuan diatur dalam struktur pohon di mana pada akar pohon ada kebijakan pemberitahuan yang disebut kebijakan root. Hanya ada satu kebijakan root dan kebijakan root tidak dapat dihapus.

Kebijakan perutean khusus adalah turunan dari kebijakan root dan dapat digunakan untuk mencocokkan semua peringatan atau subset peringatan berdasarkan sekumpulan label yang cocok. Kebijakan notifikasi cocok dengan peringatan ketika label yang cocok cocok dengan label dalam peringatan.

Kebijakan perutean tertentu dapat memiliki kebijakan turunannya sendiri, yang disebut kebijakan bersarang, yang memungkinkan pencocokan peringatan tambahan. Contoh kebijakan perutean tertentu dapat mengirimkan peringatan infrastruktur ke tim Ops; sementara kebijakan anak mungkin mengirim peringatan prioritas tinggi ke Pagerduty dan peringatan prioritas rendah ke Slack.

Semua peringatan, terlepas dari labelnya, cocok dengan kebijakan root. Namun, ketika kebijakan root menerima peringatan, kebijakan perutean akan melihat setiap kebijakan perutean tertentu dan mengirimkan peringatan ke kebijakan perutean spesifik pertama yang cocok dengan peringatan tersebut. Jika kebijakan perutean tertentu memiliki kebijakan turunan lebih lanjut, maka kebijakan tersebut dapat mencoba mencocokkan peringatan dengan salah satu kebijakan bersarangnya. Jika tidak ada kebijakan bersarang yang cocok dengan peringatan maka kebijakan perutean tertentu adalah kebijakan yang cocok. Jika tidak ada kebijakan perutean tertentu, atau tidak ada kebijakan perutean tertentu yang cocok dengan peringatan, maka kebijakan root adalah kebijakan yang cocok.

## Titik kontak
<a name="v9-alerting-explore-notifications-contacts"></a>

Titik kontak berisi konfigurasi untuk mengirim pemberitahuan. Titik kontak adalah daftar integrasi, yang masing-masing mengirimkan pemberitahuan ke alamat email, layanan, atau URL tertentu. Titik kontak dapat memiliki beberapa integrasi dari jenis yang sama, atau kombinasi integrasi dari berbagai jenis. Misalnya, titik kontak dapat berisi integrasi Pager Duty; Pager Duty dan integrasi Slack; atau integrasi Pager Duty, integrasi Slack, dan dua integrasi Amazon SNS. Anda juga dapat mengonfigurasi titik kontak tanpa integrasi; dalam hal ini tidak ada pemberitahuan yang dikirim.

Titik kontak tidak dapat mengirim pemberitahuan sampai telah ditambahkan ke kebijakan pemberitahuan. Kebijakan pemberitahuan hanya dapat mengirim peringatan ke satu titik kontak, tetapi titik kontak dapat ditambahkan ke sejumlah kebijakan pemberitahuan secara bersamaan. Ketika peringatan cocok dengan kebijakan notifikasi, peringatan dikirim ke titik kontak dalam kebijakan notifikasi tersebut, yang kemudian mengirimkan pemberitahuan ke setiap integrasi dalam konfigurasinya.

**catatan**  
Untuk informasi tentang integrasi yang didukung untuk titik kontak, lihat[Titik kontak](v9-alerting-explore-contacts.md).

## Pemberitahuan Templating
<a name="v9-alerting-explore-notifications-templating"></a>

Anda dapat menyesuaikan notifikasi dengan templat. Misalnya, template dapat digunakan untuk mengubah judul dan pesan notifikasi yang dikirim ke Slack.

Template tidak terbatas pada integrasi individu atau titik kontak, tetapi dapat digunakan dalam sejumlah integrasi di titik kontak yang sama dan bahkan integrasi di berbagai titik kontak. Misalnya, pengguna Grafana dapat membuat template yang disebut `custom_subject_or_title` dan menggunakannya untuk subjek templating di Pager Duty dan judul pesan Slack tanpa harus membuat dua templat terpisah.

Semua template notifikasi ditulis dalam [bahasa template Go](https://pkg.go.dev/text/template), dan berada di tab Titik kontak di halaman Peringatan.

## Keheningan
<a name="v9-alerting-explore-notifications-silences"></a>

Anda dapat menggunakan keheningan untuk membisukan notifikasi dari satu atau beberapa aturan penembakan. Keheningan tidak menghentikan peringatan agar tidak ditembakkan atau diselesaikan, atau menyembunyikan peringatan penembakan di antarmuka pengguna. Keheningan berlangsung selama durasinya yang dapat dikonfigurasi dalam hitungan menit, jam, hari, bulan atau tahun.

# Mengatur Peringatan
<a name="v9-alerting-setup"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Konfigurasikan fitur dan integrasi yang Anda butuhkan untuk membuat dan mengelola peringatan Anda.

**Topics**
+ [Tambahkan Alertmanager eksternal](v9-alerting-setup-alertmanager.md)
+ [Penyediaan sumber daya Peringatan Grafana](v9-alerting-setup-provision.md)

# Tambahkan Alertmanager eksternal
<a name="v9-alerting-setup-alertmanager"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Siapkan Grafana untuk menggunakan Alertmanager eksternal sebagai Alertmanager tunggal untuk menerima semua peringatan Anda. Alertmanager eksternal ini kemudian dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

Setelah menambahkan Alertmanager, Anda dapat menggunakan Grafana Alerting UI untuk mengelola keheningan, titik kontak, dan kebijakan notifikasi. Opsi dropdown di halaman ini memungkinkan Anda untuk beralih di antara manajer peringatan.

**catatan**  
Dimulai dengan Grafana 9.2, konfigurasi URL pengelola peringatan eksternal dari tab Admin di halaman Peringatan tidak digunakan lagi. Ini akan dihapus dalam rilis future.

Manajer peringatan eksternal sekarang harus dikonfigurasi sebagai sumber data menggunakan Konfigurasi Grafana dari menu navigasi Grafana utama. Ini memungkinkan Anda untuk mengelola titik kontak dan kebijakan pemberitahuan manajer peringatan eksternal dari dalam Grafana dan juga mengenkripsi kredensi otentikasi dasar HTTP yang sebelumnya terlihat saat mengonfigurasi pengelola peringatan eksternal berdasarkan URL.

Untuk menambahkan Alertmanager eksternal, selesaikan langkah-langkah berikut.

1. Klik Konfigurasi dan kemudian Sumber data.

1. Cari Alertmanager.

1. Pilih Implementasi Anda dan isi kolom pada halaman, sesuai kebutuhan.

   Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.
**catatan**  
Prometheus, Grafana Mimir, dan implementasi Cortex dari Alertmanager didukung. Untuk Prometheus, titik kontak dan kebijakan notifikasi hanya-baca di UI Peringatan Grafana.

1. Klik Simpan & uji.

# Penyediaan sumber daya Peringatan Grafana
<a name="v9-alerting-setup-provision"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Infrastruktur peringatan seringkali rumit, dengan banyak potongan pipa yang sering tinggal di tempat yang berbeda. Menskalakan ini di beberapa tim dan organisasi adalah tugas yang sangat menantang. Penyediaan Grafana Alerting membuat proses ini lebih mudah dengan memungkinkan Anda membuat, mengelola, dan memelihara data peringatan Anda dengan cara yang paling sesuai dengan organisasi Anda.

Ada dua opsi untuk dipilih:

1. Menyediakan sumber daya peringatan Anda menggunakan API HTTP Penyediaan Peringatan.
**catatan**  
Biasanya, Anda tidak dapat mengedit aturan peringatan yang disediakan API dari UI Grafana.  
Untuk mengaktifkan pengeditan, tambahkan x-disable-provenance header ke permintaan berikut saat membuat atau mengedit aturan peringatan Anda di API:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Menyediakan sumber peringatan Anda menggunakan Terraform.

**catatan**  
Saat ini, penyediaan Grafana Alerting mendukung aturan peringatan, titik kontak, pengaturan waktu bisu, dan templat. Sumber daya peringatan yang disediakan menggunakan penyediaan file atau Terraform hanya dapat diedit di sumber yang membuatnya dan bukan dari dalam Grafana atau sumber lainnya. Misalnya, jika Anda menyediakan sumber peringatan menggunakan file dari disk, Anda tidak dapat mengedit data di Terraform atau dari dalam Grafana.

**Topics**
+ [Buat dan kelola sumber daya peringatan menggunakan Terraform](v9-alerting-setup-provision-terraform.md)
+ [Melihat sumber peringatan yang disediakan di Grafana](v9-alerting-setup-provision-view.md)

# Buat dan kelola sumber daya peringatan menggunakan Terraform
<a name="v9-alerting-setup-provision-terraform"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan Penyedia Grafana Terraform untuk mengelola sumber daya peringatan Anda dan menyediakannya ke dalam sistem Grafana Anda. Dukungan penyedia Terraform untuk Grafana Alerting memudahkan untuk membuat, mengelola, dan memelihara seluruh tumpukan Grafana Alerting Anda sebagai kode.

Untuk informasi lebih lanjut tentang mengelola sumber daya peringatan Anda menggunakan Terraform, lihat dokumentasi [Penyedia](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Grafana di dokumentasi Terraform.

Selesaikan tugas-tugas berikut untuk membuat dan mengelola sumber peringatan Anda menggunakan Terraform.

1. Buat kunci API untuk penyediaan.

1. Konfigurasikan penyedia Terraform.

1. Tentukan sumber peringatan Anda di Terraform.

1. Jalankan `terraform apply` untuk menyediakan sumber peringatan Anda.

## Prasyarat
<a name="v9-alerting-setup-provision-tf-prerequisites"></a>
+ Pastikan Anda memiliki [penyedia grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 atau lebih tinggi.
+ Pastikan Anda menggunakan Grafana 9.1 atau lebih tinggi. Jika Anda membuat instance Grafana Terkelola Amazon dengan Grafana versi 9, ini benar.

## Membuat kunci API untuk penyediaan
<a name="v9-alerting-setup-provision-tf-apikey"></a>

Anda dapat [membuat kunci API Grafana normal](Using-Grafana-APIs.md) untuk mengautentikasi Terraform dengan Grafana. Sebagian besar perkakas yang ada menggunakan kunci API akan secara otomatis bekerja dengan dukungan Grafana Alerting yang baru. Untuk informasi khusus tentang membuat kunci untuk digunakan dengan Terraform, lihat [Menggunakan Terraform untuk otomatisasi Grafana Terkelola Amazon](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/).

**Untuk membuat kunci API untuk penyediaan**

1. Buat akun layanan baru untuk pipeline CI Anda.

1. Tetapkan peran “Akses API Penyediaan aturan peringatan.”

1. Buat token akun layanan baru.

1. Beri nama dan simpan token untuk digunakan di Terraform.

Atau, Anda dapat menggunakan otentikasi dasar. Untuk melihat semua format otentikasi yang didukung, lihat Autentikasi [Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) di dokumentasi Terraform.

## Konfigurasikan penyedia Terraform
<a name="v9-alerting-setup-provision-tf-configure"></a>

[Dukungan Grafana Alerting disertakan sebagai bagian dari penyedia Grafana Terraform.](https://registry.terraform.io/providers/grafana/grafana/latest/docs)

Berikut ini adalah contoh yang dapat Anda gunakan untuk mengonfigurasi penyedia Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Penyediaan titik kontak dan templat
<a name="v9-alerting-setup-provision-tf-contacts"></a>

Titik kontak menghubungkan tumpukan peringatan ke dunia luar. Mereka memberi tahu Grafana cara terhubung ke sistem eksternal Anda dan di mana mengirimkan pemberitahuan. Ada lebih dari lima belas [integrasi](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) berbeda untuk dipilih. Contoh ini menggunakan titik kontak Slack.

**Untuk menyediakan titik kontak dan templat**

1. Salin blok kode ini ke file.tf di mesin lokal Anda. Ganti *<slack-webhook-url>* dengan URL webhook Slack Anda (atau kontak lainnya

   Contoh ini menciptakan titik kontak yang mengirimkan pemberitahuan peringatan ke Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Masukkan teks untuk notifikasi Anda di bidang teks.

   `text`Bidang ini mendukung [Templating Go-style](https://pkg.go.dev/text/template). Ini memungkinkan Anda untuk mengelola templat notifikasi Grafana Alerting Anda langsung di Terraform.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail titik kontak Anda.

   Anda tidak dapat mengedit sumber daya yang disediakan melalui Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik kontak berfungsi dengan benar.

**catatan**  
Anda dapat menggunakan kembali template yang sama di banyak titik kontak. Dalam contoh di atas, template bersama yaitu disematkan menggunakan pernyataan `{{ template "Alert Instance Template" . }}`  
Fragmen ini kemudian dapat dikelola secara terpisah di Terraform:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Kebijakan pemberitahuan penyediaan dan perutean
<a name="v9-alerting-setup-provision-tf-notifications"></a>

Kebijakan notifikasi memberi tahu Grafana cara merutekan instance peringatan, sebagai lawan dari where. Mereka menghubungkan peringatan penembakan ke titik kontak yang Anda tentukan sebelumnya menggunakan sistem label dan pencocokan.

**Untuk menyediakan kebijakan pemberitahuan dan perutean**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, peringatan dikelompokkan berdasarkan`alertname`, yang berarti bahwa setiap pemberitahuan yang berasal dari peringatan yang memiliki nama yang sama, dikelompokkan ke dalam pesan Slack yang sama.

   Jika Anda ingin merutekan pemberitahuan tertentu secara berbeda, Anda dapat menambahkan sub-kebijakan. Sub-kebijakan memungkinkan Anda menerapkan perutean ke peringatan yang berbeda berdasarkan pencocokan label. Dalam contoh ini, kami menerapkan waktu bisu ke semua peringatan dengan label a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Di bidang mute\$1timings, tautkan waktu bisu ke kebijakan notifikasi Anda.

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail kebijakan notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa titik notifikasi berfungsi dengan benar.

## Ketentuan waktu bisu
<a name="v9-alerting-setup-provision-tf-mutetiming"></a>

Pengaturan waktu bisu memberikan kemampuan untuk membisukan pemberitahuan peringatan untuk periode waktu yang ditentukan.

**Untuk menyediakan timing bisu**

1. Salin blok kode ini ke file.tf di mesin lokal Anda.

   Dalam contoh ini, notifikasi peringatan dibisukan pada akhir pekan.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Jalankan perintah `terraform apply`.

1. Buka Grafana UI dan periksa detail waktu bisu Anda.

1. Referensikan waktu bisu yang baru dibuat dalam kebijakan notifikasi menggunakan `mute_timings` bidang. Ini akan menerapkan waktu bisu Anda ke beberapa atau semua notifikasi Anda.
**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Terraform dari UI. Ini memastikan bahwa tumpukan peringatan Anda selalu sinkron dengan kode Anda.

1. Klik **Uji** untuk memverifikasi bahwa waktu bisu berfungsi dengan benar.

## Aturan peringatan ketentuan
<a name="v9-alerting-setup-provision-tf-rules"></a>

[Aturan peringatan](v9-alerting-managerules.md) memungkinkan Anda untuk memperingatkan terhadap sumber data Grafana apa pun. Ini bisa berupa sumber data yang sudah Anda konfigurasikan, atau Anda dapat [menentukan sumber data Anda di Terraform bersama aturan](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) peringatan Anda.

**Untuk menyediakan aturan peringatan**

1. Buat sumber data untuk kueri dan folder untuk menyimpan aturan Anda.

   Dalam contoh ini, sumber [Konfigurasikan sumber TestData data untuk pengujian](testdata-data-source.md) data digunakan.

   Peringatan dapat didefinisikan terhadap sumber data backend apa pun di Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Tentukan aturan peringatan.

   Untuk informasi selengkapnya tentang aturan peringatan, lihat [cara membuat lansiran yang dikelola Grafana.](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/)

1. Buat grup aturan yang berisi satu atau beberapa aturan.

   Dalam contoh ini, grup `grafana_rule_group` sumber daya digunakan.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Buka UI Grafana dan periksa aturan peringatan Anda.

   Anda dapat melihat apakah aturan peringatan menyala. Anda juga dapat melihat visualisasi setiap tahapan kueri aturan peringatan.

   Saat peringatan diaktifkan, Grafana merutekan notifikasi melalui kebijakan yang Anda tetapkan.

   Misalnya, jika Anda memilih Slack sebagai titik kontak, [Alertmanager](https://github.com/prometheus/alertmanager) tertanam Grafana secara otomatis memposting pesan ke Slack.

# Melihat sumber peringatan yang disediakan di Grafana
<a name="v9-alerting-setup-provision-view"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

 Anda dapat memverifikasi bahwa sumber peringatan Anda dibuat di Grafana.

**Untuk melihat sumber daya yang Anda sediakan di Grafana**

1. Buka instance Grafana Anda.

1. Arahkan ke Peringatan.

1. Klik folder sumber peringatan, misalnya, Aturan peringatan.

   Sumber daya yang disediakan diberi label **Provisioned**, sehingga jelas bahwa mereka tidak dibuat secara manual.

**catatan**  
Anda tidak dapat mengedit sumber daya yang disediakan dari Grafana. Anda hanya dapat mengubah properti sumber daya dengan mengubah file penyediaan dan memulai ulang Grafana atau melakukan hot reload. Ini mencegah perubahan yang dilakukan pada sumber daya yang akan ditimpa jika file disediakan lagi atau hot reload dilakukan.

# Memigrasi peringatan dasbor klasik ke peringatan Grafana
<a name="v9-alerting-use-grafana-alerts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Ruang kerja yang memilih untuk tidak menggunakan peringatan Grafana, gunakan peringatan dasbor klasik. Untuk beralih ke peringatan Grafana baru, Anda harus ikut serta dalam fitur tersebut.

Anda dapat mengonfigurasi instans Grafana Terkelola Amazon untuk menggunakan peringatan Grafana menggunakan API Grafana yang Dikelola Amazon Konsol Manajemen AWS, AWS CLI atau Amazon. Untuk detail tentang cara mengonfigurasi Grafana Terkelola Amazon, termasuk mengaktifkan atau menonaktifkan peringatan Grafana, lihat. [Konfigurasikan ruang kerja Grafana yang Dikelola Amazon](AMG-configure-workspace.md)

**catatan**  
Saat menggunakan peringatan Grafana, aturan peringatan yang ditentukan di Grafana, bukan di Prometheus, kirim beberapa pemberitahuan ke titik kontak Anda. Jika Anda menggunakan peringatan Grafana asli, kami sarankan Anda tetap menggunakan peringatan dasbor klasik dan tidak mengaktifkan fitur peringatan Grafana baru. Jika Anda ingin melihat Peringatan yang ditentukan dalam sumber data Prometheus Anda, maka kami sarankan Anda mengaktifkan Peringatan Grafana, yang hanya mengirimkan satu pemberitahuan untuk peringatan yang dibuat di Prometheus Alertmanager.  
Batasan ini telah dihapus di ruang kerja Grafana Terkelola Amazon yang mendukung Grafana v10.4 dan yang lebih baru.

## Bermigrasi ke sistem peringatan Grafana
<a name="v9-alerting-use-grafana-alerts-opt-in"></a>

Saat peringatan Grafana diaktifkan, peringatan dasbor klasik yang ada bermigrasi dalam format yang kompatibel dengan peringatan Grafana. Di halaman Peringatan instans Grafana Anda, Anda dapat melihat peringatan yang dimigrasi bersama peringatan baru. Dengan peringatan Grafana, aturan peringatan yang dikelola Grafana Anda mengirim beberapa notifikasi, bukan satu peringatan saat dicocokkan.

Akses baca dan tulis ke lansiran dasbor klasik dan peringatan Grafana diatur oleh izin folder yang menyimpannya. Selama migrasi, izin peringatan dasbor klasik dicocokkan dengan izin aturan baru sebagai berikut:
+ Jika dasbor peringatan asli memiliki izin, migrasi akan membuat folder bernama dengan format ini `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` agar sesuai dengan izin dasbor asli (termasuk izin yang diwariskan dari folder).
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder, maka aturan tersebut ditautkan ke folder ini dan mewarisi izinnya.
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder Umum, maka aturan tersebut ditautkan ke folder General Alerting, dan aturan mewarisi izin default.

**catatan**  
Karena tidak ada `Keep Last State` opsi untuk `NoData` peringatan Grafana, opsi ini menjadi `NoData` selama migrasi aturan klasik. Opsi `Keep Last State` untuk `Error` penanganan dimigrasikan ke opsi `Error` baru. Untuk mencocokkan perilaku`Keep Last State`, dalam kedua kasus, selama migrasi Grafana yang Dikelola Amazon secara otomatis membuat keheningan untuk setiap aturan peringatan dengan durasi satu tahun.

Saluran notifikasi dimigrasikan ke konfigurasi Alertmanager dengan rute dan penerima yang sesuai. Saluran pemberitahuan default ditambahkan sebagai titik kontak ke rute default. Saluran pemberitahuan yang tidak terkait dengan peringatan Dasbor apa pun masuk ke `autogen-unlinked-channel-recv` rute.

### Batasan
<a name="v9-alerting-use-grafana-alerts-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan peringatan dari sumber data lain yang didukung.
+ Migrasi bolak-balik antara peringatan Grafana dan peringatan dasbor klasik dapat mengakibatkan hilangnya data untuk fitur yang didukung dalam satu sistem, tetapi tidak yang lain.
**catatan**  
Jika Anda bermigrasi kembali ke peringatan dasbor klasik, Anda kehilangan semua perubahan yang dibuat pada konfigurasi peringatan yang dibuat saat peringatan Grafana diaktifkan, termasuk aturan peringatan baru yang dibuat.

# Kelola aturan peringatan Anda
<a name="v9-alerting-managerules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah peringatan akan menyala. Aturan peringatan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan secara opsional, durasi di mana kondisi terpenuhi.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi atau dilampaui peringatan untuk membuat peringatan. Interval menentukan seberapa sering aturan peringatan dievaluasi. Durasi, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan peringatan juga dapat menentukan perilaku peringatan tanpa adanya data.

**catatan**  
Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan.  
Aturan peringatan untuk instans Grafana Mimir atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.

**Topics**
+ [Membuat aturan peringatan terkelola Grafana](v9-alerting-managerules-grafana.md)
+ [Membuat aturan peringatan terkelola Grafana Mimir atau Loki](v9-alerting-managerules-mimir-loki.md)
+ [Membuat aturan perekaman terkelola Grafana Mimir atau Loki](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir atau grup aturan Loki dan ruang nama](v9-alerting-managerules-mimir-loki-groups.md)
+ [Melihat dan mengedit aturan peringatan](v9-alerting-managerules-view-edit.md)

# Membuat aturan peringatan terkelola Grafana
<a name="v9-alerting-managerules-grafana"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grafana memungkinkan Anda membuat aturan peringatan yang menanyakan satu atau lebih sumber data, mengurangi atau mengubah hasil dan membandingkannya satu sama lain atau dengan ambang batas tetap. Saat ini dijalankan, Grafana mengirimkan notifikasi ke titik kontak.

**Untuk menambahkan aturan terkelola Grafana**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + **Dari tarik-turun **Jenis aturan**, pilih Grafana managed alert.**
   + Dari dropdown **Folder**, pilih folder tempat Anda ingin menyimpan aturan. Jika Anda tidak memilih folder, aturan disimpan dalam `General` folder. Untuk membuat folder, pilih dropdown dan masukkan nama folder baru.

1. Pada **Langkah 2**, tambahkan kueri dan ekspresi untuk mengevaluasi.
   + Simpan nama default atau arahkan kursor ke atas dan pilih ikon edit untuk mengubah nama.
   + Untuk kueri, pilih sumber data dari dropdown.
   + Tambahkan satu atau beberapa [kueri atau ekspresi](v9-panels-query-xform-expressions.md).
   + Untuk setiap ekspresi, pilih salah satu **kondisi Klasik** untuk membuat aturan peringatan tunggal, atau pilih dari opsi **Matematika**, **Kurangi**, **Sampel ulang** untuk menghasilkan peringatan terpisah untuk setiap seri. Untuk detail tentang opsi ini, lihat[Aturan tunggal dan multidimensi](#v9-alerting-single-multi-rule).
   + Pilih **Jalankan kueri** untuk memverifikasi bahwa kueri berhasil.

1. Pada **Langkah 3**, tambahkan kondisi.
   + Dari **kondisi** tarik-turun, pilih kueri atau ekspresi untuk memulai aturan peringatan.
   + Untuk **Evaluasi setiap**, tentukan frekuensi evaluasi. Harus kelipatan 10 detik. Misalnya,`1m`,`30s`.
   + **Untuk Evaluasi** untuk, tentukan durasi kondisinya harus benar sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi dilanggar, peringatan masuk ke `Pending` status. Jika kondisi tetap dilanggar selama durasi yang ditentukan, peringatan akan beralih ke status. `Firing` Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.
   + Di **Konfigurasikan tidak ada data dan penanganan kesalahan**, konfigurasikan perilaku peringatan jika tidak ada data. gunakan pedoman di. [Tidak menangani data atau kasus kesalahan](#v9-alerting-rule-no-data-error)
   + Pilih **Pratinjau lansiran** untuk memeriksa hasil menjalankan kueri saat ini. Pratinjau mengecualikan tidak ada data dan kondisi penanganan kesalahan.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Label dan anotasi](v9-alerting-explore-labels.md).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

Setelah Anda membuat aturan, Anda dapat membuat pemberitahuan untuk aturan Anda. Untuk informasi selengkapnya tentang notifikasi, lihat[Mengelola notifikasi peringatan](v9-alerting-managenotifications.md).

## Aturan tunggal dan multidimensi
<a name="v9-alerting-single-multi-rule"></a>

Untuk aturan peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multidimensi.

**Aturan dimensi tunggal (kondisi klasik)**

Gunakan ekspresi kondisi klasik untuk membuat aturan yang memulai peringatan tunggal ketika kondisinya terpenuhi. Untuk kueri yang mengembalikan beberapa seri, Grafana tidak melacak status peringatan setiap seri. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

Untuk informasi selengkapnya tentang cara memformat ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dalam dokumentasi *Grafana*.

**Aturan multidimensi**

Untuk menghasilkan instance peringatan terpisah untuk setiap seri yang dikembalikan dalam kueri, buat aturan multidimensi.

**catatan**  
Setiap instance peringatan yang dihasilkan oleh aturan multi-dimensi dihitung terhadap total kuota peringatan Anda. Aturan tidak dievaluasi ketika Anda mencapai kuota peringatan Anda. Untuk informasi selengkapnya tentang kuota untuk aturan multi-dimensi, lihat. [Kuota mencapai kesalahan](#v9-alerting-rule-quota-reached)

Untuk membuat beberapa instance dari satu aturan, gunakan `Math``Reduce`, atau `Resample` ekspresi untuk membuat aturan multidimensi. Sebagai contoh, Anda dapat:
+ Tambahkan `Reduce` ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai. (Tidak diperlukan untuk [aturan menggunakan data numerik](v9-alerting-explore-numeric.md)).
+ Tambahkan `Math` ekspresi dengan kondisi untuk aturan. Ini tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan 0 jika aturan tidak harus memulai peringatan, atau angka positif jika harus memulai peringatan. 

  Beberapa contoh: 
  + `$B > 70`jika harus memulai peringatan jika nilai B query/expression lebih dari 70. 
  + `$B < $C * 100`dalam hal itu harus memulai peringatan jika nilai B kurang dari nilai C dikalikan dengan 100. Jika kueri yang dibandingkan memiliki beberapa seri dalam hasilnya, seri dari kueri yang berbeda dicocokkan jika mereka memiliki label yang sama, atau satu adalah bagian dari yang lain.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di halaman komunitas [Variabel Template tidak didukung dalam kueri peringatan saat menyiapkan Peringatan](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Pertimbangan kinerja untuk aturan multidimensi**

Setiap instance peringatan dihitung terhadap kuota peringatan. Aturan multidimensi yang membuat lebih banyak instance daripada yang dapat diakomodasi dalam kuota peringatan tidak dievaluasi dan mengembalikan kesalahan kuota. Untuk informasi selengkapnya, lihat [Kuota mencapai kesalahan](#v9-alerting-rule-quota-reached).

Peringatan multidimensi dapat berdampak tinggi pada kinerja ruang kerja Grafana Anda, serta kinerja sumber data Anda saat Grafana menanyakannya untuk mengevaluasi aturan peringatan Anda. Pertimbangan berikut dapat membantu saat Anda mencoba mengoptimalkan kinerja sistem pemantauan Anda.
+ **Frekuensi evaluasi aturan — Evaluasi** **Setiap** properti dari aturan peringatan mengontrol frekuensi evaluasi aturan. Kami merekomendasikan menggunakan frekuensi evaluasi terendah yang dapat diterima. 
+ **Hasil set kardinalitas** — Jumlah instance peringatan yang Anda buat dengan aturan memengaruhi kinerjanya. Misalkan Anda memantau kesalahan respons API untuk setiap jalur API, di setiap VM di armada Anda. Set ini memiliki kardinalitas jumlah jalur dikalikan dengan jumlah. VMs Anda dapat mengurangi kardinalitas set hasil, misalnya, dengan memantau kesalahan total per VM, bukan per jalur per VM.
+ **Kompleksitas kueri — Kueri** yang sumber data dapat memproses dan merespons dengan cepat mengkonsumsi lebih sedikit sumber daya. Meskipun pertimbangan ini kurang penting daripada pertimbangan lain yang tercantum di atas, jika Anda telah menguranginya sebanyak mungkin, melihat kinerja kueri individu dapat membuat perbedaan. Anda juga harus menyadari dampak kinerja yang mengevaluasi aturan ini terhadap sumber data Anda. Kueri peringatan seringkali merupakan sebagian besar kueri yang ditangani oleh database pemantauan, jadi faktor beban yang sama yang memengaruhi instance Grafana juga memengaruhi mereka.

## Kuota mencapai kesalahan
<a name="v9-alerting-rule-quota-reached"></a>

Ada kuota untuk jumlah instance peringatan yang dapat Anda miliki dalam satu ruang kerja. Ketika Anda mencapai nomor itu, Anda tidak dapat lagi membuat aturan peringatan baru di ruang kerja itu. Dengan peringatan multidimensi, jumlah instance peringatan dapat bervariasi dari waktu ke waktu.

Berikut ini penting untuk diingat saat bekerja dengan instance peringatan.
+ Jika Anda hanya membuat aturan satu dimensi, setiap aturan adalah contoh peringatan tunggal. Anda dapat membuat jumlah aturan yang sama dalam satu ruang kerja dengan kuota instans peringatan, dan tidak lebih.
+ Aturan multidimensi membuat beberapa contoh peringatan, namun jumlahnya tidak diketahui sampai dievaluasi. Misalnya, jika Anda membuat aturan peringatan yang melacak penggunaan CPU instans Amazon EC2 Anda, mungkin ada 50 instans EC2 saat Anda membuatnya (dan karenanya 50 instans peringatan), tetapi jika Anda menambahkan 10 instans EC2 lagi seminggu kemudian, evaluasi berikutnya memiliki 60 instance peringatan.

  Jumlah instans peringatan dievaluasi ketika Anda membuat peringatan multidimensi, dan Anda tidak dapat membuat satu yang segera menempatkan Anda di atas kuota instance peringatan Anda. Karena jumlah instans peringatan dapat berubah, kuota Anda akan diperiksa setiap kali aturan Anda dievaluasi.
+ Pada waktu evaluasi aturan, jika aturan menyebabkan Anda melampaui kuota untuk instance peringatan, aturan tersebut tidak dievaluasi hingga pembaruan dibuat pada aturan peringatan yang membawa jumlah total instance peringatan di bawah kuota layanan. Ketika ini terjadi, Anda menerima pemberitahuan peringatan yang memberi tahu Anda bahwa kuota Anda telah tercapai (notifikasi menggunakan kebijakan notifikasi untuk aturan yang sedang dievaluasi). Pemberitahuan mencakup `Error` anotasi dengan nilai`QuotaReachedError`.
+ Aturan yang menyebabkan `QuotaReachedError` berhenti dievaluasi. Evaluasi hanya dilanjutkan ketika pembaruan dilakukan dan evaluasi setelah pembaruan tidak sendiri menyebabkan a. `QuotaReachedError` Aturan yang tidak dievaluasi menunjukkan kesalahan **Kuota yang dicapai** di konsol Grafana.
+ Anda dapat menurunkan jumlah instance peringatan dengan menghapus aturan peringatan, atau dengan mengedit peringatan multidimensi agar lebih sedikit instance peringatan (misalnya, dengan memiliki satu peringatan tentang kesalahan per VM, daripada satu peringatan tentang kesalahan per API di VM).
+ Untuk melanjutkan evaluasi, perbarui peringatan dan simpan. Anda dapat memperbaruinya untuk menurunkan jumlah instance peringatan, atau jika Anda telah membuat perubahan lain untuk menurunkan jumlah instance peringatan, Anda dapat menyimpannya tanpa perubahan. Jika bisa dilanjutkan, memang begitu. Jika itu menyebabkan yang lain`QuotaReachedError`, Anda tidak dapat menyimpannya.
+ Ketika peringatan disimpan dan melanjutkan evaluasi tanpa melewati kuota peringatan, kesalahan **Kuota tercapai** dapat terus ditampilkan di konsol Grafana untuk beberapa waktu (hingga interval evaluasinya), namun, evaluasi aturan peringatan akan dimulai dan peringatan dikirim jika ambang batas aturan terpenuhi.
+ Untuk detail tentang kuota peringatan, serta kuota lainnya, lihat. [Kuota layanan Grafana yang Dikelola Amazon](AMG_quotas.md)

## Tidak menangani data atau kasus kesalahan
<a name="v9-alerting-rule-no-data-error"></a>

Pilih opsi untuk cara menangani perilaku peringatan jika tidak ada data atau ketika ada kesalahan.

Opsi untuk menangani tidak ada data tercantum dalam tabel berikut.


| Tidak ada opsi Data | Perilaku | 
| --- | --- | 
|  Tidak ada Data  |  Buat peringatan `DatasourceNoData` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.  | 
|  Peringatan  |  Tetapkan status aturan peringatan ke`Alerting`.  | 
|  OK  |  Tetapkan status aturan peringatan ke`Normal`.  | 

Opsi untuk menangani kasus kesalahan tercantum dalam tabel berikut.


| Opsi kesalahan atau batas waktu | Perilaku | 
| --- | --- | 
|  Peringatan  |  Tetapkan status aturan peringatan ke `Alerting`  | 
|  OK  |  Tetapkan status aturan peringatan ke `Normal`  | 
|  Kesalahan  |  Buat peringatan `DatasourceError` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.  | 

# Membuat aturan peringatan terkelola Grafana Mimir atau Loki
<a name="v9-alerting-managerules-mimir-loki"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Menggunakan Grafana, Anda dapat membuat aturan peringatan untuk instance Grafana Mimir atau Loki eksternal.

**catatan**  
Grafana Mimir dapat terhubung ke Amazon Managed Service untuk sumber data Prometheus dan Prometheus.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus. Jika tidak, Anda tidak dapat membuat atau memperbarui aturan peringatan terkelola Cortex.
+ Untuk sumber data Grafana Mimir dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
  + **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
  + **Grafana Mimir** — Gunakan awalan warisan, bukan. `/api/prom` `/prometheus` Sumber data Prometheus mendukung Grafana Mimir dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk menambahkan aturan peringatan terkelola Grafana Mimir atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Buat aturan peringatan**.

1. Pada **Langkah 1**, pilih jenis aturan, dan detailnya, sebagai berikut:
   + Pilih peringatan **Mimir atau Loki**.
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](alert-rules.md#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tentukan interval evaluasi peringatan.

   Dalam **Untuk** kotak teks kondisi, tentukan durasi kondisinya harus benar sebelum peringatan dimulai. Jika Anda menentukan`5m`, kondisi harus benar selama lima menit sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi terpenuhi, peringatan masuk ke `Pending` negara. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke `Firing` status. Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Label dan anotasi](v9-alerting-explore-labels.md).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Pratinjau lansiran** untuk mengevaluasi aturan dan melihat peringatan apa yang akan dihasilkannya. Ini menampilkan daftar peringatan dengan status dan nilai masing-masing.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

Setelah Anda membuat aturan, Anda dapat membuat pemberitahuan untuk aturan Anda. Untuk informasi selengkapnya tentang notifikasi, lihat[Mengelola notifikasi peringatan](v9-alerting-managenotifications.md).

# Membuat aturan perekaman terkelola Grafana Mimir atau Loki
<a name="v9-alerting-managerules-mimir-loki-recording"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat membuat dan mengelola aturan perekaman untuk instans Grafana Mimir atau Loki eksternal. Aturan perekaman menghitung ekspresi yang sering dibutuhkan atau ekspresi mahal secara komputasi terlebih dahulu dan menyimpan hasilnya sebagai rangkaian waktu baru. Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

**Prasyarat**

Untuk sumber data Grafana Mimir dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
+ **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
+ **Grafana Mimir** — Saat mengonfigurasi sumber data untuk menunjuk ke Grafana Mimir, gunakan awalan lama, bukan. `/api/prom` `/prometheus` Sumber data Prometheus mendukung Grafana Mimir dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk menambahkan aturan rekaman terkelola Grafana Mimir atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Buat aturan peringatan**.

1. Pada **Langkah 1**, tambahkan jenis aturan, nama aturan, dan lokasi penyimpanan, sebagai berikut.
   + Pilih opsi **aturan perekaman Mimir atau Loki**.
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](alert-rules.md#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada di dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](alert-rules.md#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

# Grafana Mimir atau grup aturan Loki dan ruang nama
<a name="v9-alerting-managerules-mimir-loki-groups"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda dapat mengatur aturan Anda. Aturan dibuat dalam grup aturan, dan grup aturan diatur ke dalam ruang nama. Aturan dalam kelompok aturan dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama Grafana Mimir atau Loki dan grup aturan, dan mengedit interval evaluasi grup aturan.

**Untuk mengedit grup aturan atau namespace**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Arahkan ke aturan dalam grup aturan atau namespace yang ingin Anda edit.

1. Pilih ikon **Edit** (pena).

1. Buat perubahan pada grup aturan atau namespace.
**catatan**  
Untuk ruang nama, Anda hanya dapat mengedit nama. Untuk grup aturan, Anda mengubah nama, atau interval evaluasi untuk aturan dalam grup. Misalnya, Anda dapat memilih `1m` agar aturan dievaluasi sekali per menit, atau `30s` mengevaluasi setiap 30 detik sekali.

1. Pilih **Simpan perubahan**.

# Melihat dan mengedit aturan peringatan
<a name="v9-alerting-managerules-view-edit"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana, dan bagian **Cortex/Loki** mencantumkan aturan untuk sumber data yang kompatibel dengan Prometheus. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

Bagian Mimir/Cortex/Loki aturan mencantumkan semua aturan untuk sumber data Mimir, Cortex, atau Loki. Aturan peringatan cloud juga tercantum di bagian ini.

Saat mengelola volume peringatan yang besar, Anda dapat menggunakan kemampuan pencarian aturan peringatan yang diperluas untuk memfilter folder, grup evaluasi, dan aturan. Selain itu, Anda dapat memfilter aturan peringatan berdasarkan propertinya seperti label, status, jenis, dan kesehatan.

**catatan**  
Anda dapat melihat definisi kueri untuk peringatan yang disediakan, tetapi Anda tidak dapat mengeditnya. Mampu melihatnya memungkinkan Anda memverifikasi bahwa kueri dan definisi aturan Anda benar tanpa kembali ke repositori penyediaan Anda untuk definisi aturan.

## Lihat aturan peringatan
<a name="v9-alerting-managerules-view"></a>

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

**Untuk melihat detail peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.** Secara default, aturan ditampilkan dalam grup berdasarkan tipe sumber data. Anda juga dapat melihat berdasarkan status saat ini dari setiap peringatan (ini dijelaskan secara lebih rinci dalam teks berikut).

1. Di **View as**, Anda dapat beralih antara tampilan grup dan status dengan memilih opsi yang Anda inginkan.

1. Pilih panah di sebelah baris untuk melihat detail lebih lanjut untuk baris itu. Detail untuk aturan mencakup label aturan, anotasi, sumber data, dan kueri, serta daftar instance peringatan yang dihasilkan dari aturan tersebut.

**catatan**  
Untuk informasi selengkapnya tentang memahami detail lansiran Anda, lihat[Keadaan dan kesehatan aturan peringatan](v9-alerting-explore-state.md).

**Tampilan grup**

Tampilan grup menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \$1. `namespace` `group` Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

**Tampilan negara**

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

**Filter aturan peringatan**

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.
+ Anda dapat memfilter untuk menampilkan aturan yang menanyakan sumber data tertentu dengan memilih **Pilih sumber data**, lalu memilih sumber data yang akan difilter.
+ Anda dapat memfilter berdasarkan label dengan memilih kriteria pencarian di **Cari berdasarkan label**. Misalnya, Anda dapat mengetik `environment=production,region=~US|EU,severity!=warning` untuk memfilter peringatan produksi di AS dan UE.
+ Anda dapat memfilter untuk menampilkan aturan dalam keadaan tertentu dengan memilih **Menyaring peringatan menurut negara**, lalu memilih status yang ingin Anda lihat.

## Mengedit atau menghapus aturan peringatan
<a name="v9-alerting-managerules-edit"></a>

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan. Aturan peringatan untuk instance Mimir atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.

**Untuk mengedit atau menghapus aturan**

1. Perluas aturan hingga Anda dapat melihat kontrol aturan untuk **Lihat**, **Edit**, dan **Hapus**.

1. Pilih **Edit** untuk membuka halaman aturan buat. Buat pembaruan dengan cara yang sama seperti Anda membuat aturan. Untuk detailnya, lihat instruksi di [Membuat aturan peringatan terkelola Grafana](v9-alerting-managerules-grafana.md) atau[Membuat aturan peringatan terkelola Grafana Mimir atau Loki](v9-alerting-managerules-mimir-loki.md).

1. Secara opsional, pilih **Hapus** untuk menghapus aturan.

## Aturan peringatan ekspor
<a name="v9-alerting-managerules-export"></a>

**Anda dapat mengekspor aturan ke YAMAL atau JSON di ruang kerja Grafana, dengan memilih Ekspor.** Ini akan memberi Anda opsi untuk menentukan aturan baru, lalu mengekspornya. Anda dapat membuat aturan menggunakan UI dan kemudian mengekspornya untuk digunakan dalam API penyediaan atau skrip terraform.

**catatan**  
Ini didukung di ruang kerja Grafana dan antarmuka penyediaan.

# Mengelola notifikasi peringatan
<a name="v9-alerting-managenotifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Memilih bagaimana, kapan, dan di mana mengirim pemberitahuan peringatan Anda adalah bagian penting dari pengaturan sistem peringatan Anda. Keputusan ini akan berdampak langsung pada kemampuan Anda untuk menyelesaikan masalah dengan cepat dan tidak melewatkan sesuatu yang penting.

Sebagai langkah pertama, tentukan *titik kontak* Anda; ke mana harus mengirim pemberitahuan peringatan Anda. Titik kontak dapat berupa serangkaian tujuan untuk pemberitahuan yang cocok. Tambahkan templat notifikasi ke titik kontak untuk digunakan kembali dan pesan yang konsisten di notifikasi Anda.

Selanjutnya, buat *kebijakan notifikasi*, yang merupakan seperangkat aturan untuk tempat, kapan, dan bagaimana peringatan Anda diarahkan ke titik kontak. Dalam kebijakan notifikasi, Anda menentukan tempat mengirim pemberitahuan peringatan dengan memilih salah satu titik kontak yang Anda buat. Tambahkan pengaturan waktu bisu ke kebijakan notifikasi Anda. *Waktu bisu* adalah interval waktu berulang di mana Anda tidak ingin pemberitahuan dikirim.

*Saat aturan peringatan dievaluasi, penggaris peringatan mengirimkan instance peringatan ke Alertmanager — satu aturan peringatan dapat memicu beberapa instance peringatan individual.*

Alertmanager menerima instance peringatan ini dan kemudian menangani pengaturan waktu bisu, mengelompokkan peringatan, dan mengirimkan pemberitahuan ke titik kontak Anda sebagaimana didefinisikan dalam kebijakan notifikasi.

**Topics**
+ [Pengelola Peringatan](v9-alerting-managenotifications-alertmanager.md)
+ [Bekerja dengan titik kontak](v9-alerting-contact-points.md)
+ [Bekerja dengan kebijakan notifikasi](v9-alerting-notification-policies.md)
+ [Sesuaikan notifikasi](v9-alerting-notifications.md)
+ [Membungkam pemberitahuan peringatan untuk sumber data Prometheus](v9-alerting-silences.md)
+ [Bisukan waktu](v9-alerting-notification-muting.md)
+ [Lihat dan filter menurut grup peringatan](v9-alerting-viewfiltergroups.md)
+ [Lihat kesalahan pemberitahuan](v9-alerting-viewnotificationerrors.md)

# Pengelola Peringatan
<a name="v9-alerting-managenotifications-alertmanager"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Alertmanager memungkinkan Anda mengelola dan merespons peringatan dengan cepat dan efisien. Ini menerima peringatan, menangani mutasi, penghambatan, pengelompokan, dan perutean dengan mengirimkan pemberitahuan melalui saluran pilihan Anda, misalnya, email atau Slack.

Di Grafana, Anda dapat menggunakan Grafana Alertmanager, atau Alertmanager eksternal. Anda juga dapat menjalankan beberapa pengelola peringatan; keputusan Anda tergantung pada pengaturan Anda dan di mana peringatan Anda dihasilkan.

**Grafana Alertmanager**

Grafana Alertmanager adalah Alertmanager internal yang telah dikonfigurasi sebelumnya dan tersedia untuk dipilih secara default jika Anda menjalankan Grafana di lokasi atau sumber terbuka.

Grafana Alertmanager dapat menerima peringatan dari Grafana, tetapi tidak dapat menerima peringatan dari luar Grafana, misalnya, dari Mimir atau Loki.

**catatan**  
Aturan penghambatan tidak didukung di Grafana Alertmanager.

**Pengelola Peringatan Eksternal**

Jika Anda ingin menggunakan satu alertmanager untuk menerima semua peringatan Grafana, Loki, Mimir, dan Prometheus Anda, Anda dapat mengatur Grafana untuk menggunakan Alertmanager eksternal. Alertmanager eksternal ini dapat dikonfigurasi dan dikelola dari dalam Grafana itu sendiri.

Berikut adalah dua contoh kapan Anda mungkin ingin mengonfigurasi manajer peringatan eksternal Anda sendiri dan mengirim peringatan Anda ke sana alih-alih Grafana Alertmanager:

1. Anda sudah memiliki pengelola peringatan di lokasi di infrastruktur Cloud Anda sendiri yang telah Anda atur dan masih ingin digunakan, karena Anda memiliki generator peringatan lain, seperti Prometheus.

1. Anda ingin menggunakan Prometheus on-premise dan Grafana yang dihosting untuk mengirim peringatan ke alertmanager yang sama yang berjalan di infrastruktur Cloud Anda.

Alertmanagers terlihat dari menu tarik-turun pada halaman Alerting Contact Points, dan Notification Policies.

Jika Anda menyediakan sumber data Anda, setel tanda `handleGrafanaManagedAlerts` di `jsonData` bidang untuk mengirim peringatan yang dikelola Grafana `true` ke Alertmanager ini.

# Bekerja dengan titik kontak
<a name="v9-alerting-contact-points"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Gunakan titik kontak untuk menentukan bagaimana kontak Anda diberi tahu saat peringatan dimulai. Titik kontak dapat memiliki satu atau lebih integrasi titik kontak, misalnya, Amazon Simple Notification Service atau Slack. Ketika peringatan dimulai, pemberitahuan dikirim ke semua integrasi titik kontak yang terdaftar untuk titik kontak. Secara opsional, gunakan [templat notifikasi](v9-alerting-create-templates.md) untuk menyesuaikan pesan notifikasi untuk jenis titik kontak.

**catatan**  
Anda dapat membuat dan mengedit titik kontak untuk peringatan terkelola Grafana. Titik kontak untuk peringatan Alertmanager hanya bisa dibaca.

## Bekerja dengan titik kontak
<a name="v9-alerting-working-contact-points"></a>

Prosedur berikut merinci cara menambahkan, mengedit, menguji, dan menghapus titik kontak.

**Untuk menambahkan titik kontak**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Titik kontak**, lalu **Tambahkan titik kontak**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager. Grafana Alertmanager dipilih secara default.

1. Masukkan **Nama** untuk titik kontak.

1. Dari **integrasi titik kontak**, pilih jenis, dan bidang wajib berdasarkan jenis itu. Misalnya, jika Anda memilih Slack, masukkan saluran Slack dan pengguna yang harus dihubungi.

1. Jika tersedia untuk titik kontak yang Anda pilih, pilih **Pengaturan opsional** yang diinginkan untuk menentukan pengaturan tambahan.

1. Di bawah **Pengaturan pemberitahuan**, pilih **Nonaktifkan pesan yang diselesaikan** secara opsional jika Anda tidak ingin diberi tahu saat peringatan diselesaikan.

1. Jika titik kontak Anda membutuhkan lebih banyak jenis titik kontak, Anda dapat memilih **Tambahkan integrasi titik kontak** dan ulangi langkah-langkah untuk setiap jenis titik kontak yang diperlukan.

1. Pilih **Simpan titik kontak** untuk menyimpan perubahan Anda.

**Untuk mengedit titik kontak**

1. Pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diedit, lalu pilih ikon **Edit** (pena).

1. Buat perubahan yang diperlukan, lalu pilih **Simpan titik kontak** untuk menyimpan perubahan Anda.

Setelah titik kontak Anda dibuat, Anda dapat mengirim pemberitahuan pengujian untuk memverifikasi bahwa itu dikonfigurasi dengan benar.

**Untuk mengirim pemberitahuan pengujian**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diuji, lalu pilih ikon **Edit** (pena).

1. Pilih ikon **Uji** (paper airplane).

1. Pilih apakah akan mengirim pemberitahuan pengujian yang telah ditentukan sebelumnya atau pilih **Kustom** untuk menambahkan anotasi dan label kustom Anda sendiri dalam pemberitahuan pengujian.

1. Pilih **Kirim pemberitahuan pengujian** untuk menguji peringatan dengan titik kontak yang diberikan.

Anda dapat menghapus titik kontak yang tidak digunakan oleh kebijakan pemberitahuan.

**Untuk menghapus titik kontak**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pilih titik kontak yang akan dihapus, lalu pilih ikon **Hapus** (tempat sampah).

1. Di kotak dialog konfirmasi, pilih **Ya, hapus**.

**catatan**  
Jika titik kontak digunakan oleh kebijakan notifikasi, Anda harus menghapus kebijakan notifikasi atau mengeditnya untuk menggunakan titik kontak yang berbeda sebelum menghapus titik kontak.

## Daftar notifier yang didukung
<a name="v9-alerting-contactpoint-supported-notifiers"></a>


|  Nama  |  Tipe  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Tugas Pager  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Bekerja dengan kebijakan notifikasi
<a name="v9-alerting-notification-policies"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Kebijakan pemberitahuan menentukan bagaimana peringatan diarahkan ke titik kontak. Kebijakan memiliki struktur pohon, di mana setiap kebijakan dapat memiliki satu atau lebih kebijakan anak. Setiap kebijakan, kecuali kebijakan root, juga dapat mencocokkan label peringatan tertentu. Setiap peringatan dievaluasi oleh kebijakan root dan kemudian oleh setiap kebijakan anak. Jika Anda mengaktifkan `Continue matching subsequent sibling nodes` opsi untuk kebijakan tertentu, evaluasi berlanjut bahkan setelah satu atau lebih kecocokan. Pengaturan konfigurasi kebijakan induk dan informasi titik kontak mengatur perilaku peringatan yang tidak cocok dengan kebijakan turunan mana pun. Kebijakan root mengatur peringatan apa pun yang tidak cocok dengan kebijakan tertentu.

**catatan**  
Anda dapat membuat dan mengedit kebijakan notifikasi untuk lansiran terkelola Grafana. Kebijakan pemberitahuan untuk peringatan Alertmanager hanya bisa dibaca.

**Pemberitahuan pengelompokan**

Pengelompokan mengkategorikan notifikasi peringatan yang sifatnya serupa ke dalam satu corong. Ini memungkinkan Anda untuk mengontrol pemberitahuan peringatan selama pemadaman yang lebih besar ketika banyak bagian dari sistem gagal sekaligus menyebabkan sejumlah besar peringatan dimulai secara bersamaan.

**Contoh pengelompokan**

Misalkan Anda memiliki 100 layanan yang terhubung ke database di lingkungan yang berbeda. Layanan ini dibedakan oleh label`env=environmentname`. Aturan peringatan ada untuk memantau apakah layanan Anda dapat mencapai database. Aturan peringatan membuat peringatan bernama`alertname=DatabaseUnreachable`.

Jika partisi jaringan terjadi, di mana setengah dari layanan Anda tidak dapat lagi mencapai database, 50 peringatan berbeda dimulai. Untuk situasi ini, Anda ingin menerima pemberitahuan satu halaman (sebagai lawan dari 50) dengan daftar lingkungan yang terpengaruh.

Anda dapat mengonfigurasi pengelompokan menjadi `group_by: [alertname]` (tidak menggunakan `env` label, yang berbeda untuk setiap layanan). Dengan konfigurasi ini, Grafana mengirimkan satu notifikasi ringkas yang memiliki semua lingkungan yang terpengaruh untuk aturan peringatan ini.

**Grup Khusus**

Grafana memiliki dua kelompok khusus. Grup default, `group_by: null` mengelompokkan *semua* peringatan menjadi satu grup. Anda juga dapat menggunakan label khusus yang diberi nama `...` untuk mengelompokkan peringatan berdasarkan semua label, menonaktifkan pengelompokan secara efektif, dan mengirim setiap peringatan ke dalam grupnya sendiri.

## Bekerja dengan notifikasi
<a name="v9-alerting-notification-policies-working"></a>

Prosedur berikut menunjukkan cara membuat dan mengelola kebijakan notifikasi.

**Untuk mengedit kebijakan pemberitahuan root**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Kebijakan Root**, pilih ikon **Edit** (pena).

1. Di **titik kontak default**, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.

1. Di **Grup menurut**, pilih label (atau grup khusus) untuk mengelompokkan peringatan berdasarkan.

1. Di **Opsi waktu**, pilih dari opsi berikut.
   + **Tunggu grup** — Saatnya menunggu untuk menyangga peringatan dari grup yang sama sebelum mengirim pemberitahuan awal. Waktu default-nya adalah 30 detik.
   + **Interval grup** — Interval waktu minimum antara dua pemberitahuan untuk grup. Default adalah 5 menit.
   + **Interval pengulangan** — Interval waktu minimum sebelum mengirim ulang pemberitahuan jika tidak ada peringatan baru yang ditambahkan ke grup. Defaultnya adalah 4 jam.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menambahkan kebijakan spesifik tingkat atas yang baru**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Perutean khusus**, pilih **Kebijakan spesifik baru**.

1. Di bagian **Mencocokkan label**, tambahkan satu atau beberapa label peringatan yang cocok. Informasi lebih lanjut tentang pencocokan label nanti dalam topik ini.

1. Di **titik Kontak**, tambahkan titik kontak untuk mengirim notifikasi jika peringatan cocok dengan kebijakan khusus ini. Kebijakan bersarang mengesampingkan titik kontak ini.

1. Secara opsional, aktifkan **Lanjutkan pencocokan node saudara berikutnya** untuk terus mencocokkan kebijakan saudara kandung bahkan setelah peringatan cocok dengan kebijakan saat ini. Jika kebijakan ini diaktifkan, Anda bisa mendapatkan lebih dari satu notifikasi untuk peringatan yang sama.

1. Secara opsional pilih **Ganti pengelompokan** untuk menentukan pengelompokan yang berbeda dari kebijakan root.

1. Secara opsional pilih **Ganti pengaturan waktu umum** untuk mengganti opsi waktu dalam kebijakan pemberitahuan grup.

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk menambahkan kebijakan bersarang**

1. Perluas kebijakan spesifik yang ingin Anda buat kebijakan bersarang di bawahnya.

1. Pilih **Tambahkan kebijakan bertingkat**, lalu tambahkan detailnya (seperti saat menambahkan kebijakan spesifik tingkat atas).

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk mengedit kebijakan tertentu**

1. Dari halaman **Peringatan**, pilih **Kebijakan pemberitahuan** untuk membuka halaman yang mencantumkan kebijakan yang ada.

1. Pilih kebijakan yang ingin Anda edit, lalu pilih ikon **Edit** (pena).

1. Buat perubahan apa pun (seperti saat menambahkan kebijakan spesifik tingkat atas).

1. Pilih **Simpan kebijakan**.

**Mencari kebijakan**

Anda dapat mencari di dalam pohon kebijakan berdasarkan *pencocokan Label atau titik* *kontak*.
+ Untuk mencari berdasarkan titik kontak, masukkan nama sebagian atau lengkap titik kontak di bidang **Cari berdasarkan titik kontak**.
+ Untuk mencari berdasarkan label, masukkan pencocokan label yang valid di kolom **Cari berdasarkan label**. Beberapa matcher dapat dimasukkan, dipisahkan dengan koma. Misalnya, masukan pencocokan yang valid bisa `severity=high, region=~EMEA|NA` jadi.
**catatan**  
Saat mencari berdasarkan label, semua kebijakan yang cocok akan sama persis. Pertandingan sebagian dan pertandingan gaya regeks tidak didukung.

**Cara kerja pencocokan label**

Kebijakan akan cocok dengan peringatan jika label peringatan cocok dengan semua *Label Pencocokan* yang ditentukan pada kebijakan.
+ **Label** — Nama label yang cocok. Itu harus sama persis dengan nama label peringatan.
+ **Operator** — Operator digunakan untuk membandingkan nilai label dengan nilai label yang cocok. Operator yang tersedia adalah:
  + `=`Pilih label yang nilainya sama persis dengan string yang disediakan.
  + `!=`Pilih label yang nilainya tidak cocok dengan string yang disediakan.
  + `=~`Pilih label yang nilainya cocok dengan nilai interpretasi regex dari string yang disediakan (string yang disediakan ditafsirkan sebagai ekspresi reguler.
  + `!=`Pilih label yang tidak cocok dengan ekspresi reguler yang disediakan.
+ **Nilai** — Nilai untuk mencocokkan nilai label. Hal ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.

# Sesuaikan notifikasi
<a name="v9-alerting-notifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Sesuaikan notifikasi Anda dengan templat notifikasi.

Anda dapat menggunakan templat notifikasi untuk mengubah judul, pesan, dan format pesan di notifikasi.

Template notifikasi tidak terkait dengan integrasi titik kontak tertentu, seperti email atau Slack. Namun, Anda dapat memilih untuk membuat templat notifikasi terpisah untuk integrasi titik kontak yang berbeda.

Anda dapat menggunakan template notifikasi untuk:
+ Menambahkan, menghapus, atau mengurutkan ulang informasi dalam pemberitahuan termasuk ringkasan, deskripsi, label dan anotasi, nilai, dan tautan
+ Format teks dalam huruf tebal dan miring, dan tambahkan atau hapus jeda baris

Anda tidak dapat menggunakan templat notifikasi untuk:
+ Ubah desain notifikasi di layanan pesan instan seperti Slack dan Microsoft Teams

**Topics**
+ [Menggunakan bahasa template Go](v9-alerting-notifications-go-templating.md)
+ [Buat templat notifikasi](v9-alerting-create-templates.md)
+ [Referensi templat](v9-alerting-template-reference.md)

# Menggunakan bahasa template Go
<a name="v9-alerting-notifications-go-templating"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Anda menulis template notifikasi dalam bahasa template Go, [teks/template](https://pkg.go.dev/text/template).

Bagian ini memberikan ikhtisar bahasa template Go dan template penulisan dalam teks/template.

## Dot
<a name="v9-go-dot"></a>

Di text/template sana ada kursor khusus yang disebut titik, dan ditulis sebagai`.`. Anda dapat menganggap kursor ini sebagai variabel yang nilainya berubah tergantung di mana dalam template itu digunakan. Misalnya, pada awal template notifikasi `.` mengacu pada `ExtendedData` objek, yang berisi sejumlah bidang termasuk`Alerts`,,`Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` dan`ExternalURL`. Namun, dot mungkin merujuk ke sesuatu yang lain saat digunakan dalam daftar di `range` atas, saat digunakan di dalam`with`, atau saat menulis templat fitur untuk digunakan di templat lain. Anda dapat melihat contoh ini di[Buat templat notifikasi](v9-alerting-create-templates.md), dan semua data dan fungsi di[Referensi templat](v9-alerting-template-reference.md).

## Membuka dan menutup tag
<a name="v9-go-openclosetags"></a>

Dalam teks/template, template dimulai dengan `{{` dan diakhiri dengan `}}` terlepas dari apakah template mencetak variabel atau menjalankan struktur kontrol seperti pernyataan if. Ini berbeda dari bahasa templating lainnya seperti Jinja di mana pencetakan variabel menggunakan `{{` dan `}}` dan struktur kontrol menggunakan `{%` dan. `%}`

## Cetak
<a name="v9-go-print"></a>

Untuk mencetak nilai sesuatu gunakan `{{` dan`}}`. Anda dapat mencetak nilai titik, bidang titik, hasil fungsi, dan nilai [variabel](#v9-go-variables). Misalnya, untuk mencetak `Alerts` bidang di mana titik mengacu pada `ExtendedData` Anda akan menulis yang berikut:

```
{{ .Alerts }}
```

## Iterasi di atas peringatan
<a name="v9-go-iterate-alerts"></a>

Untuk mencetak hanya label setiap peringatan, bukan semua informasi tentang peringatan, Anda dapat menggunakan a `range` untuk mengulangi peringatan di: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

Di dalam rentang titik tidak lagi mengacu pada`ExtendedData`, tetapi ke`Alert`. Anda dapat menggunakan `{{ .Labels }}` untuk mencetak label setiap peringatan. Ini berfungsi karena `{{ range .Alerts }}` perubahan titik untuk merujuk ke peringatan saat ini dalam daftar peringatan. Ketika rentang selesai titik diatur ulang ke nilai yang dimilikinya sebelum dimulainya rentang, yang dalam contoh ini adalah`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Ulangi anotasi dan label
<a name="v9-go-iterate-labels"></a>

Mari kita menulis template untuk mencetak label setiap peringatan dalam format`The name of the label is $name, and the value is $value`, di mana `$name` dan `$value` berisi nama dan nilai setiap label.

Seperti pada contoh sebelumnya, gunakan rentang untuk mengulangi peringatan `.Alerts` sedemikian rupa sehingga titik mengacu pada peringatan saat ini dalam daftar peringatan, dan kemudian gunakan rentang kedua pada label yang diurutkan sehingga titik diperbarui untuk kedua kalinya untuk merujuk ke label saat ini. Di dalam rentang kedua gunakan `.Name` dan `.Value` untuk mencetak nama dan nilai setiap label:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Jika pernyataan
<a name="v9-go-if"></a>

Anda dapat menggunakan pernyataan if dalam template. Misalnya, untuk mencetak `There are no alerts` jika tidak ada peringatan di `.Alerts` Anda akan menulis yang berikut:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Dengan
<a name="v9-go-with"></a>

Dengan mirip dengan pernyataan if, namun tidak seperti pernyataan if, `with` pembaruan titik untuk merujuk ke nilai with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variabel
<a name="v9-go-variables"></a>

Variabel dalam text/template harus dibuat dalam template. Misalnya, untuk membuat variabel yang disebut `$variable` dengan nilai titik saat ini Anda akan menulis yang berikut ini:

```
{{ $variable := . }}
```

Anda dapat menggunakan `$variable` di dalam rentang atau `with` dan itu akan merujuk ke nilai titik pada saat variabel didefinisikan, bukan nilai titik saat ini.

Misalnya, Anda tidak dapat menulis templat yang digunakan `{{ .Labels }}` dalam rentang kedua karena di sini titik mengacu pada label saat ini, bukan peringatan saat ini:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Anda dapat memperbaikinya dengan mendefinisikan variabel yang disebut `$alert` dalam rentang pertama dan sebelum rentang kedua:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Rentang dengan indeks
<a name="v9-go-rangeindex"></a>

Anda bisa mendapatkan indeks setiap peringatan dalam rentang dengan mendefinisikan indeks dan variabel nilai di awal rentang:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Tentukan templat
<a name="v9-go-define"></a>

Anda dapat menentukan template yang dapat digunakan dalam template lain, menggunakan `define` dan nama template dalam tanda kutip ganda. Anda tidak boleh mendefinisikan template dengan nama yang sama dengan template lain, termasuk template default seperti`__subject`,`__text_values_list`,`__text_alert_list`, `default.title` dan`default.message`. Jika templat telah dibuat dengan nama yang sama dengan templat default, atau templat di templat notifikasi lain, Grafana mungkin menggunakan salah satu templat. Grafana tidak mencegah, atau menampilkan pesan kesalahan, ketika ada dua atau lebih templat dengan nama yang sama.

```
{{ define "print_labels" }}
{{ end }}
```

## Template sematkan
<a name="v9-go-embed"></a>

Anda dapat menyematkan template yang ditentukan dalam template Anda menggunakan`template`, nama template dalam tanda kutip ganda, dan kursor yang harus diteruskan ke template:

```
{{ template "print_labels" . }}
```

## Meneruskan data ke template
<a name="v9-go-passdata"></a>

Dalam titik template mengacu pada nilai yang diteruskan ke template.

Misalnya, jika templat dilewatkan daftar peringatan penembakan maka dot mengacu pada daftar peringatan penembakan tersebut:

```
{{ template "print_alerts" .Alerts }}
```

Jika templat dilewatkan label yang diurutkan untuk peringatan maka dot mengacu pada daftar label yang diurutkan:

```
{{ template "print_labels" .SortedLabels }}
```

Ini berguna saat menulis templat yang dapat digunakan kembali. Misalnya, untuk mencetak semua peringatan, Anda dapat menulis yang berikut ini:

```
{{ template "print_alerts" .Alerts }}
```

Kemudian untuk mencetak hanya peringatan penembakan Anda dapat menulis ini:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Ini berfungsi karena keduanya `.Alerts` dan `.Alerts.Firing` merupakan daftar peringatan.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Komentar
<a name="v9-go-comments"></a>

Anda dapat menambahkan komentar dengan `{{/*` dan`*/}}`:

```
{{/* This is a comment */}}
```

Untuk mencegah komentar menambahkan jeda baris gunakan:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Lekukan
<a name="v9-go-indentation"></a>

Anda dapat menggunakan lekukan, baik tab maupun spasi, dan jeda baris, untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Namun, lekukan dalam template juga akan ada dalam teks. Selanjutnya kita akan melihat cara menghapusnya.

## Hapus spasi dan jeda baris
<a name="v9-go-removespace"></a>

 text/template Digunakan `{{-` dan `-}}` untuk menghapus spasi depan dan trailing dan jeda garis.

Misalnya, saat menggunakan lekukan dan jeda baris untuk membuat templat lebih mudah dibaca:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Lekukan dan jeda baris juga akan ada dalam teks:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Anda dapat menghapus lekukan dan jeda baris dari teks yang berubah `}}` menjadi `-}}` di awal setiap rentang:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Indentasi dan jeda baris dalam template sekarang tidak ada dari teks:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Buat templat notifikasi
<a name="v9-alerting-create-templates"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Buat templat notifikasi yang dapat digunakan kembali untuk dikirim ke titik kontak Anda.

Anda dapat menambahkan satu atau beberapa templat ke templat notifikasi Anda.

Nama template notifikasi Anda harus unik. Anda tidak dapat memiliki dua templat dengan nama yang sama di templat notifikasi yang sama atau di templat notifikasi yang berbeda. Hindari mendefinisikan template dengan nama yang sama dengan template default, seperti:`__subject`,, `__text_values_list``__text_alert_list`, `default.title` dan`default.message`.

Di tab Titik kontak, Anda dapat melihat daftar templat notifikasi Anda.

## Membuat template notifikasi
<a name="v9-alerting-creating-templates"></a>

**Untuk membuat template notifikasi**

1. Klik **Tambahkan templat**.

1. Pilih nama untuk template notifikasi, seperti`email.subject`.

1. Tulis konten template di bidang konten.

   Contoh:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Klik Simpan.

   `{{ define "email.subject" }}`(di `email.subject` mana nama template Anda) dan `{{ end }}` secara otomatis ditambahkan ke awal dan akhir konten.

**Untuk membuat template notifikasi yang berisi lebih dari satu template:**

1. Klik **Tambahkan Template**.

1. Masukkan nama untuk template notifikasi keseluruhan. Misalnya, `email`.

1. Tulis setiap templat di bidang Konten, termasuk `{{ define "name-of-template" }}` dan `{{ end }}` di awal dan akhir setiap templat. Anda dapat menggunakan nama deskriptif untuk setiap templat di templat notifikasi, misalnya, `email.subject` atau`email.message`. Dalam hal ini, jangan gunakan kembali nama template notifikasi yang Anda masukkan di atas.

   Bagian berikut menunjukkan contoh rinci untuk template yang mungkin Anda buat.

1. Klik Simpan.

## Membuat template untuk subjek email
<a name="v9-alerting-create-template-subject"></a>

Buat templat untuk subjek email yang berisi jumlah peringatan yang ditembakkan dan diselesaikan, seperti dalam contoh ini:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk subjek email**

1. Buat template yang disebut `email.subject` dengan konten berikut:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke bidang **Subjek** dengan `template` kata kunci.

   ```
   {{ template "email.subject" . }}
   ```

## Membuat template untuk pesan email
<a name="v9-alerting-create-template-message"></a>

Buat templat untuk pesan email yang berisi ringkasan semua peringatan yang diaktifkan dan diselesaikan, seperti dalam contoh ini:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Untuk membuat template untuk pesan email**

1. Buat template notifikasi yang disebut `email` dengan dua templat dalam konten: `email.message_alert` dan`email.message`.

   `email.message_alert`Template digunakan untuk mencetak label dan nilai untuk setiap peringatan yang diaktifkan dan diselesaikan sementara `email.message` template berisi struktur email.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Text Body** dengan `template` kata kunci.

   ```
   {{ template "email.message" . }}
   ```

## Membuat template untuk judul pesan Slack
<a name="v9-alerting-create-template-slack-title"></a>

Buat template untuk judul pesan Slack yang berisi jumlah peringatan yang diaktifkan dan diselesaikan, seperti pada contoh berikut:

```
1 firing alerts, 0 resolved alerts
```

**Untuk membuat template untuk judul pesan Slack**

1. Buat template yang disebut `slack.title` dengan konten berikut:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Judul** dengan `template` kata kunci.

   ```
   {{ template "slack.title" . }}
   ```

## Membuat template untuk konten pesan Slack
<a name="v9-alerting-create-template-slack-message"></a>

Buat template untuk konten pesan Slack yang berisi deskripsi semua peringatan yang diaktifkan dan diselesaikan, termasuk label, anotasi, dan URL Dasbor:

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Untuk membuat template untuk konten pesan Slack**

1. Buat template yang disebut `slack` dengan dua template dalam konten: `slack.print_alert` dan`slack.message`.

   `slack.print_alert`Template digunakan untuk mencetak label, anotasi, dan dasbordURL sementara `slack.message` template berisi struktur notifikasi.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Gunakan template saat membuat integrasi titik kontak Anda dengan memasukkannya ke dalam bidang **Text Body** dengan `template` kata kunci.

   ```
   {{ template "slack.message" . }}
   ```

## Template email dan Slack dengan template bersama
<a name="v9-alerting-create-shared-templates"></a>

Alih-alih membuat template notifikasi terpisah untuk setiap titik kontak, seperti email dan Slack, Anda dapat berbagi template yang sama.

Misalnya, jika Anda ingin mengirim email dengan subjek ini dan pesan Slack dengan judul ini`1 firing alerts, 0 resolved alerts`, Anda dapat membuat templat bersama.

**Untuk membuat template bersama**

1. Buat template yang disebut `common.subject_title` dengan konten berikut:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Untuk email, jalankan template dari bidang subjek dalam integrasi titik kontak email Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Untuk Slack, jalankan template dari bidang judul di integrasi titik kontak Slack Anda:

   ```
   {{ template "common.subject_title" . }}
   ```

## Menggunakan template notifikasi
<a name="v9-alerting-use-notification-templates"></a>

Gunakan templat di titik kontak untuk menyesuaikan notifikasi Anda.

**Untuk menggunakan template saat membuat titik kontak**

1. Dari menu **Peringatan**, pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih **Tambahkan titik kontak**. Sebagai alternatif, Anda dapat mengedit titik kontak yang ada dengan memilih ikon **Edit** (pena) di sebelah titik kontak yang ingin Anda edit.

1. Masukkan templat yang ingin Anda gunakan dalam satu atau beberapa bidang, seperti **Pesan** atau **Subjek**. Untuk memasukkan templat, gunakan formulir`{{ template "template_name" . }}`, ganti *template\$1name* dengan nama templat yang ingin Anda gunakan.

1. Klik **Simpan titik kontak**.

# Referensi templat
<a name="v9-alerting-template-reference"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Bagian ini memberikan informasi referensi untuk membuat template Anda.

## Data templat
<a name="v9-alerting-template-data"></a>

Data berikut diteruskan ke template pesan.


| Nama | Tipe | Catatan | 
| --- | --- | --- | 
|  `Receiver`  |  string  |  Nama titik kontak tempat notifikasi dikirim.  | 
|  `Status`  |  string  |  menembak jika setidaknya satu peringatan ditembakkan, jika tidak diselesaikan.  | 
|  `Alerts`  |  Pemberitahuan  |  Daftar objek peringatan yang disertakan dalam pemberitahuan ini (lihat di bawah).  | 
|  `GroupLabels`  |  KeyValue  |  Label peringatan ini dikelompokkan berdasarkan.  | 
|  `CommonLabels`  |  KeyValue  |  Label umum untuk semua peringatan yang disertakan dalam notifikasi ini.  | 
|  `CommonAnnotations`  |  KeyValue  |  Anotasi umum untuk semua peringatan yang disertakan dalam pemberitahuan ini.  | 
|  `ExternalURL`  |  string  |  Tautan kembali ke Grafana yang mengirim notifikasi. Jika menggunakan Alertmanager eksternal, tautan kembali ke Alertmanager ini.  | 

`Alerts`Jenis ini mengekspos dua fungsi untuk memfilter peringatan yang dikembalikan.
+ `Alerts.Firing`— Mengembalikan daftar peringatan penembakan.
+ `Alerts.Resolved`— Mengembalikan daftar peringatan diselesaikan.

**Peringatan (tipe)**

Jenis peringatan berisi data berikut.


| Nama | Tipe | Catatan | 
| --- | --- | --- | 
|  Status  |  string  |  `firing` atau `resolved`.  | 
|  Label  |  KeyValue  |  Satu set label yang dilampirkan pada peringatan.  | 
|  Anotasi  |  KeyValue  |  Satu set anotasi yang dilampirkan pada peringatan.  | 
| Nilai | KeyValue | Nilai dari semua ekspresi, termasuk Kondisi Klasik | 
|  StartsAt  |  waktu.waktu  |  Waktu peringatan mulai menembak.  | 
|  EndsAt  |  waktu.waktu  |  Hanya atur jika waktu akhir peringatan diketahui. Jika tidak, atur ke periode batas waktu yang dapat dikonfigurasi sejak peringatan terakhir diterima.  | 
|  GeneratorURL  |  string  |  Tautan balik ke Grafana atau Alertmanager eksternal.  | 
|  SilenceUrl  |  string  |  Tautan untuk membungkam peringatan (dengan label untuk peringatan ini telah diisi sebelumnya). Hanya untuk peringatan terkelola Grafana.  | 
|  DashboardURL  |  string  |  Tautkan ke dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | 
|  PanelURL  |  string  |  Tautkan ke panel dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | 
|  Sidik jari  |  string  |  Sidik jari yang dapat digunakan untuk mengidentifikasi peringatan.  | 
|  ValueString  |  string  |  String yang berisi label dan nilai setiap ekspresi yang dikurangi dalam peringatan.  | 

 **ExtendedData**

 ExtendedData Objek berisi properti berikut.


| Nama | Jenis | Deskripsi | Contoh | 
| --- | --- | --- | --- | 
|  Penerima  |  `string`  |  Nama titik kontak yang mengirimkan notifikasi.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Statusnya adalah `firing if at least one alert is firing, otherwise resolved.`  |  `{{ .Status }}`  | 
|  Pemberitahuan  |  `[]Alert`  |  Daftar semua peringatan yang ditembakkan dan diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts }} alerts`  | 
|  Peringatan penembakan  |  `[]Alert`  |  Daftar semua peringatan penembakan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Peringatan terselesaikan  |  `[]Alert`  |  Daftar semua peringatan yang diselesaikan dalam pemberitahuan ini.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Label yang mengelompokkan peringatan ini termasuk pemberitahuannya.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Label umum untuk semua peringatan dalam pemberitahuan ini.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Anotasi umum untuk semua peringatan dalam pemberitahuan ini.  |  `{{ .CommonAnnotations }}`  | 
|  URL eksternal  |  `string`  |  Tautan ke ruang kerja Grafana atau Alertmanager yang mengirimkan pemberitahuan ini.  |  `{{ .ExternalURL }}`  | 

**KeyValue jenis**

`KeyValue`Tipe adalah satu set pasangan key/value string yang mewakili label dan anotasi.

Selain akses langsung dari data yang disimpan sebagai a`KeyValue`, ada juga metode untuk menyortir, menghapus, dan mengubah data.


| Nama | Pendapat | Pengembalian | Catatan | Contoh | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Daftar pasangan string kunci dan nilai yang diurutkan  |    | `{{ .Annotations.SortedPairs }}` | 
|  Menghapus  |  [] string  |  KeyValue  |  Mengembalikan salinan Key/Value peta tanpa kunci yang diberikan.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nama  |    |  [] string  |  Daftar nama label  | `{{ .Names }}` | 
|  Nilai  |    |  [] string  |  Daftar nilai label  | `{{ .Values }}` | 

**Waktu**

Waktu dari [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)paket Go. Anda dapat mencetak waktu dalam sejumlah format berbeda. Misalnya, untuk mencetak waktu peringatan diaktifkan dalam format`Monday, 1st January 2022 at 10:00AM`, Anda menulis template berikut:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Anda dapat menemukan referensi untuk format waktu Go [di sini](https://pkg.go.dev/time#pkg-constants).

## Fungsi template
<a name="v9-alerting-template-functions"></a>

Dengan menggunakan fungsi template, Anda dapat memproses label dan anotasi untuk menghasilkan notifikasi dinamis. Fungsi-fungsi berikut tersedia.


| Nama | Jenis Argumen | Jenis pengembalian | Deskripsi | 
| --- | --- | --- | --- | 
|  `humanize`  |  nomor atau string  |  string  |  Mengonversi angka ke format yang lebih mudah dibaca, menggunakan awalan metrik.  | 
|  `humanize1024`  |  nomor atau string  |  string  |  Seperti memanusiakan, tetapi menggunakan 1024 sebagai basis daripada 1000.  | 
|  `humanizeDuration`  |  nomor atau string  |  string  |  Mengonversi durasi dalam hitungan detik ke format yang lebih mudah dibaca.  | 
|  `humanizePercentage`  |  nomor atau string  |  string  |  Mengkonversi nilai rasio menjadi pecahan dari 100.  | 
|  `humanizeTimestamp`  |  nomor atau string  |  string  |  Mengonversi stempel waktu Unix dalam hitungan detik ke format yang lebih mudah dibaca.  | 
|  `title`  |  string  |  string  |  Strings.title, mengkapitalisasi karakter pertama dari setiap kata.  | 
|  `toUpper`  |  string  |  string  |  senar. ToUpper, mengonversi semua karakter ke huruf besar.  | 
|  `toLower`  |  string  |  string  |  senar. ToLower, mengonversi semua karakter ke huruf kecil.  | 
|  `match`  |  pola, teks  |  Boolean  |  regexp. MatchString Tes untuk pertandingan regexp yang tidak ditambatkan.  | 
|  `reReplaceAll`  |  pola, penggantian, teks  |  string  |  Regexp. ReplaceAllString Regexp substitusi, tidak berlabuh.  | 
|  `graphLink`  |  string - Objek JSON dengan `expr` dan bidang `datasource`  |  string  |  Mengembalikan jalur ke tampilan grafis di Jelajahi untuk ekspresi dan sumber data yang diberikan.  | 
|  `tableLink`  |  string - Objek JSON dengan `expr` dan bidang `datasource`  |  string  |  Mengembalikan jalur ke tampilan tabel di Jelajahi untuk ekspresi dan sumber data yang diberikan.  | 
|  `args`  |  [] antarmuka \$1\$1  |  peta [string] antarmuka \$1\$1  |  Mengkonversi daftar objek ke peta dengan kunci, misalnya, arg0, arg1. Gunakan fungsi ini untuk meneruskan beberapa argumen ke template.  | 
|  `externalURL`  |  tidak ada  |  string  |  Mengembalikan string yang mewakili URL eksternal.  | 
|  `pathPrefix`  |  tidak ada  |  string  |  Mengembalikan jalur URL eksternal.  | 

Tabel berikut menunjukkan contoh penggunaan setiap fungsi.


| Fungsi | TemplateString | Input | Expected | 
| --- | --- | --- | --- | 
|  memanusiakan  |  \$1memanusiakan \$1value\$1  |  1234567.0  |  1.235 M  | 
|  manusia1024  |  \$1humanize1024 \$1nilai\$1  |  1048576.0  |  1Mi  | 
|  HumanizeUrasi  |  \$1HumanizeDuration \$1value\$1  |  899,99  |  14m 59s  | 
|  HumanizePersentase  |  \$1HumanizePersentase \$1 nilai\$1  |  0.1234567  |  12,35%  | 
|  HumanizeTimestamp  |  \$1HumanizeTimeStamp \$1nilai\$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  title  |  \$1\$1value \$1 judul\$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1\$1nilai \$1 TouPper\$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1\$1value \$1 toLower\$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1cocokkan “a\$1” \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll “localhost :( .\$1)” “my.domain: \$11" \$1labels.instance\$1\$1  |  localhost:3000  |  domain.my:3000  | 
|  GraphLink  |  \$1\$1GraphLink “\$1\$1" expr\$1”:\$1 "up\$1”,\$1 "sumber data\$1”:\$1 "gdev-prometheus\$1"\$1”\$1\$1  |    |  /jelajahi? left= ["now-1h”, "now”, "gdev-prometheus”, \$1"datasource” :"gdev-prometheus”, "expr” :"up”, "instant” :false, "range” :true\$1]  | 
|  TableLink  |  \$1\$1TableLink “\$1\$1" expr\$1”:\$1 "up\$1”,\$1 "sumber data\$1”:\$1 "gdev-prometheus\$1"\$1”\$1\$1  |    |  /jelajahi? left= ["now-1h”, "now”, "gdev-prometheus”, \$1"datasource” :"gdev-prometheus”, "expr” :"up”, "instant” :true, "range” :false\$1]  | 
|  args  |  \$1\$1define “x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1template “x” (argumen 1 “2")\$1\$1  |    |  1 2  | 
|  URL eksternal  |  \$1ExternalUrl\$1  |    |  http://localhost/path/prefix  | 
|  PathPrefix  |  \$1PathPrefix\$1  |    |  /jalur/awalan  | 

# Membungkam pemberitahuan peringatan untuk sumber data Prometheus
<a name="v9-alerting-silences"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

*Untuk sumber data pengelola Peringatan eksternal (termasuk Amazon Managed Service untuk Prometheus), Anda dapat menekan pemberitahuan peringatan dengan diam.* Keheningan hanya menghentikan pemberitahuan agar tidak dibuat: Keheningan tidak mencegah aturan peringatan dievaluasi, dan mereka tidak menghentikan peringatan instance agar tidak ditampilkan di antarmuka pengguna. Saat Anda membungkam peringatan, Anda menentukan jendela waktu untuk ditekan.

Anda dapat mengonfigurasi keheningan untuk sumber data Alertmanager eksternal.

**catatan**  
Untuk menekan pemberitahuan peringatan pada interval waktu reguler, atau untuk sumber data lain, (misalnya, selama periode pemeliharaan rutin), gunakan [Bisukan waktu](v9-alerting-notification-muting.md) bukan diam.

**Untuk menambahkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Silences** untuk membuka daftar halaman yang ada[Bekerja dengan titik kontak](v9-alerting-contact-points.md).

1. Pilih Alertmanager eksternal dari dropdown **Alertmanager**.

1. Pilih **Tambahkan Keheningan**.

1. Pilih tanggal mulai dan berakhir di **Silence start and end** untuk menunjukkan kapan keheningan akan berlaku dan kapan harus berakhir.

   Sebagai alternatif untuk mengatur waktu akhir, di **Durasi**, tentukan berapa lama keheningan diberlakukan. Ini secara otomatis memperbarui waktu akhir di bidang **Mulai dan Akhir Diam**.

1. Di bidang **Nama** dan **Nilai**, masukkan satu atau beberapa *Label Pencocokan*. Matcher menentukan aturan mana yang berlaku untuk keheningan. Pencocokan label dibahas secara lebih rinci mengikuti prosedur ini.

1. Secara opsional, tambahkan **Komentar**, atau ubah **Pencipta** untuk mengatur pemilik keheningan.

1. Pilih **Buat** untuk membuat keheningan.

Anda dapat mengedit keheningan yang ada dengan memilih ikon **Edit** (pena).

**Pencocokan label untuk penekanan peringatan**

Saat Anda membuat keheningan, Anda membuat satu set *label yang cocok* sebagai bagian dari keheningan. Ini adalah seperangkat aturan tentang label yang harus cocok agar peringatan ditekan. Label yang cocok terdiri dari tiga bagian:
+ **Label** — Nama label yang cocok. Itu harus sama persis dengan nama label peringatan.
+ **Operator** — Operator digunakan untuk membandingkan nilai label dengan nilai label yang cocok. Operator yang tersedia adalah:
  + `=`Pilih label yang nilainya sama persis dengan string yang disediakan.
  + `!=`Pilih label yang nilainya tidak cocok dengan string yang disediakan.
  + `=~`Pilih label yang nilainya cocok dengan nilai interpretasi regex dari string yang disediakan (string yang disediakan ditafsirkan sebagai ekspresi reguler).
  + `!=`Pilih label yang tidak cocok dengan ekspresi reguler yang disediakan.
+ **Nilai** — Nilai untuk mencocokkan nilai label. Hal ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.

Keheningan berakhir pada tanggal akhir yang ditunjukkan, tetapi Anda dapat mengakhiri penindasan secara manual kapan saja.

**Untuk mengakhiri keheningan secara manual**

1. Di halaman **Peringatan**, pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Pilih keheningan yang ingin Anda akhiri, dan pilih **Unsilence**. Ini mengakhiri penindasan peringatan.
**catatan**  
Unsilencing mengakhiri penindasan peringatan, seolah-olah waktu akhir ditetapkan untuk waktu saat ini. Keheningan yang telah berakhir (secara otomatis atau manual) dipertahankan dan terdaftar selama lima hari. Anda tidak dapat menghapus keheningan dari daftar secara manual.

**Membuat tautan ke formulir pembuatan keheningan**

Anda dapat membuat URL ke formulir pembuatan diam dengan detail yang sudah diisi. Operator dapat menggunakan ini untuk menekan alarm dengan cepat selama acara operasional.

Saat membuat tautan ke formulir diam, gunakan parameter `matchers` kueri untuk menentukan label yang cocok, dan parameter `comment` kueri untuk menentukan komentar. `matchers`Parameter membutuhkan satu atau lebih nilai dalam bentuk`[label][operator][value]`, dipisahkan dengan koma.

**Contoh URL**

Untuk menautkan ke formulir diam, dengan label yang cocok `severity=critical` dan`cluster!~europe-.*`, dengan komentar yang mengatakan`Silencing critical EU alerts`, gunakan URL seperti berikut ini. Ganti *mygrafana* dengan nama host instance Grafana Anda.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Untuk menautkan ke halaman diam baru untuk Alertmanager eksternal, tambahkan parameter `alertmanager` kueri dengan nama sumber data Alertmanage, seperti. `alertmanager=myAlertmanagerdatasource`

# Bisukan waktu
<a name="v9-alerting-notification-muting"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan keheningan, timing bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.

**Pengaturan waktu bisu dibandingkan dengan keheningan**

Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.


| Bisukan waktu | Pembisuan | 
| --- | --- | 
|  Menggunakan definisi interval waktu yang dapat terulang kembali.  |  Memiliki waktu mulai dan berakhir yang tetap.  | 
|  Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan.  |  Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak.  | 
|  Bekerja dengan peringatan Grafana dan Manajer Peringatan eksternal.  |  Hanya berfungsi dengan Alertmanagers eksternal.  | 

**Untuk membuat waktu bisu**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Mute timing**, pilih tombol **Add mute timing**.

1. Pilih interval waktu yang Anda inginkan agar waktu bisu diterapkan.

1. Pilih **Kirim** untuk membuat waktu bisu.

**Untuk menambahkan waktu bisu ke kebijakan notifikasi**

1. Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, lalu pilih tombol **Edit**.

1. Dari menu tarik-turun **Pengaturan waktu bisu**, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.

   Pilih tombol **Simpan kebijakan**.

**Interval waktu**

Interval waktu adalah definisi untuk rentang waktu. Jika peringatan dimulai selama interval ini, peringatan itu ditekan. Rentang didukung menggunakan `:` (misalnya,`monday:thursday`). Waktu bisu dapat berisi beberapa interval waktu. Interval waktu terdiri dari beberapa bidang (detail dalam daftar berikut), yang semuanya harus cocok untuk menekan peringatan. Misalnya, jika Anda menentukan hari dalam seminggu `monday:friday` dan rentang waktu dari 8:00-9:00, maka peringatan ditekan dari 8-9, Senin hingga Jumat, tetapi tidak, misalnya, 8-9 pada hari Sabtu.
+ **Rentang waktu** — Waktu hari untuk menekan notifikasi. Terdiri dari dua sub-bidang, **Start time** dan **End time**. Contoh waktu adalah`14:30`. Waktu dalam notasi 24 jam, di UTC.
+ **Hari dalam seminggu** — Hari-hari dalam seminggu. Dapat berupa satu hari, seperti`monday`, rentang, seperti`monday:friday`, atau daftar hari yang terpisah koma, seperti. `monday, tuesday, wednesday`
+ **Bulan** — Bulan untuk memilih. Anda dapat menentukan bulan dengan penunjukan numerik, atau dengan nama bulan penuh, misalnya `1` atau `january` keduanya menentukan Januari. Anda dapat menentukan satu bulan, rentang bulan, atau daftar bulan yang dipisahkan koma.
+ **Hari dalam sebulan** — Tanggal dalam sebulan. Nilai dapat berkisar dari `1` -`31`. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi `-1` mewakili hari terakhir bulan itu. Hari dalam sebulan dapat ditentukan sebagai satu hari, rentang hari, atau daftar hari yang terpisah koma.
+ **Tahun** — Tahun atau tahun untuk interval. Misalnya, `2023:2025`.

Masing-masing elemen ini dapat berupa daftar, dan setidaknya satu item dalam elemen harus dipenuhi untuk menjadi kecocokan. Jadi jika Anda menetapkan tahun ke`2023:2025, 2027`, maka itu akan benar selama 2023, 2024, 2025, dan 2027 (tetapi bukan 2026).

Jika bidang dibiarkan kosong, setiap saat akan cocok dengan bidang. Momen waktu harus cocok dengan semua bidang agar sesuai dengan interval waktu yang lengkap.

Jika Anda ingin menentukan durasi yang tepat, tentukan semua opsi yang diperlukan untuk durasi tersebut. Misalnya, jika Anda ingin membuat interval waktu untuk Senin pertama setiap bulan, untuk bulan Maret, Juni, September, dan Desember, antara jam 12:00 dan 24:00 UTC, spesifikasi interval waktu Anda dapat berupa:
+ Rentang waktu:
  + Waktu mulai: `12:00`
  + Waktu akhir: `24:00`
+ Hari dalam seminggu: `monday`
+ Bulan: `3, 6, 9, 12`
+ Hari dalam sebulan: `1:7`

# Lihat dan filter menurut grup peringatan
<a name="v9-alerting-viewfiltergroups"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Grup peringatan menampilkan peringatan yang dikelompokkan dari instance Alertmanager. Secara default, aturan peringatan dikelompokkan berdasarkan kunci label untuk kebijakan root dalam kebijakan notifikasi. Mengelompokkan aturan peringatan umum ke dalam satu grup peringatan mencegah aturan peringatan duplikat dipecat.

Anda dapat melihat grup peringatan dan juga memfilter aturan peringatan yang sesuai dengan kriteria tertentu.

**Untuk melihat grup peringatan**

1. Di menu Grafana, klik ikon **Peringatan** (bel) untuk membuka halaman Peringatan yang mencantumkan peringatan yang ada.

1. Klik **Grup peringatan** untuk membuka halaman yang mencantumkan grup yang ada.

1. Dari tarik-turun **Alertmanager**, pilih Alertmanager eksternal sebagai sumber data Anda.

1. Dari **grup kustom berdasarkan** tarik-turun, pilih kombinasi label untuk melihat pengelompokan selain default. Ini berguna untuk men-debug dan memverifikasi pengelompokan kebijakan pemberitahuan Anda.

Jika peringatan tidak berisi label yang ditentukan baik dalam pengelompokan kebijakan root atau pengelompokan kustom, maka peringatan akan ditambahkan ke grup catch all dengan header. `No grouping`

**Untuk memfilter berdasarkan label**
+ Di **Penelusuran**, masukkan label yang ada untuk melihat peringatan yang cocok dengan label.

  Misalnya, `environment=production,region=~US|EU,severity!=warning`.

**Untuk memfilter menurut negara**
+ Di **Negara Bagian**, pilih dari Status Aktif, Ditekan, atau Tidak Diproses untuk melihat peringatan yang cocok dengan status yang Anda pilih. Semua peringatan lainnya disembunyikan.

# Lihat kesalahan pemberitahuan
<a name="v9-alerting-viewnotificationerrors"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Lihat kesalahan pemberitahuan dan pahami mengapa kesalahan tersebut gagal dikirim atau tidak diterima.

**catatan**  
Fitur ini hanya didukung untuk Grafana Alertmanager.

**Untuk melihat kesalahan pemberitahuan**

1. Di menu Grafana, klik ikon **Peringatan** (bel) untuk membuka halaman Peringatan yang mencantumkan peringatan yang ada.

1. Pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

   Jika ada titik kontak yang gagal, pesan di sudut kanan layar memberi tahu pengguna tentang fakta bahwa ada kesalahan dan berapa banyak.

1. Klik pada titik kontak untuk melihat detail kesalahan untuk titik kontak tersebut.

   Detail kesalahan ditampilkan jika Anda mengarahkan kursor ke ikon Kesalahan.

   Jika titik kontak memiliki lebih dari satu integrasi, Anda melihat semua kesalahan untuk setiap integrasi yang terdaftar.

1. Di kolom Health, periksa status notifikasi.

   Ini bisa berupa OK, Tidak ada upaya, atau Kesalahan.

# Bekerja di Grafana versi 8
<a name="using-grafana-v8"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Saat Anda membuat ruang kerja Grafana, Anda memiliki opsi versi Grafana mana yang akan digunakan. Topik berikut menjelaskan penggunaan ruang kerja Grafana yang menggunakan Grafana versi 8.

**Topics**
+ [Panel](Grafana-panels.md)
+ [Dasbor](dashboard-overview.md)
+ [Jelajahi](explore.md)
+ [Menautkan](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [Template dan variabel](templates-and-variables.md)
+ [Grafana memperingatkan](alerts-overview.md)

# Panel
<a name="Grafana-panels"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel adalah blok bangunan visualisasi dasar di server Grafana. Panel adalah representasi visual dari satu atau lebih pertanyaan kecuali beberapa panel penggunaan khusus. Kueri menampilkan data dari waktu ke waktu. Ini dapat berkisar dari fluktuasi suhu hingga status server saat ini hingga daftar log atau peringatan.

Setiap panel memiliki editor kueri khusus untuk sumber data yang dipilih di panel. Editor kueri memungkinkan Anda mengekstrak visualisasi untuk ditampilkan di panel.



Untuk menampilkan data, Anda harus memiliki setidaknya satu sumber data yang ditambahkan ke ruang kerja Anda. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md).

Ada berbagai macam pilihan styling dan format untuk setiap panel. Panel dapat diseret, diatur ulang, dan diubah ukurannya.

**Topics**
+ [Menambahkan panel](add-a-panel-to-a-dashboard.md)
+ [Menghapus panel](Deleting-a-panel.md)
+ [Kueri](panel-queries.md)
+ [Kueri yang direkam](recorded-queries.md)
+ [Transformasi](panel-transformations.md)
+ [Opsi bidang dan penggantian](field-options-overrides.md)
+ [Editor panel](AMG-panel-editor.md)
+ [Panel perpustakaan](AMG-library-panel.md)
+ [Visualisasi](AMG-visualizations.md)

# Menambahkan panel
<a name="add-a-panel-to-a-dashboard"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Anda dapat menggunakan panel untuk menampilkan data Anda dalam bentuk visual. Topik ini memandu Anda melalui langkah-langkah dasar untuk membangun panel. 

**Untuk menambahkan panel ke dasbor**

1.  Pilih dasbor yang ingin Anda tambahkan panel. 

1.  Pilih ikon **Add panel**. 

1.  Pilih **Tambahkan panel baru**. 

    Ruang kerja Grafana membuat panel grafik kosong dengan sumber data default Anda dipilih. 

1.  Meskipun tidak diperlukan, kami sarankan Anda menambahkan judul dan deskripsi yang bermanfaat ke panel Anda. Anda dapat secara opsional menggunakan variabel yang telah Anda tentukan di kedua bidang, tetapi bukan variabel global. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md).
   + **Judul panel** — Teks yang dimasukkan dalam bidang ini ditampilkan di bagian atas panel Anda di editor panel dan di dasbor.
   + **Deskripsi** — Teks yang dimasukkan dalam bidang ini ditampilkan di tooltip di sudut kiri atas panel. Tulis deskripsi panel dan data yang Anda tampilkan.

1. Tulis kueri untuk panel. Untuk menampilkan visualisasi, setiap panel membutuhkan setidaknya satu kueri. Anda menulis kueri pada tab **Query** dari editor panel. Untuk informasi selengkapnya, lihat [Kueri](panel-queries.md).

   1. Pilih sumber data. Di baris pertama tab **Query**, pilih daftar dropdown untuk melihat semua sumber data yang tersedia. Daftar ini mencakup semua sumber data yang Anda tambahkan. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md). 

   1. Tulis atau buat kueri dalam bahasa kueri sumber data Anda. Opsi akan bervariasi. Lihat dokumentasi sumber data spesifik Anda untuk panduan khusus. 

1.  Di bagian **Visualisasi** tab **Panel**, pilih jenis visualisasi. Ruang kerja Grafana menampilkan pratinjau hasil kueri Anda dengan visualisasi yang diterapkan. 

1. Kami menyarankan Anda menambahkan catatan untuk menjelaskan perubahan Anda sebelum memilih **Simpan**. Catatan sangat membantu jika Anda perlu mengembalikan dasbor ke versi sebelumnya. 

1.  Untuk menyimpan dasbor, pilih **Simpan** di sudut kanan atas layar. 

# Menghapus panel
<a name="Deleting-a-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Untuk menghapus panel di Grafana, selesaikan langkah-langkah berikut:
+  Pilih drop-down di sebelah judul panel dan pilih **Hapus panel**. 

atau
+ Arahkan penunjuk Anda ke panel dan gunakan urutan pintasan keyboard “p r”.

# Kueri
<a name="panel-queries"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Panel ruang kerja Grafana menggunakan *Kueri* untuk berkomunikasi dengan sumber data untuk mendapatkan data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data. Jika kueri terbentuk dengan benar, sumber data merespons. Dalam opsi sumber data panel, Anda dapat menyesuaikan seberapa sering kueri dikirim ke sumber data dan berapa banyak titik data yang dikumpulkan. 

 Ruang kerja Grafana mendukung hingga 26 kueri per panel. 

## Editor kueri
<a name="query-editors"></a>

 Editor kueri adalah formulir yang membantu Anda menulis kueri. Bergantung pada sumber data Anda, editor kueri mungkin memberikan penyelesaian otomatis, nama metrik, atau saran variabel. 

 Karena perbedaan antara bahasa kueri, sumber data mungkin memiliki editor kueri yang terlihat berbeda.

## Sintaks kueri
<a name="query-syntax"></a>

 Sumber data memiliki bahasa kueri dan sintaks yang berbeda untuk meminta data. Berikut adalah dua contoh kueri.

 **PostgreSQL** 

```
SELECT hostname FROM host WHERE region IN($region)
```

 **PromQL** 

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

 Untuk informasi selengkapnya tentang menulis kueri untuk sumber data Anda, lihat dokumentasi untuk sumber data tersebut. Sumber data tercantum dalam[Connect ke sumber data](AMG-data-sources.md).

## Tab kueri UI
<a name="query-tab-ui"></a>

 Tab **Query** terdiri dari elemen-elemen berikut: 
+  Pemilih sumber data 
+  Opsi kueri 
+  Tombol inspektur kueri 
+  Daftar editor kueri 

### Pemilih sumber data
<a name="data-source-selector"></a>

 Pemilih sumber data adalah daftar dropdown. Pilih untuk memilih sumber data yang telah Anda tambahkan. Saat Anda membuat panel, Grafana Terkelola Amazon secara otomatis memilih sumber data default Anda. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md). 

 Selain sumber data yang telah Anda konfigurasikan di ruang kerja Grafana Anda, tiga sumber data khusus tersedia. 
+ **TestDataDB** — Sumber data bawaan yang menghasilkan data berjalan acak. Sumber data Grafana berguna untuk menguji visualisasi dan menjalankan eksperimen.
+  **Campuran** — Sumber data untuk menanyakan beberapa sumber data di panel yang sama. Saat sumber data ini dipilih, Anda dapat memilih sumber data untuk setiap kueri baru yang Anda tambahkan.
  +  Kueri pertama akan menggunakan sumber data yang dipilih sebelum Anda memilih **Mixed**. 
  +  Anda tidak dapat mengubah kueri yang ada untuk menggunakan sumber data Campuran. 
+ **Dasbor** —Sumber data untuk menggunakan set hasil dari panel lain di dasbor yang sama. 

### Opsi kueri
<a name="query-options"></a>

 Untuk melihat setelan sumber data yang dipilih, pilih **Opsi kueri** di sebelah pemilih sumber data. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini. 

 Grafana Terkelola Amazon menetapkan default yang ditampilkan dalam teks abu-abu gelap. Perubahan ditampilkan dalam teks putih. Untuk mengembalikan bidang ke pengaturan default, hapus teks putih dari bidang. 

 Anda dapat menggunakan opsi kueri sumber data panel berikut: 
+  **Titik data maks** - Jika sumber data mendukungnya, tetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, sumber data mengkonsolidasikannya (mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata atau maks atau fungsi lainnya). 

   Ada dua alasan utama untuk membatasi jumlah poin: kinerja dan menghaluskan garis. Nilai default adalah lebar (atau jumlah piksel) grafik, yang menghindari memiliki lebih banyak titik data daripada yang dapat ditampilkan panel grafik. 

   Dengan data streaming, nilai titik data maks digunakan untuk buffer bergulir. (Streaming adalah aliran data yang berkelanjutan, dan buffering adalah cara untuk membagi aliran menjadi beberapa bagian). 
+  **Interval min** - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, biasanya interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak perlu memiliki interval yang lebih rendah dari itu. Kasus penggunaan lainnya adalah mengaturnya ke minimum yang lebih tinggi daripada interval pengikisan untuk mendapatkan kueri yang lebih kasar dan berfungsi dengan baik. 
+  **Interval** — Rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu. 

   Grafana yang Dikelola Amazon secara otomatis menghitung interval yang sesuai yang dapat digunakan sebagai variabel dalam kueri templat. Variabelnya dalam detik:`$__interval`; atau dalam milidetik:`$__interval_ms`. Hal ini biasanya digunakan dalam fungsi agregasi seperti `sum` atau`average`. Misalnya, ini adalah kueri Prometheus menggunakan variabel interval:. `rate(http_requests_total[$__interval])` 

   Interval otomatis ini dihitung berdasarkan lebar grafik. Jika pengguna memperkecil banyak, interval menjadi lebih besar sehingga menghasilkan agregasi yang lebih kasar. Jika pengguna memperbesar, interval berkurang sehingga menghasilkan agregasi yang lebih halus. 

   Untuk informasi selengkapnya, lihat [Variabel global](variables-types.md#global-variables). 
+  **Waktu relatif** — Ganti rentang waktu relatif untuk panel individu yang menyebabkannya berbeda dari apa yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Ini memungkinkan Anda menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama. 
+  **Pergeseran waktu** - Menyediakan cara lain untuk mengganti rentang waktu untuk panel individu. Fungsi ini hanya berfungsi dengan rentang waktu relatif, dan Anda dapat menyesuaikan rentang waktu. 

   Misalnya, Anda dapat menggeser rentang waktu panel menjadi 2 jam lebih awal dari pemilih waktu dasbor. Untuk informasi selengkapnya, lihat [Kontrol rentang waktu](dashboard-time-range-controls.md). 
+  **Cache timeout** — (Bidang ini hanya terlihat jika tersedia di sumber data Anda.) Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Ini ditentukan sebagai nilai numerik dalam hitungan detik. 

### Tombol inspektur kueri
<a name="query-inspector-button"></a>

 Anda dapat memilih **Query inspector** untuk membuka tab **Query** dari panel inspector. Pada tab **Query**, Anda dapat melihat permintaan kueri yang dikirim oleh panel dan responsnya. 

 Pilih **Segarkan** untuk melihat teks lengkap permintaan yang dikirim oleh panel ini ke server. 

**catatan**  
 Anda perlu menambahkan setidaknya satu kueri sebelum inspektur Kueri dapat mengembalikan hasil. 

 Untuk informasi lebih lanjut tentang inspektur panel, lihat[Periksa panel](inspect-a-panel.md). 

### Daftar editor kueri
<a name="query-editor-list"></a>

 Di UI, kueri diatur dalam baris kueri yang dapat dilipat. Setiap baris kueri berisi editor kueri dan diidentifikasi dengan huruf (A, B, C, dan sebagainya). 

## Berbagi hasil kueri antar panel
<a name="share-query-results-between-panels"></a>

 Dengan Amazon Managed Grafana, Anda dapat menggunakan hasil kueri dari satu panel untuk panel lain di dasbor. Berbagi hasil kueri di seluruh panel mengurangi jumlah kueri yang dibuat ke sumber data Anda, yang dapat meningkatkan kinerja dasbor Anda. 

 Sumber data Dasbor memungkinkan Anda memilih panel di dasbor yang berisi kueri yang ingin Anda bagikan hasilnya. Alih-alih mengirim kueri terpisah untuk setiap panel, Amazon Managed Grafana mengirimkan satu kueri, dan panel lainnya menggunakan hasil kueri untuk membuat visualisasi. 

 Strategi ini dapat secara drastis mengurangi jumlah kueri yang dibuat ketika, misalnya, Anda memiliki beberapa panel yang memvisualisasikan data yang sama. 

**Untuk berbagi kueri sumber data dengan panel lain**

1.  Buat dasbor. Untuk informasi selengkapnya, lihat [Membuat dasbor](getting-started-grafanaui.md#create-a-dashboard). 

1.  Tambahkan panel. Untuk informasi selengkapnya, lihat [Menambahkan panel](add-a-panel-to-a-dashboard.md). 

1.  Ubah judul menjadi**Source panel**. Anda akan menggunakan panel ini sebagai sumber untuk panel lainnya. Tentukan kueri atau kueri yang akan dibagikan. Jika Anda tidak memiliki sumber data yang tersedia saat ini, Anda dapat menggunakan sumber data **Grafana**, yang mengembalikan deret waktu acak yang dapat Anda gunakan untuk pengujian. 

1.  Tambahkan panel kedua, lalu pilih sumber data **Dasbor** di editor kueri. 

1.  Di **Gunakan hasil dari daftar panel**, pilih panel pertama yang Anda buat. 

 Semua query didefinisikan dalam panel sumber sekarang tersedia untuk panel baru. Kueri yang dibuat di panel sumber dapat dibagikan dengan beberapa panel. 

 Untuk pergi ke panel di mana kueri didefinisikan, pilih kueri itu. 

# Kueri yang direkam
<a name="recorded-queries"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Anda dapat melihat tren dari waktu ke waktu dengan mengambil snapshot dari titik data pada interval yang ditetapkan menggunakan kueri yang direkam. Ini dapat memberi Anda wawasan tentang tren bersejarah.

Untuk plugin yang tidak mengembalikan deret waktu, mungkin berguna untuk memplot data historis. Misalnya, Anda mungkin ingin melakukan kueri **ServiceNow**untuk melihat riwayat waktu respons permintaan tetapi hanya dapat mengembalikan point-in-time metrik saat ini.

## Cara kerja kueri yang direkam
<a name="how-recorded-queries-work"></a>

Kueri yang direkam hanya berfungsi dengan plugin sumber data backend. Untuk informasi lebih lanjut, lihat Plugin [sumber data Backend](https://grafana.com/tutorials/build-a-data-source-backend-plugin/). Anda dapat merekam tiga jenis kueri:
+ single row and column - Sebuah query yang mengembalikan satu baris dan kolom.
+ jumlah baris - Kueri yang mengembalikan baris bermakna untuk dihitung.
+ ekspresi - Ekspresi apa pun. Untuk mempelajari lebih lanjut tentang membuat dan menggunakan ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

Setelah kueri yang direkam dibuat atau diaktifkan, ia segera membuat snapshot dan terus membuat snapshot pada interval yang ditetapkan. Kueri yang direkam berhenti mengambil snapshot saat dinonaktifkan, dihapus, atau saat Grafana tidak berjalan. Titik data dikumpulkan di backend dengan menjalankan kueri yang direkam dan meneruskan setiap hasil ke instance Prometheus yang diaktifkan penulisan jarak jauh.

**catatan**  
Anda harus mengonfigurasi sumber data Prometheus dan mengaitkannya dengan target penulisan Jarak Jauh sebelum kueri yang direkam dapat digunakan.

## Buat kueri yang direkam
<a name="create-a-recorded-query"></a>

Untuk membuat kueri yang direkam, selesaikan langkah-langkah berikut:

1. Temukan atau buat kueri yang ingin Anda rekam di dasbor di panel edit. Query hanya harus mengembalikan satu baris dan kolom. Jika mengembalikan lebih banyak, Anda masih dapat mencatat jumlah hasil yang dikembalikan menggunakan opsi *hitung*. Sumber data kueri harus berupa sumber data backend. Ekspresi dapat digunakan untuk mengumpulkan data dari query deret waktu. Untuk mempelajari lebih lanjut tentang membuat dan menggunakan ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

1. Pilih menu **kueri rekaman** yang terletak di editor kueri.

1. Masukkan informasi kueri yang direkam. Semua bidang diperlukan kecuali dinyatakan lain. 
   + Nama - Nama kueri yang direkam.
   + Deskripsi - (opsional) Jelaskan kueri yang direkam sesuai keinginan Anda untuk muncul dalam daftar kueri yang direkam.
   + Interval - Interval di mana snapshot akan diambil. Interval dimulai saat Anda membuat kueri yang direkam dan berhenti jika Anda menjeda atau menghapus kueri yang direkam. Untuk informasi selengkapnya tentang menjeda dan menghapus kueri yang direkam, lihat [Mengelola](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries) kueri yang direkam.
   + Rentang - Rentang waktu relatif dari kueri. Jika Anda memilih rentang 30m dan interval 1 jam kueri akan mengambil snapshot setiap jam dari 30 menit terakhir.
   + Hitung hasil kueri - Jika Anda ingin menghitung baris yang dikembalikan dari kueri Anda, aktifkan opsi ini. Jika opsi ini tidak aktif, kueri Anda harus mengembalikan satu baris dengan satu nilai.

1. Uji kueri rekaman Anda dengan memilih tombol kueri yang direkam uji.

1. Pilih **Mulai merekam kueri**.

## Menambahkan kueri yang direkam
<a name="Adding-a-recorded-query"></a>

Anda dapat menambahkan kueri rekaman yang ada ke panel di dasbor. Untuk setiap kueri rekaman yang Anda tambahkan, kueri Prometheus dibuat:. `generated_recorded_query_name{id="generated_id", name="recorded query name"}` Kueri yang dibuat dari Prometheus mengembalikan semua snapshot yang dikumpulkan dari kueri yang direkam.

1. Arahkan ke panel di dasbor tempat Anda ingin menambahkan kueri yang direkam.

1. Pilih menu **\$1 Kueri yang direkam**.

1. Jika Anda ingin memfilter kueri yang direkam berdasarkan sumber data, pilih sumber data dari menu tarik-turun filter menurut sumber data.

1. Pilih **Tambahkan** menu pada kueri yang direkam untuk menambahkannya ke panel.

Setelah menambahkan kueri yang direkam ke panel, sumber data panel akan menjadi`-- Mixed --`. Kueri rekaman Anda diwakili oleh `Prometheus` kueri dengan label nama yang cocok dengan nama kueri rekaman Anda. Lihat [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) untuk mempelajari lebih lanjut tentang sumber data Prometheus.

Jika setelah menambahkan kueri yang direkam, kueri dengan sumber `-- Mixed --` data alih-alih sumber data Prometheus muncul, ini bisa berarti bahwa target penulisan jarak jauh tidak disiapkan `Prometheus ` untuk kueri yang direkam. Lihat [target penulisan jarak jauh](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) untuk mengatur titik tulis jarak jauh.

## Menggunakan kueri yang direkam
<a name="using-a-recorded-query"></a>

Untuk menggunakan kueri yang direkam, buat dan tambahkan ke dasbor. Setelah itu, dapat dikelola di **Preferensi** dari tab **Kueri yang direkam**.

## Mengelola kueri yang direkam
<a name="managing-recorded-queries"></a>

Kueri yang direkam dapat dijeda atau diaktifkan dan dihapus dari tab Kueri yang direkam di Preferensi. Menghapus kueri yang direkam akan menghapusnya dari Grafana, tetapi informasi yang dikumpulkan di Prometheus akan tetap ada di sana. Menjeda kueri yang direkam tidak akan lagi mengumpulkan titik data baru sampai dilanjutkan.

## Target tulis jarak jauh
<a name="remote_write_target"></a>

Target penulisan jarak jauh adalah sumber data **Prometheus** tempat titik data kueri yang direkam ditulis. Anda akan memerlukan Prometheus dengan penulisan jarak jauh diaktifkan dan Anda perlu membuat sumber data untuk Prometheus ini.

Untuk mengedit target penulisan jarak jauh pilih **Edit Target Tulis Jarak Jauh** di menu konsol pada tab **Kueri Rekaman** di **Preferensi**. Pilih sumber data **Prometheus** yang mengaktifkan penulisan jarak jauh dan masukkan jalur tulis jarak jauh.

# Transformasi
<a name="panel-transformations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Transformasi memproses hasil yang ditetapkan sebelum diteruskan ke visualisasi. Anda mengakses transformasi di tab **Transform pada editor** panel Grafana Terkelola Amazon.

Anda dapat menggunakan transformasi untuk mengganti nama bidang, menggabungkan deret waktu terpisah bersama-sama, melakukan matematika di seluruh kueri, dan banyak lagi. Jika Anda memiliki dasbor besar atau kueri berat, dapat menggunakan kembali hasil kueri dari satu panel ke panel lain dapat memberikan keuntungan kinerja yang besar.

**catatan**  
Transformasi terkadang menghasilkan data yang tidak dapat digambarkan. Ketika itu terjadi, Amazon Managed Grafana menampilkan saran tentang visualisasi. Pilih saran untuk beralih ke visualisasi tabel. Ini sering membantu Anda lebih memahami apa yang dilakukan transformasi terhadap data Anda. 

Grafana yang Dikelola Amazon menerapkan transformasi dalam urutan yang terdaftar di layar. Setiap transformasi menciptakan set hasil baru yang diteruskan ke transformasi berikutnya dalam pipeline. 

Urutan dapat membuat perbedaan besar dalam bagaimana hasil Anda terlihat. Misalnya, jika Anda menggunakan transformasi reduksi untuk memadatkan semua hasil dari satu kolom menjadi satu nilai, Anda dapat menerapkan transformasi hanya untuk nilai tunggal itu. 

**Prasyarat**

Sebelum Anda menerapkan transformasi, semua hal berikut harus benar:
+ Anda telah memasukkan kueri dan mengembalikan data dari sumber data. Untuk informasi selengkapnya tentang kueri, lihat [Pertanyaan](panel-queries.md).
+ Anda telah menerapkan visualisasi yang mendukung kueri, seperti salah satu visualisasi berikut:
  + Pengukur batang
  + Pengukur
  + Grafik
  + Peta panas
  + Beberapa catatan
  + Stat
  + Tabel

## Menerapkan transformasi
<a name="apply-a-transformation"></a>

 Transformasi tersedia dari tab **Transform** di panel bawah editor panel, di sebelah tab **Queries**. 

**Untuk menerapkan transformasi**

1.  Pada panel yang ingin Anda tambahkan transformasi, pilih judul panel, lalu pilih **Edit**. 

1.  Pilih tab **Transformasi**. 

1.  Pilih transformasi. 

    Di baris transformasi yang muncul, Anda dapat mengonfigurasi opsi transformasi. 

1.  Untuk menerapkan transformasi lain, pilih **Tambahkan transformasi**. Perlu diingat bahwa transformasi berikutnya bertindak pada set hasil yang dikembalikan oleh transformasi sebelumnya. 

 Jika Anda mengalami masalah, pilih ikon bug untuk [men-debug transformasi Anda](#debug-transformations). 

 Untuk menghapus transformasi, pilih ikon tempat sampah. 

## Jenis dan opsi transformasi
<a name="transformation-types-and-options"></a>

 Ruang kerja Grafana mencakup transformasi berikut. 

**Topics**
+ [Mengurangi](#reduce)
+ [Gabungkan](#merge)
+ [Filter berdasarkan nama](#filter-by-name)
+ [Filter data berdasarkan kueri](#filter-data-by-query)
+ [Mengatur bidang](#organize-fields)
+ [Bergabung dengan bidang (bergabung luar)](#join-by-field-outer-join)
+ [Tambahkan bidang dari perhitungan](#add-field-from-calculation)
+ [Label ke bidang](#labels-to-fields)
+ [Grup Oleh](#sort-by)
+ [Grup Oleh](#group-by)
+ [Seri ke baris](#series-to-rows)
+ [Filter data berdasarkan nilai](#filter-data-by-value)
+ [Transformasi debug](#debug-transformations)

### Mengurangi
<a name="reduce"></a>

 Terapkan transformasi **Reduce** ketika Anda ingin menyederhanakan hasil Anda menjadi satu nilai. Mengurangi pada dasarnya menghapus komponen waktu. Jika divisualisasikan sebagai tabel, itu mengurangi kolom menjadi satu baris (nilai). 

 Di bidang **Perhitungan**, masukkan satu atau beberapa jenis perhitungan. Pilih untuk melihat daftar pilihan perhitungan. Untuk informasi tentang perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md).

Setelah Anda memilih setidaknya satu perhitungan, Amazon Managed Grafana menampilkan satu nilai menggunakan perhitungan yang Anda pilih. Jika Anda memilih lebih dari satu perhitungan, lebih dari satu nilai ditampilkan. 

### Gabungkan
<a name="merge"></a>

 Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel. Nilai yang dapat digabungkan digabungkan ke dalam baris yang sama. Nilai dapat digabungkan jika bidang bersama berisi data yang sama. 

 Dalam contoh berikut, dua query mengembalikan data tabel. Data divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi. 

Kueri A


|  Waktu  |  Pekerjaan  |  Waktu aktif  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  simpul  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

Kueri B


|  Waktu  |  Pekerjaan  |  Kesalahan  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  simpul  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

 Berikut adalah hasilnya setelah menerapkan transformasi **Merge**. 


|  Waktu  |  Pekerjaan  |  Kesalahan  |  Waktu aktif  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  simpul  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

### Filter berdasarkan nama
<a name="filter-by-name"></a>

 Gunakan transformasi ini untuk menghapus bagian dari hasil kueri. 

 Grafana Terkelola Amazon menampilkan bidang **Identifier**, diikuti oleh bidang yang ditampilkan oleh kueri Anda. 

 Anda dapat menerapkan filter dengan salah satu dari dua cara: 
+  Masukkan ekspresi regex. 
+  Pilih bidang untuk beralih pemfilteran pada bidang itu. Bidang yang difilter ditampilkan dengan teks abu-abu gelap, bidang tanpa filter memiliki teks putih. 

### Filter data berdasarkan kueri
<a name="filter-data-by-query"></a>

 Gunakan transformasi ini di panel yang memiliki beberapa kueri, jika Anda ingin menyembunyikan satu atau beberapa kueri. 

 Grafana Terkelola Amazon menampilkan surat identifikasi kueri dalam teks abu-abu gelap. Untuk mengaktifkan pemfilteran, pilih pengenal kueri. Jika surat kueri berwarna putih, hasilnya akan ditampilkan. Jika surat kueri gelap, hasilnya disembunyikan. 

### Mengatur bidang
<a name="organize-fields"></a>

 Gunakan transformasi ini untuk mengganti nama, menyusun ulang, atau menyembunyikan bidang yang dikembalikan oleh kueri. 

**catatan**  
 Transformasi ini hanya berfungsi di panel yang memiliki satu kueri. Jika panel Anda memiliki beberapa kueri, Anda harus menerapkan transformasi **Join by field (outer join)** atau menghapus kueri tambahan. 

 Grafana Terkelola Amazon menampilkan daftar bidang yang dikembalikan oleh kueri. Anda dapat membuat salah satu dari perubahan berikut: 
+  Ubah urutan bidang dengan menjeda bidang. Kursor berubah menjadi tangan, dan kemudian Anda dapat menyeret bidang ke tempat barunya. 
+  Sembunyikan atau tampilkan bidang dengan memilih ikon mata di sebelah nama bidang. 
+  Ganti nama bidang dengan mengetikkan nama baru di kotak **Ganti nama**. 

### Bergabung dengan bidang (bergabung luar)
<a name="join-by-field-outer-join"></a>

 Gunakan transformasi ini untuk menggabungkan beberapa deret waktu dari hasil yang ditetapkan berdasarkan bidang. 

 Transformasi ini berguna jika Anda ingin menggabungkan kueri sehingga Anda dapat menghitung hasil dari bidang. 

### Tambahkan bidang dari perhitungan
<a name="add-field-from-calculation"></a>

 Gunakan transformasi ini untuk menambahkan bidang baru yang dihitung dari dua bidang lainnya. Setiap transformasi memungkinkan Anda menambahkan satu bidang baru. 
+  **Mode** - Pilih mode: 
  +  **Kurangi baris** - Terapkan perhitungan yang dipilih pada setiap baris bidang yang dipilih secara independen. 
  +  **Opsi biner** — Terapkan operasi matematika dasar (`sum``multiply`,, dan seterusnya) pada nilai dalam satu baris dari dua bidang yang dipilih. 
+  **Nama bidang** — Pilih nama bidang yang ingin Anda gunakan dalam perhitungan untuk bidang baru. 
+  **Perhitungan -** Pilih perhitungan yang akan digunakan saat Amazon Managed Grafana membuat bidang baru. Pilih bidang untuk melihat daftar pilihan perhitungan. Untuk informasi tentang perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md). 
+  **Alias** — (Opsional) Masukkan nama bidang baru Anda. Jika Anda membiarkan ini kosong, bidang akan diberi nama agar sesuai dengan perhitungan. 
+  **Ganti semua bidang** — (Opsional) Gunakan opsi ini jika Anda ingin menyembunyikan semua bidang lain dan hanya menampilkan bidang terhitung Anda dalam visualisasi. 

### Label ke bidang
<a name="labels-to-fields"></a>

**catatan**  
 Untuk menerapkan transformasi ini, kueri Anda harus mengembalikan bidang berlabel. 

 Saat Anda memilih transformasi ini, Grafana Terkelola Amazon secara otomatis mengubah semua data berlabel menjadi bidang. 

 Misalnya, pertimbangkan hasil kueri dari dua deret waktu. 

 1: label Server = Server A, DataCenter = EU 2: label Server = Server B, DataCenter = EU 

 Transformasi ini akan menghasilkan tabel berikut. 


|  Waktu  |  Server  |  Pusat data  |  Nilai  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Server A  |  EU  |  1  | 
|  2020-07-07 11:34:20  |  Peladen B  |  EU  |  2  | 

 **Nama bidang nilai**; Jika Anda memilih `Server` sebagai **nama bidang Nilai**, Anda akan mendapatkan satu bidang untuk setiap nilai `Server` label. 


|  Waktu  |  Pusat data  |  Server A  |  Peladen B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  EU  |  1  |  2  | 

### Grup Oleh
<a name="sort-by"></a>

Transformasi ini mengurutkan setiap frame berdasarkan bidang yang dikonfigurasi. Ketika `reverse` dicentang, nilai dikembalikan dalam urutan yang berlawanan.

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

 Transformasi ini mengelompokkan data dengan nilai bidang (kolom) tertentu dan memproses perhitungan pada setiap grup. Perhitungan yang tersedia sama dengan untuk transformasi Reduce. 

 Berikut adalah contoh data asli. 


|  Waktu  |  ID Server  |  Suhu CPU  |  Status Server  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  Matikan  | 
|  2020-07-07 11:34:20  |  server 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  server 2  |  90  |  Kelebihan  | 
|  2020-07-07 10:31:22  |  server 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  server 3  |  62  |  Rebooting  | 
|  2020-07-07 09:30:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

 Transformasi ini membutuhkan dua langkah. Pertama, Anda menentukan satu atau beberapa bidang untuk mengelompokkan data berdasarkan. Ini akan mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya. Misalnya, jika Anda **Kelompokkan Berdasarkan** `Server ID` bidang, itu akan mengelompokkan data dengan cara ini: 


|  Waktu  |  ID Server  |  Suhu CPU  |  Status Server  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  Matikan  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

Semua baris dengan nilai yang sama `Server ID` dikelompokkan bersama. 

Setelah memilih bidang mana Anda ingin mengelompokkan data Anda, Anda dapat menambahkan berbagai perhitungan pada bidang lain, dan perhitungan akan diterapkan pada setiap kelompok baris. Misalnya, Anda mungkin ingin menghitung rata-rata `CPU temperature` untuk masing-masing server tersebut. Anda dapat menambahkan perhitungan *rata-rata* yang diterapkan di `CPU Temperature` lapangan untuk mendapatkan yang berikut ini.


|  ID Server  |  Suhu CPU (rata-rata)  | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  88,6  | 
|  server 3  |  59,6  | 

Dan Anda dapat menambahkan lebih dari satu perhitungan tersebut. Misalnya, Anda dapat menggunakan perhitungan berikut. 
+  Untuk bidang`Time`, Anda dapat menghitung nilai *Terakhir*, untuk mengetahui kapan titik data terakhir diterima untuk setiap server. 
+  Untuk bidang`Server Status`, Anda dapat menghitung nilai *Terakhir* untuk mengetahui nilai status terakhir untuk setiap server. 
+  Untuk bidang`Temperature`, Anda juga dapat menghitung nilai *Terakhir* untuk mengetahui suhu yang dipantau terbaru untuk setiap server. 

 Transformasi Grup By menghasilkan hasil sebagai berikut. 


|  ID Server  |  Suhu CPU (rata-rata)  |  Suhu CPU (terakhir)  |  Waktu (terakhir)  |  Status Server (terakhir)  | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  2020-07-07 11:34:20  |  Matikan  | 
|  server 2  |  88,6  |  90  |  2020-07-07 10:32:20  |  Kelebihan  | 
|  server 3  |  59,6  |  62  |  2020-07-07 11:34:20  |  OK  | 

Dengan menggunakan transformasi ini, Anda dapat mengekstrak beberapa informasi penting dari deret waktu Anda dan menampilkannya dengan cara yang nyaman. 

### Seri ke baris
<a name="series-to-rows"></a>

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri data deret waktu menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel. 

Hasil dari transformasi ini akan berisi tiga kolom:`Time`,`Metric`, dan`Value`. `Metric`Kolom ditambahkan sehingga Anda dapat melihat kueri mana metrik berasal. Sesuaikan nilai ini dengan mendefinisikan `Label` pada kueri sumber. 

Pada contoh di bawah ini, dua kueri mengembalikan data deret waktu. Ini divisualisasikan sebagai dua tabel terpisah sebelum transformasi diterapkan. 

 Kueri A 


|  Waktu  |  Temperatur  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  25  | 
|  2020-07-07 10:31:22  |  22  | 
|  2020-07-07 09:30:05  |  19  | 

 Kueri B 


|  Waktu  |  Kelembaban  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  24  | 
|  2020-07-07 10:32:20  |  29  | 
|  2020-07-07 09:30:57  |  33  | 

 Menerapkan `Series to rows` transformasi menghasilkan hasil sebagai berikut. 


|  Waktu  |  Metrik  |  Nilai  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  Temperatur  |  25  | 
|  2020-07-07 11:34:20  |  Kelembaban  |  22  | 
|  2020-07-07 10:32:20  |  Kelembaban  |  29  | 
|  2020-07-07 10:31:22  |  Temperatur  |  22  | 
|  2020-07-07 09:30:57  |  Kelembaban  |  33  | 
|  2020-07-07 09:30:05  |  Temperatur  |  19  | 

### Filter data berdasarkan nilai
<a name="filter-data-by-value"></a>

Transformasi ini memungkinkan Anda untuk memfilter data Anda secara langsung di ruang kerja Grafana dan menghapus beberapa titik data dari hasil kueri Anda. Anda memiliki opsi untuk menyertakan atau mengecualikan data yang cocok dengan satu atau beberapa kondisi yang Anda tentukan. Kondisi diterapkan pada bidang yang dipilih.

Transformasi ini berguna jika sumber data Anda tidak memfilter secara native berdasarkan nilai. Anda juga dapat menggunakan ini untuk mempersempit nilai untuk ditampilkan jika Anda menggunakan kueri bersama.

 Kondisi yang tersedia untuk semua bidang adalah sebagai berikut:
+  **Regex - Cocokkan ekspresi regex**. 
+  **Apakah Null** — Cocokkan jika nilainya nol.
+  **Is Not Null** — Cocokkan jika nilainya tidak null.
+  **Sama** - Cocokkan jika nilainya sama dengan nilai yang ditentukan. 
+  **Berbeda** - Cocokkan jika nilainya berbeda dari nilai yang ditentukan. 

Kondisi yang tersedia untuk bidang angka adalah sebagai berikut:
+  **Lebih besar** — Cocokkan jika nilainya lebih besar dari nilai yang ditentukan. 
+  **Lower** — Cocokkan jika nilainya lebih rendah dari nilai yang ditentukan. 
+  **Lebih besar atau sama** - Cocokkan jika nilainya lebih besar dari atau sama dengan nilai yang ditentukan. 
+  **Lebih rendah atau sama** - Cocokkan jika nilainya lebih rendah dari atau sama dengan nilai yang ditentukan. 
+  **Rentang** - Cocokkan rentang antara minimum dan maksimum yang ditentukan. Minimum dan maksimum termasuk dalam kisaran.

Anda dapat menambahkan lebih dari satu kondisi ke filter. Bila Anda memiliki lebih dari satu kondisi, Anda dapat memilih apakah Anda ingin tindakan sertakan atau kecualikan diterapkan pada baris yang Cocokkan semua atau salah satu kondisi yang Anda tambahkan.

Kondisi yang tidak valid atau tidak lengkap dikonfigurasi diabaikan.

### Transformasi debug
<a name="debug-transformations"></a>

Untuk melihat input dan set hasil output transformasi, pilih ikon bug di sisi kanan baris transformasi. 

 Grafana Terkelola Amazon menampilkan tampilan debug transformasi di bawah baris transformasi. 

# Opsi bidang dan penggantian
<a name="field-options-overrides"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Bagian ini menjelaskan opsi bidang dan penggantian bidang di Grafana Terkelola Amazon dan cara menggunakannya. 

 Model data yang digunakan dalam ruang kerja Grafana, kerangka data, adalah struktur tabel berorientasi kolom yang menyatukan deret waktu dan hasil kueri tabel. Setiap kolom dalam struktur ini disebut *bidang*. Bidang dapat mewakili satu deret waktu atau kolom tabel. 

 Opsi bidang memungkinkan Anda mengubah cara data ditampilkan dalam visualisasi Anda. Opsi dan penggantian yang Anda terapkan tidak mengubah data, mereka mengubah cara Amazon Managed Grafana menampilkan data. 

## Opsi bidang
<a name="field-options-overview"></a>

 *Opsi bidang*, baik standar maupun kustom, dapat ditemukan di tab **Bidang** di editor panel. Perubahan yang dibuat pada tab ini berlaku untuk semua bidang (yaitu, seri dan kolom). Misalnya, jika Anda mengubah unit menjadi persentase, semua bidang dengan nilai numerik ditampilkan dalam persentase. Pelajari cara menerapkan opsi bidang di[Konfigurasikan semua bidang](#configure-all-fields). 

## Pengesampaian lapangan
<a name="field-overrides-overview"></a>

 *Penggantian bidang* dapat ditambahkan pada tab **Overrides** di editor panel. Di sana Anda dapat menambahkan opsi yang sama seperti yang Anda temukan di tab **Bidang**, tetapi hanya diterapkan ke bidang tertentu. Pelajari cara menerapkan override in[Konfigurasikan bidang tertentu](#configure-specific-fields).

## Opsi bidang yang tersedia dan penggantian
<a name="available-field-options-and-overrides"></a>

 Jenis opsi bidang umum untuk opsi bidang dan penggantian bidang. Satu-satunya perbedaan adalah apakah perubahan akan berlaku untuk semua bidang (diterapkan pada tab **Bidang**) atau ke subset bidang (diterapkan pada tab **Overrides**). 
+  [Opsi bidang standar](#standard-field-options)berlaku untuk semua visualisasi panel yang memungkinkan transformasi. 
+  [Opsi bidang tabel](table-panel.md#table-field-options)berlaku hanya untuk visualisasi panel tabel. 

### Konfigurasikan semua bidang
<a name="configure-all-fields"></a>

 Untuk mengubah cara semua bidang menampilkan data, Anda dapat mengubah opsi pada tab **Bidang**. Pada tab **Overrides**, Anda kemudian dapat mengganti opsi bidang untuk bidang tertentu. Untuk informasi selengkapnya, lihat [Konfigurasikan bidang tertentu](#configure-specific-fields). 

 Misalnya, Anda dapat mengubah jumlah tempat desimal yang ditampilkan di semua bidang dengan mengubah opsi **Desimal**. Untuk informasi selengkapnya tentang opsi, lihat [Opsi bidang standar](#standard-field-options) dan[Opsi bidang tabel](table-panel.md#table-field-options). 

#### Ubah opsi bidang
<a name="change-a-field-option"></a>

 Anda dapat mengubah opsi sebanyak yang Anda inginkan. 

**Untuk mengubah opsi bidang**

1.  Pilih panel yang ingin Anda edit, pilih judul panel, lalu pilih **Edit**. 

1.  Pilih tab **Bidang**. 

1.  Temukan opsi yang ingin Anda ubah. Anda dapat menentukan yang berikut: 
   +  [Opsi bidang standar](#standard-field-options), yang berlaku untuk semua visualisasi panel yang memungkinkan transformasi. 
   +  [Opsi bidang tabel](table-panel.md#table-field-options), yang hanya berlaku untuk visualisasi panel tabel. 

1.  Tambahkan opsi dengan menambahkan nilai di bidang. Untuk mengembalikan opsi ke nilai default, hapus teks putih di bidang. 

1.  Setelah selesai mengedit dasbor, pilih **Simpan**. 

#### Contoh opsi bidang
<a name="field-option-example"></a>

 Mari kita asumsikan bahwa kumpulan hasil adalah kerangka data yang terdiri dari dua bidang: waktu dan suhu. 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0  | 
|  2020-01-02 03:05:00  |  47.0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 Setiap bidang (kolom) dari struktur ini dapat memiliki opsi bidang yang diterapkan dengan cara yang mengubah cara nilainya ditampilkan. Misalnya, Anda dapat mengatur Satuan ke Temperature > Celcius, menghasilkan tabel berikut. 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0 °C  | 
|  2020-01-02 03:05:00  |  47.0° C  | 
|  2020-01-02 03:06:00  |  48.0 °C  | 

 Tempat desimal tidak berarti apa-apa dalam kasus ini. Anda dapat mengubah Desimal dari `auto` nol (`0`), menghasilkan tabel berikut. 


|  Waktu  |  suhu  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45° C  | 
|  2020-01-02 03:05:00  |  47° C  | 
|  2020-01-02 03:06:00  |  48° C  | 

### Konfigurasikan bidang tertentu
<a name="configure-specific-fields"></a>

 Anda dapat menggunakan penggantian untuk mengubah pengaturan untuk satu atau beberapa bidang. Opsi bidang untuk penggantian sama persis dengan opsi bidang yang tersedia dalam visualisasi tertentu. Satu-satunya perbedaan adalah Anda memilih bidang mana yang akan diterapkan. 

 **Misalnya, Anda dapat mengubah jumlah tempat desimal yang ditampilkan di semua bidang atau kolom numerik dengan mengubah opsi **Desimal** untuk Bidang dengan jenis yang cocok **dengan** Numerik.** Untuk informasi selengkapnya tentang opsi, lihat[Opsi bidang standar](#standard-field-options), yang berlaku untuk semua visualisasi panel yang memungkinkan transformasi, dan[Opsi bidang tabel](table-panel.md#table-field-options), yang hanya berlaku untuk visualisasi panel tabel. 

#### Tambahkan penggantian bidang
<a name="add-a-field-override"></a>

 Anda dapat mengganti opsi bidang sebanyak yang Anda inginkan. 

**Untuk menambahkan penggantian bidang**

1.  Pilih panel yang ingin Anda edit, pilih judul panel, lalu pilih **Edit**. 

1.  Pilih tab **Overrides**. 

1.  Pilih **Tambahkan penggantian untuk**. 

1.  Pilih bidang yang ingin Anda terapkan aturan penggantian. 
   +  **Bidang dengan nama** - Gunakan ini untuk memilih bidang dari daftar semua bidang yang tersedia. Properti yang Anda tambahkan ke aturan dengan pemilih ini hanya diterapkan ke bidang tunggal ini. 
   +  **Bidang dengan nama yang cocok dengan regex** — Gunakan ini untuk menentukan bidang yang akan diganti dengan ekspresi reguler. Properti yang Anda tambahkan ke aturan dengan menggunakan pemilih ini diterapkan ke semua bidang di mana nama bidang cocok dengan regex. 
   +  **Bidang dengan tipe** - Gunakan ini untuk memilih bidang berdasarkan jenis, seperti string, numerik, dan sebagainya. Properti yang Anda tambahkan ke aturan dengan pemilih ini diterapkan ke semua bidang yang cocok dengan jenis yang dipilih. 

1.  Pilih **Tambahkan properti override**. 

1.  Pilih opsi bidang yang ingin Anda terapkan. 

1.  Masukkan opsi dengan menambahkan nilai di bidang. Untuk mengembalikan opsi ke nilai default, hapus teks putih di bidang. 

1. Lanjutkan untuk menambahkan penggantian ke bidang ini dengan memilih **Tambahkan properti penggantian**, atau Anda dapat memilih **Tambahkan penggantian** dan pilih bidang lain untuk menambahkan penggantian.

1.  Setelah selesai, silakan pilih **Simpan**. 

#### Hapus penggantian bidang
<a name="delete-a-field-override"></a>

1.  Pilih tab Overrides yang berisi penggantian yang ingin Anda hapus. 

1.  Pilih ikon tempat sampah di sebelah override. 

#### Contoh penggantian bidang
<a name="field-override-example"></a>

Mari kita asumsikan bahwa kumpulan hasil kita adalah kerangka data yang terdiri dari empat bidang: waktu, suhu tinggi, suhu rendah, dan kelembaban. 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45,0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47.0  |  34.0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31.0  |  68  | 

 Mari kita terapkan opsi bidang dari [Contoh opsi bidang](#field-option-example) untuk menerapkan unit Celcius dan singkirkan tempat desimal. Ini menghasilkan tabel berikut. 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45° C  |  30° C  |  67° C  | 
|  2020-01-02 03:05:00  |  47° C  |  34° C  |  68° C  | 
|  2020-01-02 03:06:00  |  48° C  |  31° C  |  68° C  | 

 Bidang suhu terlihat bagus, tetapi kelembabannya tidak masuk akal. Anda dapat memperbaikinya dengan menerapkan opsi field override ke bidang kelembaban dan mengubah unit menjadi Misc > percent (0-100). Ini menghasilkan tabel yang jauh lebih masuk akal. 


|  Waktu  |  suhu tinggi  |  suhu rendah  |  kelembaban  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45° C  |  30° C  |  67%  | 
|  2020-01-02 03:05:00  |  47° C  |  34° C  |  68%  | 
|  2020-01-02 03:06:00  |  48° C  |  31° C  |  68%  | 

### Opsi bidang standar
<a name="standard-field-options"></a>

 Bagian ini menjelaskan opsi bidang yang tersedia. Mereka terdaftar dalam urutan abjad. 

 Anda dapat menerapkan opsi bidang standar ke sebagian besar panel ruang kerja Grafana bawaan. Beberapa panel lama dan panel komunitas yang belum diperbarui ke panel baru dan model data akan kehilangan semua atau beberapa opsi bidang ini. 

 Sebagian besar opsi bidang tidak akan memengaruhi visualisasi sampai Anda memilih di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter. 

 Untuk informasi selengkapnya tentang menerapkan opsi ini, lihat bagian berikut: 
+  [Konfigurasikan semua bidang](#configure-all-fields) 
+  [Konfigurasikan bidang tertentu](#configure-specific-fields) 

#### Desimal
<a name="decimals"></a>

 Opsi ini menetapkan jumlah desimal untuk disertakan saat merender nilai. Biarkan Grafana Terkelola Amazon kosong untuk menggunakan jumlah desimal yang disediakan oleh sumber data. 

 Untuk mengubah pengaturan ini, masukkan nomor di bidang. 

#### Tautan data
<a name="data-links-overview"></a>

 Opsi ini mengontrol URL yang ditautkan nilai atau visualisasi. Untuk informasi dan petunjuk selengkapnya, silakan lihat [Tautan data](data-links.md). 

#### Nama tampilan
<a name="display-name"></a>

 Opsi ini menetapkan judul tampilan semua bidang. Anda dapat menggunakan variabel dalam judul bidang. Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template dan variabel](templates-and-variables.md). 

 Ketika beberapa statistik, bidang, atau seri ditampilkan, bidang ini mengontrol judul di setiap stat. Anda dapat menggunakan ekspresi seperti `${__field.name}` hanya menggunakan nama seri atau nama bidang dalam judul. 

 Diberikan bidang dengan nama Temp, dan label \$1"loc"="PBI”, “Sensor"="3"\$1 


|  Sintaksis ekspresi  |  Contoh  |  Render ke  |  Penjelasan  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  Sama seperti sintaks  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  Menampilkan nama bidang dan label \$1\$1 jika ada. Jika hanya ada satu kunci label dalam respons, maka untuk bagian label, Amazon Managed Grafana menampilkan nilai label tanpa tanda kurung kurung yang terlampir.  | 
|  \$1\$1\$1\$1field.name\$1  |  Sama seperti sintaks  |  Temp  |  Menampilkan nama bidang (tanpa label).  | 
|  \$1\$1\$1\$1field.labels\$1  |  Sama seperti sintaks  |  Loc="PBI", Sensor="3"  |  Menampilkan label tanpa nama.  | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  Menampilkan nilai kunci label yang ditentukan.  | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  Sama seperti Sintaks  |  PBI, 3  |  Menampilkan nilai-nilai label yang dipisahkan oleh koma (tanpa kunci label).  | 

 Jika nilainya adalah string kosong setelah merender ekspresi untuk bidang tertentu, metode tampilan default digunakan. 

#### Maks
<a name="max"></a>

 Opsi ini menetapkan nilai maksimum yang digunakan dalam perhitungan ambang persentase. Untuk perhitungan otomatis berdasarkan semua seri dan bidang, biarkan pengaturan ini kosong. 

#### Min
<a name="min"></a>

 Opsi ini menetapkan nilai minimum yang digunakan dalam perhitungan ambang persentase. Untuk perhitungan otomatis berdasarkan semua seri dan bidang, biarkan pengaturan ini kosong. 

#### Tidak ada nilai
<a name="no-value"></a>

 Masukkan apa yang harus ditampilkan Grafana Terkelola Amazon jika nilai bidang kosong atau null. 

#### Unit
<a name="unit"></a>

 Opsi ini menentukan unit yang harus digunakan bidang. Pilih bidang **Unit**, lalu telusuri sampai Anda menemukan unit yang Anda inginkan. Unit yang Anda pilih diterapkan ke semua bidang kecuali waktu. 

##### Unit kustom
<a name="custom-units"></a>

 Anda juga dapat menggunakan daftar dropdown unit untuk menentukan unit kustom, awalan kustom atau akhiran, dan format. date/time 

 Untuk memilih unit khusus, masukkan unit dan pilih `Custom: xxx` opsi terakhir di daftar dropdown. 
+  `suffix:<suffix>`untuk unit khusus yang harus mengejar nilai. 
+  `time:<format>`untuk date/time format khusus; misalnya,`time:YYYY-MM-DD`. Untuk sintaks format dan opsi, lihat [Tampilan](https://momentjs.com/docs/#/displaying/). 
+  `si:<base scale><unit characters>`untuk unit SI kustom; misalnya,`si: mF`. Opsi ini sedikit lebih maju karena Anda dapat menentukan unit dan skala data sumber. Misalnya, jika data sumber Anda direpresentasikan sebagai milli (ribuan) unit, awali unit dengan karakter skala SI tersebut. 
+  `count:<unit>`untuk unit hitungan khusus. 
+  `currency:<unit>`untuk kustom unit mata uang. 

 Anda juga dapat menempelkan emoji asli di pemilih unit dan memilihnya sebagai unit khusus. 

##### Satuan string
<a name="string-units"></a>

 Grafana yang Dikelola Amazon terkadang dapat mengurai string dan menunjukkannya sebagai angka. Untuk membuat Grafana Terkelola Amazon menampilkan string asli, buat penggantian bidang dan tambahkan properti unit dengan unit. `string` 

#### Skema warna
<a name="color-scheme"></a>

 Opsi warna bidang menentukan cara Amazon Managed Grafana mewarnai seri atau bidang. Ada beberapa mode di sini yang bekerja secara berbeda, dan utilitasnya sangat bergantung pada visualisasi yang dipilih saat ini. 

 Mode warna kontinu menggunakan persentase nilai relatif terhadap min dan maks untuk menginterpolasi warna. 
+  **Warna tunggal** - Warna tertentu diatur dengan menggunakan pemilih warna. Ini paling berguna dari aturan penggantian. 
+  **Dari ambang batas** — Warna berasal dari ambang yang cocok. Ini berguna untuk pengukur, stat, dan visualisasi tabel. 

##### Warna dengan seri
<a name="color-by-series"></a>

 Grafana yang Dikelola Amazon mencakup skema warna yang menentukan warna berdasarkan seri. Ini berguna untuk grafik dan diagram lingkaran, misalnya. 

##### Warnai berdasarkan nilai
<a name="color-by-value"></a>

 Grafana yang Dikelola Amazon juga menyertakan skema warna kontinu (gradien). Ini berguna untuk visualisasi yang mewarnai nilai individu; misalnya, panel stat dan panel tabel. 

#### Ambang batas
<a name="thresholds-overview"></a>

 Anda dapat menggunakan ambang batas untuk mengubah warna bidang berdasarkan nilainya. Untuk informasi dan petunjuk selengkapnya, silakan lihat [Ambang batas](thresholds.md). 

#### Pemetaan nilai
<a name="value-mapping"></a>

 Anda dapat menggunakan opsi ini untuk menetapkan aturan yang menerjemahkan nilai bidang atau rentang nilai ke dalam teks eksplisit. Anda dapat menambahkan lebih dari satu pemetaan nilai. 
+  **Jenis pemetaan** - Pilih opsi. 
  +  **Nilai** — Masukkan nilai. Jika nilai bidang lebih besar dari atau sama dengan nilai, **Teks** ditampilkan. 
  +  **Dari** dan **Ke** - Masukkan rentang. Jika nilai bidang berada di antara atau sama dengan nilai dalam rentang, **Teks** ditampilkan. 
+  **Teks** — Teks yang ditampilkan jika kondisi terpenuhi dalam bidang. Bidang ini menerima variabel. 

# Editor panel
<a name="AMG-panel-editor"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Topik ini menjelaskan bagian-bagian dari editor panel Grafana Terkelola Amazon, dan itu mencakup tautan ke tempat Anda dapat menemukan informasi lebih lanjut. 

## Membuka editor panel
<a name="open-the-panel-editor"></a>

 Ada beberapa cara untuk mengakses editor panel, juga disebut layar **Edit Panel**, *mode edit*, atau *mode edit panel*. 
+  Pilih ikon **Add panel** di bagian atas layar, lalu pilih **Add new panel**. Panel baru terbuka di editor panel. Untuk informasi selengkapnya tentang cara menambahkan panel, lihat[Menambahkan panel](add-a-panel-to-a-dashboard.md). 
+  Pilih judul panel yang ada, lalu pilih **Edit**. Panel terbuka dalam mode edit. 
+  Pilih di mana saja pada panel yang ada, lalu tekan **e** pada keyboard Anda. Panel terbuka dalam mode edit. 

## Mengubah ukuran bagian editor panel
<a name="resize-panel-editor-sections"></a>

 Seret untuk mengubah ukuran bagian editor panel. Jika panel samping menjadi terlalu sempit, tab **Panel**, **Field**, dan **Overrides** berubah menjadi daftar dropdown. 

## Bagian dari editor panel
<a name="parts-of-the-panel-editor"></a>

 Bagian ini menjelaskan bagian-bagian layar editor panel, dengan informasi tentang bidang, opsi, atau tugas yang terkait dengan setiap bagian. 

### Header
<a name="header"></a>

 Bagian header mencantumkan nama dasbor tempat panel berada dan beberapa perintah dasbor. Anda juga dapat memilih panah **Kembali** untuk kembali ke dasbor. 

 Di sisi kanan header adalah opsi berikut: 
+  **Ikon pengaturan dasbor (roda gigi)** - Pilih untuk mengakses pengaturan dasbor. 
+  **Buang** Pilih untuk membuang semua perubahan yang telah Anda buat pada panel sejak Anda terakhir menyimpan dasbor. 
+  **Simpan** — Pilih untuk menyimpan dasbor, termasuk semua perubahan yang telah Anda buat di editor panel. 
+  **Terapkan** - Pilih untuk menerapkan perubahan yang Anda buat dan kemudian tutup panel editor, kembali ke dasbor. Simpan juga dasbor untuk mempertahankan perubahan yang diterapkan. 

### Pratinjau visualisasi
<a name="visualization-preview"></a>

 Bagian pratinjau visualisasi berisi opsi tampilan, kontrol rentang waktu, pratinjau visualisasi, dan (jika ada) judul panel, sumbu, dan legenda. 
+  **Isi** - Pratinjau visualisasi mengisi ruang yang tersedia di bagian pratinjau. Jika Anda mengubah lebar panel samping atau tinggi panel bawah, visualisasi menyesuaikan untuk mengisi ruang apa pun yang tersedia. 
+  **Fit** - Pratinjau visualisasi mengisi ruang yang tersedia, tetapi mempertahankan rasio aspek panel. 
+  **Tepat** - Pratinjau visualisasi memiliki ukuran yang tepat seperti ukuran di dasbor. Jika tidak cukup ruang yang tersedia, visualisasi akan menurunkan skala, menjaga rasio aspek. 
+  **Kontrol rentang waktu** — Untuk informasi selengkapnya, lihat[Kontrol rentang waktu](dashboard-time-range-controls.md).

### Bagian data (panel terendah)
<a name="data-section-bottom-pane"></a>

 Bagian data berisi tab tempat Anda memasukkan kueri, mengubah data, dan membuat aturan peringatan (jika berlaku). 
+  **Tab kueri** — Pilih sumber data Anda dan masukkan kueri di sini. Untuk informasi selengkapnya, lihat [Kueri](panel-queries.md). 
+  **Tab Transform** - Terapkan transformasi data. Untuk informasi selengkapnya, lihat [Transformasi](panel-transformations.md). 
+  **Tab peringatan** - Tulis aturan peringatan. Untuk informasi selengkapnya, lihat [Grafana memperingatkan](alerts-overview.md). 

### Opsi panel dan bidang (panel samping)
<a name="panel-and-field-options-side-pane"></a>

 Bagian ini berisi tab tempat Anda mengontrol hampir setiap aspek bagaimana data Anda divisualisasikan. Tidak semua tab tersedia untuk setiap visualisasi. 

 Fitur pada tab ini didokumentasikan dalam topik berikut: 
+  [Menambahkan panel](add-a-panel-to-a-dashboard.md) 
+  [Visualisasi](AMG-visualizations.md) 
+  [Opsi bidang dan penggantian](field-options-overrides.md) 
+  [Tautan panel](panel-links.md)dan[Tautan data](data-links.md), yang membantu Anda menghubungkan visualisasi Anda ke sumber daya lain 

# Panel perpustakaan
<a name="AMG-library-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Panel pustaka memungkinkan pengguna membuat panel yang dapat digunakan kembali di mana setiap perubahan yang dilakukan pada satu contoh panel perpustakaan tercermin di setiap dasbor yang memengaruhi semua contoh lain di mana panel digunakan. Panel ini dapat disimpan dalam folder bersama Dasbor dan merampingkan penggunaan kembali panel di beberapa dasbor. 

## Buat panel perpustakaan
<a name="library-panel-create"></a>

**catatan**  
Saat Anda membuat panel pustaka, panel di dasbor sumber juga dikonversi ke panel perpustakaan. Anda harus menyimpan dasbor asli setelah panel dikonversi.

**Untuk membuat panel perpustakaan**

1. Buat panel seperti biasanya. Anda juga dapat menggunakan panel yang ada.

1. Pilih judul panel dan pilih **Edit**.

1. Di panel samping opsi tampilan panel, pilih opsi panah bawah untuk membawa perubahan pada visualisasi.

1. Pilih **panel Library**, dan pilih **Create new library panel**. 

1. Masukkan nama untuk panel perpustakaan, dan pilih folder untuk menyimpannya.

1. Pilih **Buat panel perpustakaan** dan kemudian simpan dasbor.

Anda juga dapat membuat panel perpustakaan dengan menggunakan opsi **Bagikan** untuk panel apa pun.

Setelah dibuat, Anda dapat memodifikasi panel perpustakaan menggunakan dasbor apa pun yang muncul. Setelah perubahan panel perpustakaan disimpan, semua contoh panel perpustakaan akan mencerminkan modifikasi ini.

## Menambahkan panel perpustakaan
<a name="library-panel-add"></a>

**Untuk menambahkan panel pustaka ke dasbor**

1. Jeda pada opsi \$1 di menu kiri, lalu pilih **Buat**.

1. Pilih **Tambahkan panel dari pustaka panel**.

1. Filter daftar panel perpustakaan untuk menemukan panel yang Anda inginkan.

1. Pilih panel itu dan tambahkan ke dasbor. 

## Putuskan tautan panel pustaka
<a name="library-panel-unlink"></a>

Jika Anda memiliki panel pustaka di dasbor yang ingin Anda modifikasi tanpa memengaruhi semua contoh panel pustaka lainnya, Anda dapat memutuskan tautan panel pustaka.

**Untuk memutuskan tautan panel pustaka dari dasbor**

1. Jeda di **Dasbor** di menu sebelah kiri, lalu pilih **Panel Perpustakaan**.

1. Pilih panel perpustakaan. Anda akan melihat daftar semua dasbor tempat panel perpustakaan digunakan.

1. Pilih panel yang ingin Anda putuskan tautan dan perbarui.

1. Pilih judul panel dan pilih **Edit**. 

1. Pilih **Putuskan Tautan**. 

## Menghapus panel pustaka
<a name="library-panel-delete"></a>

Sebelum Anda menghapus panel pustaka, verifikasi bahwa panel tersebut tidak lagi digunakan di dasbor apa pun.

**Untuk menghapus panel pustaka**

1. Jeda di **Dasbor** di menu sebelah kiri, lalu pilih **Panel Perpustakaan**.

1. Pilih panel perpustakaan. Anda akan melihat daftar semua dasbor tempat panel perpustakaan digunakan.

1. Pilih panel yang ingin Anda hapus.

1. Pilih ikon hapus di sebelah nama panel. 

## Bagian dari editor panel
<a name="parts-of-the-panel-editor"></a>

 Bagian ini menjelaskan bagian-bagian layar editor panel, dengan informasi tentang bidang, opsi, atau tugas yang terkait dengan setiap bagian. 

### Header
<a name="header"></a>

 Bagian header mencantumkan nama dasbor tempat panel berada dan beberapa perintah dasbor. Anda juga dapat memilih panah **Kembali** untuk kembali ke dasbor. 

 Di sisi kanan header adalah opsi berikut: 
+  **Ikon pengaturan dasbor (roda gigi)** - Pilih untuk mengakses pengaturan dasbor. 
+  **Buang** Pilih untuk membuang semua perubahan yang telah Anda buat pada panel sejak Anda terakhir menyimpan dasbor. 
+  **Simpan** - Pilih untuk menyimpan dasbor termasuk semua perubahan yang telah Anda buat di editor panel. 
+  **Terapkan** - Pilih untuk menerapkan perubahan yang Anda buat dan kemudian tutup panel editor, kembali ke dasbor. Simpan juga dasbor untuk mempertahankan perubahan yang diterapkan. 

### Pratinjau visualisasi
<a name="visualization-preview"></a>

 Bagian pratinjau visualisasi berisi opsi tampilan, kontrol rentang waktu, pratinjau visualisasi, dan (jika ada) judul panel, sumbu, dan legenda. 
+  **Isi** - Pratinjau visualisasi mengisi ruang yang tersedia di bagian pratinjau. Jika Anda mengubah lebar panel samping atau tinggi panel bawah, visualisasi menyesuaikan untuk mengisi ruang apa pun yang tersedia. 
+  **Fit** - Pratinjau visualisasi mengisi ruang yang tersedia, tetapi mempertahankan rasio aspek panel. 
+  **Tepat** - Pratinjau visualisasi memiliki ukuran yang tepat seperti ukuran di dasbor. Jika tidak cukup ruang yang tersedia, visualisasi akan menurunkan skala, menjaga rasio aspek. 
+  **Kontrol rentang waktu** — Untuk informasi selengkapnya, lihat[Kontrol rentang waktu](dashboard-time-range-controls.md).

### Bagian data (panel terendah)
<a name="data-section-bottom-pane"></a>

 Bagian data berisi tab tempat Anda memasukkan kueri, mengubah data, dan membuat aturan peringatan (jika berlaku). 
+  **Tab kueri** — Pilih sumber data Anda dan masukkan kueri di sini. Untuk informasi selengkapnya, lihat [Kueri](panel-queries.md). 
+  **Tab Transform** - Terapkan transformasi data. Untuk informasi selengkapnya, lihat [Transformasi](panel-transformations.md). 
+  **Tab peringatan** - Tulis aturan peringatan. Untuk informasi selengkapnya, lihat [Grafana memperingatkan](alerts-overview.md). 

### Opsi panel dan bidang (panel samping)
<a name="panel-and-field-options-side-pane"></a>

 Bagian ini berisi tab tempat Anda mengontrol hampir setiap aspek bagaimana data Anda divisualisasikan. Tidak semua tab tersedia untuk setiap visualisasi. 

 Fitur pada tab ini didokumentasikan dalam topik berikut: 
+  [Menambahkan panel](add-a-panel-to-a-dashboard.md) 
+  [Visualisasi](AMG-visualizations.md) 
+  [Opsi bidang dan penggantian](field-options-overrides.md) 
+  [Tautan panel](panel-links.md)dan[Tautan data](data-links.md), yang membantu Anda menghubungkan visualisasi Anda ke sumber daya lain 

# Visualisasi
<a name="AMG-visualizations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Grafana yang Dikelola Amazon menawarkan berbagai visualisasi yang sesuai dengan kasus penggunaan yang berbeda. Bagian berikut mencantumkan visualisasi yang tersedia di Grafana Terkelola Amazon dan pengaturan tampilannya.

**Topics**
+ [Panel daftar peringatan](alert-list-panel.md)
+ [Panel bagan batang](bar-chart-panel.md)
+ [Panel pengukur batang](alert-panel-bar-gauge-panel.md)
+ [Panel jam](clock-panel.md)
+ [Panel daftar dasbor](dashboard-list-panel.md)
+ [Panel pengukur](gauge-panel.md)
+ [Panel geomap](AMG-Geomap.md)
+ [Panel grafik](graph-panel.md)
+ [Peta panas](visualization-heatmap.md)
+ [Panel histogram](histogram-panel.md)
+ [Panel log](logs-panel.md)
+ [Panel berita](news-panel.md)
+ [Panel grafik simpul (Beta)](node-graph-panel.md)
+ [Panel bagan pai](pie-chart-panel.md)
+ [Panel yang cepat](plotly-panel.md)
+ [Panel Sankey](sankey-panel.md)
+ [Panel pencar](scatter-panel.md)
+ [Panel stat](stat-panel.md)
+ [Panel garis waktu negara](state-timeline-panel.md)
+ [Panel riwayat status](status-history-panel.md)
+ [Panel meja](table-panel.md)
+ [Panel teks](text-panel.md)
+ [Panel deret waktu](time-series-panel.md)
+ [Ambang batas](thresholds.md)
+ [WindRose](windrose.md)
+ [Periksa panel](inspect-a-panel.md)
+ [Daftar perhitungan](list-of-calculations.md)

# Panel daftar peringatan
<a name="alert-list-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel daftar peringatan menampilkan peringatan dasbor Anda. Anda dapat mengonfigurasi daftar untuk menampilkan status saat ini atau perubahan status terbaru. Untuk informasi selengkapnya tentang peringatan, lihat[Grafana memperingatkan](alerts-overview.md).

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Opsi
<a name="alert-list-panel-options"></a>
+  **Tampilkan** - Pilih apakah panel harus menampilkan status peringatan saat ini atau perubahan status peringatan terbaru.
+  **Item Maks** - Atur jumlah maksimum peringatan ke daftar.
+  **Urutkan urutan** - Pilih cara memesan peringatan yang ditampilkan.
  +  **Abjad (asc)** - Urutan abjad
  +  **Abjad (desc)** - Urutan abjad terbalik
  +  **Pentingnya** — Dengan kepentingan menurut nilai-nilai berikut, dengan 1 menjadi yang tertinggi:
    + peringatan: 1
    + tidak-data: 2
    + tertunda: 3
    + ok: 4
    + dijeda: 5
+  **Peringatan dari dasbor ini** - Tampilkan peringatan hanya dari dasbor tempat daftar peringatan berada.

## Filter
<a name="alerts-panel-filter"></a>

Gunakan opsi berikut untuk memfilter peringatan agar sesuai dengan kueri, folder, atau tag yang Anda pilih:
+  **Nama peringatan** - Masukkan kueri nama peringatan. 
+  **Judul dasbor** - Masukkan kueri judul dasbor.
+  **Folder** — Pilih folder. Hanya peringatan dari dasbor di folder yang dipilih yang akan ditampilkan.
+  **Tag dasbor -** Pilih satu atau beberapa tag. Hanya peringatan dari dasbor dengan satu atau lebih tag yang akan ditampilkan. 

## Filter negara
<a name="alert-panel-state-filter"></a>

Pilih status peringatan mana yang akan ditampilkan di panel ini.
+ Oke
+ Dijeda
+ Tidak ada data
+ Kesalahan eksekusi
+ Peringatan
+ Tertunda

# Panel bagan batang
<a name="bar-chart-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi panel ini memungkinkan Anda untuk membuat grafik data kategoris.

## Format data yang didukung
<a name="bar-chart-formats"></a>

Hanya satu frame data yang didukung dan perlu memiliki setidaknya satu bidang string yang akan digunakan sebagai kategori untuk sumbu X atau Y dan satu atau lebih bidang numerik. Berikut ini adalah contoh format data:


|  Peramban  |  Pangsa pasar  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Penjelajah Internet  |  17.5  | 

Jika Anda memiliki lebih dari satu bidang numerik, panel menampilkan bilah yang dikelompokkan.

### Memvisualisasikan deret waktu atau beberapa set hasil
<a name="bar-chart-visualization"></a>

Jika Anda memiliki beberapa deret waktu atau tabel, pertama-tama Anda harus bergabung dengan mereka menggunakan gabungan, atau mengurangi transformasi. Misalnya, jika Anda memiliki beberapa deret waktu dan Anda ingin membandingkan nilai terakhir dan maksnya, tambahkan Kurangi transformasi dan tentukan Maks dan Terakhir sebagai opsi di bawah Perhitungan.

## Opsi bagan batang
<a name="bar-chart-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Orientasi**
+  **Otomatis** — Grafana memutuskan orientasi batang berdasarkan dimensi panel.
+  **Horizontal** - Menjadikan sumbu X sebagai sumbu kategori.
+  **Vertikal — Menjadikan** sumbu Y sebagai sumbu kategori.

**Tampilkan nilai**

Mengontrol apakah nilai ditampilkan di atas atau di sebelah kiri bar.
+  **Auto** - Nilai ditampilkan jika ada spasi.
+  **Selalu** — Selalu tunjukkan nilai.
+  **Jangan pernah** - Jangan pernah menunjukkan nilai.

**Lebar grup** mengontrol lebar grup. 0 = min dan 1 = lebar maks.

**Lebar bar** mengontrol lebar bar. 0 = min dan 1 = lebar maks.

**Lebar garis** mengontrol lebar garis bar.

**Fill opacity** mengontrol opasitas isian bilah.

**Mode gradien** mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan Fill opacity.
+  **Tidak ada** - tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip** — Saat Anda mengarahkan kursor ke visualisasi, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku.
+  **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda arahkan pada visualisasi.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** — Jangan tampilkan tooltip saat Anda berinteraksi dengan visualisasi.

**catatan**  
Gunakan override untuk menyembunyikan seri individual dari tooltip.

**Mode legenda** — Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** — Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Perhitungan legenda** — Pilih perhitungan standar mana yang akan ditampilkan dalam legenda. Anda dapat memiliki lebih dari satu.

**Ukuran teks** - Masukkan nilai untuk mengubah ukuran teks pada bagan batang Anda.

**Axis** - Gunakan pengaturan bidang berikut untuk menyempurnakan tampilan sumbu Anda. Beberapa opsi bidang tidak akan memengaruhi visualisasi sampai Anda mengklik di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter.
+  **Penempatan** - Mengatur penempatan sumbu Y.
+  **Otomatis** - Grafana secara otomatis menetapkan sumbu Y ke seri. Ketika ada dua atau lebih seri dengan unit yang berbeda, maka Grafana menetapkan sumbu kiri ke unit pertama dan kanan ke unit berikut.
+  **Kiri** - Tampilkan semua sumbu Y di sisi kiri.
+  **Kanan** - Tampilkan semua sumbu Y di sisi kanan.
+  **Tersembunyi** — Sembunyikan semua sumbu Y.
+  **Label** - Tetapkan label teks sumbu Y. Jika Anda memiliki lebih dari satu sumbu Y, maka Anda dapat menetapkan label yang berbeda dengan override.
+  **Lebar** - Atur lebar sumbu yang tetap. Secara default, Grafana secara dinamis menghitung lebar sumbu.

  Dengan mengatur lebar sumbu, data dengan jenis sumbu yang berbeda dapat berbagi proporsi tampilan yang sama. Ini membuatnya lebih mudah untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau diregangkan dalam kedekatan visual satu sama lain.
+  **Soft min dan soft max** - Tetapkan opsi soft min dan soft max untuk kontrol batas sumbu Y yang lebih baik. Secara default, Grafana menetapkan rentang untuk sumbu Y secara otomatis berdasarkan kumpulan data.

  Pengaturan soft min dan soft max dapat mencegah blip berubah menjadi pegunungan ketika data sebagian besar datar, dan min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik yang ditentukan.

  Anda dapat mengatur min/max opsi standar untuk menentukan batas keras sumbu Y.

# Panel pengukur batang
<a name="alert-panel-bar-gauge-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Pengukur batang menyederhanakan data Anda dengan mengurangi setiap bidang menjadi satu nilai. Anda memilih bagaimana Amazon Managed Grafana menghitung pengurangan.

Panel ini dapat menampilkan satu atau beberapa pengukur batang tergantung pada berapa banyak seri, baris, atau kolom yang dikembalikan kueri Anda.

## Opsi data dan bidang
<a name="bar-gauge-data-and-field-options"></a>

Dengan visualisasi pengukur Bar, Anda dapat menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md) 
+  [Opsi bidang dan penggantian](field-options-overrides.md) 
+  [Ambang batas](thresholds.md) 

## Opsi tampilan
<a name="bar-gauge-display-options"></a>

Gunakan opsi berikut untuk menyempurnakan visualisasi Anda:
+  **Tampilkan** — Pilih cara Grafana Terkelola Amazon menampilkan data Anda.
  +  **Hitung** - Tampilkan nilai yang dihitung berdasarkan semua baris. Untuk daftar perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md).
  +  **Semua nilai** - Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, Anda juga dapat memilih **Batas**, atau jumlah baris maksimum yang akan ditampilkan.
+  **Nilai** — Pilih fungsi peredam yang akan digunakan Amazon Managed Grafana untuk mengurangi banyak bidang menjadi satu nilai. Pilih daftar **Nilai** untuk melihat fungsi dan deskripsi singkat. 
+  **Orientasi** — Pilih arah susun.
  +  **Otomatis** — Grafana yang Dikelola Amazon memilih orientasi apa yang menurutnya paling cocok.
  +  **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
  +  **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.
+  **Mode tampilan** - Pilih mode tampilan.
  +  **Gradien** — Pilih tingkat ambang batas untuk menentukan gradien.
  +  **Retro LCD** — Menampilkan pengukur yang terbagi menjadi sel-sel kecil yang menyala atau tidak menyala.
  +  **Dasar** - Gunakan satu warna berdasarkan ambang yang cocok.
+  **Tampilkan area yang tidak terisi** - Pilih opsi ini jika Anda ingin membuat wilayah bar yang tidak terisi sebagai abu-abu gelap. Opsi ini tidak tersedia untuk mode tampilan LCD Retro.

# Panel jam
<a name="clock-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel jam menunjukkan waktu saat ini atau hitungan mundur. Ini memperbarui setiap detik.
+ **Mode** — Defaultnya adalah **waktu**. Jika Anda memilih **hitung mundur**, atur Batas **Waktu Hitung Mundur untuk memulai hitungan mundur**.
+ **12 atau 24 jam** - Pilihan untuk menampilkan waktu adalah format 12 jam dan format 24 jam.
+ **Zona waktu** — Zona waktu disediakan oleh perpustakaan zona waktu momen. Defaultnya adalah zona waktu di komputer Anda.
+ **Batas Waktu Hitung Mundur** **- Tentukan waktu dan tanggal untuk menghitung mundur, jika Anda telah mengatur **Mode** ke hitungan mundur.**
+ **Teks Akhir Hitung Mundur** - Tentukan teks yang akan ditampilkan saat hitungan mundur berakhir.
+ **Opsi pemformatan Tanggal/Waktu** - Sesuaikan ukuran font, berat, dan pemformatan. date/time Jika Anda menunjukkan hitungan mundur dan tidak ingin melihat detik berdetak turun, ubah format waktu menjadi `hh:mm` jam 24 jam atau jam 12 `h:mm A` jam. Untuk daftar lengkap opsi, lihat [Tampilan](https://momentjs.com/docs/#/displaying/).
+ **Bg Color** - Pilih warna latar belakang untuk jam.

# Panel daftar dasbor
<a name="dashboard-list-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel daftar dasbor menampilkan tautan dinamis ke dasbor lain. Daftar ini dapat dikonfigurasi untuk menggunakan dasbor berbintang, dasbor yang baru dilihat, kueri penelusuran, dan tag dasbor.

Pada setiap pemuatan dasbor, panel ini menanyakan daftar dasbor, selalu memberikan up-to-date hasil terbanyak.

## Opsi
<a name="options-1"></a>

Gunakan opsi berikut untuk menyempurnakan visualisasi Anda:
+  **Dibintangi** - Tampilkan dasbor berbintang dalam urutan abjad.
+  **Baru-baru ini dilihat** - Tampilkan dasbor yang baru dilihat dalam urutan abjad.
+  **Cari** - Tampilkan dasbor berdasarkan permintaan pencarian atau tag. Opsi ini mengharuskan Anda untuk memasukkan setidaknya satu nilai dalam **Kueri** atau **Tag**.
+  **Tampilkan judul** - Tampilkan pilihan daftar yang dipilih (Dibintangi, Baru dilihat, Cari) sebagai judul.
+  **Maks item** - Mengatur jumlah maksimum item untuk daftar per bagian. Misalnya, pada nilai default 10, jika memilih untuk menampilkan dasbor berbintang dan yang baru dilihat, panel menampilkan hingga 20 dasbor total, 10 di setiap bagian.

### Pencarian
<a name="panel-dashboard-list-search"></a>

Opsi berikut hanya berlaku jika opsi **Pencarian** dipilih.
+  **Query** — Masukkan kueri yang ingin Anda cari. Kueri tidak peka huruf besar/kecil, dan sebagian nilai diterima.
+  **Folder** — Pilih folder dasbor yang ingin Anda tampilkan.
+  **Tag** — Masukkan tag yang ingin Anda cari. *Perhatikan bahwa tag yang ada tidak akan muncul saat Anda mengetik, dan tag peka huruf besar/kecil.*

**catatan**  
Ketika beberapa tag dan string muncul, daftar dasbor menampilkan yang cocok dengan *semua* kondisi.

# Panel pengukur
<a name="gauge-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 **Gauge** adalah panel nilai tunggal yang dapat mengulang pengukur untuk setiap seri, kolom, atau baris.

## Opsi data dan bidang
<a name="gauge-panel-data-and-field-options"></a>

Visualisasi pengukur memungkinkan Anda menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md) 
+  [Opsi bidang dan penggantian](field-options-overrides.md) 
+  [Ambang batas](thresholds.md) 

## Opsi tampilan
<a name="gauge-panel-display-options-2"></a>

Untuk menyempurnakan visualisasi Anda, gunakan opsi berikut:
+  **Tampilkan** — Pilih cara Grafana Terkelola Amazon menampilkan data Anda.
  +  **Hitung** - Tampilkan **Nilai** yang dihitung berdasarkan semua baris. Untuk daftar perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md).
  +  **Semua nilai** - Tampilkan stat terpisah untuk setiap baris. Jika Anda memilih opsi ini, Anda juga dapat memilih **Batas**, atau jumlah baris maksimum yang akan ditampilkan.
+  **Orientasi** — Pilih arah susun.
  +  **Otomatis** — Grafana yang Dikelola Amazon memilih apa yang dianggapnya sebagai orientasi terbaik.
  +  **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
  +  **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.
+  **Tampilkan label ambang batas** - Pilih apakah akan menampilkan nilai ambang batas.
+  **Tampilkan penanda ambang batas** - Pilih apakah akan menampilkan pita ambang batas di luar pita nilai pengukur bagian dalam.

# Panel geomap
<a name="AMG-Geomap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi panel **Geomap** memungkinkan Anda untuk melihat dan menyesuaikan peta dunia menggunakan data geospasial. Untuk dengan mudah fokus pada karakteristik data berbasis lokasi yang penting, Anda dapat mengonfigurasi berbagai gaya overlay dan pengaturan tampilan peta.

## Lapisan data
<a name="Data-Layer"></a>

Lapisan data di plugin Geomap menentukan bagaimana Anda memvisualisasikan data geospasial di atas peta dasar.

### Lokasi
<a name="Location"></a>

Panel **Geomap** membutuhkan sumber data geografis. Data ini berasal dari kueri database, dan ada empat opsi pemetaan untuk data Anda.
+ **Otomatis** secara otomatis mencari data lokasi. Gunakan opsi ini ketika kueri Anda didasarkan pada salah satu nama berikut untuk bidang data.
  + geohash: “geohash”
  + garis lintang: “garis lintang”, “lat”
  + bujur: “bujur”, “lng”, “lon”
  + pencarian: “pencarian”
+  **Coords** menentukan bahwa kueri Anda menyimpan data koordinat. Anda akan diminta untuk memilih bidang data numerik untuk garis lintang dan bujur dari kueri database Anda.
+  **Geohash** menentukan bahwa kueri Anda menyimpan data geohash. Anda akan diminta untuk memilih bidang data string untuk geohash dari kueri database Anda.
+  **Pencarian** menentukan bahwa kueri Anda menyimpan data nama lokasi yang perlu dipetakan ke nilai. Anda akan diminta untuk memilih bidang pencarian dari kueri database Anda dan file. ` gazetteer` ` gazetteer `Ini adalah direktori yang digunakan untuk memetakan data kueri Anda ke titik geografis.

## Lapisan penanda
<a name="Markers-Layer"></a>

Lapisan **Markers** memungkinkan Anda untuk menampilkan titik data sebagai bentuk penanda yang berbeda seperti lingkaran, kotak, segitiga, bintang, dan banyak lagi.
+ **Marker Color** mengkonfigurasi warna penanda. Ukuran Tetap default membuat semua titik menjadi satu warna. Ada opsi alternatif untuk memiliki beberapa warna tergantung pada nilai titik data dan ambang batas yang ditetapkan di bagian **Ambang.**
+  **Ukuran Penanda** mengkonfigurasi ukuran penanda. Defaultnya adalah` Fixed size`, membuat semua ukuran penanda sama terlepas dari titik datanya. Namun, ada juga opsi untuk menskalakan lingkaran ke titik data yang sesuai. ` Min`dan ukuran `Max ` penanda harus diatur sedemikian rupa sehingga lapisan Marker dapat menskalakan dalam rentang ini.
+  **Marker Shape** memberi Anda fleksibilitas untuk memvisualisasikan titik data secara berbeda.
  + Lingkaran
  + Persegi
  + Segitiga
  + Salib
  + X
+  **Fill opacity** mengonfigurasi transparansi setiap penanda.

## Lapisan peta panas
<a name="Heatmap-layer"></a>

Lapisan **Heatmap** mengelompokkan berbagai titik data untuk memvisualisasikan lokasi dengan kepadatan berbeda. **Untuk menambahkan layer heatmap, di bawah **Data Layer**, pilih Heatmap.**



Mirip dengan **Marker**, Anda diminta dengan berbagai opsi untuk menentukan titik data mana yang akan divisualisasikan dan bagaimana caranya.
+ **Nilai bobot** mengonfigurasi intensitas kluster peta panas. Nilai tetap menjaga nilai bobot konstan di semua titik data. Nilai ini harus berada dalam kisaran 0 \$1 1. Mirip dengan **Markers**, ada opsi alternatif di dropdown untuk secara otomatis menskalakan nilai bobot tergantung pada nilai data. 
+  **Radius** mengkonfigurasi ukuran kluster peta panas.
+  **Blur** mengkonfigurasi jumlah blur pada setiap cluster.

# Panel grafik
<a name="graph-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel grafik dapat dirender sebagai garis, jalur titik, atau serangkaian batang. Jenis grafik ini cukup serbaguna untuk menampilkan hampir semua data deret waktu.

## Opsi data dan bidang
<a name="graph-panel-data-and-field-options"></a>

Saat menggunakan visualisasi grafik, Anda dapat menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md) 
+ Peringatan. Ini adalah satu-satunya jenis visualisasi yang memungkinkan Anda mengatur peringatan. Untuk informasi selengkapnya, lihat [Grafana memperingatkan](alerts-overview.md).
+  [Ambang batas](thresholds.md) 

## Opsi tampilan
<a name="graph-panel-display-options"></a>

Untuk menyempurnakan visualisasi Anda, gunakan pengaturan berikut:
+  **Bars** - Menampilkan nilai sebagai diagram batang. 
+  **Garis** - Menampilkan nilai sebagai grafik garis. 
+  **Lebar garis** - Tentukan lebar garis untuk seri. Default-nya adalah 1.
+  **Tangga** — Gambarlah titik-titik yang berdekatan sebagai tangga.
+  **Isi area** - Tentukan jumlah isian warna untuk seri. Defaultnya adalah 1; 0 tidak ada.
+  **Fill gradient** — Tentukan derajat gradien pada area fill. Defaultnya adalah 0, yang tidak ada gradien; 10 adalah gradien curam.
+  **Poin** - Menampilkan poin untuk nilai. 
+  **Radius titik** — Kontrol seberapa besar titiknya.
+  **Ambang batas peringatan** - Menampilkan ambang peringatan dan Wilayah pada panel.

### Penumpukan dan nilai null
<a name="stacking-and-null-value"></a>
+  **Stack** — Setiap seri ditumpuk di atas yang lain.
+  **Persen** — Setiap seri diambil sebagai persentase dari total semua seri. Opsi ini tersedia saat **Stack** dipilih.
+  **Nilai nol** - Tentukan bagaimana nilai null ditampilkan. *Ini adalah pengaturan yang penting.* Lihat catatan di bawah ini.
  +  **terhubung** - Jika ada celah dalam seri, yang berarti satu atau lebih nilai nol, garis akan melewati celah dan terhubung ke nilai non-null berikutnya. 
  +  **null** Jika ada celah dalam seri, yang berarti nilai nol, garis dalam grafik akan rusak dan menunjukkan celah. Ini adalah pengaturan default.
  +  **null as zero** — Jika ada celah dalam seri, yang berarti nilai nol, itu akan ditampilkan sebagai nilai nol di panel grafik.

**penting**  
Jika Anda memantau beban CPU server dan beban mencapai 100 persen, server akan mengunci, dan agen yang mengirim statistik tidak akan dapat mengumpulkan statistik beban. Hal ini menyebabkan celah dalam metrik, dan menggunakan pengaturan *nol* default berarti Grafana yang Dikelola Amazon akan menunjukkan celah dan menunjukkan bahwa ada sesuatu yang salah. Jika ini diatur ke *terhubung*, akan mudah untuk melewatkan sinyal ini. 

### Tooltip arahkan
<a name="graph-panel-hover-tooltip"></a>

Gunakan pengaturan ini untuk mengubah tampilan tooltip yang muncul saat Anda menjeda visualisasi grafik.
+  **Mode** - Menentukan berapa banyak seri yang ditampilkan tooltip hover.
  +  **Semua seri** - Tooltip hover menunjukkan semua seri dalam grafik. Dalam daftar seri di tooltip, ruang kerja Grafana menyoroti seri yang Anda jeda dengan huruf tebal.
  +  **Single** - Tooltip hover hanya menampilkan satu seri, yang Anda jeda dalam grafik.
+  **Urutkan urutan** - Mengurutkan urutan seri di tooltip hover jika Anda telah memilih **Semua mode seri**. Saat Anda menjeda pada grafik, Grafana Terkelola Amazon menampilkan nilai yang terkait dengan garis. Umumnya, pengguna paling tertarik pada nilai tertinggi atau terendah. Menyortir nilai-nilai ini dapat membuatnya lebih mudah untuk menemukan data yang Anda inginkan.
  +  **Tidak ada** - Urutan seri di tooltip ditentukan oleh urutan pengurutan dalam kueri Anda. Misalnya, Anda dapat mengurutkan seri menurut abjad berdasarkan nama seri.
  +  **Peningkatan** - Seri di tooltip hover diurutkan berdasarkan nilai dan urutan yang meningkat, dengan nilai terendah di bagian atas daftar.
  +  **Penurunan** - Seri di tooltip hover diurutkan berdasarkan nilai dan dalam urutan menurun, dengan nilai tertinggi di bagian atas daftar.

## Penggantian seri
<a name="graph-panel-series-overrides"></a>

Penggantian seri memungkinkan seri dalam panel grafik dirender secara berbeda dari yang lain. Anda dapat menyesuaikan opsi tampilan per seri atau dengan menggunakan aturan regex. Misalnya, satu seri dapat memiliki lebar garis yang lebih tebal untuk membuatnya menonjol atau dipindahkan ke sumbu Y kanan.

Anda dapat menambahkan beberapa penggantian seri.

**Untuk menambahkan penggantian seri**

1. Pilih **Tambahkan penggantian seri**.

1. Di **Alias atau regex**, ketik atau pilih seri. Pilih bidang untuk melihat daftar seri yang tersedia.

   Misalnya, `/Network.*/` akan cocok dengan dua seri bernama `Network out` dan`Network in`.

1. Pilih **\$1** dan kemudian pilih gaya untuk diterapkan ke seri. Anda dapat menambahkan beberapa gaya ke setiap entri.
+  **Bar** - Tampilkan seri sebagai grafik batang. 
+  **Garis** - Tampilkan seri sebagai grafik garis. 
+  **Isi garis** - Tampilkan grafik garis dengan isian area. 
+  **Isi gradien** - Tentukan jumlah gradien pengisian area.
+  **Lebar garis** - Atur lebar garis.
+  **Mode titik nol** - Gunakan opsi ini untuk mengabaikan nilai nol atau menggantinya dengan nol. Ini penting jika Anda ingin mengabaikan celah dalam data Anda.
+  **Isi di bawah ini untuk** - Isi area antara dua seri.
+  **Garis tangga** — Tampilkan seri sebagai garis tangga.
+  **Tanda hubung** - Tampilkan garis dengan tanda hubung. 
+  **Seri Tersembunyi** - Sembunyikan seri. 
+  **Dash Length** - Atur panjang garis di garis.
+  **Dash Space** - Atur panjang spasi di antara tanda hubung di garis.
+  **Poin** - Tampilkan seri sebagai poin terpisah.
+  **Point Radius** - Atur radius untuk rendering titik.
+  **Stack** - Mengatur kelompok tumpukan untuk seri.
+  **Warna** - Atur warna seri.
+  **Sumbu Y - Atur** sumbu y seri.
+  **Z-index** - Mengatur seri z-index (urutan rendering). Opsi ini penting ketika Anda melapisi gaya yang berbeda, seperti diagram batang dan bagan area.
+  Transform — Ubah nilai menjadi negatif untuk dirender di bawah sumbu y.
+  **Legenda** — Kontrol apakah seri ditampilkan dalam legenda.
+  **Sembunyikan di tooltip** - Kontrol apakah seri ditampilkan dalam tooltip grafik.

## Sumbu
<a name="graph-panel-axes"></a>

Gunakan opsi ini untuk mengontrol tampilan sumbu dalam visualisasi.

### Kiri Y/Right Y
<a name="left-yright-y"></a>

Opsi identik untuk kedua sumbu y.
+  **Tampilkan** - Pilih untuk menampilkan atau menyembunyikan sumbu.
+  **Unit** — Pilih unit tampilan untuk nilai y.
+  **Skala** — Pilih skala yang akan digunakan untuk nilai y: **linier**, atau **logaritmik**. Defaultnya adalah **linier**.
+  **Y-Min** — Nilai y minimum. Defaultnya adalah **auto**.
+  **Y-Max** — Nilai Y maksimum. Defaultnya adalah **auto**.
+  **Desimal** — Tentukan berapa banyak desimal yang ditampilkan untuk nilai y. Defaultnya adalah **auto**. 
+  **Label** - Tentukan label sumbu y. Defaultnya adalah “”,

### Sumbu Y
<a name="y-axes"></a>
+  **Sejajarkan** - Sejajarkan sumbu y kiri dan kanan berdasarkan nilai. Defaultnya tidak dicentang/salah.
+  **Level** - Masukkan nilai yang akan digunakan untuk penyelarasan sumbu y kiri dan kanan, mulai dari Y = 0. Default-nya adalah 0. Opsi ini tersedia saat **Align** dipilih. 

### Sumbu X
<a name="x-axis"></a>
+  **Tampilkan** - Pilih untuk menampilkan atau menyembunyikan sumbu.
+  **Mode** — Mode tampilan benar-benar mengubah visualisasi panel grafik. Ini seperti tiga panel dalam satu. Mode utama adalah mode deret waktu dengan waktu pada sumbu x. Dua mode lainnya adalah mode bagan batang dasar dengan seri pada sumbu x, bukan waktu dan mode histogram.
  +  **Waktu** (default) — Sumbu x mewakili waktu dan data dikelompokkan berdasarkan waktu (misalnya, berdasarkan jam, atau menit).
  +  **Seri** — Data dikelompokkan berdasarkan seri, dan bukan berdasarkan waktu. Sumbu y masih mewakili nilainya.
    +  **Nilai** - Ini adalah jenis agregasi yang akan digunakan untuk nilai. Defaultnya adalah **total** (menjumlahkan nilai bersama-sama).
  +  **Histogram** — Opsi ini mengubah grafik menjadi histogram. Histogram adalah jenis bagan batang yang mengelompokkan angka ke dalam rentang, sering disebut ember atau tempat sampah. Bilah yang lebih tinggi menunjukkan bahwa lebih banyak data jatuh dalam kisaran itu.

    Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)
    +  **Bucket** — Mengatur jumlah bucket untuk mengelompokkan nilai berdasarkan. Jika dibiarkan kosong, Grafana yang Dikelola Amazon mencoba menghitung jumlah ember yang sesuai.
    +  **X-Min** — Menyaring nilai dari histogram yang kurang dari batas minimum ini.
    +  **X-Max** — Memfilter nilai yang lebih besar dari batas maksimum ini.

## Legenda
<a name="graph-panel-legend"></a>

Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.

### Opsi
<a name="graph-panel-legends-options"></a>
+  **Tampilkan** — Bersihkan untuk menyembunyikan legenda. Default dipilih (true).
+  **Sebagai Tabel** - Pilih untuk menampilkan legenda dalam tabel. Default dicentang (true).
+  **Ke kanan** — Pilih untuk menampilkan legenda di sebelah kanan.
+  Lebar - Masukkan lebar minimum untuk legenda dalam piksel. Opsi ini tersedia saat **Ke kanan** dipilih.

### Nilai
<a name="graph-panel-values"></a>

Nilai tambahan dapat ditampilkan di samping nama legenda.
+  **Min** — Nilai minimum yang dikembalikan dari kueri metrik.
+  **Max** — Nilai maksimum yang dikembalikan dari kueri metrik.
+  **Rata-rata** — Nilai rata-rata yang dikembalikan dari kueri metrik.
+  **Current** - Nilai terakhir yang dikembalikan dari kueri metrik.
+  **Total — Jumlah** semua nilai yang dikembalikan dari kueri metrik.
+  **Desimal** - Berapa banyak desimal yang ditampilkan untuk nilai legenda dan tooltips grafik hover.

Grafana Terkelola Amazon menghitung nilai legenda di sisi klien. Nilai legenda ini bergantung pada jenis agregasi atau konsolidasi titik yang digunakan kueri metrik Anda. Semua nilai legenda di atas tidak bisa benar pada saat bersamaan.

Misalnya, jika Anda memplot tingkat permintaan/detik seperti itu, yang mungkin menggunakan rata-rata sebagai agregator, Total dalam legenda tidak akan mewakili jumlah total permintaan. Ini hanya jumlah dari semua titik data yang diterima oleh Grafana yang Dikelola Amazon. 

### Sembunyikan seri
<a name="graph-panel-hide-series"></a>

Sembunyikan seri ketika semua nilai seri dari kueri metrik memiliki nilai tertentu.
+  **Dengan hanya nol - value=null (default** tidak dicentang)
+  **Dengan hanya nol - nilai = nol** (default tidak dicentang)

### Wilayah waktu
<a name="graph-panel-time-regions"></a>

Anda dapat menyorot wilayah waktu tertentu pada grafik untuk membuatnya lebih mudah dilihat, misalnya, akhir pekan, jam kerja, dan jam di luar kerja. Semua wilayah waktu yang dikonfigurasi mengacu pada waktu UTC.

# Peta panas
<a name="visualization-heatmap"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi panel heatmap memungkinkan Anda untuk melihat histogram dari waktu ke waktu. Untuk informasi lebih lanjut tentang histogram, lihat. [Pengantar histogram dan peta panas](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

## Opsi sumbu
<a name="heatmap-axes-options"></a>

Gunakan pengaturan ini untuk menyesuaikan bagaimana sumbu ditampilkan dalam visualisasi Anda.

### Sumbu Y
<a name="heatmap-y-axis"></a>
+  **Unit — Unit** tampilan untuk nilai sumbu y
+  **Skala** — Skala yang digunakan untuk nilai sumbu y
  +  **linier** - Skala linier 
  +  **log (basis 2)** — Skala logaritmik dengan basis 2
  +  **log (basis 10)** — Skala logaritmik dengan basis 10
  +  **log (basis 32)** — Skala logaritmik dengan basis 32
  +  **log (basis 1024)** — Skala logaritmik dengan basis 1024
+  **Y-Min** - Nilai y minimum (default adalah auto)
+  **Y-Max** — Nilai y maksimum (default adalah auto)
+  **Desimal** - Jumlah desimal untuk merender nilai sumbu y dengan (default adalah auto)

### Bucket
<a name="heatmap-buckets"></a>

**catatan**  
Jika format data adalah **Bucket deret waktu**, bagian ini tidak tersedia.
+  **Bucket Sumbu Y** — Jumlah ember yang akan dibagi menjadi sumbu y.
+  **Ukuran** - Ukuran setiap bucket sumbu y (hanya terlihat jika **Skala** *linier*). Opsi ini memiliki prioritas di atas **Bucket Sumbu Y**.
+  **Split Factor** - (Hanya terlihat jika **Skala** adalah *log (basis 2)* atau lebih besar). Secara default, Grafana Terkelola Amazon membagi nilai y berdasarkan basis log. Dengan opsi ini, Anda dapat membagi setiap bucket default menjadi jumlah bucket yang ditentukan.
+  **Bucket Sumbu X** — Jumlah ember yang akan dibagi menjadi sumbu x.
+  **Ukuran** — Ukuran setiap ember sumbu x. Jumlah atau interval waktu (10s, 5m, 1h, dll). Interval yang didukung: ms, s, m, h, d, w, M, y. Opsi ini memiliki prioritas di atas **Bucket Sumbu X**.

#### Ember terikat
<a name="heatmap-bucket-bound"></a>

Jika format Data adalah bucket deret Time, sumber data mengembalikan seri dengan nama yang mewakili bucket bound. Tetapi tergantung pada sumber data, batas bisa atas atau bawah. Anda dapat menggunakan opsi ini untuk menyesuaikan tipe terikat. Jika **Auto** disetel, opsi terikat dipilih berdasarkan tipe sumber data panel.

#### Ukuran bucket
<a name="heatmap-bucket-size"></a>

Opsi jumlah dan ukuran Bucket digunakan oleh Grafana Terkelola Amazon untuk menghitung seberapa besar setiap sel dalam peta panas. Anda dapat menentukan ukuran bucket baik dengan hitungan (kotak input pertama) atau dengan menentukan interval ukuran. Untuk sumbu y, interval ukuran hanyalah nilai. Untuk X-bucket, Anda dapat menentukan interval waktu di input **Ukuran**. Misalnya, Anda dapat mengatur rentang waktu ke`1h`. Ini akan membuat sel selebar 1 jam pada sumbu x.

#### Format data
<a name="heatmap-data-format"></a>

Pilih opsi dalam daftar **Format**.
+ **Deret waktu** - Grafana yang Dikelola Amazon melakukan bucketing dengan melalui semua nilai deret waktu. Ukuran dan interval bucket diatur dalam opsi **Bucket**.
+ **Bucket deret waktu** — Setiap deret waktu sudah mewakili ember sumbu y. Nama deret waktu (alias) harus berupa nilai numerik yang mewakili interval atas atau bawah untuk bucket. Ruang kerja Grafana tidak memiliki ember, sehingga opsi ukuran ember disembunyikan.

## Opsi tampilan
<a name="heatmap-display-options"></a>

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

### Warna
<a name="heatmap-colors"></a>

Spektrum warna mengontrol pemetaan antara jumlah nilai (di setiap bucket) dan warna yang ditetapkan untuk setiap bucket. Warna di sisi paling kiri spektrum mewakili jumlah minimum, dan warna di sisi paling kanan mewakili hitungan maksimum. Beberapa skema warna secara otomatis terbalik saat menggunakan tema cahaya.

Anda juga dapat mengubah mode warna menjadi **Opacity**. Dalam hal ini, warnanya tidak akan berubah, tetapi jumlah opasitas akan berubah dengan jumlah ember.
+  **Modus** 
  +  **Opacity** — Nilai bucket diwakili oleh opasitas sel. Sel buram berarti nilai maksimum.
    +  **Warna - Warna** dasar sel.
    +  **Skala** — Skala untuk memetakan nilai bucket ke opacity.
      +  **linier** — Skala linier. Nilai bucket memetakan secara linier ke opacity.
      +  **sqrt — Skala** daya. Opasitas sel dihitung sebagai`value ^ k`, di mana `k` adalah nilai **Eksponen** yang dikonfigurasi. Jika eksponen kurang dari`1`, Anda akan mendapatkan skala logaritmik. Jika eksponen lebih besar dari`1`, Anda akan mendapatkan skala eksponensial. Dalam kasus`1`, skalanya akan sama dengan linier.
    +  **Eksponen — nilai eksponen**, lebih besar dari. `0`
  +  **spektrum** - Nilai ember diwakili oleh warna sel.
    +  **Skema** — Jika modenya **spektrum**, pilih skema warna.

### Skala warna
<a name="heatmap-color-scale"></a>

Secara default, Grafana Terkelola Amazon menghitung warna sel berdasarkan nilai bucket minimum dan maksimum. Dengan **Min** dan **Max**, Anda dapat menimpa nilai-nilai tersebut. Pikirkan nilai bucket sebagai sumbu z dan Min dan Max sebagai Z-Min dan Z-Max masing-masing.
+  **Min** — Nilai minimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket kurang dari Min, itu dipetakan ke warna minimum. Nilai default-nya `series min value`.
+  **Maks** - Nilai maksimum yang digunakan untuk perhitungan warna sel. Jika nilai bucket lebih besar dari Max, itu dipetakan ke warna maksimum. Nilai default-nya `series max value`. 

### Legenda
<a name="heatmap-legend"></a>

Pilih apakah akan menampilkan legenda peta panas pada visualisasi atau tidak. 

### Bucket
<a name="heatmap-legend-buckets"></a>
+  **Sembunyikan nol** - Jangan menggambar sel yang memiliki nilai nol.
+  **Spasi** - Mengatur ruang antara sel dalam piksel. Defaultnya adalah 1 piksel.
+  **Bulat** — Atur kebulatan sel dalam piksel. Default-nya adalah 0.

### Tooltip
<a name="heatmap-tooltip"></a>
+  **Tampilkan tooltip** - Tampilkan tooltip peta panas.
+  **Histogram — Tampilkan histogram** sumbu y pada tooltip. Histogram mewakili distribusi nilai bucket untuk stempel waktu tertentu.
+  **Desimal** - Tetapkan jumlah desimal untuk merender nilai bucket dengan (default adalah auto).

# Panel histogram
<a name="histogram-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi histogram menghitung distribusi nilai dan menyajikannya sebagai diagram batang. Sumbu Y dan tinggi setiap batang mewakili jumlah nilai yang termasuk dalam setiap braket sedangkan sumbu X mewakili rentang nilai.

Visualisasi histogram mendukung deret waktu dan hasil tabel apa pun dengan satu atau lebih bidang numerik.

## Opsi tampilan
<a name="histogram-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Ukuran ember**

Ukuran ember. Biarkan kosong untuk ukuran ember otomatis (\$1 10% dari rentang penuh).

**Ember offset**

Jika ember pertama tidak harus mulai dari nol. Offset bukan nol menggeser jendela agregasi. Misalnya, ember berukuran 5 yang 0—5, 5—10, 10—15 dengan offset default 0 akan menjadi 2—7, 7—12, 12—17 dengan offset 2; offset 0, 5, atau 10, dalam hal ini, secara efektif tidak akan melakukan apa-apa. Biasanya, opsi ini akan digunakan dengan ukuran bucket yang ditentukan secara eksplisit daripada otomatis. Agar pengaturan ini mempengaruhi, jumlah offset harus lebih besar dari 0 dan kurang dari ukuran bucket; nilai di luar rentang ini akan memiliki efek yang sama dengan nilai dalam rentang ini.

**Gabungkan seri**

Ini akan menggabungkan semua seri dan bidang menjadi histogram gabungan.

**Lebar garis** mengontrol lebar garis bar.

**Fill opacity** mengontrol opasitas isian bilah.

**Mode gradien** mengatur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar. Tampilan gradien dipengaruhi oleh pengaturan Fill opacity.
+  **Tidak ada** - Tidak ada gradien fill, ini adalah pengaturan default.
+  **Opacity** — Transparansi gradien dihitung berdasarkan nilai pada sumbu Y. Opasitas isi meningkat dengan nilai-nilai pada sumbu Y.
+  **Hue** - Warna gradien dihasilkan berdasarkan rona warna garis.

**Mode Tooltip** Saat Anda mengarahkan kursor ke grafik, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku:
+  **Single** - Tooltip hover hanya menampilkan seri yang Anda arahkan.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam visualisasi. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** - Jangan tampilkan tooltip. 

**catatan**  
Gunakan override untuk menyembunyikan seri individual dari tooltip.

## Opsi legenda
<a name="histogram-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

**Perhitungan legenda**

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Lihat informasi yang lebih lengkap di [Daftar perhitungan](list-of-calculations.md).

# Panel log
<a name="logs-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi panel log menunjukkan baris log dari sumber data yang mendukung log, seperti Elastic, Influx, dan Loki. Biasanya, Anda akan menggunakan panel ini di sebelah panel grafik untuk menampilkan output log dari proses terkait.

Panel log menunjukkan hasil kueri yang dimasukkan pada tab **Kueri**. Hasil dari beberapa kueri digabungkan dan diurutkan berdasarkan waktu. Anda dapat menggulir ke dalam panel jika sumber data mengembalikan lebih banyak baris daripada yang dapat ditampilkan.

Untuk membatasi jumlah baris yang dirender, Anda dapat menggunakan pengaturan **Titik data Maks** dalam **opsi Kueri**. Jika tidak diatur, sumber data biasanya akan memberlakukan batas default.

## Opsi tampilan
<a name="logs-panel-display-options"></a>

Gunakan pengaturan berikut untuk menyempurnakan visualisasi Anda:
+  **Waktu** - Tampilkan atau sembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data.
+  **Label unik** - Tampilkan atau sembunyikan kolom label unik, yang hanya menampilkan label yang tidak umum.
+  **Garis bungkus** - Alihkan pembungkus garis. 
+  **Urutan** - Menampilkan hasil dalam urutan waktu turun atau naik. Defaultnya adalah **Descending**, menampilkan log terbaru terlebih dahulu. Setel ke **Ascending** untuk menampilkan baris log tertua terlebih dahulu.

# Panel berita
<a name="news-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel ini menampilkan umpan RSS. Secara default, ini menampilkan artikel dari blog Grafana Labs.

Di bagian **Tampilan**, di bidang **URL**, masukkan URL umpan RSS. Jenis panel ini tidak menerima pertanyaan lain.

# Panel grafik simpul (Beta)
<a name="node-graph-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel grafik simpul memvisualisasikan grafik atau jaringan yang diarahkan. Ini menggunakan tata letak gaya terarah untuk memposisikan node secara efektif sehingga dapat membantu menampilkan peta infrastruktur, hierarki, atau diagram eksekusi yang kompleks.

## Persyaratan data
<a name="node-graph-panel-requirements"></a>

Panel grafik node membutuhkan bentuk data tertentu untuk dapat menampilkan node dan tepinya. Tidak semua sumber data atau kueri dapat divisualisasikan di panel ini.

Visualisasi grafik Node terdiri dari *node* dan *tepi*.
+ Sebuah *simpul* ditampilkan sebagai lingkaran. Sebuah node mungkin mewakili aplikasi, layanan, atau apa pun yang relevan dari perspektif aplikasi.
+ *Tepi* ditampilkan sebagai garis yang menghubungkan dua node. Koneksi mungkin permintaan, eksekusi, atau hubungan lain antara dua node.

## Node
<a name="node-graph-panel-nodes"></a>

Biasanya, node menunjukkan dua nilai statistik di dalam node dan dua pengidentifikasi tepat di bawah node, biasanya nama dan jenis. Node juga dapat menunjukkan set nilai lain sebagai lingkaran warna di sekitar node, dengan bagian warna yang berbeda mewakili nilai yang berbeda yang harus menambahkan hingga 1. Misalnya, Anda dapat memiliki persentase kesalahan yang diwakili oleh bagian merah dari lingkaran.

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

## Tepi
<a name="node-graph-panel-edges"></a>

Tepi juga dapat menunjukkan statistik saat Anda mengarahkan kursor ke tepi. Mirip dengan node, Anda dapat membuka menu konteks dengan detail dan tautan tambahan dengan memilih tepi.

Sumber data pertama yang mendukung visualisasi ini adalah sumber AWS X-Ray data untuk fitur peta layanannya. Untuk informasi selengkapnya, lihat [Connect ke sumber AWS X-Ray data](x-ray-data-source.md).

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

## Menavigasi grafik simpul
<a name="node-graph-panel-navigation"></a>

Anda dapat menggeser dalam grafik simpul dengan memilih di luar node atau tepi mana pun dan menyeret mouse.

Anda dapat memperbesar dengan menggunakan tombol di sudut kiri atas grafik simpul.

# Panel bagan pai
<a name="pie-chart-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Diagram lingkaran menampilkan seri yang dikurangi, atau nilai dalam seri, dari satu atau lebih kueri, karena mereka berhubungan satu sama lain, sebagai irisan kue. Panjang busur, luas, dan sudut tengah irisan semuanya sebanding dengan nilai irisan, karena berkaitan dengan jumlah semua nilai. Jenis bagan ini paling baik digunakan ketika Anda menginginkan perbandingan cepat dari serangkaian kecil nilai dalam bentuk yang menyenangkan secara estetika.

Visualisasi diagram lingkaran memungkinkan Anda menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md). 
+  [Opsi bidang dan penggantian](field-options-overrides.md). 
+  [Ambang batas](thresholds.md).

## Opsi
<a name="pie-chart-panel-options"></a>

Anda dapat menggunakan opsi berikut untuk menyempurnakan visualisasi Anda.
+  **Tampilkan** — Pilih berapa banyak informasi yang akan ditampilkan. **Hitung** mengurangi setiap nilai menjadi satu nilai per seri. **Semua nilai** menampilkan setiap nilai dari satu seri.
+  **Perhitungan** — Pilih perhitungan untuk mengurangi setiap seri saat **Hitung** telah dipilih. Untuk informasi tentang perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md).
+  **Batas** - Saat menampilkan setiap nilai dari satu seri, ini membatasi jumlah nilai yang ditampilkan.
+  **Bidang** - Pilih bidang mana yang akan ditampilkan dalam visualisasi.
  + **Bidang numerik** - Semua bidang dengan nilai numerik.
  + **Semua bidang** — Semua bidang yang tidak dihapus oleh transformasi.
  + **Waktu** - Semua bidang dengan nilai waktu.

## Label
<a name="pie-charts-panel-labels"></a>

Pilih label untuk ditampilkan pada diagram lingkaran. Anda dapat memilih lebih dari satu.
+  **Nama - Nama** seri atau bidang. 
+  **Persentase** — Persentase keseluruhan. 
+  **Nilai — Nilai** numerik mentah. 

Label ditampilkan dalam warna putih di atas badan bagan. Anda mungkin perlu memilih warna grafik yang lebih gelap untuk membuatnya lebih terlihat. Nama atau angka panjang mungkin terpotong.

## Penempatan dan nilai legenda
<a name="pie-charts-panel-legend"></a>

Pilih tempat untuk menampilkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik. 

Anda dapat memilih lebih dari satu nilai untuk ditampilkan dalam legenda. **Persen** adalah persentase keseluruhan dan **Nilai adalah nilai** numerik mentah.

# Panel yang cepat
<a name="plotly-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel Plotly merender bagan menggunakan [Plotly, pustaka](https://plotly.com/javascript/) grafik javascript open source.

Bidang **Data**, **Layout**, dan **Config** cocok dengan parameter umum yang dijelaskan dalam dokumentasi [Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Mereka harus dalam format JSON.

Data yang disediakan oleh sumber data dapat diubah melalui skrip yang ditentukan pengguna sebelum disuntikkan dalam bagan Plotly. Skrip ini mencakup 2 argumen.
+ `data`— Data yang dikembalikan oleh sumber data.
+ `variables`— Objek yang berisi [variabel Grafana](templates-and-variables.md) di dasbor saat ini (variabel pengguna dan beberapa variabel global ini:`__from`,, `__to``__interval`, dan`__interval_ms`).

Script harus mengembalikan objek dengan satu atau lebih properti berikut:`data`,`layout`, `config` dan`frames`. Berikut adalah contohnya.

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

Objek yang dikembalikan oleh skrip dan JSON yang disediakan di bidang *Data*, *Layout* dan *Config* akan digabungkan (deep merge).

Jika tidak ada skrip yang disediakan, panel hanya akan menggunakan bidang *Data*, *Layout* dan *Config*.

# Panel Sankey
<a name="sankey-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel Sankey menunjukkan diagram Sankey, yang bagus untuk memvisualisasikan data aliran, dengan lebar aliran sebanding dengan metrik yang dipilih. Gambar berikut menunjukkan diagram Sankey dengan dua kelompok sumber dan tujuan.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/sankey-panel.png)


**Cara kerjanya**

Panel sankey membutuhkan setidaknya 2 kolom data, sumber dan tujuan untuk aliran. Kueri Anda harus mengelompokkan data Anda ke dalam setidaknya dua grup. Panel akan menggambar tautan dari kolom pertama titik data, ke yang terakhir dalam urutan kueri. Ketebalan tautan akan sebanding dengan nilai yang ditetapkan oleh metrik dalam kueri.

**Menyesuaikan**
+ **Tautan** - Saat ini ada dua opsi untuk warna tautan: multi atau tunggal. Ini multi-warna secara default. Untuk memilih satu warna untuk tautan, alihkan opsi warna **Single Link saja dan pilih warna** Anda dari pemilih warna Grafana.
+ **Node** - Anda dapat mengubah warna node persegi panjang dengan mengubah opsi **warna Node**
+ **Lebar Node** - Lebar node dapat disesuaikan dengan slider **Lebar Node** atau memasukkan angka di kotak input. Angka ini harus berupa bilangan bulat.
+ **Node Padding** — Padding vertikal antar node dapat disesuaikan dengan slider **Node Padding** atau memasukkan angka di kotak input. Angka ini harus berupa bilangan bulat. Jika tautan Anda terlalu tipis, coba sesuaikan nomor ini
+ **Header** - Header kolom dapat diubah dengan menggunakan penggantian **Nama Tampilan** di panel editor. Mereka akan menjadi warna yang sama yang Anda pilih untuk **warna Teks**
+ **Sankey Layout** - Tata letak tautan Sankey dapat disesuaikan sedikit menggunakan slider **iterasi Layout**. Angka ini harus berupa bilangan bulat dan merupakan jumlah iterasi relaksasi yang digunakan untuk menghasilkan tata letak.

# Panel pencar
<a name="scatter-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel pencar menunjukkan plot X/Y pencar untuk data tabel dengan antarmuka yang lebih sederhana daripada panel grafik lainnya. Berbeda dengan panel grafik, panel pencar tidak memerlukan data untuk berada dalam deret waktu. Panel pencar membutuhkan dataset yang diformat tabel dengan dua atau lebih kolom numerik data.

Salah satunya dapat ditetapkan ke sumbu X. Satu atau lebih dapat ditetapkan ke serangkaian nilai sumbu Y dan data yang dihasilkan diplot sebagai serangkaian titik. Setiap seri secara opsional juga dapat menunjukkan garis regresi menggunakan salah satu dari sejumlah kecocokan statistik terbaik.

**Membuat panel pencar**

Prosedur berikut menjelaskan cara membuat plot pencar menggunakan panel pencar. Untuk contoh ini, kita akan mengasumsikan bahwa ada data, seperti pada tabel berikut yang disebut `HEIGHT` dengan tiga kolom nilai numerik,`Age`,`Boys`, dan`Girls`, menunjukkan tinggi rata-rata anak laki-laki dan perempuan berdasarkan usia.


| Umur | Tinggi Anak Laki-Laki | Tinggi Gadis | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115.4  | 
|  7  |  121.1  |  120,8  | 
|  8  |  126.3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152.6  | 
|  14  |  159,9  |  155.1  | 
|  15  |  164.4  |  156,7  | 
|  16  |  167.3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Untuk membuat plot pencar dengan panel pencar**

1. Di dasbor Grafana Anda, pilih **Tambah** Panel. Untuk detail selengkapnya tentang menambahkan panel, lihat[Menambahkan panel](add-a-panel-to-a-dashboard.md).

1. Untuk Query, tulis kueri yang akan mengembalikan data yang dibutuhkan. Dalam hal ini, Anda akan menggunakan kueri seperti`SELECT * FROM HEIGHT`.

1. Pilih visualisasi **Scatter**.

Ini akan membuat plot pencar, menggunakan kolom pertama sebagai sumbu X, dan kolom numerik lainnya sebagai sumbu Y.

**Opsi konfigurasi**

Panel pencar menyediakan empat opsi konfigurasi kustom berikut.
+ **Sumbu X** - Anda dapat memilih bidang mana yang akan digunakan sebagai sumbu X, serta luas dan judul dan informasi tampilan untuk sumbu.
+ **Sumbu Y** - Anda dapat memilih bidang mana yang akan ditampilkan pada sumbu Y, termasuk opsi tampilan untuk setiap bidang, dan informasi perluasan dan judul untuk sumbu. Anda juga dapat memilih untuk menampilkan garis regresi untuk setiap bidang. Lihat informasi berikut untuk detail lebih lanjut tentang konfigurasi garis regresi.
+ **Legenda** — Anda dapat mengaktifkan atau menonaktifkan legenda untuk panel, serta memilih ukuran teks dalam legenda.
+ **Tampilan** - Anda dapat mengatur opsi lain untuk bagan, termasuk warna kisi dan gaya perbatasan.

**Konfigurasi garis regresi**

Setiap dataset sumbu Y dapat menampilkan garis, selain titik-titik individual. Ada lima opsi untuk jenis garis.
+ **Tidak ada** - Jangan menampilkan garis regresi.
+ **Sederhana** — Menampilkan garis regresi yang menghubungkan titik dataset.
+ **Linear** - Menampilkan garis lurus, menggunakan kuadrat terkecil, metode yang paling cocok.
+ **Eksponensial** - Menampilkan garis regresi paling cocok eksponensial.
+ **Daya** - Menampilkan garis regresi yang paling sesuai dengan daya.

# Panel stat
<a name="stat-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel stat menunjukkan satu nilai stat besar dengan sparkline grafik opsional. Anda dapat mengontrol latar belakang atau warna nilai dengan menggunakan ambang batas.

Secara default, panel stat menunjukkan salah satu tampilan berikut:
+ Hanya nilai untuk satu seri atau bidang.
+ Baik nilai dan nama untuk beberapa seri atau bidang.

Anda dapat menggunakan opsi **mode Teks** untuk mengontrol apakah teks ditampilkan atau tidak.

## Opsi data dan bidang
<a name="stat-panel-data-and-field-options"></a>

Visualisasi stat memungkinkan Anda menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md).
+  [Opsi bidang dan penggantian](field-options-overrides.md).
+  [Ambang batas](thresholds.md).

## Penyesuaian tata letak otomatis
<a name="stat-panel-automatic-layout-adjustment"></a>

Panel secara otomatis menyesuaikan tata letak tergantung pada lebar dan tinggi yang tersedia di dasbor. Secara otomatis menyembunyikan grafik (sparkline) jika panel menjadi terlalu kecil.

## Opsi tampilan
<a name="stat-panel-display-options"></a>

Gunakan opsi berikut untuk menyempurnakan visualisasi Anda:
+  **Tampilkan** — Pilih cara Grafana Terkelola Amazon menampilkan data Anda.
  +  **Hitung** - Tampilkan nilai yang dihitung berdasarkan semua baris.
    +  **Perhitungan** — Pilih perhitungan yang akan diterapkan. Untuk informasi tentang perhitungan yang tersedia, lihat[Daftar perhitungan](list-of-calculations.md).
  +  **Semua nilai** - Tampilkan stat terpisah untuk setiap baris.
    +  **Batas** - Tentukan jumlah baris maksimum yang akan ditampilkan.
+  **Bidang** - Pilih nama bidang atau jenis bidang (termasuk **Semua bidang atau bidang** **Numerik**) untuk disertakan dalam panel ini.
+  **Nilai** — Pilih fungsi peredam yang akan digunakan Amazon Managed Grafana untuk mengurangi banyak bidang menjadi satu nilai. Pilih daftar **Nilai** untuk melihat fungsi dan deskripsi singkat. 
+  **Orientasi** — Pilih arah susun.
  +  **Otomatis** — Grafana yang Dikelola Amazon memilih apa yang dianggapnya sebagai orientasi terbaik.
  +  **Horizontal** - Batang meregang secara horizontal, kiri ke kanan.
  +  **Vertikal** - Batang meregang secara vertikal, dari atas ke bawah.
+  **Mode teks** - Anda dapat menggunakan opsi **mode Teks** untuk mengontrol teks apa yang ditampilkan panel. Jika hanya nama dan warna yang penting, dan nilainya tidak, ubah **mode Teks** ke **Nama**. Nilai masih digunakan untuk menentukan warna dan ditampilkan dalam tooltip.
  +  **Otomatis** - Jika data berisi beberapa seri atau bidang, tunjukkan nama dan nilainya.
  +  **Nilai** - Hanya tampilkan nilainya, jangan pernah namanya. Nama ditampilkan di tooltip.
  +  **Nilai dan nama** — Selalu tunjukkan nilai dan nama.
  +  **Nama** — Tampilkan nama, bukan nilainya. Nilai ditampilkan di tooltip.
  +  **Tidak ada** - Tidak menunjukkan apa-apa (kosong). Nama dan nilainya ditampilkan di tooltip.
+  **Mode warna** - Pilih mode warna.
  +  **Nilai** - Warna hanya nilai dan area grafik.
  +  **Latar belakang** - Warna latar belakang juga.
+  **Mode grafik** - Pilih mode grafik.
  +  **Tidak ada** - Menyembunyikan grafik dan hanya menunjukkan nilainya.
  +  **Area** - Menunjukkan grafik area di bawah nilai. Opsi ini mengharuskan kueri Anda mengembalikan kolom waktu.
+  **Mode penyelarasan** - Pilih mode perataan.
  +  **Otomatis** - Jika hanya satu nilai yang ditampilkan (tidak ada pengulangan), nilainya terpusat. Jika beberapa seri atau baris ditampilkan, nilainya sejajar kiri.
  +  **Pusat** — Nilai Stat terpusat.

# Panel garis waktu negara
<a name="state-timeline-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi panel timeline status menunjukkan perubahan status diskrit dari waktu ke waktu. Setiap bidang atau seri dirender sebagai pita horisontal yang unik. Wilayah negara dapat dirender dengan atau tanpa nilai. Panel ini bekerja dengan baik dengan status string atau boolean tetapi juga dapat digunakan dengan deret waktu. Ketika digunakan dengan deret waktu, ambang batas digunakan untuk mengubah nilai numerik menjadi wilayah keadaan diskrit.

## Opsi garis waktu negara
<a name="state-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Gabungkan nilai berurutan yang sama**

Mengontrol apakah Grafana menggabungkan nilai yang identik jika keduanya bersebelahan.

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam wilayah negara bagian. Otomatis akan merender nilai jika ada ruang yang cukup.

**Sejajarkan nilai**

Mengontrol penyelarasan nilai di dalam wilayah negara bagian.

**Tinggi baris**

Mengontrol ruang antar baris. 1 = tidak ada spasi = 0,5 = 50% ruang.

**Lebar garis**

Mengontrol lebar garis wilayah negara bagian.

**Isi opacity**

Mengontrol opasitas wilayah negara bagian.

## Pemetaan nilai
<a name="state-timeline-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Pemetaan nilai](field-options-overrides.md#value-mapping)

## Data deret waktu dengan ambang batas
<a name="state-timeline-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mengubah deret waktu menjadi daerah keadaan berwarna diskrit.

## Opsi legenda
<a name="state-timeline-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah Opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

# Panel riwayat status
<a name="status-history-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Visualisasi riwayat Status menunjukkan keadaan periodik dari waktu ke waktu. Setiap bidang atau seri dirender sebagai baris horizontal. Kotak dirender dan dipusatkan di sekitar setiap nilai.

Visualisasi riwayat status bekerja dengan string, boolean, dan bidang numerik atau deret waktu. Diperlukan bidang waktu. Anda dapat menggunakan pemetaan nilai untuk mewarnai string atau menetapkan nilai teks ke rentang numerik.

## Opsi tampilan
<a name="status-timeline-options"></a>

Gunakan opsi ini untuk menyempurnakan visualisasi Anda:

**Tampilkan nilai**

Mengontrol apakah nilai dirender di dalam kotak nilai. Otomatis akan merender nilai jika ada ruang yang cukup.

**Lebar kolom** mengontrol lebar kotak. 1 = maks dan 0 = lebar Min.

**Lebar garis** mengontrol lebar garis wilayah negara bagian.

**Fill opacity** mengontrol opasitas pengisian wilayah negara bagian.

## Pemetaan nilai
<a name="status-history-valuemap"></a>

Untuk menetapkan warna ke nilai boolean atau string, gunakan. [Pemetaan nilai](field-options-overrides.md#value-mapping)

## Data deret waktu dengan ambang batas
<a name="status-history-threshold"></a>

Panel dapat digunakan dengan data deret waktu juga. Dalam hal ini, ambang batas digunakan untuk mewarnai kotak. Anda juga dapat menggunakan skema warna gradien untuk mewarnai nilai.

## Opsi legenda
<a name="status-history-legend"></a>

Saat opsi legenda diaktifkan, opsi ini dapat menampilkan pemetaan nilai atau tanda kurung ambang batas. Untuk menampilkan pemetaan nilai dalam legenda, penting bahwa opsi skema Warna di bawah Opsi standar diatur ke Warna tunggal atau Palet klasik. Untuk melihat tanda kurung ambang batas dalam legenda, atur skema Warna ke Dari ambang batas.

**Mode legenda** Gunakan pengaturan ini untuk menyempurnakan bagaimana legenda muncul dalam visualisasi Anda.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah mode tampilan default legenda.
+  **Tabel** - Menampilkan legenda sebagai tabel.
+  **Tersembunyi** — Menyembunyikan legenda.

**Penempatan legenda** Pilih tempat untuk menempatkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik.

# Panel meja
<a name="table-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel tabel mendukung beberapa mode untuk deret waktu dan untuk tabel, anotasi, dan data JSON mentah. Panel ini juga menyediakan pemformatan tanggal, pemformatan nilai, dan opsi pewarnaan.

## Opsi data dan bidang
<a name="data-and-field-options"></a>

Dengan visualisasi tabel Anda dapat menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md).
+  [Opsi bidang dan penggantian](field-options-overrides.md).
+  [Ambang batas](thresholds.md).

## Opsi tampilan
<a name="display-options"></a>
+  **Tampilkan header** - Tampilkan atau sembunyikan nama kolom yang diimpor dari sumber data Anda.
+  **Urutkan naik/turun** - Pilih judul kolom untuk mengubah urutan pengurutan dari default menjadi turun ke naik. Setiap kali Anda memilih, urutan pengurutan berubah ke opsi berikutnya dalam siklus. Anda dapat mengurutkan dengan hanya satu kolom pada satu waktu.
+  [Opsi bidang tabel](#table-field-options)— Ubah opsi bidang seperti lebar kolom, perataan, dan mode tampilan sel.
+  [Filter kolom tabel](#filter-table-columns)— Ubah sementara bagaimana data kolom ditampilkan. Misalnya, Anda dapat mengurutkan nilai dari tertinggi ke terendah atau menyembunyikan nilai tertentu.

## Dukungan anotasi
<a name="annotation-support"></a>

Anotasi saat ini tidak didukung di panel tabel baru.

## Opsi bidang tabel
<a name="table-field-options"></a>

Bagian ini menjelaskan semua opsi bidang tabel yang tersedia. Opsi tercantum dalam urutan yang sama seperti di Grafana yang Dikelola Amazon. Opsi yang tercantum dalam topik ini hanya berlaku untuk visualisasi panel tabel.

Sebagian besar opsi bidang tidak akan memengaruhi visualisasi sampai Anda memilih di luar kotak opsi bidang yang sedang Anda edit atau tekan Enter.

Untuk informasi selengkapnya tentang menerapkan opsi ini, lihat [Konfigurasikan semua bidang](field-options-overrides.md#configure-all-fields) dan[Konfigurasikan bidang tertentu](field-options-overrides.md#configure-specific-fields).

### Penyelarasan kolom
<a name="column-alignment"></a>

Pilih bagaimana Grafana yang Dikelola Amazon harus menyelaraskan konten sel:
+ Otomatis (default)
+ Kiri
+ Pusat
+ Kanan

### Lebar kolom
<a name="column-width"></a>

Secara default, Grafana Terkelola Amazon secara otomatis menghitung lebar kolom berdasarkan konten sel. Dalam opsi bidang ini, Anda dapat mengganti pengaturan dan menentukan lebar untuk semua kolom dalam piksel.

Misalnya, jika Anda memasukkan `100` di bidang, semua kolom akan diatur ke lebar 100 piksel saat Anda memilih di luar bidang.

### Mode tampilan sel
<a name="cell-display-mode"></a>

Secara default, Grafana Terkelola Amazon secara otomatis memilih pengaturan tampilan. Anda dapat mengganti pengaturan dengan memilih salah satu opsi berikut untuk mengubah semua bidang.

**catatan**  
Jika Anda mengatur ini di tab **Bidang**, mode tampilan berlaku untuk semua bidang, termasuk bidang waktu. Banyak opsi bekerja paling baik jika Anda mengaturnya di tab **Override**.

#### Teks warna
<a name="color-text"></a>

Jika ambang batas ditetapkan, teks bidang ditampilkan dalam warna ambang batas yang sesuai.

#### Latar belakang warna
<a name="color-background"></a>

Jika ambang batas ditetapkan, latar belakang bidang ditampilkan dalam warna ambang batas yang sesuai.

#### Pengukur gradien
<a name="gradient-gauge"></a>

Tingkat ambang batas menentukan gradien.

#### Pengukur LCD
<a name="lcd-gauge"></a>

Pengukur dibagi dalam sel-sel kecil yang menyala atau tidak menyala.

#### Tampilan JSON
<a name="json-view"></a>

Nilai ditampilkan diformat sebagai kode. Jika nilai adalah objek, tampilan JSON yang memungkinkan Anda untuk menelusuri objek JSON muncul ketika Anda berhenti pada nilai.

### Filter kolom
<a name="column-filter"></a>

## Filter kolom tabel
<a name="filter-table-columns"></a>

Jika Anda mengaktifkan **Filter kolom** dalam opsi tabel, Anda dapat memfilter opsi tabel. Untuk informasi selengkapnya, lihat [Opsi bidang tabel](#table-field-options).

### Aktifkan pemfilteran kolom
<a name="turn-on-column-filtering"></a>

1. Di Amazon Managed Grafana, pilih dasbor yang menampilkan tabel dengan kolom yang ingin Anda filter.

1. Pada panel tabel yang ingin Anda filter,[Membuka editor panel](AMG-panel-editor.md#open-the-panel-editor).

1. Pilih tab **Bidang**.

1. Dalam opsi **Tabel**, nyalakan opsi **Filter kolom**.

Ikon filter muncul di sebelah setiap judul kolom.

### Filter nilai kolom
<a name="filter-column-values"></a>

Untuk memfilter nilai kolom, pilih ikon filter (corong) di sebelah judul kolom. Ruang kerja Grafana menampilkan opsi filter untuk kolom itu.

Pilih kotak centang di sebelah nilai yang ingin Anda tampilkan. Masukkan teks di bidang pencarian di bagian atas untuk menampilkan nilai-nilai tersebut di layar sehingga Anda dapat memilihnya daripada menggulir untuk menemukannya.

### Hapus filter kolom
<a name="clear-column-filters"></a>

Kolom dengan filter yang diterapkan memiliki corong biru yang ditampilkan di sebelah judul.

Untuk menghapus filter, pilih ikon corong biru, lalu pilih **Hapus filter**.

# Panel teks
<a name="text-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Anda dapat menggunakan panel teks untuk membuat panel informasi dan deskripsi untuk dasbor Anda.

Dalam **Mode**, pilih apakah Anda ingin menggunakan penurunan harga atau HTML untuk menata teks Anda, lalu masukkan konten di kotak di bawah ini. Ruang kerja Grafana menyertakan judul dan paragraf untuk membantu Anda memulai, atau Anda dapat menempelkan konten dari editor lain.

# Panel deret waktu
<a name="time-series-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Panel deret waktu dapat membuat deret waktu sebagai garis, jalur titik, atau serangkaian batang. Jenis grafik ini cukup serbaguna untuk menampilkan hampir semua data deret waktu.

**catatan**  
Anda dapat memigrasikan visualisasi panel Grafik ke visualisasi deret Waktu. Untuk bermigrasi, pada tab **Panel**, pilih **Visualisasi deret waktu**. Grafana mentransfer semua pengaturan yang berlaku.

Visualisasi deret waktu memungkinkan Anda menerapkan opsi berikut:
+  [Transformasi](panel-transformations.md) 
+  [Opsi bidang dan penggantian](field-options-overrides.md) 
+  [Ambang batas](thresholds.md) 

Anda juga dapat menggunakan opsi bidang untuk membuat berbagai jenis grafik atau menyesuaikan sumbu Anda.

Gunakan pengaturan ini untuk menyempurnakan visualisasi Anda.

## Mode Tooltip
<a name="time-series-panel-tooltip"></a>

Saat Anda mengarahkan kursor ke grafik, Grafana dapat menampilkan tooltips. Pilih bagaimana tooltips berperilaku:
+  **Single** - Tooltip hover hanya menampilkan seri yang Anda arahkan.
+  **Semua** - Tooltip hover menunjukkan semua seri dalam grafik. Grafana menyoroti seri yang Anda arahkan dengan huruf tebal dalam daftar seri di tooltip.
+  **Tersembunyi** - Jangan tampilkan tooltip. 

## Mode dan penempatan legenda
<a name="time-series-panel-legend"></a>

Pilih bagaimana legenda muncul.
+  **Daftar** - Menampilkan legenda sebagai daftar. Ini adalah opsi default.
+  **Tabel** - Menampilkan legenda sebagai tabel. 
+  **Tersembunyi** — Menyembunyikan legenda.

Pilih tempat untuk menampilkan legenda.
+  **Bawah** - Di bawah grafik.
+  **Kanan** - Di sebelah kanan grafik. 

## Perhitungan legenda
<a name="time-series-panel-legend-calculations"></a>

Pilih perhitungan mana yang akan ditampilkan dalam legenda. Lihat informasi yang lebih lengkap di [Daftar perhitungan](list-of-calculations.md).

# Grafik deret waktu sebagai garis
<a name="time-series-graph-lines"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini menjelaskan cara menggunakan opsi bidang deret waktu untuk memvisualisasikan data deret waktu sebagai garis dan menggambarkan apa yang dilakukan opsi.

**Buat panel**

1. Buat panel, pilih visualisasi **deret Waktu**. Untuk informasi selengkapnya, lihat [Menambahkan panel](add-a-panel-to-a-dashboard.md).

1. Di **editor Panel**, pilih **Bidang**.

1. Di **Style**, pilih **Lines**.

## Gaya garis
<a name="time-series-graph-lines-style"></a>

Ada berbagai opsi untuk menata garis.
+ **Interpolasi garis** — Pilih cara Grafana menginterpolasi garis seri. Pilihannya adalah **Linear**, **Smooth**, **Step before**, dan **Step after**.
+ **Lebar garis** - Atur ketebalan garis antara 0 dan 10 piksel.
+ **Fill opacity** - Atur opacity dari seri fill, dari 0 hingga 100 persen.
+ **Mode gradien** - Atur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

  Tampilan gradien dipengaruhi oleh pengaturan untuk **Fill opacity**.

  **Pilihan untuk gradient fill adalah **None**, **Opacity**, dan Hue.** Dengan **Opacity**, Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isian meningkat dengan nilai pada sumbu y. Dengan **Hue**, warna gradien dihasilkan berdasarkan rona warna garis.
+ **Gaya garis** - Mengatur gaya garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

  Tampilan gaya garis dipengaruhi oleh pengaturan untuk **Lebar garis** dan **opasitas Isi**.

  Pilihan untuk gaya garis adalah **Solid**, **Dash**, dan **Dots**.
+ **Nilai nol** - Pilih bagaimana celah dalam data ditampilkan. Nilai nol dapat dihubungkan untuk membentuk garis kontinu atau, secara opsional, menetapkan ambang batas di mana celah dalam data seharusnya tidak lagi terhubung. Anda dapat memilih untuk **Jangan pernah** menghubungkan titik data dengan celah, **Selalu** sambungkan titik data dengan celah, atau atur **Ambang batas** di mana celah dalam data seharusnya tidak lagi terhubung.
+ **Tampilkan poin** - Pilih kapan titik harus ditampilkan pada grafik. Pilihannya adalah **Otomatis**, **Selalu**, dan **Tidak Pernah**.

## Isi di bawah ini untuk
<a name="time-series-panel-legend-fillbelow"></a>

Opsi ini hanya tersedia di tab overrides.

**Untuk mengisi area antara dua seri**

1. Pilih bidang yang akan diisi di bawah ini.

1. Di **Tambahkan properti ganti**, pilih **Isi di bawah ini untuk**.

1. Pilih seri tempat Anda ingin isian berhenti.

# Grafik deret waktu sebagai batang
<a name="time-series-graph-bars"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini menjelaskan cara menggunakan opsi bidang deret waktu untuk memvisualisasikan data deret waktu sebagai bilah dan menggambarkan apa yang dilakukan opsi.

**Buat panel**

1. Buat panel, pilih visualisasi **deret Waktu**. Untuk informasi selengkapnya, lihat [Menambahkan panel](add-a-panel-to-a-dashboard.md).

1. Di **editor Panel**, pilih **Bidang**.

1. Dalam **Gaya**, pilih **Bar**.

## Gaya bar
<a name="time-series-graph-bars-style"></a>

Ada berbagai pilihan untuk menata bar.
+ **Penjajaran batang** - Mengatur posisi bar relatif terhadap titik data. Pilihannya adalah **Sebelum**, **Tengah**, dan **Setelah**.
+ **Lebar garis** - Mengatur ketebalan garis bar antara 0 dan 10 piksel.
+ **Fill opacity** — Atur opacity dari bar fill, dari 0 hingga 100 persen.
+ **Mode gradien** - Atur mode pengisian gradien. Gradien isi didasarkan pada warna garis. Untuk mengubah warna, gunakan opsi bidang skema warna standar.

  Tampilan gradien dipengaruhi oleh pengaturan untuk **Fill opacity**.

  **Pilihan untuk gradient fill adalah **None**, **Opacity**, dan Hue.** Dengan **Opacity**, Transparansi gradien dihitung berdasarkan nilai pada sumbu y. Opasitas isian meningkat dengan nilai pada sumbu y. Dengan **Hue**, warna gradien dihasilkan berdasarkan rona warna garis.
+ **Tampilkan poin** - Pilih kapan titik harus ditampilkan pada grafik. Pilihannya adalah **Otomatis**, **Selalu** dan **Tidak Pernah**.

# Grafik deret waktu sebagai titik
<a name="time-series-graph-points"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini menjelaskan cara menggunakan opsi bidang deret waktu untuk memvisualisasikan data deret waktu sebagai titik dan menggambarkan apa yang dilakukan opsi.

**Buat panel**

1. Buat panel, pilih visualisasi **deret Waktu**. Untuk informasi selengkapnya, lihat [Menambahkan panel](add-a-panel-to-a-dashboard.md).

1. Di **editor Panel**, pilih **Bidang**.

1. Dalam **Gaya**, pilih **Poin**.

## Gaya poin
<a name="time-series-graph-points-style"></a>

Saat Anda membuat grafik sebagai titik, Anda dapat memilih ukuran titik.
+ **Ukuran titik** — Pilih ukuran titik, antara 1 dan 40 piksel dengan diameter.

# Ubah tampilan sumbu
<a name="time-series-change-axis"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini menjelaskan cara menggunakan opsi bidang deret waktu untuk mengontrol tampilan sumbu dalam visualisasi dan mengilustrasikan apa yang dilakukan opsi sumbu.

Ada berbagai pilihan untuk sumbu.
+ **Penempatan sumbu** Y - Atur penempatan sumbu y. Pilihannya adalah **Kiri, **Kanan****, dan **Tersembunyi**.
+ **Label sumbu Y** - Tetapkan label teks untuk sumbu y. Jika Anda memiliki lebih dari satu sumbu y, Anda dapat menggunakan tab **Override** untuk menetapkan label yang berbeda.
+ **Lebar** - Atur lebar sumbu yang tetap. Secara default, ruang kerja Grafana secara dinamis menghitung lebar sumbu. Dengan mengatur lebar sumbu, data yang jenis sumbunya berbeda dapat berbagi proporsi tampilan yang sama. Ini membuatnya lebih mudah untuk membandingkan lebih dari satu data grafik karena sumbu tidak bergeser atau diregangkan dalam kedekatan visual satu sama lain.
+ **Soft min dan soft max** - Atur **Soft min** atau **Soft max** untuk kontrol batas sumbu y yang lebih baik. Secara default, ruang kerja Grafana menetapkan rentang untuk sumbu y secara otomatis berdasarkan data.

  Pengaturan **soft min** atau **Soft max** dapat mencegah blip muncul sebagai gunung ketika data sebagian besar datar, dan min keras atau maks yang berasal dari opsi bidang min dan maks standar dapat mencegah lonjakan intermiten meratakan detail yang berguna dengan memotong paku melewati titik yang ditentukan.
+ **Skala** - Atur skala yang akan digunakan untuk nilai sumbu y. Pilihannya adalah **Linear** dan **Logaritmik**.

# Grafik deret waktu bertumpuk
<a name="time-series-stacked"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini menjelaskan cara menggunakan opsi bidang panel deret waktu untuk mengontrol penumpukan seri dan menggambarkan apa yang dilakukan opsi susun. Penumpukan memungkinkan Grafana untuk menampilkan seri di atas satu sama lain. Berhati-hatilah saat menggunakan penumpukan dalam visualisasi karena dapat dengan mudah membuat grafik yang menyesatkan. Anda dapat membaca lebih lanjut tentang mengapa penumpukan mungkin bukan pendekatan terbaik di sini: [Masalah dengan Penumpukan](https://www.data-to-viz.com/caveat/stacking.html).

# Seri tumpukan dalam kelompok
<a name="time-series-stacked-groups"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Opsi grup susun hanya tersedia sebagai penggantian.

**Untuk menumpuk seri dalam grup yang sama**

1. Di bagian Overrides, buat penggantian bidang untuk opsi seri **Stack**.

1. Pilih mode susun **Normal**.

1. Beri nama grup susun tempat Anda ingin seri muncul. Opsi nama grup susun hanya tersedia saat membuat penggantian.

# Ambang batas
<a name="thresholds"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Ambang batas mengatur warna teks nilai atau latar belakang tergantung pada kondisi yang Anda tentukan.

Anda dapat menentukan ambang salah satu dari dua cara:
+ Ambang batas **absolut** didefinisikan berdasarkan angka; misalnya, 80 pada skala 1-150.
+ Ambang batas **persentase** didefinisikan relatif terhadap minimum atau maksimum; misalnya, 80 persen.

Anda dapat menerapkan ambang batas untuk visualisasi berikut:
+ [Panel pengukur batang](alert-panel-bar-gauge-panel.md) 
+  [Panel pengukur](gauge-panel.md) 
+  [Panel grafik](graph-panel.md)
+  [Panel stat](stat-panel.md)
+  [Panel meja](table-panel.md)

## Ambang batas default
<a name="default-thresholds"></a>

Pada visualisasi yang mendukungnya, Amazon Managed Grafana menetapkan nilai ambang default berikut: 80 = merah; Basis = hijau; Mode = Absolut.

Nilai **dasar** mewakili minus tak terhingga. Ini umumnya warna yang *bagus*.

## Menambahkan ambang batas
<a name="add-a-threshold"></a>

Anda dapat menambahkan ambang batas sebanyak mungkin ke panel yang Anda inginkan. Ruang kerja Grafana secara otomatis mengurutkan ambang batas dari nilai tertinggi ke terendah.

**catatan**  
Instruksi ini hanya berlaku untuk stat, gauge, bar gauge, dan visualisasi tabel.

1. Pilih panel yang ingin Anda tambahkan ambang batas.

1. Pilih tab **Bidang**.

1. Pilih **Tambahkan ambang batas**.

   Grafana yang Dikelola Amazon menambahkan ambang batas dengan nilai numerik dan warna yang disarankan. 

1. Terima rekomendasi atau edit ambang batas baru.
   +  **Edit warna** - Pilih titik warna yang ingin Anda ubah, lalu pilih warna baru.
   +  **Edit nomor** — Pilih nomor yang ingin Anda ubah, lalu masukkan nomor baru.
   +  **Mode ambang batas - Pilih mode** untuk mengubahnya untuk semua ambang batas pada panel ini.

1. Pilih **Simpan** untuk menyimpan perubahan di dasbor.

## Menambahkan ambang batas ke panel grafik
<a name="add-a-threshold-to-a-graph-panel"></a>

Dalam visualisasi panel grafik, Anda dapat menggunakan ambang batas untuk menambahkan garis atau bagian arbitrer ke grafik agar lebih mudah dilihat saat grafik melewati ambang tertentu.

1. Pilih panel grafik yang ingin Anda tambahkan ambang batas.

1. Pada tab **Panel**, pilih **Ambang batas**.

1. Pilih **Tambahkan ambang batas**.

1. Isi kolom sebanyak yang Anda inginkan. Hanya bidang **T1** yang diperlukan.
   +  **T1** — Kedua nilai diperlukan untuk menampilkan ambang batas.
     +  **lt** atau **gt** — **Pilih** lt untuk kurang dari atau **gt** untuk lebih besar dari untuk menunjukkan ambang batas yang berlaku.
     +  **Nilai** — Masukkan nilai ambang batas. Ruang kerja Grafana menggambar garis ambang sepanjang sumbu y pada nilai itu.
   +  **Warna** — Pilih kondisi yang sesuai dengan warna, atau tentukan warna Anda sendiri.
     +  **kustom** - Anda menentukan warna isian dan warna garis.
     +  **kritis** - Isi dan warna garis merah.
     +  **peringatan** - Isi dan warna garis berwarna kuning.
     +  **ok** - Isi dan warna garis hijau.
   +  **Isi** - Pilih apakah pengisian ambang batas ditampilkan.
   +  **Baris** - Pilih apakah garis ambang ditampilkan.
   +  **Y-Axis** - Pilih **kiri** atau **kanan**.

1. Pilih **Simpan** untuk menyimpan perubahan di dasbor. 

## Menghapus ambang batas
<a name="delete-a-threshold"></a>

1. Pilih panel yang ingin Anda hapus ambang batas.

1. Pilih tab **Bidang**. (Atau, untuk panel grafik, pilih tab **Panel**.)

1. Pilih ikon tempat sampah di sebelah ambang batas yang ingin Anda hapus. 

1. Pilih **Simpan** untuk menyimpan perubahan di dasbor. 

# WindRose
<a name="windrose"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 WindRose Panel menerima data deret waktu mentah mengubah data dan memetakannya dalam WindRose bagan.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/windrose.png)


## Opsi
<a name="windrose-options"></a>

 WindRose Panel mendukung opsi berikut:
+ Frekuensi sumbu
+ Gaya sumbu (derajat atau kompas)
+ Skala (linier, persegi, log)

# Periksa panel
<a name="inspect-a-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Inspektur panel membantu Anda memahami dan memecahkan masalah panel Anda. Anda dapat memeriksa data mentah untuk panel ruang kerja Grafana apa pun, mengekspor data tersebut ke file nilai yang dipisahkan koma (CSV), melihat permintaan kueri, dan mengekspor panel dan data JSON. 

## UI inspektur panel
<a name="panel-inspector-ui"></a>

Inspektur panel menampilkan **Inspect: < NameOfPanelBeingInspected >** di bagian atas panel. Pilih panah di sudut kanan atas untuk memperluas atau mengurangi panel.

Inspektur panel terdiri dari empat tab:
+  **Tab data** - Menampilkan data mentah yang dikembalikan oleh kueri dengan transformasi yang diterapkan. Opsi bidang, seperti penggantian dan pemetaan nilai, tidak diterapkan secara default.
+  **Tab Statistik** - Menunjukkan berapa lama kueri Anda dan berapa banyak yang dikembalikan.
+  **Tab JSON** - Memungkinkan Anda untuk melihat dan menyalin panel JSON, panel data JSON, dan struktur bingkai data JSON. Ini berguna jika Anda menyediakan atau mengelola Grafana yang Dikelola Amazon.
+  **Tab kueri** — Menampilkan permintaan ke server yang dikirim saat Grafana Terkelola Amazon menanyakan sumber data.

**catatan**  
Tidak semua jenis panel mencakup keempat tab. Misalnya, panel daftar dasbor tidak memiliki data mentah untuk diperiksa, sehingga tidak menampilkan tab Statistik, Data, atau Kueri.

## Tugas inspektur panel
<a name="panel-inspector-tasks"></a>

Di inspektur panel, Anda dapat memeriksa panel, memeriksa dan mengunduh hasil kueri mentah, memeriksa kinerja kueri, melihat model JSON panel, dan melihat permintaan mentah dan respons ke sumber data.

### Buka inspektur panel
<a name="open-the-panel-inspector"></a>

Anda dapat memeriksa panel apa pun yang dapat Anda lihat.

1. Di konsol ruang kerja Grafana, pilih dasbor yang berisi panel yang ingin Anda periksa.

1. **Pilih judul panel yang ingin Anda periksa, lalu pilih Inspect.** Atau jeda di atas judul panel, lalu tekan **i**.

Panel inspektur panel terbuka di sisi kanan layar.

### Periksa hasil kueri mentah
<a name="inspect-raw-query-results"></a>

Lihat hasil kueri mentah dalam tabel. Ini adalah data yang dikembalikan oleh kueri dengan transformasi yang diterapkan dan sebelum panel menerapkan opsi bidang atau penggantian opsi bidang.

1. Buka inspektur panel, lalu pilih tab **Data**. Atau di menu panel, pilih **Inspect**, **Data**.

1. Jika panel Anda berisi beberapa kueri atau kueri beberapa node, Anda memiliki opsi tambahan.
+  **Pilih hasil** - Pilih data set hasil yang ingin Anda lihat.
+  **Mengubah data** 
  +  **Bergabung berdasarkan waktu** - Lihat data mentah dari semua kueri Anda secara bersamaan, dengan satu set hasil per kolom. Pilih judul kolom untuk menyusun ulang data.

  Lihat hasil kueri mentah dalam tabel dengan opsi bidang dan penggantian opsi diterapkan.

  1. Buka tab **Data** di inspektur panel.

  1. Di atas tabel, pilih **opsi tampilan Data**.

  1. Pilih tombol sakelar **Terapkan konfigurasi bidang**.

### Unduh hasil kueri mentah sebagai file CSV
<a name="download-raw-query-results-as-csv"></a>

Grafana Terkelola Amazon menghasilkan file CSV di lokasi unduhan browser default Anda. Anda dapat membukanya di pemirsa pilihan Anda.

1. Buka inspektur panel.

1. Periksa hasil query mentah seperti dijelaskan di atas. Sesuaikan pengaturan hingga Anda melihat data mentah yang ingin Anda ekspor.

1. Pilih **Unduh CSV**.

Untuk mengunduh file CSV yang diformat untuk Excel, perluas panel **Opsi data** dan aktifkan opsi **Unduh untuk Excel** sebelum Anda memilih **Unduh** CSV. 

### Periksa kinerja kueri
<a name="inspect-query-performance"></a>

Tab **Statistik** menampilkan statistik yang memberi tahu Anda berapa lama kueri Anda, berapa banyak kueri yang Anda kirim, dan jumlah baris yang dikembalikan. Informasi ini dapat membantu Anda memecahkan masalah pertanyaan Anda, terutama jika ada angka yang tiba-tiba tinggi atau rendah.

1. Buka inspektur panel.

1. Pilih tab **Statistik**.

Statistik ditampilkan dalam format read-only.

### Lihat model panel JSON
<a name="view-panel-json-model"></a>

Jelajahi dan ekspor panel, data panel, dan model JSON bingkai data.

1. Buka inspektur panel, lalu pilih tab **JSON**. Atau, di menu panel, pilih **Inspect**, **Panel JSON**. 

1. Di **Pilih sumber**, pilih salah satu opsi berikut:
   +  **Panel JSON** - Menampilkan objek JSON yang mewakili panel.
   +  **Data panel** - Menampilkan objek JSON yang mewakili data yang diteruskan ke panel. 
   +  **DataFrame struktur** - Menampilkan set hasil mentah dengan transformasi, konfigurasi bidang, dan penggantian yang diterapkan.

1. Anda dapat memperluas atau menciutkan bagian JSON untuk menjelajahinya, atau Anda dapat memilih **Salin ke clipboard** dan menempelkan JSON di aplikasi lain.

### Lihat permintaan mentah dan respons terhadap sumber data
<a name="view-raw-request-and-response-to-data-source"></a>

1. Buka panel inspektur, dan kemudian pilih tab **Query**. Atau, di menu panel, pilih **Inspect**, **Query**.

1. Pilih**Refresh**.

Grafana yang Dikelola Amazon mengirimkan kueri ke server untuk mengumpulkan informasi, dan kemudian menampilkan hasilnya. Anda dapat menelusuri bagian-bagian tertentu dari kueri, memperluas atau menciutkan semuanya, atau menyalin data ke clipboard untuk digunakan dalam aplikasi lain.

# Daftar perhitungan
<a name="list-of-calculations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Topik ini mencantumkan dan mendefinisikan perhitungan yang digunakan di Grafana Terkelola Amazon.

Di antara tempat-tempat lain, perhitungan ini digunakan di tab **Transform** dan bar gauge, gauge, dan visualisasi stat.


|  Penghitungan  |  Deskripsi  | 
| --- | --- | 
|  Semua nol  |  Benar ketika semua nilai nol  | 
|  Semua nol  |  Benar ketika semua nilai adalah 0  | 
|  Ubah hitungan  |  Berapa kali nilai bidang berubah  | 
|  Hitungan  |  Jumlah nilai dalam bidang  | 
|  kuala  |  Perubahan nilai kumulatif  | 
|  Perbedaan  |  Perbedaan antara nilai pertama dan terakhir dari suatu bidang  | 
|  Hitungan yang berbeda  |  Jumlah nilai unik dalam bidang  | 
|  Pertama (bukan null)  |  Pertama, bukan nilai null di bidang  | 
|  Maks  |  Nilai maksimum suatu bidang  | 
|  Berarti  |  Nilai rata-rata dari semua nilai dalam bidang  | 
|  Min  |  Nilai minimum suatu bidang  | 
|  Min (di atas nol)  |  Minimum, nilai positif dari suatu bidang  | 
|  Kisaran  |  Perbedaan antara nilai maksimum dan minimum bidang  | 
|  Langkah  |  Interval minimal antara nilai bidang  | 
|  Total  |  Jumlah semua nilai dalam bidang  | 

# Dasbor
<a name="dashboard-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 *Dasbor* adalah satu set dari satu atau lebih panel yang diatur dan disusun menjadi satu atau lebih baris. Grafana yang Dikelola Amazon dikirimkan dengan berbagai panel. Grafana yang Dikelola Amazon memudahkan pembuatan kueri yang tepat dan menyesuaikan properti tampilan sehingga Anda dapat membuat dasbor yang Anda butuhkan. Setiap panel dapat berinteraksi dengan data dari sumber data yang dikonfigurasi. 

## Kelola dasbor
<a name="manage-dashboards"></a>

 Untuk mengontrol periode waktu dasbor, Anda dapat menggunakan [Kontrol rentang waktu](dashboard-time-range-controls.md) di kanan atas dasbor. 

 Dasbor dapat menggunakan template dan variabel untuk membuatnya lebih dinamis dan interaktif. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md). 

 Dasbor dapat digunakan [Anotasi](dashboard-annotations.md) untuk menampilkan data peristiwa di seluruh panel. Ini dapat membantu mengkorelasikan data deret waktu di panel dengan peristiwa lain. 

 Dasbor dapat dibagikan dengan mudah dalam berbagai cara. Untuk informasi selengkapnya, lihat [Berbagi dasbor](share-a-dashboard.md). 

 Dasbor dapat ditandai, dan pemilih dasbor menyediakan akses cepat dan dapat dicari ke semua dasbor di organisasi tertentu. 

## Baris
<a name="dashboard-rows"></a>

 *Baris* adalah pembagi logis dalam dasbor. Ini digunakan untuk mengelompokkan panel bersama. 

 Baris selalu lebar 12 *unit*. Unit-unit ini secara otomatis diskalakan berdasarkan resolusi horizontal browser Anda. Anda dapat mengontrol lebar relatif panel dalam satu baris dengan mengatur lebar spesifiknya. 

 Grafana yang Dikelola Amazon menggunakan abstraksi unit untuk mengoptimalkan tampilan pada semua ukuran layar. 

**catatan**  
 Dengan MaxDataPoint fungsionalitas, Grafana Terkelola Amazon dapat menampilkan jumlah titik data yang diperlukan, terlepas dari resolusi atau rentang waktu. 

 Untuk menciutkan baris, pilih judul baris. Jika Anda menyimpan dasbor dengan baris yang diciutkan, dasbor disimpan dalam keadaan itu, dan grafik tersebut tidak dimuat sampai Anda memperluas baris. 

 Gunakan fungsi baris berulang untuk membuat atau menghapus seluruh baris panel secara dinamis, berdasarkan variabel template yang dipilih. 

# Anotasi
<a name="dashboard-annotations"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Anotasi menyediakan cara untuk menandai titik pada grafik dengan peristiwa kaya. Saat Anda menjeda anotasi, Anda dapat melihat deskripsi acara dan tag peristiwa. Bidang teks dapat menyertakan tautan ke sistem lain untuk lebih detail. 

## Anotasi asli
<a name="native-annotations"></a>

 Grafana Terkelola Amazon dilengkapi dengan penyimpanan anotasi asli dan kemampuan untuk menambahkan peristiwa anotasi langsung dari panel grafik. 

## Menambahkan anotasi
<a name="adding-annotations"></a>

 Untuk menambahkan anotasi, tekan **Ctrl atau **Cmd**** dan pilih di mana Anda ingin menambahkan anotasi. Untuk membuat anotasi dapat dicari dari dasbor lain, tambahkan tag ke dalamnya. 

### Menambahkan anotasi wilayah
<a name="adding-regions-events"></a>

 Untuk membuat anotasi untuk suatu wilayah, tekan **Ctrl** atau **Cmd** saat Anda memilih wilayah. 

### Kueri bawaan
<a name="annotation-built-in-query"></a>

 Setelah Anda menambahkan anotasi, itu tetap terlihat. Ini karena kueri anotasi bawaan ada di semua dasbor. Kueri anotasi ini mengambil semua peristiwa anotasi yang berasal dari dasbor saat ini dan menampilkannya di panel tempat kejadian tersebut dibuat. Ini termasuk anotasi riwayat status peringatan. Anda dapat menghentikan anotasi agar tidak diambil dan ditampilkan dengan memilih ikon **Setelan Dasbor** (roda gigi), memilih **Anotasi**, dan kemudian memodifikasi kueri bernama. `Annotations & Alerts (Built-in)` 

 Saat Anda menyalin dasbor menggunakan fitur **Save** As, dasbor baru memiliki ID dasbor baru, sehingga anotasi yang dibuat di dasbor sumber tidak terlihat pada salinan. Jika anotasi dasbor sumber memiliki tag untuk difilter, Anda dapat menampilkan anotasi pada salinan dengan menambahkan **Kueri Anotasi** baru dan memfilter berdasarkan tag. 

### Kueri dengan tag
<a name="annotation-query-by-tag"></a>

 ****Anda dapat membuat kueri anotasi baru yang mengambil anotasi dari penyimpanan anotasi asli dengan menggunakan sumber `-- Grafana --` data dan menyetel Filter menurut Tag.**** Tentukan setidaknya satu tag. Misalnya, buat kueri anotasi bernama`outages`, dan tentukan tag bernama`outage`. Kueri ini akan menampilkan semua anotasi yang Anda buat (dari dasbor apa pun atau melalui API) yang memiliki `outage` tag.

Secara default, jika Anda menambahkan beberapa tag dalam kueri anotasi, Grafana Terkelola Amazon hanya akan menampilkan anotasi yang memiliki semua tag yang Anda berikan. Untuk menampilkan anotasi yang berisi setidaknya satu tag yang Anda berikan, aktifkan **Cocokkan apa saja**. 

 Di Amazon Managed Grafana, dimungkinkan untuk menggunakan variabel template dalam kueri tag. Misalnya, jika Anda memiliki dasbor yang menampilkan statistik untuk layanan yang berbeda dan variabel templat yang mengontrol layanan mana yang akan ditampilkan, Anda dapat menggunakan variabel templat yang sama dalam kueri anotasi untuk menampilkan anotasi hanya untuk layanan tersebut. 

## Menanyakan sumber data lainnya
<a name="querying-other-data-sources"></a>

 Peristiwa anotasi diambil dengan menggunakan kueri anotasi. Untuk menambahkan kueri anotasi baru ke dasbor, pilih ikon **Pengaturan dasbor** (roda gigi), pilih`Annotations`, lalu pilih **Baru**. 

 Tentukan nama untuk kueri anotasi. Nama ini ditampilkan oleh kotak centang untuk menampilkan atau menyembunyikan peristiwa anotasi untuk kueri ini. Misalnya, Anda mungkin memiliki dua kueri anotasi bernama `Deploys` dan. `Outages` Anda dapat memilih atau menghapus kotak centang untuk menentukan anotasi mana yang akan ditampilkan. 

### Detail kueri anotasi
<a name="annotation-query-details"></a>

 Opsi kueri anotasi berbeda untuk setiap sumber data. 
+ [Anotasi menggunakan editor kueri Grafit](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [Anotasi menggunakan sumber OpenSearch data](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Anotasi menggunakan Prometheus](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [Anotasi menggunakan MySQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [Anotasi menggunakan PostgreSQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# Folder dasbor
<a name="dashboard-folders"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Folder adalah cara untuk mengatur dan mengelompokkan dasbor. Ini berguna jika Anda memiliki banyak dasbor atau jika beberapa tim menggunakan ruang kerja Grafana yang sama. 

## Membuat folder
<a name="how-to-create-a-folder"></a>

Untuk membuat folder, lakukan salah satu hal berikut:
+  Di menu samping, di bawah ikon \$1, pilih tautan **Buat Folder**. 
+  Pada halaman **Kelola Dasbor**, pilih tombol **Buat Folder**. 

 Pada halaman **Buat Folder**, masukkan nama unik untuk folder tersebut, lalu pilih **Buat**. 

Saat menyimpan dasbor, Anda dapat memilih folder yang ada atau membuat folder baru.

## Kelola dasbor
<a name="folders-manage-dashboards"></a>

 Pada halaman **Kelola Dasbor**, Anda dapat melakukan berbagai tugas: 
+  Buat folder. 
+  Buat dasbor. 
+  Pindahkan dasbor ke folder. 
+  Hapus beberapa dasbor. 
+  Arahkan ke halaman folder (tempat Anda dapat mengatur izin untuk folder atau dasbornya). 

## Halaman Folder Dasbor
<a name="dashboard-folder-page"></a>

 Untuk membuka halaman Folder Dasbor, pilih ikon roda gigi yang muncul saat Anda menjeda folder di daftar dasbor di hasil pencarian atau di halaman Kelola Dasbor. 

 Halaman Folder Dasbor mirip dengan halaman Kelola Dasbor. Pada halaman Folder Dasbor, Anda dapat melakukan tugas-tugas berikut: 
+  Memindahkan atau menghapus dasbor dalam folder. 
+  Ganti nama folder (pada tab **Pengaturan**). 
+  Tetapkan izin untuk folder (diwarisi oleh dasbor di folder). 

## Izin
<a name="folder-permissions"></a>

 Izin dapat ditetapkan ke folder dan diwarisi oleh dasbor yang dikandungnya. Daftar Kontrol Akses (ACL) digunakan di mana **Peran Organisasi**, **Tim**, dan **Pengguna** Individu dapat diberikan izin. Lihat informasi yang lebih lengkap di [Izin dasbor dan folder](dashboard-and-folder-permissions.md). 

# Daftar Putar
<a name="dashboard-playlist"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Daftar putar adalah daftar dasbor yang ditampilkan secara berurutan. Anda dapat menggunakan daftar putar untuk membangun kesadaran situasional atau untuk menyajikan metrik Anda kepada tim atau pengunjung Anda. 

 Grafana yang Dikelola Amazon secara otomatis menskalakan dasbor ke resolusi apa pun, termasuk layar besar. 

 Anda dapat mengakses fitur **Daftar Putar** dari menu samping, di submenu **Dasbor**. 

## Membuat daftar putar
<a name="create-a-playlist"></a>

 Daftar putar menyajikan dasbor secara berurutan, dengan urutan yang ditetapkan dan interval waktu antar dasbor. 

1.  Untuk mengakses fitur **Daftar Putar**, jeda di menu samping. 

1.  Pilih **Daftar Putar**. 

1.  Pilih **Daftar putar baru**. 

1.  Di kotak teks **Nama**, masukkan nama untuk daftar putar Anda. 

1.  Di kotak teks **Interval**, masukkan interval waktu. 

   Interval waktu adalah jumlah waktu bagi Grafana yang Dikelola Amazon untuk tetap berada di dasbor tertentu sebelum melanjutkan ke dasbor berikutnya di daftar putar. 

1.  Di samping setiap dasbor yang ingin Anda tambahkan ke daftar putar, pilih **Tambahkan ke daftar putar**. 

1.  Pilih **Buat**. 

## Mengedit daftar putar
<a name="edit-a-playlist"></a>

 Anda dapat mengedit daftar putar saat membuatnya atau setelah menyimpannya. 

1.  Untuk mengakses fitur Daftar Putar, jeda di menu samping. 

1.  Pilih **Daftar Putar**. 

1.  Pilih daftar putar yang ingin Anda edit. 

### Mengedit nama daftar putar
<a name="edit-the-name-of-a-playlist"></a>

1. Pilih kotak teks **Nama**.

1.  Edit namanya. 

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Mengedit interval daftar putar
<a name="edit-the-interval-of-a-playlist"></a>

1.  Pilih kotak teks **Interval**. 

1.  Edit intervalnya. 

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Menambahkan dasbor ke daftar putar
<a name="add-a-dashboard-to-a-playlist"></a>

1.  Di samping dasbor yang ingin Anda tambahkan, pilih **Tambahkan ke daftar putar**. 

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Mencari dasbor untuk ditambahkan
<a name="search-for-a-dashboard-to-add"></a>

1. Di bawah **Tambahkan dasbor**, pilih kotak teks **Cari dasbor berdasarkan nama**. 

1.  Masukkan nama atau ekspresi reguler. 

1. Jika perlu, filter hasil Anda berdasarkan status atau tag berbintang. Secara default, dasbor berbintang Anda muncul sebagai opsi untuk ditambahkan ke daftar putar.

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Mengatur ulang pesanan dasbor
<a name="rearrange-dashboard-order"></a>

1.  Di sebelah dasbor yang ingin Anda pindahkan, pilih panah atas atau bawah. 

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Menghapus dasbor
<a name="remove-a-dashboard"></a>

1.  Pilih ikon x untuk menghapus dasbor dari daftar putar. 

1.  Pilih **Simpan** untuk menyimpan perubahan Anda. 

### Menghapus daftar putar
<a name="delete-a-playlist"></a>

1.  Pilih **Daftar Putar**. 

1.  Di sebelah daftar putar yang ingin Anda hapus, pilih ikon x. 

## Menyimpan daftar putar
<a name="save-a-playlist"></a>

 Anda dapat menyimpan daftar putar untuk menambahkannya ke halaman **Daftar Putar** Anda, tempat Anda dapat memulainya. Pastikan untuk menambahkan semua dasbor yang ingin Anda tampilkan di daftar putar sebelum Anda menyimpannya. 

1.  Untuk mengakses fitur **Daftar Putar**, jeda di menu samping. 

1.  Pilih **Daftar Putar**. 

1.  Pilih daftar putar. 

1.  Edit daftar putar. 

   Pastikan daftar putar Anda memiliki **Nama**, **Interval**, dan setidaknya satu **Dasbor** yang ditambahkan ke dalamnya. 

1.  Pilih **Simpan**. 

## Memulai daftar putar
<a name="start-a-playlist"></a>

 Anda dapat memulai daftar putar dalam lima mode tampilan berbeda. Mode menentukan bagaimana menu dan bilah navigasi ditampilkan di dasbor. 

 Secara default, setiap dasbor ditampilkan untuk jumlah waktu yang dimasukkan di bidang **Interval**, yang dapat diatur saat membuat atau mengedit daftar putar. Setelah Anda memulai daftar putar, Anda dapat mengontrolnya dengan menggunakan navbar di bagian atas layar Anda. 

1.  Pada menu **Dasbor**, pilih Daftar **Putar**. 

1.  Di samping daftar putar yang ingin Anda mulai, pilih **Mulai daftar putar**. 

1.  Dalam daftar dropdown, pilih salah satu mode tampilan berikut: 
   +  **Modus normal** 
     +  Menu samping tetap terlihat. 
     +  Kontrol navbar, baris, dan panel muncul di bagian atas layar. 
   +  **Modus TV** 
     +  Menu samping disembunyikan atau dihapus. 
     +  Kontrol navbar, baris, dan panel muncul di bagian atas layar. 
     +  Mode TV dihidupkan secara otomatis setelah 1 menit pengguna tidak aktif. 
     +  Anda dapat mengaktifkan mode TV secara manual dengan menggunakan pintasan urutan **d v**, atau dengan menambahkan parameter `?inactive` ke URL dasbor. 
     +  Anda dapat menonaktifkan mode TV dengan gerakan mouse atau aksi keyboard apa pun. 
   +  **Mode TV (dengan panel auto fit)** 
     +  Menu samping disembunyikan atau dihapus. 
     +  Kontrol navbar, baris, dan panel muncul di bagian atas layar. 
     +  Panel dasbor secara otomatis menyesuaikan untuk mengoptimalkan ruang di layar. 
   +  **Mode kios** 
     +  Menu samping, navbar, baris, dan kontrol panel benar-benar tersembunyi atau dihapus dari tampilan. 
     +  Anda dapat mengaktifkan mode Kios secara manual dengan menggunakan pintasan urutan **d v** setelah daftar putar dimulai. 
     +  Anda dapat mematikan mode Kios secara manual dengan menggunakan pintasan yang sama. 
   +  **Mode kios (dengan panel auto fit):** 
     +  Menu samping, navbar, baris, dan kontrol panel benar-benar tersembunyi atau dihapus dari tampilan. 
     +  Panel dasbor secara otomatis menyesuaikan untuk mengoptimalkan ruang di layar. 

## Mengontrol daftar putar
<a name="control-a-playlist"></a>

 Anda dapat mengontrol daftar putar dalam mode **Normal** atau **TV** setelah dimulai dengan menggunakan bilah navigasi di bagian atas layar Anda. 


|  Tombol  |  Hasil  | 
| --- | --- | 
|  Berikutnya (panah kanan ganda)  |  Maju ke dasbor berikutnya.  | 
|  Kembali (panah kiri)  |  Kembali ke dasbor sebelumnya.  | 
|  Berhenti (persegi)  |  Mengakhiri daftar putar, dan keluar ke dasbor saat ini.  | 
|  Mode tampilan siklus (ikon monitor)  |  Mengubah tampilan dasbor ke mode tampilan yang berbeda.  | 
|  Rentang waktu  | Menampilkan data dalam rentang waktu. Ini dapat diatur untuk menampilkan 5 menit terakhir hingga 5 tahun yang lalu, atau rentang waktu khusus, menggunakan panah tarik-turun.  | 
|  Segarkan (panah lingkaran)  |  Muat ulang dasbor untuk menampilkan data saat ini. Ini dapat diatur untuk memuat ulang secara otomatis, dari setiap 5 detik hingga 1 hari, dengan menggunakan panah dropdown.  | 

 Untuk menghentikan daftar putar dari keyboard Anda, tekan **Esc**.

## Berbagi daftar putar dalam mode tampilan
<a name="share-a-playlist-in-a-view-mode"></a>

Anda dapat membagikan daftar putar dengan menyalin URL dalam mode tampilan yang Anda inginkan dan menempelkan URL ke tujuan Anda.

1.  Dari menu **Dasbor**, pilih Daftar **Putar**. 

1.  Di samping daftar putar yang ingin Anda bagikan, pilih **Mulai daftar putar**, lalu pilih mode tampilan yang Anda inginkan. 

1.  Untuk menyalin URL ke clipboard Anda, pilih **Salin Alamat Tautan**. 

    Misalnya, URL untuk daftar putar di situs Grafana Play dalam mode Kios bisa `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` 

1.  Tempelkan URL ke tujuan Anda. 

# Pencarian dasbor
<a name="dashboard-search"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Dasbor dapat dicari berdasarkan nama dasbor, difilter oleh satu (atau banyak) tag, atau difilter berdasarkan status bintang. Pencarian dasbor diakses melalui pemilih dasbor, tersedia di bilah navigasi atas dasbor. Pencarian dasbor juga dapat dibuka dengan menggunakan pintasan **F**. 

Saat hanya menggunakan keyboard, Anda dapat menggunakan tombol panah keyboard untuk menavigasi hasil, dan tekan **Enter** untuk membuka dasbor yang Anda inginkan. 

## Menemukan dengan nama dasbor
<a name="find-by-dashboard-name"></a>

Ketik bagian mana pun dari nama dasbor di bilah pencarian. Saat Anda mengetik, pencarian mengembalikan hasil untuk setiap kecocokan string paral secara real time. 

Pencarian dasbor adalah sebagai berikut:
+ Waktu nyata
+ Tidak peka huruf besar/kecil
+  Fungsional di seluruh dasbor yang disimpan dan berbasis file

## Pemfilteran berdasarkan tag
<a name="filter-by-tags"></a>

 Tag adalah cara yang berguna untuk mengatur dasbor Anda, terutama karena jumlah dasbor bertambah. Tag dapat ditambahkan dan dikelola di **Pengaturan** dasbor. 

 Untuk memfilter daftar dasbor berdasarkan tag, pilih tag apa pun yang muncul di kolom kanan. Anda dapat memfilter daftar lebih lanjut dengan memilih tag tambahan. 

Untuk melihat daftar semua tag yang tersedia, pilih menu dropdown **Filter by tags**. Saat Anda memilih tag, pencarian dasbor langsung difilter. 

Saat hanya menggunakan keyboard, tekan **Tab** untuk fokus pada tautan tag, tekan tombol panah bawah untuk menemukan tag, dan tekan **Enter** untuk memilih tag. 

**catatan**  
 Saat beberapa tag dipilih, Grafana Terkelola Amazon menampilkan dasbor yang menyertakan semua tag. 

# Berbagi dasbor
<a name="share-a-dashboard"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Untuk berbagi dasbor, pilih **Dasbor Bagikan** (ikon bagikan) di bilah navigasi atas. Ini membuka kotak dialog **Bagikan**, di mana Anda bisa mendapatkan tautan ke dasbor saat ini dengan rentang waktu dan variabel templat yang dipilih saat ini. Jika Anda telah membuat perubahan pada dasbor, pastikan untuk menyimpan perubahan tersebut sebelum Anda menyalin tautan. 

## Cuplikan dasbor
<a name="dashboard-snapshot"></a>

 Snapshot dasbor adalah cara instan untuk berbagi dasbor interaktif secara publik. Saat membuat snapshot, Grafana Terkelola Amazon menghapus data sensitif seperti kueri (metrik, templat, dan anotasi) dan tautan panel, hanya menyisakan data metrik yang terlihat dan nama seri yang disematkan di dasbor Anda. Snapshot dasbor dapat diakses oleh siapa saja yang memiliki tautan dan dapat mencapai URL. 

## Publikasikan snapshot
<a name="publish-snapshots"></a>

 Anda dapat mempublikasikan snapshot ke instans lokal Anda. 

# Berbagi panel
<a name="dashboard-share-a-panel"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Pilih judul panel untuk membuka menu panel, lalu pilih **Bagikan** di menu panel untuk membuka kotak dialog **Share Panel**. Anda dapat menyalin tautan, yang akan membawa Anda ke panel ini dengan rentang waktu saat ini dan variabel template yang dipilih. 

# Kontrol rentang waktu
<a name="dashboard-time-range-controls"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Grafana yang Dikelola Amazon menyediakan beberapa cara untuk mengelola rentang waktu data yang sedang divisualisasikan, baik di tingkat dasbor maupun di tingkat panel. 

 Topik ini menjelaskan unit waktu dan rentang relatif yang didukung, kontrol waktu umum, pengaturan waktu di seluruh dasbor, dan pengaturan waktu khusus panel. 

**catatan**  
Untuk memiliki kontrol waktu, data Anda harus menyertakan kolom waktu. Lihat dokumentasi untuk [sumber data](AMG-data-sources.md) spesifik Anda untuk informasi selengkapnya tentang menyertakan kolom waktu.

## Satuan waktu dan rentang relatif
<a name="time-units-and-relative-ranges"></a>

 Unit waktu berikut didukung: 
+ `s`(detik)
+ `m`(menit)
+ `h`(jam),
+ `d`(hari)
+ `w`(minggu)
+ `M`(bulan)
+ `y`(tahun)

 Gunakan operator minus untuk mundur dalam waktu, relatif terhadap sekarang. Untuk menampilkan periode penuh unit (seperti hari, minggu, atau bulan), tambahkan. `/<time unit>` 

 Gunakan operator plus untuk melangkah maju dalam waktu relatif terhadap sekarang. Anda dapat menggunakan fitur ini untuk melihat data yang diprediksi untuk masa depan. 

 Berikut ini adalah beberapa contohnya: 


|  Contoh rentang relatif  |  Dari  |  Ke  | 
| --- | --- | --- | 
|  5 menit terakhir  |  now-5m  |  now  | 
|  Hari sejauh ini  |  now/d  |  now  | 
|  Minggu ini  |  now/w  |  now/w  | 
|  Minggu hingga saat ini  |  now/w  |  now  | 
|  Bulan sebelumnya  |  now-1M/M  |  now-1M/M  | 

## Kontrol rentang waktu umum
<a name="common-time-range-controls"></a>

 Kontrol waktu dasbor dan panel memiliki antarmuka pengguna yang umum, dengan opsi berikut. 

### Rentang waktu saat ini
<a name="current-time-range"></a>

 Rentang waktu saat ini, juga disebut *pemilih waktu*, menunjukkan rentang waktu yang saat ini ditampilkan di dasbor atau panel yang Anda lihat. 

 Jeda di bidang untuk melihat stempel waktu yang tepat dalam rentang dan sumbernya, seperti browser lokal. 

 Untuk mengubah rentang waktu, pilih rentang waktu saat ini. Anda dapat mengubah waktu saat ini menggunakan *rentang waktu relatif*, seperti 15 menit terakhir, atau *rentang waktu absolut*, seperti`2020-05-14 00:00:00 to 2020-05-15 23:59:59`. 

### Rentang waktu relatif
<a name="relative-time-range"></a>

 Pilih rentang waktu relatif dari **Rentang waktu relatif** daftar. Berikut adalah beberapa contoh rentang waktu relatif: 
+  30 menit terakhir 
+  12 jam terakhir 
+  7 hari terakhir 
+  2 tahun terakhir 
+  Kemarin 
+  Sehari sebelum kemarin 
+  Hari ini minggu lalu 
+  Hari ini sejauh ini 
+  Minggu ini sejauh ini 
+  Bulan ini sejauh ini 

### Rentang waktu absolut
<a name="absolute-time-range"></a>

 Tetapkan rentang waktu absolut salah satu dari dua cara: 
+  Masukkan nilai di bidang **Dari** dan **Ke**. Anda dapat memasukkan nilai waktu yang tepat atau nilai relatif, seperti`now-24h`, dan kemudian memilih **Terapkan rentang waktu**. 
+  Pilih bidang **Dari** atau **Ke**. Grafana yang Dikelola Amazon menampilkan kalender. Pilih hari atau hari yang ingin Anda gunakan sebagai rentang waktu saat ini dan kemudian pilih **Terapkan rentang waktu**. 

 Grafana yang Dikelola Amazon juga menampilkan rentang absolut yang baru-baru ini digunakan. 

### Perkecil (Cmd\$1Z atau Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 Untuk melihat rentang waktu yang lebih besar di dasbor atau visualisasi panel, pilih ikon **Perkecil rentang waktu**. 

### Memperbesar (hanya untuk visualisasi grafik)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 Dalam visualisasi grafik, seret untuk memilih rentang waktu yang ingin Anda lihat. 

### Segarkan dasbor
<a name="refresh-dashboard"></a>

 Pilih ikon **dasbor Refresh** untuk menjalankan setiap kueri di dasbor segera dan menyegarkan visualisasi. Grafana yang Dikelola Amazon membatalkan permintaan yang tertunda saat penyegaran baru dimulai. 

 Secara default, Grafana yang Dikelola Amazon tidak secara otomatis menyegarkan dasbor. Kueri berjalan sesuai jadwal mereka sendiri sesuai dengan pengaturan panel. Namun, jika Anda ingin menyegarkan dasbor secara teratur, pilih panah bawah di sebelah ikon **dasbor Refresh**, lalu pilih interval penyegaran. 

## Pengaturan waktu dasbor
<a name="dashboard-time-settings"></a>

 Pengaturan waktu disimpan berdasarkan per dasbor. 

 Untuk mengakses pengaturan waktu dasbor, pilih ikon **Pengaturan dasbor** (roda gigi) di bagian atas layar. Pengaturan ada di bagian **Opsi Waktu** pada tab **Umum**. 
+  **Timezone** — Zona waktu lokal dari layanan atau sistem yang Anda pantau. Ini dapat membantu ketika Anda memantau sistem atau layanan yang beroperasi di beberapa zona waktu. 
  +  **Default** — Zona waktu default yang dipilih untuk profil pengguna, tim, atau organisasi. Jika tidak ada zona waktu yang ditentukan untuk profil pengguna, tim yang menjadi anggotanya, atau organisasi, Grafana yang Dikelola Amazon menggunakan waktu browser lokal. 
  +  **Waktu Browser** Zona waktu yang dikonfigurasi untuk browser yang sedang digunakan. Ini biasanya zona waktu yang diatur pada komputer. 
  +  **Waktu Universal Terkoordinasi — Zona waktu** standar ISO 8601, termasuk UTC. Untuk informasi selengkapnya, lihat [daftar zona waktu](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 
+  **Penyegaran otomatis** - Opsi yang dapat disesuaikan dengan waktu relatif dan pengaturan penyegaran otomatis. Entri dipisahkan dengan koma dan dapat berupa satuan waktu yang valid. 
+  **Sekarang tunda sekarang-** - Nilai penundaan waktu yang mengesampingkan nilai. `now` Paling umum, fitur ini digunakan untuk menghindari nilai nol dengan mengakomodasi penundaan yang diketahui dalam agregasi data. 
+  **Sembunyikan pemilih waktu** - Opsi untuk tidak menampilkan pemilih waktu. 

## Penggantian waktu panel dan pergeseran waktu
<a name="panel-time-overrides-and-timeshift"></a>

 Di[Opsi kueri](panel-queries.md#query-options), Anda dapat mengganti rentang waktu relatif untuk masing-masing panel, menyebabkannya berbeda dari apa yang dipilih di pemilih waktu dasbor di bilah navigasi atas. Anda dapat menampilkan metrik dari periode waktu atau hari yang berbeda secara bersamaan. 

## Mengontrol rentang waktu menggunakan URL
<a name="control-the-time-range-using-a-url"></a>

 Anda dapat mengontrol rentang waktu dasbor dengan memberikan parameter kueri berikut di URL dasbor: 
+  `from`— Mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms atau waktu relatif. Untuk informasi selengkapnya, lihat [Rentang waktu relatif](#relative-time-range). 
+  `to`— Mendefinisikan batas atas rentang waktu, yang ditentukan dalam zaman ms atau waktu relatif. Untuk informasi selengkapnya, lihat [Rentang waktu relatif](#relative-time-range). 
+  `time`dan `time.window` — Tentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam milidetik. Misalnya, `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000 

# Mengekspor dan mengimpor dasbor
<a name="dashboard-export-and-import"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Dasbor Grafana Terkelola Amazon dapat dengan mudah diekspor dan diimpor, baik dari UI atau dari [HTTP API] 

## Mengekspor dasbor
<a name="exporting-a-dashboard"></a>

 Dasbor diekspor dalam format JSON Grafana Terkelola Amazon, dan berisi semua yang Anda butuhkan, termasuk tata letak, variabel, gaya, sumber data, dan kueri, untuk mengimpor dasbor di lain waktu. 

 Fitur ekspor diakses di jendela bagikan, yang Anda buka dengan memilih tombol bagikan di menu dasbor.

### Membuat dasbor portabel
<a name="making-a-dashboard-portable"></a>

 Saat Anda mengekspor dasbor untuk digunakan orang lain, ada baiknya menambahkan variabel template untuk nilai seperti awalan metrik (gunakan variabel konstan) dan nama server. 

 Variabel template dari jenis `Constant` ini secara otomatis disembunyikan di dasbor. Itu juga ditambahkan sebagai input yang diperlukan saat dasbor diimpor. Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template dan variabel](templates-and-variables.md). 

## Mengimpor dasbor
<a name="importing-a-dashboard"></a>

 Untuk mengimpor dasbor, pilih ikon \$1 di menu samping, lalu pilih **Impor**. 

 Anda dapat mengunggah file JSON dasbor, menempelkan URL dasbor atau menempelkan teks JSON dasbor langsung ke area teks. 

 Pada langkah 2 proses impor, Anda dapat mengubah nama dasbor, menentukan sumber data yang ingin digunakan dasbor, dan menentukan awalan metrik apa pun (jika dasbor menggunakannya). 

## Temukan dasbor di Grafana.com
<a name="discover-dashboards-on-grafana.com"></a>

 Temukan dasbor untuk aplikasi server umum di [Grafana.com/dasbor](https://grafana.com/dashboards). 

# Riwayat versi dasbor
<a name="dashboard-version-history"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Setiap kali Anda menyimpan versi dasbor Anda, salinan versi itu disimpan sehingga versi dasbor Anda sebelumnya tidak hilang. Daftar versi ini tersedia dengan memilih **pengaturan Dasbor** dan kemudian memilih **Versi** di menu sebelah kiri. 

 Fitur riwayat versi dasbor memungkinkan Anda membandingkan dan mengembalikan ke versi dasbor yang disimpan sebelumnya. 

## Membandingkan dua versi dasbor
<a name="comparing-two-dashboard-versions"></a>

 Untuk membandingkan dua versi dasbor, pilih dua versi dari daftar yang ingin Anda bandingkan. Setelah Anda memilih dua versi, pilih **Bandingkan versi** untuk membuka tampilan diff. Secara default, Anda akan melihat ringkasan tekstual perubahan, seperti pada gambar berikut.

 Untuk melihat perbedaan JSON mentah yang mewakili dasbor Anda, pilih **Lihat JSON** Diff. 

 Untuk mengembalikan ke versi sebelumnya yang Anda bandingkan, pilih **Pulihkan ke versi**<x>.

## Memulihkan ke versi dasbor yang disimpan sebelumnya
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 Jika Anda perlu mengembalikan ke versi dasbor yang disimpan sebelumnya, Anda dapat melakukannya dengan memilih tombol “Pulihkan” di sebelah kanan baris dalam daftar versi dasbor atau dengan memilih **Pulihkan ke versi** yang <x>muncul di tampilan diff. Setelah Anda memilih untuk memulihkan, kotak pop-up akan meminta Anda untuk mengkonfirmasi pemulihan. 

 Setelah memulihkan ke versi sebelumnya, versi baru akan dibuat yang berisi data yang sama persis dengan versi sebelumnya, tetapi dengan nomor versi yang berbeda. Ini ditunjukkan di kolom **Catatan**. Ini membantu memastikan bahwa versi dasbor Anda sebelumnya tidak terpengaruh oleh perubahan. 

# Pintasan keyboard
<a name="keyboard-shortcuts"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Grafana yang Dikelola Amazon memiliki sejumlah pintasan keyboard yang tersedia. Untuk menampilkan semua pintasan keyboard yang tersedia di Grafana Terkelola Amazon versi Anda, **tekan** Shift \$1? pada keyboard Anda. 

 **Grafana yang Dikelola Amazon menyertakan pintasan populer berikut:** 
+  **Ctrl\$1S** menyimpan dasbor saat ini. 
+  **Ctrl\$1F membuka pencari** dasbor/pencarian. 
+  **Ctrl\$1H** menyembunyikan semua kontrol (menyembunyikan kontrol berfungsi dengan baik untuk tampilan TV). 
+  **Escape keluar dari** grafik saat dalam mode layar penuh atau edit. 

# Dasbor model JSON
<a name="dashboard-json-model"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Dasbor di Amazon Managed Grafana diwakili oleh objek JSON, yang menyimpan metadata dasbornya. Metadata dasbor mencakup properti dasbor, metadata dari panel, variabel template, dan kueri panel.

**Untuk melihat JSON dasbor**

1.  Buka dasbor. 

1.  Di bilah navigasi atas, pilih pada **Manage dashboard**. 

1.  Pilih **Lihat JSON** dari menu tarik-turun. 

## Bidang JSON
<a name="dashboard-json-fields"></a>

 Saat pengguna membuat dasbor baru, objek JSON dasbor baru diinisialisasi dengan bidang berikut. 

**catatan**  
 Dalam JSON berikut, `id` ditampilkan sebagai`null`, yang merupakan nilai default yang ditetapkan untuk itu sampai dashboard disimpan. Setelah Anda menyimpan dasbor, nilai integer ditetapkan ke `id` bidang. 

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

 Tabel berikut memberikan rincian penggunaan untuk setiap bidang di dashboard JSON. 


|  Nama  |  Penggunaan  | 
| --- | --- | 
|  id  |  Pengidentifikasi numerik unik untuk dasbor (dihasilkan oleh database).  | 
|  uid  |  Pengidentifikasi dasbor unik yang dapat dihasilkan oleh siapa saja. uidIni adalah string 8-40 karakter.  | 
|  judul  |  Judul dasbor saat ini.  | 
|  tag  |  Tag yang terkait dengan dasbor. Di JSON, tag adalah array string.  | 
|  style  |  Tema dasbor (misalnya, dark ataulight).  | 
|  timezone  |  Zona waktu dasbor (utcataubrowser).  | 
|  editable  |  Apakah dasbor dapat diedit.  | 
|  graphTooltip  |  Gaya tooltip. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  Rentang waktu untuk dasbor (misalnya, 6 jam terakhir, 7 hari terakhir).  | 
|  timepicker  |  Metadata timepicker. Untuk informasi selengkapnya, lihat [Pemetik waktu](#dashboard-json-timepicker).  | 
|  templating  |  Metadata template. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md).  | 
|  annotations  |  Metadata anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).  | 
|  refresh  |  Interval penyegaran otomatis.  | 
|  schemaVersion  |  Versi skema JSON (integer), yang bertambah setiap kali pembaruan Grafana Terkelola Amazon mengubah skema.  | 
|  version  |  Versi dasbor (integer), yang bertambah setiap kali dasbor diperbarui.  | 
|  panels  |  Array panel. Untuk informasi selengkapnya, lihat [Panel](#dashboard-JSON-panels).  | 

## Panel
<a name="dashboard-JSON-panels"></a>

 Panel adalah blok bangunan dasbor. Ini terdiri dari kueri sumber data, jenis grafik, alias, dan data lainnya. Panel JSON terdiri dari array objek JSON, masing-masing mewakili panel yang berbeda. Sebagian besar bidang umum untuk semua panel, tetapi beberapa bidang tergantung pada jenis panel. Contoh berikut menunjukkan panel JSON dari panel teks.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

### Ukuran dan posisi panel
<a name="panel-size-and-position"></a>

 `gridPos`Properti menggambarkan ukuran panel dan posisi dalam koordinat grid: 
+  `w`— 1-24. Lebar dasbor dibagi menjadi 24 kolom. 
+  `h`- Dalam satuan ketinggian grid. Setiap unit tinggi grid mewakili 30 piksel. 
+  `x`Posisi x. Posisi x menggunakan unit kolom yang sama dengan`w`. 
+  `y`Posisi y. Posisi y menggunakan satuan tinggi grid yang sama dengan`h`. 

 Grid memiliki gravitasi negatif yang menggerakkan panel ke atas jika ada ruang kosong di atas panel. 

### Pemetik waktu
<a name="dashboard-json-timepicker"></a>

Contoh berikut menunjukkan `timepicker` opsi.

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

 Tabel berikut memberikan rincian penggunaan untuk`timepicker`. 


|  Nama  |  Penggunaan  | 
| --- | --- | 
|  collapse  |  timepickerApakah runtuh  | 
|  enable  |  timepickerApakah diaktifkan  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

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

 `templating`Bidang berisi array variabel template dengan nilai yang disimpan dan metadata lainnya. Contoh berikut menunjukkan `templating` metadata. 

```
 "templating": {
    "enable": true,
    "list": [
      {
        "allFormat": "wildcard",
        "current": {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
          {
            "selected": false,
            "text": "All",
            "value": "*"
          },
          {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
          {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
      {
        "allFormat": "wildcard",
        "current": {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
          {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
          {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

 Tabel berikut menyediakan rincian penggunaan untuk bagian templating. 


|  Nama  |  Penggunaan  | 
| --- | --- | 
|  mengaktifkan  |  Apakah templating diaktifkan.  | 
|  daftar  |  Sebuah array objek, masing-masing mewakili satu variabel template  | 
|  AllFormat  |  Format yang akan digunakan saat mengambil semua nilai dari sumber data (misalnya,,wildcard, globregex, danpipe).  | 
|  saat ini  |  Menampilkan teks atau nilai variabel yang dipilih saat ini di dasbor  | 
|  sumber data  |  Menampilkan sumber data untuk variabel  | 
|  SertakanSemua  |  Apakah opsi semua nilai tersedia  | 
|  multi  |  Apakah beberapa nilai dapat dipilih dari daftar nilai variabel  | 
|  MultiFormat  |  Format yang akan digunakan saat mengambil timeseries dari sumber data  | 
|  name  |  Nama variabel  | 
|  options  |  Array text/value pasangan variabel tersedia untuk seleksi di dasbor  | 
|  query  |  Kueri sumber data yang digunakan untuk mengambil nilai untuk variabel  | 
|  menyegarkan  |  TODO  | 
|  regex  |  TODO  | 
|  jenis  |  Jenis variabel (custom,query, atauinterval)  | 

# Dasbor berskrip
<a name="scripted-dashboards"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

**Awas**  
 Fitur ini sudah usang dan akan dihapus di rilis mendatang. 

 Jika Anda memiliki banyak nama metrik yang berubah (misalnya, server baru) dalam pola yang ditentukan, akan memakan waktu untuk terus membuat dasbor baru. 

 Dengan dasbor skrip, Anda dapat membuat dasbor secara dinamis menggunakan. JavaScript Di folder instal Grafana, di bawah`public/dashboards/`, ada file bernama. `scripted.js` File ini berisi contoh dasbor skrip. Anda dapat mengaksesnya dengan menggunakan URL: `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` 

 Ketika Anda membuka`scripted.js`, Anda dapat melihat bagaimana membaca parameter URL dari `ARGS` variabel dan kemudian menambahkan baris dan panel. 

## Contoh: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## Lebih banyak contoh
<a name="more-examples"></a>

 Anda dapat menemukan lebih banyak contoh di `public/dashboards/` direktori instalasi Grafana Anda. 

# Jelajahi
<a name="explore"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Di ruang kerja Grafana, UI dasbor menyediakan alat untuk membangun dasbor untuk visualisasi. *Jelajahi* semua opsi dasbor dan panel sehingga Anda dapat fokus pada kueri. Ulangi sampai Anda memiliki kueri yang berfungsi, lalu rencanakan dan buat dasbor. 

 Untuk pemantauan infrastruktur dan respons insiden, Anda tidak perlu lagi beralih ke alat lain untuk men-debug apa yang salah. Anda dapat menggunakan Jelajahi untuk menggali lebih dalam metrik dan log Anda untuk menemukan penyebabnya.

 Jelajahi membuatnya lebih mudah untuk melihat data Anda tanpa membuat dasbor. Jika sumber data Anda mendukung data grafik dan tabel, Jelajahi menampilkan hasilnya baik sebagai grafik maupun sebagai tabel. Ini membantu Anda melihat tren dalam data dan detail lebih lanjut secara bersamaan. 

## Mulai menjelajah
<a name="start-exploring"></a>

**catatan**  
 Secara default, pengguna dengan peran Penampil tidak dapat mengedit dan tidak memiliki akses ke Jelajahi. 

 Ikon **Jelajahi** di menu sebelah kiri membuka tab Jelajahi kosong. 

 Untuk memulai dengan kueri yang ada di panel, pilih opsi **Jelajahi** dari menu **Panel**. Ini membuka tab Jelajahi yang berisi kueri dari panel. Anda kemudian dapat mengubah atau mengulangi kueri di luar dasbor Anda. 

 Pilih sumber data Anda dari daftar dropdown di kiri atas. Prometheus memiliki implementasi Explore khusus. Sumber data lainnya menggunakan editor kueri standar mereka. 

 Di bidang kueri, Anda dapat menulis kueri dan menjelajahi data Anda. Ada tiga tombol di samping bidang kueri, tombol bening (X), tombol tambahkan kueri (\$1) dan tombol hapus kueri (-). Seperti pada editor kueri panel, Anda dapat menambah dan menghapus beberapa kueri. 

## Memisahkan dan membandingkan
<a name="split-and-compare"></a>

 Fitur split view adalah cara untuk membandingkan grafik dan tabel side-by-side atau untuk melihat data terkait bersama-sama pada satu halaman. Pilih **Split** untuk menduplikasi kueri saat ini dan membagi halaman menjadi dua side-by-side kueri. Anda memiliki opsi untuk memilih sumber data yang berbeda untuk kueri baru. Ini memberi Anda kesempatan untuk membandingkan kueri yang sama untuk dua server yang berbeda atau untuk membandingkan lingkungan pementasan dengan lingkungan produksi. 

 Dalam tampilan terpisah, pemilih waktu untuk kedua panel dapat ditautkan (jika Anda mengubah satu, yang lain juga akan diubah) dengan memilih salah satu tombol sinkronisasi waktu yang dilampirkan ke pemilih waktu. Menautkan pemilih waktu membantu menjaga waktu mulai dan akhir kueri tampilan terpisah tetap sinkron, sehingga Anda melihat interval waktu yang sama di kedua panel terpisah. 

 Anda dapat menutup kueri yang baru dibuat dengan memilih **Close Split**.

## Berbagi tautan singkat
<a name="share-shortened-link"></a>

 Gunakan kemampuan **Share shortened link** untuk membuat format yang lebih kecil dan lebih sederhana URLs `/goto/:uid` daripada berbagi lebih lama URLs yang berisi parameter kueri kompleks. Anda dapat membuat tautan singkat dengan memilih opsi **Bagikan** di bilah alat Jelajahi. Setiap tautan singkat yang tidak pernah digunakan akan dihapus secara otomatis setelah 7 hari. 

## Riwayat kueri
<a name="query-history"></a>

 Riwayat kueri adalah daftar kueri yang telah Anda gunakan di Jelajahi. Riwayat bersifat lokal untuk browser Anda dan tidak dibagikan. Untuk membuka dan berinteraksi dengan riwayat Anda, pilih **Riwayat kueri** di Jelajahi. 

### Melihat riwayat kueri
<a name="view-query-history"></a>

 FIn riwayat kueri, Anda dapat melakukan hal berikut: 
+  Jalankan kueri. 
+  Buat atau edit komentar. 
+  Salin kueri ke clipboard. 
+  Salin tautan singkat dengan kueri ke clipboard. 
+  Bintangi kueri. 

### Mengelola pertanyaan favorit
<a name="manage-favorite-queries"></a>

 Semua kueri yang telah dibintangi di tab Riwayat kueri ditampilkan di tab Berbintang. Anda dapat mengakses kueri favorit Anda lebih cepat dan menggunakan kembali kueri tersebut tanpa mengetik ulang. 

### Urutkan riwayat kueri
<a name="sort-query-history"></a>

 Secara default, riwayat kueri menunjukkan kueri terbaru kepada Anda. Anda dapat mengurutkan riwayat Anda berdasarkan tanggal atau dengan nama sumber data dalam urutan naik atau turun. 

Di sisi kanan riwayat kueri, dalam daftar dropdown, pilih salah satu opsi berikut: bidang.
+  Terbaru pertama 
+  Tertua pertama 
+  Sumber data A-Z 
+  Sumber data Z-A 

**catatan**  
 Jika Anda berada dalam tampilan terpisah, mode penyortiran hanya berlaku untuk panel aktif. 

### Filter riwayat kueri
<a name="filter-query-history"></a>

 Pada tab **Query history** dan **Starred**, Anda dapat memfilter riwayat kueri berdasarkan nama sumber data. 

1. Pilih **Filter kueri untuk sumber data tertentu**.

1. Pilih sumber data yang ingin Anda gunakan untuk memfilter riwayat Anda. Anda dapat memilih beberapa sumber data.

Pada tab **Query history**, Anda dapat menggunakan slider vertikal untuk memfilter kueri berdasarkan tanggal:
+ Seret pegangan bawah untuk menyesuaikan tanggal mulai.
+ Seret pegangan atas untuk menyesuaikan tanggal akhir. 

**catatan**  
Jika Anda berada dalam tampilan terpisah, filter hanya diterapkan ke panel aktif. 

### Mencari di riwayat kueri
<a name="search-in-query-history"></a>

 Anda dapat mencari di riwayat Anda di seluruh kueri dan komentar Anda. Pencarian dimungkinkan untuk kueri di tab **Query history** dan **Starred**. 

1.  Pilih bidang **Permintaan pencarian**. 

1.  Di bidang pencarian, masukkan istilah pencarian Anda. 

### Pengaturan riwayat kueri
<a name="query-history-settings"></a>

 Anda dapat menyesuaikan riwayat kueri di tab **Pengaturan**. Tabel berikut mencantumkan opsi yang tersedia. 


|  Pengaturan  |  Nilai default  | 
| --- | --- | 
|  Tentukan berapa lama Grafana akan menyimpan riwayat kueri Anda.  |  1 minggu  | 
|  Ubah tab aktif default. |  Tab riwayat kueri  | 
|  Tampilkan kueri hanya untuk sumber data yang saat ini aktif di Jelajahi.  |  True  | 
|  Hapus riwayat kueri.  |  (Pilih Hapus riwayat kueri untuk menghapus semua kueri yang disimpan secara permanen.)  | 

**catatan**  
Pengaturan riwayat kueri bersifat global, dan diterapkan ke kedua panel dalam mode terpisah.

## Fitur khusus Prometheus
<a name="prometheus-specific-features"></a>

 Versi pertama Jelajahi menampilkan pengalaman kueri khusus untuk Prometheus. Saat Anda menjalankan kueri, Grafana sebenarnya menjalankan dua kueri: kueri Prometheus normal untuk grafik dan Kueri Instan untuk tabel. Kueri Instan mengembalikan nilai terakhir untuk setiap deret waktu, yang menunjukkan ringkasan data yang baik yang ditunjukkan dalam grafik. 

### Penjelajah metrik
<a name="metrics-explorer"></a>

 Di sisi kiri bidang kueri, pilih **Metrik** untuk membuka Metric Explorer. Ini menunjukkan menu hierarkis dengan metrik yang dikelompokkan berdasarkan awalan mereka. Misalnya, semua metrik Alertmanager dikelompokkan di bawah awalan. `alertmanager` Ini adalah titik awal yang baik untuk menjelajahi metrik mana yang tersedia. 

### Bidang kueri
<a name="query-field"></a>

 Bidang Kueri mendukung penyelesaian otomatis untuk nama metrik, fungsi, dan sebagian besar bekerja dengan cara yang sama seperti editor kueri Prometheus standar. Tekan **Enter** untuk menjalankan kueri. 

 Menu Autocomplete dapat diakses dengan menekan **Ctrl\$1Space**. Menu Pelengkapan Otomatis berisi bagian Riwayat baru dengan daftar kueri yang baru saja dijalankan. 

 Saran dapat muncul di bawah bidang Kueri. Pilih saran untuk memperbarui kueri Anda dengan perubahan yang disarankan. 
+  Untuk penghitung (metrik yang meningkat secara monoton), fungsi laju disarankan. 
+  Untuk ember, fungsi histogram disarankan. 
+  Untuk merekam aturan, mungkin untuk memperluas aturan.

### Filter tabel
<a name="table-filters"></a>

 Pilih tombol **Filter** di kolom **label** panel tabel untuk menambahkan filter ke ekspresi kueri. Anda dapat menambahkan filter untuk beberapa kueri juga. Filter ditambahkan untuk semua kueri. 

## Integrasi log
<a name="logs-integration"></a>

 Anda juga dapat menggunakan Jelajahi untuk menyelidiki log Anda dengan sumber data berikut: 
+  InfluxDB 
+  Elasticsearch 

### Visualisasi log
<a name="logs-visualization"></a>

 Hasil kueri log ditampilkan sebagai histogram dalam grafik, dan log individu ditampilkan di bawah ini. Jika sumber data tidak mengirim data histogram untuk rentang waktu yang diminta, model log menghitung deret waktu berdasarkan jumlah baris log yang diselimuti oleh interval waktu yang dihitung secara otomatis. Awal histogram kemudian ditambatkan oleh stempel waktu baris log pertama dari hasilnya. **Akhir dari deret waktu berlabuh ke rentang To picker waktu.** 

#### Tingkat log
<a name="log-level"></a>

 Untuk log di mana label **level** ditentukan, Grafana menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, Grafana mem-parsing log untuk mengetahui apakah kontennya cocok dengan ekspresi yang didukung. Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang **tidak diketahui**. Tabel berikut mencantumkan tingkat log dan pemetaan singkatan dan ekspresi tingkat log. 


|  Ekspresi yang didukung  |  Tingkat log  |  Warna  | 
| --- | --- | --- | 
|  muncul  |  kritis  |  ungu  | 
|  mematikan  |  kritis  |  ungu  | 
|  pemberitahuan  |  kritis  |  ungu  | 
|  kritikan  |  kritis  |  ungu  | 
|  kritis  |  kritis  |  ungu  | 
|  keliru  |  kesalahan  |  merah  | 
|  eror  |  kesalahan  |  merah  | 
|  kesalahan  |  kesalahan  |  merah  | 
|  menegur  |  memperingati  |  kuning  | 
|  memperingati  |  memperingati  |  kuning  | 
|  info  |  info  |  hijau  | 
|  informasi  |  info  |  hijau  | 
|  melihat  |  info  |  hijau  | 
|  dbug  |  debug  |  biru  | 
|  debug  |  debug  |  biru  | 
|  jejak  |  jejak  |  biru muda  | 
|  \$1  |  tidak diketahui  |  abu-abu  | 

### Opsi visualisasi
<a name="visualization-options"></a>

 Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan. 

#### Waktu
<a name="visualization-options-time"></a>

 Opsi ini menunjukkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang dikaitkan dengan baris log seperti yang dilaporkan dari sumber data. 

#### Label unik
<a name="visualization-options-unique-labels"></a>

 Opsi ini menampilkan atau menyembunyikan kolom label unik, yang hanya mencakup label yang tidak umum. Semua label umum ditampilkan di atas.

#### Bungkus garis
<a name="visualization-options-wrap-lines"></a>

 Untuk menggunakan pembungkus baris di layar, atur ini ke **True**. Menyetel opsi ini ke Hasil **False** dalam pengguliran horizontal. 

#### Deduping
<a name="visualization-options-deduping"></a>

 Data log bisa sangat berulang. Jelajahi dapat membantu dengan menyembunyikan baris log duplikat. Anda dapat memilih dari algoritma deduplikasi yang berbeda: 
+  **Tepat** - Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal. 
+  **Angka** — Pertandingan dilakukan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya. 
+  **Tanda tangan** — Deduping yang paling agresif, ini menghapus semua huruf dan angka. Pertandingan dilakukan pada spasi dan tanda baca yang tersisa. 

#### Balik urutan hasil
<a name="visualization-options-flip-results-order"></a>

 Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama). 

### Label dan bidang yang terdeteksi
<a name="labels-and-detected-fields"></a>

 Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Untuk semua label, Anda dapat memfilter (filter positif) dan menyaring (filter negatif) label yang dipilih. Setiap bidang atau label juga memiliki ikon statistik untuk menampilkan statistik satu kali dalam kaitannya dengan semua log yang ditampilkan. 

### Alihkan bidang yang terdeteksi
<a name="toggle-detected-fields"></a>

 Jika log Anda terstruktur di JSON atau logfmt, Anda dapat menampilkan atau menyembunyikan bidang yang terdeteksi. Perluas garis log, lalu pilih ikon mata untuk menampilkan atau menyembunyikan bidang. 

 \$1\$1< docs-imagebox img=”/img/docs/explore/parsed-fields-7-2.gif "max-width="800px” caption="Mengalihkan bidang yang terdeteksi di Jelajahi” >\$1\$1 

## Menelusuri integrasi
<a name="tracing-integration"></a>

 Anda dapat memvisualisasikan jejak dari melacak sumber data di Jelajahi. Sumber data yang saat ini didukung: 
+ [Connect ke sumber data Jaeger](jaeger-data-source.md) 
+ [Connect ke sumber data Tempo](tempo-data-source.md) 
+ [Connect ke sumber AWS X-Ray data](x-ray-data-source.md) 
+ [Connect ke sumber data Zipkin](zipkin-data-source.md) 

 Untuk informasi tentang penggunaan editor kueri, lihat dokumentasi untuk sumber data tertentu. 

### Header
<a name="explore-header"></a>

Header mencakup item berikut:
+  Judul header, yang menunjukkan nama rentang root dan ID jejak 
+  Penelusuran, yang menyoroti rentang yang berisi teks yang dicari 
+  Metadata tentang jejak 

### Minimap
<a name="explore-minimap"></a>

 Minimap menunjukkan tampilan kental atau garis waktu jejak. Seret mouse Anda ke minimap untuk memperbesar ke rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Jika Anda berhenti di minimap, saat diperbesar, Anda dapat melihat tombol **Reset Selection, yang mengatur ulang** zoom. 

### Jadwal
<a name="explore-timeline"></a>

 Garis waktu menunjukkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen berikut: 
+ **Perluas tombol anak**: Memperluas atau menciutkan semua rentang anak dari rentang yang dipilih 
+ Nama layanan: Nama layanan yang mencatat rentang
+ Nama operasi: Nama operasi yang diwakili oleh rentang ini
+ Bilah durasi rentang: Representasi visual dari durasi operasi dalam jejak

Memilih di mana saja pada baris rentang menunjukkan detail rentang. 

### Rincian rentang
<a name="explore-span-details"></a>

Rincian rentang mencakup item-item berikut:
+  Nama operasi 
+  Metadata rentang 
+  Tag (tag apa pun yang terkait dengan rentang ini) 
+  Metadata proses (metadata tentang proses yang mencatat rentang ini) 
+  Log: Daftar log yang dicatat oleh rentang ini dan nilai kunci terkait. Dalam kasus Zipkin log bagian menunjukkan anotasi Zipkin. 

## Menavigasi antara Jelajahi dan dasbor
<a name="navigating-between-explore-and-a-dashboard"></a>

 Untuk membantu mempercepat alur kerja yang melibatkan peralihan secara teratur dari Explore ke dasbor dan sebaliknya, kami telah menambahkan kemampuan untuk kembali ke dasbor asal setelah menavigasi ke Explore dari menu tarik-turun panel. 

 Setelah Anda menavigasi ke Explore, Anda akan melihat tombol “Kembali” di toolbar Jelajahi. 

 Cukup memilih tombol akan mengembalikan Anda ke dasbor asal, atau, jika Anda ingin membawa perubahan yang Anda buat di Jelajahi kembali ke dasbor, cukup pilih panah di sebelah tombol untuk menampilkan item menu “Kembali ke panel dengan perubahan”. 

## Inspektur permintaan
<a name="query-inspector"></a>

 Untuk membantu men-debug kueri, Explore memungkinkan Anda untuk menyelidiki permintaan dan tanggapan kueri, serta statistik kueri, melalui inspektur Query. Fungsionalitas ini mirip dengan tab inspektur panel **Stats** dan tab **Query**. Lihat informasi yang lebih lengkap di [Periksa kinerja kueri](inspect-a-panel.md#inspect-query-performance) dan [Lihat permintaan mentah dan respons terhadap sumber data](inspect-a-panel.md#view-raw-request-and-response-to-data-source). 

# Menautkan
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Anda dapat menggunakan tautan untuk menavigasi antara dasbor yang umum digunakan atau untuk menghubungkan orang lain ke visualisasi Anda. Tautan memungkinkan Anda membuat pintasan ke dasbor, panel, dan bahkan situs web eksternal lainnya. 

 Grafana yang Dikelola Amazon mendukung tautan dasbor, tautan panel, dan tautan data. Tautan dasbor ditampilkan di bagian atas dasbor. Tautan panel dapat diakses dengan memilih ikon di sudut kiri atas panel. 

## Tautan mana yang harus Anda gunakan?
<a name="which-link-should-you-use"></a>

 Mulailah dengan memeriksa bagaimana Anda saat ini menavigasi antar dasbor. Jika Anda sering melompat di antara satu set dasbor dan berjuang untuk menemukan konteks yang sama di masing-masing, tautan dapat membantu mengoptimalkan alur kerja Anda. 

 Langkah selanjutnya adalah mencari tahu jenis tautan mana yang tepat untuk alur kerja Anda. Meskipun semua jenis tautan di Grafana digunakan untuk membuat pintasan ke dasbor lain atau situs web eksternal, mereka bekerja dalam konteks yang berbeda. 
+  Untuk menambahkan tautan yang berhubungan dengan sebagian besar atau semua panel di dasbor, gunakan[Tautan dasbor](dashboard-links.md). 
+  Untuk menelusuri panel tertentu, gunakan[Tautan panel](panel-links.md).
+  Untuk menautkan ke situs eksternal, Anda dapat menggunakan tautan dasbor atau tautan panel. 
+  Untuk menelusuri seri tertentu, atau bahkan pengukuran tunggal, gunakan[Tautan data](data-links.md). 

## Mengontrol rentang waktu menggunakan URL
<a name="controlling-time-range-using-the-url"></a>

 Anda dapat mengontrol rentang waktu panel atau dasbor dengan memberikan parameter kueri berikut di URL dasbor: 
+  `from`mendefinisikan batas bawah rentang waktu, ditentukan dalam ms epoch. 
+  `to`mendefinisikan batas atas rentang waktu, ditentukan dalam ms epoch. 
+  `time`dan `time.window` menentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam milidetik. Misalnya, `?time=1500000000000&time.window=10000` akan menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000 

# Tautan dasbor
<a name="dashboard-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Saat Anda membuat tautan dasbor, Anda dapat menyertakan rentang waktu dan variabel template saat ini untuk langsung melompat ke konteks yang sama di dasbor lain. Ini membantu memastikan bahwa orang yang Anda kirimi tautan melihat data yang tepat. Untuk jenis tautan lainnya, lihat[Variabel tautan data](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

 Setelah Anda menambahkan tautan dasbor, itu muncul di sudut kanan atas dasbor Anda. 

## Menambahkan tautan ke dasbor
<a name="add-links-to-dashboards"></a>

 Tambahkan tautan ke dasbor lain di bagian atas dasbor Anda saat ini. 

1.  Saat melihat dasbor tempat Anda ingin menambahkan tautan, pilih ikon roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**. 

1.  Pilih **Tautan**, lalu pilih **Tambahkan Tautan Dasbor** atau **Baru**. 

1.  Di **Type**, pilih **dasbor**. 

1.  Pilih opsi tautan: 
   +  **Dengan tag** - Masukkan tag untuk membatasi dasbor yang ditautkan hanya dengan tag yang Anda masukkan. Jika tidak, ruang kerja Grafana menyertakan tautan ke semua dasbor lainnya. 
   +  **Sebagai dropdown** - Pilih opsi ini jika Anda menautkan ke banyak dasbor, dan tambahkan judul opsional ke daftar dropdown. Jika opsi ini tidak dipilih, ruang kerja Grafana menampilkan tautan dasbor berdampingan di bagian atas dasbor Anda. 
   +  **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna memilih tautan, dasbor yang ditautkan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan.
   +  **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna memilih tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan.
   +  **Buka di tab baru** - Pilih opsi ini untuk membuka tautan dasbor di tab atau jendela baru. 

1.  Pilih **Tambahkan**. 

## Menambahkan tautan URL ke dasbor
<a name="add-a-url-link-to-a-dashboard"></a>

 Tambahkan tautan ke URL di bagian atas dasbor Anda saat ini. Anda dapat menautkan ke URL apa pun yang tersedia, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan bahwa pengguna melihat data spesifik di ruang kerja Grafana. 

1.  Saat melihat dasbor yang ingin Anda tautkan, pilih ikon roda gigi di bagian atas layar untuk membuka **pengaturan Dasbor**. 

1.  Pilih **Tautan**, lalu pilih **Tambahkan Tautan Dasbor** atau **Baru**. 

1.  Di **Ketik**, pilih **tautan**. 

1.  Pilih opsi tautan: 
   +  **Url** — Masukkan URL yang ingin Anda tautkan. Bergantung pada target, Anda mungkin ingin menyertakan nilai bidang.
   +  **Judul** — Masukkan judul yang Anda ingin tautannya ditampilkan. 
   +  **Tooltip** - Masukkan tooltip yang ingin ditampilkan tautan saat pengguna berhenti di atasnya. 
   +  **Ikon** - Pilih ikon yang ingin Anda tampilkan dengan tautan. 
   +  **Rentang waktu** - Pilih opsi ini untuk menyertakan rentang waktu dasbor di tautan. Saat pengguna memilih tautan, dasbor yang ditautkan terbuka dengan rentang waktu yang ditunjukkan sudah ditetapkan. 
     +  `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms. 
     +  `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam epoch ms. 
     +  `time`dan `time.window` menentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam milidetik. Misalnya, `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000. 
   +  **Nilai variabel** - Pilih opsi ini untuk menyertakan variabel template yang saat ini digunakan sebagai parameter kueri di tautan. Saat pengguna memilih tautan, templat apa pun yang cocok di dasbor tertaut disetel ke nilai dari tautan; misalnya, https://play.grafana. org/d/000000074/alerting? var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1 jam 
   +  **Buka di tab baru** - Pilih opsi ini untuk membuka tautan dasbor di tab atau jendela baru. 

1.  Pilih **Tambahkan**. 

## Memperbarui tautan dasbor
<a name="update-a-dashboard-link"></a>

 Untuk mengubah atau memperbarui tautan dasbor yang ada, gunakan prosedur berikut. 

1.  Di **Pengaturan Dasbor**, pada tab **Tautan**, pilih tautan yang ada yang ingin Anda edit. 

1.  Ubah pengaturan, lalu pilih **Perbarui**. 

## Menduplikasi tautan dasbor
<a name="duplicate-a-dashboard-link"></a>

 Untuk menduplikasi tautan dasbor yang ada, pilih ikon duplikat di sebelah tautan yang ada yang ingin Anda duplikat. 

## Menghapus tautan dasbor
<a name="delete-a-dashboard-link"></a>

 Untuk menghapus tautan dasbor yang ada, pilih ikon tempat sampah untuk tautan yang ingin Anda hapus. 

# Tautan panel
<a name="panel-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Setiap panel dapat memiliki rangkaian tautannya sendiri yang ditampilkan di sudut kiri atas panel. Anda dapat menautkan ke semua yang tersedia URLs, termasuk dasbor, panel, atau situs eksternal. Anda bahkan dapat mengontrol rentang waktu untuk memastikan pengguna melihat data spesifik di ruang kerja Grafana. 

Pilih ikon di sudut kiri atas panel untuk melihat tautan panel yang tersedia. 

## Menambahkan tautan panel
<a name="add-a-panel-link"></a>

1.  Jeda pada panel yang ingin Anda tambahkan tautannya, lalu tekan **e**. **Atau pilih panah tarik-turun di sebelah judul panel, lalu pilih Edit.** 

1.  Pada tab **Panel**, gulir ke bawah ke bagian **Tautan**. 

1.  Perluas **Tautan**, lalu pilih **Tambahkan tautan**. 

1.  Masukkan **Judul** untuk tautan. Judul akan ditampilkan di UI. 

1.  Masukkan **URL** yang ingin Anda tautkan. Anda dapat menyertakan salah satu variabel template yang didefinisikan di dasbor. Tekan **Ctrl\$1Spasi** atau **Cmd\$1Spasi**, lalu pilih bidang **URL** untuk melihat variabel yang tersedia. Ketika Anda menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan. Anda juga dapat menggunakan variabel waktu 
   +  `from`mendefinisikan batas bawah rentang waktu, yang ditentukan dalam epoch ms. 
   +  `to`mendefinisikan batas atas rentang waktu, yang ditentukan dalam epoch ms. 
   +  `time`dan `time.window` menentukan rentang waktu dari `time-time.window/2` ke`time+time.window/2`. Kedua parameter harus ditentukan dalam milidetik. Misalnya, `?time=1500000000000&time.window=10000` menghasilkan rentang waktu 10 detik dari 1499999995000 hingga 1500000005000. 

1.  Untuk membuka di tab baru, pilih **Buka di tab baru**. 

1.  Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

## Memperbarui tautan panel
<a name="update-a-panel-link"></a>

1.  Pada tab **Panel**, temukan tautan yang ingin Anda ubah. 

1.  Pilih ikon **Edit** (pensil) untuk membuka jendela **Edit link**. 

1.  Buat perubahan yang diperlukan. 

1.  Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

## Menghapus tautan panel
<a name="delete-a-panel-link"></a>

1.  Pada tab **Panel**, temukan tautan yang ingin Anda hapus. 

1.  Pilih ikon **X** di sebelah tautan yang ingin Anda hapus. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

# Tautan data
<a name="data-links"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Tautan data memberikan konteks yang lebih terperinci ke tautan Anda. Anda dapat membuat tautan yang menyertakan nama seri atau bahkan nilainya. Misalnya, jika visualisasi Anda menunjukkan empat server, Anda dapat menambahkan tautan data ke satu atau dua server. 

 Tautan itu sendiri dapat diakses dengan berbagai cara, tergantung pada visualisasi. Untuk panel grafik, Anda harus memilih titik atau garis data. Untuk panel seperti stat, gauge, atau bar gauge, Anda dapat memilih di mana saja pada visualisasi untuk membuka menu konteks. 

 Anda dapat menggunakan variabel dalam tautan data untuk mengirim orang ke dasbor terperinci dengan filter data yang diawetkan. Misalnya, Anda dapat menggunakan variabel untuk menentukan rentang waktu, seri, dan pemilihan variabel. Untuk informasi selengkapnya, lihat [Variabel tautan data](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

## Saran Typeahead
<a name="typeahead-suggestions"></a>

 Saat Anda membuat atau memperbarui tautan data, tekan **Ctrl\$1Spasi atau Cmd\$1Spasi** **Cmd\$1Spasi** pada keyboard Anda untuk membuka saran typeahead agar lebih mudah menambahkan variabel ke URL Anda. 

## Menambahkan tautan data
<a name="add-a-data-link"></a>

1.  Jeda pada panel yang ingin Anda tambahkan tautannya, lalu tekan **e**. **Atau pilih panah tarik-turun di sebelah judul panel, lalu pilih Edit.** 

1.  Pada tab **Bidang**, gulir ke bawah ke bagian **Tautan data**. 

1.  Perluas **tautan Data**, lalu pilih **Tambahkan tautan**. 

1.  Masukkan **Judul** untuk tautan. Judul akan ditampilkan di UI. 

1.  Masukkan **URL** yang ingin Anda tautkan. 

    Anda dapat menambahkan salah satu variabel template yang didefinisikan di dasbor. Pilih bidang **URL**, lalu ketik **\$1**, atau tekan **** Ctrl\$1Spasi atau **Cmd\$1Spasi** untuk melihat daftar variabel yang tersedia. Ketika Anda menambahkan variabel template ke link panel Anda, link mengirim pengguna ke konteks yang tepat, dengan variabel yang relevan sudah ditetapkan. Untuk informasi selengkapnya, lihat [Variabel tautan data](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

1.  Untuk membuka di tab baru, pilih **Buka di tab baru**. 

1.  Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

## Memperbarui tautan data
<a name="update-a-data-link"></a>

1.  Pada tab **Bidang**, temukan tautan yang ingin Anda ubah. 

1.  Pilih ikon **Edit** (pensil) untuk membuka jendela **Edit link**. 

1.  Buat perubahan yang diperlukan. 

1.  Pilih **Simpan** untuk menyimpan perubahan dan menutup jendela. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

## Menghapus tautan data
<a name="delete-a-data-link"></a>

1.  Pada tab **Bidang**, temukan tautan yang ingin Anda hapus. 

1.  Pilih ikon **X** di sebelah tautan yang ingin Anda hapus. 

1.  Pilih **Simpan** di kanan atas untuk menyimpan perubahan Anda ke dasbor. 

## Variabel tautan data
<a name="data-link-variables"></a>

 Anda dapat menggunakan variabel dalam tautan data untuk melihat bidang seri, label, dan nilai. Untuk informasi selengkapnya tentang tautan data, lihat[Tautan data](data-links.md). 

 Untuk melihat daftar variabel yang tersedia, masukkan **\$1** di bidang **URL** tautan data. 

 Anda juga dapat menggunakan variabel template di tautan data Anda URLs. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md). 

### Variabel panel rentang waktu
<a name="time-range-panel-variables"></a>

 Anda dapat menggunakan variabel berikut untuk memasukkan rentang waktu saat ini di URL tautan data: 
+  `__url_time_range`— Rentang waktu dasbor saat ini; misalnya, `?from=now-6h&to=now` 
+  `$__from and $__to`— Untuk informasi selengkapnya, lihat [Variabel global] (\$1\$1< relref “.. /variables/variable-types/global-variables.md \$1\$1\$1from -and-\$1\$1to” >\$1\$1). 

### Variabel seri
<a name="series-variables"></a>

 Variabel spesifik seri tersedia di bawah namespace: `__series` 
+  `__series.name`— Menambahkan nama seri ke URL 
+  `__series.labels.<LABEL>`— Menambahkan nilai label ke URL. Jika label Anda berisi titik, gunakan `__series.labels["<LABEL>"]` sintaks. 

### Variabel bidang
<a name="field-variables"></a>

 Variabel khusus bidang tersedia di bawah namespace: `__field` 
+  `__field.name`— Nama bidang 

### Variabel nilai
<a name="value-variables"></a>

 Variabel spesifik nilai tersedia di bawah namespace: `__value` 
+  `__value.time`— Stempel waktu nilai (Unix ms epoch) ke URL; misalnya, `?time=1560268814105` 
+  `__value.raw`— Nilai mentah 
+  `__value.numeric`— Representasi numerik dari suatu nilai 
+  `__value.text`— Representasi teks dari suatu nilai 
+  `__value.calc`— Nama perhitungan jika nilainya adalah hasil perhitungan 

### Variabel template
<a name="template-variables"></a>

 Saat menautkan ke dasbor lain yang menggunakan variabel template, pilih nilai variabel untuk siapa pun yang memilih tautan. 

 Gunakan`var-myvar=${myvar}`, di mana `myvar` adalah nama variabel template yang cocok dengan satu di dasbor saat ini yang ingin Anda gunakan. 

 Untuk menambahkan semua variabel dasbor saat ini ke URL, gunakan`__all_variables`. 

# Template dan variabel
<a name="templates-and-variables"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Variabel adalah placeholder untuk suatu nilai. Anda dapat menggunakan variabel dalam kueri metrik dan judul panel. Variabel memberi Anda kemampuan untuk membuat dasbor yang lebih interaktif dan dinamis. Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. 

Variabel ditampilkan sebagai daftar dropdown di bagian atas dasbor. Saat Anda mengubah nilai dengan menggunakan daftar tarik-turun di bagian atas dasbor, kueri metrik panel Anda mencerminkan nilai baru. 

Ini dapat sangat berguna bagi administrator yang ingin memungkinkan pemirsa menyesuaikan visualisasi dengan cepat tetapi tidak ingin memberi mereka izin pengeditan penuh. Pemirsa Grafana dapat menggunakan variabel. 

Dengan menggunakan variabel dan template, Anda dapat dasbor sumber tunggal. Jika Anda memiliki beberapa sumber data atau server yang identik, Anda dapat membuat satu dasbor dan menggunakan variabel untuk mengubah apa yang Anda lihat. Ini menyederhanakan pemeliharaan dan pemeliharaan. 

Untuk daftar tipe variabel yang didukung, dan petunjuk untuk menambahkan setiap jenis variabel, lihat [Jenis variabel](variables-types.md)

## Template
<a name="templates"></a>

 *Template* adalah kueri yang berisi variabel. 

Misalnya, jika Anda mengelola dasbor untuk memantau beberapa server, Anda dapat membuat dasbor untuk setiap server. Atau Anda bisa membuat satu dasbor dan menggunakan panel dengan kueri template, seperti yang ditunjukkan pada contoh berikut. 

```
wmi_system_threads{instance=~"$server"}
```

Nilai variabel selalu disinkronkan ke URL dengan menggunakan sintaks`var-<varname>=value`. 

## Praktik terbaik variabel
<a name="variable-best-practices"></a>

Daftar dropdown variabel ditampilkan dalam urutan mereka tercantum dalam daftar variabel di pengaturan **Dashboard**.

Letakkan variabel yang akan sering Anda ubah di bagian atas, sehingga akan ditampilkan terlebih dahulu, di paling kiri di dasbor.

## Sintaks variabel
<a name="variable-syntax"></a>

 Judul panel dan kueri metrik dapat melihat variabel dengan menggunakan dua sintaks yang berbeda: 
+  `$varname`Sintaks ini lebih mudah dibaca, seperti pada contoh berikut:`apps.frontend.$server.requests.count`. Namun, Anda tidak dapat menggunakan variabel di tengah kata. 
+  `${var_name}`Gunakan sintaks ini ketika Anda ingin menginterpolasi variabel di tengah ekspresi. 
+  `${var_name:<format>}`Format ini memberi Anda kontrol lebih besar atas bagaimana Grafana menginterpolasi nilai. Untuk informasi selengkapnya, lihat [Opsi format variabel lanjutan](#advanced-variable-format-options). 

 Sebelum kueri dikirim ke sumber data Anda, kueri *diinterpolasi*, artinya variabel diganti dengan nilai saat ini. Selama interpolasi, nilai variabel mungkin *lolos* agar sesuai dengan sintaks bahasa kueri dan di mana ia digunakan. Misalnya, variabel yang digunakan dalam ekspresi regex dalam kueri Prometheus akan di-regex escaped. Baca topik dokumentasi khusus sumber data untuk detail tentang pelarian nilai selama interpolasi. 

 Untuk informasi tentang sintaks lanjutan untuk mengganti pemformatan default sumber data, lihat. [Opsi format variabel lanjutan](#advanced-variable-format-options) 

# Jenis variabel
<a name="variables-types"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

 Grafana menggunakan beberapa jenis variabel. 


|  Jenis variabel  |  Deskripsi  | 
| --- | --- | 
|  Kueri  |  Daftar nilai yang dihasilkan kueri seperti nama metrik, nama server, sensor IDs, pusat data, dan sebagainya. Untuk informasi selengkapnya, lihat [Menambahkan variabel kueri](#add-a-query-variable).  | 
|  Khusus  |  Tentukan opsi variabel secara manual menggunakan daftar yang dipisahkan koma. Untuk informasi selengkapnya, lihat [Menambahkan variabel kustom](#add-a-custom-variable).  | 
|  Kotak teks  |  Menampilkan bidang input teks dengan nilai default opsional. Untuk informasi selengkapnya, lihat [Menambahkan variabel kotak teks](#add-a-text-box-variable).  | 
|  Konstan  |  Tentukan konstanta tersembunyi. Untuk informasi selengkapnya, lihat [Menambahkan variabel konstan](#add-a-constant-variable).  | 
|  Sumber data  |  Ubah sumber data dengan cepat untuk seluruh dasbor. Untuk informasi selengkapnya, lihat [Menambahkan variabel sumber data](#add-a-data-source-variable).  | 
|  Interval  |  Variabel interval mewakili rentang waktu. Untuk informasi selengkapnya, lihat [Menambahkan variabel interval](#add-an-interval-variable).  | 
|  Filter ad hoc  |  Key/value filter yang secara otomatis ditambahkan ke semua kueri metrik untuk sumber data (InfluxDB, Prometheus, dan hanya). OpenSearch Untuk informasi selengkapnya, lihat [Menambahkan filter ad hoc](#add-ad-hoc-filters).  | 
|  Variabel global  |  Variabel bawaan yang dapat digunakan dalam ekspresi di editor kueri. Untuk informasi selengkapnya, lihat [Variabel global](#global-variables).  | 
|  Variabel yang dirantai  |  Kueri variabel dapat berisi variabel lain. Untuk informasi selengkapnya, lihat [Variabel yang dirantai](#chained-variables).  | 

## Menambahkan variabel kueri
<a name="add-a-query-variable"></a>

 Menggunakan variabel kueri, Anda dapat menulis kueri sumber data yang mengembalikan daftar nama metrik, nilai tag, atau kunci. Misalnya, variabel kueri mungkin mengembalikan daftar nama server, sensor IDs, atau pusat data. Nilai variabel berubah saat mereka secara dinamis mengambil opsi dengan kueri sumber data. 

 Ekspresi kueri dapat berisi referensi ke variabel lain dan, pada dasarnya, membuat variabel terkait. Grafana mendeteksi ini dan secara otomatis menyegarkan variabel ketika salah satu variabel tertaut berubah. 

### Ekspresi kueri
<a name="query-expressions"></a>

Ekspresi kueri berbeda untuk setiap sumber data. Untuk informasi selengkapnya, lihat dokumentasi untuk sumber data Anda di[Connect ke sumber data](AMG-data-sources.md).

### Memasuki opsi umum
<a name="enter-general-options"></a>

**Untuk memasukkan opsi umum untuk variabel kueri**

1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Type**, pilih **Query**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasukkan opsi kueri
<a name="enter-query-options"></a>

**Untuk memasukkan opsi kueri untuk variabel kueri**

1. Dalam daftar **Sumber data**, pilih sumber data target untuk kueri. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md).

1.  Dalam daftar **Refresh**, pilih kapan variabel harus memperbarui opsi. 
   +  **Tidak pernah** - Cache kueri variabel, dan nilai tidak diperbarui. Ini bagus jika nilainya tidak pernah berubah, tetapi bermasalah jika dinamis dan banyak berubah. 
   +  **On Dashboard Load** - Query sumber data setiap kali dashboard dimuat. Ini memperlambat pemuatan dasbor, karena kueri variabel harus diselesaikan sebelum dasbor dapat diinisialisasi. 
   +  **Pada Perubahan Rentang Waktu** - Menanyakan sumber data saat rentang waktu dasbor berubah. Gunakan opsi ini hanya jika kueri opsi variabel Anda berisi filter rentang waktu atau bergantung pada rentang waktu dasbor. 

1.  Di bidang **Query**, masukkan kueri. 
   +  Bidang kueri bervariasi sesuai dengan sumber data Anda. Beberapa sumber data memiliki editor kueri khusus. 
   + Jika Anda membutuhkan lebih banyak ruang dalam editor kueri bidang input tunggal, jeda pada baris di sudut kanan bawah bidang dan seret ke bawah untuk memperluas. 

1. (Opsional) Di bidang **Regex**, ketik ekspresi regex untuk memfilter atau menangkap bagian tertentu dari nama yang dikembalikan oleh kueri sumber data Anda. Sebagai contoh, lihat [Memfilter variabel dengan regex](templates-and-variables.md#filter-variables-with-regex). 

1. Dalam daftar **Urutkan**, pilih urutan pengurutan untuk nilai yang akan ditampilkan dalam daftar dropdown. Opsi default, **Dinonaktifkan**, berarti urutan opsi yang dikembalikan oleh kueri sumber data Anda akan digunakan. 

1. (Opsional) Masukkan **Pilihan Pilihan**. Untuk informasi selengkapnya, lihat [Memasukkan opsi pemilihan variabel](templates-and-variables.md#enter-variable-selection-options). 

1.  Di **Pratinjau nilai**, ruang kerja Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan. 

1.  Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

## Menambahkan variabel kustom
<a name="add-a-custom-variable"></a>

 Gunakan variabel *kustom* untuk nilai yang tidak berubah. Ini mungkin angka, string, atau bahkan variabel lainnya. 

Misalnya, jika Anda memiliki nama server atau nama wilayah yang tidak berubah, Anda dapat membuatnya sebagai variabel kustom daripada variabel kueri. Karena mereka tidak berubah, Anda dapat menggunakannya dalam variabel berantai daripada variabel kueri lainnya. Itu akan mengurangi jumlah kueri yang harus dikirim Grafana ketika variabel berantai diperbarui. Untuk informasi lebih lanjut tentang variabel berantai, lihat[Variabel yang dirantai](#chained-variables). 

### Memasuki opsi umum
<a name="variables-enter-general-options"></a>

**Untuk memasukkan opsi kueri untuk variabel kustom**

1.  Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Jenis**, pilih **Kustom**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasukkan opsi kustom
<a name="enter-custom-options"></a>

**Untuk memasukkan opsi kustom untuk variabel kustom**

1. Dalam daftar **Nilai dipisahkan oleh koma**, masukkan nilai untuk variabel ini dalam daftar yang dipisahkan koma. Anda dapat menyertakan angka, string, variabel lain, atau pasangan kunci-nilai yang dipisahkan oleh titik dua. 

1.  (Opsional) Masukkan **Pilihan Pilihan**. Untuk informasi selengkapnya, lihat [Memasukkan opsi pemilihan variabel](templates-and-variables.md#enter-variable-selection-options). 

1.  Di **Pratinjau nilai**, ruang kerja Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan. 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

## Menambahkan variabel kotak teks
<a name="add-a-text-box-variable"></a>

 Variabel *kotak teks* menampilkan bidang input teks dengan nilai default opsional. Ini adalah variabel yang paling fleksibel, karena Anda dapat memasukkan nilai apa pun. Gunakan jenis variabel ini jika Anda memiliki metrik dengan kardinalitas tinggi atau jika Anda ingin memperbarui beberapa panel di dasbor secara bersamaan. 

### Memasuki opsi umum
<a name="text-box-enter-general-options"></a>

**Untuk memasukkan opsi umum untuk variabel kotak teks**

1.  Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Jenis**, pilih **kotak Teks**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, maka label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasukkan opsi teks
<a name="enter-text-options"></a>

**Untuk memasukkan opsi teks untuk variabel kotak teks**

1. (Opsional) Di bidang **Nilai default**, pilih nilai default untuk variabel. Jika Anda tidak memasukkan apa pun di bidang ini, Grafana menampilkan kotak teks kosong tempat Anda dapat mengetik teks. 

1.  Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan. 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

## Menambahkan variabel konstan
<a name="add-a-constant-variable"></a>

Untuk menentukan konstanta tersembunyi, gunakan variabel *konstan*. Variabel konstan berguna untuk awalan jalur metrik untuk dasbor yang ingin Anda bagikan. Saat Anda mengekspor dasbor, variabel konstan dikonversi ke opsi impor. 

Variabel konstan tidak fleksibel. Setiap variabel konstan hanya memiliki satu nilai. Untuk memperbaruinya, Anda harus memperbarui pengaturan variabel. 

Variabel konstan berguna ketika Anda memiliki nilai kompleks yang harus Anda sertakan dalam kueri tetapi tidak ingin mengetik ulang di setiap kueri tunggal. Misalnya, jika Anda memiliki jalur server yang dipanggil`i-0b6a61efe2ab843gg`, Anda bisa menggantinya dengan variabel yang disebut`$path_gg`. 

### Memasuki opsi umum
<a name="constant-variable-enter-general-options"></a>

**Untuk memasukkan opsi umum untuk variabel konstan**

1.  Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon **Dashboard settings** (gear) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Type**, pilih **Constant**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, maka label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. Ini adalah opsi default. 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 

### Memasuki opsi konstan
<a name="enter-constant-options"></a>

**Untuk memasukkan opsi konstan untuk variabel konstan**

1. Di bidang **Nilai**, masukkan nilai variabel. Anda dapat memasukkan huruf, angka, dan simbol. Jika Anda menggunakan opsi format variabel lanjutan, Anda bahkan dapat menggunakan kartu liar. Untuk informasi selengkapnya, lihat [Opsi format variabel lanjutan](templates-and-variables.md#advanced-variable-format-options). 

1. Di **Pratinjau nilai**, ruang kerja Grafana menampilkan nilai variabel saat ini. Tinjau untuk memastikannya sesuai dengan apa yang Anda harapkan. 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

## Menambahkan variabel sumber data
<a name="add-a-data-source-variable"></a>

Untuk mengubah sumber data untuk seluruh dasbor dengan cepat, Anda dapat menggunakan variabel *sumber data*. Mereka berguna jika Anda memiliki beberapa contoh sumber data, mungkin di lingkungan yang berbeda. 

### Memasuki opsi umum
<a name="data-source-enter-general-options"></a>

**Untuk memasukkan opsi umum untuk variabel sumber data**

1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Type**, pilih **Datasource**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasukkan opsi sumber data
<a name="enter-data-source-options"></a>

**Untuk memasukkan opsi sumber data untuk variabel sumber data**

1.  Dalam daftar **Jenis**, pilih sumber data target untuk variabel tersebut. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md). 

1. (Opsional) Untuk **filter nama Instance**, masukkan filter regex yang instance sumber datanya dapat dipilih dalam daftar drop-down nilai variabel. Biarkan bidang ini kosong untuk menampilkan semua instance. 

1.  (Opsional) Masukkan **Pilihan Pilihan**. Untuk informasi selengkapnya, lihat [Memasukkan opsi pemilihan variabel](templates-and-variables.md#enter-variable-selection-options). 

1.  Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan. 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

## Menambahkan variabel interval
<a name="add-an-interval-variable"></a>

Gunakan variabel *interval* untuk mewakili rentang waktu seperti`1m`,`1h`,`1d`. Anda dapat menganggapnya sebagai perintah di seluruh dasbor group-by-time. Variabel interval mengubah cara data dikelompokkan dalam visualisasi. Anda juga dapat menggunakan opsi Auto untuk mengembalikan sejumlah titik data per rentang waktu. 

Anda dapat menggunakan variabel interval sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB), interval histogram tanggal (untuk OpenSearch), atau sebagai parameter fungsi ringkasan (untuk Grafit). 

### Memasuki opsi umum
<a name="interval-variable-enter-general-options"></a>

**Untuk memasukkan opsi umum untuk variabel interval**

1.  Arahkan ke dasbor yang ingin Anda buat variabel dan kemudian pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Type**, pilih **Interval**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan dropdownlist variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasuki opsi interval
<a name="enter-interval-options"></a>

**Untuk memasukkan opsi interval untuk variabel interval**

1.  Di bidang **Nilai**, masukkan interval rentang waktu yang ingin Anda tampilkan di daftar drop-down variabel. Unit waktu berikut didukung:`s (seconds)`,,`m (minutes)`,`h (hours)`, `d (days)``w (weeks)`,`M (months)`, dan`y (years)`. Anda juga dapat menerima atau mengedit nilai default:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`. 

1. (Opsional) Aktifkan **Opsi Otomatis** jika Anda ingin menambahkan `auto` opsi ke daftar. Gunakan opsi ini untuk menentukan berapa kali rentang waktu saat ini harus dibagi untuk menghitung rentang `auto` waktu saat ini. Jika Anda menyalakannya, maka dua opsi lagi muncul: 
   +  **Jumlah langkah** - Pilih berapa kali rentang waktu saat ini akan dibagi untuk menghitung nilainya, mirip dengan opsi kueri **poin data Maks**. Misalnya, jika rentang waktu yang terlihat saat ini adalah 30 menit, maka `auto` interval mengelompokkan data menjadi 30 peningkatan satu menit. Nilai default adalah 30 langkah. 
   +  **Interval Min** — Ambang minimum di bawah mana interval hitungan langkah tidak akan membagi waktu. Untuk melanjutkan contoh 30 menit, jika interval minimum diatur ke`2m`, Grafana mengelompokkan data menjadi 15 kenaikan 2 menit. 

1.  Di **Pratinjau nilai**, Grafana menampilkan daftar nilai variabel saat ini. Tinjau mereka untuk memastikan mereka sesuai dengan apa yang Anda harapkan. 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

### Contoh variabel interval
<a name="interval-variable-examples"></a>

 Contoh menggunakan variabel template `myinterval` dalam fungsi Graphite: 

```
summarize($myinterval, sum, false)
```

 Contoh grafit yang lebih kompleks: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## Menambahkan filter ad hoc
<a name="add-ad-hoc-filters"></a>

Anda dapat menggunakan filter satu kali, atau *ad hoc* untuk menambahkan filter kunci/nilai yang secara otomatis ditambahkan ke semua kueri metrik yang menggunakan sumber data yang ditentukan. Tidak seperti variabel lain, Anda tidak menggunakan filter satu kali dalam kueri. Sebagai gantinya, Anda menggunakannya untuk menulis filter untuk kueri yang ada. 

**catatan**  
**Catatan:** Variabel filter satu kali, atau ad hoc, hanya berfungsi dengan InfluxDB, Prometheus, dan sumber data. OpenSearch 

### Memasuki opsi umum
<a name="ad-hoc-filters-enter-general-options"></a>

**Untuk memasukkan opsi umum untuk filter ad hoc**

1. Arahkan ke dasbor yang ingin Anda buat variabel, lalu pilih ikon **Pengaturan Dasbor** (roda gigi) di bagian atas halaman. 

1.  Pada tab **Variables**, pilih **New**. 

1.  Masukkan **Nama** untuk variabel Anda. 

1.  Dalam daftar **Jenis**, pilih **Filter ad hoc**. 

1. (Opsional) Untuk **Label**, masukkan nama tampilan daftar dropdown variabel. Jika Anda tidak memasukkan nama tampilan, label dropdown akan menjadi nama variabel. 

1.  Pilih opsi **Sembunyikan**: 
   +  **Tidak ada pilihan (kosong)** - Daftar dropdown variabel menampilkan variabel **Nama** atau nilai **Label**. Ini adalah opsi default. 
   +  **Label** - Daftar dropdown variabel hanya menampilkan nilai variabel yang dipilih dan panah bawah. 
   +  **Variabel** - Tidak ada daftar dropdown variabel ditampilkan di dasbor. 

### Memasukkan opsi
<a name="ad-hoc-enter-options"></a>

**Untuk memasukkan opsi untuk filter ad hoc**

1.  Dalam daftar **Sumber data**, pilih sumber data target. Untuk informasi selengkapnya tentang sumber data, lihat[Connect ke sumber data](AMG-data-sources.md). 

1. Pilih **Tambah** untuk menambahkan variabel ke dasbor. 

### Membuat filter ad hoc
<a name="create-ad-hoc-filters"></a>

Filter ad hoc adalah salah satu opsi variabel paling kompleks dan fleksibel yang tersedia. Alih-alih daftar opsi variabel reguler, variabel ini memungkinkan pembuatan kueri ad hoc di seluruh dasbor. Filter yang Anda terapkan dengan cara ini diterapkan ke semua panel di dasbor. 

## Variabel yang dirantai
<a name="chained-variables"></a>

*Variabel berantai*, juga disebut *variabel terkait atau variabel* *bersarang, adalah variabel* kueri dengan satu atau lebih variabel lain dalam kueri variabelnya. Bagian ini menjelaskan cara kerja variabel berantai, dan menyediakan tautan ke dasbor contoh yang menggunakan variabel berantai. 

Kueri variabel berantai berbeda untuk setiap sumber data, tetapi premisnya sama untuk semua. Anda dapat menggunakan kueri variabel berantai di sumber data apa pun yang mendukungnya. 

Anda dapat membangun dasbor yang ditautkan dan bertemplat yang kompleks, kedalaman 5 atau 10 level. Secara teknis, tidak ada batasan seberapa dalam atau kompleks Anda dapat pergi, tetapi semakin banyak tautan yang Anda miliki, semakin besar beban kueri. 

### Praktik dan kiat terbaik
<a name="variables-best-practices-and-tips"></a>

Praktik berikut akan membuat dasbor dan variabel Anda lebih mudah digunakan. 

#### Membuat variabel berantai baru
<a name="creating-new-linked-variables"></a>
+  Variabel rantai menciptakan dependensi induk-anak. Anda dapat membayangkan mereka sebagai tangga atau pohon. 
+ Cara tercepat untuk membuat variabel berantai baru adalah dengan menyalin variabel yang ingin Anda dasarkan yang baru. Dalam daftar variabel, pilih ikon **variabel Duplikat** di sebelah kanan entri variabel untuk membuat salinan. Anda kemudian dapat menambahkan ke kueri untuk variabel induk.
+ Variabel berantai baru yang Anda buat dengan cara ini muncul di bagian bawah daftar. Untuk memberikan daftar urutan logis, seret variabel ke posisi yang berbeda dalam daftar. 

#### Urutan variabel
<a name="variable-order"></a>

Untuk mengubah urutan variabel dalam daftar variabel dasbor, pilih panah atas dan bawah di sisi kanan setiap entri. Ruang kerja Grafana mencantumkan daftar dropdown variabel dari kiri ke kanan sesuai dengan daftar ini, menampilkan variabel di bagian atas daftar di paling kiri. 
+  Buat daftar variabel yang tidak memiliki dependensi di bagian atas, sebelum variabel anak mereka. 
+  Setiap variabel harus mengikuti salah satu yang bergantung padanya. 
+ UI tidak menunjukkan variabel mana yang memiliki hubungan ketergantungan. Buat daftar variabel dalam urutan logis untuk membuatnya lebih jelas bagi pengguna akhir (dan diri Anda sendiri). 

#### Pertimbangan kompleksitas
<a name="complexity-consideration"></a>

Semakin banyak lapisan ketergantungan yang Anda miliki dalam variabel, semakin lama waktu yang dibutuhkan untuk memperbarui dasbor setelah Anda mengubah variabel. 

Misalnya, jika Anda memiliki serangkaian empat variabel tertaut (negara, wilayah, server, metrik) dan Anda mengubah nilai variabel root (negara), ruang kerja Grafana harus menjalankan kueri untuk semua variabel dependen sebelum memperbarui visualisasi di dasbor. 

## Variabel global
<a name="global-variables"></a>

 Grafana memiliki variabel bawaan global yang dapat digunakan dalam ekspresi di editor kueri. Topik ini mencantumkannya dalam urutan abjad dan mendefinisikannya. Variabel ini berguna dalam kueri, tautan dasbor, tautan panel, dan tautan data. 

### \$1 \$1\$1dasbor
<a name="global-variable-dashboard"></a>

Variabel ini adalah nama dasbor saat ini. 

### \$1\$1\$1from dan \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

Grafana memiliki dua variabel rentang waktu bawaan: `$__from` dan. `$__to` Mereka saat ini selalu diinterpolasi sebagai milidetik epoch secara default tetapi Anda dapat mengontrol pemformatan tanggal. 


|  Sintaksis  |  Contoh hasil  |  Deskripsi  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Epoch unix milidetik  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T 20:19:09.254 Z  |  Tidak ada argumen, default ke ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Epoch detik Unix  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  Setiap format data kustom. Untuk informasi selengkapnya, lihat [Tampilan](https://momentjs.com/docs/#/displaying/).  | 

Sintaks di atas `${__to}` juga berfungsi dengan. 

Anda dapat menggunakan variabel ini URLs juga. Misalnya, untuk mengirim pengguna akhir ke dasbor yang menunjukkan rentang waktu dari enam jam yang lalu hingga sekarang, gunakan URL berikut: https://play.grafana. org/d/000000012/grafanaBermain di rumah? ViewPanel=2&orgid=1? dari=sekarang-6h&ke=sekarang 

### \$1 \$1\$1interval
<a name="global-variable-interval"></a>

*Anda dapat menggunakan `$__interval` variabel sebagai parameter untuk mengelompokkan berdasarkan waktu (untuk InfluxDB, Myself, Postgres, MSSQL), interval histogram tanggal (untuk), atau sebagai parameter fungsi ringkasan (untuk Grafit OpenSearch).* 

Ruang kerja Grafana secara otomatis menghitung interval yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ketika ada lebih banyak titik data daripada yang dapat ditampilkan pada grafik, kueri dapat dibuat lebih efisien dengan mengelompokkan dengan interval yang lebih besar. Misalnya, lebih efisien untuk mengelompokkan 1 hari daripada 10 detik ketika melihat data 3 bulan. Grafik akan terlihat sama, dan kueri akan lebih cepat. `$__interval`Ini dihitung dengan menggunakan rentang waktu dan lebar grafik (jumlah piksel). 

 Perhitungan Perkiraan: `(from - to) / resolution` 

Misalnya, ketika rentang waktu adalah 1 jam dan grafik layar penuh, interval dapat dihitung`2m`; poin dikelompokkan dalam interval 2 menit. Jika rentang waktu 6 bulan dan grafiknya layar penuh, intervalnya mungkin `1d` (1 hari); poin dikelompokkan berdasarkan hari. 

 Dalam sumber data InfluxDB, variabel warisan `$interval` adalah variabel yang sama. Gunakan `$__interval` sebagai gantinya. 

 InfluxDB dan sumber OpenSearch data memiliki `Group by time interval` bidang yang digunakan untuk hardcode interval atau untuk menetapkan batas minimum untuk `$__interval` variabel dengan menggunakan sintaks ->. `>` `>10m` 

### \$1 \$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

 Variabel ini adalah `$__interval` variabel dalam milidetik, bukan string yang diformat interval waktu. Misalnya, jika `$__interval` adalah `20m` maka `$__interval_ms` adalah`1200000`. 

### \$1 \$1\$1nama
<a name="global-variable-name"></a>

 **Variabel ini hanya tersedia di panel Singlestat dan dapat digunakan di bidang awalan atau akhiran pada tab Opsi.** Variabel akan diganti dengan nama seri atau alias. 

### \$1\$1\$1org
<a name="global-variable-org"></a>

 Variabel ini adalah ID dari organisasi saat ini. Variabel `${__org.name}` adalah nama organisasi saat ini. 

### \$1 \$1\$1pengguna
<a name="global-variable-user"></a>

Variabel `${__user.id}` adalah ID dari pengguna saat ini. Variabel `${__user.login}` adalah pegangan login dari pengguna saat ini. Variabel `${__user.email}` adalah email untuk pengguna saat ini. 

### \$1 \$1\$1kisaran
<a name="global-variable-range"></a>

Variabel ini saat ini hanya didukung untuk sumber data Prometheus. Variabel ini mewakili rentang untuk dasbor saat ini. Itu dihitung oleh`to - from`. Ini memiliki representasi milidetik dan kedua yang disebut `$__range_ms` dan. `$__range_s` 

### \$1 TimeFilter atau \$1 \$1\$1TimeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

`$timeFilter`Variabel mengembalikan rentang waktu yang dipilih saat ini sebagai ekspresi. Misalnya, `Last 7 days` ekspresi interval rentang waktu adalah`time > now() - 7d`. 

 Variabel ini digunakan di beberapa tempat, termasuk: 
+ Klausul WHERE untuk sumber data InfluxDB. **Grafana menambahkannya secara otomatis ke kueri InfluxDB saat dalam mode Query Editor.** Anda dapat menambahkannya secara manual dalam mode **Editor Teks**:`WHERE $timeFilter`. 
+  Kueri log Analytics di sumber data Azure Monitor. 
+  Kueri SQL di MySQL, Postgres, dan MSSQL. 
+  `$__timeFilter`Variabel ini digunakan dalam sumber data MySQL. 

## Opsi variabel lainnya
<a name="other-variable-options"></a>

Bagian ini menjelaskan opsi variabel lain yang tersedia.

### Memasukkan opsi pemilihan variabel
<a name="enter-variable-selection-options"></a>

Anda dapat menggunakan **Pilihan Pilihan** untuk mengelola pilihan opsi variabel. Semua opsi pilihan adalah opsional, dan mereka mati secara default. 

#### Multi-nilai
<a name="multi-value"></a>

Jika Anda mengaktifkan opsi ini, daftar dropdown variabel mendukung pemilihan beberapa opsi secara bersamaan. Untuk informasi selengkapnya, lihat [Memformat variabel multi-nilai](#formatting-multi-value-variables). 

#### Sertakan Semua opsi
<a name="include-all-option"></a>

Ruang kerja Grafana menambahkan `All` opsi ke daftar dropdown variabel. Jika pengguna akhir memilih opsi ini, semua opsi variabel dipilih. 

#### Kustom semua nilai
<a name="custom-all-value"></a>

Opsi ini hanya terlihat jika **opsi Sertakan Semua** dipilih. 

**Untuk menentukan nilai `All` opsi, masukkan sintaks regex, glob, atau Lucene di bidang Kustom semua nilai.** 

Secara default, `All` nilai mencakup semua opsi dalam ekspresi gabungan. Ini bisa menjadi sangat panjang dan dapat memiliki masalah kinerja. Terkadang lebih baik untuk menentukan nilai semua kustom, seperti regex kartu liar. 

Saat Anda menggunakan sintaks regex, glob, atau Lucene kustom di opsi **Kustom semua nilai**, itu tidak pernah lolos, jadi Anda harus mempertimbangkan nilai yang valid untuk sumber data Anda. 

### Opsi format variabel lanjutan
<a name="advanced-variable-format-options"></a>

 Pemformatan interpolasi variabel tergantung pada sumber data, tetapi ada beberapa situasi di mana Anda mungkin ingin mengubah format default. 

 Misalnya, default untuk sumber data MySQL adalah menggabungkan beberapa nilai sebagai dipisahkan koma dengan tanda kutip:. `'server01','server02'` Dalam beberapa kasus, Anda mungkin ingin memiliki string yang dipisahkan koma tanpa tanda kutip:. `server01,server02` Untuk melakukan ini, gunakan opsi pemformatan variabel lanjutan berikut. 

#### Sintaks umum
<a name="general-syntax"></a>

 Sintaks: `${var_name:option}` 

Jika ada opsi pemformatan yang tidak valid ditentukan, `glob` adalah opsi default, atau fallback,. 

#### CSV
<a name="variables-csv"></a>

 Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```

#### Didistribusikan - OpenTSDB
<a name="distributed---opentsdb"></a>

 Memformat variabel dengan beberapa nilai dalam format khusus untuk OpenTSDB. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```

#### Kutipan ganda
<a name="doublequote"></a>

 Memformat variabel nilai tunggal dan multi-nilai ke dalam string yang dipisahkan koma, lolos `"` di setiap nilai dengan`\"`, dan mengutip setiap nilai dengan. `"` 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```

#### Glob - Grafit
<a name="glob---graphite"></a>

 Memformat variabel dengan beberapa nilai menjadi gumpalan (untuk kueri Grafit). 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```

#### JSON
<a name="json"></a>

 Memformat variabel dengan beberapa nilai sebagai string yang dipisahkan koma. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```

#### Lucene - OpenSearch
<a name="lucene---opensearch"></a>

 Memformat variabel dengan beberapa nilai dalam format Lucene untuk. OpenSearch 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```

#### Kode Persentase
<a name="percentencode"></a>

 Memformat variabel nilai tunggal dan multi-nilai untuk digunakan dalam parameter URL. 

```
servers = ['foo()bar BAZ', 'test2']
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```

#### Pipa
<a name="pipe"></a>

 Memformat variabel dengan beberapa nilai menjadi string yang dipisahkan pipa. 

```
servers = ['test1.', 'test2']
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```

#### Mentah
<a name="raw"></a>

 Mematikan format khusus sumber data, seperti tanda kutip tunggal dalam kueri SQL. 

```
servers = ['test1.', 'test2']
String to interpolate: '${var_name:raw}'
Interpolation result: '{test.1,test2}'
```

#### Regex
<a name="regex"></a>

 Memformat variabel dengan beberapa nilai menjadi string regex. 

```
servers = ['test1.', 'test2']
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```

#### Singlequote
<a name="singlequote"></a>

 Memformat variabel nilai tunggal dan multi-menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `\'` dan mengutip setiap nilai dengan. `'` 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```

#### Sqlstring
<a name="sqlstring"></a>

 Memformat variabel nilai tunggal dan multi-menjadi string yang dipisahkan koma, lolos `'` di setiap nilai dengan `''` dan mengutip setiap nilai dengan. `'` 

```
servers = ["test'1", "test2"]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```

#### Teks
<a name="text"></a>

 Memformat variabel nilai tunggal dan multi-nilai ke dalam representasi teksnya. Untuk satu variabel, itu hanya akan mengembalikan representasi teks. Untuk variabel multi-nilai, itu akan mengembalikan representasi teks yang digabungkan dengan`+`. 

```
servers = ["test1", "test2"]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```

### Memformat variabel multi-nilai
<a name="formatting-multi-value-variables"></a>

Menginterpolasi variabel dengan beberapa nilai yang dipilih rumit karena tidak langsung bagaimana memformat beberapa nilai menjadi string yang valid dalam konteks tertentu di mana variabel digunakan. Grafana mencoba menyelesaikan ini dengan mengaktifkan setiap plugin sumber data untuk menginformasikan mesin interpolasi template format apa yang akan digunakan untuk beberapa nilai. 

**catatan**  
 Opsi **Kustom semua nilai** pada variabel harus kosong agar Grafana memformat semua nilai menjadi satu string. Jika dibiarkan kosong, maka Grafana menggabungkan (menambahkan bersama) semua nilai dalam kueri. Sesuatu seperti`value1,value2,value3`. Jika `all` nilai kustom digunakan, maka sebaliknya nilai akan menjadi sesuatu seperti `*` atau`all`. 

#### Variabel multi-nilai dengan sumber data Grafit
<a name="multi-value-variables-with-a-graphite-data-source"></a>

 Grafit menggunakan ekspresi glob. *Variabel dengan beberapa nilai akan, dalam hal ini, diinterpolasi `{host1,host2,host3}` seolah-olah nilai variabel saat ini adalah *host1, host2**, dan host3*.* 

#### Variabel multi-nilai dengan sumber data Prometheus atau InfluxDB
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

 InfluxDB dan Prometheus menggunakan ekspresi regex, sehingga variabel yang sama akan diinterpolasi sebagai. `(host1|host2|host3)` Setiap nilai juga akan lolos dari regex. Jika tidak, nilai dengan karakter kontrol regex akan merusak ekspresi regex. 

#### Variabel multi-nilai dengan sumber data Elastis
<a name="multi-value-variables-with-an-elastic-data-source"></a>

Amazon OpenSearch menggunakan sintaks kueri Lucene, sehingga variabel yang sama akan diformat sebagai. `("host1" OR "host2" OR "host3")` Dalam hal ini, setiap nilai harus diloloskan sehingga nilainya hanya berisi kata-kata kontrol Lucene dan tanda kutip. 

#### Memecahkan masalah pemformatan
<a name="formatting-troubles"></a>

 Pelarian dan pemformatan otomatis dapat menyebabkan masalah. Mungkin sulit untuk memahami logika di balik masalah, terutama untuk InfluxDB dan Prometheus, di mana penggunaan sintaks regex mengharuskan variabel tersebut digunakan dalam konteks operator regex. 

 Jika Anda tidak ingin Grafana melakukan pelolosan dan pemformatan regex otomatis ini, Anda harus melakukan salah satu hal berikut:
+ Matikan opsi **Multi-nilai** **Sertakan Semua opsi**.
+ Gunakan [format variabel mentah] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).

### Memfilter variabel dengan regex
<a name="filter-variables-with-regex"></a>

 Menggunakan opsi Regex Query, Anda dapat memfilter daftar opsi yang dikembalikan oleh kueri variabel atau memodifikasi opsi yang dikembalikan. 

Bagian ini menunjukkan cara menggunakan regex untuk memfilter dan memodifikasi nilai dalam daftar dropdown variabel. 

 Menggunakan opsi Regex Query, Anda memfilter daftar opsi yang dikembalikan oleh kueri Variabel atau memodifikasi opsi yang dikembalikan. Untuk informasi selengkapnya, lihat [Ekspresi reguler](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). 

 Contoh penyaringan pada daftar opsi berikut: 

```
backend_01
backend_02
backend_03
backend_04
```

#### Pemfilteran sehingga hanya opsi yang diakhiri dengan `01` atau `02` dikembalikan
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 Regex: 

```
/.*[01|02]/
```

 Hasil: 

```
backend_01
backend_02
```

#### Memfilter dan memodifikasi opsi menggunakan grup tangkapan regex untuk mengembalikan bagian teks
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 Regex: 

```
/.*(01|02)/
```

 Hasil: 

```
01
02
```

#### Memfilter dan memodifikasi - Contoh Prometheus
<a name="filter-and-modify---prometheus-example"></a>

 Daftar opsi: 

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

 Regex: 

```
/.*instance="([^"]*).*/
```

 Hasil: 

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

#### Memfilter dan memodifikasi menggunakan teks bernama dan grup penangkap nilai
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

Menggunakan grup tangkapan bernama, Anda dapat menangkap bagian “teks” dan “nilai” terpisah dari opsi yang dikembalikan oleh kueri variabel. Daftar dropdown variabel dapat berisi nama ramah untuk setiap nilai yang dapat dipilih. 

 Misalnya, saat menanyakan metrik `node_hwmon_chip_names` Prometheus, metrik lebih ramah daripada nilainya. `chip_name` `chip` Mulailah dengan hasil query variabel berikut. 

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

 Lewati melalui Regex berikut. 

```
/chip_name="(?<text>[^"]+)|chip="(?<value>[^"]+)/g
```

 Daftar dropdown berikut diproduksi. 

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

 **Catatan:** Hanya `text` dan `value` menangkap nama grup yang didukung. 

### Panel atau baris berulang
<a name="repeat-panels-or-rows"></a>

 Anda dapat membuat dasbor dinamis menggunakan *variabel template*. Semua variabel dalam kueri Anda diperluas ke nilai variabel saat ini sebelum kueri dikirim ke database. Dengan variabel, Anda dapat menggunakan kembali satu dasbor untuk semua layanan Anda. 

 Variabel template bisa sangat berguna untuk mengubah kueri Anda secara dinamis di seluruh dasbor. *Jika Anda ingin Grafana membuat panel atau baris baru secara dinamis berdasarkan nilai yang telah Anda pilih, Anda dapat menggunakan fitur Ulangi.* 

#### Panel berulang
<a name="repeating-panels"></a>

 Jika Anda memiliki variabel dengan `Multi-value` atau `Include all value` opsi diaktifkan, Anda dapat memilih satu panel dan meminta Grafana mengulangi panel itu untuk setiap nilai yang dipilih. Anda dapat menemukan fitur *Ulangi* di bawah *tab Umum* dalam mode edit panel. 

 `direction`Kontrol bagaimana panel diatur. 

Jika Anda memilih`horizontal`, panel diatur side-by-side. Grafana secara otomatis menyesuaikan lebar setiap panel berulang sehingga seluruh baris terisi. Saat ini, Anda tidak dapat mencampur panel lain secara berurutan dengan panel berulang. 

 Atur `Max per row` untuk memberi tahu Grafana berapa banyak panel per baris yang paling Anda inginkan. *Defaultnya ke 4.* 

Jika Anda memilih`vertical`, panel disusun dari atas ke bawah dalam kolom. Lebar panel berulang sama dengan panel pertama (template asli) yang diulang. 

Buat perubahan hanya pada panel pertama (template asli). Agar perubahan diterapkan pada semua panel, Anda harus memulai pembuatan ulang dasbor dinamis. Anda dapat melakukan ini dengan mengubah nilai variabel (yaitu, dasar untuk pengulangan) atau memuat ulang dasbor. 

**catatan**  
Panel berulang membutuhkan variabel untuk memiliki satu atau lebih item yang dipilih. Anda tidak dapat mengulang panel nol kali untuk menyembunyikannya.

#### Baris berulang
<a name="repeating-rows"></a>

 Seperti yang terlihat di atas dengan panel Anda juga dapat mengulangi baris jika Anda memiliki variabel yang ditetapkan dengan `Multi-value` atau `Include all value` pilihan pilihan. 

 Untuk mengaktifkan fitur ini, Anda harus terlebih dahulu menambahkan *Baris* baru dengan menggunakan menu *Add Panel*. Kemudian jeda pada judul baris dan pilih tombol roda gigi untuk mengakses panel `Row Options` konfigurasi. Anda kemudian dapat memilih variabel yang ingin Anda ulangi barisnya. 

 Praktik terbaik adalah menggunakan variabel dalam judul baris juga. 

# Grafana memperingatkan
<a name="alerts-overview"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Grafana alert memberi Anda peringatan yang kuat dan dapat ditindaklanjuti yang membantu Anda mempelajari masalah dalam sistem beberapa saat setelah terjadi, meminimalkan gangguan pada layanan Anda.

Grafana yang Dikelola Amazon mencakup akses ke sistem peringatan yang diperbarui, peringatan Grafana, yang *memusatkan informasi peringatan* dalam satu tampilan yang dapat dicari. Ini mencakup fitur-fitur berikut:
+ Buat dan kelola peringatan Grafana dalam tampilan terpusat.
+ Buat dan kelola peringatan terkelola Cortex dan Loki melalui satu antarmuka. Untuk informasi selengkapnya, lihat [Kelola aturan peringatan Anda](v9-alerting-managerules.md).
+ Lihat informasi peringatan dari Prometheus, Layanan Terkelola Amazon untuk Prometheus, dan sumber data lain yang kompatibel dengan Alertmanager.
+ Buat beberapa instance peringatan dari satu aturan peringatan. Untuk informasi selengkapnya, lihat [Aturan tunggal dan multidimensi](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Kelola sumber daya peringatan Anda dengan terraform atau penyediaan. APIs Untuk informasi selengkapnya, lihat [Penyediaan sumber daya Peringatan Grafana](v9-alerting-setup-provision.md).

Untuk ruang kerja Grafana Terkelola Amazon yang ada, defaultnya adalah. [Peringatan dasbor klasik](old-alerts-overview.md) Untuk bermigrasi ke peringatan Grafana, Anda harus [bermigrasi](alert-opt-in.md) ke peringatan Grafana.

Untuk mempelajari lebih lanjut tentang peringatan Grafana, lihat. [Apa yang baru di Grafana alerting](alerts-whats-new.md)

Grafana alert memiliki empat komponen utama:
+ [Aturan peringatan](alert-rules.md) - Kriteria evaluasi yang menentukan apakah peringatan dimulai. Ini terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan opsional, durasi di mana kondisi terpenuhi.
+ [Titik kontak](alert-contact-points.md) - Saluran untuk mengirim pemberitahuan ketika kondisi aturan peringatan terpenuhi. 
+ [Kebijakan pemberitahuan](alert-notifications.md) - Kumpulan kriteria pencocokan dan pengelompokan yang digunakan untuk menentukan frekuensi pemberitahuan.
+ [Silences](alert-silences.md) - Tanggal dan kriteria pencocokan yang digunakan untuk membungkam notifikasi.

Saat peringatan Grafana diaktifkan, Anda dapat:
+ [Buat aturan peringatan terkelola Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Buat aturan peringatan terkelola Cortex atau Loki](alert-rules.md#create-alert-rule)
+ [Lihat aturan peringatan yang ada dan kelola statusnya saat ini](alert-rules.md#manage-alert-rules)
+ [Lihat keadaan dan kesehatan aturan peringatan](alert-fundamentals.md#alerts-state)
+ [Menambahkan atau mengedit titik kontak peringatan](alert-contact-points.md#alert-working-contact-points)
+ [Menambahkan atau mengedit kebijakan pemberitahuan](alert-notifications.md#alert-notifications-working)
+ [Menambahkan atau mengedit keheningan](alert-silences.md)

## Batasan
<a name="alert-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Amazon Managed Service yang tersedia untuk Prometheus, Prometheus, Loki, dan Alertmanager. Mungkin tidak dapat mengambil aturan dari sumber data lain yang didukung.
+ Aturan peringatan yang ditentukan di Grafana, bukan di Prometheus, mengirim beberapa pemberitahuan ke titik kontak Anda. Jika Anda menggunakan peringatan Grafana asli, kami sarankan Anda tetap menggunakan peringatan dasbor klasik dan tidak mengaktifkan fitur peringatan Grafana baru. Jika Anda ingin melihat Peringatan yang ditentukan dalam sumber data Prometheus Anda, maka kami sarankan Anda mengaktifkan Peringatan Grafana, yang hanya mengirimkan satu pemberitahuan untuk peringatan yang dibuat di Prometheus Alertmanager.
**catatan**  
Batasan ini tidak lagi menjadi batasan di ruang kerja Grafana Terkelola Amazon yang mendukung Grafana v10.4 dan yang lebih baru.

**Topics**
+ [Batasan](#alert-limitations)
+ [Apa yang baru di Grafana alerting](alerts-whats-new.md)
+ [Memigrasi peringatan dasbor klasik ke peringatan Grafana](alert-opt-in.md)
+ [Memperingatkan dasar-dasar](alert-fundamentals.md)
+ [Membuat dan mengelola aturan peringatan Grafana](alert-rules.md)
+ [Grup peringatan](alert-groups.md)
+ [Membungkam pemberitahuan peringatan untuk sumber data Prometheus](alert-silences.md)
+ [Bekerja dengan titik kontak](alert-contact-points.md)
+ [Menggunakan templat perpesanan](alert-message-templates.md)
+ [Bekerja dengan kebijakan notifikasi](alert-notifications.md)

# Apa yang baru di Grafana alerting
<a name="alerts-whats-new"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Peringatan Grafana memiliki beberapa penyempurnaan dibandingkan peringatan dasbor klasik.

## Buat peringatan multidimensi
<a name="alerts-new-dimensional"></a>

Anda sekarang dapat membuat aturan peringatan tunggal yang memberi Anda visibilitas seluruh sistem, menghasilkan beberapa instance peringatan dari satu aturan peringatan. Misalnya, Anda dapat membuat aturan untuk memantau penggunaan disk dari beberapa titik pemasangan pada satu host. Mesin evaluasi mengembalikan beberapa deret waktu dari satu kueri, dengan setiap deret waktu diidentifikasi oleh set labelnya.

**catatan**  
Setiap instance peringatan dihitung terhadap kuota peringatan. Aturan multidimensi yang membuat lebih banyak instance daripada yang dapat diakomodasi dalam kuota peringatan tidak dievaluasi dan mengembalikan kesalahan kuota. Untuk informasi selengkapnya, lihat [Kuota mencapai kesalahan](alert-rules.md#rule-quota-reached).

## Buat peringatan di luar dasbor
<a name="alerts-new-not-dashboard"></a>

Tidak seperti peringatan dasbor klasik, dengan peringatan Grafana Anda dapat membuat kueri dan ekspresi yang menggabungkan data dari berbagai sumber dengan cara yang unik. Anda masih dapat menautkan dasbor dan panel ke aturan peringatan menggunakan ID mereka dan dengan cepat memecahkan masalah sistem yang sedang diamati.

Karena peringatan terpadu tidak lagi terkait langsung dengan kueri panel, mereka tidak menyertakan gambar atau nilai kueri dalam email notifikasi. Anda dapat menggunakan templat notifikasi yang disesuaikan untuk melihat nilai kueri.

## Buat aturan peringatan Loki dan Cortex
<a name="alerts-new-loki-cortex"></a>

Dalam peringatan Grafana, Anda dapat mengelola aturan peringatan Loki dan Cortex menggunakan UI dan API yang sama dengan peringatan yang dikelola Grafana Anda.

## Lihat dan cari peringatan dari Amazon Managed Service untuk Prometheus dan sumber data lain yang kompatibel dengan Prometheus
<a name="alerts-new-prometheus"></a>

Peringatan untuk Layanan Terkelola Amazon untuk sumber data yang kompatibel dengan Prometheus dan Prometheus sekarang terdaftar di antarmuka Peringatan. Anda dapat mencari label di beberapa sumber data untuk menemukan peringatan yang relevan dengan cepat.

## Peringatan khusus untuk status peringatan NoData dan Kesalahan
<a name="alerts-new-error"></a>

Peringatan Grafana menghasilkan peringatan khusus yang memiliki label berikut, ketika evaluasi aturan peringatan menghasilkan status atau: `NoData` `Error`
+ `alertname`dengan nilai `DatasourceNoData` atau `DatasourceError` tergantung pada negara.
+ `rulename`dengan nama aturan peringatan peringatan khusus milik.
+ `datasource_uid`memiliki UID dari sumber data yang menyebabkan negara.
+ Semua label dan anotasi aturan asli.

Anda dapat menangani peringatan ini sama seperti peringatan biasa, misalnya, dengan menambahkan keheningan, atau merutekan ke titik kontak.

**catatan**  
Jika aturan menggunakan beberapa sumber data dan satu atau lebih tidak mengembalikan data, peringatan khusus dibuat untuk setiap sumber data yang menyebabkan status peringatan.

# Memigrasi peringatan dasbor klasik ke peringatan Grafana
<a name="alert-opt-in"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Ruang kerja yang ada, atau ruang kerja yang memilih untuk tidak menggunakan peringatan Grafana, gunakan peringatan dasbor klasik. Untuk bermigrasi ke peringatan Grafana baru, Anda harus ikut serta dalam fitur tersebut.

Anda dapat mengonfigurasi instans Grafana Terkelola Amazon untuk menggunakan peringatan Grafana menggunakan API Grafana yang Dikelola Amazon Konsol Manajemen AWS, AWS CLI atau Amazon. Untuk detail tentang cara mengonfigurasi Grafana Terkelola Amazon, termasuk mengaktifkan atau menonaktifkan peringatan Grafana, lihat. [Konfigurasikan ruang kerja Grafana yang Dikelola Amazon](AMG-configure-workspace.md)

**catatan**  
Saat menggunakan peringatan Grafana, aturan peringatan yang ditentukan di Grafana, bukan di Prometheus, kirim beberapa pemberitahuan ke titik kontak Anda. Jika Anda menggunakan peringatan Grafana asli, kami sarankan Anda tetap menggunakan peringatan dasbor klasik dan tidak mengaktifkan fitur peringatan Grafana baru. Jika Anda ingin melihat Peringatan yang ditentukan dalam sumber data Prometheus Anda, maka kami sarankan Anda mengaktifkan Peringatan Grafana, yang hanya mengirimkan satu pemberitahuan untuk peringatan yang dibuat di Prometheus Alertmanager.  
Batasan ini dihapus di ruang kerja Grafana Terkelola Amazon yang mendukung Grafana v10.4 dan yang lebih baru.

## Bermigrasi ke sistem peringatan Grafana
<a name="alert-opt-in-migrating"></a>

Saat peringatan Grafana diaktifkan, peringatan dasbor klasik yang ada bermigrasi dalam format yang kompatibel dengan peringatan Grafana. Di halaman Peringatan instans Grafana Anda, Anda dapat melihat peringatan yang dimigrasi bersama peringatan baru. Dengan peringatan Grafana, aturan peringatan yang dikelola Grafana Anda mengirim beberapa notifikasi, bukan satu peringatan saat dicocokkan.

Akses baca dan tulis ke lansiran dasbor klasik dan peringatan Grafana diatur oleh izin folder yang menyimpannya. Selama migrasi, izin peringatan dasbor klasik dicocokkan dengan izin aturan baru sebagai berikut:
+ Jika dasbor peringatan asli memiliki izin, migrasi akan membuat folder bernama dengan format ini `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` agar sesuai dengan izin dasbor asli (termasuk izin yang diwariskan dari folder).
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder, maka aturan tersebut ditautkan ke folder ini dan mewarisi izinnya.
+ Jika tidak ada izin dasbor dan dasbor berada di bawah folder Umum, maka aturan tersebut ditautkan ke folder General Alerting, dan aturan mewarisi izin default.

**catatan**  
Karena tidak ada `Keep Last State` opsi untuk `NoData` peringatan Grafana, opsi ini menjadi `NoData` selama migrasi aturan klasik. Opsi `Keep Last State` untuk `Error` penanganan dimigrasikan ke opsi `Error` baru. Untuk mencocokkan perilaku`Keep Last State`, dalam kedua kasus, selama migrasi Grafana yang Dikelola Amazon secara otomatis membuat keheningan untuk setiap aturan peringatan dengan durasi satu tahun.

Saluran notifikasi dimigrasikan ke konfigurasi Alertmanager dengan rute dan penerima yang sesuai. Saluran pemberitahuan default ditambahkan sebagai titik kontak ke rute default. Saluran pemberitahuan yang tidak terkait dengan peringatan Dasbor apa pun masuk ke `autogen-unlinked-channel-recv` rute.

### Batasan
<a name="alert-migration-limitations"></a>
+ Sistem peringatan Grafana dapat mengambil aturan dari semua sumber data Prometheus, Loki, dan Alertmanager yang tersedia. Mungkin tidak dapat mengambil aturan peringatan dari sumber data lain yang didukung.
+ Migrasi bolak-balik antara peringatan Grafana dan peringatan dasbor klasik dapat mengakibatkan hilangnya data untuk fitur yang didukung dalam satu sistem, tetapi tidak yang lain.
**catatan**  
Jika Anda bermigrasi kembali ke peringatan dasbor klasik, Anda kehilangan semua perubahan yang dibuat pada konfigurasi peringatan yang dibuat saat peringatan Grafana diaktifkan, termasuk aturan peringatan baru yang dibuat.

# Memperingatkan dasar-dasar
<a name="alert-fundamentals"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Bagian ini memberikan informasi tentang konsep dasar peringatan Grafana.

## Konsep peringatan
<a name="alert-fundamentals-terms"></a>

Tabel berikut menjelaskan konsep-konsep kunci dalam peringatan Grafana.


| Konsep atau fitur kunci | Definisi | 
| --- | --- | 
|  Sumber data untuk Peringatan  |  Pilih sumber data yang ingin Anda kueri dan visualisasikan metrik, log, dan jejak.  | 
|  Penjadwal  |  Mengevaluasi aturan peringatan Anda; komponen yang secara berkala menjalankan kueri terhadap sumber data. Ini hanya berlaku untuk aturan yang dikelola Grafana.  | 
|  Pengelola Peringatan  |  Mengelola perutean dan pengelompokan instance peringatan.  | 
|  Aturan peringatan  |  Seperangkat kriteria evaluasi kapan aturan peringatan harus ditembakkan. Aturan peringatan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan durasi di mana kondisi terpenuhi. Aturan peringatan dapat menghasilkan beberapa instance peringatan.  | 
|  Contoh peringatan  |  Sebuah instance peringatan adalah contoh dari aturan peringatan. Aturan peringatan satu dimensi memiliki satu contoh peringatan. Aturan peringatan multidimensi memiliki satu atau lebih contoh peringatan. Aturan peringatan tunggal yang cocok dengan beberapa hasil, seperti CPU terhadap 10 VMs, dihitung sebagai beberapa (dalam hal ini 10) instance peringatan. Jumlah ini dapat bervariasi dari waktu ke waktu. Misalnya, aturan peringatan yang memantau penggunaan CPU untuk semua VMs dalam sistem memiliki lebih banyak instance peringatan seperti VMs yang ditambahkan. Untuk informasi selengkapnya tentang kuota instance peringatan, lihat. [Kuota mencapai kesalahan](alert-rules.md#rule-quota-reached)  | 
|  Grup peringatan  |  Alertmanager mengelompokkan instance peringatan secara default menggunakan label untuk kebijakan notifikasi root. Ini mengontrol de-duplikasi dan grup instance peringatan yang dikirim ke titik kontak.  | 
|  Titik kontak  |  Tentukan bagaimana kontak Anda diberi tahu saat aturan peringatan diaktifkan.  | 
|  Templating pesan  |  Buat templat khusus yang dapat digunakan kembali dan gunakan di titik kontak.  | 
|  Kebijakan pemberitahuan  |  Set aturan untuk di mana, kapan, dan bagaimana peringatan dikelompokkan dan diarahkan ke titik kontak.  | 
|  Label dan pencocokan label  |  Label secara unik mengidentifikasi aturan peringatan. Mereka menghubungkan aturan peringatan dengan kebijakan pemberitahuan dan pembungkaman, menentukan kebijakan mana yang harus menanganinya dan aturan peringatan mana yang harus dibungkam.  | 
|  Keheningan  |  Hentikan pemberitahuan dari satu atau beberapa contoh peringatan. Perbedaan antara keheningan dan waktu bisu adalah bahwa keheningan berlangsung selama jendela waktu tertentu di mana waktu bisu terjadi pada jadwal berulang. Menggunakan pencocokan label untuk membungkam instance peringatan.  | 
|  Bisukan waktu  |  Tentukan interval waktu saat Anda tidak ingin notifikasi baru dibuat atau dikirim. Anda dapat membekukan notifikasi peringatan untuk periode waktu berulang, seperti selama periode pemeliharaan. Harus ditautkan ke kebijakan pemberitahuan yang ada.  | 

## Sumber data peringatan
<a name="alert-sources"></a>

Grafana lansiran terkelola menanyakan sumber data backend berikut yang mengaktifkan peringatan.
+ Sumber data bawaan, atau dikembangkan dan dikelola oleh Grafana:,,, `Prometheus` (termasuk Layanan Terkelola Amazon untuk Prometheus) `Alertmanager``Graphite`,,,,,,,,,,,,,,,,,,,,,,,,,,`Loki`,,`InfluxDB`,,`Amazon OpenSearch Service`,, `Google Cloud Monitoring``Amazon CloudWatch`, `Azure Monitor` dan. `MySQL` `PostgreSQL` `MSSQL` `OpenTSDB` `Oracle` `Azure Monitor`

## Peringatan pada data numerik
<a name="alert-numeric"></a>

Data numerik yang tidak dalam format deret waktu dapat langsung diperingatkan, atau diteruskan ke Server Side Expressions. Hal ini memungkinkan untuk lebih banyak pemrosesan dan menghasilkan efisiensi dalam sumber data, dan juga dapat menyederhanakan aturan peringatan. Saat memperingatkan data numerik alih-alih data deret waktu, tidak perlu mengurangi setiap deret waktu berlabel menjadi satu angka. Sebaliknya nomor berlabel dikembalikan ke Grafana sebagai gantinya.

### Data tabular
<a name="alert-tabular-data"></a>

Fitur ini didukung dengan sumber data backend yang menanyakan data tabular, termasuk sumber data SQL, seperti MySQL, Postgres, MSSQL, dan Oracle.

Kueri dengan peringatan terkelola Grafana atau Ekspresi Sisi Server dianggap numerik dengan sumber data ini:
+ Jika `Format AS` opsi diatur ke `Table` dalam kueri sumber data.
+ Jika respons tabel dikembalikan ke Grafana dari kueri hanya mencakup satu kolom numerik (misalnya, int, ganda, atau float), dan kolom string tambahan opsional.

Jika ada kolom string, maka kolom tersebut menjadi label. Nama kolom menjadi nama label, dan nilai untuk setiap baris menjadi nilai label yang sesuai. Jika beberapa baris dikembalikan, maka setiap baris harus diidentifikasi secara unik oleh labelnya.

### Contoh
<a name="alert-tabular-example"></a>

Jika Anda memiliki tabel MySQL yang disebut Diskspace, sebagai berikut.


| Waktu | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
|  2021-Juni-7  |  web1  |  /dll  |  3  | 
|  2021-Juni-7  |  web2  |  /var  |  4  | 
|  2021-Juni-7  |  web3  |  /var  |  8  | 
|  …  |  …  |  …  |  …  | 

Anda dapat menanyakan pemfilteran data tepat waktu, tetapi tanpa mengembalikan deret waktu ke Grafana. Misalnya, peringatan yang akan dimulai per Host, Disk ketika ada kurang dari 5% ruang kosong bisa terlihat seperti berikut.

```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
  SELECT
      Host,
      Disk,
      Avg(PercentFree)
  FROM DiskSpace
  Group By
    Host,
    Disk
  Where __timeFilter(Time)
```

Query ini mengembalikan respon tabel berikut untuk Grafana.


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /dll  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

Ketika kueri ini digunakan sebagai **kondisi** dalam aturan peringatan, maka kasus di mana nilainya adalah peringatan bukan nol. Akibatnya, tiga contoh peringatan diproduksi, seperti tabel berikut.


| Label | Status | 
| --- | --- | 
|  \$1host = web1, disk =/dll\$1  |  Peringatan  | 
|  \$1host = web2, disk =/var\$1  |  Peringatan  | 
|  \$1host = web3, disk =/var\$1  |  Normal  | 

## Pengelola Peringatan
<a name="alert-alertmanager"></a>

Grafana menyertakan dukungan bawaan untuk Prometheus Alertmanager. Alertmanager membantu mengelompokkan dan mengelola aturan peringatan, menambahkan lapisan orkestrasi di atas mesin peringatan. Secara default, notifikasi untuk lansiran terkelola Grafana ditangani oleh Alertmanager tertanam yang merupakan bagian dari Grafana inti. Anda dapat mengonfigurasi titik kontak, kebijakan notifikasi, dan templat Alertmanager dari UI peringatan Grafana dengan memilih opsi Grafana dari tarik-turun Alertmanager.

Grafana alert memiliki dukungan untuk konfigurasi Alertmanager eksternal (untuk informasi selengkapnya tentang Alertmanager sebagai sumber data eksternal, lihat). [Connect ke sumber data Alertmanager](data-source-alertmanager.md) Saat Anda menambahkan Alertmanager eksternal, dropdown Alertmanager menampilkan daftar sumber data Alertmanager eksternal yang tersedia. Pilih sumber data untuk membuat dan mengelola peringatan untuk sumber data Cortex atau Loki mandiri.

## Keadaan dan kesehatan aturan peringatan
<a name="alerts-state"></a>

Keadaan dan kesehatan aturan peringatan membantu Anda memahami beberapa indikator status utama tentang peringatan Anda. Ada tiga komponen utama: status peringatan, status aturan peringatan, dan kesehatan aturan peringatan. Meskipun terkait, setiap komponen menyampaikan informasi yang sedikit berbeda.

**Status aturan peringatan**
+ **Normal** — Tidak ada deret waktu yang dikembalikan oleh mesin evaluasi dalam `Firing` keadaan `Pending` atau.
+ **Tertunda** — Setidaknya satu dari deret waktu yang dikembalikan oleh mesin evaluasi adalah`Pending`.
+ **Penembakan** — Setidaknya satu dari deret waktu yang dikembalikan oleh mesin evaluasi adalah`Firing`.

**Status peringatan**
+ **Normal** — Kondisi untuk aturan peringatan **salah** untuk setiap deret waktu yang dikembalikan oleh mesin evaluasi.
+ **Peringatan** — Kondisi aturan peringatan **berlaku** untuk setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi. Durasi di mana kondisi harus benar sebelum peringatan dimulai, jika disetel, terpenuhi atau telah terlampaui.
+ **Tertunda** — Kondisi aturan peringatan **berlaku** untuk setidaknya satu deret waktu yang dikembalikan oleh mesin evaluasi. Durasi kondisinya harus benar sebelum peringatan dimulai, jika disetel, belum terpenuhi.
+ **NoData**— Aturan peringatan belum mengembalikan deret waktu, semua nilai untuk deret waktu adalah nol, atau semua nilai untuk deret waktu adalah nol.
+ **Kesalahan** — Kesalahan saat mencoba mengevaluasi aturan peringatan.

**Memperingatkan kesehatan aturan**
+ **Ok** - Tidak ada kesalahan saat mengevaluasi aturan peringatan.
+ **Kesalahan** — Kesalahan saat mengevaluasi aturan peringatan.
+ **NoData**- Tidak adanya data dalam setidaknya satu deret waktu yang dikembalikan selama evaluasi aturan.

# Membuat dan mengelola aturan peringatan Grafana
<a name="alert-rules"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Aturan peringatan adalah seperangkat kriteria evaluasi yang menentukan apakah peringatan dimulai. Aturan terdiri dari satu atau lebih pertanyaan dan ekspresi, kondisi, frekuensi evaluasi, dan opsional durasi di mana kondisi terpenuhi.

Sementara kueri dan ekspresi memilih kumpulan data untuk dievaluasi, kondisi menetapkan ambang batas yang harus dipenuhi peringatan, atau melebihi untuk membuat peringatan. Interval menentukan seberapa sering aturan peringatan dievaluasi. Durasi, ketika dikonfigurasi, menunjukkan berapa lama suatu kondisi harus dipenuhi. Aturan juga dapat menentukan perilaku peringatan tanpa adanya data.

Bagian berikut menjelaskan pembuatan dan pengelolaan berbagai jenis aturan peringatan Grafana.

**Topics**
+ [Membuat aturan peringatan terkelola Cortex atau Loki](#create-alert-rule)
+ [Membuat aturan perekaman terkelola Cortex atau Loki](#create-alert-recording-rule)
+ [Membuat aturan peringatan terkelola Grafana](#create-grafana-alert-rule)
+ [Anotasi dan label untuk aturan peringatan](#alert-rule-labels)
+ [Mengelola aturan peringatan](#manage-alert-rules)
+ [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups)

## Membuat aturan peringatan terkelola Cortex atau Loki
<a name="create-alert-rule"></a>

Menggunakan Grafana, Anda dapat membuat aturan peringatan untuk instance Cortex atau Loki eksternal.

**catatan**  
Cortex adalah database deret waktu yang digunakan oleh Amazon Managed Service untuk sumber data Prometheus dan Prometheus.

**Prasyarat**
+ Verifikasi bahwa Anda memiliki izin menulis ke sumber data Prometheus. Jika tidak, Anda tidak dapat membuat atau memperbarui aturan peringatan terkelola Cortex.
+ Untuk sumber data Cortex dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
  + **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
  + **Cortex** — Gunakan `/api/prom` awalan warisan, bukan. `/prometheus` Sumber data Prometheus mendukung Cortex dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk menambahkan aturan peringatan terkelola Cortex atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari dropdown **tipe Aturan**, pilih peringatan terkelola **Cortex/Loki**.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada di dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tambahkan kondisi.

   Dalam Untuk kotak teks kondisi, tentukan durasi kondisinya harus benar sebelum peringatan dimulai. Jika Anda menentukan`5m`, kondisi harus benar selama lima menit sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi terpenuhi, peringatan masuk ke `Pending` negara. Jika kondisi tetap aktif selama durasi yang ditentukan, peringatan akan beralih ke `Firing` status. Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Pratinjau lansiran** untuk mengevaluasi aturan dan melihat peringatan apa yang akan dihasilkannya. Ini menampilkan daftar peringatan dengan status dan nilai masing-masing.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

## Membuat aturan perekaman terkelola Cortex atau Loki
<a name="create-alert-recording-rule"></a>

Anda dapat membuat dan mengelola aturan perekaman untuk instance Cortex atau Loki eksternal. Aturan perekaman menghitung ekspresi yang sering dibutuhkan atau ekspresi mahal secara komputasi terlebih dahulu dan menyimpan hasilnya sebagai rangkaian waktu baru. Menanyakan deret waktu baru ini lebih cepat, terutama untuk dasbor karena mereka menanyakan ekspresi yang sama setiap kali dasbor disegarkan.

**Prasyarat**

Untuk sumber data Cortex dan Loki, aktifkan API penggaris dengan mengonfigurasi layanan masing-masing.
+ **Loki** — Jenis penyimpanan `local` aturan, default untuk sumber data Loki, hanya mendukung tampilan aturan. Untuk mengedit aturan, konfigurasikan salah satu jenis penyimpanan lainnya.
+ **Korteks** — Saat mengonfigurasi sumber data Grafana Prometheus untuk menunjuk ke Cortex, gunakan awalan lama, bukan. `/api/prom` `/prometheus` Sumber data Prometheus mendukung Cortex dan Prometheus, dan Grafana mengharapkan bahwa API Kueri dan API Penggaris berada di bawah URL yang sama. Anda tidak dapat memberikan URL terpisah untuk Ruler API.

**catatan**  
**Jika Anda tidak ingin mengelola aturan peringatan untuk sumber data Loki atau Prometheus tertentu, buka pengaturannya dan hapus kotak centang Kelola peringatan melalui UI Peringatan.**

**Untuk menambahkan aturan perekaman terkelola Cortex atau Loki**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut.
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + Dari dropdown **tipe Aturan**, pilih peringatan terkelola **Cortex/Loki**.
   + Dari menu tarik-turun **Pilih sumber data**, pilih Prometheus, atau sumber data Loki.
   + Dari dropdown **Namespace**, pilih namespace aturan yang ada. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Ruang nama dapat berisi satu atau lebih grup aturan dan hanya memiliki tujuan organisasi. Untuk informasi selengkapnya, lihat [Grup aturan dan ruang nama Cortex atau Loki](#alert-rule-groups).
   + Dari dropdown **Grup**, pilih grup yang ada di dalam namespace yang dipilih. Jika tidak, pilih **Tambahkan baru** dan masukkan nama untuk membuatnya. Aturan yang baru dibuat ditambahkan ke akhir grup. Aturan dalam grup dijalankan secara berurutan pada interval reguler, dengan waktu evaluasi yang sama.

1. Pada **Langkah 2**, tambahkan kueri untuk mengevaluasi.

   Nilai dapat berupa ekspresi promQL atau logQL. Aturan memulai peringatan jika hasil evaluasi memiliki setidaknya satu seri dengan nilai yang lebih besar dari 0. Peringatan dibuat untuk setiap seri.

1. Pada **Langkah 3**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

## Membuat aturan peringatan terkelola Grafana
<a name="create-grafana-alert-rule"></a>

Grafana memungkinkan Anda membuat aturan peringatan yang menanyakan satu atau lebih sumber data, mengurangi atau mengubah hasil dan membandingkannya satu sama lain atau untuk memperbaiki ambang batas. Ketika ini diproses, Grafana mengirimkan pemberitahuan ke titik kontak.

**catatan**  
Membuat aturan peringatan terkelola Grafana saat menggunakan peringatan Grafana menyebabkan beberapa notifikasi dikirim saat aturan dicocokkan. Beberapa penyedia titik kontak mungkin memiliki opsi yang dapat dikonfigurasi untuk menghapus duplikat notifikasi.

**Untuk menambahkan aturan terkelola Grafana**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel) untuk membuka halaman Peringatan yang mencantumkan** **peringatan** yang ada.

1. Pilih **Aturan peringatan baru**.

1. Pada **Langkah 1**, tambahkan nama aturan, jenis dan lokasi penyimpanan, sebagai berikut:
   + Dalam **nama Aturan**, tambahkan nama deskriptif. Nama ini ditampilkan dalam daftar aturan peringatan. Ini juga merupakan `alertname` label untuk setiap instance peringatan yang dibuat dari aturan ini.
   + **Dari tarik-turun **Jenis aturan**, pilih Grafana managed alert.**
   + Dari dropdown **Folder**, pilih folder tempat Anda ingin menyimpan aturan. Jika Anda tidak memilih folder, aturan disimpan dalam `General` folder. Untuk membuat folder, pilih dropdown dan masukkan nama folder baru.

1. Pada **Langkah 2**, tambahkan kueri dan ekspresi untuk mengevaluasi.
   + Simpan nama default atau arahkan kursor ke atas dan pilih ikon edit untuk mengubah nama.
   + Untuk kueri, pilih sumber data dari dropdown.
   + Tambahkan satu atau beberapa [kueri](panel-queries.md) atau ekspresi (untuk detail tentang ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dalam dokumentasi *Grafana*).
   + Untuk setiap ekspresi, pilih salah satu **kondisi Klasik** untuk membuat aturan peringatan tunggal, atau pilih dari opsi **Matematika**, **Kurangi**, **Sampel ulang** untuk menghasilkan peringatan terpisah untuk setiap seri. Untuk detail tentang opsi ini, lihat[Aturan tunggal dan multidimensi](#single-multi-rule).
   + Pilih **Jalankan kueri** untuk memverifikasi bahwa kueri berhasil.

1. Pada **Langkah 3**, tambahkan kondisi.
   + Dari **kondisi** tarik-turun, pilih kueri atau ekspresi untuk memulai aturan peringatan.
   + Untuk **Evaluasi setiap**, tentukan frekuensi evaluasi. Harus kelipatan 10 detik. Misalnya,`1m`,`30s`.
   + **Untuk Evaluasi** untuk, tentukan durasi kondisinya harus benar sebelum peringatan dimulai.
**catatan**  
Setelah suatu kondisi dilanggar, peringatan masuk ke `Pending` status. Jika kondisi tetap dilanggar selama durasi yang ditentukan, peringatan akan beralih ke status. `Firing` Jika tidak lagi terpenuhi, ia kembali ke `Normal` negara.
   + Di **Konfigurasikan tidak ada data dan penanganan kesalahan**, konfigurasikan perilaku peringatan jika tidak ada data. gunakan pedoman di. [Tidak menangani data atau kasus kesalahan](#rule-no-data-error)
   + Pilih **Pratinjau lansiran** untuk memeriksa hasil menjalankan kueri saat ini. Pratinjau mengecualikan tidak ada data dan kondisi penanganan kesalahan.

1. Pada **Langkah 4**, tambahkan metadata tambahan yang terkait dengan aturan.
   + Tambahkan deskripsi dan ringkasan untuk menyesuaikan pesan peringatan. Gunakan pedoman di[Anotasi dan label untuk aturan peringatan](#alert-rule-labels).
   + Tambahkan URL Runbook, panel, dasbor, dan peringatan IDs.
   + Tambahkan label khusus.

1. Pilih **Simpan** untuk menyimpan aturan atau **Simpan dan keluar** untuk menyimpan aturan dan kembali ke halaman **Peringatan**.

### Aturan tunggal dan multidimensi
<a name="single-multi-rule"></a>

Untuk aturan peringatan terkelola Grafana, Anda dapat membuat aturan dengan kondisi klasik atau Anda dapat membuat aturan multidimensi.

**Aturan dimensi tunggal (kondisi klasik)**

Gunakan ekspresi kondisi klasik untuk membuat aturan yang memulai peringatan tunggal ketika kondisinya terpenuhi. Untuk kueri yang mengembalikan beberapa seri, Grafana tidak melacak status peringatan setiap seri. Akibatnya, Grafana hanya mengirimkan satu peringatan bahkan ketika kondisi peringatan terpenuhi untuk beberapa seri.

Untuk informasi selengkapnya tentang cara memformat ekspresi, lihat [Ekspresi](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dalam dokumentasi *Grafana*.

**Aturan multidimensi**

Untuk menghasilkan instance peringatan terpisah untuk setiap seri yang dikembalikan dalam kueri, buat aturan multidimensi.

**catatan**  
Setiap instance peringatan yang dihasilkan oleh aturan multi-dimensi diperhitungkan dalam total kuota peringatan Anda. Aturan tidak dievaluasi ketika Anda mencapai kuota peringatan Anda. Untuk informasi selengkapnya tentang kuota untuk aturan multi-dimensi, lihat. [Kuota mencapai kesalahan](#rule-quota-reached)

Untuk membuat beberapa instance dari satu aturan, gunakan `Math``Reduce`, atau `Resample` ekspresi untuk membuat aturan multidimensi. Sebagai contoh, Anda dapat:
+ Tambahkan `Reduce` ekspresi untuk setiap kueri ke nilai agregat dalam rentang waktu yang dipilih menjadi satu nilai. (Tidak diperlukan untuk [aturan menggunakan data numerik](alert-fundamentals.md#alert-numeric)).
+ Tambahkan `Math` ekspresi dengan kondisi untuk aturan. Ini tidak diperlukan jika kueri atau ekspresi pengurangan sudah mengembalikan 0 jika aturan tidak harus memulai peringatan, atau angka positif jika harus memulai peringatan. 

  Beberapa contoh: 
  + `$B > 70`jika harus memulai peringatan jika nilai B query/expression lebih dari 70. 
  + `$B < $C * 100`dalam hal itu harus memulai peringatan jika nilai B kurang dari nilai C dikalikan dengan 100. Jika kueri yang dibandingkan memiliki beberapa seri dalam hasilnya, seri dari kueri yang berbeda dicocokkan jika mereka memiliki label yang sama, atau satu adalah bagian dari yang lain.

**catatan**  
Grafana tidak mendukung kueri peringatan dengan variabel template. Informasi lebih lanjut tersedia di halaman komunitas [Variabel Template tidak didukung dalam kueri peringatan saat menyiapkan Peringatan](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Pertimbangan kinerja untuk aturan multidimensi**

Setiap instance peringatan dihitung terhadap kuota peringatan. Aturan multidimensi yang membuat lebih banyak instance daripada yang dapat diakomodasi dalam kuota peringatan tidak dievaluasi dan mengembalikan kesalahan kuota. Untuk informasi selengkapnya, lihat [Kuota mencapai kesalahan](#rule-quota-reached).

Peringatan multidimensi dapat berdampak tinggi pada kinerja ruang kerja Grafana Anda, serta kinerja sumber data Anda saat Grafana menanyakannya untuk mengevaluasi aturan peringatan Anda. Pertimbangan berikut dapat membantu saat Anda mencoba mengoptimalkan kinerja sistem pemantauan Anda.
+ **Frekuensi evaluasi aturan — Evaluasi** **Setiap** properti dari aturan peringatan mengontrol frekuensi evaluasi aturan. Kami merekomendasikan menggunakan frekuensi evaluasi terendah yang dapat diterima. 
+ **Hasil set kardinalitas** — Jumlah instance peringatan yang Anda buat dengan aturan memengaruhi kinerjanya. Misalkan Anda memantau kesalahan respons API untuk setiap jalur API, di setiap VM di armada Anda. Set ini memiliki kardinalitas jumlah jalur dikalikan dengan jumlah. VMs Anda dapat mengurangi kardinalitas set hasil, misalnya, dengan memantau kesalahan total per VM, bukan per jalur per VM.
+ **Kompleksitas kueri — Kueri** yang sumber data dapat memproses dan merespons dengan cepat mengkonsumsi lebih sedikit sumber daya. Meskipun pertimbangan ini kurang penting daripada pertimbangan lain yang tercantum di atas, jika Anda telah menguranginya sebanyak mungkin, melihat kinerja kueri individu dapat membuat perbedaan. Anda juga harus menyadari dampak kinerja yang mengevaluasi aturan ini terhadap sumber data Anda. Kueri peringatan seringkali merupakan sebagian besar kueri yang ditangani oleh database pemantauan, jadi faktor beban yang sama yang memengaruhi instance Grafana juga memengaruhi mereka.

### Kuota mencapai kesalahan
<a name="rule-quota-reached"></a>

Ada kuota untuk jumlah instance peringatan yang dapat Anda miliki dalam satu ruang kerja. Ketika Anda mencapai nomor itu, Anda tidak dapat lagi membuat aturan peringatan baru di ruang kerja itu. Dengan peringatan multidimensi, jumlah instance peringatan dapat bervariasi dari waktu ke waktu.

Berikut ini penting untuk diingat saat bekerja dengan instance peringatan.
+ Jika Anda hanya membuat aturan satu dimensi, setiap aturan adalah contoh peringatan tunggal. Anda dapat membuat jumlah aturan yang sama dalam satu ruang kerja dengan kuota instans peringatan, dan tidak lebih.
+ Aturan multidimensi membuat beberapa contoh peringatan, namun jumlahnya tidak diketahui sampai dievaluasi. Misalnya, jika Anda membuat aturan peringatan yang melacak penggunaan CPU instans Amazon EC2 Anda, mungkin ada 50 instans EC2 saat Anda membuatnya (dan karenanya 50 instans peringatan), tetapi jika Anda menambahkan 10 instans EC2 lagi seminggu kemudian, evaluasi berikutnya memiliki 60 instance peringatan.

  Jumlah instans peringatan dievaluasi ketika Anda membuat peringatan multidimensi, dan Anda tidak dapat membuat satu yang segera menempatkan Anda di atas kuota instance peringatan Anda. Karena jumlah instans peringatan dapat berubah, kuota Anda akan diperiksa setiap kali aturan Anda dievaluasi.
+ Pada waktu evaluasi aturan, jika aturan menyebabkan Anda melampaui kuota untuk instance peringatan, aturan tersebut tidak dievaluasi hingga pembaruan dibuat pada aturan peringatan yang membawa jumlah total instance peringatan di bawah kuota layanan. Ketika ini terjadi, Anda menerima pemberitahuan peringatan yang memberi tahu Anda bahwa kuota Anda telah tercapai (notifikasi menggunakan kebijakan notifikasi untuk aturan yang sedang dievaluasi). Pemberitahuan mencakup `Error` anotasi dengan nilai`QuotaReachedError`.
+ Aturan yang menyebabkan `QuotaReachedError` berhenti dievaluasi. Evaluasi hanya dilanjutkan ketika pembaruan dilakukan dan evaluasi setelah pembaruan tidak sendiri menyebabkan a. `QuotaReachedError` Aturan yang tidak dievaluasi menunjukkan kesalahan **Kuota yang dicapai** di konsol Grafana.
+ Anda dapat menurunkan jumlah instance peringatan dengan menghapus aturan peringatan, atau dengan mengedit peringatan multidimensi agar lebih sedikit instance peringatan (misalnya, dengan memiliki satu peringatan tentang kesalahan per VM, daripada satu peringatan tentang kesalahan per API di VM).
+ Untuk melanjutkan evaluasi, perbarui peringatan dan simpan. Anda dapat memperbaruinya untuk menurunkan jumlah instance peringatan, atau jika Anda telah membuat perubahan lain untuk menurunkan jumlah instance peringatan, Anda dapat menyimpannya tanpa perubahan. Jika bisa dilanjutkan, memang begitu. Jika itu menyebabkan yang lain`QuotaReachedError`, Anda tidak dapat menyimpannya.
+ Ketika peringatan disimpan dan melanjutkan evaluasi tanpa melewati kuota peringatan, kesalahan **Kuota tercapai** dapat terus ditampilkan di konsol Grafana untuk beberapa waktu (hingga interval evaluasinya), namun, evaluasi aturan peringatan akan dimulai dan peringatan dikirim jika ambang batas aturan terpenuhi.
+ Untuk detail tentang kuota peringatan, serta kuota lainnya, lihat. [Kuota layanan Grafana yang Dikelola Amazon](AMG_quotas.md)

### Tidak menangani data atau kasus kesalahan
<a name="rule-no-data-error"></a>

Pilih opsi untuk cara menangani perilaku peringatan jika tidak ada data atau ketika ada kesalahan.

Opsi untuk menangani tidak ada data tercantum dalam tabel berikut.


| Tidak ada opsi Data | Perilaku | 
| --- | --- | 
|  Tidak ada Data  |  Buat peringatan `DatasourceNoData` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.  | 
|  Peringatan  |  Tetapkan status aturan peringatan ke`Alerting`.  | 
|  OK  |  Tetapkan status aturan peringatan ke`Normal`.  | 

Opsi untuk menangani kasus kesalahan tercantum dalam tabel berikut.


| Opsi kesalahan atau batas waktu | Perilaku | 
| --- | --- | 
|  Peringatan  |  Tetapkan status aturan peringatan ke `Alerting`  | 
|  OK  |  Tetapkan status aturan peringatan ke `Normal`  | 
|  Kesalahan  |  Buat peringatan `DatasourceError` dengan nama dan UID aturan peringatan, dan UID sumber data yang tidak mengembalikan data sebagai label.  | 

## Anotasi dan label untuk aturan peringatan
<a name="alert-rule-labels"></a>

Anotasi dan label adalah pasangan nilai kunci yang terkait dengan peringatan yang berasal dari aturan peringatan, respons sumber data, dan sebagai hasil dari evaluasi aturan peringatan. Mereka dapat digunakan dalam pemberitahuan peringatan secara langsung atau dalam [template](alert-message-templates.md) dan [fungsi template](alert-message-templates.md#alert-template-functions) untuk membuat kontak notifikasi secara dinamis.

**Anotasi**

Anotasi adalah pasangan nilai kunci yang memberikan informasi tambahan tentang peringatan. Anda dapat menggunakan anotasi berikut:`description`,,`summary`,`runbook_url`, `alertId``dashboardUid`, dan`panelId`. Ini ditampilkan dalam detail aturan dan peringatan di UI dan dapat digunakan dalam templat pesan titik kontak.

**Label**

Label adalah pasangan nilai kunci yang berisi informasi tentang peringatan. Label yang ditetapkan untuk peringatan dibuat dan ditambahkan ke seluruh evaluasi peringatan dan proses notifikasi. Mereka digunakan dengan cara-cara berikut.
+ Kumpulan label lengkap untuk peringatan secara unik mengidentifikasi peringatan itu dalam Peringatan Grafana.
+ [Alertmanager menggunakan label untuk mencocokkan peringatan untuk [keheningan](alert-silences.md) dan [grup peringatan](alert-groups.md) dalam kebijakan notifikasi.](alert-notifications.md)
+ UI peringatan menampilkan label untuk setiap instance peringatan yang dihasilkan oleh evaluasi aturan tersebut.
+ Titik kontak dapat mengakses label untuk menghasilkan notifikasi secara dinamis yang berisi informasi khusus untuk peringatan yang menghasilkan pemberitahuan.
+ Label dapat ditambahkan ke [aturan peringatan](#alert-rules). Label yang dikonfigurasi secara manual ini dapat menggunakan fungsi templat dan referensi label lain. Label yang ditambahkan ke aturan peringatan di sini diutamakan jika terjadi tabrakan antar label.

Variabel template berikut tersedia saat memperluas anotasi dan label.


| Nama | Deskripsi | 
| --- | --- | 
|  `$labels`  |  Label dari kueri atau kondisi. Misalnya, `{{ $labels.instance }}` dan `{{ $labels.job }}`. Ini tidak tersedia ketika aturan menggunakan kondisi klasik.  | 
|  `$values`  |  Nilai dari semua ekspresi reduce dan matematika yang dievaluasi untuk aturan peringatan ini. Misalnya,`{{ $values.A }}`, `{{ $values.A.Labels }}` dan `{{ $values.A.Value }}` di `A` mana `refID` ekspresinya. Ini tidak tersedia ketika aturan menggunakan kondisi klasik  | 
|  `$value`  |  String nilai dari instance peringatan. Misalnya, `[ var='A' labels={instance=foo} value=10 ]`.  | 

## Mengelola aturan peringatan
<a name="manage-alert-rules"></a>



Halaman **Peringatan mencantumkan** aturan peringatan. Secara default, aturan dikelompokkan berdasarkan jenis sumber data. Bagian **Grafana mencantumkan** aturan yang dikelola oleh Grafana, dan bagian **Cortex/Loki** mencantumkan aturan untuk sumber data yang kompatibel dengan Prometheus. Anda dapat melihat aturan peringatan untuk sumber data yang kompatibel dengan Prometheus tetapi Anda tidak dapat mengeditnya.

### Lihat aturan peringatan
<a name="manage-alerts-view"></a>

Menggunakan peringatan Grafana, Anda dapat melihat semua peringatan Anda dalam satu halaman.

**Untuk melihat detail peringatan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.** Secara default, aturan ditampilkan dalam grup berdasarkan tipe sumber data. Anda juga dapat melihat berdasarkan status saat ini dari setiap peringatan (ini dijelaskan secara lebih rinci dalam teks berikut).

1. Di **View as**, Anda dapat beralih antara tampilan grup dan status dengan memilih opsi yang Anda inginkan.

1. Pilih panah di sebelah baris untuk melihat detail lebih lanjut untuk baris itu. Detail untuk aturan mencakup label aturan, anotasi, sumber data, dan kueri, serta daftar instance peringatan yang dihasilkan dari aturan.

**Tampilan grup**

Tampilan grup menunjukkan aturan peringatan Grafana yang dikelompokkan berdasarkan folder dan aturan peringatan Loki atau Prometheus yang dikelompokkan berdasarkan \$1. `namespace` `group` Ini adalah tampilan daftar aturan default, yang ditujukan untuk mengelola aturan. Anda dapat memperluas setiap grup untuk melihat daftar aturan dalam grup ini. Perluas aturan lebih lanjut untuk melihat detailnya. Anda juga dapat memperluas tombol tindakan dan peringatan yang dihasilkan dari aturan untuk melihat detailnya.

**Tampilan negara**

Tampilan status menunjukkan aturan peringatan yang dikelompokkan berdasarkan negara bagian. Gunakan tampilan ini untuk mendapatkan gambaran umum tentang aturan mana yang berada dalam keadaan apa. Setiap aturan dapat diperluas untuk melihat detailnya. Tombol tindakan dan peringatan apa pun yang dihasilkan oleh aturan ini, dan setiap peringatan dapat diperluas lebih lanjut untuk melihat detailnya.

**Filter aturan peringatan**

Anda dapat memfilter aturan peringatan yang muncul di halaman **Peringatan dengan** beberapa cara.
+ Anda dapat memfilter untuk menampilkan aturan yang menanyakan sumber data tertentu dengan memilih **Pilih sumber data**, lalu memilih sumber data yang akan difilter.
+ Anda dapat memfilter berdasarkan label dengan memilih kriteria pencarian di **Cari berdasarkan label**. Beberapa kriteria sampel meliputi`environment=production`,`region=~US|EU`,`severity!=warning`.
+ Anda dapat memfilter untuk menampilkan aturan dalam keadaan tertentu dengan memilih **Menyaring peringatan menurut negara**, lalu memilih status yang ingin Anda lihat.

### Mengedit atau menghapus aturan peringatan
<a name="manage-alerts-edit"></a>

Aturan peringatan terkelola Grafana hanya dapat diedit atau dihapus oleh pengguna dengan izin Edit untuk folder yang menyimpan aturan. Aturan peringatan untuk instance Cortex atau Loki eksternal dapat diedit atau dihapus oleh pengguna dengan peran Editor atau Admin.

**Untuk mengedit atau menghapus aturan**

1. Perluas aturan hingga Anda dapat melihat kontrol aturan untuk **Lihat**, **Edit**, dan **Hapus**.

1. Pilih **Edit** untuk membuka halaman aturan buat. Buat pembaruan dengan cara yang sama seperti Anda membuat aturan. Untuk detailnya, lihat instruksi di [Membuat aturan peringatan terkelola Grafana](#create-grafana-alert-rule) atau[Membuat aturan peringatan terkelola Cortex atau Loki](#create-alert-rule).

1. Secara opsional, pilih **Hapus** untuk menghapus aturan.

## Grup aturan dan ruang nama Cortex atau Loki
<a name="alert-rule-groups"></a>

Anda dapat mengatur aturan Anda. Aturan dibuat dalam grup aturan, dan grup aturan diatur ke dalam ruang nama. Aturan dalam kelompok aturan dijalankan secara berurutan pada interval reguler. Interval default adalah satu menit. Anda dapat mengganti nama ruang nama Cortex atau Loki dan grup aturan, dan mengedit interval evaluasi grup aturan.

**Untuk mengedit grup aturan atau namespace**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Arahkan ke aturan dalam grup aturan atau namespace yang ingin Anda edit.

1. Pilih ikon **Edit** (pena).

1. Buat perubahan pada grup aturan atau namespace.
**catatan**  
Untuk ruang nama, Anda hanya dapat mengedit nama. Untuk grup aturan, Anda mengubah nama, atau interval evaluasi untuk aturan dalam grup. Misalnya, Anda dapat memilih `1m` agar aturan dievaluasi sekali per menit, atau `30s` mengevaluasi setiap 30 detik sekali.

1. Pilih **Simpan perubahan**.

# Grup peringatan
<a name="alert-groups"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Grup peringatan menampilkan peringatan yang dikelompokkan dari instance Alertmanager. Secara default, peringatan dikelompokkan berdasarkan kunci label untuk kebijakan root di. [Bekerja dengan kebijakan notifikasi](alert-notifications.md) Mengelompokkan peringatan umum ke dalam satu grup peringatan mencegah peringatan duplikat dimulai.

**Untuk melihat pengelompokan peringatan**

1. Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan (bel), lalu item **pengelompokan Peringatan** untuk membuka halaman yang mencantumkan** grup yang ada.

1. Dari drop-down **Alertmanager**, pilih Alertmanager eksternal sebagai sumber data Anda. Secara default, `Grafana` Alertmanager dipilih.

1. Dari **grup kustom menurut** drop-down, pilih kombinasi label untuk melihat pengelompokan selain default. Anda dapat menggunakan tampilan ini untuk men-debug atau memverifikasi pengelompokan kebijakan pemberitahuan Anda.

Peringatan tanpa label yang ditentukan dalam pengelompokan kebijakan root atau pengelompokan kustom, ditambahkan ke grup dengan header. `No grouping`

**Menyaring peringatan**

Anda dapat menggunakan filter berikut untuk melihat peringatan yang sesuai dengan kriteria tertentu:
+ **Cari berdasarkan label** — Di **Penelusuran**, masukkan label yang ada untuk melihat peringatan yang cocok dengan label. Misalnya, `environment=production``region=~US|EU`,`severity!=warning`.
+ **Filter peringatan menurut negara — Di **Negara** Bagian**, pilih dari `Active``Suppressed`, atau `Unprocessed` negara bagian untuk melihat peringatan di negara bagian itu.

# Membungkam pemberitahuan peringatan untuk sumber data Prometheus
<a name="alert-silences"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

*Untuk sumber data Alertmanager eksternal (termasuk Amazon Managed Service untuk Prometheus), Anda dapat menekan pemberitahuan peringatan dengan diam.* Keheningan hanya menghentikan pemberitahuan agar tidak dibuat: Keheningan tidak mencegah aturan peringatan dievaluasi, dan mereka tidak menghentikan peringatan instance agar tidak ditampilkan di antarmuka pengguna. Saat Anda membungkam peringatan, Anda menentukan jendela waktu untuk ditekan.

Anda dapat mengonfigurasi keheningan untuk sumber data Alertmanager eksternal.

**catatan**  
Untuk menekan pemberitahuan peringatan pada interval waktu reguler (misalnya, selama periode pemeliharaan rutin), gunakan [Bisukan waktu](alert-notifications.md#alert-notification-muting) bukan diam.

**Untuk menambahkan keheningan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Silences** untuk membuka halaman yang mencantumkan [titik kontak](alert-contact-points.md) yang ada.

1. Pilih Alertmanager eksternal dari dropdown **Alertmanager**.

1. Pilih **Keheningan Baru**.

1. Pilih tanggal mulai dan berakhir di **Silence start and end** untuk menunjukkan kapan keheningan akan berlaku dan kapan harus berakhir.

   Sebagai alternatif untuk mengatur waktu akhir, di **Durasi**, tentukan berapa lama keheningan diberlakukan. Ini secara otomatis memperbarui waktu akhir di bidang **Mulai dan Akhir Diam**.

1. Di bidang **Nama** dan **Nilai**, masukkan satu atau beberapa *Label Pencocokan*. Matcher menentukan aturan mana yang berlaku untuk keheningan. Pencocokan label dibahas secara lebih rinci mengikuti prosedur ini.

1. Secara opsional, tambahkan **Komentar**, atau ubah **Pencipta** untuk mengatur pemilik keheningan.

**Pencocokan label untuk penekanan peringatan**

Saat Anda membuat keheningan, Anda membuat satu set *label yang cocok* sebagai bagian dari keheningan. Ini adalah seperangkat aturan tentang label yang harus cocok agar peringatan ditekan. Label yang cocok terdiri dari tiga bagian:
+ **Label** — Nama label yang cocok. Itu harus sama persis dengan nama label peringatan.
+ **Operator** — Operator digunakan untuk membandingkan nilai label dengan nilai label yang cocok. Operator yang tersedia adalah:
  + `=`Pilih label yang nilainya sama persis dengan string yang disediakan.
  + `!=`Pilih label yang nilainya tidak cocok dengan string yang disediakan.
  + `=~`Pilih label yang nilainya cocok dengan nilai interpretasi regex dari string yang disediakan (string yang disediakan ditafsirkan sebagai ekspresi reguler).
  + `!=`Pilih label yang tidak cocok dengan ekspresi reguler yang disediakan.
+ **Nilai** — Nilai untuk mencocokkan nilai label. Ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.

Keheningan berakhir pada tanggal akhir yang ditunjukkan, tetapi Anda dapat mengakhiri penindasan secara manual kapan saja.

**Untuk mengakhiri keheningan secara manual**

1. Di halaman **Peringatan**, pilih **Silences** untuk melihat daftar keheningan yang ada.

1. Pilih keheningan yang ingin Anda akhiri, dan pilih **Unsilence**. Ini mengakhiri penindasan peringatan.
**catatan**  
Unsilencing mengakhiri penekanan peringatan, seolah-olah waktu akhir ditetapkan untuk waktu saat ini. Keheningan yang telah berakhir (secara otomatis atau manual) dipertahankan dan terdaftar selama lima hari. Anda tidak dapat menghapus keheningan dari daftar secara manual.

**Membuat tautan ke formulir pembuatan keheningan**

Anda dapat membuat URL ke formulir pembuatan diam dengan detail yang sudah diisi. Operator dapat menggunakan ini untuk menekan alarm dengan cepat selama acara operasional.

Saat membuat tautan ke formulir diam, gunakan parameter `matchers` kueri untuk menentukan label yang cocok, dan parameter `comment` kueri untuk menentukan komentar. `matchers`Parameter membutuhkan satu atau lebih nilai dalam bentuk`[label][operator][value]`, dipisahkan dengan koma.

**Contoh URL**

Untuk menautkan ke formulir diam, dengan label yang cocok `severity=critical` dan`cluster!~europe-.*`, dengan komentar yang mengatakan`Silencing critical EU alerts`, gunakan URL seperti berikut ini. Ganti *mygrafana* dengan nama host instance Grafana Anda.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Untuk menautkan ke halaman diam baru untuk Alertmanager eksternal, tambahkan parameter `alertmanager` kueri dengan nama sumber data Alertmanage, seperti. `alertmanager=myAlertmanagerdatasource`

# Bekerja dengan titik kontak
<a name="alert-contact-points"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Gunakan titik kontak untuk menentukan bagaimana kontak Anda diberi tahu saat peringatan dimulai. Titik kontak dapat memiliki satu atau lebih jenis titik kontak, misalnya, Amazon Simple Notification Service atau Slack. Ketika peringatan dimulai, pemberitahuan dikirim ke semua jenis titik kontak yang terdaftar untuk titik kontak. Secara opsional, gunakan [Menggunakan templat perpesanan](alert-message-templates.md) untuk menyesuaikan pesan notifikasi untuk jenis titik kontak.

**catatan**  
Anda dapat membuat dan mengedit titik kontak untuk peringatan terkelola Grafana. Titik kontak untuk peringatan Alertmanager hanya bisa dibaca.

## Bekerja dengan titik kontak
<a name="alert-working-contact-points"></a>

Prosedur berikut merinci cara menambahkan, mengedit, menguji, dan menghapus titik kontak.

**Untuk menambahkan titik kontak**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Titik kontak**, lalu **Titik kontak baru**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager. Grafana Alertmanager dipilih secara default.

1. Masukkan **Nama** untuk titik kontak.

1. Dari **tipe titik kontak**, pilih jenis, dan bidang wajib berdasarkan jenis itu. Misalnya, jika Anda memilih Slack, masukkan saluran Slack dan pengguna yang harus dihubungi.

1. Jika tersedia untuk titik kontak yang Anda pilih, secara opsional pilih **Pengaturan opsional** untuk menentukan pengaturan tambahan.

1. Di bawah **Pengaturan pemberitahuan**, pilih **Nonaktifkan pesan yang diselesaikan** secara opsional jika Anda tidak ingin diberi tahu saat peringatan diselesaikan.

1. Jika titik kontak Anda membutuhkan lebih banyak jenis titik kontak, Anda dapat memilih **jenis titik kontak baru** dan ulangi langkah-langkah untuk setiap jenis titik kontak yang diperlukan.

1. Pilih **Simpan titik kontak** untuk menyimpan perubahan Anda.

**Untuk mengedit titik kontak**

1. Pilih **Titik kontak** untuk melihat daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diedit, lalu pilih ikon **Edit** (pena).

1. Buat perubahan yang diperlukan, lalu pilih **Simpan titik kontak** untuk menyimpan perubahan Anda.

Setelah titik kontak Anda dibuat, Anda dapat mengirim pemberitahuan pengujian untuk memverifikasi bahwa itu dikonfigurasi dengan benar.

**Untuk mengirim pemberitahuan pengujian**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pilih titik kontak yang akan diuji, lalu pilih ikon **Edit** (pena).

1. Pilih ikon **Uji** (paper airplane).

1. Pilih apakah akan mengirim pemberitahuan pengujian yang telah ditentukan sebelumnya atau pilih **Kustom** untuk menambahkan anotasi dan label kustom Anda sendiri dalam pemberitahuan pengujian.

1. Pilih **Kirim pemberitahuan pengujian** untuk menguji peringatan dengan titik kontak yang diberikan.

Anda dapat menghapus titik kontak yang tidak digunakan oleh kebijakan pemberitahuan.

**Untuk menghapus titik kontak**

1. Pilih **Titik kontak** untuk membuka daftar titik kontak yang ada.

1. Pilih titik kontak yang akan dihapus, lalu pilih ikon **Hapus** (tempat sampah).

1. Di kotak dialog konfirmasi, pilih **Ya, hapus**.

**catatan**  
Jika titik kontak digunakan oleh kebijakan notifikasi, Anda harus menghapus kebijakan notifikasi atau mengeditnya untuk menggunakan titik kontak yang berbeda sebelum menghapus titik kontak.

## Daftar notifier yang didukung
<a name="alert-supported-notifiers"></a>


|  Nama  |  Tipe  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Tugas Pager  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Menggunakan templat perpesanan
<a name="alert-message-templates"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Pemberitahuan yang dikirim melalui [Bekerja dengan titik kontak](alert-contact-points.md) dibuat menggunakan *templat perpesanan*. Template default Grafana didasarkan pada [sistem template Go di mana beberapa bidang dievaluasi sebagai teks, sementara yang lain dievaluasi sebagai HTML (yang dapat memengaruhi pelolosan](https://golang.org/pkg/text/template)).

Karena sebagian besar bidang titik kontak dapat di-template, Anda dapat membuat templat khusus yang dapat digunakan kembali dan menggunakannya di beberapa titik kontak. [Data templat](#alert-template-data)Topik mencantumkan variabel yang tersedia untuk templating.

**Menggunakan template**

Template digunakan untuk membuat pesan. Misalnya, dengan pesan peringatan Slack, Anda dapat mengatur judul dan isi di titik kontak. Contoh berikut menunjukkan cara menggunakan templat default untuk membuat judul yang berisi jumlah peringatan yang ditembakkan dan diselesaikan, dan badan yang mencantumkan peringatan dan statusnya.
+ **Judul**:

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **Tubuh Teks**: 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

Anda dapat membuat template kustom Anda sendiri, seperti pada contoh berikut.
+ **Judul**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **Tubuh Teks**: 

  ```
  {{ template "mymessage" .}}
  ```

Berikut ini adalah contoh template.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Prosedur berikut menunjukkan cara membuat, mengedit, dan menghapus templat pesan khusus.

**Untuk membuat template pesan**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Titik kontak**.

1. Dari tarik-turun **Alertmanager**, pilih contoh Alertmanager yang ingin Anda buat template pesan. Defaultnya adalah Grafana Alertmanager.

1. Pilih **Tambahkan templat**.

1. Tambahkan **nama** deskriptif.

1. Tambahkan **Konten** untuk template, misalnya:

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   `define`Tag di bagian Konten memberikan nama template. Tag ini opsional, dan ketika dihilangkan, nama template berasal dari bidang **Nama**. Ketika keduanya ditentukan, itu adalah praktik terbaik untuk menjaga mereka tetap sama.

1. Pilih **Simpan template**.

**catatan**  
HTML dalam peringatan template pesan dirender sebagai teks, dengan karakter kontrol lolos. Rendering HTML dalam notifikasi yang dihasilkan tidak didukung oleh Grafana.

**Untuk mengedit template pesan**

1. Di halaman **Peringatan**, pilih **Titik kontak** untuk membuka daftar titik kontak.

1. Di **tabel Template**, temukan template yang ingin Anda edit, lalu pilih ikon **Edit** (pena).

1. Buat perubahan, lalu pilih **Simpan template**.

**Untuk menghapus template pesan**

1. Di halaman **Peringatan**, pilih **Titik kontak** untuk membuka daftar titik kontak.

1. Di **tabel Template**, temukan template yang ingin Anda hapus, lalu pilih ikon **Hapus** (tempat sampah).

1. Pilih **Ya, hapus** untuk menghapus template.

**Template bersarang**

Anda dapat menyematkan template dalam template lain.

Misalnya, Anda dapat menentukan fragmen template menggunakan `define` kata kunci:

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Anda kemudian dapat menyematkan template kustom dalam fragmen ini menggunakan kata kunci. `template` Contoh:

```
Alert summary:
{{ template "mytemplate" . }}
```

Anda dapat menggunakan opsi templat bawaan berikut untuk menyematkan templat khusus.


| Nama | Catatan | 
| --- | --- | 
|  `default.title`  |  Menampilkan informasi status tingkat tinggi.  | 
|  `default.message`  |  Menyediakan ringkasan pemformatan dan peringatan yang diselesaikan.  | 

**Contoh template kustom**

Berikut adalah contoh cara menggunakan templat khusus.

Template untuk membuat peringatan tunggal:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Template untuk merender seluruh pesan notifikasi:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## Data templat
<a name="alert-template-data"></a>

Data berikut diteruskan ke template pesan.


| Nama | Tipe | Catatan | 
| --- | --- | --- | 
|  `Receiver`  |  string  |  Nama titik kontak tempat notifikasi dikirim.  | 
|  `Status`  |  string  |  menembak jika setidaknya satu peringatan ditembakkan, jika tidak diselesaikan.  | 
|  `Alerts`  |  Pemberitahuan  |  Daftar objek peringatan yang disertakan dalam pemberitahuan ini (lihat di bawah).  | 
|  `GroupLabels`  |  KeyValue  |  Label peringatan ini dikelompokkan berdasarkan.  | 
|  `CommonLabels`  |  KeyValue  |  Label umum untuk semua peringatan yang disertakan dalam notifikasi ini.  | 
|  `CommonAnnotations`  |  KeyValue  |  Anotasi umum untuk semua peringatan yang disertakan dalam pemberitahuan ini.  | 
|  `ExternalURL`  |  string  |  Tautan kembali ke Grafana yang mengirim notifikasi. Jika menggunakan Alertmanager eksternal, tautan kembali ke Alertmanager ini.  | 

`Alerts`Jenis ini mengekspos dua fungsi untuk memfilter peringatan yang dikembalikan.
+ `Alerts.Firing`— Mengembalikan daftar peringatan penembakan.
+ `Alerts.Resolved`— Mengembalikan daftar peringatan diselesaikan.

**Peringatan (tipe)**

Jenis peringatan berisi data berikut.


| Nama | Tipe | Catatan | 
| --- | --- | --- | 
|  Status  |  string  |  `firing` atau `resolved`.  | 
|  Label  |  KeyValue  |  Satu set label yang dilampirkan pada peringatan.  | 
|  Anotasi  |  KeyValue  |  Satu set anotasi yang dilampirkan pada peringatan.  | 
|  StartsAt  |  waktu.waktu  |  Waktu peringatan mulai menembak.  | 
|  EndsAt  |  waktu.waktu  |  Hanya atur jika waktu akhir peringatan diketahui. Jika tidak, atur ke periode batas waktu yang dapat dikonfigurasi sejak peringatan terakhir diterima.  | 
|  GeneratorURL  |  string  |  Tautan balik ke Grafana atau Alertmanager eksternal.  | 
|  SilenceUrl  |  string  |  Tautkan ke grafana silence untuk dengan label untuk peringatan ini yang telah diisi sebelumnya. Hanya untuk peringatan terkelola Grafana.  | 
|  DashboardURL  |  string  |  Tautkan ke dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | 
|  PanelURL  |  string  |  Tautkan ke panel dasbor grafana, jika aturan peringatan milik salah satunya. Hanya untuk peringatan terkelola Grafana.  | 
|  Sidik jari  |  string  |  Sidik jari yang dapat digunakan untuk mengidentifikasi peringatan.  | 
|  ValueString  |  string  |  String yang berisi label dan nilai setiap ekspresi yang dikurangi dalam peringatan.  | 

**KeyValue jenis**

`KeyValue`Tipe adalah satu set pasangan key/value string yang mewakili label dan anotasi.

Selain akses langsung dari data yang disimpan sebagai a`KeyValue`, ada juga metode untuk menyortir, menghapus dan mengubah data.


| Nama | Pendapat | Pengembalian | Catatan | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  Daftar pasangan string kunci dan nilai yang diurutkan  |    | 
|  Menghapus  |  [] string  |  KeyValue  |  Mengembalikan salinan Key/Value peta tanpa kunci yang diberikan.  | 
|  Nama  |    |  [] string  |  Daftar nama label  | 
|  Nilai  |    |  [] string  |  Daftar nilai label  | 



## Fungsi template
<a name="alert-template-functions"></a>

Dengan menggunakan fungsi template, Anda dapat memproses label dan anotasi untuk menghasilkan notifikasi dinamis. Fungsi-fungsi berikut tersedia.


| Nama | Jenis Argumen | Jenis pengembalian | Deskripsi | 
| --- | --- | --- | --- | 
|  `humanize`  |  nomor atau string  |  string  |  Mengonversi angka ke format yang lebih mudah dibaca, menggunakan awalan metrik.  | 
|  `humanize1024`  |  nomor atau string  |  string  |  Seperti memanusiakan, tetapi menggunakan 1024 sebagai basis daripada 1000.  | 
|  `humanizeDuration`  |  nomor atau string  |  string  |  Mengonversi durasi dalam hitungan detik ke format yang lebih mudah dibaca.  | 
|  `humanizePercentage`  |  nomor atau string  |  string  |  Mengkonversi nilai rasio menjadi pecahan dari 100.  | 
|  `humanizeTimestamp`  |  nomor atau string  |  string  |  Mengonversi stempel waktu Unix dalam hitungan detik ke format yang lebih mudah dibaca.  | 
|  `title`  |  string  |  string  |  Strings.title, mengkapitalisasi karakter pertama dari setiap kata.  | 
|  `toUpper`  |  string  |  string  |  senar. ToUpper, mengonversi semua karakter ke huruf besar.  | 
|  `toLower`  |  string  |  string  |  senar. ToLower, mengonversi semua karakter ke huruf kecil.  | 
|  `match`  |  pola, teks  |  boolean  |  regexp. MatchString Tes untuk pertandingan regexp yang tidak ditambatkan.  | 
|  `reReplaceAll`  |  pola, penggantian, teks  |  string  |  Regexp. ReplaceAllString Regexp substitusi, tidak berlabuh.  | 
|  `graphLink`  |  string - Objek JSON dengan `expr` dan bidang `datasource`  |  string  |  Mengembalikan jalur ke tampilan grafis di Jelajahi untuk ekspresi dan sumber data yang diberikan.  | 
|  `tableLink`  |  string - Objek JSON dengan `expr` dan bidang `datasource`  |  string  |  Mengembalikan jalur ke tampilan tabel di Jelajahi untuk ekspresi dan sumber data yang diberikan.  | 
|  `args`  |  [] antarmuka \$1\$1  |  peta [string] antarmuka \$1\$1  |  Mengkonversi daftar objek ke peta dengan kunci, misalnya, arg0, arg1. Gunakan fungsi ini untuk meneruskan beberapa argumen ke template.  | 
|  `externalURL`  |  tidak ada  |  string  |  Mengembalikan string yang mewakili URL eksternal.  | 
|  `pathPrefix`  |  tidak ada  |  string  |  Mengembalikan jalur URL eksternal.  | 

Tabel berikut menunjukkan contoh penggunaan setiap fungsi.


| Fungsi | TemplateString | Input | Expected | 
| --- | --- | --- | --- | 
|  memanusiakan  |  \$1memanusiakan \$1value\$1  |  1234567.0  |  1.235 M  | 
|  manusia1024  |  \$1humanize1024 \$1nilai\$1  |  1048576.0  |  1Mi  | 
|  HumanizeUrasi  |  \$1HumanizeDuration \$1value\$1  |  899,99  |  14m 59s  | 
|  HumanizePersentase  |  \$1HumanizePersentase \$1 nilai\$1  |  0.1234567  |  12,35%  | 
|  HumanizeTimestamp  |  \$1HumanizeTimeStamp \$1nilai\$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  title  |  \$1\$1value \$1 judul\$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1\$1nilai \$1 TouPper\$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1\$1value \$1 toLower\$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1cocokkan “a\$1” \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll “localhost :( .\$1)” “my.domain: \$11" \$1labels.instance\$1\$1  |  localhost:3000  |  domain.my:3000  | 
|  GraphLink  |  \$1\$1GraphLink “\$1\$1" expr\$1”:\$1 "up\$1”,\$1 "sumber data\$1”:\$1 "gdev-prometheus\$1"\$1”\$1\$1  |    |  /jelajahi? left= ["now-1h”, "now”, "gdev-prometheus”, \$1"datasource” :"gdev-prometheus”, "expr” :"up”, "instant” :false, "range” :true\$1]  | 
|  TableLink  |  \$1\$1TableLink “\$1\$1" expr\$1”:\$1 "up\$1”,\$1 "sumber data\$1”:\$1 "gdev-prometheus\$1"\$1”\$1\$1  |    |  /jelajahi? left= ["now-1h”, "now”, "gdev-prometheus”, \$1"datasource” :"gdev-prometheus”, "expr” :"up”, "instant” :true, "range” :false\$1]  | 
|  args  |  \$1\$1define “x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1template “x” (argumen 1 “2")\$1\$1  |    |  1 2  | 
|  URL eksternal  |  \$1ExternalUrl\$1  |    |  http://localhost/path/prefix  | 
|  PathPrefix  |  \$1PathPrefix\$1  |    |  /jalur/awalan  | 

# Bekerja dengan kebijakan notifikasi
<a name="alert-notifications"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)

Kebijakan pemberitahuan menentukan bagaimana peringatan diarahkan ke titik kontak. Kebijakan memiliki struktur pohon, di mana setiap kebijakan dapat memiliki satu atau lebih kebijakan anak. Setiap kebijakan, kecuali kebijakan root, juga dapat mencocokkan label peringatan tertentu. Setiap peringatan dievaluasi oleh kebijakan root dan kemudian oleh setiap kebijakan anak. Jika Anda mengaktifkan `Continue matching subsequent sibling nodes` opsi untuk kebijakan tertentu, evaluasi berlanjut bahkan setelah satu atau lebih kecocokan. Pengaturan konfigurasi kebijakan induk dan informasi titik kontak mengatur perilaku peringatan yang tidak cocok dengan kebijakan turunan mana pun. Kebijakan root mengatur peringatan apa pun yang tidak cocok dengan kebijakan tertentu.

**catatan**  
Anda dapat membuat dan mengedit kebijakan notifikasi untuk lansiran terkelola Grafana. Kebijakan pemberitahuan untuk peringatan Alertmanager hanya bisa dibaca.

**Pemberitahuan pengelompokan**

Pengelompokan mengkategorikan notifikasi peringatan yang sifatnya serupa ke dalam satu corong. Ini memungkinkan Anda untuk mengontrol pemberitahuan peringatan selama pemadaman yang lebih besar ketika banyak bagian dari sistem gagal sekaligus menyebabkan sejumlah besar peringatan dimulai secara bersamaan.

**Contoh pengelompokan**

Misalkan Anda memiliki 100 layanan yang terhubung ke database di lingkungan yang berbeda. Layanan ini dibedakan oleh label`env=environmentname`. Aturan peringatan ada untuk memantau apakah layanan Anda dapat mencapai database. Aturan peringatan membuat peringatan bernama`alertname=DatabaseUnreachable`.

Jika partisi jaringan terjadi, di mana setengah dari layanan Anda tidak dapat lagi mencapai database, 50 peringatan berbeda dimulai. Untuk situasi ini, Anda ingin menerima pemberitahuan satu halaman (sebagai lawan dari 50) dengan daftar lingkungan yang terpengaruh.

Anda dapat mengonfigurasi pengelompokan menjadi `group_by: [alertname]` (tidak menggunakan `env` label, yang berbeda untuk setiap layanan). Dengan konfigurasi ini, Grafana mengirimkan satu notifikasi ringkas yang memiliki semua lingkungan yang terpengaruh untuk aturan peringatan ini.

**Grup Khusus**

Grafana memiliki dua kelompok khusus. Grup default, `group_by: null` mengelompokkan *semua* peringatan menjadi satu grup. Anda juga dapat menggunakan label khusus yang diberi nama `...` untuk mengelompokkan peringatan berdasarkan semua label, menonaktifkan pengelompokan secara efektif, dan mengirim setiap peringatan ke dalam grupnya sendiri.

## Bekerja dengan notifikasi
<a name="alert-notifications-working"></a>

Prosedur berikut menunjukkan cara membuat dan mengelola kebijakan notifikasi.

**Untuk mengedit kebijakan pemberitahuan root**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Kebijakan Root**, pilih ikon **Edit** (pena).

1. Di **titik kontak default**, perbarui titik kontak tempat pemberitahuan harus dikirim untuk aturan saat aturan peringatan tidak cocok dengan kebijakan tertentu.

1. Di **Grup menurut**, pilih label (atau grup khusus) untuk mengelompokkan peringatan berdasarkan.

1. Di **Opsi waktu**, pilih dari opsi berikut.
   + **Tunggu grup** — Saatnya menunggu untuk menyangga peringatan dari grup yang sama sebelum mengirim pemberitahuan awal. Waktu default-nya adalah 30 detik.
   + **Interval grup** — Interval waktu minimum antara dua pemberitahuan untuk grup. Default adalah 5 menit.
   + **Interval pengulangan** — Interval waktu minimum sebelum mengirim ulang pemberitahuan jika tidak ada peringatan baru yang ditambahkan ke grup. Defaultnya adalah 4 jam.

1. Pilih **Simpan** untuk menyimpan perubahan Anda.

**Untuk menambahkan kebijakan spesifik tingkat atas yang baru**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Perutean khusus**, pilih **Kebijakan spesifik baru**.

1. Di bagian **Mencocokkan label**, tambahkan satu atau beberapa label peringatan yang cocok. Informasi lebih lanjut tentang pencocokan label nanti dalam topik ini.

1. Di **titik Kontak**, tambahkan titik kontak untuk mengirim notifikasi jika peringatan cocok dengan kebijakan khusus ini. Kebijakan bersarang mengesampingkan titik kontak ini.

1. Secara opsional pilih **Ganti pengelompokan** untuk menentukan pengelompokan yang berbeda dari kebijakan root.

1. Secara opsional pilih **Ganti pengaturan waktu umum** untuk mengganti opsi waktu dalam kebijakan pemberitahuan grup.

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk menambahkan kebijakan bersarang**

1. Perluas kebijakan spesifik yang ingin Anda buat kebijakan bersarang.

1. Pilih **Tambahkan kebijakan bertingkat**, lalu tambahkan detailnya (seperti saat menambahkan kebijakan spesifik tingkat atas).

1. Pilih **Simpan kebijakan** untuk menyimpan perubahan Anda.

**Untuk mengedit kebijakan tertentu**

1. Dari halaman **Peringatan**, pilih **Kebijakan pemberitahuan** untuk membuka halaman yang mencantumkan kebijakan yang ada.

1. Pilih kebijakan yang ingin Anda edit, lalu pilih ikon **Edit** (pena).

1. Buat perubahan apa pun (seperti saat menambahkan kebijakan spesifik tingkat atas).

1. Pilih **Simpan kebijakan**.

**Cara kerja pencocokan label**

Kebijakan akan cocok dengan peringatan jika label peringatan cocok dengan semua *Label Pencocokan* yang ditentukan pada kebijakan.
+ **Label** — Nama label yang cocok. Itu harus sama persis dengan nama label peringatan.
+ **Operator** — Operator digunakan untuk membandingkan nilai label dengan nilai label yang cocok. Operator yang tersedia adalah:
  + `=`Pilih label yang nilainya sama persis dengan string yang disediakan.
  + `!=`Pilih label yang nilainya tidak cocok dengan string yang disediakan.
  + `=~`Pilih label yang nilainya cocok dengan nilai interpretasi regex dari string yang disediakan (string yang disediakan ditafsirkan sebagai ekspresi reguler.
  + `!=`Pilih label yang tidak cocok dengan ekspresi reguler yang disediakan.
+ **Nilai** — Nilai untuk mencocokkan nilai label. Hal ini dapat cocok sebagai string atau sebagai ekspresi reguler, tergantung pada operator yang dipilih.

## Bisukan waktu
<a name="alert-notification-muting"></a>

Waktu bisu adalah interval waktu berulang ketika tidak ada pemberitahuan baru untuk kebijakan yang dibuat atau dikirim. Gunakan mereka untuk mencegah peringatan menembakkan periode tertentu dan berulang, misalnya, periode pemeliharaan rutin.

Mirip dengan keheningan, pengaturan waktu bisu tidak mencegah aturan peringatan dievaluasi, juga tidak menghentikan instance peringatan ditampilkan di antarmuka pengguna. Mereka hanya mencegah pemberitahuan dibuat.

Anda dapat mengonfigurasi pengaturan waktu bisu terkelola Grafana serta pengaturan waktu bisu untuk sumber data Alertmanager eksternal.

**Pengaturan waktu bisu dibandingkan dengan keheningan**

Tabel berikut menyoroti perbedaan antara timing bisu dan keheningan.


| Bisukan waktu | Pembisuan | 
| --- | --- | 
|  Menggunakan definisi interval waktu yang dapat terulang kembali  |  Memiliki waktu mulai dan berakhir yang tetap  | 
|  Dibuat dan kemudian ditambahkan ke kebijakan pemberitahuan  |  Menggunakan label untuk mencocokkan dengan peringatan untuk menentukan apakah akan diam atau tidak  | 

**Untuk membuat waktu bisu**

1. **Dari konsol Grafana Anda, di menu Grafana, pilih ikon **Peringatan** (bel) untuk membuka halaman Peringatan.**

1. Pilih **Kebijakan pemberitahuan**.

1. Dari dropdown **Alertmanager**, pilih Alertmanager yang ingin Anda edit.

1. Di bagian **Mute timing**, pilih tombol **Add mute timing**.

1. Pilih interval waktu yang Anda inginkan untuk menerapkan waktu bisu.

1. Pilih **Kirim** untuk membuat waktu bisu.

**Untuk menambahkan waktu bisu ke kebijakan notifikasi**

1. Pilih kebijakan notifikasi yang ingin Anda tambahkan waktu bisu, lalu pilih tombol **Edit**.

1. Dari menu tarik-turun **Pengaturan waktu bisu**, pilih pengaturan waktu bisu yang ingin ditambahkan ke kebijakan.

   Pilih tombol **Simpan kebijakan**.

**Interval waktu**

Interval waktu adalah definisi untuk rentang waktu. Jika peringatan dimulai selama interval ini, peringatan itu ditekan. Rentang didukung menggunakan `:` (misalnya,`monday:thursday`). Waktu bisu dapat berisi beberapa interval waktu. Interval waktu terdiri dari beberapa bidang (detail dalam daftar berikut), yang semuanya harus cocok untuk menekan peringatan. Misalnya, jika Anda menentukan hari dalam seminggu `monday:friday` dan rentang waktu dari 8:00-9:00, maka peringatan ditekan dari 8-9, Senin hingga Jumat, tetapi tidak, misalnya, 8-9 pada hari Sabtu.
+ **Rentang waktu** — Waktu hari untuk menekan notifikasi. Terdiri dari dua sub-bidang, **Start time** dan **End time**. Contoh waktu adalah`14:30`. Waktu dalam notasi 24 jam, di UTC.
+ **Hari dalam seminggu** — Hari-hari dalam seminggu. Dapat berupa satu hari, seperti`monday`, rentang, seperti`monday:friday`, atau daftar hari yang terpisah koma, seperti. `monday, tuesday, wednesday`
+ **Bulan** — Bulan untuk memilih. Anda dapat menentukan bulan dengan penunjukan numerik, atau dengan nama bulan penuh, misalnya `1` atau `january` keduanya menentukan Januari. Anda dapat menentukan satu bulan, rentang bulan, atau daftar bulan yang dipisahkan koma.
+ **Hari dalam sebulan** — Tanggal dalam sebulan. Nilai dapat berkisar dari `1` -`31`. Nilai negatif menentukan hari dalam sebulan dalam urutan terbalik, jadi `-1` mewakili hari terakhir bulan itu. Hari dalam sebulan dapat ditentukan sebagai satu hari, rentang hari, atau daftar hari yang terpisah koma.

# Ubah preferensi Anda
<a name="change-your-grafana-preferences"></a>

Anda dapat melakukan beberapa tugas di tab **Preferensi**. Anda dapat mengedit profil, mengubah preferensi Grafana Terkelola Amazon, dan melihat informasi tentang profil Anda dan penggunaan Grafana yang Dikelola Amazon.

**catatan**  
Untuk membuat perubahan pada konfigurasi ruang kerja Anda, lihat[Konfigurasikan ruang kerja Grafana yang Dikelola Amazon](AMG-configure-workspace.md).

## Edit profil Grafana Terkelola Amazon Anda
<a name="edit-your-grafana-profile"></a>

 Profil Anda mencakup nama, nama pengguna, dan alamat email Anda. 

**Untuk mengedit profil Anda**

1.  Jeda ikon pengguna Anda di sudut kiri bawah layar, lalu pilih **Preferensi**. 

1.  Di bagian **Edit Profil**, Anda dapat mengedit salah satu dari berikut ini: 
   +  **Nama** - Edit bidang ini untuk mengubah nama tampilan yang terkait dengan profil Anda. 
   +  **Email** - Edit bidang ini untuk mengubah alamat email yang terkait dengan profil Anda. 
   +  **Nama pengguna** - Edit bidang ini untuk mengubah nama pengguna Anda. 

1.  Pilih **Simpan**. 

## Edit preferensi Anda
<a name="edit-your-grafana-preferences"></a>

 Preferensi Anda termasuk apakah menggunakan tema gelap atau terang, dasbor rumah Anda, dan zona waktu Anda. 

**catatan**  
 Pengaturan pada pengaturan penggantian instans pribadi yang dibuat oleh administrator Anda di tingkat instans atau tim. 

**Untuk mengubah preferensi Anda**

1.  Jeda ikon pengguna Anda di sudut kiri bawah layar, lalu pilih **Preferensi**. 

1.  Di bagian Preferensi, Anda dapat mengedit salah satu dari berikut ini: 
   +  **Tema UI** - Untuk mengatur tema, pilih **Gelap** atau **Terang**. **Default** adalah tema gelap atau tema yang dipilih oleh administrator Grafana Anda. 
   +  **Dasbor Rumah** 
   +  **Timezone** - Pilih untuk memilih opsi dalam daftar **Timezone**. **Default** adalah zona waktu lokal browser atau zona waktu yang dipilih oleh administrator Grafana Anda. Untuk informasi selengkapnya, lihat [Kontrol rentang waktu](dashboard-time-range-controls.md). 

1.  Pilih **Simpan**. 

## Lihat sesi Grafana Terkelola Amazon Anda
<a name="view-your-grafana-sessions"></a>

 Grafana yang Dikelola Amazon mencatat sesi Anda di setiap ruang kerja Grafana. Jika Anda mencurigai seseorang telah menyalahgunakan kredenal Grafana yang Dikelola Amazon Anda, Anda dapat meninjau bagian ini. 

**Untuk melihat informasi sesi**

1.  Jeda ikon pengguna Anda di sudut kiri bawah layar, lalu pilih **Preferensi**. 

1.  Gulir ke bawah ke bagian **Sesi**. Grafana menampilkan yang berikut: 
   +  **Terakhir terlihat** - Berapa lama Anda login. 
   +  **Login** — Tanggal Anda masuk ke instance Grafana saat ini. 
   +  **Alamat IP** — Alamat IP yang Anda login dari. 
   +  **Browser & OS** — Browser web dan sistem operasi yang digunakan untuk masuk ke Grafana. 
   +  Jika Anda adalah admin Grafana untuk instance, Anda dapat mencabut sesi dengan memilih ikon signout merah di baris sesi. 

# Kumpulkan informasi untuk dukungan
<a name="support-bundles"></a>

Support bundle menyediakan cara sederhana untuk mengumpulkan informasi tentang ruang kerja Grafana Anda melalui antarmuka pengguna. Ketika Anda mengalami masalah dengan ruang kerja Grafana, Anda dapat mengirimkan dukungan produk bundel dukungan yang berisi informasi tentang ruang kerja Anda, termasuk:
+ Versi Grafana
+ Plugin yang diinstal
+ Konfigurasi Grafana
+ Informasi database dan migrasi

**catatan**  
Support bundle hanya tersedia di workspace yang kompatibel dengan Grafana versi 10 atau yang lebih baru.

## Support komponen bundel
<a name="support-bundles-components"></a>

Bundel dukungan dapat mencakup salah satu komponen berikut:
+ **Statistik penggunaan — Statistik** penggunaan untuk ruang kerja Grafana.
+ **Informasi pengguna** — Daftar pengguna ruang kerja Grafana.
+ Informasi **database dan migrasi — Informasi** database, dan log migrasi.
+ **Informasi plugin** — Informasi tentang plugin yang diinstal di ruang kerja.
+ **Informasi dasar** — Informasi dasar tentang ruang kerja Grafana, termasuk versi, dan penggunaan memori.
+ **Pengaturan** — Pengaturan ruang kerja Grafana.
+ **SALL** - Koneksi Healthcheck dan metadata untuk SALL (hanya ditampilkan jika SALL diaktifkan).
+ **LDAP** - Koneksi Healthcheck dan metadata untuk LDAP (hanya ditampilkan jika LDAP diaktifkan).
+ **OAuth2**— Koneksi Healthcheck dan metadata untuk setiap OAuth2 penyedia (hanya ditampilkan jika OAuth penyedia diaktifkan).

## Membuat bundel dukungan
<a name="support-bundles-create"></a>

Gunakan prosedur berikut untuk membuat bundel dukungan.

**catatan**  
Prosedur ini memerlukan `admin` izin di ruang kerja.

**Untuk membuat bundel dukungan**

1. Masuk ke ruang kerja Grafana Anda.

1. Pilih ikon Bantuan

1. Dari menu bantuan, pilih **Support Bundles.**

1. Pilih **New Support Bundle**.

1. Pilih komponen yang ingin Anda sertakan dalam bundel dukungan.

1. Pilih **Buat**.

1. Setelah bundel dukungan siap, pilih **Unduh**.

   Grafana mengunduh bundel dukungan ke file archive (`tar.gz`).

Anda dapat membuka file untuk melihat isi bundel dukungan. Anda dapat langsung mengirim file ke dukungan, jika diperlukan. Jika bundel berisi informasi pribadi, dan Anda harus mengirimkannya melalui saluran yang tidak pribadi, Anda dapat mempertimbangkan untuk mengenkripsi itu. Anda dapat menggunakan alat seperti [usia](https://age-encryption.org/) untuk mengenkripsi file sebelum mengirim.

# Peringatan dasbor klasik
<a name="old-alerts-overview"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

**catatan**  
Bagian ini menjelaskan sistem peringatan dasbor klasik di Grafana. Untuk mempelajari tentang migrasi ke, dan menggunakan, peringatan Grafana baru, yang dirancang untuk melihat peringatan Prometheus Alertmanager bersama dengan peringatan Grafana, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
GrafanaLabs telah mengumumkan penghapusan peringatan dasbor klasik di Grafana versi 11.

 Peringatan dasbor klasik terdiri dari dua bagian: 
+  Aturan peringatan — Saat peringatan dipicu. Aturan peringatan ditentukan oleh satu atau lebih kondisi yang dievaluasi secara teratur oleh Grafana. 
+  Saluran notifikasi — Bagaimana peringatan dikirimkan. Ketika kondisi aturan peringatan terpenuhi, Grafana akan memberi tahu saluran yang dikonfigurasi untuk peringatan tersebut. 

 Saat ini, hanya visualisasi panel grafik yang mendukung peringatan. 

## Konfigurasi peringatan
<a name="old-alert-tasks"></a>

Anda dapat mengonfigurasi peringatan di ruang kerja Grafana Terkelola Amazon Anda. 
+  Tambahkan atau edit saluran notifikasi peringatan. Untuk informasi selengkapnya, lihat [Notifikasi](#old-notifications). 
+  Buat aturan peringatan. Untuk informasi selengkapnya, lihat [Membuat peringatan](old-create-alerts.md). 
+  Lihat aturan peringatan yang ada dan statusnya saat ini. Untuk informasi selengkapnya, lihat [Melihat aturan peringatan yang ada](old-view-existing-alert-rules.md). 
+  Uji aturan peringatan dan pecahkan masalah. Untuk informasi selengkapnya, lihat [Peringatan pemecahan masalah](old-troubleshoot-alerts.md). 

## Pengelompokan
<a name="old-clustering"></a>

 Saat ini, peringatan mendukung bentuk terbatas ketersediaan tinggi. Pemberitahuan peringatan akan di-deduplikasi saat Anda menjalankan beberapa ruang kerja. Ini berarti bahwa semua peringatan dijalankan di setiap server, tetapi tidak ada pemberitahuan peringatan duplikat yang dikirim karena logika deduping. 

## Notifikasi
<a name="old-notifications"></a>

 Anda dapat membuat aturan peringatan dengan pesan terperinci termasuk informasi seperti cara mengatasi masalah, tautan ke buku runbook, dan sebagainya.

 Pemberitahuan aktual dikonfigurasi dan dibagikan di antara beberapa peringatan. 

## Eksekusi peringatan
<a name="old-alert-execution"></a>

 Aturan peringatan dievaluasi di Grafana Terkelola Amazon di mesin penjadwal dan eksekusi kueri.

# Pemberitahuan peringatan
<a name="old-alert-notifications"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

 Ketika peringatan berubah status, ia mengirimkan pemberitahuan. Setiap aturan peringatan dapat memiliki beberapa notifikasi. Untuk menambahkan pemberitahuan ke aturan peringatan, Anda harus menambahkan dan mengonfigurasi `notification` saluran terlebih dahulu. 

 Ini dilakukan dari halaman saluran Pemberitahuan. 

## Menambahkan saluran notifikasi
<a name="old-add-a-notification-channel"></a>

1.  Di bilah samping, jeda pada ikon **Peringatan** (bel), lalu pilih Saluran **pemberitahuan**. 

1.  Pilih **Tambah saluran**. 

1.  Isi bidang atau pilih opsi yang dijelaskan di bagian berikut. 

## Bidang saluran notifikasi baru
<a name="old-new-notification-channel-fields"></a>

### Default (kirim semua peringatan)
<a name="old-default-send-on-all-alerts"></a>
+  **Nama** — Masukkan nama untuk saluran ini. Ini akan ditampilkan ketika pengguna menambahkan pemberitahuan ke aturan peringatan. 
+  **Jenis** - Pilih jenis saluran. Untuk informasi selengkapnya, lihat [Daftar notifier yang didukung](#old-list-of-supported-notifiers). 
+  **Default (kirim pada semua peringatan)** — Saat dipilih, opsi ini mengirimkan pemberitahuan di saluran ini untuk semua aturan peringatan. 
+  **Nonaktifkan Pesan Selesaikan** — Saat dipilih, opsi ini menonaktifkan pesan selesaikan [OK] yang dikirim saat status peringatan kembali ke false. 
+  **Kirim pengingat** — Ketika opsi ini dipilih, pemberitahuan tambahan (pengingat) akan dikirim untuk peringatan. Anda dapat menentukan seberapa sering pengingat harus dikirim dengan menggunakan jumlah detik, menit (m), atau jam (h); misalnya,, `30s``3m`, `5m` atau`1h`. 

**penting**  
 Pengingat peringatan dikirim setelah aturan dievaluasi. Oleh karena itu, pengingat tidak dapat dikirim lebih sering daripada interval evaluasi aturan peringatan yang dikonfigurasi. 

 Contoh berikut menunjukkan seberapa sering dan kapan pengingat dikirim untuk peringatan yang dipicu. 


|  Interval evaluasi aturan peringatan  |  Kirim pengingat setiap  |  Pengingat dikirim setiap (setelah pemberitahuan peringatan terakhir)  | 
| --- | --- | --- | 
|  30s  |  15s  |  \$1 30 detik  | 
|  1m  |  5m  |  \$1 5 menit  | 
|  5m  |  15m  |  \$1 15 menit  | 
|  6m  |  20m  |  \$1 24 menit  | 
|  1h  |  15m  |  \$1 1 jam  | 
|  1h  |  2h  |  \$1 2 jam  | 

## Daftar notifier yang didukung
<a name="old-list-of-supported-notifiers"></a>


|  Nama  |  Tipe  |  Mendukung gambar  |  Mendukung tag aturan peringatan  | 
| --- | --- | --- | --- | 
| [Layanan Notifikasi Sederhana Amazon](#old-amazon-sns)  |  sns  |  Tidak  |  Ya  | 
|  OpsGenie  |  opsgenie  |  Tidak  |  Ya  | 
|  [PagerDuty](#old-pagerduty)  |  pagerduty  |  Tidak  |  Ya  | 
|  [Slack](#old-slack)  |  slack  |  Tidak  |  Tidak  | 
|  VictorOps  |  victorops  |  Tidak  |  Tidak  | 

### Layanan Notifikasi Sederhana Amazon
<a name="old-amazon-sns"></a>

Jika Anda telah mengaktifkan izin yang dikelola layanan dan menyertakan Amazon SNS sebagai saluran notifikasi untuk ruang kerja, Anda hanya perlu menyediakan ARN Topik SNS saat membuat saluran notifikasi. Di bidang **Nama**, berikan nama topik SNS yang telah Anda buat. Jika Anda membuat ruang kerja menggunakan izin yang dikelola layanan, nama topik SNS harus diawali agar notifikasi berhasil dipublikasikan ke topik tersebut. `grafana` Jika Anda memilih izin yang dikelola pelanggan saat membuat ruang kerja, nama Topik SNS tidak perlu diawali. `grafana` 

 Di bidang **Topik**, salin dan tempel ARN dari topik SNS. Dalam **format badan Pesan**, Anda dapat memilih opsi JSON atau teks. 

Di bidang **Pengaturan AWS SNS Opsional**, centang kotak Centang **Sertakan semua tag dalam pesan** untuk melihat semua tag Grafana di badan pesan.

Jika Anda menggunakan izin yang dikelola pelanggan untuk tempat kerja, peran IAM yang Anda berikan harus menyertakan izin Terbitkan SNS untuk Topik SNS Anda. 

### Slack
<a name="old-slack"></a>

 Untuk mengatur Slack, Anda harus mengonfigurasi URL webhook Slack yang masuk. Untuk informasi selengkapnya, lihat [Mengirim pesan menggunakan Webhook Masuk](https://api.slack.com/incoming-webhooks).

Untuk informasi selengkapnya tentang menyiapkan integrasi bot Slack, lihat [Ikuti panduan Slack untuk menyiapkan integrasi bot](https://api.slack.com/bot-users). Gunakan token yang disediakan, yang dimulai dengan “xoxb”. 


|  Pengaturan  |  Deskripsi  | 
| --- | --- | 
|  Url  |  Slack URL webhook masuk, atau akhirnya titik akhir [Chat.postMessage](https://api.slack.com/methods/chat.postMessage) Slack API.  | 
|  nama pengguna  |  Tetapkan nama pengguna untuk pesan bot.  | 
|  Penerima  |  Gunakan ini untuk mengganti penerima Slack. Anda harus memberikan ID Slack saluran, ID Slack pengguna, referensi nama pengguna (@, <user>semua huruf kecil, tidak ada spasi putih), atau referensi saluran (\$1, <channel>semua huruf kecil, tidak ada spasi putih). Jika Anda menggunakan titik akhir chat.postMessage Slack API, ini diperlukan.  | 
|  Ikon emoji  |  Berikan emoji untuk digunakan sebagai ikon pesan bot. Misalnya, :smile:  | 
|  Ikon URL  |  Berikan URL ke gambar untuk digunakan sebagai ikon pesan bot.  | 
|  Sebutkan Pengguna  |  Secara opsional menyebutkan satu atau lebih pengguna dalam notifikasi Slack yang dikirim oleh Grafana. Untuk melihat pengguna, dipisahkan koma, melalui Slack yang sesuai IDs, pilih tombol overflow pada profil Slack setiap pengguna.  | 
|  Sebutkan Grup  |  Secara opsional sebutkan satu atau lebih grup dalam notifikasi Slack yang dikirim oleh Grafana. Anda dapat melihat grup, dipisahkan koma, melalui Slack yang sesuai IDs (yang bisa Anda dapatkan dari URL profil Slack masing-masing grup).  | 
|  Sebutkan Saluran  |  Secara opsional menyebutkan semua anggota saluran atau hanya yang aktif.  | 
|  Token  |  Jika disediakan, Grafana Terkelola Amazon akan mengunggah gambar yang dihasilkan melalui operasi Slack file.upload API, bukan tujuan gambar eksternal. Jika Anda menggunakan titik akhir chat.postMessage Slack API, ini diperlukan.  | 

 Jika Anda menggunakan token untuk bot slack, Anda harus mengundang bot ke saluran yang ingin Anda kirimi notifikasi. Kemudian tambahkan saluran ke bidang penerima. 

### PagerDuty
<a name="old-pagerduty"></a>

 Untuk mengatur PagerDuty, berikan kunci integrasi. 


|  Pengaturan  |  Deskripsi  | 
| --- | --- | 
|  Kunci Integrasi  |  Kunci integrasi untuk PagerDuty.  | 
|  Kepelikan  |  Level untuk notifikasi dinamis; defaultnya adalah critical (1). | 
|  Selesaikan insiden secara otomatis  |  Selesaikan insiden PagerDuty setelah peringatan kembali ke ok.  | 
|  Pesan secara detail  |  Menghapus pesan Peringatan dari bidang ringkasan PD dan memasukkannya ke detail khusus sebagai gantinya (2).  | 

**catatan**  
 Tag`Severity`,,`Class`, `Group``dedup_key`, dan `Component` memiliki arti khusus dalam [Format Acara PagerDuty Umum - PD-CEF](https://support.pagerduty.com/docs/pd-cef). Jika panel peringatan mendefinisikan kunci tag ini, mereka dialihkan ke root acara yang dikirim ke. PagerDuty Ini berarti mereka akan tersedia dalam PagerDuty UI dan alat Filtering. Tag Keparahan yang disetel pada peringatan akan menggantikan set Keparahan global di saluran notifikasi jika levelnya valid. 

**catatan**  
 Menggunakan Message In Details akan mengubah struktur `custom_details` bidang di PagerDuty Event. Ini mungkin melanggar aturan acara khusus dalam PagerDuty aturan Anda jika Anda mengandalkan bidang di`payload.custom_details`. Pindahkan aturan yang ada yang digunakan `custom_details.myMetric` untuk`custom_details.queries.myMetric`. 

**catatan**  
 Menggunakan `dedup_key` tag akan mengganti Grafana yang `dedup_key` dihasilkan dengan kunci khusus.

## Mengonfigurasi tautan kembali ke Grafana dari pemberitahuan peringatan
<a name="old-configure-the-link-back-to-grafana-from-alert-notifications"></a>

 Semua notifikasi peringatan berisi tautan kembali ke peringatan yang dipicu di ruang kerja Grafana. 

# Membuat peringatan
<a name="old-create-alerts"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

 Saat menggunakan peringatan Grafana Terkelola Amazon, Anda dapat melampirkan aturan ke panel dasbor. Saat Anda menyimpan dasbor, Grafana Terkelola Amazon mengekstrak aturan peringatan ke dalam penyimpanan aturan peringatan terpisah dan menjadwalkannya untuk dievaluasi. 

 Pada tab **Peringatan** pada panel grafik, Anda dapat mengonfigurasi seberapa sering aturan peringatan harus dievaluasi dan kondisi yang harus dipenuhi agar peringatan dapat mengubah status dan memulai pemberitahuannya. 

 Saat ini, hanya panel grafik yang mendukung aturan peringatan. 

## Menambahkan atau mengedit aturan peringatan
<a name="old-add-or-edit-an-alert-rule"></a>

1.  Arahkan ke panel tempat menambahkan atau mengedit aturan peringatan, pilih judul, lalu pilih **Edit**. 

1.  Pada tab **Alert**, pilih **Create Alert**. Jika peringatan sudah ada untuk panel ini, Anda dapat mengedit bidang pada tab **Alert**. 

1.  Isi bidang. Untuk informasi selengkapnya, lihat [Bidang aturan peringatan](#old-alert-rule-fields). 

1.  Setelah selesai menulis aturan, pilih **Simpan** di sudut kanan atas untuk menyimpan aturan peringatan dan dasbor. 

1.  (Opsional tetapi disarankan) Untuk memastikan bahwa aturan mengembalikan hasil yang Anda harapkan, pilih **Aturan uji**. 

## Menghapus aturan peringatan
<a name="old-delete-an-alert"></a>

 Untuk menghapus peringatan, gulir ke bagian bawah peringatan, lalu pilih **Hapus**. 

## Bidang aturan peringatan
<a name="old-alert-rule-fields"></a>

 Bagian ini menjelaskan bidang yang Anda isi untuk membuat peringatan. 

### Aturan
<a name="old-rule"></a>
+  **Nama** — Masukkan nama deskriptif. Nama akan ditampilkan dalam daftar **Aturan Peringatan**. 
+  **Evaluasi setiap** — Tentukan seberapa sering penjadwal harus mengevaluasi aturan peringatan. Ini disebut sebagai *interval evaluasi*. 
+  **Untuk** — Tentukan berapa lama kueri harus melanggar ambang batas yang dikonfigurasi sebelum pemberitahuan peringatan dipicu. 

**Awas**  
Jangan gunakan `For` dengan `If no data or all values are null` pengaturan diatur ke`No Data`. Pemicu `No Data` akan memicu secara instan dan tidak `For` mempertimbangkan. Hal ini juga dapat mengakibatkan pemberitahuan OK tidak dikirim jika transisi peringatan dari`No Data -> Pending -> OK`.

 Jika aturan peringatan telah dikonfigurasi `For` dan kueri melanggar ambang batas yang dikonfigurasi, pertama-tama akan beralih dari `OK` ke`Pending`. Dari `OK` ke`Pending`, Grafana yang Dikelola Amazon tidak mengirim pemberitahuan apa pun. Ketika aturan peringatan telah diaktifkan selama lebih dari `For` durasi, itu akan berubah menjadi `Alerting` dan mengirim pemberitahuan peringatan. 

 Biasanya, kami sarankan menggunakan pengaturan ini karena seringkali lebih buruk untuk mendapatkan positif palsu daripada menunggu beberapa menit sebelum pemberitahuan peringatan dimulai. Melihat `Alert list` atau`Alert list panels`, Anda akan dapat melihat peringatan yang berada dalam keadaan tertunda. 

### Ketentuan
<a name="old-conditions"></a>

 Saat ini, satu-satunya jenis kondisi yang ada adalah `Query` kondisi yang memungkinkan Anda menentukan surat kueri, rentang waktu, dan fungsi agregasi. 

#### Contoh kondisi kueri
<a name="old-query-condition-example"></a>

```
avg() OF query(A, 15m, now) IS BELOW 14
```
+  `avg()`Mengontrol bagaimana nilai untuk **setiap** seri harus dikurangi menjadi nilai yang dapat dibandingkan dengan ambang batas. Pilih fungsi untuk mengubahnya ke fungsi agregasi lain. 
+  `query(A, 15m, now)`Huruf tersebut mendefinisikan kueri apa yang akan dijalankan dari tab **Metrik**. Dua parameter kedua menentukan rentang waktu: `15m, now` berarti 15 menit yang lalu hingga sekarang. Anda juga dapat menggunakan `10m, now-2m` untuk menentukan rentang waktu yang akan 10 menit yang lalu hingga 2 menit yang lalu. Ini berguna jika Anda ingin mengabaikan 2 menit terakhir data. 
+  `IS BELOW 14`Mendefinisikan jenis ambang batas dan nilai ambang batas. Anda dapat memilih `IS BELOW` untuk mengubah jenis ambang batas. 

 Kueri yang digunakan dalam aturan peringatan tidak dapat berisi variabel template apa pun. Saat ini, kami hanya mendukung `AND` dan `OR` operator di antara kondisi, dan mereka dijalankan secara serial. Misalnya, kami memiliki tiga kondisi dalam urutan sebagai berikut: *Condition:A (mengevaluasi ke: TRUE) ATAU CONDITION:B (mengevaluasi ke: FALSE) DAN CONDITION:C (mengevaluasi ke: TRUE) sehingga hasilnya akan dihitung sebagai ((TRUE OR FALSE)* AND TRUE) = TRUE. 

#### Beberapa seri
<a name="old-multiple-series"></a>

 Jika kueri mengembalikan beberapa seri, fungsi agregasi dan pemeriksaan ambang batas akan dievaluasi untuk setiap seri. Saat ini, Grafana Terkelola Amazon tidak melacak status aturan peringatan **per** seri. Implikasinya dirinci dalam skenario berikut. 
+  **Kondisi peringatan dengan kueri yang mengembalikan dua seri: **server1 dan server2**.** 
+  Seri **server1** menyebabkan aturan peringatan menyala dan beralih ke status. `Alerting` 
+  Pemberitahuan dikirim dengan pesan: *load peaking (server1*) 
+  Dalam evaluasi selanjutnya dari aturan peringatan yang sama, seri **server2** juga menyebabkan aturan peringatan diaktifkan. 
+  Tidak ada pemberitahuan baru yang dikirim karena aturan peringatan sudah dalam status`Alerting`. 

Seperti yang Anda lihat dari skenario sebelumnya, jika aturan sudah dalam status`Alerting`, Grafana tidak mengirimkan notifikasi ketika seri lain menyebabkan peringatan diaktifkan.

**catatan**  
 Anda dapat mengonfigurasi pengingat yang akan dikirim untuk peringatan yang dipicu. Ini akan mengirimkan pemberitahuan tambahan ketika peringatan terus menyala. Jika seri lain (seperti server2 pada contoh sebelumnya) juga menyebabkan aturan peringatan diaktifkan, mereka disertakan dalam pemberitahuan pengingat. Bergantung pada saluran notifikasi yang Anda gunakan, Anda mungkin dapat memanfaatkan fitur ini untuk mengidentifikasi seri baru atau yang sudah ada yang menyebabkan peringatan diaktifkan. 

### Tidak ada data dan penanganan kesalahan
<a name="old-no-data-error-handling"></a>

 Tabel berikut berisi kondisi untuk mengontrol bagaimana mesin evaluasi aturan menangani kueri yang tidak mengembalikan data atau hanya nilai nol. 


|  Tidak Ada Opsi Data  |  Deskripsi  | 
| --- | --- | 
|  Tidak ada Data  |  Tetapkan status aturan peringatan keNoData.  | 
|  Peringatan  |  Tetapkan status aturan peringatan keAlerting.  | 
|  Pertahankan Status Terakhir  |  Pertahankan status aturan peringatan saat ini, apa pun itu.  | 
|  Oke  | Didukung, tetapi biasanya tidak berguna.  | 

### Kesalahan eksekusi atau batas waktu
<a name="old-execution-errors-or-timeouts"></a>

 Opsi berikut memberi tahu Amazon Managed Grafana cara menangani kesalahan eksekusi atau batas waktu. 


|  Opsi kesalahan atau batas waktu  |  Deskripsi  | 
| --- | --- | 
|  Peringatan  |  Tetapkan status aturan peringatan keAlerting.  | 
|  Pertahankan Status Terakhir  |  Pertahankan status aturan peringatan saat ini, apa pun itu.  | 

 Jika Anda memiliki toko deret waktu yang tidak dapat diandalkan dari mana kueri terkadang habis atau gagal secara acak, Anda dapat mengatur opsi ini untuk pada dasarnya `Keep Last State` mengabaikannya. 

## Notifikasi
<a name="old-alert-notifications-1"></a>

 Pada tab **Peringatan**, Anda juga dapat menentukan pemberitahuan aturan peringatan dan pesan terperinci tentang aturan peringatan. Pesan dapat berisi apa saja: informasi tentang bagaimana Anda dapat memecahkan masalah, tautan ke runbook, dan sebagainya. 

 Pemberitahuan aktual dikonfigurasi dan dibagikan di antara beberapa peringatan. Untuk informasi tentang cara mengonfigurasi dan mengatur notifikasi, lihat[Pemberitahuan peringatan](old-alert-notifications.md). 
+  **Kirim ke** - Pilih saluran pemberitahuan peringatan jika Anda sudah menyiapkannya. 
+  **Pesan** — Masukkan pesan teks yang akan dikirim pada saluran notifikasi. Beberapa notifier peringatan mendukung transformasi teks ke HTML atau format kaya lainnya. 
+  **Tag** - Tentukan daftar tag (nilai kunci) yang akan disertakan dalam notifikasi. Ini didukung oleh hanya beberapa notifier. 

## Riwayat dan anotasi status peringatan
<a name="old-alert-state-history-and-annotations"></a>

 Perubahan status peringatan dicatat dalam tabel anotasi internal di database Grafana Terkelola Amazon. Perubahan status divisualisasikan sebagai anotasi di panel grafik aturan peringatan. Anda juga dapat masuk ke `State history` submenu pada tab **Alert** untuk melihat dan menghapus riwayat status. 

# Menjeda aturan peringatan
<a name="old-pause-an-alert-rule"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

 Menjeda evaluasi aturan peringatan terkadang bisa berguna. Misalnya, selama jendela pemeliharaan, menjeda aturan peringatan dapat menghindari dimulainya banjir peringatan. 

1.  **Di bilah samping Grafana, jeda pada ikon **Peringatan** (bel) lalu pilih Aturan Peringatan.** Semua aturan peringatan yang dikonfigurasi terdaftar, bersama dengan statusnya saat ini. 

1.  Temukan peringatan Anda dalam daftar, dan pilih ikon **Jeda** di sebelah kanan. Ikon **Jeda** berubah menjadi ikon **Putar**. 

1.  Pilih ikon **Putar** untuk melanjutkan evaluasi peringatan Anda. 

# Melihat aturan peringatan yang ada
<a name="old-view-existing-alert-rules"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

 Grafana yang Dikelola Amazon menyimpan aturan peringatan individual di panel tempat aturan tersebut ditentukan, tetapi Anda juga dapat melihat daftar semua aturan peringatan yang ada dan statusnya saat ini. 

 **Di bilah samping Grafana, jeda pada ikon **Peringatan** (bel), lalu pilih Aturan Peringatan.** Semua aturan peringatan yang dikonfigurasi terdaftar, bersama dengan statusnya saat ini. 

 Saat melihat peringatan, Anda dapat melakukan hal berikut: 
+  **Filter peringatan berdasarkan nama** - Ketik nama peringatan di bidang **Peringatan Pencarian**. 
+  **Filter peringatan menurut negara** - Di **Negara** Bagian, pilih status peringatan mana yang ingin Anda lihat. Semua yang lain akan disembunyikan. 
+  **Jeda atau lanjutkan peringatan** — pilih ikon **Jeda atau **Putar**** di samping peringatan untuk menjeda atau melanjutkan evaluasi. 
+  **Akses pengaturan aturan peringatan** - Pilih nama peringatan atau ikon **Edit aturan peringatan** (roda gigi). Grafana Terkelola Amazon membuka tab **Peringatan** panel tempat aturan peringatan ditentukan. Ini sangat membantu saat peringatan menyala, tetapi Anda tidak tahu panel mana yang didefinisikan. 

# Templating pemberitahuan
<a name="old-alerts-notification-templating"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

Fitur template pemberitahuan peringatan memungkinkan Anda untuk mengambil nilai label dari kueri peringatan dan menyuntikkannya ke pemberitahuan peringatan.

Label yang ada dari evaluasi kueri peringatan dapat digunakan dalam nama aturan peringatan dan di bidang pesan pemberitahuan peringatan. Data label peringatan disuntikkan ke bidang notifikasi saat peringatan berada dalam status peringatan. Bila ada beberapa nilai unik untuk label yang sama, nilainya dipisahkan koma.

**Untuk menambahkan data label peringatan ke notifikasi peringatan**

1. Arahkan ke panel yang ingin Anda tambahkan atau edit aturan peringatan.

1. Pilih judul panel dan pilih **Edit**.

1. Pada tab **Alert**, pilih **Create Alert**. Jika peringatan sudah ada untuk panel ini, Anda dapat mengeditnya secara langsung.

1. Lihat label kueri peringatan di nama aturan peringatan atau bidang pesan pemberitahuan peringatan dengan menggunakan `${Label}` sintaks. Untuk informasi selengkapnya tentang label kueri peringatan, lihat [Templating pesan](https://grafana.com/docs/grafana/v8.4/alerting/unified-alerting/message-templating/) dalam dokumentasi Grafana.

1. Pilih **Simpan** di sudut kanan atas.

# Peringatan pemecahan masalah
<a name="old-troubleshoot-alerts"></a>

****  
Topik dokumentasi ini membahas peringatan lama di Grafana. Ini tidak akan didukung di versi Amazon Managed Grafana yang akan datang. Anda dapat bermigrasi ke peringatan Grafana untuk menggunakan fitur peringatan terbaru. Untuk informasi lebih lanjut, lihat salah satu topik berikut.  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Peringatan di Grafana versi 10](v10-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Peringatan di Grafana versi 9](v9-alerts.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Grafana memperingatkan](alerts-overview.md)

 Jika peringatan tidak berperilaku seperti yang Anda harapkan, langkah-langkah berikut dapat membantu Anda memecahkan masalah dan mencari tahu apa yang salah. 

 Tingkat pertama pemecahan masalah yang dapat Anda lakukan adalah memilih Aturan **Uji**. Anda dapat memperluas hasil ke titik di mana Anda dapat melihat data mentah yang dikembalikan dari kueri Anda. 