Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Herstellen einer Verbindung zu Datadog
Datadog ist eine Überwachungs- und Analytikplattform für Cloud-Anwendungen, einschließlich Infrastruktur, Anwendungen, Services und Tools.
**Topics**
+ [AWS Glue Unterstützung für Datadog](datadog-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](datadog-configuring-iam-permissions.md)
+ [Konfigurieren von Datadog](datadog-configuring.md)
+ [Konfigurieren von Datadog-Verbindungen](datadog-configuring-connections.md)
+ [Lesen aus Datadog-Entitäten](datadog-reading-from-entities.md)
+ [Datadog-Verbindungsoptionen](datadog-connection-options.md)
+ [Erstellen eines Datadog-Kontos](datadog-create-account.md)
+ [Einschränkungen](datadog-connector-limitations.md)
# AWS Glue Unterstützung für Datadog
AWS Glue unterstützt Datadog wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten von Datadog abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Datadog-API-Versionen**
+ v1
+ v2
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Wenn Sie die vorstehende Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, an die die Richtlinie angehängt ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird in der Regel Benutzern der AWS Glue Konsole zugewiesen.
# Konfigurieren von Datadog
Bevor Sie die Übertragung von Datadog verwenden AWS Glue können, müssen Sie die folgenden Anforderungen erfüllen:
## Mindestanforderungen
+ Sie haben ein Datadog-Konto mit und. DD-API-KEY DD-APPLICATION-KEY Weitere Informationen zum Erstellen eines Kontos finden Sie unter [Erstellen eines Datadog-Kontos](datadog-create-account.md).
+ Ihr Datadog-Konto verfügt über API-Zugriff mit einer gültigen Lizenz.
Datadog unterstützt die folgenden sechs. URLs Alle Datadog-API-Clients sind standardmäßig so konfiguriert, dass sie die Datadog-Site nutzen. US1 APIs Wenn Sie sich auf der Datadog EU-Site befinden, müssen Sie die URL https://api.datadoghq.eu mit dem Ende der `DD-API-KEY` Datadog EU-Site auswählen, um auf die zuzugreifen. `DD-APPLICATION-KEY` APIs In ähnlicher Weise sollten Sie für andere Websites die jeweilige URLs mit `DD-API-KEY and DD-APPLICATION-KEY` der jeweiligen Site auswählen.
+ 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)
+ API-URL MIT S1-FED — [https://api.ddog-gov.com](https://api.ddog-gov.com)
+ Japan API-URL — [https://api.ap1.datadoghq.com](https://api.ap1.datadoghq.com)
Wenn Sie diese Anforderungen erfüllen, sind Sie bereit, eine Verbindung AWS Glue zu Ihrem Datadog-Konto herzustellen.
# Konfigurieren von Datadog-Verbindungen
Datadog unterstützt benutzerdefinierte Authentifizierung. Im Folgenden finden Sie die Schritte zur Konfiguration der Datadog-Verbindung:
Konfigurieren einer Datadog-Verbindung:
1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:
Für kundenseitig verwaltete verbundene App – Geheimnis muss das Verbrauchergeheimnis der verbundenen App mit `API_KEY` und `APPLICATION_KEY` als Schlüssel enthalten.
**Anmerkung**
Sie müssen für jede Verbindung in AWS Glue ein Geheimnis erstellen.
1. Erstellen Sie in AWS Glue Studio unter **Datenverbindungen** eine Verbindung, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie als **Verbindungstyp** Datadog aus.
1. Geben Sie die `Instance_Url` von Datadog an, zu der eine Verbindung hergestellt werden soll.
1. Wählen Sie die IAM-Rolle aus, für die AWS Glue Sie die folgenden Aktionen übernehmen können und über Berechtigungen verfügen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.
1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.
1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.
# Lesen aus Datadog-Entitäten
**Voraussetzungen**
Ein Datadog-Objekt, aus dem gelesen werden soll. In der folgenden Tabelle mit unterstützten Entitäten können Sie die verfügbaren Entitäten überprüfen.
**Unterstützte Entitäten**
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Metrikzeitreihen | Ja | Nein | Nein | Ja | Nein |
| Abfragen protokollieren | Ja | Ja | Ja | Ja | Nein |
**Beispiel**
```
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-Entitäts- und Felddetails**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/datadog-reading-from-entities.html)
# Datadog-Verbindungsoptionen
Im Folgenden sind Verbindungsoptionen für Datadog aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Der Name Ihres Objekts in Datadog.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen/Schreiben verwendet. Version der Datadog-Rest-API, die Sie verwenden möchten. Version `v1` unterstützt Entität `metrics-timeseries`, während Version `v2` Entität `log-queries` unterstützt.
+ `INSTANCE_URL` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Datadog-Instance-URL. Die URL der Datadog-Instance variiert je nach Region.
+ `SELECTED_FIELDS`(Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
# Erstellen eines Datadog-Kontos
1. Gehe zu [https://www.datadoghq.com/](https://api.datadoghq.com).
1. Wählen Sie **GET STARTED FREE** aus.
1. Geben Sie die erforderlichen Informationen ein und registrieren Sie sich.
1. Installieren Sie mit dem **Datadog-Agent-Installationsprogramm** wie vorgeschlagen.
1. Stellen Sie sicher, dass das Konto bei einer gültigen Organisation (aus der verfügbaren Liste) registriert ist, die über ein aktives Datadog-Abonnement verfügt.
1. Nachdem Sie sich bei Ihrem Datadog-Konto angemeldet haben, bewegen Sie den Mauszeiger oben rechts über Ihren Benutzernamen, um die **Schlüsseldetails** anzuzeigen:
1. Wählen Sie **API-Schlüssel** aus, um Ihren API-Schlüssel zu erhalten.
1. Wählen Sie **Anwendungsschlüssel** aus, um Ihren Anwendungsschlüssel zu erhalten.
# Einschränkungen
Die folgenden Einschränkungen gelten für den Datadog-Connector:
+ Datadog unterstützt weder feldbasierte noch datensatzbasierte Partitionierung.
+ `from` ist ein obligatorischer Filterparameter für die `Log Queries`-Entität.
+ `from_to_date` und `query` sind obligatorische Filterparameter für die `Metrics Timeseries`-Entität.