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 Wavefront (VMware Tanzu Observability by Wavefront)
La fonte di dati Wavefront (VMware Tanzu Observability by Wavefront) consente agli utenti di Amazon Managed Grafana di interrogare e visualizzare i dati che stanno raccogliendo direttamente da Wavefront e di visualizzarli facilmente insieme a qualsiasi altra metrica, registro, tracciamento o altra fonte di dati. Questa visualizzazione flessibile a riquadro singolo semplifica il monitoraggio dello stato del sistema e dei problemi di debug.
**Nota**
Questa fonte di dati è solo per Grafana Enterprise. Per ulteriori informazioni, consulta [Gestisci l'accesso ai plugin Enterprise](upgrade-to-enterprise-plugins.md).
Inoltre, 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).
## Che cos'è Wavefront?
[Wavefront](https://www.wavefront.com) è uno strumento di monitoraggio e analisi del cloud sviluppato da VMware. Wavefront è un servizio ospitato nel cloud che consente di inviare dati di serie temporali (metrici) da collectD, StatSD, JMX, Ruby's logger o altri strumenti. AWS Con Wavefront, gli utenti possono eseguire operazioni matematiche su tali serie, eseguire il rendering di grafici per visualizzare le anomalie, tracciare i KPI e creare avvisi.
## Massimizza il tuo stack tecnologico con Wavefront e Grafana
Sebbene in apparenza Grafana e Wavefront sembrino simili, molte organizzazioni utilizzano sia Wavefront che Grafana come parti fondamentali dei loro flussi di lavoro di osservabilità.
**Visualizza senza spostare le fonti di dati:** l'esclusiva architettura di Grafana interroga i dati direttamente dove risiedono anziché spostarli e pagare per lo storage e l'ingestione ridondanti.
**Componi pannelli da varie fonti** Con dashboard preconfigurate e personalizzate, riunisci i dati provenienti da molte fonti di dati diverse in un unico pannello di vetro.
**Trasformazione ed elaborazione a livello di utente:** gli utenti possono trasformare i dati ed eseguire vari calcoli sui dati che vedono, richiedendo una minore preparazione dei dati.
**Combina, calcola e visualizza all'interno dei pannelli: crea pannelli di sorgenti di dati misti che visualizzano** dati correlati da Waveferont e altre fonti, come Prometheus e InfluxDB.
## Documentazione
### Funzionalità
+ Visualizzazioni di serie temporali
+ Visualizzazioni di tabelle
+ Visualizzazioni Heatmap
+ Visualizzazioni a statistica singola
+ Editor di interrogazioni guidate
+ Editor di query WQL non elaborato
+ Annotazioni per i dati degli eventi
+ Variabili del modello
+ Ad-Hoc Filtri
+ Avviso
### Configurazione
La configurazione della sorgente dati Wavefront è relativamente semplice. Sono necessari solo due campi per completare la configurazione: e. `API URL` `Token`
+ `API URL`sarà l'URL che utilizzerai per accedere al tuo ambiente wavefront. Esempio: `https://myenvironment.wavefront.com`.
+ `Token`deve essere generato da un account utente o da un account di servizio.
1. **Per creare un token basato su un account utente, accedi al tuo ambiente Wavefront, scegli l'ingranaggio nell'angolo in alto a destra della pagina, scegli il tuo nome utente (ad esempio,`me@grafana.com`), seleziona la scheda **Accesso API** nella parte superiore della pagina utente, quindi copia una chiave esistente o scegli genera.**
1. Per creare un token basato su un account di servizio, accedi al tuo ambiente Wavefront, scegli l'ingranaggio nell'angolo in alto a destra della pagina, scegli la gestione dell'account. Nella barra di navigazione a sinistra, seleziona **Account, gruppi e ruoli**, scegli la scheda **Account di servizio** in alto, quindi scegli **Crea** nuovo account. Inserisci un nome per l'account di servizio. Questo può essere tutto quello che vuoi. Copia il token fornito nella sezione **Token**.
1. L'ultimo passaggio consiste nell'assicurarsi che la casella di controllo **Account, gruppi e ruoli** sia selezionata in **Autorizzazioni**.
Dopo aver ottenuto il token, aggiungilo al campo `Token` di configurazione e dovresti essere pronto\!
La pagina di configurazione definitiva dovrebbe essere simile alla seguente:
### Utilizzo
#### Utilizzo dell’editor della query
**L'editor di query Wavefront ha due modalità: Query **Builder e Raw Query**.** Per passare da una all'altra, usa il selettore in alto a destra del modulo di interrogazione:
In modalità **Query Builder**, ti verranno presentate quattro scelte da fare:
1. Quale metrica vuoi interrogare?
1. Quale aggregazione vuoi eseguire su quella metrica?
1. Come vuoi filtrare i risultati di quella query metrica?
1. Vuoi applicare funzioni aggiuntive al risultato?
Il selettore delle metriche è una gerarchia categorizzata. Seleziona una categoria, quindi scegli di nuovo per approfondire le sottocategorie. Ripeti questo processo fino a raggiungere la metrica desiderata.
Dopo aver selezionato una metrica, i filtri e i valori dei filtri disponibili verranno compilati automaticamente.
**In modalità **Raw Query**, vedrai un singolo campo denominato Query.** Ciò consente di eseguire qualsiasi query [WQL](#wavefront-references) desiderata.
#### Utilizzo dei filtri
Il plugin Wavefront interrogherà dinamicamente i filtri appropriati per ogni metrica.
Per aggiungere un filtro, scegli il **\+** accanto all'etichetta **Filtri** nell'editor di query Wavefront, seleziona il campo in base al quale vuoi filtrare e seleziona un valore in base al quale filtrare.
#### Utilizzo delle funzioni
Le funzioni forniscono un modo aggiuntivo per aggregare, manipolare ed eseguire calcoli sui dati di risposta metrica. **Per visualizzare le funzioni disponibili, scegliete l'elenco a discesa accanto all'etichetta della funzione in Query Builder.** In base alla funzione selezionata, sarai in grado di eseguire ulteriori azioni come l'impostazione di un gruppo per campo o l'applicazione di soglie. Gli utenti sono in grado di concatenare più funzioni per eseguire calcoli avanzati o manipolazioni dei dati.
#### Aggiungere una variabile del modello di interrogazione
1. Per creare una nuova variabile di modello Wavefront per una dashboard, scegli l'ingranaggio delle impostazioni nella parte in alto a destra della dashboard.
1. **Nel pannello a sinistra, scegli Variabili.**
1. Nella parte superiore destra della pagina Variabili, scegli **Nuovo**.
1. Inserisci un **nome** e un'**etichetta** per la variabile modello che desideri creare. **Name** è il valore che utilizzerai all'interno delle query per fare riferimento alla variabile del modello. **Label** è un nome intuitivo da visualizzare per la variabile modello nel pannello di selezione della dashboard.
1. Seleziona il tipo **Query** per il campo del tipo (dovrebbe essere selezionato per impostazione predefinita).
1. Sotto l'intestazione **Opzioni di interrogazione**, seleziona **Wavefront** nell'elenco a discesa **Data source**.
1. **Vedi [Template Variable Query Structure](#template-variable-query-structure) per i dettagli su cosa inserire nel campo Query.**
1. Se desideri filtrare uno qualsiasi dei valori restituiti dalla tua query, inserisci un'espressione regolare nel campo di immissione **Regex**.
1. Applica le preferenze di ordinamento che potresti avere scegliendo un tipo di ordinamento nell'elenco a discesa **Ordina**.
1. Dopo aver verificato la configurazione, scegli **Aggiungi** per aggiungere la variabile modello, quindi scegli **Salva dashboard** nel pannello di navigazione a sinistra per salvare le modifiche.
#### Struttura di interrogazione variabile del modello
elenchi di metriche: metriche: ts (...)
elenchi di fonti: fonti: ts (...)
elenchi di tag di origine: sourceTags: ts (...)
elenchi di tag sorgente corrispondenti: matchingSourceTags: ts (...)
elenchi di nomi di tag: tagNames: ts (...)
liste valori tag: tagValues (): ts (...)
**Note**
+ La s alla fine di ogni tipo di query è facoltativa
+ Support per tutte le lettere minuscole. Puoi usare tagnames o tagNames, ma non TAGNAMES.
+ L'uso di spazi attorno a: è facoltativo
**ATTENZIONE**
`Multi-value`e attualmente non `Include All option` sono supportati dal plugin Wavefront.
#### Utilizzo di variabili modello
Dopo aver completato i passaggi per [aggiungere una nuova variabile modello](#wavefront-adding-a-query-template-variable-1), ora sei pronto per utilizzare la variabile modello nei pannelli della dashboard per creare visualizzazioni dinamiche.
1. Aggiungi un nuovo pannello di controllo utilizzando l'icona panel\+ nell'angolo in alto a destra della dashboard.
1. Seleziona l'aggregato che desideri utilizzare per la tua query.
1. Scegli l'icona \+ accanto all'etichetta **Filtri** e seleziona il tipo di chiave che corrisponde alla variabile del modello. `host=`per un filtro host, ad esempio.
1. Inserisci il nome della variabile modello che hai creato nel campo di immissione **Valore** del filtro.
1. Salva la dashboard.
Ora dovresti essere in grado di scorrere tra i diversi valori della variabile del modello e aggiornare il pannello dinamicamente\!
#### Usare i filtri Ad-Hoc
Per utilizzare filtri ad hoc, dobbiamo creare due variabili di modello. La prima è una variabile di supporto che verrà utilizzata per selezionare una metrica in modo che i filtri aggiuntivi possano essere compilati per quel nome di metrica. L'altra sarà l'effettiva variabile di filtro ad hoc.
**Importante**
La variabile di supporto richiesta deve essere denominata. `metriclink` Può essere una variabile personalizzata con l'elenco delle metriche che desideri utilizzare o una variabile basata su query che utilizza la struttura delle [query della variabile modello](#template-variable-query-structure). Se desideri compilare i campi di filtro ad hoc solo con i valori di una singola metrica, puoi nascondere la variabile modello. `metriclink`
[Dopo aver creato la `metriclink` variabile, ora puoi aggiungere il filtro ad hoc seguendo gli stessi passaggi descritti in Aggiungere una variabile del modello di query.](#wavefront-adding-a-query-template-variable-1) La differenza è che selezionerai **Filtri ad hoc** come **Tipo** e non sono richiesti input per una query.
#### Aggiungere annotazioni
1. Per creare una nuova annotazione Wavefront per una dashboard, scegli l'ingranaggio delle impostazioni nella parte in alto a destra della dashboard.
1. **Nel pannello a sinistra, scegli Annotazioni.**
1. **In alto a destra della pagina Annotazioni, scegli Nuovo.**
1. Inserisci un nome per l'annotazione (verrà utilizzato come nome dell'interruttore sulla dashboard).
1. Seleziona l'**origine dati** di Wavefront.
1. Per impostazione predefinita, le annotazioni hanno un limite di 100 eventi di avviso che verranno restituiti. Per modificarlo, imposta il campo **Limite** sul valore desiderato.
1. Scegliere **Aggiungi**.
#### Utilizzo delle annotazioni
Quando le annotazioni sono attivate, ora dovresti vedere gli eventi di avviso e i problemi correlati a un determinato periodo di tempo.
Se ti fermi nella parte inferiore di una sezione annotata di una visualizzazione, verrà visualizzata una finestra pop-up che mostra il nome dell'avviso e fornisce un collegamento diretto all'avviso in Wavefront.
#### Utilizzo del campo Display Name
Questa fonte di dati utilizza il campo Nome visualizzato nella scheda Campo del pannello Opzioni per abbreviare o modificare una chiave della legenda in base al nome, alle etichette o ai valori. Altre origini dati utilizzano `alias` funzionalità personalizzate per modificare le chiavi della legenda, ma la funzione Display Name è un modo più coerente per farlo.
### Riferimenti
+ [WQL (Wavefront Query Language)](https://docs.wavefront.com/query_language_reference.html)