Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect ke sumber data bawaan
Sumber data berikut didukung di setiap ruang kerja Grafana Terkelola Amazon.
Untuk ruang kerja yang mendukung versi 9 dan yang lebih baru, beberapa sumber data ini mungkin tidak diinstal secara default. Sumber data inti tersedia di semua instalasi, tetapi sumber data yang bukan bagian dari kumpulan inti mungkin memerlukan plugin Grafana yang benar untuk diinstal. Anda dapat menginstal plugin untuk sumber data tambahan yang tidak tercantum di sini. Untuk informasi selengkapnya tentang mengelola plugin, lihat[Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).
**Topics**
+ [Pengelola Peringatan](data-source-alertmanager.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [OpenSearch Layanan Amazon](using-Amazon-OpenSearch-in-AMG.md)
+ [AWS IoT SiteWise](using-iotsitewise-in-AMG.md)
+ [AWS IoT TwinMaker](AMG-iot-twinmaker.md)
+ [Prometheus](prometheus-data-source.md)
+ [Amazon Timestream](timestream-datasource.md)
+ [Amazon Athena](AWS-Athena.md)
+ [Amazon Redshift](AWS-Redshift.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Monitor Azure](using-azure-monitor-in-AMG.md)
+ [Grafit](using-graphite-in-AMG.md)
+ [Pemantauan Google Cloud](using-google-cloud-monitoring-in-grafana.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Jaeger](jaeger-data-source.md)
+ [Loki](using-loki-in-AMG.md)
+ [Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [MySQL](using-mysql-in-AMG.md)
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [OpenTSDB](using-opentsdb-in-AMG.md)
+ [PostgreSQL](using-postgresql-in-AMG.md)
+ [Templ](tempo-data-source.md)
+ [TestData](testdata-data-source.md)
+ [Zipkin](zipkin-data-source.md)
# Connect ke sumber data Alertmanager
Grafana menyertakan dukungan bawaan untuk Prometheus Alertmanager. Setelah peringatan Grafana dikonfigurasi, Anda dapat menggunakan UI peringatan Grafana untuk mengelola keheningan, titik kontak, serta kebijakan pemberitahuan. Opsi drop-down di halaman ini memungkinkan Anda untuk beralih antara Grafana dan sumber data Alertmanager yang dikonfigurasi.
**Implementasi Alertmanager**
[Implementasi Prometheus](https://prometheus.io/), [Cortex](https://cortexmetrics.io/), dan [Grafana](https://grafana.com/docs/mimir/latest/) Mimir dari Alertmanager didukung. Anda dapat menentukan implementasi di halaman pengaturan sumber data. Titik kontak Prometheus dan kebijakan notifikasi hanya-baca di UI peringatan Grafana, karena tidak mendukung pembaruan konfigurasi melalui HTTP API.
## Mengkonfigurasi sumber data Alertmanager
Anda dapat mengonfigurasi sumber data Alertmanager untuk digunakan dengan peringatan Grafana.
**Prasyarat**
Untuk mengkonfigurasi Alertmanager, Anda harus memiliki prasyarat berikut lengkap:
+ Instance Prometheus, dengan metrik yang dicerna, dan setidaknya satu aturan peringatan atau perekaman yang dikonfigurasi. Anda akan membutuhkan URL untuk ruang kerja Anda.
+ Izin yang ditetapkan untuk Grafana Terkelola Amazon agar memiliki akses baca ke lansiran, grup peringatan, keheningan, dan titik kontak dari implementasi Alertmanager Anda.
**Untuk mengonfigurasi sumber data Alertmanager**
1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**
1. Pilih **Tambahkan sumber data**, dan pilih **Alertmanager** dari daftar tipe sumber data.
1. Berikan informasi berikut untuk sumber data baru Anda.
+ Untuk **Nama**, berikan nama yang Anda pilih untuk sumber data Anda.
+ ****Untuk **Implementasi**, pilih implementasi Alertmanager Anda — baik Prometheus, Mimir, atau **Cortex**.****
+ Di bawah **HTTP**, untuk **URL**, berikan URL Alertmanager. Untuk Prometheus, ini adalah URL ruang kerja, dengan ditambahkan. `alertmanager` Misalnya, `https://myprometheus/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`.
+ Di bawah **Auth**, konfigurasikan detail otentikasi yang diperlukan untuk mengakses implementasi Alertmanager Anda.
1. Pilih **Simpan & uji** untuk menyelesaikan penyiapan sumber data Anda.
Jika sumber data Anda diatur dengan benar, Anda akan melihat pesan yang mengatakan **Pemeriksaan Kesehatan lulus**.
# Connect ke sumber CloudWatch data Amazon
Dengan Amazon Managed Grafana, Anda dapat menambahkan Amazon CloudWatch sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan CloudWatch sebagai sumber data dengan menemukan CloudWatch akun Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses. CloudWatch Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan CloudWatch 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.
**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data](adding-CloudWatch-AWS-config.md)
+ [Tambahkan secara manual CloudWatch sebagai sumber data](adding--CloudWatch-manual.md)
+ [Menggunakan editor kueri](CloudWatch-using-the-query-editor.md)
+ [Dasbor yang dikuratori](CloudWatch-curated-dashboards.md)
+ [Kueri templat](cloudwatch-templated-queries.md)
+ [Menggunakan contoh ec2\$1instance\$1attribute](cloudwatch-ec2-instance-attribute-examples.md)
+ [Menggunakan variabel template format JSON](cloudwatch-using-json-format-template-variables.md)
+ [Harga](cloudwatch-pricing.md)
+ [Kuota layanan](cloudwatch-service-quotas.md)
+ [Observabilitas lintas akun](cloudwatch-cross-account.md)
# Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch 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 CloudWatch sumber daya di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan CloudWatch sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data**
1. Buka konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
1. Pada panel navigasi, 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**.
1. Pilih kotak centang untuk **Amazon**, CloudWatch lalu pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi.
1. Pilih **Konfigurasi di Grafana** di baris **Amazon CloudWatch**.
1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center, jika perlu.
1. **Pada bilah navigasi di konsol ruang kerja Grafana, pilih AWS ikon dan kemudian pilih AWS layanan,. **CloudWatch****
1. Pilih Wilayah default tempat Anda ingin sumber CloudWatch data kueri.
1. Pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.
# Tambahkan secara manual CloudWatch sebagai sumber data
**Untuk menambahkan sumber CloudWatch data secara manual**
1. **Di menu sisi konsol Grafana, arahkan kursor ke ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber **CloudWatch**data. Jika perlu, Anda dapat mulai mengetik **CloudWatch** di kotak pencarian untuk membantu Anda menemukannya.
## CloudWatch pengaturan
CloudWatch Pengaturan berikut berlaku.
| Nama | Deskripsi |
| --- | --- |
| `Name` | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri. |
| `Default` | Menentukan sumber data yang akan dipilih sebelumnya untuk panel baru. |
| `Default Region` | Atur Wilayah di editor kueri. Dapat diubah berdasarkan per-query. |
| `Namespaces of Custom Metrics` | Menentukan CloudWatch ruang nama metrik kustom. Dapat menyertakan beberapa ruang nama, dipisahkan dengan koma. |
| `Auth Provider` | Menentukan penyedia untuk mendapatkan kredensional. |
| `Assume Role Arn` | Menentukan Nama Sumber Daya Amazon (ARN) dari peran yang akan diasumsikan. |
| `External ID` | (Opsional) Menentukan ID eksternal. Gunakan jika Anda mengambil peran dalam peran lain Akun AWS yang telah dibuat dengan ID eksternal. |
| `Timeout` | Konfigurasikan batas waktu khusus untuk kueri CloudWatch Log. |
| `X-Ray trace links` | Untuk menambahkan tautan secara otomatis di log Anda saat log berisi `@xrayTraceId` bidang, tautkan sumber data X-Ray di bagian **tautan jejak X-Ray** pada konfigurasi sumber data. Anda harus sudah memiliki [sumber data X-Ray](x-ray-data-source.md) yang dikonfigurasi. |
### Autentikasi
Untuk mengaktifkan autentikasi antara Grafana Terkelola Amazon CloudWatch dan, Anda dapat menggunakan konsol Grafana Terkelola Amazon untuk membuat kebijakan dan izin yang diperlukan dengan cepat. Atau, Anda dapat mengatur otentikasi secara manual menggunakan beberapa metode yang sama seperti yang Anda lakukan di server Grafana yang dikelola sendiri.
Untuk menggunakan konfigurasi sumber data Grafana yang Dikelola Amazon untuk menyiapkan kebijakan dengan cepat, ikuti langkah-langkahnya. [Gunakan konfigurasi sumber AWS data untuk ditambahkan CloudWatch sebagai sumber data](adding-CloudWatch-AWS-config.md)
Untuk mengatur izin secara manual, gunakan salah satu metode di bagian berikut.
#### AWS kredensi
Ada tiga metode otentikasi berbeda yang tersedia.
+ **AWS SDK Default** — Menggunakan izin yang ditentukan dalam peran yang dilampirkan ke ruang kerja Anda. Untuk informasi selengkapnya, lihat [Izin yang dikelola pelanggan](AMG-manage-permissions.md#AMG-customer-managed).
+ **Akses dan kunci rahasia** — Sesuai dengan AWS SDK untuk Go `StaticProvider`. Menggunakan ID kunci akses yang diberikan dan kunci rahasia untuk mengautentikasi. Metode ini tidak memiliki fallback, dan akan gagal jika key pair yang disediakan tidak berfungsi.
#### Peran IAM
Saat ini, semua akses CloudWatch dilakukan di sisi server oleh backend Grafana menggunakan SDK resmi. AWS Jika Anda memilih metode otentikasi *Default AWS SDK*, dan server Grafana Anda sedang berjalan AWS, Anda dapat menggunakan peran IAM untuk menangani autentikasi secara otomatis.
Untuk informasi selengkapnya, lihat [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html).
#### Kebijakan IAM
Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca CloudWatch metrik dan tag EC2, instance, dan Wilayah. Anda dapat melampirkan izin ini ke peran IAM dan menggunakan dukungan Grafana bawaan untuk mengasumsikan peran.
Contoh kode berikut menunjukkan kebijakan minimal.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowReadingMetricsFromCloudWatch",
"Effect": "Allow",
"Action": [
"cloudwatch:DescribeAlarmsForMetric",
"cloudwatch:DescribeAlarmHistory",
"cloudwatch:DescribeAlarms",
"cloudwatch:ListMetrics",
"cloudwatch:GetMetricStatistics",
"cloudwatch:GetMetricData",
"cloudwatch:GetInsightRuleReport"
],
"Resource": "*"
},
{
"Sid": "AllowReadingLogsFromCloudWatch",
"Effect": "Allow",
"Action": [
"logs:DescribeLogGroups",
"logs:GetLogGroupFields",
"logs:StartQuery",
"logs:StopQuery",
"logs:GetQueryResults",
"logs:GetLogEvents"
],
"Resource": "*"
},
{
"Sid": "AllowReadingTagsInstancesRegionsFromEC2",
"Effect": "Allow",
"Action": [
"ec2:DescribeTags",
"ec2:DescribeInstances",
"ec2:DescribeRegions"
],
"Resource": "*"
},
{
"Sid": "AllowReadingResourcesForTags",
"Effect": "Allow",
"Action": "tag:GetResources",
"Resource": "*"
},
{
"Sid": "AllowReadingAcrossAccounts",
"Effect": "Allow",
"Action": [
"oam:ListSinks",
"oam:ListAttachedLinks"
],
"Resource": "*"
}
]
}
```
------
#### Dengan asumsi peran
`Assume Role ARN`Bidang ini memungkinkan Anda menentukan peran IAM mana yang akan diasumsikan, jika ada. Jika Anda mengosongkan ini, kredensi yang disediakan akan digunakan secara langsung dan peran atau pengguna terkait harus memiliki izin yang diperlukan. Jika bidang ini tidak kosong, kredensi yang disediakan digunakan untuk melakukan panggilan. `sts:AssumeRole`
# Menggunakan editor kueri
Sumber CloudWatch data di Amazon Managed Grafana menyediakan editor kueri canggih yang memungkinkan Anda mengambil dan menganalisis metrik dan log dari berbagai AWS layanan yang mengirim data ke. CloudWatch Editor kueri mendukung dua mode kueri yang berbeda: Pencarian Metrik dan CloudWatch Log.
Mode editor kueri untuk metrik menggunakan CloudWatch API untuk menemukan metrik yang diunggah. CloudWatch Mode untuk log menggunakan CloudWatch Log APIs untuk menemukan catatan log. Setiap mode memiliki editor kueri khusus sendiri. Anda memilih API mana yang ingin Anda kueri dengan menggunakan sakelar mode kueri di bagian atas editor.
**Topics**
+ [Menggunakan editor kueri metrik](CloudWatch-using-the-metric-query-editor.md)
+ [Menggunakan editor kueri Amazon CloudWatch Logs](CloudWatch-using-the-logs-query-editor.md)
# Menggunakan editor kueri metrik
Editor kueri metrik memungkinkan Anda membuat dua jenis kueri - **Pencarian Metrik** dan **Kueri Metrik**. Opsi **Kueri Metrik** menanyakan data menggunakan Wawasan CloudWatch Metrik.
## Bidang editor kueri umum
Ada tiga bidang yang umum untuk mode **Pencarian Metrik** dan **Kueri Metrik**.
**Bidang umum**
**Id**
`GetMetricData`API mengharuskan semua kueri memiliki ID unik. Gunakan bidang ini untuk menentukan ID pilihan. ID dapat mencakup angka, huruf, dan garis bawah, dan harus dimulai dengan huruf kecil. Jika tidak ada ID yang ditentukan, Grafana Terkelola Amazon menghasilkan ID menggunakan pola berikut:. `query[refId of the current query row]` Misalnya, `queryA` mewakili baris kueri pertama di editor panel.
**Periode**
Periode adalah lamanya waktu yang terkait dengan CloudWatch statistik tertentu. Periode didefinisikan dalam jumlah detik. Nilai yang valid termasuk 1, 5, 10, 30, atau kelipatan 60. Jika Anda membiarkan kolom periode kosong atau disetel ke`auto`, maka akan dihitung secara otomatis berdasarkan rentang waktu dan kebijakan CloudWatch penyimpanan. Rumus yang digunakan adalah`time range in seconds / 2000`, dan kemudian beralih ke nilai berikutnya yang lebih tinggi dalam array periode yang telah ditentukan [60, 300, 900, 3600, 21600, 86400] setelah menghapus periode berdasarkan retensi. Untuk melihat periode yang digunakan Grafana Terkelola Amazon, pilih **Tampilkan Pratinjau Kueri** di editor kueri.
**Alias**
Pola alias berikut berlaku.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html)
# Menggunakan opsi pencarian metrik
Untuk membuat kueri yang valid di **Pencarian Metrik**, Anda harus menentukan namespace, nama metrik, dan setidaknya satu statistik. Jika **Match Exact** diaktifkan, Anda juga harus menentukan semua dimensi metrik yang Anda kueri. Skema metrik harus sama persis. Untuk informasi selengkapnya, lihat [sintaks ekspresi CloudWatch pencarian](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html).
Jika **Match Exact** dimatikan, Anda dapat menentukan sejumlah dimensi yang ingin Anda filter. Hingga 100 metrik yang cocok dengan kriteria filter Anda dikembalikan.
## Kueri dinamis menggunakan karakter wildcard dimensi
Anda dapat memantau daftar metrik dinamis dengan menggunakan karakter wildcard asterisk (`*`) untuk satu atau beberapa nilai dimensi.
Ini membantu Anda memantau metrik untuk AWS sumber daya, seperti instans EC2 atau container. Misalnya, ketika instance baru dibuat sebagai bagian dari peristiwa penskalaan otomatis, instance tersebut akan muncul secara otomatis di grafik tanpa Anda harus melacak instance baru. IDs Kemampuan ini saat ini terbatas untuk mengambil hingga 100 metrik. Anda dapat memilih **Tampilkan Pratinjau Kueri** untuk melihat ekspresi pencarian yang dibuat secara otomatis untuk mendukung karakter wildcard.
Secara default, ekspresi penelusuran didefinisikan sedemikian rupa sehingga metrik yang ditanyakan harus sama persis dengan nama dimensi yang ditentukan. Ini berarti bahwa dalam contoh hanya metrik dengan tepat satu dimensi dengan nama `InstanceId` yang dikembalikan.
Untuk menyertakan metrik yang memiliki dimensi lain yang ditentukan, Anda dapat menonaktifkan **Match Exact**. Mematikan **Match Exact** juga membuat ekspresi penelusuran meskipun Anda tidak menggunakan karakter wildcard. Grafana mencari metrik apa pun yang cocok setidaknya dengan namespace, nama metrik, dan semua dimensi yang ditentukan.
## Variabel template multi-nilai
Saat menentukan nilai dimensi berdasarkan variabel template multi-nilai, ekspresi penelusuran digunakan untuk menanyakan metrik yang cocok. Hal ini memungkinkan penggunaan beberapa variabel template dalam satu query. Anda juga dapat menggunakan variabel template untuk kueri yang memiliki opsi **Match Exact** dimatikan.
Ekspresi penelusuran saat ini dibatasi hingga 1024 karakter, sehingga kueri Anda mungkin gagal jika Anda memiliki daftar nilai yang panjang. Jika Anda ingin menanyakan semua metrik yang memiliki nilai apa pun untuk nama dimensi tertentu, sebaiknya gunakan karakter wildcard asterisk (`*`) alih-alih opsi. `All`
Penggunaan variabel template multi-nilai hanya didukung untuk nilai dimensi. Menggunakan variabel template multi-nilai untuk`Region`,`Namespace`, atau `Metric Name` tidak didukung.
## Ekspresi matematika metrik
Anda dapat membuat metrik deret waktu baru dengan beroperasi di atas CloudWatch metrik menggunakan fungsi matematika. Operator aritmatika, pengurangan unary, dan fungsi lainnya didukung dan dapat diterapkan pada metrik. CloudWatch Untuk informasi selengkapnya tentang fungsi matematika CloudWatch metrik, lihat [Menggunakan matematika metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html).
Sebagai contoh, untuk menerapkan operasi aritmatika pada metrik, berikan ID (string unik) ke metrik mentah. Anda kemudian dapat menggunakan ID ini dan menerapkan operasi aritmatika padanya di `Expression` bidang metrik baru.
Jika Anda menggunakan `Expression` bidang untuk mereferensikan kueri lain`queryA * 2`, misalnya, Anda tidak dapat membuat aturan peringatan berdasarkan kueri tersebut.
## Periode
Periode adalah lamanya waktu yang terkait dengan CloudWatch statistik Amazon tertentu. Periode didefinisikan dalam jumlah detik. Nilai yang valid termasuk 1, 5, 10, 30, atau kelipatan 60.
Jika Anda membiarkan bidang periode kosong atau disetel ke **auto**, maka itu menghitung secara otomatis berdasarkan rentang waktu. Rumus yang digunakan adalah`time range in seconds / 2000`, dan kemudian beralih ke nilai berikutnya yang lebih tinggi dalam array periode `[60, 300, 900, 3600, 21600, 86400]` yang telah ditentukan. Untuk melihat periode yang digunakan Grafana Terkelola Amazon, pilih **Tampilkan Pratinjau Kueri** di editor kueri.
## Tautan dalam dari panel Grafana ke konsol CloudWatch
Memilih deret waktu di panel menunjukkan menu konteks dengan tautan ke **Lihat di CloudWatch konsol**. Memilih tautan itu membuka tab baru yang membawa Anda ke CloudWatch konsol dan menampilkan semua metrik untuk kueri itu. Jika saat ini Anda belum masuk ke CloudWatch konsol, tautan akan meneruskan Anda ke halaman login. Tautan yang disediakan valid untuk semua Akun AWS tetapi hanya menampilkan metrik yang benar jika Anda masuk ke Akun AWS yang sesuai dengan sumber data yang dipilih di Grafana.
Fitur ini tidak tersedia untuk metrik yang didasarkan pada ekspresi matematika metrik.
# Menggunakan opsi kueri metrik untuk menanyakan data Wawasan CloudWatch Metrik
**catatan**
Amazon CloudWatch Metrics Insights sedang dalam pratinjau. CloudWatch Fitur Wawasan Metrik terbuka untuk semua. Akun AWS Fitur dapat berubah sewaktu-waktu.
Anda dapat melakukan kueri data Wawasan CloudWatch Metrik dengan memilih `metric query` mode di Editor **kueri metrik**.
CloudWatch Metrics Insights adalah mesin kueri SQL berkinerja tinggi yang kuat yang dapat Anda gunakan untuk menanyakan metrik Anda dalam skala besar. Ini adalah mesin kueri berbasis SQL yang cepat, fleksibel, yang dapat Anda gunakan untuk mengidentifikasi tren dan pola dalam semua CloudWatch metrik Anda secara real time. Ini menggunakan dialek SQL. Untuk informasi selengkapnya tentang sintaks kueri Metrics Insights, lihat. [Sintaks kueri dan kata kunci](#metrics-insights-syntax-keywords)
## Sintaks kueri dan kata kunci
CloudWatch Metrics Insights menggunakan dialek SQL. Contoh berikut menunjukkan sintaks query.
```
SELECT FUNCTION(metricName)
FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ]
[ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ]
[ GROUP BY labelKey [, ...]]
[ ORDER BY FUNCTION() [DESC | ASC] ]
[ LIMIT number]
```
Kata kunci tidak peka huruf besar/kecil, tetapi pengenalnya peka huruf besar/kecil. Pengidentifikasi mencakup nama metrik, ruang nama, dan dimensi.
Tabel berikut menyediakan kata kunci query dan deskripsi mereka.
| Kata Kunci | Deskripsi |
| --- | --- |
| FUNCTION | Wajib. Menentukan fungsi agregat untuk digunakan, dan juga menentukan nama metrik untuk query. Nilai yang valid adalah AVG, COUNT, MAX, MIN, dan SUM. |
| MetricName | Wajib. Misalnya, CPUUtilization. |
| FROM | Wajib. Menentukan sumber metrik. Anda dapat menentukan namespace metrik yang berisi metrik untuk kueri, atau fungsi tabel SCHEMA. Beberapa contoh namespace adalah AWS/EC2 dan. AWS/Lambda |
| SCHEMA | (Opsional) Memfilter hasil kueri untuk hanya menampilkan metrik yang sama persis, atau metrik yang tidak cocok. |
| WHERE | (Opsional) Memfilter hasil untuk hanya menampilkan metrik yang cocok dengan ekspresi yang Anda tentukan. Misalnya, WHERE InstanceType \$1= 'c3.4xlarge'. |
| GROUP BY | (Opsional) Kelompokkan hasil kueri menjadi beberapa deret waktu. Misalnya, GROUP BY ServiceName. |
| ORDER BY | (Opsional) Menentukan urutan deret waktu untuk kembali. Pilihannya adalah ASC danDESC. |
| LIMIT | (Opsional) Membatasi jumlah deret waktu untuk kembali. |
Berikut ini beberapa contohnya:
+
```
SELECT AVG(CPUUtilization) FROM "AWS/EC2"
```
Mencocokkan semua `CPUUtilization` metrik di `AWS/EC2` namespace, mengabaikan dimensinya, dan mengembalikan satu deret waktu gabungan.
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")
```
Hanya cocok dengan `CPUUtilization` metrik di `AWS/EC2` namespace yang tidak memiliki dimensi yang ditentukan.
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
```
Hanya cocok dengan `CPUUtilization` metrik yang dilaporkan CloudWatch dengan tepat satu dimensi,`InstanceId`.
+
```
SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
AvailabilityZone)
```
Mtches hanya `RequestCount` metrik yang dilaporkan CloudWatch dari `AWS/ApplicationELB` dengan tepat dua dimensi, `LoadBalancer` dan. `AvailabilityZone`
Nilai label harus dilampirkan oleh tanda kutip tunggal.
### Karakter melarikan diri
Dalam kueri, nilai label harus selalu dikurung dengan tanda kutip tunggal. Misalnya, `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`.
Ruang nama metrik, nama metrik, dan kunci label yang berisi karakter selain huruf, angka, dan garis bawah (`_`) harus dikelilingi oleh tanda kutip ganda. Misalnya, `SELECT MAX("My.Metric")`. Jika salah satu dari ini berisi tanda kutip ganda itu sendiri (seperti`Bytes"Input"`), Anda harus menghindari tanda kutip ganda dengan garis miring terbalik, seperti pada. `SELECT AVG("Bytes\"Input\"")` Jika namespace metrik, nama metrik, atau kunci label, berisi kata yang merupakan kata kunci cadangan dalam Metrics Insights, ini juga harus diapit dalam tanda kutip ganda. Sebagai contoh, jika Anda memiliki metrik yang disebut `LIMIT`, Anda akan menggunakan `SELECT AVG("LIMIT")`. Ini juga benar untuk mengapit namespace, nama metrik, atau label dalam tanda kutip ganda bahkan jika itu tidak menyertakan kata kunci yang dicadangkan.
## Mode pembangun dan mode kode
Anda dapat membuat kueri dalam `Builder` mode atau `Code` mode.
**Untuk membuat kueri dalam `Builder` mode**
1. Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel sebelumnya.
1. Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.
**Untuk membuat kueri dalam `Code` mode**
1. Tulis kueri Anda di editor kode.
1. Untuk menjalankan kueri, pilih **Jalankan kueri** di editor kode.
Untuk membuat kueri dalam `builder` mode:
+ Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel di atas.
+ Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.
Grafana secara otomatis membuat kueri SQL berdasarkan pilihan Anda.
Untuk membuat kueri dalam `code` mode:
+ Tulis kueri Anda di editor kode.
+ Untuk menjalankan kueri, pilih **kueri Jalankan** pada editor kode.
Editor kode memiliki fitur pelengkapan otomatis bawaan yang memberikan saran untuk kata kunci, agregasi, ruang nama, metrik, label, dan nilai label. Saran ditampilkan saat Anda memasukkan tanda spasi, koma, atau dolar. Anda juga dapat menggunakan kombinasi keyboard`CTRL+Space`.
Editor kode dapat melengkapi kueri secara otomatis. Namun, penggunaan variabel template dalam editor kode dapat mengganggu pelengkapan otomatis.
## CloudWatch Contoh Wawasan Metrik
**catatan**
CloudWatch Wawasan Metrik ada dalam pratinjau terbuka. Pratinjau terbuka untuk semua AWS akun dan Anda tidak perlu meminta akses. Fitur dapat ditambahkan atau diubah sebelum mengumumkan Ketersediaan Umum.
Bagian ini berisi contoh kueri Wawasan CloudWatch Metrik yang berguna yang dapat Anda salin dan gunakan secara langsung atau salin dan modifikasi di editor kueri. Beberapa contoh ini sudah tersedia di konsol, dan Anda dapat mengaksesnya dengan memilih **Tambahkan kueri** di tampilan **Metrik**.
### Contoh EC2
Lihat pemanfaatan CPU per metrik instans
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
```
Lihat rata-rata pemanfaatan CPU di seluruh armada
```
SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
```
Lihat 10 instans dengan pemanfaatan CPU rata-rata tertinggi
```
SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
```
Lihat 10 instans dengan pemanfaatan CPU tertinggi, diurutkan berdasarkan maksimum, dalam urutan menurun
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10
```
Dalam hal ini, CloudWatch agen mengumpulkan CPUUtilization metrik per aplikasi. Kueri ini menyaring rata-rata metrik ini untuk nama aplikasi tertentu.
```
SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"
```
Lihat waktu eksekusi rata-rata untuk 10 fungsi Lambda teratas, diurutkan berdasarkan maksimum, dalam urutan menurun
```
SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10
```
Lihat maksimum, rata-rata, dan minimum waktu eksekusi Lambda
```
SELECT MAX(Duration)
FROM "AWS/Lambda"
```
### Contoh Penyeimbang Beban Aplikasi
Lihat metrik yang memiliki dimensi **LoadBalancer**dan **AvailabilityZone**
```
SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
```
Lihat metrik dengan jumlah koneksi TCP bersamaan yang aktif
```
SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"
```
### Contoh Amazon EBS
Lihat 10 byte tulis rata-rata per volume teratas dalam urutan menurun
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10
```
Lihat rata-rata waktu tulis volume Amazon EBS
```
SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"
```
Lihat rata-rata waktu idle volume Amazon EBS
```
SELECT AVG(VolumeIdleTime)
FROM "AWS/EBS"
View average burst balance per volume
SELECT AVG(BurstBalance)
FROM "AWS/EBS"
GROUP BY VolumeId
View average read bytes across Amazon EBS volumes
SELECT AVG(VolumeReadBytes)
FROM "AWS/EBS"
```
Lihat rata-rata byte tulis di seluruh volume Amazon EBS
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
```
### Contoh Amazon Simple Storage Service
Lihat grup latensi rata-rata berdasarkan nama bucket
```
SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName
```
Lihat rata-rata jumlah objek per ember di semua bucket Amazon S3
```
SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
```
### Contoh Amazon Simple Notification Service
A mazon-simple-notificaation-service -contoh
```
SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"
```
Melihat rata-rata jumlah pesan yang gagal untuk setiap nama topik
```
SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName
```
### AWS Contoh penggunaan API
Lihat 20 teratas AWS APIs dengan jumlah panggilan di akun Anda
```
SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20
```
## CloudWatch Batas Wawasan Metrik
CloudWatch Metrics Insights saat ini memiliki batasan berikut:
+ Anda hanya dapat menanyakan tiga jam data terbaru.
+ Satu kueri dapat memproses tidak lebih dari 10.000 metrik. Ini berarti bahwa jika `WHERE` klausa `SELECT``FROM`,, dan cocok dengan lebih dari 10.000 metrik, hanya 10.000 metrik pertama yang ditemukan yang akan diproses oleh kueri.
+ Satu kueri dapat mengembalikan tidak lebih dari 500 deret waktu. Ini berarti bahwa jika kueri memproses lebih dari 500 metrik, tidak semua metrik akan dikembalikan dalam hasil kueri. Jika Anda menggunakan `ORDER BY` klausa, maka semua metrik yang sedang diproses akan diurutkan dan 500 yang memiliki nilai tertinggi atau terendah sesuai dengan `ORDER BY` klausa Anda akan dikembalikan. Jika Anda tidak menyertakan `ORDER BY` klausa, Anda tidak dapat mengontrol 500 metrik pencocokan mana yang dikembalikan.
+ Setiap `GetMetricData` operasi hanya dapat memiliki satu kueri, tetapi Anda dapat memiliki beberapa widget di dasbor yang masing-masing menyertakan kueri.
# Menggunakan editor kueri Amazon CloudWatch Logs
Untuk menanyakan CloudWatch Log, pilih Wilayah dan hingga 20 grup log yang ingin Anda kueri. Gunakan area input utama untuk menulis kueri Anda. Untuk informasi selengkapnya, lihat [sintaks kueri Wawasan CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html).
Anda juga dapat menulis kueri yang mengembalikan data deret waktu dengan menggunakan `stats` perintah di Wawasan CloudWatch Log. Saat membuat `stats` kueri di Jelajahi, Anda harus memastikan bahwa Anda berada dalam mode Jelajahi Metrik.
Di sebelah kanan bidang input kueri terdapat tautan Wawasan CloudWatch Log yang membuka konsol Wawasan CloudWatch Log dengan kueri Anda. Anda dapat melanjutkan eksplorasi di sana jika perlu.
## Menggunakan variabel template
Seperti beberapa sumber data lainnya, sumber CloudWatch data mendukung penggunaan variabel template dalam kueri. Untuk informasi selengkapnya, lihat [Template dan variabel](templates-and-variables.md).
## Penautan dalam dari panel Grafana ke CloudWatch konsol Log
Jika Anda ingin melihat kueri di konsol Wawasan CloudWatch Log, pilih tombol **Wawasan CloudWatch Log** di sebelah editor kueri. Jika saat ini Anda belum masuk ke CloudWatch konsol, tautan akan meneruskan Anda ke halaman login. Tautan yang disediakan valid untuk semua Akun AWS tetapi hanya menampilkan metrik yang benar jika Anda masuk ke Akun AWS yang sesuai dengan sumber data yang dipilih di Grafana.
## Peringatan
Karena kueri CloudWatch Log dapat mengembalikan data numerik, misalnya, melalui penggunaan `stats` perintah, peringatan didukung. Lihat informasi yang lebih lengkap di [Grafana memperingatkan](alerts-overview.md).
# Dasbor yang dikuratori
Sumber CloudWatch data yang diperbarui dikirimkan dengan dasbor pra-konfigurasi untuk lima layanan paling populer AWS :
+ Amazon EC2
+ Amazon Elastic Block Store
+ AWS Lambda
+ CloudWatch Log Amazon
+ Amazon Relational Database Service
Untuk mengimpor dasbor yang telah dikonfigurasi sebelumnya, buka halaman konfigurasi sumber CloudWatch data Anda dan pilih tab **Dasbor**. Pilih **Impor** untuk dasbor yang ingin Anda gunakan. Untuk menyesuaikan dasbor, sebaiknya simpan dasbor dengan nama yang berbeda, karena jika tidak, dasbor akan ditimpa saat versi baru dasbor dirilis.
# Kueri templat
Alih-alih hardcoding detail 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.
Lihat [Template](templates-and-variables.md#templates) untuk pengantar fitur templating dan berbagai jenis variabel template.
## Variabel kueri
Sumber CloudWatch data menyediakan kueri berikut yang dapat Anda tentukan di bidang **Kueri** di tampilan Edit **variabel**. Anda dapat menggunakan ini untuk mengisi daftar opsi variabel dengan hal-hal seperti`region`,`namespaces`,`metric names`, dan`dimension keys/values`.
Sebagai gantinya`region`, Anda dapat menentukan `default` untuk menggunakan Wilayah default yang dikonfigurasi dalam sumber data untuk kueri.
| Nama | Deskripsi |
| --- | --- |
| regions() | Mengembalikan daftar semua AWS Wilayah. |
| namespaces() | Mengembalikan daftar namespace yang CloudWatch mendukung. |
| metrics(namespace, [region]) | Mengembalikan daftar metrik di namespace. (Tentukan Wilayah atau gunakan "default" untuk metrik khusus.) |
| dimension\$1keys(namespace) | Mengembalikan daftar kunci dimensi di namespace. |
| dimension\$1values(region, namespace, metric, dimension\$1key, [filters]) | Mengembalikan daftar nilai dimensi yang cocok dengan yang ditentukanregion,namespace,metric, ataudimension\$1key. secara ternatif, Anda dapat menggunakan dimensi filters untuk mendapatkan hasil yang lebih spesifik. |
| ebs\$1volume\$1ids(region, instance\$1id) | Mengembalikan daftar volume IDs yang cocok dengan yang ditentukanregion,instance\$1id. |
| ec2\$1instance\$1attribute(region, attribute\$1name, filters) | Mengembalikan daftar atribut yang cocok dengan yang ditentukanregion,attribute\$1name,filters. |
| resource\$1arns(region, resource\$1type, tags) | Mengembalikan daftar ARNs pencocokan yang ditentukanregion,resource\$1type, dantags. |
| statistics() | Mengembalikan daftar semua statistik standar. |
Untuk detail tentang metrik yang CloudWatch disediakan, lihat [AWS layanan yang mempublikasikan CloudWatch metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html).
### Contoh kueri template
Tabel berikut menunjukkan contoh kueri dimensi yang mengembalikan daftar sumber daya untuk AWS layanan individual.
| Kueri | Layanan |
| --- | --- |
| dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName) | Elastic Load Balancing |
| dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId) | Amazon ElastiCache |
| dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier) | Amazon Redshift |
| dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier) | Amazon RDS |
| dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName) | Amazon Simple Storage Service (Amazon S3) |
| dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1) | CloudWatch Agen |
| resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Elastic Load Balancing |
| resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Amazon EC2 |
# Menggunakan contoh ec2\$1instance\$1attribute
## Filter JSON
`ec2_instance_attribute`Kueri mengambil `filters` dalam format JSON. Anda dapat menentukan filter yang telah ditentukan sebelumnya dari. `ec2:DescribeInstances` Perhatikan bahwa penyaringan sebenarnya terjadi di AWS, bukan di Grafana.
Contoh kode berikut menunjukkan sintaks filter.
```
{ filter_name1: [ filter_value1 ], filter_name2: [ filter_value2 ] }
```
Contoh berikut menunjukkan `ec2_instance_attribute()` query.
```
ec2_instance_attribute(us - east - 1, InstanceId, { 'tag:Environment': ['production'] });
```
## Memilih atribut
Hanya satu atribut per instance yang dapat dikembalikan. Setiap atribut datar dapat dipilih (yaitu, jika atribut memiliki nilai tunggal dan bukan objek atau array). Atribut datar berikut tersedia.
+ `AmiLaunchIndex`
+ `Architecture`
+ `ClientToken`
+ `EbsOptimized`
+ `EnaSupport`
+ `Hypervisor`
+ `IamInstanceProfile`
+ `ImageId`
+ `InstanceId`
+ `InstanceLifecycle`
+ `InstanceType`
+ `KernelId`
+ `KeyName`
+ `LaunchTime`
+ `Platform`
+ `PrivateDnsName`
+ `PrivateIpAddress`
+ `PublicDnsName`
+ `PublicIpAddress`
+ `RamdiskId`
+ `RootDeviceName`
+ `RootDeviceType`
+ `SourceDestCheck`
+ `SpotInstanceRequestId`
+ `SriovNetSupport`
+ `SubnetId`
+ `VirtualizationType`
+ `VpcId`
Tag dapat dipilih dengan awalan nama tag dengan`Tags`.
Contoh berikut menunjukkan `ec2_instance_attribute()` query.
```
ec2_instance_attribute(us - east - 1, Tags.Name, { 'tag:Team': ['sysops'] });
```
# Menggunakan variabel template format JSON
Beberapa kueri menerima filter dalam format JSON dan Grafana mendukung konversi variabel template ke JSON.
Jika`env = 'production', 'staging'`, kueri berikut akan mengembalikan ARN dari instans EC2 yang `Environment` tag tersebut atau. `production` `staging`
```
resource_arns(us-east-1, ec2:instance, {"Environment":${env:json}})
```
# Harga
Sumber CloudWatch data Amazon untuk Grafana menggunakan panggilan `GetMetricData` CloudWatch API `ListMetrics` dan untuk membuat daftar dan mengambil metrik. Harga untuk CloudWatch Log didasarkan pada jumlah data yang dicerna, diarsipkan, dan dianalisis melalui kueri Wawasan CloudWatch Log. Untuk informasi selengkapnya, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing).
Setiap kali Anda memilih dimensi di editor kueri, Grafana mengeluarkan permintaan. `ListMetrics` Setiap kali Anda mengubah kueri di editor kueri, satu permintaan baru GetMetricData akan dikeluarkan.
Permintaan API untuk mengambil sampel data menggunakan `GetMetricData` operasi. Operasi ini memberikan dukungan yang lebih baik untuk matematika CloudWatch metrik. Ini juga mendukung pembuatan ekspresi pencarian otomatis saat menggunakan karakter wildcard atau mematikan opsi **Match Exact**. `GetMetricData`Operasi menimbulkan biaya. Untuk informasi lebih lanjut, lihat [Amazon CloudWatch Harga](https://aws.amazon.com/cloudwatch/pricing).
# Kuota layanan
AWS mendefinisikan kuota, atau batas, untuk sumber daya, operasi, dan item di akun Anda AWS . Bergantung pada jumlah kueri di dasbor Anda dan jumlah pengguna yang mengakses dasbor, Anda mungkin mencapai batas penggunaan untuk berbagai CloudWatch sumber daya CloudWatch Log. Perhatikan bahwa kuota ditentukan per akun dan per AWS Wilayah. Jika Anda menggunakan beberapa Wilayah atau telah menyiapkan lebih dari satu sumber CloudWatch data untuk melakukan kueri terhadap beberapa akun, Anda harus meminta peningkatan kuota untuk setiap akun dan setiap Wilayah tempat Anda mencapai batas.
Untuk informasi selengkapnya, lihat [ CloudWatch service quotas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html).
# Observabilitas lintas akun
**Awas**
Fitur ini mengharuskan ruang kerja Grafana Anda menjadi versi 9 atau yang lebih baru.
CloudWatch Plugin ini memungkinkan Anda untuk memantau dan memecahkan masalah aplikasi di beberapa akun regional. Menggunakan observabilitas lintas akun, Anda dapat dengan mulus mencari, memvisualisasikan, dan menganalisis metrik dan log tanpa mengkhawatirkan batasan akun.
Untuk mengaktifkan observabilitas lintas akun, pertama-tama aktifkan CloudWatch, lalu tambahkan tindakan IAM yang tepat ke plugin yang role/user sedang berjalan. Jika ruang kerja Grafana Terkelola Amazon Anda berjalan dalam VPC, maka Anda juga harus memiliki gateway NAT untuk mendukung akses internet.
+ Untuk mempelajari cara mengaktifkan fitur, lihat [observabilitas CloudWatch lintas akun](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) di * CloudWatchPanduan Pengguna Amazon*.
+ Tindakan berikut adalah tindakan IAM yang tepat untuk ditambahkan untuk role/user yang menjalankan plugin.
```
{
"Sid": "AllowReadingAcrossAccounts",
"Effect": "Allow",
"Action": [
"oam:ListSinks",
"oam:ListAttachedLinks"
],
"Resource": "*"
}
```
+ Pengamatan lintas akun untuk sumber CloudWatch data bergantung pada Amazon CloudWatch Observability Access Manager. Pengelola Akses Observabilitas tidak mendukung titik akhir VPC. Jika ruang kerja Grafana Terkelola Amazon Anda berjalan dalam VPC, maka Anda juga harus memiliki NAT Gateway yang memungkinkan ruang kerja untuk menelepon di internet. APIs
**catatan**
Anda juga harus memiliki izin IAM untuk membaca CloudWatch data di akun yang Anda coba akses.
# 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**.
# Connect ke sumber AWS IoT SiteWise 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 Amazon Managed Grafana, Anda dapat menambahkan AWS IoT SiteWise sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan AWS IoT SiteWise sebagai sumber data dengan menemukan AWS IoT SiteWise akun Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses. AWS IoT SiteWise Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan AWS IoT SiteWise 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.
**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise sebagai sumber data](IoTSiteWise-adding-AWS-config.md)
+ [Menambahkan sumber AWS IoT SiteWise data secara manual](iotsitewise-add-the-data-source.md)
+ [AWS IoT SiteWise pengaturan](#iotsitewise-settings)
+ [Menggunakan sumber AWS IoT SiteWise data](IoTSiteWise-using.md)
# Gunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise 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 AWS IoT SiteWise sumber daya di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan AWS IoT SiteWise sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk ditambahkan AWS IoT SiteWise 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 **AWS IoT SiteWise**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. **Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** IoT AWS . SiteWise**
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 ,** IoT. SiteWise**
1. Pilih Wilayah default tempat Anda ingin sumber AWS IoT SiteWise data kueri, pilih akun, lalu pilih **Tambahkan sumber data**.
# Menambahkan sumber AWS IoT SiteWise data secara manual
**Untuk menambahkan sumber AWS IoT SiteWise data secara manual**
1. **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber SiteWise data **AWS IoT**. Jika perlu, Anda dapat mulai mengetik **SiteWise** di kotak pencarian untuk membantu Anda menemukannya.
## AWS IoT SiteWise pengaturan
| Nama | Deskripsi |
| --- | --- |
| Nama | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri. |
| Penyedia Auth | Tentukan penyedia untuk mendapatkan kredensional. |
| Wilayah Default | Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan). |
| Nama profil kredensial | Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file); tetap kosong untuk default. |
| Asumsikan Peran Arn | Tentukan ARN dari peran yang akan diasumsikan. |
| Titik akhir (opsional) | Jika Anda harus menentukan titik akhir layanan alternatif. |
# Menggunakan sumber AWS IoT SiteWise data
Untuk informasi tentang cara menggunakan sumber AWS IoT SiteWise data, lihat Sumber data di [AWS IoT SiteWise Github.](https://github.com/grafana/iot-sitewise-datasource/blob/main/src/README.md)
# Connect ke sumber AWS IoT TwinMaker 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 Amazon Managed Grafana, Anda dapat menambahkan AWS IoT TwinMaker, layanan analisis data industri yang canggih, sebagai aplikasi dan sumber data di ruang kerja Grafana Anda. Dengan AWS IoT TwinMaker, Anda dapat membuat aplikasi kembar digital 3D pengguna akhir untuk memantau operasi industri. Ini AWS IoT TwinMaker adalah layanan yang membuatnya lebih cepat bagi pengembang untuk membuat replika digital sistem dunia nyata, membantu lebih banyak pelanggan menyadari potensi kembar digital untuk mengoptimalkan operasi. The AWS IoT TwinMaker for Grafana menyediakan panel khusus, templat dasbor, dan sumber data untuk terhubung ke data kembar digital Anda.
# Menambahkan sumber AWS IoT TwinMaker data secara manual
## Prasyarat
Sebelum Anda mulai, pastikan Anda memiliki akses **AWS IoT TwinMaker**dari Anda Akun AWS.
Untuk mempelajari cara menambahkan izin ke peran IAM ruang kerja Anda untuk diakses AWS IoT TwinMaker, lihat. [Menambahkan izin AWS IoT TwinMaker untuk peran pengguna ruang kerja Anda](AMG-iot-twinmaker.md#twinmaker-add-permission)
**Untuk menambahkan sumber AWS IoT TwinMaker data:**
1. Pastikan bahwa peran pengguna Anda adalah admin atau editor.
1. **Di menu sisi konsol Grafana, arahkan kursor ke ikon **Konfigurasi** (roda gigi) lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber **AWS IoT TwinMaker**data. Jika perlu, Anda dapat mulai mengetik **TwinMaker** di kotak pencarian untuk membantu Anda menemukannya.
1. Ini membuka halaman **Detail Koneksi**. Ikuti langkah-langkah dalam mengonfigurasi file. [AWS IoT TwinMaker pengaturan detail koneksi](AMG-iot-twinmaker.md#twinmaker-connection-details)
## Menambahkan izin AWS IoT TwinMaker untuk peran pengguna ruang kerja Anda
**Untuk menambahkan izin AWS IoT TwinMaker ke peran pengguna ruang kerja Anda, gunakan izin peran antara ruang kerja Grafana Terkelola Amazon dan peran dasbor. TwinMaker**
1. Kunjungi [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Buat peran dasbor secara manual. Untuk informasi selengkapnya tentang membuat peran dasbor, lihat[Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual](#iot-twinmaker-dashboard-role).
## AWS IoT TwinMaker pengaturan detail koneksi
**Konfigurasikan pengaturan detail koneksi**
1. Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**).
1. Pilih **Wilayah Default** yang ingin Anda kueri.
1. Dalam **TwinMaker pengaturan**, masukkan nama AWS IoT TwinMaker ruang kerja.
# Menggunakan sumber AWS IoT TwinMaker data
Untuk informasi tentang cara menggunakan sumber AWS IoT TwinMaker data, lihat Sumber [AWS IoT TwinMakerdata di.](https://github.com/grafana/grafana-iot-twinmaker-app) GitHub
## Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual
**Untuk membuat peran dasbor Grafana AWS IoT TwinMaker secara manual**
1. Masuk ke konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Temukan peran ruang kerja Grafana Terkelola Amazon Anda dalam ringkasan. Tampaknya sebagai berikut:
```
AmazonGrafanaServiceRole-random_ID
```
1. Tambahkan kebijakan inline berikut ke peran:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Action": "sts:AssumeRole",
"Resource": "arn:aws:iam::111122223333:role/TwinMakerDashboardRole"
}
}
```
------
1. Tambahkan kebijakan inline baru untuk setiap peran dasbor. Atau, tambahkan daftar peran Amazon Resource Names (ARNs) pada baris **Resource**.
1. Temukan peran dasbor Anda di konsol IAM. Itu harus memiliki `SceneViewer` kebijakan dan, secara opsional, `VideoPlayer` kebijakan.
1. Pilih tab **Hubungan kepercayaan**.
1. Pilih **Edit trust relationship** (Edit Hubungan Kepercayaan).
1. Masukkan kebijakan berikut, ganti *AMGWorkspaceRoleArn* dengan Arn dari akun Anda:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "AMGWorkspaceRoleARN"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
## Contoh AWS IoT TwinMaker kebijakan
Berikut ini adalah AWS IoT TwinMaker kebijakan minimal yang dapat Anda lampirkan ke peran dasbor. Anda harus mengganti nilai untuk ARN dan ID AWS IoT TwinMaker ruang kerja, serta ARN bucket Amazon S3, berdasarkan sumber daya Anda sendiri.
# Connect ke Amazon Managed Service untuk Prometheus dan sumber data Prometheus sumber terbuka
Di Grafana Terkelola Amazon, sumber data Prometheus mendukung penggunaan server Prometheus yang dikelola sendiri dan Layanan Terkelola Amazon untuk ruang kerja Prometheus sebagai sumber data. Untuk informasi selengkapnya tentang Layanan Terkelola Amazon untuk Prometheus, lihat [Apa itu Layanan Terkelola Amazon](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html) untuk Prometheus?
Dengan Grafana Terkelola Amazon, Anda dapat menambahkan Layanan Terkelola Amazon untuk ruang kerja Prometheus sebagai sumber data dengan menggunakan opsi konfigurasi sumber data di konsol ruang kerja Grafana. AWS Fitur ini menyederhanakan penambahan Amazon Managed Service untuk Prometheus sebagai sumber data dengan menemukan Amazon Managed Service yang ada untuk akun Prometheus dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses Amazon Managed Service untuk Prometheus.
**catatan**
Anda dapat melihat peringatan Prometheus Anda di antarmuka peringatan Grafana terpadu, oleh. [Mengkonfigurasi sumber data Alertmanager](data-source-alertmanager.md#data-source-alertmanager-create)
**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus sebagai sumber data](AMP-adding-AWS-config.md)
+ [Menambahkan sumber data Prometheus secara manual](prometheus-manually-adding.md)
+ [Menggunakan sumber data Prometheus](using-prometheus-datasource.md)
+ [Visualisasikan peringatan dari Amazon Managed Service untuk Prometheus](amp-configure-alerts.md)
+ [Konfigurasikan contoh](amp-configure-exemplars.md)
# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus 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 Layanan Terkelola Amazon untuk Prometheus di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Amazon Managed Service for Prometheus sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Amazon Managed Service untuk Prometheus 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 **Amazon Managed Service for Prometheus**, dan **pilih** Tindakan, Aktifkan kebijakan yang dikelola layanan.**
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di** baris **Amazon Managed Service for Prometheus**.
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 dan kemudian pilih AWS layanan, Prometheus.****
1. **Pilih Wilayah yang ingin dicari Grafana Terkelola Amazon untuk menemukan Layanan Terkelola Amazon untuk ruang kerja Prometheus, lalu pilih akun dan Layanan Terkelola Amazon untuk ruang kerja Prometheus yang ingin Anda tambahkan, lalu pilih Tambahkan sumber data.**
# Menambahkan sumber data Prometheus secara manual
**Untuk menambahkan sumber data Prometheus secara manual**
1. **Di menu sisi konsol Grafana, jeda pada item menu **Administrasi** (atau ikon **Konfigurasi** (roda gigi) di Grafana v8), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber data **Prometheus**. Jika perlu, Anda dapat mulai mengetik **Prometheus** di kotak pencarian untuk membantu Anda menemukannya.
# Menggunakan sumber data Prometheus
## Pengaturan Prometheus
| 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 | URL server Prometheus Anda; misalnya,. https://prometheus.example.org:9090 |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data Prometheus. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
| Scrape interval | Setel ini ke interval gesekan dan evaluasi khas yang dikonfigurasi di Prometheus. Default ke 15 detik. |
| Disable metrics lookup | Memeriksa opsi ini akan menonaktifkan pemilih metrik dan metric/label dukungan di pelengkapan otomatis bidang kueri. Ini membantu jika Anda memiliki masalah kinerja dengan instance Prometheus yang lebih besar. |
| Custom Query Parameters | Tambahkan parameter khusus ke URL kueri Prometheus. Misalnyatimeout,partial\$1response,dedup, ataumax\$1source\$1resolution. Beberapa parameter harus digabungkan bersama dengan “&”. |
## Editor kueri Prometheus
Bagian berikut memberikan informasi dan opsi untuk editor kueri Prometheus di dasbor dan di Jelajahi.
### Editor kueri di dasbor
Buka grafik dalam mode edit dengan memilih judul dan kemudian memilih **Edit** (atau dengan menekan tombol **e** sambil berhenti di panel).
| Nama | Deskripsi |
| --- | --- |
| Query expression | [Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.](https://prometheus.io/docs/querying/basics/) |
| Legend format | Mengontrol nama deret waktu, menggunakan nama atau pola. Misalnya \$1\$1hostname\$1\$1 diganti dengan nilai label untuk labelhostname. |
| Min step | Batas bawah tambahan untuk [`step`parameter kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) dan untuk variabel dan. \$1\$1\$1interval \$1\$1\$1rate\$1interval Batasnya mutlak dan tidak dimodifikasi oleh pengaturan Resolusi. |
| Resolution | 1/1menetapkan \$1\$1\$1interval variabel dan [`step`parameter kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) sedemikian rupa sehingga setiap piksel sesuai dengan satu titik data. Untuk kinerja yang lebih baik, gunakan resolusi yang lebih rendah. 1/2hanya mengambil titik data untuk setiap piksel lainnya, dan 1/10 mengambil satu titik data per 10 piksel. Perhatikan bahwa interval waktu Min dan langkah Min membatasi nilai akhir \$1\$1\$1interval danstep. |
| Metric lookup | Cari nama metrik di kolom input ini. |
| Format as | Beralih antaraTable,Time series, atauHeatmap. Tablehanya berfungsi di panel tabel. Heatmapcocok untuk menampilkan metrik tipe histogram pada panel peta panas. Ini mengubah histogram kumulatif menjadi histogram biasa dan mengurutkan seri dengan terikat ember. |
| Instant | Lakukan kueri “instan”, untuk mengembalikan hanya nilai terbaru yang telah dikikis Prometheus untuk deret waktu yang diminta. Kueri instan mengembalikan hasil jauh lebih cepat daripada kueri rentang normal. Gunakan mereka untuk mencari set label. |
| Min time interval | [Nilai ini dikalikan dengan penyebut dari pengaturan *Resolusi* menetapkan batas bawah untuk `$__interval` variabel dan parameter `step` kueri rentang Prometheus.](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries) Default untuk Scrape interval seperti yang diatur dalam opsi sumber data. |
**catatan**
Grafana Terkelola Amazon memodifikasi tanggal permintaan kueri untuk menyelaraskannya dengan langkah yang dihitung secara dinamis. Ini memastikan tampilan data metrik yang konsisten, tetapi dapat menghasilkan celah kecil data di tepi kanan grafik.
#### Kueri instan di dasbor
Sumber data Prometheus memungkinkan Anda menjalankan kueri instan, yang hanya menanyakan nilai terbaru. Anda dapat memvisualisasikan hasil dalam panel tabel untuk melihat semua label yang tersedia dari deret waktu.
Hasil kueri instan hanya terdiri dari satu titik data per seri. Mereka dapat ditampilkan di panel grafik dengan bantuan penggantian seri. Untuk menunjukkannya dalam grafik sebagai titik nilai terbaru, tambahkan penggantian seri dan pilih`Points > true`. Untuk menampilkan garis horizontal di seluruh grafik, tambahkan penggantian seri dan pilih `Transform > constant` Untuk informasi selengkapnya tentang penggantian seri, lihat. [Penggantian seri](graph-panel.md#graph-panel-series-overrides)
### Editor kueri di Jelajahi
| Nama | Deskripsi |
| --- | --- |
| Query expression | [Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.](https://prometheus.io/docs/querying/basics/) |
| Step | [`Step`parameter dari kueri rentang Prometheus](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries). Satuan waktu dapat digunakan di sini, misalnya: 5s, 1m, 3h, 1d, 1y. Unit default jika tidak ada unit yang ditentukan adalah s (detik). |
| Query type | Range, Instant, atau Both. Saat menjalankan kueri Rentang, hasil kueri ditampilkan dalam grafik dan tabel. Kueri instan hanya mengembalikan nilai terbaru yang Prometheus telah tergores untuk deret waktu yang diminta dan ditampilkan dalam tabel. Ketika Keduanya dipilih, kueri instan dan kueri rentang dijalankan. Hasil kueri rentang ditampilkan dalam grafik dan hasil kueri instan ditampilkan dalam tabel. |
## Browser metrik
Browser metrik memungkinkan Anda menemukan metrik dengan cepat dan memilih label yang relevan untuk membuat kueri dasar. Saat Anda membuka browser, Anda akan melihat semua metrik dan label yang tersedia. Jika didukung oleh instance Prometheus Anda, setiap metrik akan menampilkan HELP dan TYPE sebagai tooltip.
Saat Anda memilih metrik, browser mempersempit label yang tersedia untuk hanya menampilkan label yang berlaku untuk metrik. Anda kemudian dapat memilih satu atau beberapa label yang nilai label yang tersedia ditampilkan dalam daftar di bagian bawah. Pilih satu atau beberapa nilai untuk setiap label untuk memperketat cakupan kueri Anda.
**catatan**
Jika Anda tidak ingat nama metrik untuk memulai, Anda juga dapat memilih beberapa label terlebih dahulu, untuk mempersempit daftar dan kemudian menemukan nilai label yang relevan.
Semua daftar di browser metrik memiliki bidang pencarian di atasnya untuk dengan cepat memfilter metrik atau label yang cocok dengan string tertentu. Bagian nilai hanya memiliki satu bidang pencarian. Pemfilterannya berlaku untuk semua label untuk membantu Anda menemukan nilai di seluruh label setelah dipilih, misalnya, di antara aplikasi label Anda, job, job\$1name hanya satu yang mungkin dengan nilai yang Anda cari.
Setelah Anda puas dengan kueri Anda, klik “Gunakan kueri” untuk menjalankan kueri. Tombol **Use as rate query** menambahkan rate (...) [\$1\$1\$1interval] di sekitar kueri Anda untuk membantu menulis kueri untuk metrik penghitung. Tombol “Validasi pemilih” akan memeriksa dengan Prometheus berapa banyak deret waktu yang tersedia untuk pemilih itu.
### Batasan
Browser metrik memiliki batas keras 10.000 label (kunci) dan 50.000 nilai label (termasuk nama metrik). Jika instance Prometheus Anda mengembalikan lebih banyak hasil, browser akan terus berfungsi. Namun, set hasil akan terpotong di atas batas maksimum tersebut.
## Templating
Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. 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
Variabel tipe *Query* memungkinkan Anda untuk query Prometheus untuk daftar metrik, label, atau nilai label. **Plugin sumber data Prometheus menyediakan fungsi-fungsi berikut yang dapat Anda gunakan di bidang input Query.**
| Nama | Deskripsi |
| --- | --- |
| label\$1names() | Mengembalikan daftar nama label. |
| label\$1values(label) | Mengembalikan daftar nilai label untuk label dalam setiap metrik. |
| label\$1values(metric, label) | Mengembalikan daftar nilai label untuk label dalam metrik tertentu. |
| metrics(metric) | Mengembalikan daftar metrik yang cocok dengan metric regex tertentu. |
| query\$1result(query) | Mengembalikan daftar Prometheus hasil query untuk. query |
Untuk informasi tentang *nama metrik, nama* *label*, dan *nilai label*, lihat dokumentasi [Prometheus](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels).
#### Menggunakan variabel interval dan rentang
**catatan**
Support untuk`$__range`,`$__range_s`, dan hanya `$__range_ms` tersedia dari Grafana v5.3.
Anda dapat menggunakan beberapa variabel global dalam variabel kueri:`$__interval`,`$__interval_ms`,`$__range`,`$__range_s`, dan`$__range_ms`. Untuk informasi selengkapnya, lihat [Variabel global](variables-types.md#global-variables). Ini dapat nyaman digunakan dengan `query_result` fungsi ketika Anda harus memfilter kueri variabel karena `label_values` fungsi tidak mendukung kueri.
Untuk mendapatkan instance yang benar saat mengubah rentang waktu di dasbor, pastikan untuk mengatur `refresh` pemicu variabel menjadi`On Time Range Change`.
Contoh kode berikut menunjukkan cara mengisi variabel dengan lima instance permintaan tersibuk berdasarkan QPS rata-rata selama rentang waktu yang ditunjukkan di dasbor.
```
Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/
```
Contoh kode berikut menunjukkan cara mengisi variabel dengan instance yang memiliki status tertentu selama rentang waktu yang ditunjukkan di dasbor, menggunakan. `$__range_s`
```
Query: query_result(max_over_time([${__range_s}s]) != )
Regex:
```
### Menggunakan `$__rate_interval` variabel
`$__rate_interval`Variabel dimaksudkan untuk digunakan dalam fungsi laju. Ini didefinisikan sebagai maks (`$__interval`\$1 *Interval scrape*, 4 \$1 *Scrape interval*). *Interval scrape* adalah pengaturan langkah Min (AKA query\$1interval, pengaturan per kueri promQL), jika ada yang disetel, dan sebaliknya *interval Scrape* seperti yang diatur dalam sumber data Prometheus (tetapi mengabaikan pengaturan interval Min apa pun di panel, karena yang terakhir dimodifikasi oleh pengaturan resolusi).
### Menggunakan variabel dalam kueri
Ada dua sintaks:
+ `$`Contoh: tingkat (http\$1requests\$1total \$1job=\$1"\$1job "\$1 [5m])
+ `[[varname]]`Contoh: rate (http\$1requests\$1total \$1job=\$1 "[[job]]"\$1 [5m])
Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Saat opsi *Multi-nilai* atau *Sertakan semua nilai* diaktifkan, Grafana mengonversi label dari teks biasa menjadi string yang kompatibel dengan regex. Yang berarti Anda harus menggunakan `=~` alih-alih`=`.
## Anotasi
Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi menggunakan menu Dasbor atau tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).
Prometheus mendukung dua cara untuk menanyakan anotasi.
+ Kueri metrik biasa
+ Permintaan Prometheus untuk peringatan tertunda dan penembakan. Untuk informasi selengkapnya, lihat [Memeriksa peringatan selama runtime](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/#inspecting-alerts-during-runtime)).
Opsi langkah berguna untuk membatasi jumlah peristiwa yang dikembalikan dari kueri Anda.
# Visualisasikan peringatan dari Amazon Managed Service untuk Prometheus
Anda dapat memvisualisasikan peringatan Amazon Managed Service untuk Prometheus atau Prometheus di Amazon Managed Grafana dengan mengonfigurasi sumber data Alertmanager untuk sumber data Prometheus yang sudah terhubung dengan Anda.
**Prasyarat**
Untuk mengonfigurasi Alertmanager untuk digunakan dengan Amazon Managed Service for Prometheus, Anda harus menyelesaikan prasyarat berikut:
+ [Layanan Terkelola Amazon untuk instans Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-onboard-create-workspace.html), dengan metrik tertelan, dan setidaknya satu peringatan atau aturan perekaman yang dikonfigurasi. **Anda akan memerlukan URL untuk ruang kerja Anda (dari detail ruang kerja Anda di Amazon Managed Service untuk Prometheus Anda dapat melihat URL Endpoint.** Ruang kerja URl adalah URL Endpoint tanpa `api/v1/remote_write` di akhir).
+ [Ruang kerja Grafana Terkelola Amazon yang [dibuat](AMG-create-workspace.md) dengan instance Prometheus yang dikonfigurasi sebagai sumber data.](prometheus-data-source.md)
+ Grafana yang Dikelola Amazon harus memiliki izin berikut untuk sumber daya Prometheus Anda. Anda harus menambahkannya ke kebijakan yang dikelola layanan atau yang dikelola pelanggan yang dijelaskan dalam. [Izin dan kebijakan Grafana yang Dikelola Amazon untuk sumber data AWS](AMG-manage-permissions.md)
+ `aps:ListRules`
+ `aps:ListAlertManagerSilences`
+ `aps:ListAlertManagerAlerts`
+ `aps:GetAlertManagerStatus`
+ `aps:ListAlertManagerAlertGroups`
+ `aps:PutAlertManagerSilences`
+ `aps:DeleteAlertManagerSilence`
**Untuk mengonfigurasi sumber data Alertmanager untuk digunakan dengan Amazon Managed Service for Prometheus**
1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**
1. Pilih **Tambahkan sumber data**, dan pilih **Alertmanager** dari daftar tipe sumber data.
1. Berikan informasi berikut untuk sumber data baru Anda.
+ Untuk **Implementasi**, pilih **Prometheus**.
+ Di bawah **HTTP**, untuk **URL**, berikan URL ruang kerja Prometheus, dengan ditambahkan. `alertmanager` Misalnya, `https://aps-workspaces.us-east1.amazonaws.com/workspaces/ws-example-1234-5678-abcd-xyz00000001/alertmanager`.
+ Di bawah **Auth**, nyalakan **Sigv4auth**. Ini memberitahu Grafana untuk menggunakan [AWS otentikasi untuk permintaan](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html).
+ Di bawah **Detail Sigv4Auth**, untuk **Wilayah Default, berikan wilayah** instance Prometheus Anda, misalnya. `us-east-1`
1. Pilih **Simpan & uji** untuk menyelesaikan penyiapan sumber data Anda.
Jika sumber data Anda diatur dengan benar, Anda akan melihat pesan yang mengatakan **Pemeriksaan Kesehatan berlalu**.
**Untuk menghubungkan sumber data Alertmanager baru Anda ke sumber data Prometheus**
1. **Dari konsol Grafana Anda, di menu Grafana, pilih halaman **Sumber data di bawah Konfigurasi**.**
1. Pilih Layanan Terkelola Amazon asli Anda untuk sumber data Prometheus dan aktifkan sakelar sakelar **Kelola peringatan melalui UI Peringatan**.
1. Pilih **Simpan & uji** untuk menyelesaikan konfigurasi sumber data Anda.
# Konfigurasikan contoh
**catatan**
Fitur ini membutuhkan Prometheus versi 2.26 atau yang lebih baru.
Contoh tidak didukung di Amazon Managed Service untuk Prometheus.
Anda dapat menampilkan data contoh bersama metrik baik di Explore maupun Dashboards. Contoh mengaitkan metadata kardinalitas yang lebih tinggi dari peristiwa tertentu dengan data deret waktu tradisional.
Anda dapat mengonfigurasi contoh dalam pengaturan sumber data dengan menambahkan tautan ke contoh Anda. Anda dapat menggunakan makro di URL Anda. Misalnya, Anda dapat membuat URL seperti`https://example.com/${__value.raw}`.
# Connect ke sumber data Amazon Timestream
**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 Amazon Timestream sebagai sumber data dengan menggunakan opsi konfigurasi sumber data AWS di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Timestream sebagai sumber data dengan menemukan akun Timestream Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses Timestream. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Timestream sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama dengan yang Anda lakukan pada server Grafana yang dikelola sendiri.
# Gunakan konfigurasi sumber AWS data untuk menambahkan Timestream 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 Timestream di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Timestream sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Timestream 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 **Amazon Timestream**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di** baris **Amazon Timestream**.
1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu.
1. Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih **Aplikasi** lalu **Sumber AWS Data** (di Grafana v8, pilih AWS ikon dari menu kiri).
1. Pilih tab **AWS layanan**, lalu **Timestream**.
1. Pilih wilayah default yang Anda inginkan sumber data **Timestream** untuk kueri, pilih akun, lalu pilih **Tambahkan sumber data**.
# Menambahkan sumber data Timestream secara manual
**Untuk menambahkan sumber data Timestream secara manual**
1. **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber data **Amazon Timestream**. Jika perlu, Anda dapat mulai mengetik **Timestream** di kotak pencarian untuk membantu Anda menemukannya.
## Pengaturan Timestream
| Nama | Deskripsi |
| --- | --- |
| Nama | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri. |
| Penyedia Auth | Tentukan penyedia untuk mendapatkan kredensional. |
| Wilayah Default | Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan). |
| Nama profil kredensial | Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file), tetap kosong untuk default. |
| Asumsikan Peran Arn | Tentukan ARN dari peran yang akan diasumsikan. |
| Titik akhir (opsional) | Jika Anda harus menentukan titik akhir layanan alternatif. |
### Autentikasi
Bagian ini mencakup berbagai jenis otentikasi yang dapat Anda gunakan untuk sumber data Amazon Timestream.
#### Contoh AWS kredensial
Anda tidak dapat menggunakan metode autentikasi file kredensial di Grafana Terkelola Amazon.
# Menggunakan sumber data Timestream
## Editor kueri
Editor kueri menerima sintaks Timestream selain makro yang terdaftar sebelumnya dan variabel template dasbor apa pun.
Tekan **Ctrl\$1Space untuk membuka saran**. IntelliSense
## Makro
Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro.
| Contoh makro | Deskripsi |
| --- | --- |
| *\$1 \$1\$1basis data* | Akan menentukan database yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri. |
| *\$1 \$1\$1tabel* | Akan menentukan database yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri. |
| *\$1 \$1\$1ukur* | Akan menentukan ukuran yang dipilih. Ini menggunakan default dari konfigurasi sumber data, atau nilai eksplisit dari editor kueri. |
| *\$1 \$1\$1TimeFilter* | Akan diganti dengan ekspresi yang membatasi waktu ke rentang dasbor |
| *\$1 \$1\$1interval\$1ms* | Akan diganti dengan angka yang mewakili jumlah waktu yang harus dicakup oleh satu piksel dalam grafik. |
# Connect ke sumber data Amazon Athena
**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).
**catatan**
Panduan ini mengasumsikan bahwa Anda sudah terbiasa dengan layanan Amazon Athena sebelum Anda menggunakan sumber data Athena.
Dengan Amazon Managed Grafana, Anda dapat menambahkan Athena sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Athena sebagai sumber data dengan menemukan akun Athena Anda yang ada dan mengelola konfigurasi kredensi otentikasi yang diperlukan untuk mengakses Athena. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Athena sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama dengan yang Anda lakukan pada server Grafana yang dikelola sendiri.
Ada prasyarat agar Athena dapat diakses oleh Grafana yang Dikelola Amazon. Untuk prasyarat yang terkait dengan penggunaan sumber data Athena, lihat. [Prasyarat](Athena-prereq.md)
# Prasyarat
Untuk menggunakan kebijakan terkelola untuk Grafana Terkelola Amazon untuk Athena, selesaikan tugas berikut sebelum Anda mengonfigurasi sumber data Athena:
+ Tandai kelompok kerja Athena Anda dengan. `GrafanaDataSource: true`
+ Buat bucket S3 dengan nama yang dimulai dengan`grafana-athena-query-results-`. Kebijakan ini memberikan izin untuk menulis hasil kueri ke dalam bucket S3 dengan konvensi penamaan tersebut.
Izin Amazon S3 untuk mengakses sumber data dasar kueri Athena tidak disertakan dalam kebijakan terkelola ini. Anda harus menambahkan izin yang diperlukan untuk bucket Amazon S3 secara manual, secara manual. case-by-case Untuk informasi selengkapnya, lihat [contoh kebijakan berbasis identitas di Grafana Terkelola Amazon dalam](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) panduan ini.
# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Athena sebagai sumber data
## Prasyarat
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) diinstal dan dikonfigurasi di lingkungan Anda.
+ Anda memiliki akses ke Athena dari akun Anda.
Untuk menggunakan konfigurasi sumber AWS data, pertama-tama buka konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM yang dikelola layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya Athena di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan Athena sebagai sumber data.
# Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Athena sebagai sumber data
1. Pastikan bahwa peran pengguna Anda adalah admin atau editor.
1. Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
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 **Amazon Athena**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** **Amazon Athena**.
1. Masuk ke konsol ruang kerja Grafana menggunakan IAM Identity Center jika perlu. Pengguna harus memiliki kebijakan akses Athena yang dilampirkan pada pengguna/peran untuk memiliki akses ke sumber data Athena. Lihat [AWS kebijakan terkelola: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) untuk info lebih lanjut.
1. **Di bilah navigasi kiri di konsol ruang kerja Grafana, pilih AWS ikon bawah (ada dua) dan kemudian pilih **Athena** dari menu Sumber data.**
1. Pilih Wilayah default yang Anda inginkan dari sumber data Athena untuk kueri, lalu pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.
1. Ikuti langkah-langkah untuk mengonfigurasi **Detail Athena** di [**Pengaturan Detail Athena**](#Athena-settings)
## **Pengaturan Detail Athena**
**Konfigurasikan **pengaturan Detail Athena****
1. Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**).
1. Pilih sumber data Athena yang ditargetkan tempat Anda memiliki akun Athena. Jika Anda tidak memilih sumber data apa pun, ada sumber data default di drop-down.
Untuk membuat akun Athena baru, ikuti petunjuk di [Memulai](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html) dengan Athena
1. Pilih database Athena yang ditargetkan di sumber data yang dipilih di atas.
1. Pilih Workgroup. **Primer** secara default.
1. Jika workgroup Anda belum memiliki lokasi keluaran yang dikonfigurasi, tentukan bucket dan folder S3 yang akan digunakan untuk hasil kueri. Sebagai contoh, `s3://grafana-athena-plugin-test-data/query-result-output/ `.
1. Pilih **Simpan & Uji**.
# Menambahkan sumber data Athena secara manual
## Prasyarat
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) diinstal dan dikonfigurasi di lingkungan Anda.
+ Anda memiliki akses ke **Amazon Athena dari akun** Anda.
**Untuk menambahkan sumber data Athena secara manual:**
1. **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber data **AWS Athena**. Jika perlu, Anda dapat mulai mengetik **Athena** di kotak pencarian untuk membantu Anda menemukannya.
1. Di menu **Detail Koneksi**, konfigurasikan penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**)
1. Pilih sumber data, database, dan grup kerja Athena yang ditargetkan.
Untuk membuat akun Athena baru, ikuti petunjuk di [Memulai dengan Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html).
1. Jika workgroup Anda belum memiliki lokasi keluaran yang dikonfigurasi, tentukan bucket dan folder S3 yang akan digunakan untuk hasil kueri. Misalnya, `s3://grafana-athena-plugin-test-data/query-result-output/ `.
1. Pilih **Simpan & Uji**.
Berikut ini adalah contoh pengaturan **Detail Athena**.
![\[Athena Detail contoh\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/athena.png)
# Menggunakan sumber data Athena
## Kebijakan IAM
Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca metrik Athena. Anda dapat melampirkan izin ini ke peran IAM dan memanfaatkan dukungan bawaan Grafana untuk mengambil peran. Perhatikan bahwa Anda perlu [Mengonfigurasi kebijakan yang diperlukan](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) untuk peran Anda sebelum menambahkan sumber data ke Grafana. Anda akan memerlukan peran admin atau editor untuk menambahkan sumber data. Kebijakan akses Amazon Grafana Athena bawaan ditentukan di bagian ini. [AWS kebijakan terkelola: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess)
## Permintaan data Athena
Sumber data Athena menyediakan editor kueri SQL standar. Grafana yang Dikelola Amazon menyertakan beberapa makro untuk membantu menulis kueri timeseries yang lebih kompleks.
Makro
| Makro | Deskripsi | Contoh | Contoh Keluaran |
| --- | --- | --- | --- |
| \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltermembuat filter bersyarat yang memilih data (menggunakancolumn) berdasarkan rentang tanggal panel. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' |
| \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimemelemparkan varchar sebagai stempel waktu dengan format yang diberikan. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') |
| \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFiltermembuat kondisional yang menyaring data (menggunakancolumn) berdasarkan rentang waktu panel. Argumen kedua digunakan untuk mengurai kolom secara opsional dari varchar ke stempel waktu dengan format tertentu. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeFrom() | \$1\$1\$1timeFromoutput waktu mulai saat ini dari kisaran panel dengan tanda kutip. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeTo() | \$1\$1\$1timeTo menghasilkan waktu akhir saat ini dari kisaran panel dengan tanda kutip. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' |
| \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup mengelompokkan stempel waktu sehingga hanya ada 1 poin untuk setiap periode pada grafik. Argumen ketiga digunakan untuk mengurai kolom secara opsional dari varchar ke stempel waktu dengan format tertentu. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) |
| \$1\$1\$1table | \$1\$1\$1tablemengembalikan tabel yang dipilih dalam pemilih Tabel. | \$1\$1\$1table | my\$1table |
| \$1\$1\$1column | \$1\$1\$1columnmengembalikan kolom yang dipilih dalam pemilih Kolom (membutuhkan tabel). | \$1\$1\$1column | col1 |
**Visualisasi**
Sebagian besar pertanyaan di Athena paling baik diwakili oleh visualisasi tabel. Sebuah query menampilkan kembali data dalam tabel. Jika dapat ditanyakan, maka dapat ditampilkan sebagai tabel.
Contoh ini mengembalikan hasil untuk visualisasi tabel:
```
SELECT {column_1}, {column_2} FROM {table};
```
**Timeseries/ Visualisasi grafik**
Untuk rangkaian waktu dan visualisasi grafik, Anda harus:
+ pilih kolom dengan `date` atau `datetime` tipe. `date`Kolom harus dalam urutan menaik (menggunakan`ORDER BY column ASC`).
+ juga pilih kolom numerik.
**Memeriksa kueri**
Grafana yang Dikelola Amazon mendukung makro yang tidak dimiliki Athena, yang berarti kueri mungkin tidak berfungsi saat disalin dan ditempelkan langsung ke Athena. **Untuk melihat kueri interpolasi lengkap, yang bekerja langsung di Athena, klik tombol Query Inspector.** Kueri lengkap ditampilkan di bawah tab **Query**.
## Template dan variabel
Untuk informasi selengkapnya tentang menambahkan variabel kueri Athena, lihat. [Menambahkan variabel kueri](variables-types.md#add-a-query-variable) Gunakan sumber data Athena Anda sebagai sumber data Anda untuk kueri yang tersedia.
Setiap nilai yang ditanyakan dari tabel Athena dapat digunakan sebagai variabel. Hindari memilih terlalu banyak nilai, karena ini dapat menyebabkan masalah kinerja.
Setelah membuat variabel, Anda dapat menggunakannya dalam kueri Athena Anda dengan menggunakan. [Sintaks variabel](templates-and-variables.md#variable-syntax) Untuk informasi lebih lanjut tentang variabel, lihat[Template dan variabel](templates-and-variables.md).
## Anotasi
[Anotasi](dashboard-annotations.md)memungkinkan Anda untuk melapisi informasi acara yang kaya di atas grafik. **Anda dapat menambahkan anotasi dengan memilih panel atau dengan menambahkan kueri anotasi menggunakan tampilan Anotasi menu **Dasbor**.**
Contoh kueri untuk menambahkan anotasi secara otomatis:
```
SELECT
time as time,
environment as tags,
humidity as text
FROM
tableName
WHERE
$__dateFilter(time) and humidity > 95
```
Tabel berikut mewakili deskripsi kolom yang dapat digunakan untuk membuat anotasi:
| Nama | Deskripsi |
| --- | --- |
| Time | Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| Timeend | Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. (Grafana v6.6\$1) |
| Text | Bidang deskripsi acara. |
| Tags | Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma. |
## Dukungan data kueri async
Kueri Athena di Grafana Terkelola Amazon ditangani secara asinkron untuk menghindari batas waktu. Kueri asinkron menggunakan permintaan terpisah untuk memulai kueri, lalu memeriksa kemajuannya, dan akhirnya untuk mengambil hasilnya. Ini menghindari batas waktu untuk kueri yang berjalan untuk waktu yang lama.
## Penggunaan kembali hasil kueri
Anda dapat menggunakan kembali hasil kueri sebelumnya untuk meningkatkan kinerja kueri. Untuk mengaktifkan penggunaan kembali kueri, aktifkan ada di bagian **Penggunaan kembali hasil kueri** pada editor kueri. Ini harus dilakukan untuk setiap kueri yang ingin Anda gunakan kembali kueri.
**catatan**
Fitur ini mengharuskan instans Athena Anda berada di engine versi 3. Untuk informasi selengkapnya, lihat [Mengubah versi mesin Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) di Panduan Pengguna *Amazon Athena*.
# Connect ke sumber data Amazon Redshift
**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).
**catatan**
Panduan ini mengasumsikan bahwa pengguna sudah terbiasa dengan layanan Amazon Redshift sebelum menggunakan sumber data Amazon Redshift.
Dengan Amazon Managed Grafana, Anda dapat menambahkan Amazon Redshift sebagai sumber data dengan menggunakan opsi konfigurasi sumber data AWS di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan Amazon Redshift sebagai sumber data dengan menemukan akun Amazon Redshift Anda yang ada dan mengelola konfigurasi kredensional otentikasi yang diperlukan untuk mengakses Amazon Redshift. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan Amazon Redshift sebagai sumber data, atau Anda dapat secara manual mengatur sumber data dan kredensi otentikasi yang diperlukan menggunakan metode yang sama seperti yang Anda lakukan di server Grafana yang dikelola sendiri.
Ada prasyarat agar Amazon Redshift dapat diakses oleh Amazon Managed Grafana. Untuk prasyarat yang terkait dengan penggunaan sumber data Amazon Redshift, lihat. [Prasyarat](Redshift-prereq.md)
# Prasyarat
Untuk menggunakan kebijakan AWS terkelola untuk Grafana Terkelola Amazon, selesaikan tugas berikut sebelum mengonfigurasi sumber data Amazon Redshift:
+ Tandai cluster Amazon Redshift Anda dengan. `GrafanaDataSource: true` Jika tidak, itu tidak akan dapat diakses.
+ Buat kredensi database dengan salah satu cara yang saling eksklusif berikut ini:
+ Jika Anda ingin menggunakan mekanisme default (opsi kredensial sementara) untuk mengautentikasi terhadap database Redshift, Anda harus membuat nama pengguna database. `redshift_data_api_user`
+ Jika Anda ingin menggunakan kredensi dari Secrets Manager, Anda harus menandai rahasia dengan. `RedshiftQueryOwner: true` Untuk informasi selengkapnya, lihat [contoh kebijakan berbasis identitas di Grafana Terkelola Amazon dalam](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) panduan ini.
# Gunakan konfigurasi sumber AWS data untuk menambahkan Amazon Redshift sebagai sumber data
# Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan Amazon Redshift sebagai sumber data
1. Pastikan bahwa peran pengguna Anda adalah admin atau editor.
1. Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
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 **Amazon Redshift**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana di baris** **Amazon Redshift**.
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 bawah (ada dua) dan kemudian pilih Redshift.**
1. Pilih wilayah default yang Anda inginkan dari sumber data Amazon Redshift untuk kueri, lalu pilih akun yang Anda inginkan, lalu pilih **Tambahkan sumber data**.
1. Ikuti langkah-langkah untuk mengonfigurasi **Detail Koneksi** di[Pengaturan **detail koneksi**](Redshift-config.md#Redshift-connection-details).
# Menambahkan sumber data Amazon Redshift secara manual
## Prasyarat
+ Anda memiliki akses ke **Amazon Redshift dari akun** Anda.
**Untuk menambahkan sumber data Amazon Redshift:**
1. Lampirkan [AmazonRedshiftAccessPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)ke peran pengguna ruang kerja Anda.
1. Pastikan peran pengguna Anda adalah admin atau editor.
1. Pilih ruang kerja yang ingin Anda kerjakan dari konsol Grafana Terkelola Amazon di. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)
1. **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber data **AWS Redshift**. Jika perlu, Anda dapat mulai mengetik **Redshift** di kotak pencarian untuk membantu Anda menemukannya.
1. Ini membuka halaman **Detail Koneksi**. Ikuti langkah-langkah dalam mengonfigurasi file. [Pengaturan **detail koneksi**](Redshift-config.md#Redshift-connection-details)
# Mengonfigurasi Amazon Redshift
Setelah menambahkan sumber data Amazon Redshift ke ruang kerja, konfigurasikan setelan Amazon Redshift sebagai berikut:
## Prasyarat
+ Anda memiliki akses ke **Amazon Redshift dari akun** Anda.
## Pengaturan **detail koneksi**
**Konfigurasikan pengaturan detail Koneksi**
1. Di menu **Detail Koneksi**, pilih penyedia otentikasi (disarankan: Peran **IAM Ruang Kerja**).
1. Pilih **Wilayah Default** yang ingin Anda kueri.
## **Pengaturan otentikasi**
**Konfigurasikan **pengaturan Otentikasi****
1. Di menu **Authentication**, pilih tab **Temporary Credentials atau **AWS Secrets Manager** sebagai penyedia kredensial** akses Anda. Untuk detail tentang Temporary Credentials and AWS Secrets Manager, lihat [AWS kebijakan terkelola: AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)
1. Jika Anda memilih **Kredensi sementara** yang secara default, ikuti langkah-langkah di bawah ini. Jika Anda memilih **AWS Secrets Manager**, masukkan kredenal **AWS Secrets Manager** Anda di kolom input.
1. Pilih **Cluster Identifier** dari cluster yang Anda buat di Amazon Redshift.
[Untuk informasi lebih lanjut tentang cluster Redshift, lihat Koneksi Redshift.](https://docs.aws.amazon.com/redshift/latest/gsg/connection.html)
1. Pilih database Redshift yang ditargetkan.
1. Pilih pengguna database yang Anda buat untuk cluster di atas.
1. Pilih **Simpan & Uji**.
Berikut ini adalah contoh pengaturan **Kredensial Sementara**.
![\[Contoh Kredensial Sementara\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/redshift.png)
Berikut ini adalah contoh dari menu **AWS Secrets Manager**.
![\[Contoh Secrets Manager\]](http://docs.aws.amazon.com/id_id/grafana/latest/userguide/images/secretsmanager.png)
# Menggunakan sumber data Amazon Redshift
## Kebijakan IAM
Grafana membutuhkan izin yang diberikan menggunakan IAM untuk dapat membaca metrik Redshift. Anda dapat melampirkan izin ini ke peran IAM dan memanfaatkan dukungan bawaan Grafana untuk mengambil peran. Kebijakan akses Amazon Grafana Redshift bawaan ditentukan di bagian ini. [AWS kebijakan terkelola: AmazonGrafanaRedshiftAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaRedshiftAccess)
## Kueri data Amazon Redshift
Sumber data Amazon Redshift menyediakan editor kueri SQL standar. Grafana yang Dikelola Amazon menyertakan beberapa makro untuk membantu menulis kueri timeseries yang lebih kompleks.
Makro
| Makro | Deskripsi | Contoh keluaran |
| --- | --- | --- |
| \$1\$1\$1timeEpoch(column) | \$1\$1\$1timeEpochakan diganti dengan ekspresi untuk mengonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi waktu | UNIX\$1TIMESTAMP(dateColumn) as "time" |
| \$1\$1\$1timeFilter(column) | \$1\$1\$1timeFiltermembuat kondisional yang menyaring data (menggunakancolumn) berdasarkan rentang waktu panel | time BETWEEN '2017-07-18T11:15:52Z' AND '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeFrom() | \$1\$1\$1timeFromoutput waktu mulai saat ini dari kisaran panel dengan tanda kutip | '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeTo() | \$1\$1\$1timeTooutput waktu akhir saat ini dari kisaran panel dengan tanda kutip | '2017-07-18T11:15:52Z' |
| \$1\$1\$1timeGroup(column, '1m') | \$1\$1\$1timeGroupmengelompokkan stempel waktu sehingga hanya ada 1 poin untuk setiap periode pada grafik | floor(extract(epoch from time)/60)\$160 AS "time" |
| \$1\$1\$1schema | \$1\$1\$1schema menggunakan skema yang dipilih | public |
| \$1\$1\$1table | \$1\$1\$1tableoutput tabel dari yang diberikan \$1\$1\$1schema (menggunakan skema publik secara default) | sales |
| \$1\$1\$1column | \$1\$1\$1columnoutput kolom dari saat ini \$1\$1\$1table | date |
| \$1\$1\$1unixEpochFilter(column) | \$1\$1\$1unixEpochFilterdiganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix | column >= 1624406400 AND column <= 1624410000 |
| \$1\$1\$1unixEpochGroup(column) | \$1\$1\$1unixEpochGroupsama dengan \$1\$1\$1timeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix | floor(time/60)\$160 AS "time" |
**Visualisasi**
Sebagian besar kueri di Redshift paling baik diwakili oleh visualisasi tabel. Setiap kueri akan menampilkan data dalam tabel. Jika bisa ditanyakan, maka bisa dimasukkan ke dalam tabel.
Contoh ini mengembalikan hasil untuk visualisasi tabel:
```
SELECT {column_1}, {column_2} FROM {table};
```
**Deret waktu dan visualisasi grafik**
Untuk deret waktu dan visualisasi grafik, ada beberapa persyaratan:
+ Kolom dengan `date` atau `datetime` tipe harus dipilih.
+ `date`Kolom harus dalam urutan menaik (menggunakan`ORDER BY column ASC`).
+ Anda harus memilih kolom numerik.
Untuk membuat grafik yang lebih masuk akal, pastikan untuk menggunakan `$__timeFilter` dan `$__timeGroup` makro.
**Contoh kueri timeseries:**
```
SELECT
avg(execution_time) AS average_execution_time,
$__timeGroup(start_time, 'hour'),
query_type
FROM
account_usage.query_history
WHERE
$__timeFilter(start_time)
group by
query_type,start_time
order by
start_time,query_type ASC;
```
**Modus isi**
Grafana juga melengkapi bingkai secara otomatis tanpa nilai dengan beberapa default. Untuk mengonfigurasi nilai ini, ubah **Nilai Isi** di editor kueri.
**Memeriksa kueri**
Karena Grafana mendukung makro yang Redshift tidak, kueri yang dirender sepenuhnya, yang dapat disalin dan ditempelkan langsung ke Redshift, terlihat di Query Inspector. **Untuk melihat kueri interpolasi lengkap, pilih menu Query **Inspector**, dan kueri lengkap terlihat di tab Query.**
## Template dan variabel
Untuk informasi selengkapnya tentang cara menambahkan varialble kueri Redshift baru, lihat. [Menambahkan variabel kueri](variables-types.md#add-a-query-variable) Gunakan sumber data Redshift Anda sebagai sumber data Anda untuk kueri yang tersedia.
Nilai apa pun yang ditanyakan dari tabel Amazon Redshift dapat digunakan sebagai variabel. Pastikan untuk menghindari memilih terlalu banyak nilai, karena ini dapat menyebabkan masalah kinerja.
Setelah membuat variabel, Anda dapat menggunakannya dalam kueri Redshift Anda dengan menggunakan. [Sintaks variabel](templates-and-variables.md#variable-syntax) Untuk informasi lebih lanjut tentang variabel, lihat[Template dan variabel](templates-and-variables.md).
## Anotasi
[Anotasi](dashboard-annotations.md)memungkinkan Anda untuk melapisi informasi acara yang kaya di atas grafik. **Anda dapat menambahkan anotasi dengan memilih panel atau dengan menambahkan kueri anotasi menggunakan tampilan **Anotasi**, dibuka dari menu Dasbor.**
Contoh kueri untuk menambahkan anotasi secara otomatis:
```
SELECT
time as time,
environment as tags,
humidity as text
FROM
$__table
WHERE
$__timeFilter(time) and humidity > 95
```
Tabel berikut mewakili nilai-nilai kolom diperhitungkan untuk membuat anotasi:
| Nama | Deskripsi |
| --- | --- |
| Time | Nama bidang tanggal atau waktu. Bisa berupa kolom dengan tipe data tanggal atau waktu SQL asli atau nilai epoch. |
| Timeend | Nama opsional dari bidang tanggal akhir atau waktu. Bisa berupa kolom dengan tanggal SQL asli atau tipe data waktu atau nilai epoch. |
| Text | Bidang deskripsi acara. |
| Tags | Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma. |
# Connect ke sumber AWS X-Ray 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).
Tambahkan AWS X-Ray sebagai sumber data, lalu buat dasbor atau gunakan Jelajahi dengan X-Ray untuk melihat jejak, analitik, atau wawasan.
Dengan Amazon Managed Grafana, Anda dapat menambahkan X-Ray sebagai sumber data dengan menggunakan opsi konfigurasi sumber AWS data di konsol ruang kerja Grafana. Fitur ini menyederhanakan penambahan X-Ray sebagai sumber data dengan menemukan akun X-Ray yang ada dan mengelola konfigurasi kredensil otentikasi yang diperlukan untuk mengakses X-Ray. Anda dapat menggunakan metode ini untuk mengatur otentikasi dan menambahkan X-Ray 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.
**Topics**
+ [Gunakan konfigurasi sumber AWS data untuk menambahkan X-Ray sebagai sumber data](xray-adding-AWS-config.md)
+ [Menambahkan sumber data X-Ray secara manual](xray-add-the-data-source.md)
+ [Pengaturan X-Ray](#xray-settings)
+ [Menggunakan sumber data X-Ray](xray-using.md)
# Gunakan konfigurasi sumber AWS data untuk menambahkan X-Ray sebagai sumber data
Untuk menggunakan konfigurasi sumber AWS data, pertama-tama Anda menggunakan konsol Grafana Terkelola Amazon untuk mengaktifkan peran IAM berkontrol layanan yang memberikan ruang kerja kebijakan IAM yang diperlukan untuk membaca sumber daya X-Ray di akun Anda atau di seluruh unit organisasi Anda. Kemudian Anda menggunakan konsol ruang kerja Amazon Managed Grafana untuk menambahkan X-Ray sebagai sumber data.
**Untuk menggunakan konfigurasi sumber AWS data untuk menambahkan X-Ray 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 **AWS X-Ray**, dan pilih **Tindakan**, **Aktifkan kebijakan yang dikelola layanan**.
1. Pilih tab **Sumber data** lagi, lalu pilih **Konfigurasi di Grafana** di baris. **AWS X-Ray**
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 dan kemudian pilih layanan **AWS ,** X-Ray.**
1. Pilih Wilayah default tempat Anda ingin sumber data X-Ray kueri, pilih akun, lalu pilih **Tambahkan sumber data**.
# Menambahkan sumber data X-Ray secara manual
**Untuk menambahkan sumber data X-Ray secara manual**
1. **Di menu sisi konsol Grafana, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih Sumber Data.**
1. Pilih **Tambahkan sumber data**.
1. Pilih sumber data **X-Ray**. Jika perlu, Anda dapat mulai mengetik **X-Ray** di kotak pencarian untuk membantu Anda menemukannya.
## Pengaturan X-Ray
| Nama | Deskripsi |
| --- | --- |
| Nama | 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. |
| Wilayah Default | Digunakan dalam editor kueri untuk mengatur wilayah (dapat diubah berdasarkan permintaan). |
| Penyedia Auth | Tentukan penyedia untuk mendapatkan kredensil. |
| Nama profil kredensial | Tentukan nama profil yang akan digunakan (jika Anda menggunakan \$1/.aws/credentials file), tetap kosong untuk default. |
| Asumsikan Peran Arn | Tentukan ARN dari peran yang akan diasumsikan. |
| ID Eksternal | Jika Anda mengambil peran di akun lain, yang telah dibuat dengan ID eksternal, tentukan ID eksternal di sini. |
### Autentikasi
Bagian ini mencakup berbagai jenis otentikasi yang dapat Anda gunakan untuk sumber data X-Ray.
#### Peran IAM
Saat ini, semua akses ke X-Ray dilakukan di sisi server oleh backend ruang kerja Grafana menggunakan SDK resmi. AWS Jika server Grafana Anda berjalan AWS, Anda dapat menggunakan peran IAM dan otentikasi akan ditangani secara otomatis.
Untuk informasi selengkapnya, lihat [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html).
### Kebijakan IAM
Grafana membutuhkan izin yang diberikan melalui IAM untuk dapat membaca data X-Ray dan EC2. tags/instances/regions Anda dapat melampirkan izin ini ke peran IAM dan menggunakan dukungan Grafana bawaan untuk mengasumsikan peran.
Contoh kode berikut menunjukkan kebijakan minimal.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:BatchGetTraces",
"xray:GetTraceSummaries",
"xray:GetTraceGraph",
"xray:GetGroups",
"xray:GetTimeSeriesServiceStatistics",
"xray:GetInsightSummaries",
"xray:GetInsight",
"ec2:DescribeRegions"
],
"Resource": "*"
}
]
}
```
------
#### Contoh AWS kredensial
Anda tidak dapat menggunakan metode file kredensial di Grafana Terkelola Amazon.
# Menggunakan sumber data X-Ray
## Editor kueri
Bidang yang paling penting dalam editor adalah jenis kueri. Ada empat jenis kueri:
+ Daftar Jejak (Jejak di AWS)
+ Statistik Jejak
+ Trace Analytics (Analisis di AWS)
+ Wawasan
## Daftar Jejak
Jenis Trace List memungkinkan Anda untuk mencari jejak, yang ditampilkan dalam tabel. Memilih ID jejak di kolom pertama membuka jejak di sisi kanan. Perhatikan bidang kueri di editor. Anda dapat menulis kueri, memfilter ekspresi, atau Anda dapat menyisipkan ID jejak tunggal yang akan ditampilkan dalam tampilan jejak. Untuk detail selengkapnya tentang ekspresi filter, lihat [AWS X-Ray dokumentasi](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html).
**catatan**
Daftar jejak hanya akan menampilkan 1000 jejak pertama.
## Statistik Jejak
Di Trace Statistics, Anda dapat melihat grafik dan tabel yang menunjukkan informasi tentang kesalahan, kesalahan, throttle, keberhasilan, dan jumlah total. Anda dapat menggunakan kolom kolom di editor kueri untuk melihat hanya kolom tertentu.
## Trace Analytics
Di Trace Analytics, Anda dapat memvisualisasikan tabel berikut.
+ Akar Penyebab
+ Waktu Respons
+ Layanan Root Cause (Layanan terakhir di jalur)
+ Jalur (beberapa jalur)
+ Kesalahan
+ Layanan Root Cause (Layanan terakhir di jalur)
+ Jalan
+ Pesan Kesalahan
+ Kesalahan
+ Layanan Root Cause (Layanan terakhir di jalur)
+ Jalan
+ Pesan Kesalahan
+ Dampak Pengguna Akhir
+ URL
+ Kode Status HTTP
## Wawasan
Di Wawasan, Anda dapat melihat tabel ringkasan untuk Wawasan. Memilih InsightId akan membawa Anda ke konsol AWS Manajemen.
## Peringatan
Karena kueri X-Ray dapat mengembalikan data numerik, peringatan didukung. Lihat informasi yang lebih lengkap di [Grafana memperingatkan](alerts-overview.md).
# Connect ke sumber data Azure Monitor
Sumber data Azure Monitor mendukung beberapa layanan di cloud Azure:
+ Layanan **Azure Monitor adalah layanan** platform yang menyediakan satu sumber untuk memantau sumber daya Azure. Untuk informasi selengkapnya, lihat [Menanyakan layanan Azure Monitor](#query-the-azure-monitor-service).
+ **Server Application Insights** adalah layanan Application Performance Management (APM) yang dapat diperluas untuk pengembang web di berbagai platform dan dapat digunakan untuk memantau aplikasi web langsung Anda - ini akan secara otomatis mendeteksi anomali kinerja. Untuk informasi selengkapnya, lihat [Menanyakan layanan Application Insights Analytics](#query-the-application-insights-analytics-service).
+ **Azure Log Analytics** (atau Azure Logs) memberi Anda akses ke data log yang dikumpulkan oleh Azure Monitor. Untuk informasi selengkapnya, lihat [Menanyakan layanan Azure Log Analytics](#querying-the-azure-log-analytics-service).
+ Gunakan **layanan Application Insights Analytics** untuk menanyakan [data Application Insights](https://docs.microsoft.com/en-us/azure/azure-monitor/app/analytics) menggunakan bahasa kueri yang sama yang digunakan untuk Azure Log Analytics. Untuk informasi selengkapnya, lihat [Menanyakan layanan Application Insights Analytics](#query-the-application-insights-analytics-service).
## Menambahkan sumber data
Sumber data dapat mengakses metrik dari empat layanan berbeda. Anda dapat mengonfigurasi akses ke layanan yang Anda gunakan. Dimungkinkan juga untuk menggunakan kredensi yang sama untuk beberapa layanan jika itu adalah cara Anda mengaturnya di Azure Entra ID.
+ [Daftarkan aplikasi Microsoft Entra dan buat prinsipal layanan](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-create-service-principal-portal)
1. Diakses dari menu utama Grafana, sumber data yang baru diinstal dapat segera ditambahkan di bagian Sumber Data. Selanjutnya, pilih **Tambahkan sumber data** tombol di kanan atas. Sumber data Azure Monitor akan tersedia untuk dipilih di bagian Cloud dalam daftar sumber data.
1. Di bidang nama, Grafana akan secara otomatis mengisi nama untuk sumber data: `Azure Monitor` atau sesuatu seperti. `Azure Monitor - 3` Jika Anda mengonfigurasi beberapa sumber data, ubah nama menjadi sesuatu yang lebih informatif.
1. Jika Anda menggunakan Azure Monitor, Anda memerlukan empat informasi dari portal Azure (untuk instruksi terperinci, lihat tautan yang disediakan sebelumnya):
+ **Id Penyewa** (Azure Entra ID, Properti, ID Direktori)
+ **Client Id** (Azure Entra ID, Pendaftaran Aplikasi, Pilih aplikasi Anda, ID Aplikasi)
+ **Rahasia Klien** (ID Azure Entra, Pendaftaran Aplikasi, Pilih aplikasi Anda, Kunci)
+ **Id Langganan Default** (Langganan, Pilih langganan, Ikhtisar, ID Langganan)
1. Tempelkan keempat item ini ke bidang di bagian Detail API Azure Monitor.
+ Id Langganan dapat diubah per kueri. Simpan sumber data dan segarkan halaman untuk melihat daftar langganan yang tersedia untuk ID Klien yang ditentukan.
1. Jika Anda juga menggunakan layanan Azure Log Analytics, Anda harus menentukan dua nilai konfigurasi ini atau menggunakan kembali Client Id dan Secret dari langkah sebelumnya.
+ Client Id (Azure Entra ID, Pendaftaran Aplikasi, Pilih aplikasi Anda, ID Aplikasi)
+ Rahasia Klien (ID Azure Entra, Pendaftaran Aplikasi, Pilih aplikasi Anda, Kunci, Buat kunci, Gunakan rahasia klien)
1. Jika Anda menggunakan Application Insights, Anda memerlukan dua informasi dari Portal Azure (untuk petunjuk terperinci, lihat tautan yang disediakan sebelumnya):
+ ID Aplikasi
+ Kunci API
1. Tempelkan kedua item ini ke bidang yang sesuai di bagian Application Insights API Details.
1. Uji apakah detail konfigurasi sudah benar dengan memilih tombol **Simpan & Uji**.
Atau pada langkah 4, jika Anda membuat Aplikasi ID Azure Entra baru, gunakan [Azure](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest) CLI:
```
az ad sp create-for-rbac -n "http://localhost:3000"
```
## Memilih layanan
Di editor kueri untuk panel, setelah Anda memilih sumber data Azure Monitor, langkah pertama adalah memilih layanan. Ada empat opsi:
+ `Azure Monitor`
+ `Application Insights`
+ `Azure Log Analytics`
+ `Insights Analytics`
Editor kueri berubah tergantung pada opsi mana yang Anda pilih. Azure Monitor adalah default.
## Menanyakan layanan Azure Monitor
Layanan Azure Monitor menyediakan metrik untuk semua layanan Azure yang telah Anda jalankan. Ini membantu Anda memahami kinerja aplikasi Anda di Azure, dan secara proaktif menemukan masalah yang memengaruhi aplikasi Anda.
Jika kredensi Azure Monitor Anda memberi Anda akses ke beberapa langganan, pilih langganan yang sesuai terlebih dahulu.
Contoh metrik yang bisa Anda dapatkan dari layanan adalah:
+ `Microsoft.Compute/virtualMachines - Percentage CPU`
+ `Microsoft.Network/networkInterfaces - Bytes sent`
+ `Microsoft.Storage/storageAccounts - Used Capacity`
Editor kueri memungkinkan Anda untuk menanyakan beberapa dimensi untuk metrik yang mendukungnya. Metrik yang mendukung beberapa dimensi adalah yang tercantum dalam [Daftar Metrik yang didukung Azure Monitor](https://docs.microsoft.com/en-us/azure/azure-monitor/platform/metrics-supported) yang memiliki satu atau beberapa nilai yang tercantum dalam kolom **Dimensi** untuk metrik.
### Memformat kunci legenda dengan alias untuk Azure Monitor
Pemformatan legenda default untuk Azure Monitor API adalah:
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
Ini bisa panjang, tetapi Anda dapat mengubah pemformatan ini dengan menggunakan alias. Di bidang **Format Legenda**, Anda dapat menggabungkan alias berikut dengan cara apa pun yang Anda inginkan.
Contoh Azure Monitor:
+ `Blob Type: {{ blobtype }}`
+ `{{ resourcegroup }} - {{ resourcename }}`
### Pola alias untuk Azure Monitor
+ `{{ resourcegroup }}`= diganti dengan nilai Grup Sumber Daya
+ `{{ namespace }}`= diganti dengan nilai Namespace (misalnya, Microsoft.Compute/VirtualMachines)
+ `{{ resourcename }}`= diganti dengan nilai Resource Name
+ `{{ metric }}`= diganti dengan nama metrik (misalnya, Persentase CPU)
+ `{{ dimensionname }}`= *Legacy pada 7.1\$1 (untuk kompatibilitas mundur)* diganti dengan dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) key/label (misalnya, blobtype)
+ `{{ dimensionvalue }}`= *Legacy pada 7.1\$1 (untuk kompatibilitas mundur)* diganti dengan nilai dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) (misalnya,) BlockBlob
+ `{{ arbitraryDim }}`= *Tersedia dalam 7.1\$1* diganti dengan nilai dimensi yang sesuai. (misalnya, `{{ blobtype }}` menjadi BlockBlob)
### Membuat variabel template untuk Azure Monitor
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.
Perhatikan bahwa layanan Azure Monitor belum mendukung beberapa nilai. Untuk memvisualisasikan beberapa deret waktu (misalnya, metrik untuk server1 dan server2), tambahkan beberapa kueri sehingga Anda dapat melihatnya pada grafik yang sama atau dalam tabel yang sama.
Plugin sumber data Azure Monitor menyediakan kueri berikut yang dapat Anda tentukan di bidang **Kueri** dalam tampilan Edit variabel. Anda dapat menggunakannya untuk mengisi daftar opsi variabel.
| Nama | Deskripsi |
| --- | --- |
| Subscriptions() | Mengembalikan daftar langganan. |
| ResourceGroups() | Mengembalikan daftar kelompok sumber daya. |
| ResourceGroups(12345678-aaaa-bbbb-cccc-123456789aaa) | Mengembalikan daftar kelompok sumber daya untuk langganan tertentu. |
| Namespaces(aResourceGroup) | Mengembalikan daftar namespace untuk kelompok sumber daya tertentu. |
| Namespaces(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup) | Mengembalikan daftar namespace untuk kelompok sumber daya tertentu dan berlangganan. |
| ResourceNames(aResourceGroup, aNamespace) | Mengembalikan daftar nama sumber daya. |
| ResourceNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace) | Mengembalikan daftar nama sumber daya untuk langganan tertentu. |
| MetricNamespace(aResourceGroup, aNamespace, aResourceName) | Mengembalikan daftar ruang nama metrik. |
| MetricNamespace(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName) | Mengembalikan daftar ruang nama metrik untuk langganan tertentu. |
| MetricNames(aResourceGroup, aNamespace, aResourceName) | Mengembalikan daftar nama metrik. |
| MetricNames(12345678-aaaa-bbbb-cccc-123456789aaa, aResourceGroup, aNamespace, aResourceName) | Mengembalikan daftar nama metrik untuk langganan tertentu. |
Contoh:
+ Kueri Resource Groups: `ResourceGroups()`
+ Melewati variabel nama metrik: `Namespaces(cosmo)`
+ Variabel template rantai: `ResourceNames($rg, $ns)`
+ Jangan mengutip parameter: `MetricNames(hg, Microsoft.Network/publicIPAddresses, grafanaIP)`
Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template](templates-and-variables.md#templates).
### Daftar metrik Azure Monitor yang didukung
Tidak semua metrik yang dikembalikan oleh Azure Monitor API memiliki nilai. Untuk mempermudah pembuatan kueri, sumber data Grafana memiliki daftar metrik Azure Monitor yang didukung, dan mengabaikan metrik yang tidak akan pernah memiliki nilai. Daftar ini diperbarui secara berkala karena layanan dan metrik baru ditambahkan ke cloud Azure.
### Peringatan Azure Monitor
Grafana alert didukung untuk layanan Azure Monitor. Ini bukan dukungan Azure Alerts. Untuk informasi lebih lanjut tentang peringatan Grafana, lihat. [Grafana memperingatkan](alerts-overview.md)
## Menanyakan layanan Application Insights
### Memformat kunci legenda dengan alias untuk Wawasan Aplikasi
Pemformatan legenda default adalah:
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
Di bidang Format Legenda, alias berikut dapat digabungkan dengan cara apa pun yang Anda inginkan.
Contoh Wawasan Aplikasi:
+ `city: {{ client/city }}`
+ `{{ metric }} [Location: {{ client/countryOrRegion }}, {{ client/city }}]`
### Pola alias untuk Wawasan Aplikasi
+ `{{ groupbyvalue }}`= *Legacy pada Grafana 7.1\$1 (untuk kompatibilitas mundur) diganti dengan dimensi pertama (seperti* yang diurutkan berdasarkan key/label kunci/label)
+ `{{ groupbyname }}`= *Legacy pada Grafana 7.1\$1 (untuk kompatibilitas mundur*) diganti dengan nilai dimensi pertama (seperti yang diurutkan berdasarkan kunci/label) (misalnya,) BlockBlob
+ `{{ metric }}`= diganti dengan nama metrik (misalnya, permintaan/hitungan)
+ `{{ arbitraryDim }}`= *Tersedia dalam 7.1\$1* diganti dengan nilai dimensi yang sesuai. (misalnya, `{{ client/city }}` menjadi Chicago)
### Ekspresi filter untuk Wawasan Aplikasi
Bidang filter mengambil ekspresi OData filter.
Contoh:
+ `client/city eq 'Boydton'`
+ `client/city ne 'Boydton'`
+ `client/city ne 'Boydton' and client/city ne 'Dublin'`
+ `client/city eq 'Boydton' or client/city eq 'Dublin'`
### Templating dengan variabel untuk Application Insights
Gunakan salah satu kueri berikut di bidang **Query** di tampilan edit Variabel.
Untuk informasi selengkapnya tentang variabel template dan template, lihat[Template](templates-and-variables.md#templates).
| Nama | Deskripsi |
| --- | --- |
| AppInsightsMetricNames() | Mengembalikan daftar nama metrik. |
| AppInsightsGroupBys(aMetricName) | Mengembalikan daftar group by klausa untuk nama metrik tertentu. |
Contoh:
+ Kueri Nama Metrik: `AppInsightsMetricNames()`
+ Melewati variabel nama metrik: `AppInsightsGroupBys(requests/count)`
+ Variabel template rantai: `AppInsightsGroupBys($metricnames)`
### Peringatan Wawasan Aplikasi
Peringatan Grafana didukung untuk Wawasan Aplikasi. Ini bukan dukungan Azure Alerts. Untuk informasi lebih lanjut tentang peringatan Grafana, lihat. [Grafana memperingatkan](alerts-overview.md)
## Menanyakan layanan Azure Log Analytics
Kueri ditulis dalam Bahasa Kueri [Azure Log Analytics (atau KustoDB](https://docs.microsoft.com/en-us/azure/azure-monitor/log-query/query-language)) yang baru. Kueri Log Analytics dapat diformat sebagai data deret waktu atau sebagai data tabel.
Jika kredensional Anda memberi Anda akses ke beberapa langganan, pilih langganan yang sesuai sebelum memasukkan kueri.
### Pertanyaan deret waktu
Kueri deret waktu adalah untuk panel grafik dan panel lain seperti SingleStat panel. Setiap kueri harus berisi setidaknya kolom datetime dan kolom nilai numerik. Hasilnya harus diurutkan dalam urutan menaik menurut kolom datetime.
Contoh kode berikut menunjukkan query yang mengembalikan jumlah agregat dikelompokkan berdasarkan jam.
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h)
| order by TimeGenerated asc
```
Kueri juga dapat memiliki satu atau lebih kolom non-numerik/non-datetime, dan kolom tersebut dianggap dimensi dan menjadi label dalam respons. Misalnya, kueri yang mengembalikan jumlah agregat yang dikelompokkan berdasarkan jam, Komputer, dan. CounterName
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize count() by bin(TimeGenerated, 1h), Computer, CounterName
| order by TimeGenerated asc
```
Anda juga dapat memilih kolom nilai angka tambahan (dengan, atau tanpa beberapa dimensi). Misalnya, mendapatkan hitungan dan nilai rata-rata per jam, Komputer CounterName, dan InstanceName:
```
Perf
| where $__timeFilter(TimeGenerated)
| summarize Samples=count(), ["Avg Value"]=avg(CounterValue)
by bin(TimeGenerated, $__interval), Computer, CounterName, InstanceName
| order by TimeGenerated asc
```
**catatan**
**Tip**: Pada kueri sebelumnya, sintaks Kusto dan `Samples=count()` `["Avg Value"]=...` digunakan untuk mengganti nama kolom tersebut — sintaks kedua yang memungkinkan ruang. Ini mengubah nama metrik yang digunakan Grafana. Akibatnya, hal-hal seperti legenda seri dan kolom tabel akan cocok dengan apa yang Anda tentukan. Dalam contoh `Samples` ini, ditampilkan bukan`_count`.
### Kueri tabel
Kueri tabel terutama digunakan dalam panel tabel, dan mereka menunjukkan daftar kolom dan baris. Contoh query ini mengembalikan baris dengan enam kolom tertentu.
```
AzureActivity
| where $__timeFilter()
| project TimeGenerated, ResourceGroup, Category, OperationName, ActivityStatus, Caller
| order by TimeGenerated desc
```
### Memformat nama tampilan untuk Log Analytics
Format nama tampilan default adalah:
`metricName{dimensionName=dimensionValue,dimensionTwoName=DimensionTwoValue}`
Ini dapat disesuaikan dengan menggunakan opsi bidang nama tampilan.
### Makro Azure Log Analytics
Untuk mempermudah penulisan kueri, Grafana menyediakan beberapa makro yang dapat Anda gunakan di klausa where kueri:
+ `$__timeFilter()`— Memperluas ke `TimeGenerated ≥ datetime(2018-06-05T18:09:58.907Z) and` `TimeGenerated ≤ datetime(2018-06-05T20:09:58.907Z)` tempat dari dan ke datetimes berasal dari pemilih waktu Grafana.
+ `$__timeFilter(datetimeColumn)`— Memperluas ke `datetimeColumn ≥ datetime(2018-06-05T18:09:58.907Z) and` `datetimeColumn ≤ datetime(2018-06-05T20:09:58.907Z)` tempat dari dan ke datetimes berasal dari pemilih waktu Grafana.
+ `$__timeFrom()`— Mengembalikan datetime Dari dari pemilih Grafana. Contoh:`datetime(2018-06-05T18:09:58.907Z)`.
+ `$__timeTo()`— Mengembalikan datetime Dari dari pemilih Grafana. Contoh:`datetime(2018-06-05T20:09:58.907Z)`.
+ `$__escapeMulti($myVar)`— akan digunakan dengan variabel template multi-nilai yang berisi karakter ilegal. Jika `$myVar` memiliki dua nilai berikut sebagai string`'\\grafana-vm\Network(eth0)\Total','\\hello!'`, maka itu meluas ke:`@'\\grafana-vm\Network(eth0)\Total', @'\\hello!'`. Jika menggunakan variabel nilai tunggal tidak perlu untuk makro ini, lepas dari variabel inline sebagai gantinya:. `@'\$myVar'`
+ `$__contains(colName, $myVar)`— akan digunakan dengan variabel template multi-nilai. Jika `$myVar` memiliki nilai`'value1','value2'`, itu meluas ke:`colName in ('value1','value2')`.
Jika menggunakan **Semua** pilihan, centang kotak centang **Sertakan Semua Opsi** dan di bidang **Kustom semua nilai**, masukkan nilai berikut:**all**. Jika `$myVar` memiliki nilai`all`, makro malah akan diperluas ke`1 == 1`. Untuk variabel template dengan banyak opsi, ini meningkatkan kinerja kueri dengan tidak membangun klausa “where.. in” yang besar.
### Variabel bawaan Azure Log Analytics
Ada juga beberapa variabel Grafana yang dapat digunakan dalam kueri Azure Log Analytics:
+ `$__interval`- Grafana menghitung butir waktu minimum yang dapat digunakan untuk mengelompokkan berdasarkan waktu dalam kueri. Ia mengembalikan butir waktu seperti `5m` atau `1h` yang dapat digunakan dalam fungsi bin; misalnya,`summarize count() by bin(TimeGenerated, $__interval)`. Untuk informasi lebih lanjut tentang variabel interval, lihat[Menambahkan variabel interval](variables-types.md#add-an-interval-variable).
### Templating dengan variabel untuk Azure Log Analytics
Setiap kueri Log Analytics yang mengembalikan daftar nilai dapat digunakan di bidang **Kueri** dalam tampilan edit Variabel. Ada juga satu fungsi Grafana untuk Log Analytics yang mengembalikan daftar ruang kerja.
Untuk informasi tentang template dan variabel template, lihat[Template dan variabel](templates-and-variables.md).
| Nama | Deskripsi |
| --- | --- |
| workspaces() | Mengembalikan daftar ruang kerja untuk langganan default. |
| workspaces(12345678-aaaa-bbbb-cccc-123456789aaa) | Mengembalikan daftar ruang kerja untuk langganan tertentu (parameter dapat dikutip atau tidak dikutip). |
Tabel berikut menunjukkan contoh query variabel.
| Kueri | Deskripsi |
| --- | --- |
| subscriptions() | Mengembalikan daftar langganan Azure. |
| workspaces() | Mengembalikan daftar ruang kerja untuk langganan default. |
| workspaces("12345678-aaaa-bbbb-cccc-123456789aaa") | Mengembalikan daftar ruang kerja untuk langganan tertentu. |
| workspaces("\$1subscription") | Dengan variabel template untuk parameter berlangganan. |
| workspace("myWorkspace").Heartbeat \$1\$1 distinct Computer | Mengembalikan daftar mesin virtual. |
| workspace("\$1workspace").Heartbeat \$1\$1 distinct Computer | Mengembalikan daftar mesin virtual dengan variabel template. |
| workspace("\$1workspace").Perf \$1\$1 distinct ObjectName | Mengembalikan daftar objek dari tabel Perf. |
| workspace("\$1workspace").Perf \$1\$1 where ObjectName == "\$1object" \$1\$1 distinct CounterName | Mengembalikan daftar nama metrik dari tabel Perf. |
Kode xample berikut menunjukkan query deret waktu menggunakan variabel.
```
Perf
| where ObjectName == "$object" and CounterName == "$metric"
| where TimeGenerated >= $__timeFrom() and TimeGenerated <= $__timeTo()
| where $__contains(Computer, $computer)
| summarize avg(CounterValue) by bin(TimeGenerated, $__interval), Computer
| order by TimeGenerated asc
```
### Penautan mendalam dari panel Grafana ke editor kueri Log Analytics di Azure Portal
Pilih deret waktu di panel untuk melihat menu konteks dengan tautan ke **Lihat di Portal Azure**. Memilih tautan itu membuka editor kueri Azure Log Analytics di Portal Azure dan menjalankan kueri dari panel Grafana di sana.
Jika saat ini Anda tidak masuk ke Portal Azure, maka tautan akan membuka halaman login. Tautan yang disediakan berlaku untuk akun apa pun, tetapi hanya menampilkan kueri jika akun Anda memiliki akses ke ruang kerja Azure Log Analytics yang ditentukan dalam kueri.
### Peringatan Azure Log Analytics
Peringatan Grafana didukung untuk Wawasan Aplikasi. Ini bukan dukungan Azure Alerts. Untuk informasi selengkapnya tentang peringatan di ruang kerja Grafana, lihat. [Grafana memperingatkan](alerts-overview.md)
## Menanyakan layanan Application Insights Analytics
Jika Anda mengubah jenis layanan ke **Insights Analytics**, editor serupa dengan layanan Log Analytics akan tersedia. Layanan ini juga menggunakan bahasa Kusto, sehingga instruksi untuk kueri data identik dengan[Menanyakan layanan Azure Log Analytics](#querying-the-azure-log-analytics-service), kecuali Anda meminta data Application Insights Analytics sebagai gantinya.
# Connect ke sumber data Graphite
Grafana memiliki editor kueri Grafit canggih yang memungkinkan Anda menavigasi ruang metrik dengan cepat, menambahkan fungsi, mengubah parameter fungsi, dan banyak lagi. Editor dapat menangani semua jenis kueri grafit. Bahkan dapat menangani kueri bersarang yang kompleks melalui penggunaan referensi kueri.
## Pengaturan grafit
Untuk mengakses pengaturan Graphite, jeda pada ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih sumber data grafit.
| 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 instalasi graphite-web atau grafit-api Anda. |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Auth | |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
| Custom HTTP Headers | Pilih Tambahkan header untuk menambahkan header HTTP kustom. |
| Header | Masukkan nama header kustom. |
| Value | Masukkan nilai header kustom. |
| Graphite details | |
| Version | Pilih versi Graphite Anda. |
| Type | Pilih jenis Grafit Anda. |
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 Amazon Managed 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 Grafana Terkelola Amazon.
### Mode akses browser
Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber data Graphite.
## Editor kueri grafit
Grafana menyertakan editor kueri khusus Graphite untuk membantu Anda membangun kueri.
Untuk melihat teks mentah dari kueri yang dikirim ke Graphite, pilih ikon **Toggle text edit mode** (pensil).
### Memilih metrik untuk kueri
Pilih **Pilih metrik** untuk menavigasi ruang metrik. Setelah Anda mulai, Anda dapat terus menggunakan tombol panah penunjuk atau keyboard. Anda dapat memilih karakter wildcard dan masih melanjutkan.
### Fungsi
Untuk menambahkan fungsi, pilih ikon plus di sebelah **Fungsi**. Anda dapat mencari fungsi atau memilihnya dari menu. Setelah fungsi dipilih, itu akan ditambahkan dan fokus Anda akan berada di kotak teks parameter pertama. Untuk mengedit atau mengubah parameter, pilih dan itu akan berubah menjadi kotak teks. - Untuk menghapus fungsi, pilih nama fungsi diikuti oleh ikon x.
Beberapa fungsi, seperti`aliasByNode`, mendukung argumen kedua opsional. Untuk menambahkan argumen, jeda pada argumen pertama, lalu pilih `+` simbol yang muncul. Untuk menghapus parameter opsional kedua, pilih dan biarkan kosong. Editor akan menghapusnya.
### Urutkan label
Jika Anda ingin pemesanan yang konsisten, gunakan`sortByName`. Ini bisa mengganggu ketika Anda memiliki label yang sama pada beberapa grafik, dan keduanya diurutkan secara berbeda dan menggunakan warna yang berbeda. Untuk memperbaikinya, gunakan`sortByName()`.
### Kueri bersarang
Anda dapat mereferensikan kueri dengan *huruf* baris yang mereka gunakan (mirip dengan Microsoft Excel). Jika Anda menambahkan kueri kedua ke grafik, Anda dapat mereferensikan kueri pertama dengan mengetik \$1A. Ini menyediakan cara mudah untuk membuat kueri gabungan.
### Menghindari banyak pertanyaan dengan menggunakan karakter wildcard
Kadang-kadang, Anda mungkin ingin melihat beberapa deret waktu diplot pada grafik yang sama. Misalnya, Anda mungkin ingin melihat bagaimana CPU digunakan pada mesin. Anda mungkin awalnya membuat grafik dengan menambahkan kueri untuk setiap deret waktu, seperti `cpu.percent.user.g``cpu.percent.system.g`,, dan sebagainya. Ini menghasilkan *n* kueri yang dibuat ke sumber data, yang tidak efisien.
Agar lebih efisien, seseorang dapat menggunakan karakter wildcard dalam pencarian Anda, mengembalikan semua deret waktu dalam satu kueri. Misalnya, `cpu.percent.*.g`.
### Memodifikasi nama metrik dalam tabel atau bagan
Gunakan `alias` fungsi untuk mengubah nama metrik pada tabel atau grafik Grafana; misalnya, atau. `aliasByNode()` `aliasSub()`
## Konsolidasi titik
Semua metrik Graphite dikonsolidasikan sehingga Graphite tidak mengembalikan lebih banyak titik data daripada piksel dalam grafik. Secara default, konsolidasi ini dilakukan dengan menggunakan `avg` fungsi. Anda dapat mengontrol bagaimana Graphite mengkonsolidasikan metrik dengan menambahkan fungsi Graphite ConsolidateBy.
**catatan**
Ini berarti bahwa nilai ringkasan legenda (maks, min, total) tidak dapat semuanya benar pada saat yang bersamaan. Mereka dihitung sisi klien oleh Grafana. Dan tergantung pada fungsi konsolidasi Anda, hanya satu atau dua yang bisa benar pada saat yang bersamaan.
## Menggabungkan deret waktu
Untuk menggabungkan deret waktu, pilih **Gabungkan** dalam daftar **Fungsi**.
## Eksplorasi data dan tag
Dalam Graphite, semuanya adalah tag.
Saat menjelajahi data, tag yang dipilih sebelumnya digunakan untuk memfilter kumpulan hasil yang tersisa. Untuk memilih data, Anda menggunakan `seriesByTag` fungsi, yang mengambil ekspresi tag (`=`,, `!=``=~`,`!=~`) untuk memfilter deret waktu.
Pembuat kueri Grafana melakukan ini untuk Anda secara otomatis saat Anda memilih tag.
**catatan**
**Tip:** Pencarian ekspresi reguler bisa lambat pada tag kardinalitas tinggi, jadi coba gunakan tag lain untuk mengurangi cakupan terlebih dahulu. Memulai dengan nama atau namespace tertentu membantu mengurangi hasilnya.
## Variabel template
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).
Untuk membuat variabel menggunakan nilai tag, gunakan fungsi `tags` Grafana dan. `tag_values`
| Kueri | Deskripsi |
| --- | --- |
| tags() | Mengembalikan semua tag. |
| tags(server=\$1backend\$1\$1) | Mengembalikan hanya tag yang terjadi dalam seri yang cocok dengan ekspresi filter. |
| tag\$1values(server) | Mengembalikan nilai tag untuk tag yang ditentukan. |
| tag\$1values(server, server=\$1backend\$1\$1) | Mengembalikan nilai tag yang disaring yang terjadi untuk tag tertentu dalam seri yang cocok dengan ekspresi tersebut. |
| tag\$1values(server, server=\$1backend\$1\$1, app=\$1\$1\$1apps:regex\$1) | Beberapa ekspresi dan ekspresi filter dapat berisi variabel lain. |
Untuk detail selengkapnya, lihat [Dokumen grafit pada API pelengkapan otomatis untuk](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support) tag.
### Variabel kueri
Kueri yang Anda tentukan di bidang kueri harus berupa jenis kueri pencarian metrik. Misalnya, kueri seperti `prod.servers.*` akan mengisi variabel dengan semua nilai yang mungkin ada di posisi wildcard.
Anda juga dapat membuat variabel bersarang yang menggunakan variabel lain dalam definisi mereka. Misalnya `apps.$app.servers.*` menggunakan variabel `$app` dalam definisi query nya.
#### Menggunakan `__searchFilter` untuk memfilter hasil variabel kueri
Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan apa yang Anda masukkan di kotak pilih tarik-turun. Ketika Anda tidak memasukkan apa-apa, nilai default untuk `__searchFilter` adalah `*` dan ``ketika digunakan sebagai bagian dari ekspresi reguler.
Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `server` sementara pengguna memasukkan teks dalam kotak pilih dropdown.
Kueri
```
apps.$app.servers.$__searchFilter
```
TagValues
```
tag_values(server, server=~${__searchFilter:regex})
```
### Penggunaan variabel
Anda dapat menggunakan variabel dalam jalur simpul metrik atau sebagai parameter untuk suatu fungsi.
Ada dua sintaks:
+ `$`Contoh: apps.frontend. \$1 server.requests.count
+ `${varname}`Contoh: apps.frontend. \$1 \$1server\$1 .requests.count
Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Gunakan sintaks kedua dalam ekspresi seperti`my.server${serverNumber}.count`.
### Penggunaan variabel dalam kueri tag
Variabel multi-nilai dalam kueri tag menggunakan sintaks pemformatan lanjutan yang diperkenalkan di Grafana 5.0 untuk variabel:. `{var:regex}` Kueri non-tag akan menggunakan pemformatan glob default untuk variabel multi-nilai.
Contoh kode berikut menunjukkan ekspresi tag dengan pemformatan regex dan menggunakan operator Equal Tilde,. `=~`
```
server=~${servers:regex}
```
Untuk informasi selengkapnya, lihat [Opsi format variabel lanjutan](templates-and-variables.md#advanced-variable-format-options).
## Anotasi
Anotasi memungkinkan Anda untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).
Graphite mendukung dua cara untuk menanyakan anotasi:
+ Kueri metrik reguler. Untuk ini, Anda menggunakan kotak teks **kueri Graphite**.
+ Sebuah query peristiwa grafit. Untuk ini, Anda menggunakan kotak `Graphite event tags` teks, dan menentukan tag atau karakter wildcard (menjaganya tetap kosong juga harus berfungsi).
# Connect ke sumber data Google Cloud Monitoring
**catatan**
Dalam versi Grafana sebelumnya, sumber data ini diberi nama Google Stackdriver.
Tambahkan sumber data Google Cloud Monitoring agar dapat membuat dasbor untuk metrik Google Cloud Monitoring Anda.
## Menambahkan sumber data
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**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. Pilih **Google Cloud Monitoring** dari daftar dropdown **Type**.
1. Unggah atau tempel di file Kunci Akun Layanan. Lihat nanti di dokumen ini untuk langkah-langkah untuk membuat file Kunci Akun Layanan.
**catatan**
Jika Anda tidak melihat tautan **Sumber Data** di menu samping, pengguna Anda saat ini tidak memiliki `Admin` peran tersebut.
| Nama | Deskripsi |
| --- | --- |
| Name | Nama sumber data. Ini adalah bagaimana Anda merujuk ke sumber data di panel dan kueri. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| Service Account Key | File kunci akun layanan untuk Proyek GCP. Lihat petunjuknya nanti di dokumen ini tentang cara membuatnya. |
## Autentikasi
Ada dua cara untuk mengautentikasi plugin Google Cloud Monitoring
+ Unggah file Google JWT
+ Secara otomatis mengambil kredensil dari server metadata Google
Opsi terakhir hanya tersedia saat menjalankan Grafana di mesin virtual GCE.
### Menggunakan file kunci akun layanan Google
Untuk mengautentikasi dengan Google Cloud Monitoring API, Anda harus membuat Akun Layanan Google Cloud Platform (GCP) untuk Project yang ingin Anda tampilkan datanya. Sumber data Grafana terintegrasi dengan satu Proyek GCP. Untuk memvisualisasikan data dari beberapa Proyek GCP, Anda harus membuat satu sumber data per Proyek GCP.
#### Mengaktifkan APIs
Berikut ini APIs harus diaktifkan terlebih dahulu:
+ [API Pemantauan](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
+ [API Manajer Sumber Daya Cloud](https://console.cloud.google.com/apis/library/cloudresourcemanager.googleapis.com)
Pilih tautan yang terdaftar, lalu pilih tombol **Aktifkan**.
#### Membuat akun layanan GCP untuk Proyek
1. Arahkan ke halaman [APIsdan Kredensial Layanan](https://console.cloud.google.com/apis/credentials).
1. Pilih **Create credentials** dropdown/button dan pilih opsi **Service account key**.
\$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1button.png "class="docs-image—no-shadow” caption="Buat tombol akun layanan” >\$1\$1
1. Pada halaman **Create Service Account Key**, pilih Key Type`JSON`. Kemudian, di daftar dropdown **Akun Layanan**, pilih opsi **Akun layanan baru**.
\$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1key.png "class="docs-image—no-shadow” caption="Buat kunci akun layanan” >\$1\$1
1. Beberapa bidang baru akan muncul. Isi nama untuk akun layanan di bidang **Nama akun layanan**, lalu pilih peran **Monitoring Viewer** dari daftar tarik-turun **Peran**.
\$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1service\$1account\$1choose\$1role.png "class="docs-image—no-shadow” caption="Pilih peran” >\$1\$1
1. Pilih tombol **Buat**. File kunci JSON akan dibuat dan diunduh ke komputer Anda. Simpan file ini di tempat yang aman karena memungkinkan akses ke data Google Cloud Monitoring Anda.
1. Unggah ke Grafana di halaman **Konfigurasi** sumber data. Anda dapat mengunggah file atau menempelkan konten file.
\$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1grafana\$1upload\$1key.png "class="docs-image—no-shadow” caption="Unggah berkas kunci layanan ke Grafana” >\$1\$1
1. Isi file akan dienkripsi dan disimpan di database Grafana. Jangan lupa untuk menyimpan setelah mengunggah file\$1
\$1\$1< docs-imagebox img=”/img/docs/v71/cloudmonitoring\$1grafana\$1key\$1uploaded.png "class="docs-image—no-shadow” caption="File kunci layanan diunggah ke Grafana” >\$1\$1
## Menggunakan editor kueri
Editor kueri Google Cloud Monitoring memungkinkan Anda membuat dua jenis kueri - **Metric** and **Service Level Objective (SLO**). Kedua jenis mengembalikan data deret waktu.
### Kueri metrik
Editor kueri metrik memungkinkan Anda memilih metrik, group/aggregate berdasarkan label dan waktu, dan menggunakan filter untuk menentukan deret waktu yang Anda inginkan dalam hasil.
Untuk membuat kueri metrik, ikuti langkah-langkah berikut:
1. Pilih opsi **Metrik dalam daftar** tarik-turun **Jenis Kueri**.
1. Pilih proyek dari daftar dropdown **Project**.
1. Pilih layanan Google Cloud Platform dari daftar tarik-turun **Layanan**.
1. Pilih metrik dari daftar dropdown **Metrik**.
1. Untuk menambah atau menghapus filter atau mengelompokkan berdasarkan klausa, gunakan ikon plus dan minus di filter dan kelompokkan berdasarkan bagian. Langkah ini bersifat opsional.
Metrik Google Cloud Monitoring dapat dari berbagai jenis (GAUGE, DELTA, KUMULATIF) dan jenis ini memiliki dukungan untuk opsi agregasi yang berbeda (reduksi dan pelurus). Editor kueri Grafana menunjukkan daftar metode agregasi yang tersedia untuk metrik yang dipilih dan menetapkan peredam dan pelurus default saat Anda memilih metrik. Unit untuk sumbu Y juga dipilih secara otomatis oleh editor kueri.
#### Penyaring
Untuk menambahkan filter, pilih ikon plus, pilih bidang untuk difilter, dan masukkan nilai filter. Misalnya, masukkan `instance_name = grafana-1`. Anda dapat menghapus filter dengan memilih nama filter dan memilih`--remove filter--`.
##### Karakter wildcard sederhana
Ketika operator diatur ke atau, `=` `!=` dimungkinkan untuk menambahkan karakter wildcard ke bidang nilai filter. Misalnya, `us-*` menangkap semua nilai yang dimulai dengan “us-”, dan `*central-a` menangkap semua nilai yang diakhiri dengan “central-a”. `*-central-*`menangkap semua nilai yang memiliki substring. `central-` Karakter wildcard sederhana lebih murah daripada ekspresi reguler.
##### Ekspresi reguler
Ketika operator diatur ke atau, `=~` `!=~` dimungkinkan untuk menambahkan ekspresi reguler ke bidang nilai filter. Misalnya, `us-central[1-3]-[af]` mencocokkan semua nilai yang dimulai dengan “us-central”, diikuti dengan angka dalam kisaran 1 hingga 3, tanda hubung dan kemudian “a” atau “f”. Garis miring dan garis miring tidak diperlukan saat membuat ekspresi reguler.
#### Agregasi
Bidang agregasi memungkinkan Anda menggabungkan deret waktu berdasarkan statistik umum. Untuk informasi lebih lanjut tentang agregasi, lihat opsi [agregasi](https://cloud.google.com/monitoring/charts/metrics-selector#aggregation-options).
`Aligner`Bidang ini memungkinkan Anda untuk menyelaraskan beberapa deret waktu setelah grup yang sama berdasarkan interval waktu. Untuk informasi selengkapnya tentang aligner, lihat pemilih [metrik penyelarasan.](https://cloud.google.com/monitoring/charts/metrics-selector#alignment)
##### Periode Penyelarasan dan pengelompokan berdasarkan waktu
`Alignment Period`Kelompokkan metrik berdasarkan waktu jika agregasi dipilih. Defaultnya adalah menggunakan pengelompokan default GCP Google Cloud Monitoring (yang memungkinkan Anda membandingkan grafik di Grafana dengan grafik di UI Pemantauan Google Cloud). Opsi ini dipanggil `cloud monitoring auto` dan defaultnya adalah:
+ 1m untuk rentang waktu <23 jam
+ 5m untuk rentang waktu> = 23 jam dan < 6 hari
+ 1 jam untuk rentang waktu> = 6 hari
Opsi otomatis lainnya adalah`grafana auto`. Ini akan secara otomatis mengatur grup berdasarkan waktu tergantung pada rentang waktu yang dipilih dan lebar panel grafik. Untuk informasi selengkapnya, lihat [Menambahkan variabel interval](variables-types.md#add-an-interval-variable).
Dimungkinkan juga untuk memilih interval waktu tetap untuk dikelompokkan menurut, seperti `1h` atau`1d`.
#### Kelompokkan Oleh
Kelompokkan berdasarkan sumber daya atau label metrik untuk mengurangi jumlah deret waktu dan untuk mengumpulkan hasil oleh grup berdasarkan. Misalnya, kelompokkan berdasarkan instance\$1name untuk melihat metrik agregat untuk instance komputasi.
##### Label metadata
Label metadata sumber daya berisi informasi untuk mengidentifikasi sumber daya secara unik di Google Cloud. Label metadata hanya ditampilkan dalam respons deret waktu jika label tersebut merupakan bagian dari segmen **Grup Berdasarkan** dalam permintaan deret waktu. Tidak ada API untuk mengambil label metadata, jadi tidak mungkin untuk mengisi grup berdasarkan daftar tarik-turun dengan label metadata yang tersedia untuk layanan dan metrik yang dipilih. Namun, daftar dropdown bidang **Group By** dilengkapi dengan daftar label sistem umum yang telah ditentukan sebelumnya.
Label pengguna tidak dapat ditentukan sebelumnya, tetapi Anda dapat memasukkannya secara manual di bidang **Grup Berdasarkan**. Jika label metadata, label pengguna, atau label sistem disertakan dalam segmen **Grup Berdasarkan**, Anda dapat membuat filter berdasarkan itu dan memperluas nilainya di bidang **Alias**.
#### Pola alias
Bidang Alias By memungkinkan Anda untuk mengontrol format tombol legenda. Defaultnya adalah menampilkan nama metrik dan label. Ini bisa panjang dan sulit dibaca. Menggunakan pola berikut di bidang alias, Anda dapat memformat kunci legenda seperti yang Anda inginkan.
#### Pola Jenis Metrik
| Pola alias | Deskripsi | Contoh hasil |
| --- | --- | --- |
| \$1\$1metric.type\$1\$1 | Mengembalikan Tipe Metrik penuh. | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | Mengembalikan bagian nama metrik. | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | Mengembalikan bagian layanan. | compute |
#### Pola label
Dalam daftar dropdown Group By, Anda dapat melihat daftar label metrik dan sumber daya untuk metrik. Ini dapat dimasukkan dalam kunci legenda menggunakan pola alias.
| Format pola alias | Deskripsi | Contoh pola alias | Contoh hasil |
| --- | --- | --- | --- |
| \$1\$1metric.label.xxx\$1\$1 | Mengembalikan nilai label metrik. | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | Mengembalikan nilai label sumber daya. | \$1\$1resource.label.zone\$1\$1 | us-east1-b |
| \$1\$1metadata.system\$1labels.xxx\$1\$1 | Mengembalikan nilai label sistem metadata. | \$1\$1metadata.system\$1labels.name\$1\$1 | grafana |
| \$1\$1metadata.user\$1labels.xxx\$1\$1 | Mengembalikan nilai label pengguna metadata. | \$1\$1metadata.user\$1labels.tag\$1\$1 | production |
Contoh Alias Oleh: `{{metric.type}} - {{metric.label.instance_name}}`
Contoh Hasil: `compute.googleapis.com/instance/cpu/usage_time - server1-prod`
Dimungkinkan juga untuk menyelesaikan nama Jenis Sumber Daya yang Dipantau.
| Format pola alias | Deskripsi | Contoh hasil |
| --- | --- | --- |
| \$1\$1resource.type\$1\$1 | Mengembalikan nama jenis sumber daya yang dipantau. | gce\$1instance |
Contoh Alias Oleh: `{{resource.type}} - {{metric.type}}`
Contoh Hasil: `gce_instance - compute.googleapis.com/instance/cpu/usage_time`
### Kueri SLO
**catatan**
Kueri SLO hanya tersedia di Grafana v7.0\$1
Pembuat kueri SLO di sumber data Google Cloud Monitoring memungkinkan Anda menampilkan data SLO dalam format deret waktu. Untuk mendapatkan pemahaman tentang konsep dasar dalam pemantauan layanan, lihat [dokumentasi resmi](https://cloud.google.com/monitoring/service-monitoring) Google Cloud Monitoring.
#### Membuat kueri SLO
Untuk membuat kueri SLO, ikuti langkah-langkah berikut:
1. Pilih opsi **Tujuan Tingkat Layanan (SLO) di daftar** dropdown **Jenis Kueri**.
1. Pilih proyek dari daftar dropdown **Project**.
1. Pilih [layanan SLO dari daftar](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services) **dropdown Layanan**.
1. Pilih [SLO dari daftar](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services.serviceLevelObjectives) **dropdown SLO**.
1. Pilih [pemilih deret waktu dari daftar](https://cloud.google.com/monitoring/service-monitoring/timeseries-selectors#ts-selector-list) dropdown **Selector**.
Nama-nama ramah untuk pemilih deret waktu ditampilkan di Grafana. Tabel berikut menunjukkan pemetaan dari nama ramah ke nama sistem yang digunakan dalam dokumentasi Service Monitoring.
| Nilai daftar dropdown pemilih | Pemilih deret waktu yang sesuai digunakan |
| --- | --- |
| Nilai SLI | select\$1slo\$1health |
| Kepatuhan SLO | select\$1slo\$1compliance |
| SLO Kesalahan Anggaran Tersisa | select\$1slo\$1budget\$1fraction |
#### Pola alias untuk kueri SLO
Anda dapat menggunakan bidang Alias By untuk mengontrol format kunci legenda untuk kueri SLO.
| Pola alias | Deskripsi | Contoh hasil |
| --- | --- | --- |
| \$1\$1project\$1\$1 | Mengembalikan nama proyek GCP. | myProject |
| \$1\$1service\$1\$1 | Mengembalikan nama layanan. | myService |
| \$1\$1slo\$1\$1 | Mengembalikan SLO. | latency-slo |
| \$1\$1selector\$1\$1 | Mengembalikan pemilih. | select\$1slo\$1health |
#### Periode Penyelarasan dan pengelompokan berdasarkan waktu untuk kueri SLO
Kueri SLO menggunakan fungsionalitas periode penyelarasan yang sama dengan kueri metrik. Untuk informasi selengkapnya, lihat [Kueri metrik](#google-metric-queries).
## 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
Variabel dari jenis *Query* memungkinkan Anda untuk query Google Cloud Monitoring untuk berbagai jenis data. Plugin sumber data Google Cloud Monitoring menyediakan yang berikut ini`Query Types`.
| Nama | Deskripsi |
| --- | --- |
| Metric Types | Mengembalikan daftar nama jenis metrik yang tersedia untuk layanan tertentu. |
| Labels Keys | Mengembalikan daftar kunci untuk metric label dan resource label dalam metrik yang ditentukan. |
| Labels Values | Mengembalikan daftar nilai untuk label dalam metrik yang ditentukan. |
| Resource Types | Mengembalikan daftar jenis sumber daya untuk metrik tertentu. |
| Aggregations | Mengembalikan daftar agregasi (cross series reducer) untuk metrik yang ditentukan. |
| Aligners | Mengembalikan daftar aligner (per seri aligner) untuk metrik yang ditentukan. |
| Alignment periods | Mengembalikan daftar semua periode penyelarasan yang tersedia di editor kueri Google Cloud Monitoring di Grafana. |
| Selectors | Mengembalikan daftar pemilih yang dapat digunakan dalam pertanyaan SLO (Service Level Objectives). |
| SLO Services | Mengembalikan daftar layanan Pemantauan Layanan yang dapat digunakan dalam kueri SLO. |
| Service Level Objectives (SLO) | Mengembalikan daftar SLO untuk layanan SLO tertentu. |
### Menggunakan variabel dalam kueri
Ada dua sintaks:
+ `$`Contoh: `metric.label.$metric_label`
+ `[[varname]]`Contoh: `metric.label.[[metric_label]]`
Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Saat opsi *Multi-nilai* atau *Sertakan semua nilai* diaktifkan, Grafana mengonversi label dari teks biasa menjadi string yang kompatibel dengan regex, yang berarti Anda harus menggunakan sebagai gantinya. `=~` `=`
## Anotasi
Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Rendering anotasi mahal sehingga penting untuk membatasi jumlah baris yang dikembalikan. Belum ada dukungan untuk menampilkan anotasi dan acara Google Cloud Monitoring tetapi berfungsi dengan baik dengan [metrik khusus](https://cloud.google.com/monitoring/custom-metrics/) di Google Cloud Monitoring.
Untuk informasi selengkapnya tentang anotasi, lihat[Anotasi](dashboard-annotations.md).
Dengan editor kueri untuk anotasi, Anda dapat memilih metrik dan filter. Bidang **Judul** dan **Teks** mendukung templating dan dapat menggunakan data yang dikembalikan dari kueri. Misalnya, bidang Judul dapat memiliki teks berikut:
`{{metric.type}} has value: {{metric.value}}`
Contoh Hasil: `monitoring.googleapis.com/uptime_check/http_status has this value: 502`
### Pola untuk editor kueri anotasi
| Format pola alias | Deskripsi | Contoh pola alias | Contoh hasil |
| --- | --- | --- | --- |
| \$1\$1metric.value\$1\$1 | Nilai metrik/titik. | \$1\$1metric.value\$1\$1 | 555 |
| \$1\$1metric.type\$1\$1 | Mengembalikan Tipe Metrik penuh. | \$1\$1metric.type\$1\$1 | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | Mengembalikan bagian nama metrik. | \$1\$1metric.name\$1\$1 | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | Mengembalikan bagian layanan. | \$1\$1metric.service\$1\$1 | compute |
| \$1\$1metric.label.xxx\$1\$1 | Mengembalikan nilai label metrik. | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | Mengembalikan nilai label sumber daya. | \$1\$1resource.label.zone\$1\$1 | us-east1-b |
## Penautan mendalam dari panel Grafana ke Metrics Explorer di Google Cloud Console
**catatan**
Fitur ini hanya tersedia untuk kueri Metrik.
Pilih deret waktu di panel untuk melihat menu konteks dengan tautan ke Lihat di Metrics Explorer di Google Cloud Console. Memilih tautan itu membuka Metrics Explorer di Google Cloud Console dan menjalankan kueri dari panel Grafana di sana. Tautan menavigasi pengguna terlebih dahulu ke Pemilih Akun Google. Setelah berhasil memilih akun, pengguna dialihkan ke Metrics Explorer. Tautan yang disediakan berlaku untuk akun apa pun, tetapi hanya menampilkan kueri jika akun Anda memiliki akses ke proyek GCP yang ditentukan dalam kueri.
# Connect ke sumber data InfluxDB
Grafana dikirimkan dengan plugin sumber data kaya fitur untuk InfluxDB. Plugin ini mencakup editor kueri khusus dan mendukung anotasi dan templat kueri.
## Menambahkan sumber data
1. Buka menu samping dengan memilih ikon Grafana di header atas.
1. Di menu samping di bawah tautan, **Dasbor** Anda harus menemukan tautan bernama **Sumber Data**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. Pilih **InfluxDB** dari daftar **dropdown Type**.
1. **Pilih **InfluxQL** atau **Flux** dari daftar Bahasa Kueri.**
**catatan**
Jika Anda tidak melihat link **Sumber Data** di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki `Admin` peran.
# Connect ke sumber data Jaeger
Sumber data Jaeger menyediakan penelusuran terdistribusi sumber terbuka. end-to-end
## Menambahkan sumber data
**Untuk mengakses pengaturan Jaeger, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih Jaeger.**
| Nama | Deskripsi |
| --- | --- |
| Name | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| URL | URL dari contoh Jaeger; misalnya,. http://localhost:16686 |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data Jaeger. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
## Jejak kueri
Anda dapat menanyakan dan menampilkan jejak dari Jaeger melalui Jelajahi. Untuk informasi selengkapnya, lihat [Jelajahi](explore.md).
Editor kueri Jaeger memungkinkan Anda untuk menanyakan dengan melacak ID secara langsung atau memilih jejak dari pemilih jejak. Untuk melakukan kueri berdasarkan ID jejak, masukkan ID ke dalam input teks.
Gunakan pemilih jejak untuk memilih jejak tertentu dari semua jejak yang dicatat dalam rentang waktu yang telah Anda pilih di Jelajahi. Pemilih jejak memiliki tiga tingkat bersarang: 1. Layanan yang Anda minati. 1. Operasi khusus adalah bagian dari layanan yang dipilih. 1. Jejak spesifik di mana operasi yang dipilih terjadi, diwakili oleh nama operasi root dan durasi jejak.
## Menautkan ke ID jejak dari log
Anda dapat menautkan ke jejak Jaeger dari log di Loki dengan mengonfigurasi bidang turunan dengan tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields).
# Connect ke sumber data Loki
Sumber data Loki menyediakan akses ke Loki, sistem agregasi log Grafana.
## Menambahkan sumber data
1. Buka ruang kerja Grafana dan pastikan Anda masuk.
1. Di menu samping di bawah tautan **Konfigurasi** Anda harus menemukan tautan **Sumber Data**.
1. pilih tombol **Tambahkan sumber data** di bagian atas.
1. Pilih **Loki** dari daftar 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.
| Nama | Deskripsi |
| --- | --- |
| Name | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| URL | URL dari instance Loki; misalnya,http://localhost:3100. Ini bisa berupa URL untuk EC2 host Amazon, atau Application Load Balancer di depan kluster Amazon EKS, atau URL lain untuk instance Loki. |
| Maximum lines | Batas atas untuk jumlah baris log yang dikembalikan oleh Loki (default adalah 1000). Kurangi jika browser Anda lamban saat menampilkan log di Jelajahi. |
### Bidang turunan
Anda dapat menggunakan konfigurasi *bidang turunan* untuk melakukan hal berikut:
+ Tambahkan bidang yang diuraikan dari pesan log.
+ Tambahkan tautan yang menggunakan nilai bidang.
Anda dapat menggunakan fungsi ini untuk menautkan ke backend penelusuran langsung dari log Anda, atau menautkan ke halaman profil pengguna jika userID ada di baris log. Tautan ini muncul di detail log. Untuk informasi selengkapnya, lihat [Label dan bidang yang terdeteksi](explore.md#labels-and-detected-fields).
Setiap bidang turunan terdiri dari yang berikut:
+ **Nama** - Ditampilkan dalam rincian log sebagai label.
+ **Regex** — Pola Regex yang berjalan pada pesan log dan menangkap bagian darinya sebagai nilai bidang baru. Hanya dapat berisi satu grup tangkapan.
+ **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 apakah tautannya internal atau eksternal. Dalam hal tautan internal, pemilih sumber data memungkinkan Anda memilih sumber data target. Hanya melacak sumber data yang didukung.
Anda dapat menggunakan bagian debug untuk melihat apa yang diekstrak bidang Anda dan bagaimana URL diinterpolasi. pilih **Tampilkan pesan log contoh** untuk menampilkan area teks tempat Anda dapat memasukkan pesan log.
Bidang baru dengan tautan yang ditampilkan dalam detail log.
## Memeriksa log
Menanyakan dan menampilkan data log dari Loki tersedia melalui Jelajahi dan dengan panel log dalam visualisasi. Pilih sumber data Loki, lalu masukkan kueri LogQL untuk menampilkan log Anda. [Untuk informasi selengkapnya tentang LogQL, lihat LogQL.](https://grafana.com/docs/loki/latest/logql/)
### Kueri log
Kueri log terdiri dari dua bagian: **pemilih aliran log**, dan **ekspresi pencarian**. Untuk alasan kinerja, Anda harus mulai dengan memilih label log untuk aliran log.
Penjelajah **Log (tombol Log label**) di sebelah bidang kueri menunjukkan daftar label aliran log yang tersedia. Cara alternatif untuk menulis kueri adalah dengan menggunakan penyelesaian otomatis bidang kueri. Anda mulai dengan mengetik penjepit keriting kiri `{` dan menu pelengkapan otomatis akan menyarankan daftar label. Tekan tombol **Enter** untuk menjalankan kueri.
Setelah hasilnya dikembalikan, panel log menunjukkan daftar baris log dan bagan batang di mana sumbu x menunjukkan waktu dan sumbu y menunjukkan frekuensi/hitungan.
### Pemilih Aliran Log
Untuk bagian label dari ekspresi kueri, bungkus dalam kurung kurawal `{}` dan kemudian gunakan sintaks nilai kunci untuk memilih label. Beberapa ekspresi label dipisahkan oleh koma:
`{app="mysql",name="mysql-backup"}`
Operator pencocokan label berikut saat ini didukung:
+ `=`persis sama.
+ `!=`tidak sama.
+ `=~`pertandingan regex.
+ `!~`jangan regex-match.
Contoh:
+ `{name=~"mysql.+"}`
+ `{name!~"mysql.+"}`
Cara lain untuk menambahkan pemilih label adalah di bagian tabel. pilih **Filter** di samping label untuk menambahkan label ke ekspresi kueri. Ini bahkan berfungsi untuk beberapa kueri dan akan menambahkan pemilih label ke setiap kueri.
### Ekspresi pencarian
Setelah menulis Pemilih Aliran Log, Anda dapat memfilter hasil lebih lanjut dengan menulis ekspresi pencarian. Ekspresi pencarian bisa berupa teks atau ekspresi regex.
Contoh kueri:
+ `{job="mysql"} |= "error"`
+ `{name="kafka"} |~ "tsdb-ops.*io:2003"`
+ `{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"`
Operator filter dapat dirantai dan secara berurutan akan memfilter ekspresi. Garis log yang dihasilkan akan memenuhi setiap filter.
Contoh
`{job="mysql"} |= "error" != "timeout"`
Jenis filter berikut saat ini didukung:
+ `|=`baris berisi string.
+ `!=`baris tidak mengandung string.
+ `|~`garis cocok dengan ekspresi reguler.
+ `!~`garis tidak cocok dengan ekspresi reguler.
**catatan**
[Untuk informasi selengkapnya tentang LogQL, bahasa kueri Loki, lihat Loki LogQL.](https://grafana.com/docs/loki/latest/logql/)
## Konteks log
Saat menggunakan ekspresi penelusuran seperti yang dijelaskan di atas, Anda sekarang memiliki kemampuan untuk mengambil konteks seputar hasil yang difilter. Dengan memilih `Show Context` tautan pada baris yang difilter, Anda akan dapat menyelidiki pesan log yang datang sebelum dan sesudah pesan log yang Anda minati.
## Templating
Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. 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).
## Anotasi
Anda dapat menggunakan kueri Loki non-metrik apa pun sebagai sumber anotasi. Konten log akan digunakan sebagai teks anotasi dan label aliran log Anda sebagai tag, jadi tidak perlu pemetaan tambahan.
# Connect ke sumber data Microsoft SQL Server
Gunakan sumber data Microsoft SQL Server (MSSQL) untuk menanyakan dan memvisualisasikan data dari Microsoft SQL Server 2005 atau yang lebih baru, termasuk Microsoft Azure SQL Database.
**penting**
Grafana versi 8.0 mengubah struktur data yang mendasari untuk frame data untuk Microsoft SQL Server, Postgres, dan MySQL. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana.
Untuk membuat visualisasi Anda berfungsi seperti sebelumnya, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.
## Menambahkan sumber data
1. Buka menu samping dengan memilih ikon Grafana di header atas.
1. Di menu samping di bawah tautan, **Konfigurasi** Anda harus menemukan tautan **Sumber Data**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. Pilih **Microsoft SQL Server** dari **Type** daftar dropdown.
### Opsi sumber data
| 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. |
| Host | IP address/hostname dan port opsional instans MSSQL Anda. Jika port dihilangkan, default 1433 akan digunakan. |
| Database | Nama database MSSQL Anda. |
| User | Database pengguna login/nama pengguna. |
| Password | Kata sandi pengguna basis data. |
| Encrypt | Opsi ini menentukan apakah atau sejauh mana TCP/IP koneksi SSL yang aman akan dinegosiasikan dengan server, default (falseGrafana v5.4 \$1). |
| Max open | Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1). |
| Max idle | Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1). |
| Max lifetime | Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam. |
### Interval waktu min
Batas bawah untuk `$_interval` `$_interval_ms` variabel. 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 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 |
### Izin pengguna basis data
**penting**
Pengguna database yang Anda tentukan saat Anda menambahkan sumber data seharusnya hanya diberikan izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `DELETE FROM user;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna MSSQL tertentu dengan izin terbatas.
Kode contoh berikut menunjukkan pembuatan pengguna MSSQL tertentu dengan izin terbatas.
```
CREATE USER grafanareader WITH PASSWORD 'password'
GRANT SELECT ON dbo.YourTable3 TO grafanareader
```
Pastikan bahwa pengguna tidak mendapatkan izin yang tidak diinginkan dari peran publik.
### Masalah yang diketahui
Jika Anda menggunakan versi Microsoft SQL Server yang lebih lama seperti 2008 dan 2008R2, Anda mungkin perlu menonaktifkan enkripsi agar dapat terhubung. Jika memungkinkan, kami sarankan Anda untuk menggunakan paket layanan terbaru yang tersedia untuk kompatibilitas optimal.
## Editor kueri
Anda akan menemukan editor kueri MSSQL di tab metrik dalam mode edit grafik, Singlestat, atau panel tabel. Anda masuk ke mode edit dengan memilih judul panel dan kemudian memilih Edit. Editor memungkinkan Anda untuk menentukan query SQL untuk memilih data yang akan divisualisasikan.
1. Pilih *Format as* `Time series` (untuk digunakan dalam panel Grafik atau Singlestat antara lain) atau `Table` (untuk digunakan di panel Tabel antara lain).
1. Ini adalah editor aktual tempat Anda menulis kueri SQL Anda.
1. Tampilkan bagian bantuan untuk MSSQL di bawah editor kueri.
1. Tampilkan query SQL yang dijalankan. Akan tersedia terlebih dahulu setelah kueri yang berhasil dijalankan.
1. Tambahkan kueri tambahan di mana editor kueri tambahan akan ditampilkan.
## Makro
Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro.
| Contoh makro | Deskripsi |
| --- | --- |
| \$1\$1\$1time(dateColumn) | Akan diganti dengan ekspresi untuk mengganti nama kolom menjadi waktu. Misalnya, DateColumn sebagai waktu. |
| \$1\$1\$1timeEpoch(dateColumn) | Akan diganti dengan ekspresi untuk mengonversi tipe kolom DATETIME ke stempel waktu Unix dan mengganti namanya menjadi waktu. Misalnya, DATEDIFF (kedua, “1970-01-01", DateColumn) sebagai waktu. |
| \$1\$1\$1timeFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn ANTARA “2017-04-21T 05:01:17 Z” DAN “2017-04-21T 05:06:17 Z”. |
| \$1\$1\$1timeFrom() | Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, “2017-04-21T 05:01:17 Z”. |
| \$1\$1\$1timeTo() | Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, “2017-04-21T 05:06:17 Z”. |
| \$1\$1\$1timeGroup(dateColumn,'5m'[, fillvalue]) | Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Memberikan fillValue NULL atau nilai mengambang akan secara otomatis mengisi seri kosong dalam rentang waktu dengan nilai itu. Misalnya, CAST (ROUND (DATEDIFF (second, “1970-01-01", time\$1column) /300.0, 0) sebagai bigint) \$1300. |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | Sama seperti sebelumnya tetapi dengan parameter isian sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai. |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang. |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1). |
Editor kueri memiliki tautan **SQL yang Dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan.
## Kueri tabel
Jika opsi kueri diatur ke, **Format sebagai** **Tabel** maka pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda.
Kode contoh berikut menunjukkan tabel database.
```
CREATE TABLE [event] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
```
CREATE TABLE [mssql_types] (
c_bit bit, c_tinyint tinyint, c_smallint smallint, c_int int, c_bigint bigint, c_money money, c_smallmoney smallmoney, c_numeric numeric(10,5),
c_real real, c_decimal decimal(10,2), c_float float,
c_char char(10), c_varchar varchar(10), c_text text,
c_nchar nchar(12), c_nvarchar nvarchar(12), c_ntext ntext,
c_datetime datetime, c_datetime2 datetime2, c_smalldatetime smalldatetime, c_date date, c_time time, c_datetimeoffset datetimeoffset
)
INSERT INTO [mssql_types]
SELECT
1, 5, 20020, 980300, 1420070400, '$20000.15', '£2.15', 12345.12,
1.11, 2.22, 3.33,
'char10', 'varchar10', 'text',
N'☺nchar12☺', N'☺nvarchar12☺', N'☺text☺',
GETDATE(), CAST(GETDATE() AS DATETIME2), CAST(GETDATE() AS SMALLDATETIME), CAST(GETDATE() AS DATE), CAST(GETDATE() AS TIME), SWITCHOFFSET(CAST(GETDATE() AS DATETIMEOFFSET), '-07:00')
```
Contoh kode berikut menunjukkan query.
```
SELECT * FROM [mssql_types]
```
Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `AS` SQL biasa, seperti yang ditunjukkan dalam kode contoh berikut.
```
SELECT
c_bit as [column1], c_tinyint as [column2]
FROM
[mssql_types]
```
Panel tabel yang dihasilkan:
## Pertanyaan deret waktu
Jika Anda menyetel **Format sebagai** **deret Waktu**, untuk digunakan dalam panel Grafik misalnya, kueri harus memiliki kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik apa pun yang mewakili epoch Unix dalam hitungan detik. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Jika Anda menghilangkan `metric` kolom, nama kolom nilai akan menjadi nama metrik. Anda dapat memilih beberapa kolom nilai, masing-masing akan memiliki namanya sebagai metrik. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama `metric` maka kolom ini digunakan sebagai awalan untuk nama seri.
Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu.
Kode contoh berikut menunjukkan tabel database.
```
CREATE TABLE [event] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
```
CREATE TABLE metric_values (
time datetime,
measurement nvarchar(100),
valueOne int,
valueTwo int,
)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric A', 62, 6)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 12:30:00', 'Metric B', 49, 11)
...
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric A', 14, 25)
INSERT metric_values (time, measurement, valueOne, valueTwo) VALUES('2018-03-15 13:55:00', 'Metric B', 48, 10)
```
Kode contoh berikut menunjukkan satu `value` dan satu `metric` kolom.
```
SELECT
time,
valueOne,
measurement as metric
FROM
metric_values
WHERE
$__timeFilter(time)
ORDER BY 1
```
Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time`
Kode contoh berikut menunjukkan beberapa `value` kolom.
```
SELECT
time,
valueOne,
valueTwo
FROM
metric_values
WHERE
$__timeFilter(time)
ORDER BY 1
```
Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time`
Kode contoh berikut menunjukkan menggunakan makro \$1\$1\$1TimeGroup.
```
SELECT
$__timeGroup(time, '3m') as time,
measurement as metric,
avg(valueOne)
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '3m'),
measurement
ORDER BY 1
```
Ketika query sebelumnya digunakan dalam panel grafik, itu akan menghasilkan dua seri bernama `Metric A` dan `Metric B` dengan nilai-nilai `valueOne` dan `valueTwo` diplot di atas. `time` Setiap dua seri yang tidak memiliki nilai dalam jendela tiga menit akan membuat garis di antara dua garis tersebut. Anda akan melihat bahwa grafik di sebelah kanan tidak pernah turun ke nol.
Kode contoh berikut menunjukkan menggunakan makro \$1\$1\$1TimeGroup dengan parameter fill diatur ke nol.
```
SELECT
$__timeGroup(time, '3m', 0) as time,
measurement as metric,
sum(valueTwo)
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '3m'),
measurement
ORDER BY 1
```
Ketika kueri ini digunakan dalam panel grafik, hasilnya adalah dua seri bernama `Metric A` dan `Metric B` dengan jumlah `valueTwo` diplot di atas. `time` Setiap seri yang tidak memiliki nilai dalam jendela 3 menit akan memiliki nilai nol yang akan Anda lihat dirender dalam grafik di sebelah kanan.
## 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
Jika Anda menambahkan variabel templat dari jenisnya`Query`, Anda dapat menulis kueri MSSQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun.
Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template.
```
SELECT hostname FROM host
```
Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`.
```
SELECT [host].[hostname], [other_host].[hostname2] FROM host JOIN other_host ON [host].[city] = [other_host].[city]
```
Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik maka nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai yang memungkinkan Anda memiliki nama ramah sebagai teks dan id sebagai nilainya. Contoh query dengan `hostname` sebagai teks dan `id` sebagai nilai:
```
SELECT hostname __text, id __value FROM host
```
Anda juga dapat membuat variabel bersarang. Misalnya, jika Anda memiliki variabel lain bernama`region`. Kemudian Anda dapat meminta variabel host hanya menampilkan host dari wilayah yang dipilih saat ini dengan kueri seperti ini (jika `region` adalah variabel multi-nilai, maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai).
```
SELECT hostname FROM host WHERE region IN ($region)
```
### Menggunakan variabel dalam kueri
**catatan**
Nilai variabel template hanya dikutip ketika variabel template adalah`multi-value`.
Jika variabel adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai.
Ada dua sintaks:
`$`Contoh dengan variabel template bernama`hostname`:
```
SELECT
atimestamp time,
aint value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp
```
`[[varname]]`Contoh dengan variabel template bernama`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp
```
#### Mematikan kutipan untuk variabel multi-nilai
Grafana secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya, jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel.
`${servers:csv}`
Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Template dan variabel](templates-and-variables.md).
## Anotasi
Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).
**Kolom:**
| Nama | Deskripsi |
| --- | --- |
| time | Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| timeend | Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| text | Bidang deskripsi acara. |
| tags | Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string dipisahkan koma. |
Kode contoh berikut menunjukkan tabel database.
```
CREATE TABLE [events] (
time_sec bigint,
description nvarchar(100),
tags nvarchar(100),
)
```
Kami juga menggunakan tabel database yang didefinisikan dalam[Pertanyaan deret waktu](#mssql-time-series-queries).
Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch.
```
SELECT
time_sec as time,
description as [text],
tags
FROM
[events]
WHERE
$__unixEpochFilter(time_sec)
ORDER BY 1
```
Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch.
```
SELECT
time_sec as time,
time_end_sec as timeend,
description as [text],
tags
FROM
[events]
WHERE
$__unixEpochFilter(time_sec)
ORDER BY 1
```
Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli.
```
SELECT
time,
measurement as text,
convert(varchar, valueOne) + ',' + convert(varchar, valueTwo) as tags
FROM
metric_values
WHERE
$__timeFilter(time_column)
ORDER BY 1
```
## Dukungan prosedur tersimpan
Prosedur yang disimpan telah diverifikasi untuk bekerja. Namun, mungkin ada kasus tepi di mana itu tidak akan berfungsi seperti yang Anda harapkan. Prosedur tersimpan harus didukung dalam tabel, deret waktu, dan kueri anotasi selama Anda menggunakan penamaan kolom yang sama dan mengembalikan data dalam format yang sama seperti yang dijelaskan sebelumnya di bagian masing-masing.
Fungsi makro tidak akan berfungsi di dalam prosedur yang disimpan.
### Contoh
Untuk contoh berikut, tabel database didefinisikan dalam Query deret Time. Katakanlah Anda ingin memvisualisasikan empat seri dalam panel grafik, seperti semua kombinasi kolom`valueOne`, `valueTwo` dan`measurement`. Panel grafik di sebelah kanan memvisualisasikan apa yang ingin kita capai. Untuk mengatasi ini, Anda harus menggunakan dua kueri:
Kode contoh berikut menunjukkan query pertama.
```
SELECT
$__timeGroup(time, '5m') as time,
measurement + ' - value one' as metric,
avg(valueOne) as valueOne
FROM
metric_values
WHERE
$__timeFilter(time)
GROUP BY
$__timeGroup(time, '5m'),
measurement
ORDER BY 1
```
Kode contoh berikut menunjukkan query kedua.
```
SELECT
$__timeGroup(time, '5m') as time,
measurement + ' - value two' as metric,
avg(valueTwo) as valueTwo
FROM
metric_values
GROUP BY
$__timeGroup(time, '5m'),
measurement
ORDER BY 1
```
#### Prosedur tersimpan menggunakan waktu dalam format epoch
Anda dapat menentukan prosedur tersimpan yang akan mengembalikan semua data yang Anda butuhkan untuk membuat empat seri dalam panel grafik seperti di atas. Dalam hal ini, prosedur yang disimpan menerima dua parameter, `@from` dan`@to`, dari tipe `int` data, yang harus berupa rentang waktu (dari-ke) dalam format epoch yang akan digunakan untuk menyaring data untuk kembali dari prosedur yang disimpan.
Ini meniru ekspresi `$__timeGroup(time, '5m')` dalam pilih dan kelompokkan, dan itulah sebabnya banyak ekspresi panjang diperlukan. Ini dapat diekstraksi ke fungsi MSSQL, jika diinginkan.
```
CREATE PROCEDURE sp_test_epoch(
@from int,
@to int
) AS
BEGIN
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
measurement + ' - value one' as metric,
avg(valueOne) as value
FROM
metric_values
WHERE
time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
measurement
UNION ALL
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int) as time,
measurement + ' - value two' as metric,
avg(valueTwo) as value
FROM
metric_values
WHERE
time >= DATEADD(s, @from, '1970-01-01') AND time <= DATEADD(s, @to, '1970-01-01')
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, DATEADD(second, DATEDIFF(second,GETDATE(),GETUTCDATE()), time))/600 as int)*600 as int),
measurement
ORDER BY 1
END
```
Kemudian Anda dapat menggunakan kueri berikut untuk panel grafik Anda.
```
DECLARE
@from int = $__unixEpochFrom(),
@to int = $__unixEpochTo()
EXEC dbo.sp_test_epoch @from, @to
```
#### Prosedur tersimpan menggunakan waktu dalam format datetime
Anda dapat menentukan prosedur tersimpan yang akan mengembalikan semua data yang Anda butuhkan untuk membuat empat seri dalam panel grafik seperti di atas. Dalam hal ini, prosedur yang disimpan menerima dua parameter, `@from` dan`@to`, dari tipe `datetime` data, yang harus berupa rentang waktu (dari-ke) yang akan digunakan untuk memfilter data untuk kembali dari prosedur yang disimpan.
Ini meniru ekspresi `$__timeGroup(time, '5m')` dalam pilih dan kelompokkan, dan itulah sebabnya banyak ekspresi panjang diperlukan. Ini dapat diekstraksi ke fungsi MSSQL, jika diinginkan.
```
CREATE PROCEDURE sp_test_datetime(
@from datetime,
@to datetime
) AS
BEGIN
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
measurement + ' - value one' as metric,
avg(valueOne) as value
FROM
metric_values
WHERE
time >= @from AND time <= @to
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
measurement
UNION ALL
SELECT
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int) as time,
measurement + ' - value two' as metric,
avg(valueTwo) as value
FROM
metric_values
WHERE
time >= @from AND time <= @to
GROUP BY
cast(cast(DATEDIFF(second, {d '1970-01-01'}, time)/600 as int)*600 as int),
measurement
ORDER BY 1
END
```
Kemudian Anda dapat menggunakan kueri berikut untuk panel grafik Anda.
```
DECLARE
@from datetime = $__timeFrom(),
@to datetime = $__timeTo()
EXEC dbo.sp_test_datetime @from, @to
```
## Peringatan
Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan.
# Connect ke sumber data MySQL
Tambahkan sumber data MySQL untuk dapat menanyakan dan memvisualisasikan data dari database yang kompatibel dengan MySQL.
**penting**
Grafana versi 8.0 mengubah struktur data yang mendasari untuk frame data untuk sumber data MySQL, Postgres, dan Microsoft SQL Server. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana.
Untuk membuat visualisasi Anda berfungsi seperti sebelumnya, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.
## Menambahkan sumber data
1. Buka menu samping dengan memilih ikon Grafana di header atas.
1. Di menu samping di bawah tautan **Dasbor**, Anda harus menemukan tautan bernama **Sumber Data**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. Pilih **MySQL** dari daftar dropdown Type**.**
### Opsi sumber data
| 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. |
| Host | IP address/hostname dan port opsional dari instance MySQL Anda. |
| Database | Nama database MySQL Anda. |
| User | Login/nama pengguna database pengguna. |
| Password | Kata sandi pengguna basis data. |
| Max open | Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1). |
| Max idle | Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1). |
| Max lifetime | Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam. Ini harus selalu lebih rendah dari [wait\$1timeout](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_wait_timeout) yang dikonfigurasi di MySQL (Grafana v5.4\$1). |
### Interval waktu min
Batas bawah untuk `$_interval` `$_interval_ms` variabel. 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 |
### Izin pengguna basis data
**penting**
Pengguna database yang Anda tentukan saat Anda menambahkan sumber data harus diberikan hanya izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `USE otherdb;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna MySQL tertentu dengan izin terbatas.
Contoh kode berikut menunjukkan membuat pengguna MySQL tertentu dengan izin terbatas.
```
CREATE USER 'grafanaReader' IDENTIFIED BY 'password';
GRANT SELECT ON mydatabase.mytable TO 'grafanaReader';
```
Untuk memberikan akses ke lebih banyak database dan tabel, Anda dapat menggunakan karakter wildcard (`*`) sebagai pengganti database atau tabel jika Anda mau.
## Editor kueri
Anda menemukan editor kueri MySQL di tab metrik dalam mode edit panel. Anda masuk ke mode edit dengan memilih judul panel, lalu **Edit**.
Editor kueri memiliki tautan **SQL yang dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan.
### Pilih tabel, kolom waktu, dan kolom metrik (DARI)
Saat Anda memasuki mode edit untuk pertama kalinya atau menambahkan kueri baru, Grafana akan mencoba mengisi ulang pembuat kueri dengan tabel pertama yang memiliki kolom stempel waktu dan kolom numerik.
Di bidang FROM, Grafana akan menyarankan tabel yang ada di database yang dikonfigurasi. Untuk memilih tabel atau tampilan di database lain yang dapat diakses oleh pengguna database Anda, Anda dapat memasukkan nama yang memenuhi syarat secara manual (database.table) seperti. `otherDb.metrics`
Kolom kolom Waktu mengacu pada nama kolom yang memegang nilai waktu Anda. Memilih nilai untuk bidang kolom Metrik adalah opsional. Jika nilai dipilih, bidang kolom Metrik akan digunakan sebagai nama seri.
Saran kolom metrik hanya akan berisi kolom dengan tipe data teks (teks, tinytext, mediumtext, longtext, varchar, char). Jika Anda ingin menggunakan kolom dengan tipe data yang berbeda sebagai kolom metrik, Anda dapat memasukkan nama kolom dengan pemeran:`CAST(numericColumn as CHAR)`. Anda juga dapat memasukkan ekspresi SQL arbitrer di bidang kolom metrik yang mengevaluasi tipe data teks seperti. `CONCAT(column1, " ", CAST(numericColumn as CHAR))`
### Kolom dan fungsi agregasi (SELECT)
Di `SELECT` baris, Anda dapat menentukan kolom dan fungsi apa yang ingin Anda gunakan. Di kolom kolom, Anda dapat menulis ekspresi arbitrer alih-alih nama kolom seperti`column1 * column2 / column3`.
Jika Anda menggunakan fungsi agregat, Anda harus mengelompokkan set hasil Anda. Editor akan secara otomatis menambahkan `GROUP BY time` jika Anda menambahkan fungsi agregat.
Anda dapat menambahkan kolom nilai lebih lanjut dengan memilih tombol plus dan memilih `Column` dari menu. Beberapa kolom nilai akan diplot sebagai seri terpisah di panel grafik.
### Data penyaringan (WHERE)
Untuk menambahkan filter, pilih ikon plus di sebelah kanan `WHERE` kondisi. Anda dapat menghapus filter dengan memilih pada filter dan memilih`Remove`. Filter untuk rentang waktu yang dipilih saat ini secara otomatis ditambahkan ke kueri baru.
### Grup Oleh
Untuk mengelompokkan berdasarkan waktu atau kolom lainnya, pilih ikon plus di akhir baris GROUP BY. Daftar tarik-turun saran hanya akan menampilkan kolom teks dari tabel yang Anda pilih saat ini tetapi Anda dapat memasukkan kolom apa pun secara manual. Anda dapat menghapus grup dengan memilih item dan kemudian memilih`Remove`.
Jika Anda menambahkan pengelompokan apa pun, semua kolom yang dipilih harus memiliki fungsi agregat yang diterapkan. Pembuat kueri akan secara otomatis menambahkan fungsi agregat ke semua kolom tanpa fungsi agregat saat Anda menambahkan pengelompokan.
#### Pengisian celah
Grafana dapat mengisi nilai yang hilang saat Anda mengelompokkan berdasarkan waktu. Fungsi waktu menerima dua argumen. Argumen pertama adalah jendela waktu yang ingin Anda kelompokkan, dan argumen kedua adalah nilai yang Anda inginkan Grafana untuk mengisi item yang hilang.
### Mode editor teks (mentah)
Anda dapat beralih ke mode editor kueri mentah dengan memilih ikon hamburger dan memilih **mode Switch editor** atau dengan memilih **Edit SQL** di bawah kueri.
**catatan**
Jika Anda menggunakan editor kueri mentah, pastikan kueri Anda setidaknya memiliki `ORDER BY time` dan filter pada rentang waktu yang dikembalikan.
## Makro
Untuk menyederhanakan sintaks dan memungkinkan bagian dinamis, seperti filter rentang tanggal, kueri dapat berisi makro.
| Contoh makro | Deskripsi |
| --- | --- |
| \$1\$1\$1time(dateColumn) | Akan diganti dengan ekspresi untuk dikonversi ke stempel waktu UNIX dan mengganti nama kolom menjaditime\$1sec; misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. |
| \$1\$1\$1timeEpoch(dateColumn) | Akan diganti dengan ekspresi untuk dikonversi ke stempel waktu UNIX dan mengganti nama kolom menjaditime\$1sec; misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. |
| \$1\$1\$1timeFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn BETWEEN FROM\$1UNIXTIME (1494410783) DAN FROM\$1UNIXTIME (1494410983). |
| \$1\$1\$1timeFrom() | Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410783). |
| \$1\$1\$1timeTo() | Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410983). |
| \$1\$1\$1timeGroup(dateColumn,'5m') | Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Misalnya, cast (cast (UNIX\$1TIMESTAMP (DateColumn)/(300) sebagai ditandatangani) 300 sebagai ditandatangani), \$1 |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | Sama seperti baris sebelumnya, tetapi dengan parameter isian sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai. |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang. |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1). |
| \$1\$1\$1timeGroupAlias(dateColumn,'5m') | Akan diganti identik dengan \$1\$1\$1timeGroup tetapi dengan alias kolom tambahan (hanya tersedia di Grafana 5.3\$1). |
| \$1\$1\$1unixEpochFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix. Misalnya, dateColumn > 1494410783 AND dateColumn < 1494497183. |
| \$1\$1\$1unixEpochFrom() | Akan diganti dengan dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, 1494410783. |
| \$1\$1\$1unixEpochTo() | Akan diganti dengan akhir pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, 1494497183. |
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu nanodetik. Misalnya, dateColumn > 1494410783152415214 AND dateColumn < 1494497183142514872. |
| \$1\$1\$1unixEpochNanoFrom() | Akan digantikan oleh dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, 1494410783152415214. |
| \$1\$1\$1unixEpochNanoTo() | Akan diganti pada akhir pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, 1494497183142514872. |
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | Sama seperti \$1\$1\$1timeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix (hanya tersedia di Grafana 5.3\$1). |
| \$1\$1\$1unixEpochGroupAlias(dateColumn,"5m", [fillmode])` | Sama seperti di atas tetapi juga menambahkan alias kolom (hanya tersedia di Grafana 5.3\$1). |
Editor kueri memiliki tautan **SQL yang Dihasilkan** yang muncul setelah kueri berjalan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan.
## Kueri tabel
Jika opsi **Format sebagai** kueri diatur ke **Tabel**, pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda.
Kode berikut menunjukkan contoh query.
```
SELECT
title as 'Title',
user.login as 'Created By' ,
dashboard.created as 'Created On'
FROM dashboard
INNER JOIN user on user.id = dashboard.created_by
WHERE $__timeFilter(dashboard.created)
```
Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `as` SQL biasa.
## Pertanyaan deret waktu
Jika Anda menetapkan **Format sebagai** **deret Waktu**, untuk digunakan dalam panel grafik misalnya, kueri harus mengembalikan kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik yang mewakili epoch Unix. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama`metric`, kolom ini digunakan sebagai awalan untuk nama seri (hanya tersedia di Grafana 5.3\$1).
Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu.
Contoh kode berikut menunjukkan `metric` kolom.
```
SELECT
$__timeGroup(time_date_time,'5m'),
min(value_double),
'min' as metric
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```
Contoh kode berikut menunjukkan menggunakan parameter fill di \$1\$1\$1timeGroup makro untuk mengkonversi nilai null menjadi nol sebagai gantinya.
```
SELECT
$__timeGroup(createdAt,'5m',0),
sum(value_double) as value,
measurement
FROM test_data
WHERE
$__timeFilter(createdAt)
GROUP BY time, measurement
ORDER BY time
```
Contoh kode berikut menunjukkan beberapa kolom.
```
SELECT
$__timeGroup(time_date_time,'5m'),
min(value_double) as min_value,
max(value_double) as max_value
FROM test_data
WHERE $__timeFilter(time_date_time)
GROUP BY time
ORDER BY time
```
Tidak ada dukungan untuk grup dinamis berdasarkan waktu berdasarkan rentang waktu dan lebar panel.
## Templating
Alih-alih 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](templates-and-variables.md#templates).
### Variabel kueri
Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri MySQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun.
Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template.
```
SELECT hostname FROM my_host
```
Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`.
```
SELECT my_host.hostname, my_other_host.hostname2 FROM my_host JOIN my_other_host ON my_host.city = my_other_host.city
```
Untuk menggunakan makro yang bergantung pada rentang waktu seperti `$__timeFilter(column)` dalam kueri Anda, mode penyegaran variabel template harus disetel ke *On Time Range Change*.
```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```
Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik, nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai sehingga Anda dapat memiliki nama ramah sebagai teks dan ID sebagai nilainya.
Contoh kode berikut menunjukkan query dengan `hostname` sebagai teks dan `id` sebagai nilai.
```
SELECT hostname AS __text, id AS __value FROM my_host
```
Anda juga dapat membuat variabel bersarang. Misalnya, jika Anda memiliki variabel lain bernama`region`. Kemudian Anda dapat meminta variabel host hanya menampilkan host dari wilayah yang dipilih saat ini dengan kueri seperti ini (jika `region` adalah variabel multi-nilai maka gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai).
```
SELECT hostname FROM my_host WHERE region IN($region)
```
#### Menggunakan `__searchFilter` untuk memfilter hasil dalam Variabel Kueri
Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan jenis pengguna di kotak pilih dropdown. Ketika tidak ada yang dimasukkan oleh pengguna, nilai default untuk `__searchFilter` adalah`%`.
**catatan**
Penting bahwa Anda mengelilingi `__searchFilter` ekspresi dengan tanda kutip karena Grafana tidak melakukan ini untuk Anda.
Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `hostname` sementara pengguna mengetik di kotak pilih dropdown.
```
SELECT hostname FROM my_host WHERE hostname LIKE '$__searchFilter'
```
### Menggunakan variabel dalam kueri
Dari Grafana 4.3.0 hingga 4.6.0, variabel template selalu dikutip secara otomatis sehingga jika itu adalah nilai string jangan membungkusnya dalam tanda kutip di klausa where.
Dari Grafana 4.7.0, nilai variabel template hanya dikutip jika variabel template adalah a. `multi-value`
Jika variabel adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai.
Ada dua sintaks:
`$`Contoh dengan variabel template bernama`hostname`:
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]`Contoh dengan variabel template bernama`hostname`:
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### Mematikan kutipan untuk variabel multi-nilai
Grafana secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya: jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel.
`${servers:csv}`
Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Opsi format variabel lanjutan](templates-and-variables.md#advanced-variable-format-options).
## Anotasi
Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat .
Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch.
```
SELECT
epoch_time as time,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch.
**catatan**
Hanya tersedia di Grafana v6.6\$1.
```
SELECT
epoch_time as time,
epoch_timeend as timeend,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli.
```
SELECT
native_date_time as time,
metric1 as text,
CONCAT(tag1, ',', tag2) as tags
FROM
public.test_data
WHERE
$__timeFilter(native_date_time)
```
| Nama | Deskripsi |
| --- | --- |
| time | Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| timeend | Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| text | Bidang deskripsi acara. |
| tags | Nama bidang opsional yang akan digunakan untuk tag peristiwa sebagai string yang dipisahkan koma. |
## Peringatan
Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan.
# 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.
# Connect ke sumber data OpenTSDB
Grafana yang Dikelola Amazon dikirimkan dengan dukungan lanjutan untuk OpenTSDB.
## Menambahkan sumber data
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**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. Pilih **OpenTSDB** 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 server opentsdb Anda (port default biasanya 4242). |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Version | Versi = versi opentsdb, baik <=2.1 atau 2.2. |
| Resolution | Metrik dari opentsdb dapat memiliki titik data dengan resolusi kedua atau milidetik. |
## Editor kueri
Buka grafik dalam mode edit dengan memilih judul. Editor kueri akan berbeda jika sumber data memiliki versi <=2.1 atau = 2.2. Dalam versi sebelumnya, hanya tag yang dapat digunakan untuk kueri OpenTSDB. Tetapi dalam versi yang terakhir, filter serta tag dapat digunakan untuk menanyakan opentsdb. Kebijakan Isi juga diperkenalkan di OpenTSDB 2.2.
**catatan**
Saat menggunakan sumber data OpenTSDB 2.2, pastikan Anda menggunakan Filter atau Tag karena keduanya saling eksklusif. Jika digunakan bersama, mungkin memberi Anda hasil yang aneh.
### Menggunakan saran pelengkapan otomatis
Segera setelah Anda mulai mengetik nama metrik, nama tag, dan nilai tag, Anda akan melihat saran lengkap otomatis yang disorot untuknya. Pelengkapan otomatis hanya berfungsi jika API saran OpenTSDB diaktifkan.
## Kueri template
Alih-alih 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 OpenTSDB mendukung kueri variabel template. Ini berarti Anda dapat membuat variabel template yang mengambil nilai dari OpenTSDB. Misalnya, nama metrik, nama tag, atau nilai tag.
Saat menggunakan OpenTSDB dengan variabel template `query` tipe Anda dapat menggunakan sintaks berikut untuk pencarian.
| Kueri | Deskripsi |
| --- | --- |
| metrics(prefix) | Mengembalikan nama metrik dengan awalan tertentu (bisa kosong). |
| tag\$1names(cpu) | Mengembalikan nama tag (yaitu, kunci) untuk metrik cpu tertentu. |
| tag\$1values(cpu, hostname) | Mengembalikan nilai tag untuk cpu metrik dan nama host kunci tag. |
| suggest\$1tagk(prefix) | Mengembalikan nama tag (yaitu, kunci) untuk semua metrik dengan awalan tertentu (bisa kosong). |
| suggest\$1tagv(prefix) | Mengembalikan nilai tag untuk semua metrik dengan awalan tertentu (bisa kosong). |
Jika Anda tidak melihat variabel template yang diisi di `Preview of values` bagian, Anda harus mengaktifkan `tsd.core.meta.enable_realtime_ts` dalam pengaturan server OpenTSDB. Juga, untuk mengisi metadata data deret waktu yang ada di OpenTSDB, Anda harus berjalan `tsdb uid metasync` di server OpenTSDB.
### Templating bersarang
Satu variabel template dapat digunakan untuk memfilter nilai tag untuk variabel template lain. Parameter pertama adalah nama metrik, parameter kedua adalah kunci tag yang Anda butuhkan untuk menemukan nilai tag, dan setelah itu semua variabel template dependen lainnya. Beberapa contoh disebutkan di bawah ini untuk membuat kueri template bersarang bekerja dengan sukses.
| Kueri | Deskripsi |
| --- | --- |
| tag\$1values(cpu, hostname, env=\$1env) | Mengembalikan nilai tag untuk metrik cpu, nilai tag env yang dipilih, dan nama host kunci tag. |
| tag\$1values(cpu, hostname, env=\$1env, region=\$1region) | Mengembalikan nilai tag untuk metrik cpu, nilai tag env yang dipilih, nilai tag wilayah yang dipilih, dan nama host kunci tag. |
[Untuk informasi selengkapnya tentang kueri metrik OpenTSDB, lihat dokumentasi OpenTSDB](https://opentsdb.net/docs/build/html/index.html)
# Connect ke sumber data PostgreSQL
Anda dapat menggunakan sumber data PostgreSQL untuk menanyakan dan memvisualisasikan data dari database Amazon Aurora PostgreSQL Anda.
**penting**
*Grafana versi 8* mengubah struktur data yang mendasari frame data untuk sumber data Postgres, MySQL, dan Microsoft SQL Server. Akibatnya, hasil kueri deret waktu dikembalikan dalam format lebar. Untuk informasi selengkapnya, lihat [Format lebar](https://grafana.com/developers/plugin-tools/introduction/data-frames#wide-format) dalam dokumentasi bingkai data Grafana. Untuk membuat visualisasi Anda berfungsi seperti sebelum versi 8, Anda mungkin harus melakukan beberapa migrasi manual. Salah satu solusi didokumentasikan di Github di [Postgres/MySQL/MSSQL: Memecahkan perubahan di v8.0 terkait dengan kueri deret waktu dan](https://github.com/grafana/grafana/issues/35534) urutan kolom data.
Di *Grafana versi 9*, sumber data PostgreSQL menyiapkan sertifikat root untuk menghubungkan ke database Anda secara berbeda dari versi sebelumnya. Jika Anda memperbarui ruang kerja dari versi 8 ke 9, Anda mungkin perlu mengubah cara Anda terhubung. Untuk informasi selengkapnya, lihat [Memecahkan masalah dengan ruang kerja yang diperbarui](AMG-workspace-version-update-troubleshoot.md).
## Menambahkan sumber data
1. Buka menu samping dengan memilih ikon Grafana di header atas.
1. Di menu samping di bawah ikon **Konfigurasi**, Anda harus menemukan tautan **Sumber Data**.
1. Pilih tombol **\$1 Tambahkan sumber data** di header atas.
1. **Pilih **PostgreSQL** dari daftar dropdown Type.**
### Opsi sumber data
| 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. |
| Host | IP address/hostname dan port opsional instance PostgreSQL Anda. Jangan sertakan nama database. String koneksi untuk menghubungkan ke Postgres tidak akan benar dan akan menyebabkan kesalahan. |
| Database | Nama database PostgreSQL Anda. |
| User | Database pengguna login/nama pengguna. |
| Password | Kata sandi pengguna basis data |
| SSL Mode | Opsi ini menentukan apakah atau dengan prioritas apa TCP/IP koneksi SSL aman akan dinegosiasikan dengan server. |
| Max open | Jumlah maksimum koneksi terbuka ke database, default unlimited (Grafana v5.4\$1). |
| Max idle | Jumlah maksimum koneksi di kolam koneksi idle, default 2 (Grafana v5.4\$1). |
| Max lifetime | Jumlah maksimum waktu dalam hitungan detik koneksi dapat digunakan kembali, default 14400 /4 jam (Grafana v5.4\$1). |
| Version | Opsi ini menentukan fungsi mana yang tersedia di pembuat kueri (hanya tersedia di Grafana 5.3\$1). |
| TimescaleDB | TimescaleDB adalah database deret waktu yang dibangun sebagai ekstensi PostgreSQL. Jika diaktifkan, Grafana akan digunakan time\$1bucket di \$1\$1\$1timeGroup makro dan menampilkan fungsi agregat spesifik TimescaleDB di pembuat kueri (hanya tersedia di Grafana 5.3\$1). |
### Interval waktu min
Batas bawah untuk `$_interval` `$_interval_ms` variabel. 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 |
### Izin pengguna basis data
**penting**
Pengguna database yang Anda tentukan saat Anda menambahkan sumber data seharusnya hanya diberikan izin SELECT pada database dan tabel tertentu yang ingin Anda kueri. Grafana tidak memvalidasi bahwa kueri aman. Kueri dapat mencakup pernyataan SQL apa pun. Misalnya, pernyataan seperti `DELETE FROM user;` dan `DROP TABLE user;` akan dijalankan. Untuk melindungi dari hal ini, kami sangat menyarankan Anda membuat pengguna PostgreSQL tertentu dengan izin terbatas.
Kode contoh berikut menunjukkan pembuatan pengguna PostgreSQL specifice dengan izin terbatas.
```
CREATE USER grafanareader WITH PASSWORD 'password';
GRANT USAGE ON SCHEMA schema TO grafanareader;
GRANT SELECT ON schema.table TO grafanareader;
```
Pastikan bahwa pengguna tidak mendapatkan izin yang tidak diinginkan dari peran publik.
## Editor kueri
Anda menemukan editor kueri PostgreSQL di tab metrik di Graph atau mode edit panel Singlestat. Anda masuk ke mode edit dengan memilih judul panel, lalu edit.
Editor kueri memiliki tautan **SQL yang dihasilkan** yang muncul setelah kueri dijalankan, saat dalam mode edit panel. Pilih itu, dan itu akan memperluas dan menampilkan string SQL interpolasi mentah yang dijalankan.
### Pilih tabel, kolom waktu, dan kolom metrik (DARI)
Saat Anda memasuki mode edit untuk pertama kalinya atau menambahkan kueri baru, Grafana akan mencoba mengisi ulang pembuat kueri dengan tabel pertama yang memiliki kolom stempel waktu dan kolom numerik.
Di bidang FROM, Grafana akan menyarankan tabel yang ada di `search_path` pengguna database. Untuk memilih tabel atau tampilan yang tidak ada di Anda, `search_path` Anda dapat memasukkan nama yang sepenuhnya memenuhi syarat (schema.table) secara manual seperti. `public.metrics`
Kolom kolom Waktu mengacu pada nama kolom yang memegang nilai waktu Anda. Memilih nilai untuk bidang kolom Metrik adalah opsional. Jika nilai dipilih, bidang kolom Metrik akan digunakan sebagai nama seri.
Saran kolom metrik hanya akan berisi kolom dengan tipe data teks (char, varchar, text). Untuk menggunakan kolom dengan tipe data yang berbeda sebagai kolom metrik, Anda dapat memasukkan nama kolom dengan pemeran:`ip::text`. Anda juga dapat memasukkan ekspresi SQL arbitrer di bidang kolom metrik yang mengevaluasi tipe data teks seperti. `hostname || ' ' || container_name`
### Kolom, jendela, dan fungsi agregasi (SELECT)
Di `SELECT` baris, Anda dapat menentukan kolom dan fungsi apa yang ingin Anda gunakan. Di kolom kolom, Anda dapat menulis ekspresi arbitrer alih-alih nama kolom seperti`column1 * column2 / column3`.
Fungsi yang tersedia di editor kueri bergantung pada versi PostgreSQL yang Anda pilih saat mengonfigurasi sumber data. Jika Anda menggunakan fungsi agregat, Anda harus mengelompokkan set hasil Anda. Jika Anda menambahkan fungsi agregat, editor akan secara otomatis menambahkan file. `GROUP BY time`
Editor mencoba menyederhanakan dan menyatukan bagian kueri ini.
Anda dapat menambahkan kolom nilai lebih lanjut dengan memilih tombol plus dan memilih **Kolom** dari menu. Beberapa kolom nilai akan diplot sebagai seri terpisah di panel grafik.
### Data penyaringan (WHERE)
Untuk menambahkan filter, pilih ikon plus di sebelah kanan `WHERE` kondisi. Anda dapat menghapus filter dengan memilih filter dan memilih **Hapus**. Filter untuk rentang waktu yang dipilih saat ini secara otomatis ditambahkan ke kueri baru.
### Kelompokkan Oleh
Untuk mengelompokkan berdasarkan waktu atau kolom lainnya pilih ikon plus di akhir baris GROUP BY. Daftar tarik-turun saran hanya akan menampilkan kolom teks dari tabel yang Anda pilih saat ini tetapi Anda dapat memasukkan kolom apa pun secara manual. Anda dapat menghapus grup dengan memilih item dan kemudian memilih **Hapus**.
Jika Anda menambahkan pengelompokan apa pun, semua kolom yang dipilih harus memiliki fungsi agregat yang diterapkan. Pembuat kueri akan secara otomatis menambahkan fungsi agregat ke semua kolom tanpa fungsi agregat saat Anda menambahkan pengelompokan.
#### Pengisian celah
Grafana yang Dikelola Amazon dapat mengisi nilai yang hilang saat Anda mengelompokkan berdasarkan waktu. Fungsi waktu menerima dua argumen. Argumen pertama adalah jendela waktu yang ingin Anda kelompokkan, dan argumen kedua adalah nilai yang Anda inginkan Grafana untuk mengisi item yang hilang.
### Mode editor teks (RAW)
Anda dapat beralih ke mode editor kueri mentah dengan memilih ikon hamburger dan memilih **mode Switch editor** atau dengan memilih **Edit SQL** di bawah kueri.
**catatan**
Jika Anda menggunakan editor kueri mentah, pastikan kueri Anda setidaknya memiliki `ORDER BY time` dan filter pada rentang waktu yang dikembalikan.
## Makro
Makro dapat digunakan dalam kueri untuk menyederhanakan sintaks dan memungkinkan bagian dinamis.
| Contoh makro | Deskripsi |
| --- | --- |
| \$1\$1\$1time(dateColumn) | Akan diganti dengan ekspresi untuk mengkonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi. time\$1sec Misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. |
| \$1\$1\$1timeEpoch(dateColumn) | Akan diganti dengan ekspresi untuk mengkonversi ke stempel waktu UNIX dan mengganti nama kolom menjadi. time\$1sec Misalnya, UNIX\$1TIMESTAMP (DateColumn) sebagai time\$1sec. |
| \$1\$1\$1timeFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan. Misalnya, DateColumn BETWEEN FROM\$1UNIXTIME (1494410783) DAN FROM\$1UNIXTIME (1494410983). |
| \$1\$1\$1timeFrom() | Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410783). |
| \$1\$1\$1timeTo() | Akan diganti pada akhir pemilihan waktu yang sedang aktif. Misalnya, FROM\$1UNIXTIME (1494410983). |
| \$1\$1\$1timeGroup(dateColumn,'5m') | Akan diganti dengan ekspresi yang dapat digunakan dalam klausa GROUP BY. Misalnya, cast (cast (UNIX\$1TIMESTAMP (DateColumn)/(300) sebagai ditandatangani) 300 sebagai ditandatangani), \$1 |
| \$1\$1\$1timeGroup(dateColumn,'5m', 0) | Sama seperti baris preivious, tetapi dengan parameter fill sehingga titik yang hilang dalam seri itu akan ditambahkan oleh grafana dan 0 akan digunakan sebagai nilai. |
| \$1\$1\$1timeGroup(dateColumn,'5m', NULL) | Sama seperti di atas tetapi NULL akan digunakan sebagai nilai untuk poin yang hilang. |
| \$1\$1\$1timeGroup(dateColumn,'5m', previous) | Sama seperti di atas tetapi nilai sebelumnya dalam seri itu akan digunakan sebagai nilai isi jika tidak ada nilai yang terlihat namun NULL akan digunakan (hanya tersedia di Grafana 5.3\$1). |
| \$1\$1\$1timeGroupAlias(dateColumn,'5m') | Akan diganti identik dengan \$1\$1\$1TimeGroup tetapi dengan alias kolom tambahan |
| \$1\$1\$1unixEpochFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu Unix. Misalnya, \$1DateColumn > 1494410783 DAN DateColumn < 1494497183\$1 |
| \$1\$1\$1unixEpochFrom()` | \$1 Akan diganti dengan dimulainya pemilihan waktu yang sedang aktif sebagai stempel waktu Unix. Misalnya, \$11494410783\$1 |
| \$1\$1\$1unixEpochTo() | Akan diganti dengan akhir pemilihan waktu aktif saat ini sebagai stempel waktu Unix. Misalnya, \$11494497183\$1 |
| \$1\$1\$1unixEpochNanoFilter(dateColumn) | Akan diganti dengan filter rentang waktu menggunakan nama kolom yang ditentukan dengan waktu yang direpresentasikan sebagai stempel waktu nanodetik. Misalnya, \$1DateColumn > 1494410783152415214 DAN DateColumn < 1494497183142514872\$1 |
| \$1\$1\$1unixEpochNanoFrom() | Akan digantikan oleh dimulainya pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, \$11494410783152415214\$1 |
| \$1\$1\$1unixEpochNanoTo() | Akan diganti pada akhir pemilihan waktu aktif saat ini sebagai stempel waktu nanodetik. Misalnya, \$11494497183142514872\$1 |
| \$1\$1\$1unixEpochGroup(dateColumn,"5m", [fillmode]) | Sama seperti \$1\$1\$1TimeGroup tetapi untuk waktu yang disimpan sebagai stempel waktu Unix. |
## Kueri tabel
Jika opsi kueri diatur ke **Format sebagai Tabel**, pada dasarnya Anda dapat melakukan semua jenis kueri SQL. Panel tabel akan secara otomatis menampilkan hasil kolom dan baris apa pun yang dikembalikan kueri Anda.
Anda dapat mengontrol nama kolom panel Tabel dengan menggunakan sintaks pemilihan kolom `as` SQL biasa.
## Pertanyaan deret waktu
Jika Anda menetapkan **Format**`Time series`, untuk digunakan dalam panel grafik misalnya, kueri harus mengembalikan kolom bernama `time` yang mengembalikan datetime SQL atau tipe data numerik yang mewakili Unix epoch. Setiap kolom kecuali `time` dan `metric` diperlakukan sebagai kolom nilai. Anda dapat mengembalikan kolom bernama `metric` yang digunakan sebagai nama metrik untuk kolom nilai. Jika Anda mengembalikan beberapa kolom nilai dan kolom bernama`metric`, kolom ini digunakan sebagai awalan untuk nama seri.
Kumpulan hasil kueri deret waktu harus diurutkan berdasarkan waktu.
Kode contoh berikut menunjukkan `metric` kolom.
```
SELECT
$__timeGroup("time_date_time",'5m'),
min("value_double"),
'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```
Contoh kode folowing menunjukkan menggunakan parameter fill di makro \$1\$1\$1TimeGroup untuk mengonversi nilai null menjadi nol sebagai gantinya.
```
SELECT
$__timeGroup("createdAt",'5m',0),
sum(value) as value,
measurement
FROM test_data
WHERE
$__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time
```
Kode contoh berikut menunjukkan beberapa kolom.
```
SELECT
$__timeGroup("time_date_time",'5m'),
min("value_double") as "min_value",
max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time
```
## Templating
Alih-alih 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](templates-and-variables.md#templates).
### Variabel kueri
Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri PostgreSQL yang dapat mengembalikan hal-hal seperti nama pengukuran, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun.
Misalnya, Anda dapat memiliki variabel yang berisi semua nilai untuk `hostname` kolom dalam tabel jika Anda menentukan kueri seperti ini dalam pengaturan *kueri* variabel template.
```
SELECT hostname FROM host
```
Kueri dapat mengembalikan beberapa kolom dan Grafana akan secara otomatis membuat daftar dari mereka. Misalnya, query berikut akan mengembalikan daftar dengan nilai-nilai dari `hostname` dan`hostname2`.
```
SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city
```
Untuk menggunakan makro yang bergantung pada rentang waktu seperti `$__timeFilter(column)` dalam kueri Anda, mode penyegaran variabel template harus disetel ke *On Time Range Change*.
```
SELECT event_name FROM event_log WHERE $__timeFilter(time_column)
```
Pilihan lain adalah kueri yang dapat membuat key/value variabel. Query harus mengembalikan dua kolom yang diberi nama `__text` dan`__value`. Nilai `__text` kolom harus unik (jika tidak unik, nilai pertama digunakan). Opsi dalam daftar dropdown akan memiliki teks dan nilai yang memungkinkan Anda memiliki nama ramah sebagai teks dan id sebagai nilainya. Contoh query dengan `hostname` sebagai teks dan `id` sebagai nilai:
```
SELECT hostname AS __text, id AS __value FROM host
```
Anda juga dapat membuat variabel bersarang. Menggunakan variabel bernama`region`, Anda bisa memiliki variabel host hanya menampilkan host dari wilayah yang dipilih saat ini. Contoh kode berikut menunjukkan kueri seperti ini (jika `region` adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai).
```
SELECT hostname FROM host WHERE region IN($region)
```
#### Menggunakan `__searchFilter` untuk memfilter hasil dalam Variabel Kueri
Menggunakan `__searchFilter` di bidang kueri akan memfilter hasil kueri berdasarkan jenis pengguna di kotak pilih dropdown. Ketika tidak ada yang dimasukkan oleh pengguna, nilai default untuk `__searchFilter` adalah`%`.
**catatan**
Penting bahwa Anda mengelilingi `__searchFilter` ekspresi dengan tanda kutip karena Grafana tidak melakukan ini untuk Anda.
Contoh berikut menunjukkan cara menggunakan `__searchFilter` sebagai bagian dari bidang query untuk mengaktifkan pencarian `hostname` sementara pengguna mengetik di kotak pilih dropdown.
```
SELECT hostname FROM my_host WHERE hostname LIKE '$__searchFilter'
```
### Menggunakan variabel dalam kueri
Nilai variabel template hanya dikutip ketika variabel template adalah`multi-value`.
Jika variabel adalah variabel multi-nilai, gunakan operator `IN` perbandingan daripada `=` untuk mencocokkan dengan beberapa nilai.
Ada dua sintaks:
`$`Contoh dengan variabel template bernama`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]`Contoh dengan variabel template bernama`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### Mematikan kutipan untuk variabel multi-nilai
Grafana yang Dikelola Amazon secara otomatis membuat string yang dikutip dan dipisahkan koma untuk variabel multi-nilai. Misalnya: jika `server01` dan `server02` dipilih maka akan diformat sebagai:`'server01', 'server02'`. Untuk menonaktifkan kutipan, gunakan opsi pemformatan csv untuk variabel.
`${servers:csv}`
Untuk informasi selengkapnya tentang opsi pemformatan variabel, lihat[Template dan variabel](templates-and-variables.md).
## Anotasi
Gunakan anotasi untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat [Anotasi](dashboard-annotations.md).
Contoh kode berikut menunjukkan query menggunakan kolom waktu dengan nilai-nilai epoch.
```
SELECT
epoch_time as time,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
Kode contoh berikut menunjukkan kueri wilayah menggunakan kolom waktu dan waktu akhir dengan nilai epoch.
**catatan**
Ini hanya tersedia di Grafana v6.6\$1.
```
SELECT
epoch_time as time,
epoch_time_end as timeend,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__unixEpochFilter(epoch_time)
```
Contoh kode berikut menunjukkan query menggunakan kolom waktu tipe date/time data SQL asli.
```
SELECT
native_date_time as time,
metric1 as text,
concat_ws(', ', metric1::text, metric2::text) as tags
FROM
public.test_data
WHERE
$__timeFilter(native_date_time)
```
| Nama | Deskripsi |
| --- | --- |
| time | Nama date/time lapangan. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch. |
| timeend | Nama opsional dari date/time bidang akhir. Bisa berupa kolom dengan tipe date/time data SQL asli atau nilai epoch (Grafana v6.6\$1). |
| text | Bidang deskripsi acara. |
| tags | Nama bidang opsional untuk digunakan untuk tag peristiwa sebagai string yang dipisahkan koma. |
## Peringatan
Kueri deret waktu harus berfungsi dalam kondisi peringatan. Kueri yang diformat tabel belum didukung dalam kondisi aturan peringatan.
# Connect ke sumber data Tempo
Tempo adalah penyimpanan jejak ketergantungan minimal volume tinggi, solusi penelusuran OSS dari Grafana Labs.
## Menambahkan sumber data
Untuk mengakses pengaturan Tempo, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih **Tempo**.
| Nama | Deskripsi |
| --- | --- |
| Name | Nama yang akan Anda gunakan untuk merujuk ke sumber data di panel, kueri, dan Jelajahi. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| URL | URL dari instance Tempo; misalnya,http://tempo. |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data Tempo. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
## Lacak ke log
Ini adalah konfigurasi untuk fitur trace to logs. Sumber data target saat ini haruslah Loki. Untuk informasi selengkapnya, lihat [Menelusuri integrasi](explore.md#tracing-integration).
+ **Sumber data — Sumber** data target.
+ **Tag** — Tag yang akan digunakan dalam kueri Loki. Bawaannya adalah `'cluster', 'hostname', 'namespace', pod'`
+ **Pergeseran waktu mulai rentang** - Pergeseran waktu mulai untuk kueri Loki berdasarkan rentang waktu mulai. Untuk memperluas ke masa lalu, Anda perlu menggunakan nilai negatif. Satuan waktu dapat digunakan di sini, misalnya, 5s, 1m, 3h. Default-nya adalah 0.
+ **Pergeseran waktu akhir rentang** — Pergeseran waktu akhir untuk kueri Loki berdasarkan rentang waktu akhir. Satuan waktu dapat digunakan di sini, misalnya, 5s, 1m, 3h. Default-nya adalah 0.
## Jejak kueri
Anda dapat menanyakan dan menampilkan jejak dari Tempo melalui Explore. Anda dapat mencari jejak jika Anda mengatur pengaturan jejak ke log di halaman konfigurasi sumber data. Untuk menemukan jejak untuk memvisualisasikan, gunakan editor kueri Loki. Untuk mendapatkan hasil pencarian, Anda harus memiliki bidang turunan yang dikonfigurasi, yang mengarah ke sumber data ini.
Untuk menanyakan jejak tertentu, pilih jenis kueri TraceID, lalu masukkan ID ke dalam bidang Trace ID.
## Menautkan ke ID jejak dari log
Anda dapat menautkan ke jejak Tempo dari log di Loki atau Elastis dengan mengonfigurasi tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields).
# Konfigurasikan sumber TestData data untuk pengujian
Grafana dikirimkan dengan sumber TestData data, yang membuat data deret waktu simulasi untuk panel apa pun. Anda dapat menggunakannya untuk membuat data deret waktu palsu dan acak Anda sendiri dan merendernya di panel apa pun, yang membantu Anda memverifikasi fungsionalitas dasbor dan membagikan data dengan aman dan mudah.
**Konfigurasikan sumber data**
**Untuk mengakses konfigurasi sumber data untuk TestData**
1. Pilih ikon **Konfigurasi** (roda gigi).
1. Pilih **Sumber Data**.
1. pilih **TestData**.
Sumber data tidak menyediakan pengaturan apa pun di luar opsi paling dasar yang umum untuk semua sumber data:
| Nama | Deskripsi |
| --- | --- |
| `Name` | Nama sumber data di panel, kueri, dan Jelajahi. |
| `Default` | Apakah sumber data ini akan dipilih sebelumnya untuk panel baru. |
**Buat data tiruan**
Menambahkan sumber TestData data, pengguna instans Grafana Anda dapat menggunakannya sebagai sumber data di panel metrik apa pun, dan itu akan memberikan data tiruan yang dapat Anda gunakan, berdasarkan TestData skenario yang Anda pilih.
**Pilih skenario**
Alih-alih menyediakan editor kueri, sumber TestData data membantu Anda memilih **Skenario** yang menghasilkan data simulasi untuk panel.
Anda dapat menetapkan **Alias** untuk setiap skenario, dan banyak yang memiliki opsi sendiri yang muncul saat dipilih.
**Skenario yang tersedia:**
+ **Anotasi**
+ **Kesalahan Bersyarat**
+ **Konten CSV**
+ **CSV Berkas**
+ **Nilai Metrik CSV**
+ **Datapoint Luar Jangkauan**
+ **Data bucket peta panas eksponensial**
+ **Grafana API**
+ **Grafana Langsung**
+ **Data bucket peta panas linier**
+ **Muat Data Panah Apache**
+ **Log**
+ **Tidak Ada Poin Data**
+ **Grafik Node**
+ **Gelombang CSV yang Dapat Diprediksi**
+ **Pulsa yang Dapat Diprediksi**
+ **Jalan Acak**
+ **Random Walk (dengan kesalahan)**
+ **Meja Jalan Acak**
+ **Bingkai Mentah**
+ **Simulasi**
+ **Kueri Lambat**
+ **Klien Streaming**
+ **Tabel statis**
+ **Data yang dihasilkan AS**
**Impor dasbor yang telah dikonfigurasi sebelumnya**
TestData juga menyediakan contoh dasbor.
**Untuk mengimpor dasbor contoh**
1. Arahkan ke halaman konfigurasi sumber data.
1. Pilih tab **Dasbor**.
1. Pilih **Impor** untuk dasbor **Contoh Streaming Sederhana**.
**Untuk menyesuaikan dasbor yang diimpor:**
Untuk menyesuaikan dasbor yang diimpor, kami sarankan Anda menyimpannya dengan nama yang berbeda. Jika tidak, memutakhirkan Grafana dapat menimpa dasbor yang disesuaikan dengan versi baru.
**Gunakan data pengujian untuk melaporkan masalah**
Jika Anda melaporkan masalah terkait GrafanaLabs penggunaan atau rendering data deret waktu, kami sangat menyarankan agar Anda menggunakan sumber data ini untuk mereplikasi masalah tersebut. GitHub Itu membuatnya lebih mudah bagi pengembang untuk mereplikasi dan menyelesaikan masalah Anda.
# Connect ke sumber data Zipkin
Zipkin adalah sistem penelusuran terdistribusi open source. Tambahkan sumber data Zipkin untuk dapat menanyakan jejak Anda di Jelajahi di Grafana Terkelola Amazon
## Menambahkan sumber data
Untuk mengakses pengaturan Zipkin, pilih ikon **Konfigurasi** (roda gigi), lalu pilih **Sumber Data**, lalu pilih **Zipkin**.
| Nama | Deskripsi |
| --- | --- |
| Name | Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel, kueri, dan Jelajahi. |
| Default | Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru. |
| URL | URL dari contoh Zipkin; misalnya,http://localhost:9411. |
| Access | Server (default) = URL harus dapat diakses dari backend/server Grafana. |
| Basic Auth | Aktifkan otentikasi dasar ke sumber data Zipkin. |
| User | Nama pengguna untuk otentikasi dasar. |
| Password | Kata sandi untuk otentikasi dasar. |
## Jejak kueri
Menanyakan dan menampilkan jejak dari Zipkin tersedia melalui Explore.
Editor kueri Zipkin memungkinkan Anda untuk melakukan kueri dengan melacak ID secara langsung atau memilih jejak dari pemilih jejak. Untuk kueri berdasarkan ID jejak, masukkan ID ke input teks.
Gunakan pemilih jejak untuk memilih jejak tertentu dari semua jejak yang dicatat dalam rentang waktu yang telah Anda pilih di Jelajahi. Pemilih jejak memiliki tiga tingkat bersarang: 1. Layanan yang Anda minati. 1. Operasi khusus adalah bagian dari layanan yang dipilih 1. Jejak spesifik di mana operasi yang dipilih terjadi, diwakili oleh nama operasi root dan durasi jejak.
## Pemetaan data di UI jejak
Anotasi Zipkin ditampilkan dalam tampilan jejak sebagai log dengan nilai anotasi yang ditampilkan di bawah kunci anotasi.
## Menautkan ke ID jejak dari log
Anda dapat menautkan ke jejak Zipkin dari log di Loki dengan mengonfigurasi bidang turunan dengan tautan internal. Lihat informasi yang lebih lengkap di [Bidang turunan](using-loki-in-AMG.md#loki-derived-fields).