Visualisasi anotasi

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

Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8

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.

2. Di menu konteks, klik Tambahkan anotasi.

3. Tambahkan deskripsi anotasi, dan secara opsional, tag.

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

2. Di menu konteks, klik Tambahkan anotasi.

3. Tambahkan deskripsi anotasi, dan secara opsional, tag.

4. Klik Simpan.

Mengedit anotasi

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel Time series.

2. Klik ikon edit (pensil) di tooltip anotasi.

3. Ubah deskripsi, dan secara opsional, tag.

4. Klik Simpan.

Menghapus anotasi

1. Di dasbor, arahkan kursor ke indikator anotasi pada panel Time series.

2. 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 tagoutage. 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, aktifkanMatch any, dan Grafana akan menampilkan anotasi yang berisi salah satu tag yang Anda berikan.

Di Grafana v5.3+ 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 tertentu.