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 un'origine dati PostgreSQL

Puoi utilizzare l'origine dati PostgreSQL per interrogare e visualizzare i dati dai tuoi database Amazon Aurora PostgreSQL.

Aggiungere la fonte di dati

Opzioni relative all'origine dei dati

Intervallo di tempo minimo

Un limite inferiore per le $_interval $_interval_ms variabili. Si consiglia di impostare la frequenza di scrittura, ad esempio 1m se i dati vengono scritti ogni minuto. Questa opzione può anche essere sovrascritta/configurata in un pannello del dashboard sotto le opzioni dell'origine dati. Questo valore deve essere formattato come un numero seguito da un identificatore temporale valido, ad esempio 1m (1 minuto) o (30 secondi). 30s Sono supportati i seguenti identificatori di orario.

Autorizzazioni utente del database

Il codice di esempio seguente mostra la creazione di un utente PostgreSQL specifico con autorizzazioni limitate.

 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;

Assicurati che l'utente non ottenga autorizzazioni indesiderate dal ruolo pubblico.

Editor della query

Puoi trovare l'editor di query PostgreSQL nella scheda metriche nella modalità di modifica del pannello Graph o Singlestat. Si accede alla modalità di modifica scegliendo il titolo del pannello, quindi modificando.

L'editor di query ha un collegamento SQL generato che viene visualizzato dopo l'esecuzione di una query, in modalità di modifica del pannello. Sceglilo e si espanderà e mostrerà la stringa SQL interpolata non elaborata che è stata eseguita.

Seleziona tabella, colonna temporale e colonna metrica (FROM)

Quando si accede alla modalità di modifica per la prima volta o si aggiunge una nuova query, Grafana proverà a precompilare il generatore di query con la prima tabella che ha una colonna timestamp e una colonna numerica.

Nel campo FROM, Grafana suggerirà le tabelle presenti nell'utente search_path del database. Per selezionare una tabella o una vista non presente, search_path è possibile inserire manualmente un nome completo (schema.table) come. public.metrics

Il campo della colonna Ora si riferisce al nome della colonna contenente i valori temporali. La selezione di un valore per il campo della colonna Metrica è facoltativa. Se viene selezionato un valore, il campo della colonna Metrica verrà utilizzato come nome della serie.

Le colonne metriche suggerite conterranno solo colonne con un tipo di dati testuale (char, varchar, text). Per utilizzare una colonna con un tipo di dati diverso come colonna metrica, puoi inserire il nome della colonna con un cast:. ip::text Puoi anche inserire espressioni SQL arbitrarie nel campo della colonna metrica che restituiscono un tipo di dati di testo come. hostname || ' ' || container_name

Colonne, finestre e funzioni di aggregazione (SELECT)

Nella SELECT riga, puoi specificare quali colonne e funzioni desideri utilizzare. Nel campo della colonna, è possibile scrivere espressioni arbitrarie anziché un nome di colonna comecolumn1 * column2 / column3.

Le funzioni disponibili nell'editor di query dipendono dalla versione di PostgreSQL selezionata durante la configurazione dell'origine dati. Se si utilizzano funzioni aggregate, è necessario raggruppare il set di risultati. Se aggiungi una funzione aggregata, l'editor aggiungerà automaticamente una. GROUP BY time

L'editor cerca di semplificare e unificare questa parte della query.

Puoi aggiungere altre colonne di valori scegliendo il pulsante più e selezionando Colonna dal menu. Le colonne con valori multipli verranno tracciate come serie separate nel pannello grafico.

Filtraggio dei dati (WHERE)

Per aggiungere un filtro, scegli l'icona con il segno più a destra della WHERE condizione. Puoi rimuovere i filtri scegliendo il filtro e selezionando Rimuovi. Un filtro per l'intervallo di tempo attualmente selezionato viene aggiunto automaticamente alle nuove interrogazioni.

Raggruppa per

Per raggruppare in base all'ora o a qualsiasi altra colonna, scegli l'icona più alla fine della riga GROUP BY. L'elenco a discesa dei suggerimenti mostrerà solo le colonne di testo della tabella attualmente selezionata, ma puoi inserire manualmente qualsiasi colonna. Puoi rimuovere il gruppo scegliendo l'elemento e selezionando Rimuovi.

Se aggiungi un raggruppamento, a tutte le colonne selezionate deve essere applicata una funzione di aggregazione. Il generatore di query aggiungerà automaticamente funzioni di aggregazione a tutte le colonne senza funzioni di aggregazione quando si aggiungono raggruppamenti.

Riempimento degli

Amazon Managed Grafana può inserire i valori mancanti quando esegui il raggruppamento per fascia oraria. La funzione time accetta due argomenti. Il primo argomento è la finestra temporale in base alla quale vuoi raggruppare e il secondo argomento è il valore con cui vuoi che Grafana riempia gli elementi mancanti.

Modalità editor di testo (RAW)

Puoi passare alla modalità editor di query raw scegliendo l'icona a forma di hamburger e selezionando Cambia modalità editor o scegliendo Modifica SQL sotto la query.

Macro

Le macro possono essere utilizzate all'interno di una query per semplificare la sintassi e consentire l'utilizzo di parti dinamiche.

Interrogazioni sulla tabella

Se l'opzione di interrogazione è impostata su Formato come tabella, puoi praticamente eseguire qualsiasi tipo di query SQL. Il pannello della tabella mostrerà automaticamente i risultati delle colonne e delle righe restituite dalla query.

