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 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

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	Descrizione	Esempio	Esempio di output
$__dateFilter(column)	$__dateFiltercrea un filtro condizionale che seleziona i dati (utilizzandocolumn) in base all'intervallo di date del pannello.	$__date(my_date)	my_date BETWEEN date '2017-07-18' AND date '2017-07-18'
$__parseTime(column,format)	$__parseTimelancia un varchar come timestamp con il formato dato.	$__parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z')	parse_datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z')
$__timeFilter(column,format)	$__timeFiltercrea 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.	$__timeFilter(time, 'yyyy-MM-dd HH:mm:ss')	TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z'
$__timeFrom()	$__timeFromrestituisce l'ora di inizio corrente dell'intervallo del pannello tra virgolette.	$__timeFrom()	TIMESTAMP '2017-07-18 11:15:52'
$__timeTo()	$__timeTo restituisce l'ora di fine corrente dell'intervallo del pannello tra virgolette.	$__timeTo()	TIMESTAMP '2017-07-18 11:15:52'
$__timeGroup(column, '1m', format)	$__timeGroup 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.	$__timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z')	FROM_UNIXTIME(FLOOR(TO_UNIXTIME(parse_datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)*300)
$__table	$__tablerestituisce la tabella selezionata nel selettore Tabella.	$__table	my_table
$__column	$__columnrestituisce la colonna selezionata nel selettore Colonna (richiede una tabella).	$__column	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 (utilizzandoORDER 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 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 Per ulteriori informazioni sulle variabili, consulta. Modelli e variabili

Annotazioni

Annotazioniconsentono 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	Descrizione
Time	Il nome del campo data/ora. Potrebbe essere una colonna con un tipo di dati data/ora SQL nativo o un valore epocale.
Timeend	Nome opzionale del campo data/ora di fine. Potrebbe essere una colonna con un tipo di dati di data/ora SQL nativo o un valore epocale. (Grafana v6.6+)
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 nella Guida per l'utente di Amazon Athena.