Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Datadog
Datadog adalah platform pemantauan dan analitik untuk aplikasi skala cloud, termasuk infrastruktur, aplikasi, layanan, dan alat.
**Topics**
+ [AWS Glue dukungan untuk Datadog](datadog-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](datadog-configuring-iam-permissions.md)
+ [Mengkonfigurasi Datadog](datadog-configuring.md)
+ [Mengkonfigurasi koneksi Datadog](datadog-configuring-connections.md)
+ [Membaca dari entitas Datadog](datadog-reading-from-entities.md)
+ [Opsi koneksi Datadog](datadog-connection-options.md)
+ [Membuat akun Datadog](datadog-create-account.md)
+ [Batasan](datadog-connector-limitations.md)
# AWS Glue dukungan untuk Datadog
AWS Glue mendukung Datadog sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk meminta data dari Datadog.
**Didukung sebagai target?**
Tidak.
**Versi API Datadog yang didukung**
+ v1
+ v2
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode sebelumnya, sebagai alternatif, gunakan kebijakan IAM terkelola berikut:
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya ketika identitas yang dilampirkan kebijakan menggunakan konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Datadog
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari Datadog, Anda harus memenuhi persyaratan berikut:
## Persyaratan minimum
+ Anda memiliki akun Datadog dengan DD-API-KEY dan. DD-APPLICATION-KEY Untuk informasi selengkapnya tentang membuat akun, lihat [Membuat akun Datadog](datadog-create-account.md).
+ Akun Datadog Anda memiliki akses API dengan lisensi yang valid.
Datadog mendukung enam berikut. URLs Semua klien API Datadog dikonfigurasi secara default untuk menggunakan situs US1 Datadog. APIs Jika Anda berada di situs Datadog EU, Anda harus memilih https://api.datadoghq.eu URL dengan `DD-API-KEY` dan `DD-APPLICATION-KEY` dari situs Datadog EU untuk mengakses. APIs Demikian pula, untuk situs lain, Anda harus memilih masing-masing URLs dengan situs masing-masing. `DD-API-KEY and DD-APPLICATION-KEY`
+ US1 URL API - [https://api.datadoghq.com](https://api.datadoghq.com) https://api.datadoghq.com
+ URL API UE - [https://api.datadoghq.eu](https://api.datadoghq.eu)
+ US3 URL API - [https://api.us3.datadoghq.com](https://api.us3.datadoghq.com)
+ US5 URL API - [https://api.us5.datadoghq.com](https://api.us5.datadoghq.com)
+ URL API S1-FED — [https://api.ddog-gov.com](https://api.ddog-gov.com)
+ URL API Jepang - [https://api.ap1.datadoghq.com](https://api.ap1.datadoghq.com)
Jika Anda memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Datadog Anda.
# Mengkonfigurasi koneksi Datadog
Datadog mendukung otentikasi kustom. Berikut adalah langkah-langkah untuk mengkonfigurasi koneksi Datadog:
Untuk mengkonfigurasi koneksi Datadog:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
Untuk aplikasi terhubung yang dikelola pelanggan — Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan `API_KEY` dan `APPLICATION_KEY` sebagai kunci.
**catatan**
Ini adalah suatu keharusan untuk membuat rahasia per koneksi di AWS Glue.
1. Di AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Datadog.
1. Berikan Datadog yang ingin Anda sambungkan. `Instance_Url`
1. Pilih peran IAM yang AWS Glue dapat diasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Datadog
**Prasyarat**
Objek Datadog yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia.
**Entitas yang didukung**
| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- |
| Timeseries Metrik | Ya | Tidak | Tidak | Ya | Tidak |
| Kueri Log | Ya | Ya | Ya | Ya | Tidak |
**Contoh**
```
Datadog_read = glueContext.create_dynamic_frame.from_options(
connection_type="datadog",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "log-queries",
"API_VERSION": "v2",
"INSTANCE_URL": "https://api.datadoghq.com",
"FILTER_PREDICATE": "from = `2023-10-03T09:00:26Z`"
}
```
**Entitas Datadog dan detail bidang**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/datadog-reading-from-entities.html)
# Opsi koneksi Datadog
Berikut ini adalah opsi koneksi untuk Datadog:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Objek Anda di Datadog.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Datadog Rest API versi yang ingin Anda gunakan. `v1`versi mendukung `metrics-timeseries` entitas sedangkan, `v2` versi mendukung `log-queries` entitas.
+ `INSTANCE_URL`(String) - (Diperlukan) Digunakan untuk Baca. Contoh URL Datadog. Contoh URL Datadog bervariasi per wilayah.
+ `SELECTED_FIELDS`(Daftar) — Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
# Membuat akun Datadog
1. Pergi ke [https://www.datadoghq.com/](https://api.datadoghq.com).
1. Pilih **MULAI GRATIS**.
1. Masukkan informasi yang diperlukan dan daftar.
1. Instal **Installer Agen Datadog** seperti yang disarankan.
1. Pastikan akun terdaftar dengan organisasi yang valid (dari daftar yang tersedia) yang memiliki langganan Datadog aktif.
1. **Setelah masuk ke akun Datadog Anda, arahkan kursor ke nama pengguna Anda di sudut kanan atas untuk melihat detail Kunci:**
1. Untuk mendapatkan kunci API Anda, pilih **Kunci API**.
1. Untuk mendapatkan kunci aplikasi Anda, pilih **Kunci Aplikasi**.
# Batasan
Berikut ini adalah batasan untuk konektor Datadog:
+ Datadog tidak mendukung partisi berbasis bidang atau berbasis rekaman.
+ `from`adalah parameter filter wajib untuk `Log Queries` entitas.
+ `from_to_date`dan `query` merupakan parameter filter wajib untuk `Metrics Timeseries` entitas.