Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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](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
**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)
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 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
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
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
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
### 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 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
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
*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, lihat[Template dan variabel](templates-and-variables.md).
#### 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 |
| --- | --- |
| \$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": ''\$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
Ada dua sintaks:
+ `$`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
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
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
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.