Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Membangun dasbor **** **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 **** **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 **** **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 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 **** **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 **** **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 **** **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 **** **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 **** **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** 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 **** **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 **** **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 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 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 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 **** **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 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 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 **** **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 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 *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 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 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.