Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konektor Metrik Amazon Athena CloudWatch
Konektor CloudWatch Metrik Amazon Athena memungkinkan Amazon Athena untuk menanyakan CloudWatch data Metrik dengan SQL.
Konektor ini tidak menggunakan Glue Connections untuk memusatkan properti konfigurasi di Glue. Konfigurasi koneksi dilakukan melalui Lambda.
Untuk informasi tentang memublikasikan metrik kueri CloudWatch dari Athena itu sendiri, lihat. [Menggunakan CloudWatch dan EventBridge memantau kueri dan mengendalikan biaya](workgroups-control-limits.md)
## Prasyarat
+ Menyebarkan konektor ke Anda Akun AWS menggunakan konsol Athena atau. AWS Serverless Application Repository Untuk informasi selengkapnya, lihat [Buat koneksi sumber data](connect-to-a-data-source.md) atau [Gunakan AWS Serverless Application Repository untuk menyebarkan konektor sumber data](connect-data-source-serverless-app-repo.md).
## Parameter
Gunakan parameter di bagian ini untuk mengkonfigurasi konektor CloudWatch Metrik.
### AWS Glue Data Catalog konektor federasi
Kami menyarankan Anda mengonfigurasi konektor CloudWatch Metrik dengan menggunakan objek koneksi Glue. Untuk melakukan ini, atur variabel `glue_connection` lingkungan dari konektor CloudWatch Metrik Lambda ke nama koneksi Glue yang akan digunakan.
**Properti koneksi lem**
Gunakan perintah berikut untuk mendapatkan skema untuk objek koneksi Glue. Skema ini berisi semua parameter yang dapat Anda gunakan untuk mengontrol koneksi Anda.
```
aws glue describe-connection-type --connection-type CLOUDWATCHMETRICS
```
**Properti lingkungan Lambda**
Properti lingkungan Lambda berikut hanya berlaku ketika Anda menggunakan konektor dengan fungsi Lambda di akun Anda.
+ **glue\_connection** - Menentukan nama koneksi Glue yang terkait dengan konektor federasi.
**catatan**
Semua konektor yang menggunakan koneksi AWS Glue Data Catalog federasi harus digunakan AWS Secrets Manager untuk menyimpan kredensil.
Konektor CloudWatch Metrik yang dibuat menggunakan koneksi AWS Glue Data Catalog federasi tidak mendukung penggunaan handler multiplexing.
Konektor CloudWatch Metrik yang dibuat menggunakan koneksi AWS Glue Data Catalog federasi hanya mendukung `ConnectionSchemaVersion` 2.
### Konektor federasi katalog data Athena
+ **spill\_bucket** - Menentukan bucket Amazon S3 untuk data yang melebihi batas fungsi Lambda.
+ **spill\_prefix** — (Opsional) Default ke subfolder dalam nama yang ditentukan. `spill_bucket` `athena-federation-spill` Kami menyarankan Anda mengonfigurasi [siklus hidup penyimpanan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) Amazon S3 di lokasi ini untuk menghapus tumpahan yang lebih lama dari jumlah hari atau jam yang telah ditentukan sebelumnya.
+ **spill\_put\_request\_headers** — (Opsional) Peta header permintaan dan nilai yang disandikan JSON untuk permintaan Amazon S3 yang digunakan untuk menumpahkan (misalnya,). `putObject` `{"x-amz-server-side-encryption" : "AES256"}` Untuk kemungkinan header lainnya, lihat [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)di *Referensi API Amazon Simple Storage Service*.
+ **kms\_key\_id** — (Opsional) Secara default, data apa pun yang tumpah ke Amazon S3 dienkripsi menggunakan mode enkripsi yang diautentikasi AES-GCM dan kunci yang dihasilkan secara acak. Agar fungsi Lambda Anda menggunakan kunci enkripsi yang lebih kuat yang dihasilkan oleh KMS seperti`a7e63k4b-8loc-40db-a2a1-4d0en2cd8331`, Anda dapat menentukan ID kunci KMS.
+ **disable\_spill\_encryption** — (Opsional) Ketika diatur ke, menonaktifkan enkripsi tumpahan. `True` Defaultnya `False` sehingga data yang tumpah ke S3 dienkripsi menggunakan AES-GCM — baik menggunakan kunci yang dihasilkan secara acak atau KMS untuk menghasilkan kunci. [Menonaktifkan enkripsi tumpahan dapat meningkatkan kinerja, terutama jika lokasi tumpahan Anda menggunakan enkripsi sisi server.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html)
[Konektor ini juga mendukung [kontrol kemacetan AIMD](https://en.wikipedia.org/wiki/Additive_increase/multiplicative_decrease) untuk menangani peristiwa pelambatan dari melalui konstruksi CloudWatch Amazon Athena Query Federation SDK.](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-federation-sdk) `ThrottlingInvoker` Anda dapat mengubah perilaku pelambatan default dengan menyetel salah satu variabel lingkungan opsional berikut:
+ **throttle\_initial\_delay\_ms - Penundaan panggilan** awal diterapkan setelah peristiwa kemacetan pertama. Defaultnya adalah 10 milidetik.
+ **throttle\_max\_delay\_ms — Penundaan** maksimum antara panggilan. Anda dapat memperoleh TPS dengan membaginya menjadi 1000ms. Defaultnya adalah 1000 milidetik.
+ **throttle\_decrease\_factor —** Faktor dimana Athena mengurangi tingkat panggilan. Defaultnya adalah 0,5
+ **throttle\_increase\_ms — Tingkat di mana Athena** mengurangi penundaan panggilan. Defaultnya adalah 10 milidetik.
## Database dan tabel
Konektor Athena CloudWatch Metrics memetakan ruang nama, dimensi, metrik, dan nilai metrik Anda ke dalam dua tabel dalam satu skema yang disebut. `default`
### Tabel metrik
`metrics`Tabel berisi metrik yang tersedia sebagaimana didefinisikan secara unik oleh kombinasi namespace, set, dan nama. `metrics`Tabel berisi kolom berikut.
+ **namespace** — A yang `VARCHAR` berisi namespace.
+ **metric\_name** — A yang `VARCHAR` berisi nama metrik.
+ **dimensi** — Sebuah `LIST` `STRUCT` objek yang terdiri dari `dim_name (VARCHAR)` dan`dim_value (VARCHAR)`.
+ **statistik** — Sebuah `LIST` `VARCH` statistik (misalnya,, `p90``AVERAGE`,...) tersedia untuk metrik.
### Tabel metric\_samples
`metric_samples`Tabel berisi sampel metrik yang tersedia untuk setiap metrik dalam `metrics` tabel. `metric_samples`Tabel berisi kolom berikut.
+ **namespace** — A `VARCHAR` yang berisi namespace.
+ **metric\_name** — A `VARCHAR` yang berisi nama metrik.
+ **dimensi** — Sebuah `LIST` `STRUCT` objek yang terdiri dari `dim_name (VARCHAR)` dan`dim_value (VARCHAR)`.
+ **dim\_name** - Bidang `VARCHAR` kenyamanan yang dapat Anda gunakan untuk memfilter dengan mudah pada satu nama dimensi.
+ **dim\_value** — Bidang `VARCHAR` kenyamanan yang dapat Anda gunakan untuk memfilter dengan mudah pada nilai dimensi tunggal.
+ **Periode** — `INT` Bidang yang mewakili “periode” metrik dalam detik (misalnya, metrik 60 detik).
+ **stempel waktu** — `BIGINT` Bidang yang mewakili waktu epoch dalam detik untuk sampel metrik.
+ **value** — `FLOAT8` Bidang yang berisi nilai sampel.
+ **statistik** — A `VARCHAR` yang berisi tipe statistik sampel (misalnya, `AVERAGE` atau`p90`).
## Izin yang Diperlukan
Untuk detail selengkapnya tentang kebijakan IAM yang diperlukan konektor ini, tinjau `Policies` bagian [athena-cloudwatch-metricsfile.yaml.](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-cloudwatch-metrics/athena-cloudwatch-metrics.yaml) Daftar berikut merangkum izin yang diperlukan.
+ **Akses tulis Amazon S3** - Konektor memerlukan akses tulis ke lokasi di Amazon S3 untuk menumpahkan hasil dari kueri besar.
+ **Athena GetQueryExecution** — Konektor menggunakan izin ini untuk gagal cepat ketika kueri Athena hulu telah dihentikan.
+ **CloudWatch Metrik ReadOnly** — Konektor menggunakan izin ini untuk menanyakan data metrik Anda.
+ **CloudWatch Log Tulis** — Konektor menggunakan akses ini untuk menulis log diagnostiknya.
## Performa
Konektor CloudWatch Metrik Athena mencoba mengoptimalkan kueri terhadap CloudWatch Metrik dengan memparalelkan pemindaian aliran log yang diperlukan untuk kueri Anda. Untuk periode waktu tertentu, metrik, namespace, dan filter dimensi, pushdown predikat dilakukan baik di dalam fungsi Lambda maupun di dalam Log. CloudWatch
## Informasi lisensi
[Proyek konektor CloudWatch Metrik Amazon Athena dilisensikan di bawah Lisensi Apache-2.0.](https://www.apache.org/licenses/LICENSE-2.0.html)
## Sumber daya tambahan
Untuk informasi tambahan tentang konektor ini, kunjungi [situs terkait](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-cloudwatch-metrics) GitHub di.com.