本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 連線至 Datadog
Datadog 是雲端規模應用程式的監控和分析平台，包括基礎設施、應用程式、服務及工具。
**Topics**
+ [AWS Glue 支援 Datadog](datadog-support.md)
+ [包含用於建立和使用連線的 API 操作的政策](datadog-configuring-iam-permissions.md)
+ [設定 Datadog](datadog-configuring.md)
+ [設定 Datadog 連線](datadog-configuring-connections.md)
+ [從 Datadog 實體中讀取](datadog-reading-from-entities.md)
+ [Datadog 連線選項](datadog-connection-options.md)
+ [建立 Datadog 帳戶](datadog-create-account.md)
+ [限制](datadog-connector-limitations.md)
# AWS Glue 支援 Datadog
AWS Glue 支援 Datadog，如下所示：
**支援作為來源？**
是。您可以使用 AWS Glue ETL 任務從 Datadog 查詢資料。
**支援作為目標？**
否。
**支援的 Datadog API 版本**
+ v1
+ v2
# 包含用於建立和使用連線的 API 操作的政策
下列範例政策說明建立和使用 連線所需的 AWS 許可。如果您要建立新角色，請建立包含下列項目的政策：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
如果不想使用上述方法，可選擇使用下列受管 IAM 政策：
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole) – 准許存取各種 AWS Glue 程序代表您執行所需的資源。這些資源包括 AWS Glue、Amazon S3、IAM、CloudWatch Logs 和 Amazon EC2。如果您遵循此政策中指定資源的命名慣例，則 AWS Glue 程序具有必要的許可。此政策通常會連接至定義編目程式、工作和開發端點時所指定的角色。
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess) – 當連接政策的身分使用 AWS 管理主控台時，授予對 AWS Glue 資源的完整存取權。如果您依照此政策中指定的資源命名慣例，使用者就能擁有完整的主控台功能。此政策通常連接到 AWS Glue 主控台的使用者。
# 設定 Datadog
您必須先符合下列要求，才能使用 從 Datadog AWS Glue 傳輸 ：
## 最低需求
+ 您具有 DD-API-KEY 和 DD-APPLICATION-KEY 的 Datadog 帳戶。如需有關建立帳戶的詳細資訊，請參閱[建立 Datadog 帳戶](datadog-create-account.md)。
+ 您的 Datadog 帳戶具有包含有效授權的 API 存取。
Datadog 支援下列六個 URL。依預設，所有 Datadog API 用戶端都會設定為使用 Datadog US1 站點 API。如果您在 Datadog EU 站點上，則必須使用 Datadog EU 站點的 `DD-API-KEY` 和 `DD-APPLICATION-KEY` 選取 https://api.datadoghq.eu URL 來存取 API。同樣地，對於其他站點，您應使用個別站點的 `DD-API-KEY and DD-APPLICATION-KEY` 來選取個別 URL。
+ US1 API URL – [https://api.datadoghq.com](https://api.datadoghq.com)https://api.datadoghq.com
+ EU API URL – [https://api.datadoghq.eu ](https://api.datadoghq.eu)
+ US3 API URL – [https://api.us3.datadoghq.com](https://api.us3.datadoghq.com)
+ US5 API URL – [https://api.us5.datadoghq.com](https://api.us5.datadoghq.com)
+ S1-FED API URL – [https://api.ddog-gov.com](https://api.ddog-gov.com)
+ 日本 API URL – [https://api.ap1.datadoghq.com](https://api.ap1.datadoghq.com)
如果您符合這些要求，就可以 AWS Glue 連線到 Datadog 帳戶。
# 設定 Datadog 連線
Datadog 支援自訂身分驗證。以下是設定 Datadog 連線的步驟：
若要設定 Datadog 連線，請執行以下操作：
1. 在 AWS Secrets Manager 中，建立包含下列詳細資訊的秘密：
對於客戶管理的連線應用程式，機密應包含以 `API_KEY` 和 `APPLICATION_KEY` 作為金鑰的連線應用程式消費者機密。
**注意**
必須在 AWS Glue中為每個連線建立機密。
1. 在 中 AWS Glue Studio，依照下列步驟在 **Data Connections** 下建立連線：
1. 選取**連線類型**時，選取 Teradata。
1. 提供您要連線的 Datadog 的 `Instance_Url`。
1. 選取 AWS Glue 可擔任的 IAM 角色，並具有下列動作的許可：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. 選取您要用於此連線`secretName`的 AWS Glue ，以放置字符。
1. 如果想要使用您的網路，請選取網路選項。
1. 授予與您的 AWS Glue 任務相關聯的 IAM 角色讀取 的許可`secretName`。
# 從 Datadog 實體中讀取
**先決條件**
您要從中讀取的 Datadog 物件。請參閱以下支援的實體表格，以檢查可用實體。
**支援的實體**
| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \$1 | 支援分區 |
| --- | --- | --- | --- | --- | --- |
| 指標時間序列 | 是 | 否 | 否 | 是 | 否 |
| 日誌查詢 | 是 | 是 | 是 | 是 | 否 |
**範例**
```
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`"
}
```
**Datadog 實體和欄位詳細資訊**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/glue/latest/dg/datadog-reading-from-entities.html)
# Datadog 連線選項
以下是 Datadog 的連線選項：
+ `ENTITY_NAME`(String) - (必要) 用於讀取/寫入。Datadog 中物件的名稱。
+ `API_VERSION`(String) - (必要) 用於讀取/寫入。您要使用的 Datadog Rest API 版本。`v1` 版本支援 `metrics-timeseries` 實體，而 `v2` 版本支援 `log-queries` 實體。
+ `INSTANCE_URL`(String) – (必要) 用於讀取。Datadog 執行個體 URL。Datadog 執行個體 URL 因區域而異。
+ `SELECTED_FIELDS`(List) - 預設：empty(SELECT \$1)。用於讀取。您要為物件選取的資料欄。
+ `FILTER_PREDICATE`(String) - 預設：空白。用於讀取。其應該為 Spark SQL 格式。
+ `QUERY`(String) - 預設：空白。用於讀取。完整的 Spark SQL 查詢。
# 建立 Datadog 帳戶
1. 前往 [https://www.datadoghq.com/](https://api.datadoghq.com)。
1. 選擇**免費開始使用**。
1. 輸入所需資訊並註冊。
1. 依建議安裝 **Datadog 代理程式安裝程式**。
1. 確保帳戶已向具有作用中 Datadog 訂閱的有效組織 (從可用的清單中) 註冊。
1. 登入 Datadog 帳戶後，將滑鼠的游標移至右上角的您的使用者名稱上，以檢視**金鑰**詳細資訊：
1. 若要取得您的 API 金鑰，請選擇 **API 金鑰**。
1. 若要取得您的應用程式金鑰，請選擇**應用程式金鑰**。
# 限制
以下是 Datadog 連接器的限制：
+ Datadog 不支援欄位型分區或記錄型分區。
+ `from` 是 `Log Queries` 實體的必要篩選條件參數。
+ `from_to_date` 和 `query` 是 `Metrics Timeseries` 實體的必要篩選條件參數。