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 Graphite Grafana dispone di un editor di query Graphite avanzato che consente di navigare rapidamente nello spazio metrico, aggiungere funzioni, modificare i parametri delle funzioni e molto altro. L'editor può gestire tutti i tipi di interrogazioni sulla grafite. Può persino gestire query annidate complesse tramite l'uso di riferimenti di query. ## Impostazioni Graphite Per accedere alle impostazioni di Graphite, fai una pausa sull'icona **Configurazione** (ingranaggio), quindi scegli **Fonti dati**, quindi scegli l'origine dati Graphite. | Nome | Description | | --- | --- | | Name | Il nome della fonte di dati. Ecco come viene visualizzata la fonte di dati nei pannelli e nelle query. | | Default | L'origine dati predefinita significa che sarà preselezionata per i nuovi pannelli. | | URL | Il protocollo HTTP, l'IP e la porta dell'installazione di graphite-web o graphite-api. | | Access | Server (impostazione predefinita) = L'URL deve essere accessibile dal Grafana backend/server. | | Auth | | | Basic Auth | Abilita l'autenticazione di base per la fonte di dati. | | User | Nome utente per l'autenticazione di base. | | Password | Password per l'autenticazione di base. | | Custom HTTP Headers | Scegli Aggiungi intestazione per aggiungere un'intestazione HTTP personalizzata. | | Header | Inserisci il nome dell'intestazione personalizzata. | | Value | Immettete il valore dell'intestazione personalizzato. | | Graphite details | | | Version | Seleziona la tua versione di Graphite. | | Type | Seleziona il tuo tipo di grafite. | La modalità di accesso controlla il modo in cui verranno gestite le richieste alla fonte di dati. Il server dovrebbe essere il metodo preferito se non viene indicato nient'altro. ### Modalità di accesso al server (impostazione predefinita) Tutte le richieste vengono effettuate dal browser ad Amazon Managed Grafana, che le inoltra alla fonte di dati, aggirando i possibili requisiti di condivisione Cross-Origin delle risorse (CORS). Se selezioni questa modalità di accesso, l'URL deve essere accessibile da Amazon Managed Grafana. ### Modalità di accesso al browser Amazon Managed Grafana non supporta l'accesso diretto tramite browser all'origine dati Graphite. ## Editor di query Graphite Grafana include un editor di Graphite-specific query per aiutarti a creare le tue query. Per vedere il testo non elaborato della query che viene inviata a Graphite, scegli l'icona **Attiva la modalità di modifica del testo** (matita). ### Scelta delle metriche da interrogare Scegli **Seleziona metrica** per navigare nello spazio metrico. Dopo aver iniziato, puoi continuare a usare il puntatore o i tasti freccia della tastiera. Potete selezionare un carattere jolly e continuare. ### Funzioni Per aggiungere una funzione, scegliete l'icona con il segno più accanto a **Funzione**. Puoi cercare la funzione o selezionarla dal menu. Dopo aver selezionato una funzione, questa verrà aggiunta e l'attenzione verrà spostata nella casella di testo del primo parametro. Per modificare o cambiare un parametro, selezionalo e si trasformerà in una casella di testo. - Per eliminare una funzione, scegliete il nome della funzione seguito dall'icona x. Alcune funzioni, ad esempio`aliasByNode`, supportano un secondo argomento opzionale. Per aggiungere un argomento, soffermatevi sul primo argomento, quindi scegliete il `+` simbolo che appare. Per rimuovere il secondo parametro opzionale, selezionatelo e lasciatelo vuoto. L'editor lo rimuoverà. ### Ordina le etichette Se desideri un ordine coerente, usa`sortByName`. Questo può essere fastidioso quando hai le stesse etichette su più grafici e sono entrambe ordinate in modo diverso e utilizzano colori diversi. Per risolvere questo problema, usa. `sortByName()` ### Interrogazioni annidate È possibile fare riferimento alle query in base alla *lettera* riga in cui si trovano (in modo simile a Microsoft Excel). Se aggiungete una seconda query a un grafico, potete fare riferimento alla prima interrogazione digitando \#A. In questo modo è possibile creare query composte in modo pratico. ### Evitare molte interrogazioni utilizzando caratteri jolly Occasionalmente, potresti voler vedere più serie temporali tracciate sullo stesso grafico. Ad esempio, potresti voler vedere come viene utilizzata la CPU su una macchina. Inizialmente è possibile creare il grafico aggiungendo una query per ogni serie temporale, ad esempio `cpu.percent.user.g``cpu.percent.system.g`, e così via. Ciò comporta l'esecuzione di *n* query sull'origine dati, il che è inefficiente. Per essere più efficienti, è possibile utilizzare caratteri jolly nella ricerca, restituendo tutte le serie temporali in un'unica query. Ad esempio, `cpu.percent.*.g`. ### Modifica del nome della metrica in tabelle o grafici Utilizza `alias` le funzioni per modificare i nomi delle metriche nelle tabelle o nei grafici Grafana; ad esempio, o. `aliasByNode()` `aliasSub()` ## Consolidamento dei punti Tutte le metriche di Graphite sono consolidate in modo che Graphite non restituisca più punti dati di quanti siano i pixel nel grafico. Per impostazione predefinita, questo consolidamento viene eseguito utilizzando la funzione. `avg` Puoi controllare il modo in cui Graphite consolida le metriche aggiungendo la funzione Graphite ConsolidateBy. **Nota** Ciò significa che i valori di riepilogo della legenda (max, min, totale) non possono essere corretti tutti contemporaneamente. Sono calcolati lato client da Grafana. E a seconda della funzione di consolidamento, solo una o due possono essere corrette contemporaneamente. ## Combinazione di serie temporali Per combinare serie temporali, scegliete **Combina** nell'elenco **Funzioni**. ## Esplorazione dei dati e tag In Graphite, tutto è un tag. Quando si esplorano i dati, i tag precedentemente selezionati vengono utilizzati per filtrare il set di risultati rimanente. Per selezionare i dati, si utilizza la `seriesByTag` funzione, che utilizza le espressioni di tag (`=`,, `!=``=~`,`!=~`) per filtrare le serie temporali. Il generatore di query Grafana lo fa automaticamente quando selezioni un tag. **Nota** **Suggerimento:** la ricerca delle espressioni regolari può essere lenta sui tag ad alta cardinalità, quindi prova prima a utilizzare altri tag per ridurre l'ambito. Iniziare con un nome o uno spazio dei nomi particolare aiuta a ridurre i risultati. ## Variabili del modello 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 e variabili](templates-and-variables.md) Per creare una variabile utilizzando i valori dei tag, utilizzate le funzioni `tags` Grafana e. `tag_values` | Query | Description | | --- | --- | | tags() | Restituisce tutti i tag. | | tags(server=\~backend\\\*) | Restituisce solo i tag che si trovano in serie corrispondenti all'espressione del filtro. | | tag\_values(server) | Restituisce i valori dei tag per il tag specificato. | | tag\_values(server, server=\~backend\\\*) | Restituisce i valori dei tag filtrati che si verificano per il tag specificato in serie che corrispondono a tali espressioni. | | tag\_values(server, server=\~backend\\\*, app=\~${apps:regex}) | Più espressioni ed espressioni di filtro possono contenere altre variabili. | Per maggiori dettagli, consulta i [documenti Graphite sull'API di completamento automatico per i](https://graphite.readthedocs.io/en/latest/tags.html#auto-complete-support) tag. ### Variabile di interrogazione La query specificata nel campo della query deve essere un tipo di ricerca metrica. Ad esempio, una query come quella `prod.servers.*` riempirà la variabile con tutti i possibili valori presenti nella posizione dei caratteri jolly. È inoltre possibile creare variabili annidate che utilizzano altre variabili nella loro definizione. Ad esempio, `apps.$app.servers.*` utilizza la variabile `$app` nella definizione della query. #### Viene utilizzato `__searchFilter` per filtrare i risultati delle variabili di query L'utilizzo `__searchFilter` nel campo di ricerca filtrerà i risultati della query in base a ciò che inserisci nella casella di selezione a discesa. Quando non si immette nulla, il valore predefinito per `__searchFilter` «`*`e» quando viene utilizzato come parte di un'espressione regolare. L'esempio seguente mostra come utilizzare, `__searchFilter` come parte del campo di interrogazione, la ricerca `server` mentre l'utente inserisce il testo nella casella di selezione a discesa. Query ``` apps.$app.servers.$__searchFilter ``` TagValues ``` tag_values(server, server=~${__searchFilter:regex}) ``` ### Utilizzo variabile È possibile utilizzare una variabile nel percorso di un nodo metrico o come parametro di una funzione. Esistono due sintassi: + `$`Esempio: apps.frontend. $server.requests.count + `${varname}`Esempio: apps.frontend. $ {server} .requests.count Perché due modi? La prima sintassi è più facile da leggere e scrivere ma non consente di utilizzare una variabile al centro di una parola. Usa la seconda sintassi in espressioni come. `my.server${serverNumber}.count` ### Utilizzo delle variabili nelle query di tag Multi-value le variabili nelle query di tag utilizzano la sintassi di formattazione avanzata introdotta in Grafana 5.0 per le variabili:. `{var:regex}` Non-tagle query utilizzeranno la formattazione glob predefinita per le variabili multivalore. Il seguente esempio di codice mostra un'espressione di tag con formattazione regex e che utilizza l'operatore Equal Tilde,. `=~` ``` server=~${servers:regex} ``` Per ulteriori informazioni, consulta [Opzioni avanzate di formato variabile](templates-and-variables.md#advanced-variable-format-options). ## Annotazioni Le annotazioni consentono di sovrapporre informazioni dettagliate sugli eventi ai grafici. È possibile aggiungere interrogazioni di annotazione tramite il menu Dashboard /la vista Annotazioni. Per ulteriori informazioni, consulta [Annotazioni](dashboard-annotations.md). Graphite supporta due modi per interrogare le annotazioni: + Una normale interrogazione metrica. A tale scopo, si utilizza la casella di testo **Graphite Query**. + Una query di eventi Graphite. Per questo, usate la casella di `Graphite event tags` testo e specificate un tag o un carattere jolly (dovrebbe funzionare anche tenerlo vuoto).