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à. # Connect a una fonte di dati Amazon Athena **Nota** Nelle aree di lavoro che supportano la versione 9 o successiva, questa fonte di dati potrebbe richiedere l'installazione del plug-in appropriato. Per ulteriori informazioni, consulta [Estendi il tuo spazio di lavoro con i plugin](grafana-plugins.md). **Nota** Questa guida presuppone che tu conosca il servizio Amazon Athena prima di utilizzare l'origine dati Athena. Con Amazon Managed Grafana, puoi aggiungere Athena come origine dati utilizzando l'opzione di configurazione dell'origine AWS dati nella console dell'area di lavoro Grafana. Questa funzionalità semplifica l'aggiunta di Athena come fonte di dati scoprendo gli account Athena esistenti e gestisce la configurazione delle credenziali di autenticazione necessarie per accedere ad Athena. Puoi utilizzare questo metodo per configurare l'autenticazione e aggiungere Athena come origine dati oppure puoi configurare manualmente l'origine dati e le credenziali di autenticazione necessarie utilizzando lo stesso metodo che faresti su un server Grafana autogestito. Esistono dei prerequisiti affinché Athena sia accessibile da Amazon Managed Grafana. Per i prerequisiti associati all'utilizzo dell'origine dati Athena, vedere. [Prerequisiti](Athena-prereq.md) # Prerequisiti Per utilizzare le policy gestite per Amazon Managed Grafana for Athena, completa le seguenti attività prima di configurare l'origine dati Athena: + Tagga i tuoi gruppi di lavoro Athena con. `GrafanaDataSource: true` + Crea un bucket S3 con un nome che inizia con. `grafana-athena-query-results-` Questa politica fornisce le autorizzazioni per scrivere i risultati delle query in un bucket S3 con quella convenzione di denominazione. Le autorizzazioni di Amazon S3 per accedere all'origine dati sottostante di una query Athena non sono incluse in questa policy gestita. È necessario aggiungere manualmente, su base regolare, le autorizzazioni necessarie per i bucket Amazon S3. case-by-case Per ulteriori informazioni, consulta [gli esempi di policy basate sull'identità in Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html) in questa guida. # Usa la configurazione dell'origine AWS dati per aggiungere Amazon Athena come origine dati ## Prerequisiti + La [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) è installata e configurata nell'ambiente in uso. + Puoi accedere ad Athena dal tuo account. Per utilizzare la configurazione dell'origine AWS dati, accedi innanzitutto alla console Amazon Managed Grafana per abilitare i ruoli IAM gestiti dal servizio che garantiscono allo spazio di lavoro le politiche IAM necessarie per leggere le risorse Athena nel tuo account o nelle tue intere unità organizzative. Quindi usi la console di lavoro Amazon Managed Grafana per aggiungere Athena come fonte di dati. # Per utilizzare la configurazione dell'origine AWS dati per aggiungere Athena come origine dati 1. Assicurati che il tuo ruolo utente sia amministratore o editor. 1. Seleziona l'area di lavoro su cui vuoi lavorare dalla console Amazon Managed Grafana all'indirizzo. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/) 1. Se non hai scelto di utilizzare le autorizzazioni gestite dal servizio per questo spazio di lavoro al momento della creazione, passa dall'utilizzo delle autorizzazioni gestite dal cliente alle autorizzazioni gestite dal servizio per garantire che i ruoli e le policy IAM appropriati siano abilitati per l'utilizzo dell'opzione di configurazione dell'origine dati AWS nella console dello spazio di lavoro Grafana. ******Per farlo, scegli l'icona di modifica in base al ruolo IAM, quindi scegli Servizio gestito, Salva modifiche.****** Per ulteriori informazioni, consulta [Autorizzazioni e policy di Amazon Managed Grafana per le fonti di dati AWS](AMG-manage-permissions.md). 1. Scegli la scheda **Fonti dati**. Seleziona quindi la casella di controllo per **Amazon Athena** e scegli **Azioni**, **Abilita policy gestita dal servizio.** 1. Scegli di nuovo la scheda **Origini dati**, quindi scegli **Configura in Grafana nella riga** **Amazon Athena**. 1. Accedi alla console dell'area di lavoro Grafana utilizzando IAM Identity Center, se necessario. L'utente deve avere la politica di accesso Athena allegata all'utente/ruolo per avere accesso all'origine dati Athena. Per ulteriori informazioni, consulta [AWS politica gestita: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess). 1. **Nella barra di navigazione a sinistra della console dell'area di lavoro Grafana, scegli l' AWS icona in basso (ce ne sono due), quindi scegli **Athena** dal menu Sorgenti dati.** 1. Seleziona la regione predefinita da cui desideri che l'origine dati Athena esegua le query, quindi seleziona gli account che desideri, quindi scegli **Aggiungi origine dati**. 1. Segui i passaggi per configurare **Athena** Details in [**Impostazioni Athena Details**](#Athena-settings) ## **Impostazioni Athena Details** **Configurare le impostazioni di **Athena Details**** 1. Nel menu **Dettagli di connessione**, seleziona il provider di autenticazione (consigliato: **Workspace IAM Role**). 1. Seleziona la fonte di dati Athena di destinazione con cui hai il tuo account Athena. Se non selezioni alcuna fonte di dati, nel menu a discesa è presente un'origine dati predefinita. Per creare un nuovo account Athena, segui le istruzioni in [Guida introduttiva](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html) ad Athena 1. Seleziona il tuo database Athena di destinazione nella fonte di dati selezionata sopra. 1. Seleziona il gruppo di lavoro. Per impostazione predefinita, è quello **primario**. 1. Se il tuo gruppo di lavoro non ha già configurato una posizione di output, specifica un bucket e una cartella S3 da utilizzare per i risultati delle query. Ad esempio, `s3://grafana-athena-plugin-test-data/query-result-output/ ` 1. Seleziona **Salva** e prova. # Aggiungere manualmente l'origine dati Athena ## Prerequisiti + La [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) è installata e configurata nell'ambiente in uso. + Puoi accedere ad **Amazon Athena** dal tuo account. **Per aggiungere manualmente l'origine dati Athena:** 1. **Nel menu laterale della console Grafana, fai una pausa sull'icona **Configurazione** (ingranaggio), quindi scegli Origini dati.** 1. Scegli **Aggiungi origine dati** 1. Scegli l'origine dati **AWS Athena**. Se necessario, puoi iniziare a digitare **Athena** nella casella di ricerca per aiutarti a trovarla. 1. Nel menu **Dettagli di connessione**, configura il provider di autenticazione (consigliato: **Workspace IAM** Role) 1. Seleziona la fonte di dati, il database e il gruppo di lavoro Athena di destinazione. Per creare un nuovo account Athena, segui le istruzioni in [Guida introduttiva ad Athena](https://docs.aws.amazon.com/athena/latest/ug/getting-started.html). 1. Se il tuo gruppo di lavoro non ha già configurato una posizione di output, specifica un bucket e una cartella S3 da utilizzare per i risultati delle query. Ad esempio, `s3://grafana-athena-plugin-test-data/query-result-output/ `. 1. Seleziona **Salva** e prova. Di seguito è riportato un esempio delle impostazioni di **Athena Details**. ![\[Esempio di Athena Details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/athena.png) # Utilizzo dell'origine dati Athena ## Policy IAM Grafana necessita delle autorizzazioni concesse tramite IAM per poter leggere le metriche di Athena. Puoi associare queste autorizzazioni ai ruoli IAM e utilizzare il supporto integrato di Grafana per l'assunzione dei ruoli. Tieni presente che dovrai [configurare la politica richiesta per il](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) tuo ruolo prima di aggiungere l'origine dati a Grafana. Avrai bisogno di un ruolo di amministratore o di editor per aggiungere una fonte di dati. La policy di accesso integrata di Amazon Grafana Athena è definita nella sezione. [AWS politica gestita: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) ## Interroga i dati di Athena L'origine dati Athena fornisce un editor di query SQL standard. Amazon Managed Grafana include alcune macro per facilitare la scrittura di query su serie temporali più complesse. Macro | Macro | Description | Esempio | Esempio di output | | --- | --- | --- | --- | | \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltercrea un filtro condizionale che seleziona i dati (utilizzandocolumn) in base all'intervallo di date del pannello. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | | \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimelancia un varchar come timestamp con il formato dato. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') | | \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFiltercrea un condizionale che filtra i dati (utilizzandocolumn) in base all'intervallo di tempo del pannello. Il secondo argomento viene utilizzato per analizzare facoltativamente la colonna da un varchar a un timestamp con un formato specifico. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' | | \$1\$1\$1timeFrom() | \$1\$1\$1timeFromrestituisce l'ora di inizio corrente dell'intervallo del pannello tra virgolette. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeTo() | \$1\$1\$1timeTo restituisce l'ora di fine corrente dell'intervallo del pannello tra virgolette. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup raggruppa i timestamp in modo che ci sia solo 1 punto per ogni periodo del grafico. Il terzo argomento viene utilizzato per analizzare facoltativamente la colonna da un varchar a un timestamp con un formato specifico. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) | | \$1\$1\$1table | \$1\$1\$1tablerestituisce la tabella selezionata nel selettore Tabella. | \$1\$1\$1table | my\$1table | | \$1\$1\$1column | \$1\$1\$1columnrestituisce la colonna selezionata nel selettore Colonna (richiede una tabella). | \$1\$1\$1column | col1 | **Visualizzazione** La maggior parte delle interrogazioni in Athena sarà rappresentata al meglio da una visualizzazione tabellare. Una query visualizza i dati restituiti in una tabella. Se può essere interrogata, può essere visualizzata come tabella. Questo esempio restituisce i risultati per la visualizzazione di una tabella: ``` SELECT {column_1}, {column_2} FROM {table}; ``` **Visualizzazioni di serie temporali/ grafici** Per le serie temporali e le visualizzazioni grafiche, è necessario: + seleziona una colonna con un o un `date` tipo. `datetime` La `date` colonna deve essere in ordine crescente (utilizzando`ORDER BY column ASC`). + seleziona anche una colonna numerica. **Ispezione dell'interrogazione** Amazon Managed Grafana supporta macro che Athena non supporta, il che significa che una query potrebbe non funzionare se copiata e incollata direttamente in Athena. **Per visualizzare l'interrogazione interpolata completa, che funziona direttamente in Athena, fate clic sul pulsante Query Inspector.** **L'interrogazione completa viene visualizzata nella scheda Query.** ## Modelli e variabili Per ulteriori informazioni sull'aggiunta di una variabile di query Athena, vedere. [Aggiungere una variabile di query](variables-types.md#add-a-query-variable) Usa la tua fonte dati Athena come fonte di dati per le query disponibili. Qualsiasi valore richiamato da una tabella Athena può essere usato come variabile. Evita di selezionare troppi valori, poiché ciò può causare problemi di prestazioni. Dopo aver creato una variabile, puoi usarla nelle tue query Athena utilizzando. [Sintassi variabile](templates-and-variables.md#variable-syntax) Per ulteriori informazioni sulle variabili, consulta. [Modelli e variabili](templates-and-variables.md) ## Annotazioni [Annotazioni](dashboard-annotations.md)consentono di sovrapporre informazioni dettagliate sugli eventi sopra i grafici. ****È possibile aggiungere annotazioni selezionando il pannello o aggiungendo query di annotazione utilizzando la vista Annotazioni del menu Dashboard.**** Un esempio di query per aggiungere automaticamente annotazioni: ``` SELECT time as time, environment as tags, humidity as text FROM tableName WHERE $__dateFilter(time) and humidity > 95 ``` La tabella seguente rappresenta le descrizioni delle colonne che possono essere utilizzate per il rendering delle annotazioni: | Nome | Description | | --- | --- | | Time | Il nome del date/time campo. Potrebbe essere una colonna con un tipo di date/time dati SQL nativo o un valore epocale. | | Timeend | Nome opzionale del date/time campo finale. Potrebbe essere una colonna con un tipo di date/time dati SQL nativo o un valore epocale. (Grafana v6.6\$1) | | Text | Campo di descrizione dell'evento. | | Tags | Nome di campo opzionale da utilizzare per i tag degli eventi come stringa separata da virgole. | ## Supporto per dati di interrogazione asincrona Le query Athena in Amazon Managed Grafana vengono gestite in modo asincrono per evitare i timeout. Le query asincrone utilizzano richieste separate per avviare la query, verificarne lo stato di avanzamento e infine recuperare i risultati. In questo modo si evitano i timeout per le query che vengono eseguite per un lungo periodo. ## Riutilizzo dei risultati delle query È possibile riutilizzare i risultati delle query precedenti per migliorare le prestazioni delle query. Per abilitare il riutilizzo delle query, enable si trova nella sezione **Riutilizzo dei risultati delle query** dell'editor di query. Questa operazione deve essere eseguita per ogni query per la quale si desidera riutilizzare le query. **Nota** Questa funzionalità richiede che l'istanza Athena sia nella versione del motore 3. Per ulteriori informazioni, consulta [Modifica delle versioni del motore Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) nella Guida per l'utente di *Amazon Athena*.