Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect ke sumber data Amazon OpenSearch Service
**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 Amazon Managed Grafana, Anda dapat menambahkan OpenSearch Layanan Amazon sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Sumber data ini mendukung domain OpenSearch Layanan, yang menjalankan OpenSearch cluster serta kluster Elasticsearch lama.
Opsi konfigurasi sumber AWS data menyederhanakan penambahan OpenSearch Layanan sebagai sumber data dengan menemukan akun OpenSearch Layanan yang ada, dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses. OpenSearch Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan OpenSearch Layanan sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan pada server Grafana yang dikelola sendiri.
Sumber data OpenSearch Layanan mendukung bahasa pemrosesan pipa (PPL). Untuk informasi selengkapnya tentang PPL, lihat [Menanyakan data OpenSearch Layanan Amazon menggunakan Bahasa Pemrosesan Piped](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html).
Anda dapat menggunakan sumber data OpenSearch Layanan untuk 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
**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data](ES-adding-AWS-config.md)
+ [Tambahkan OpenSearch Layanan Amazon secara manual sebagai sumber data](ES-adding-the-data-source.md)
+ [OpenSearch Pengaturan layanan](#ES-settings)
+ [Menggunakan sumber data Amazon OpenSearch Service](ES-use-datasource.md)
+ [OpenSearch Layanan Amazon Tanpa Server](datasources-opensearch-serverless.md)
+ [Dukungan jejak](datasources-opensearch-traces.md)
# Gunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data
Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya OpenSearch Layanan di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan OpenSearch Layanan sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan OpenSearch Layanan sebagai sumber data**
1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
1. Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih **Semua ruang kerja**.
1. Pilih nama ruang kerja.
1. Jika Anda tidak memilih untuk menggunakan izin yang dikelola layanan untuk ruang kerja ini saat Anda membuatnya, ubah dari menggunakan izin yang dikelola pelanggan menjadi menggunakan izin yang dikelola layanan guna memastikan bahwa peran dan kebijakan IAM yang tepat diaktifkan untuk menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Untuk melakukannya, pilih ikon edit dengan **peran IAM** dan kemudian pilih **Layanan dikelola**, **Simpan perubahan**. Untuk informasi selengkapnya, lihat [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md).
1. Pilih tab **Sumber data**. Kemudian pilih kotak centang untuk ** OpenSearch Layanan Amazon**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana** di baris ** OpenSearch Layanan Amazon**.
1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.
1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon lalu pilih layanan **AWS ,** Layanan Amazon. OpenSearch **
1. Pilih Wilayah yang ingin dicari Grafana Terkelola Amazon untuk menemukan sumber daya OpenSearch Layanan, lalu pilih akun dan domain OpenSearch Layanan yang ingin ditambahkan, konfigurasikan setelan indeks, lalu pilih **Tambahkan** sumber data.
# Tambahkan OpenSearch Layanan Amazon secara manual sebagai sumber data
**Untuk menambahkan sumber data OpenSearch Layanan Amazon secara manual**
1. Di menu sisi konsol Grafana, pilih **AWS**ikon, lalu pilih Sumber **Data**.
1. Pilih sumber data ** OpenSearch Layanan Amazon**. Jika perlu, Anda dapat mulai mengetik **OpenSearch** di kotak pencarian untuk membantu Anda menemukannya.
1. Pilih **Wilayah** tempat Anda ingin mencari data.
1. Pilih **Tambahkan sumber data**.
**catatan**
Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran.
## OpenSearch Pengaturan layanan
| 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 | Titik akhir domain OpenSearch Layanan Anda. Titik akhir mengambil format berikut: https://search-my-domain.us-east-1.es.amazonaws.com. |
| 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.
### 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 Layanan, 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 data Amazon OpenSearch Service
## 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\$1 untuk melihat dan mengedit metrik atau grup berdasarkan opsi.
## Menggunakan Piped Processing Language (PPL)
Sumber data Amazon OpenSearch Service mendukung Piped Processing Language (PPL), yang memungkinkan kemampuan kueri dan visualisasi yang lebih sederhana namun kuat. OpenSearch PPL memungkinkan pelanggan untuk mengeksplorasi dan menemukan data tanpa harus menulis pernyataan OpenSearch Domain Specific Language (DSL) yang panjang atau menulis kueri menggunakan objek JSON. Dengan PPL, Anda dapat menulis kueri sebagai satu set perintah yang dibatasi oleh pipa yang mirip dengan pipa UNIX.
Ambil contoh kueri DSL berikut sebagai contoh:
```
GET opensearch_sample_data_logs/_search{"from":0,"size":0,"timeout":"1m","query":{"bool":{"should":[{"term":{"response.keyword":{"value":"404","boost":1}}},{"term":{"response.keyword":{"value":"503","boost":1}}}],"adjust_pure_negative":true,"boost":1}},"sort":[{"_doc":{"order":"asc"}}],"aggregations":{"composite_buckets":{"composite":{"size":1000,"sources":[{"host":{"terms":{"field":"host.keyword","missing_bucket":true,"order":"asc"}}},{"response":{"terms":{"field":"response.keyword","missing_bucket":true,"order":"asc"}}}]},"aggregations":{"request_count":{"value_count":{"field":"request.keyword"}},"sales_bucket_sort":{"bucket_sort":{"sort":[{"request_count":{"order":"desc"}}],"size":10}}}}}}>
```
Kueri DSL sebelumnya dapat diganti dengan perintah PPL berikut yang ringkas dan dapat dibaca manusia.
```
source = opensearch_sample_data_logs | where response='404' or response='503' | stats count(request) as request_count by host, response | sort –request_count
```
Untuk informasi selengkapnya tentang PPL, lihat [Menanyakan data OpenSearch Layanan Amazon menggunakan Bahasa Pemrosesan Piped](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html).
## Penamaan seri dan pola alias
Anda dapat mengontrol nama untuk deret waktu menggunakan 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 saluran 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 data OpenSearch Layanan 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, tetapkan 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, menggunakan 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 menyetel`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 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 menggunakan 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 data OpenSearch Layanan, 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.
# OpenSearch Layanan Amazon Tanpa Server
**catatan**
OpenSearch Dukungan Layanan Tanpa Server hanya tersedia dengan ruang kerja Grafana yang menjalankan Grafana versi 9.4 dan yang lebih baru.
Anda dapat menggunakan sumber data OpenSearch Layanan untuk mengakses data Tanpa Server OpenSearch Layanan Amazon dengan Grafana Terkelola Amazon. Akses ke data dikendalikan oleh kebijakan akses data. Contoh berikut menunjukkan kebijakan yang memungkinkan pengguna melakukan kueri koleksi dan indeks tertentu. Pastikan untuk mengganti*`collection_name`*,*`index_name`*, dan *`principal_arn`* dengan nilai yang benar untuk kasus penggunaan Anda.
```
[
{
"Rules": [
{
"Resource": ["collection/{collection_name}"],
"Permission": ["aoss:DescribeCollectionItems"],
"ResourceType": "collection"
},
{
"Resource": ["index/{collection_name}/{index_name}"],
"Permission": ["aoss:DescribeIndex", "aoss:ReadDocument"],
"ResourceType": "index"
}
],
"Principal": ["principal_arn"],
"Description": "read-access"
}
]
```
# Dukungan jejak
OpenSearch Plugin ini memiliki dukungan untuk melihat daftar jejak dalam bentuk tabel, dan satu **jejak di Trace View**, yang menunjukkan garis waktu rentang jejak.
**catatan**
OpenSearch Jejak kueri hanya tersedia menggunakan kueri Lucene.
Dukungan pelacakan hanya tersedia untuk ruang kerja Grafana yang mendukung versi 9.4 atau yang lebih baru.
Untuk membuat kueri yang menampilkan semua jejak, gunakan tipe kueri Lucene `Traces` dengan kueri kosong. Jika perlu, pilih jenis visualisasi **Tabel**.
Memilih ID jejak dalam tabel akan membuka jejak itu dalam tampilan jejak.
Untuk membuat kueri yang menampilkan jejak tunggal, gunakan kueri`traceid: {traceId}`, dan, jika perlu, pilih jenis visualisasi **Jejak**.