Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à Datadog
Datadog est une plateforme de surveillance et d’analytique pour les applications à l’échelle du cloud, notamment les infrastructures, les applications, les services et les outils.
**Topics**
+ [AWS Glue support pour Datadog](datadog-support.md)
+ [Politiques contenant les opérations API pour la création et l’utilisation des connexions](datadog-configuring-iam-permissions.md)
+ [Configuration de Datadog](datadog-configuring.md)
+ [Configuration de connexions Datadog](datadog-configuring-connections.md)
+ [Lecture à partir d’entités Datadog](datadog-reading-from-entities.md)
+ [Options de connexion Datadog](datadog-connection-options.md)
+ [Création d’un compte Datadog](datadog-create-account.md)
+ [Limitations](datadog-connector-limitations.md)
# AWS Glue support pour Datadog
AWS Glue supporte Datadog comme suit :
**Prise en charge en tant que source ?**
Oui. Vous pouvez utiliser les jobs AWS Glue ETL pour interroger les données de Datadog.
**Prise en charge en tant que cible ?**
Non.
**Versions d’API Datadog prises en charge**
+ v1
+ v2
# Politiques contenant les opérations API pour la création et l’utilisation des connexions
L'exemple de politique suivant décrit les AWS autorisations requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Si vous ne voulez pas utiliser la méthode ci-dessus, vous pouvez également utiliser les politiques IAM gérées suivantes :
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console.
# Configuration de Datadog
Avant de pouvoir AWS Glue effectuer un transfert depuis Datadog, vous devez satisfaire aux exigences suivantes :
## Configuration requise
+ Vous possédez un compte Datadog avec DD-API-KEY et. DD-APPLICATION-KEY Pour plus d’informations sur la création d’un compte, consultez [Creating a Datadog account](datadog-create-account.md).
+ Votre compte Datadog dispose d’un accès à l’API avec une licence valide.
Datadog prend en charge les six suivants. URLs Tous les clients d'API Datadog sont configurés par défaut pour utiliser le site US1 Datadog. APIs Si vous êtes sur le site européen de Datadog, vous devez sélectionner l'URL https://api.datadoghq.eu avec le `DD-API-KEY` et du site européen `DD-APPLICATION-KEY` de Datadog pour accéder au. APIs De même, pour les autres sites, vous devez sélectionner le `DD-API-KEY and DD-APPLICATION-KEY` correspondant URLs avec le site concerné.
+ US1 URL de l'API — [https://api.datadoghq.com](https://api.datadoghq.com) https://api.datadoghq.com
+ URL de l’API EU – [https://api.datadoghq.eu](https://api.datadoghq.eu)
+ US3 URL de l'API — [https://api.us3.datadoghq.com](https://api.us3.datadoghq.com)
+ US5 URL de l'API — [https://api.us5.datadoghq.com](https://api.us5.datadoghq.com)
+ URL DE L'API S1-FED — [https://api.ddog-gov.com](https://api.ddog-gov.com)
+ URL de l'API pour le Japon — [https://api.ap1.datadoghq.com](https://api.ap1.datadoghq.com)
Si vous répondez à ces exigences, vous êtes prêt à vous connecter AWS Glue à votre compte Datadog.
# Configuration de connexions Datadog
Datadog prend en charge l’authentification personnalisée. Voici les étapes à suivre pour configurer la connexion Datadog :
Pour configurer une connexion Datadog :
1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes :
Pour l’application connectée gérée par le client : le secret doit contenir le secret du consommateur de l’application connectée avec `API_KEY` et `APPLICATION_KEY` comme clés.
**Note**
Il est indispensable de créer un secret par connexion dans AWS Glue.
1. Dans AWS Glue Studio, créez une connexion sous **Connexions de données** en suivant les étapes ci-dessous :
1. Lorsque vous sélectionnez un **type de connexion**, sélectionnez Datadog.
1. Indiquez l’`Instance_Url` de Datadog à laquelle vous souhaitez vous connecter.
1. Sélectionnez le rôle IAM pour lequel AWS Glue vous pouvez assumer et qui dispose des autorisations nécessaires pour effectuer les actions suivantes :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons.
1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau.
1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`.
# Lecture à partir d’entités Datadog
**Conditions préalables**
Un objet Datadog à partir duquel vous souhaitez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles.
**Entités prises en charge**
| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- |
| Metrics Timeseries | Oui | Non | Non | Oui | Non |
| Log Queries | Oui | Oui | Oui | Oui | Non |
**Exemple**
```
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`"
}
```
**Détails des entités et des champs Datadog**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/datadog-reading-from-entities.html)
# Options de connexion Datadog
Les options de connexion pour Datadog sont les suivantes :
+ `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Le nom de votre objet dans Datadog.
+ `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Version d’API Rest Datadog que vous souhaitez utiliser. La version `v1` prend en charge l’entité `metrics-timeseries` tandis que la version `v2` prend en charge l’entité `log-queries`.
+ `INSTANCE_URL`(Chaîne) – (Obligatoire) Utilisé pour la lecture. URL d’instance Datadog. L’URL de l’instance Datadog varie selon les régions.
+ `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet.
+ `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark.
+ `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète.
# Création d’un compte Datadog
1. Accédez à [https://www.datadoghq.com/](https://api.datadoghq.com).
1. Choisissez **COMMENCER GRATUITEMENT**.
1. Saisissez les informations requises et inscrivez-vous.
1. Installez le **programme d’installation de l’agent Datadog** comme suggéré.
1. Assurez-vous que le compte est enregistré auprès d’une organisation valide (dans la liste disponible) disposant d’un abonnement Datadog actif.
1. Une fois connecté à votre compte Datadog, survolez votre nom d’utilisateur dans le coin supérieur droit pour afficher les détails des **clés** :
1. Pour obtenir votre clé d’API, choisissez **Clés d’API**.
1. Pour obtenir votre clé d’application, choisissez **Clés d’application**.
# Limitations
Les restrictions du connecteur Datadog sont les suivantes :
+ Datadog ne prend en charge ni le partitionnement basé sur les champs ni le partitionnement basé sur les enregistrements.
+ `from` est un paramètre de filtre obligatoire pour l’entité `Log Queries`.
+ `from_to_date` et `query` sont des paramètres de filtre obligatoires pour l’entité `Metrics Timeseries`.