Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8
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.
-
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
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 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
-
Di dasbor pilih panel tempat Anda menambahkan anotasi. Menu konteks akan muncul.
-
Di menu konteks, pilih Tambahkan anotasi.
-
(Opsional) Tambahkan deskripsi anotasi dan tag.
-
Pilih Simpan.
Atau, untuk menambahkan anotasi, tekan Ctrl (atauCmd) 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
-
Di dasbor tekan
Ctrl(atauCmd) saat memilih area panel. -
Tambahkan deskripsi anotasi dan tag (opsional).
-
Klik Simpan.
Untuk mengedit anotasi
-
Di dasbor, arahkan kursor ke indikator anotasi pada panel.
-
Pilih ikon Edit (pensil) di tooltip anotasi.
-
Ubah deskripsi dan/atau tag.
-
Pilih Simpan.
Untuk menghapus anotasi
-
Di dasbor, arahkan kursor ke indikator anotasi pada panel.
-
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
-
Pilih ikon Pengaturan (roda gigi) di header dasbor untuk membuka menu pengaturan.
-
Pilih Anotasi.
-
Klik Tambahkan kueri anotasi.
-
Masukkan nama untuk kueri anotasi.
Nama ini diberikan ke sakelar (kotak centang) yang memungkinkan Anda mengaktifkan menampilkan peristiwa anotasi dari kueri ini.
-
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).
-
Jika Anda tidak ingin segera menggunakan kueri anotasi, kosongkan kotak centang Diaktifkan.
-
Jika Anda tidak ingin sakelar kueri anotasi ditampilkan di dasbor, pilih kotak centang Tersembunyi.
-
Pilih warna untuk penanda acara.
-
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.
-
-
Konfigurasikan kueri.
Opsi kueri anotasi berbeda untuk setiap sumber data. Untuk informasi tentang anotasi dalam sumber data tertentu, lihatConnect ke sumber data.
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
-
Pilih ikon pengaturan dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.
-
Pilih Anotasi.
-
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
-
Pilih ikon pengaturan dasbor (roda gigi) di header dasbor untuk membuka menu pengaturan dasbor.
-
Pilih Anotasi.
-
Pilih kueri Anotasi & Peringatan (Built-in).
-
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 tagoutage. 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.
