Connect ke sumber OpenSearch data

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.

Dengan Grafana Terkelola Amazon, Anda dapat menambahkan sumber terbuka OpenSearch(atau Elasticsearch lama) sebagai sumber data. Anda dapat melakukan banyak jenis OpenSearch kueri sederhana atau kompleks untuk memvisualisasikan log atau metrik yang disimpan di dalamnya. OpenSearch Anda juga dapat membuat anotasi grafik Anda dengan peristiwa log yang disimpan di. OpenSearch

Tambahkan OpenSearch sebagai sumber data

catatan

Untuk dapat menambahkan sumber OpenSearch data, Anda perlu menambahkan akun Grafana IAM Anda ke peran ALL_ACCESS dan SECURITY_MANAGER.

1. Buka menu samping dengan memilih ikon Grafana di header atas.

2. Di menu samping di bawah tautan Dasbor, Anda harus menemukan tautan Sumber Data bernama.

3. Pilih tombol + Tambahkan sumber data di header atas.

4. Pilih OpenSearchdari 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	Penjelasan
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)

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)

Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber OpenSearch data.

Pengaturan indeks

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

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

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 diganti/dikonfigurasi 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

Log

Dua parameter, Message field name danLevel 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

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

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 OpenSearch data

Editor kueri metrik

Editor OpenSearch kueri memungkinkan Anda memilih beberapa metrik dan mengelompokkan berdasarkan beberapa istilah atau filter. Gunakan ikon plus dan minus di sebelah kanan untuk menambah/menghapus metrik atau grup 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

Anda dapat mengontrol nama untuk deret waktu melalui bidang Alias input.

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

Metrik pipa

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

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, lihatTemplate dan variabel.

Variabel kueri

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

Kueri	Deskripsi
{"find": "fields", "type": "keyword"}	Mengembalikan daftar nama bidang dengan jenis indekskeyword.
{"find": "terms", "field": "@hostname", "size": 1000}	Mengembalikan daftar nilai untuk bidang menggunakan istilah agregasi. Kueri akan menggunakan rentang waktu dasbor saat ini sebagai rentang waktu untuk kueri.
{"find": "terms", "field": "@hostname", "query": '<lucene query>'}	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_count (daftar bawah N) dapat dilakukan dengan menyetelorder: "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

Ada dua sintaks:

• $<varname>Contoh: @hostname: $hostname

• [[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

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.

Nama	Penjelasan
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

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.

Kueri log

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

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.