Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Connessione a Datadog
Datadog è una piattaforma di monitoraggio e analisi per applicazioni su scala cloud, come infrastrutture, applicazioni, servizi e strumenti.
**Topics**
+ [AWS Glue supporto per Datadog](datadog-support.md)
+ [Policy contenenti le operazioni API per creare e utilizzare le connessioni](datadog-configuring-iam-permissions.md)
+ [Configurazione di Datadog](datadog-configuring.md)
+ [Configurazione delle connessioni Datadog](datadog-configuring-connections.md)
+ [Leggere dalle entità Datadog](datadog-reading-from-entities.md)
+ [Opzioni di connessione a Datadog](datadog-connection-options.md)
+ [Creazione di un account Datadog](datadog-create-account.md)
+ [Limitazioni](datadog-connector-limitations.md)
# AWS Glue supporto per Datadog
AWS Glue supporta Datadog come segue:
**Supportato come origine?**
Sì. È possibile utilizzare i job AWS Glue ETL per interrogare i dati da Datadog.
**Supportato come destinazione?**
No.
**Versioni dell'API Datadog supportate**
+ v1
+ v2
# Policy contenenti le operazioni API per creare e utilizzare le connessioni
La seguente politica di esempio descrive le AWS autorizzazioni richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
In alternativa, se non desideri utilizzare il metodo precedente, utilizza le seguenti policy IAM:
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che diversi AWS Glue processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono Amazon S3 AWS Glue, IAM, CloudWatch Logs e Amazon EC2. Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni necessarie. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la politica utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console.
# Configurazione di Datadog
Prima di poter AWS Glue utilizzare il trasferimento da Datadog, è necessario soddisfare i seguenti requisiti:
## Requisiti minimi
+ Hai un account Datadog con e. DD-API-KEY DD-APPLICATION-KEY Per ulteriori informazioni sulla creazione di account, consulta [Creazione di un account Datadog](datadog-create-account.md).
+ L'account Datadog dispone dell'accesso all'API con una licenza valida.
Datadog supporta i seguenti sei. URLs Tutti i client API Datadog sono configurati di default per utilizzare il sito Datadog. US1 APIs Se ti trovi sul sito Datadog EU, devi selezionare l'URL https://api.datadoghq.eu con la fine del `DD-API-KEY` sito Datadog EU per `DD-APPLICATION-KEY` accedere a. APIs Allo stesso modo, per altri siti, è necessario selezionare il rispettivo sito URLs con il `DD-API-KEY and DD-APPLICATION-KEY` rispettivo sito.
+ 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 DELL'API — [https://api.us3.datadoghq.com](https://api.us3.datadoghq.com)
+ US5 URL DELL'API — [https://api.us5.datadoghq.com](https://api.us5.datadoghq.com)
+ URL DELL'API S1-FED — [https://api.ddog-gov.com](https://api.ddog-gov.com)
+ URL dell'API per il Giappone — [https://api.ap1.datadoghq.com](https://api.ap1.datadoghq.com)
Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Datadog.
# Configurazione delle connessioni Datadog
Datadog supporta l'autenticazione personalizzata. Di seguito sono riportati i passaggi per configurare la connessione a Datadog:
Per configurare una connessione Datadog:
1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli:
Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `API_KEY` e `APPLICATION_KEY` come chiavi.
**Nota**
È necessario creare un segreto per ogni connessione in AWS Glue.
1. In AWS Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti:
1. In **Tipo di connessione**, seleziona Datadog.
1. Fornisci `Instance_Url` di Datadog a cui desideri connetterti.
1. Seleziona il ruolo IAM per il quale AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token.
1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete.
1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro.
# Leggere dalle entità Datadog
**Prerequisiti**
Un oggetto Datadog da cui si desidera leggere. Consulta la tabella delle entità supportate qui di seguito per verificare quelle disponibili.
**Entità supportate**
| Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento |
| --- | --- | --- | --- | --- | --- |
| Serie temporali metriche | Sì | No | No | Sì | No |
| Registrare query | Sì | Sì | Sì | Sì | No |
**Esempio**
```
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`"
}
```
**Dettagli dell'entità e del campo di Datadog**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/datadog-reading-from-entities.html)
# Opzioni di connessione a Datadog
Di seguito sono riportate le opzioni di connessione per Datadog:
+ `ENTITY_NAME`(Stringa): (obbligatorio) utilizzato per lettura/scrittura. Il nome del tuo oggetto in Datadog.
+ `API_VERSION`(Stringa): (obbligatorio) utilizzato per lettura/scrittura. La versione Datadog Rest API che desideri utilizzare. La versione `v1` supporta l'entità `metrics-timeseries`, mentre la versione `v2` supporta l'entità `log-queries`.
+ `INSTANCE_URL`(Stringa): (obbligatorio) utilizzato per la lettura. URL dell'istanza Datadog. L'URL dell'istanza Datadog varia in base alla regione.
+ `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne da selezionare per l'oggetto.
+ `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Dev'essere in formato Spark SQL.
+ `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query Spark SQL completa.
# Creazione di un account Datadog
1. Vai a [https://www.datadoghq.com/](https://api.datadoghq.com).
1. Scegli **INIZIA GRATUITAMENTE**.
1. Inserisci le informazioni richieste e registrati.
1. Installa il **programma di installazione dell'agente di Datadog** come suggerito.
1. Assicurarsi che l'account venga registrato all'interno di un'organizzazione valida (dall'elenco disponibile) che dispone di un abbonamento attivo a Datadog.
1. Dopo aver effettuato l'accesso al tuo account Datadog, passa con il mouse sul tuo nome utente nell'angolo in alto a destra per visualizzare i dettagli delle **chiavi**:
1. Per ottenere la tua chiave API, seleziona **Chiavi API**.
1. Per ottenere la chiave dell'applicazione, seleziona **Chiavi dell'applicazione**.
# Limitazioni
Di seguito sono riportate le limitazioni per il connettore di Datadog:
+ Datadog non supporta il partizionamento basato su campi o record.
+ `from` è un parametro di filtro obbligatorio per l'entità `Log Queries`.
+ `from_to_date` e `query` sono parametri di filtro obbligatori per l'entità `Metrics Timeseries`.