È possibile controllare il nome delle colonne del pannello Tabella utilizzando la normale sintassi as SQL per la selezione delle colonne.

Interrogazioni sulle serie temporali

Se impostate Format as toTime series, per utilizzarla ad esempio in un pannello grafico, la query deve restituire una colonna denominata time che restituisca un datetime SQL o qualsiasi tipo di dati numerico che rappresenti l'epoca Unix. Qualsiasi colonna tranne time e metric viene trattata come una colonna di valori. È possibile restituire una colonna denominata metric che viene utilizzata come nome metrico per la colonna dei valori. Se restituite più colonne di valori e una colonna denominatametric, questa colonna viene utilizzata come prefisso per il nome della serie.

I set di risultati delle query sulle serie temporali devono essere ordinati in base all'ora.

Il codice di esempio seguente mostra una metric colonna.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

Il seguente esempio di codice mostra l'utilizzo del parametro fill nella macro $__TimeGroup per convertire invece i valori null in zero.

SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time

Il codice di esempio seguente mostra più colonne.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

Templating

Invece di inserire elementi come il nome del server, dell'applicazione e del sensore nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come caselle di selezione a discesa nella parte superiore della dashboard. Puoi utilizzare queste caselle a discesa per modificare i dati visualizzati nella dashboard.

Per ulteriori informazioni sui modelli e sulle variabili dei modelli, consulta. Modelli

Variabile di interrogazione

Se aggiungi una variabile modello di questo tipoQuery, puoi scrivere una query PostgreSQL in grado di restituire elementi come nomi di misurazioni, nomi di chiavi o valori chiave che vengono visualizzati come una casella di selezione a discesa.

Ad esempio, puoi avere una variabile che contiene tutti i valori per la hostname colonna in una tabella se specifichi una query come questa nell'impostazione della variabile di modello Query.

SELECT hostname FROM host

Una query può restituire più colonne e Grafana creerà automaticamente un elenco da esse. Ad esempio, la seguente query restituirà un elenco con valori da hostname ehostname2.

SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city

Per utilizzare macro dipendenti dall'intervallo di tempo, ad esempio $__timeFilter(column) nella query, la modalità di aggiornamento della variabile modello deve essere impostata su On Time Range Change.

SELECT event_name FROM event_log WHERE $__timeFilter(time_column)

Un'altra opzione è una query che può creare una variabile chiave/valore. La query dovrebbe restituire due colonne __text denominate e. __value Il valore della __text colonna deve essere univoco (se non è univoco, viene utilizzato il primo valore). Le opzioni nell'elenco a discesa avranno un testo e un valore che ti permetteranno di avere un nome descrittivo come testo e un id come valore. Un esempio di query con hostname come testo e id come valore:

SELECT hostname AS __text, id AS __value FROM host

È inoltre possibile creare variabili annidate. Utilizzando una variabile denominataregion, è possibile fare in modo che la variabile hosts mostri solo gli host della regione attualmente selezionata. Il seguente esempio di codice mostra una query come questa (se region è una variabile multivalore, utilizzate l'operatore di IN confronto anziché = eseguire la corrispondenza con più valori).

SELECT hostname FROM host  WHERE region IN($region)

Utilizzo __searchFilter per filtrare i risultati in Query Variable

L'utilizzo __searchFilter nel campo di interrogazione filtrerà il risultato della query in base a ciò che l'utente digita nella casella di selezione a discesa. Quando l'utente non ha inserito nulla, il valore predefinito per __searchFilter è%.

L'esempio seguente mostra come utilizzare, __searchFilter come parte del campo di interrogazione, la ricerca hostname mentre l'utente digita nella casella di selezione a discesa.

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

Utilizzo delle variabili nelle interrogazioni

I valori delle variabili modello vengono citati solo quando la variabile modello è a. multi-value

Se la variabile è una variabile multivalore, utilizza l'operatore di IN confronto anziché = eseguire il confronto con più valori.

Esistono due sintassi:

$<varname>Esempio con una variabile modello denominatahostname:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

[[varname]]Esempio con una variabile modello denominatahostname:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC

Disattivazione delle virgolette per le variabili multivalore

Amazon Managed Grafana crea automaticamente una stringa tra virgole e virgole per variabili multivalore. Ad esempio: se server02 sono selezionati server01 e, verranno formattati come:. 'server01', 'server02' Per disattivare le virgolette, usa l'opzione di formattazione csv per le variabili.

${servers:csv}

Per ulteriori informazioni sulle opzioni di formattazione delle variabili, vedere. Modelli e variabili

Annotazioni

Utilizzate le annotazioni per sovrapporre informazioni dettagliate sugli eventi ai grafici. È possibile aggiungere interrogazioni di annotazione tramite il menu Dashboard /la vista Annotazioni. Per ulteriori informazioni, consulta Annotazioni.

Il codice di esempio seguente mostra una query che utilizza una colonna temporale con valori epoch.

SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

Il codice di esempio seguente mostra una query regionale che utilizza le colonne time e timeend con valori epoch.

SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

Il codice di esempio seguente mostra una query che utilizza una colonna time del tipo di dati data/ora SQL nativo.

SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

Avviso

Le interrogazioni sulle serie temporali dovrebbero funzionare in condizioni di avviso. Le interrogazioni in formato tabella non sono ancora supportate nelle condizioni delle regole di avviso.