Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect ke sumber data Amazon 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*.