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à.
Opzioni e sostituzioni dei campi
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.x di Grafana.
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Funzionamento nella versione 10 di Grafana
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana
Questa sezione spiega cosa sono le opzioni di campo e le sostituzioni dei campi in Amazon Managed Grafana e come utilizzarle.
Il modello di dati utilizzato negli spazi di lavoro di Grafana, il data frame, è una struttura tabellare orientata a colonne che unifica sia le serie temporali che i risultati delle query tabellari. Ogni colonna all'interno di questa struttura è chiamata campo. Un campo può rappresentare una singola serie temporale o colonna di tabella.
Le opzioni di campo consentono di modificare la modalità di visualizzazione dei dati nelle visualizzazioni. Le opzioni e le sostituzioni applicate non modificano i dati, ma il modo in cui Amazon Managed Grafana visualizza i dati.
Opzioni di campo
Le opzioni di campo, sia standard che personalizzate, sono disponibili nella scheda Campo dell'editor del pannello. Le modifiche apportate in questa scheda si applicano a tutti i campi (ovvero serie e colonne). Ad esempio, se si modifica l'unità in percentuale, tutti i campi con valori numerici vengono visualizzati in percentuale. Scopri come applicare un'opzione di campo in. Configura tutti i campi
Sostituzioni dei campi
Le sostituzioni dei campi possono essere aggiunte nella scheda Sostituzioni dell'editor del pannello. Qui puoi aggiungere le stesse opzioni che trovi nella scheda Campo, ma vengono applicate solo a campi specifici. Scopri come applicare un override inConfigura campi specifici.
Opzioni di campo e sostituzioni disponibili
I tipi di opzioni di campo sono comuni sia alle opzioni di campo che alle sostituzioni dei campi. L'unica differenza è se la modifica verrà applicata a tutti i campi (applicata nella scheda Campo) o a un sottoinsieme di campi (applicata nella scheda Sostituzioni).
-
Opzioni di campo standardsi applicano a tutte le visualizzazioni dei pannelli che consentono le trasformazioni.
-
Opzioni dei campi della tabellasi applicano solo alle visualizzazioni dei pannelli tabellari.
Configura tutti i campi
Per modificare la modalità di visualizzazione dei dati in tutti i campi, puoi modificare un'opzione nella scheda Campo. Nella scheda Sostituzioni, puoi quindi sovrascrivere le opzioni di campo per campi specifici. Per ulteriori informazioni, consulta Configura campi specifici.
Ad esempio, è possibile modificare il numero di posizioni decimali visualizzate in tutti i campi modificando l'opzione Decimali. Per ulteriori informazioni sulle opzioni, vedere e. Opzioni di campo standard Opzioni dei campi della tabella
Modificare l'opzione di un campo
Puoi modificare tutte le opzioni che desideri.
Per modificare un'opzione di campo
-
Scegliete il pannello che desiderate modificare, scegliete il titolo del pannello, quindi scegliete Modifica.
-
Scegli la scheda Campo.
-
Trova l'opzione che desideri modificare. È possibile definire quanto segue:
-
Opzioni di campo standard, che si applicano a tutte le visualizzazioni dei pannelli che consentono trasformazioni.
-
Opzioni dei campi della tabella, che si applicano solo alle visualizzazioni dei pannelli delle tabelle.
-
-
Aggiungi opzioni aggiungendo valori nei campi. Per riportare le opzioni ai valori predefiniti, elimina il testo bianco nei campi.
-
Quando hai finito di apportare modifiche alla dashboard, scegli Salva.
Esempio di opzione di campo
Supponiamo che il set di risultati sia un frame di dati composto da due campi: tempo e temperatura.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45.0 |
| 2020-01-02 03:05:00 | 47,0 |
| 2020-01-02 03:06:00 | 48,0 |
A ogni campo (colonna) di questa struttura possono essere applicate opzioni di campo in modo da alterarne la modalità di visualizzazione dei valori. Ad esempio, è possibile impostare l'unità su Temperatura > Celsius, ottenendo la tabella seguente.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45,0 °C |
| 2020-01-02 03:05:00 | 47,0 °C |
| 2020-01-02 03:06:00 | 48,0 °C |
La cifra decimale non significa nulla in questo caso. È possibile modificare i decimali auto da zero (0), ottenendo la seguente tabella.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45 °C |
| 2020-01-02 03:05:00 | 47 °C |
| 2020-01-02 03:06:00 | 48 °C |
Configura campi specifici
Puoi utilizzare le sostituzioni per modificare le impostazioni per uno o più campi. Le opzioni di campo per le sostituzioni sono esattamente le stesse delle opzioni di campo disponibili in una particolare visualizzazione. L'unica differenza è che scegli a quali campi applicarle.
Ad esempio, è possibile modificare il numero di posizioni decimali visualizzate in tutti i campi o le colonne numerici modificando l'opzione Decimali per i campi con un tipo corrispondente a Numerico. Per ulteriori informazioni sulle opzioni, consultateOpzioni di campo standard, che si applicano a tutte le visualizzazioni dei pannelli che consentono le trasformazioni eOpzioni dei campi della tabella, che si applicano solo alle visualizzazioni dei pannelli tabellari.
Aggiungere una sovrascrittura dei campi
Puoi sovrascrivere tutte le opzioni di campo che desideri.
Per aggiungere un campo, sovrascrivi
-
Scegliete il pannello che desiderate modificare, scegliete il titolo del pannello, quindi scegliete Modifica.
-
Scegli la scheda Sostituzioni.
-
Scegli Aggiungi un override per.
-
Seleziona i campi a cui desideri applicare una regola di sostituzione.
-
Campi con nome: utilizza questa opzione per selezionare un campo dall'elenco di tutti i campi disponibili. Le proprietà aggiunte a una regola con questo selettore vengono applicate solo a questo singolo campo.
-
Campi con espressione regolare corrispondente al nome: utilizzatelo per specificare i campi da sovrascrivere con un'espressione regolare. Le proprietà che aggiungi a una regola utilizzando questo selettore vengono applicate a tutti i campi in cui i nomi dei campi corrispondono all'espressione regolare.
-
Campi con tipo: utilizzalo per selezionare i campi per tipo, ad esempio stringa, numerico e così via. Le proprietà che aggiungi a una regola con questo selettore vengono applicate a tutti i campi che corrispondono al tipo selezionato.
-
-
Scegli Aggiungi proprietà sostitutiva.
-
Seleziona l'opzione di campo che desideri applicare.
-
Inserisci le opzioni aggiungendo valori nei campi. Per riportare le opzioni ai valori predefiniti, elimina il testo bianco nei campi.
-
Continua ad aggiungere sostituzioni a questo campo scegliendo Aggiungi proprietà di sostituzione oppure puoi scegliere Aggiungi sostituzioni e selezionare un campo diverso a cui aggiungere sostituzioni.
-
Al termine, scegli Save (Salva).
Elimina una sovrascrittura di campo
-
Scegli la scheda Sostituzioni che contiene l'override che desideri eliminare.
-
Scegli l'icona del cestino accanto all'override.
Esempio di sovrascrittura dei campi
Supponiamo che il nostro set di risultati sia un frame di dati composto da quattro campi: tempo, alta temperatura, bassa temperatura e umidità.
| time | alta temperatura | bassa temperatura | umidità |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45.0 | 30,0 | 67 |
| 2020-01-02 03:05:00 | 47,0 | 34,0 | 68 |
| 2020-01-02 03:06:00 | 48,0 | 31,0 | 68 |
Applichiamo le opzioni del campo da Esempio di opzione di campo per applicare l'unità Celsius ed eliminare la cifra decimale. Ciò si traduce nella tabella seguente.
| time | alta temperatura | bassa temperatura | umidità |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67 °C |
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68 °C |
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68 °C |
I campi di temperatura sembrano buoni, ma l'umidità non ha senso. È possibile risolvere questo problema applicando un'opzione di campo che sostituisce l'opzione di campo al campo di umidità e modificando l'unità in Misc > percent (0-100). Il risultato è una tabella molto più sensata.
| time | alta temperatura | bassa temperatura | umidità |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67% |
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68% |
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68% |
Opzioni di campo standard
Questa sezione spiega le opzioni di campo disponibili. Sono elencate in ordine alfabetico.
È possibile applicare opzioni di campo standard alla maggior parte dei pannelli dell'area di lavoro Grafana integrati. Ad alcuni vecchi pannelli e pannelli della community che non sono stati aggiornati al nuovo pannello e al nuovo modello di dati mancheranno tutte o alcune di queste opzioni di campo.
La maggior parte delle opzioni di campo non influirà sulla visualizzazione finché non sceglierete una opzione esterna alla casella delle opzioni di campo che state modificando o premete Invio.
Per ulteriori informazioni sull'applicazione di queste opzioni, consulta le seguenti sezioni:
Decimali
Questa opzione imposta il numero di decimali da includere durante il rendering di un valore. Lascia vuoto affinché Amazon Managed Grafana utilizzi il numero di decimali fornito dall'origine dati.
Per modificare questa impostazione, inserisci un numero nel campo.
Collegamenti dati
Questa opzione controlla l'URL a cui si collega un valore o una visualizzazione. Per ulteriori informazioni e istruzioni, consulta Collegamenti dati.
Display name (Nome visualizzato)
Questa opzione imposta il titolo di visualizzazione di tutti i campi. È possibile utilizzare variabili nel titolo del campo. Per ulteriori informazioni sulla creazione di modelli e sulle variabili di modello, vedere. Modelli e variabili
Quando vengono visualizzate più statistiche, campi o serie, questo campo controlla il titolo di ogni statistica. Puoi usare espressioni come ${__field.name} usare solo il nome della serie o il nome del campo nel titolo.
Viene fornito un campo con il nome Temp e le etichette {"loc"="PBI», «Sensor"="3"}
| Sintassi delle espressioni | Esempio | Renderizza su | Spiegazione |
|---|---|---|---|
${__field.displayName}
|
Uguale alla sintassi |
Temp {Loc="PBI",
Sensor="3"}
|
Visualizza il nome del campo e le etichette, {} se presenti. Se nella risposta è presente una sola chiave di etichetta, per la parte relativa all'etichetta, Amazon Managed Grafana visualizza il valore dell'etichetta senza le parentesi allegate. |
${__field.name}
|
Uguale alla sintassi |
Temp
|
Visualizza il nome del campo (senza etichette). |
${__field.labels}
|
Uguale alla sintassi |
Loc="PBI", Sensor="3"
|
Visualizza le etichette senza il nome. |
${__field.labels.X}
|
${__field.labels.Loc}
|
PBI
|
Visualizza il valore della chiave dell'etichetta specificata. |
${__field.labels.__values}
|
Uguale alla sintassi |
PBI, 3
|
Visualizza i valori delle etichette separate da una virgola (senza chiavi di etichetta). |
Se il valore è una stringa vuota dopo il rendering dell'espressione per un determinato campo, viene utilizzato il metodo di visualizzazione predefinito.
Max
Questa opzione imposta il valore massimo utilizzato nei calcoli della soglia percentuale. Per il calcolo automatico basato su tutte le serie e i campi, lascia vuota questa impostazione.
Min
Questa opzione imposta il valore minimo utilizzato nei calcoli della soglia percentuale. Per il calcolo automatico basato su tutte le serie e i campi, lascia vuota questa impostazione.
Nessun valore
Inserisci ciò che Amazon Managed Grafana deve visualizzare se il valore del campo è vuoto o nullo.
Unità
Questa opzione specifica l'unità che un campo deve utilizzare. Scegli il campo Unità, quindi esegui il drill-down fino a trovare l'unità desiderata. L'unità selezionata viene applicata a tutti i campi tranne il tempo.
Unità personalizzate
Puoi anche utilizzare l'elenco a discesa delle unità per specificare unità personalizzate, prefisso o suffisso personalizzato e formati di data/ora.
Per selezionare un'unità personalizzata, inserisci l'unità e seleziona l'ultima Custom: xxx opzione nell'elenco a discesa.
-
suffix:<suffix>per l'unità personalizzata che dovrebbe andare dopo il valore. -
time:<format>per formati di data/ora personalizzati; per esempio,.time:YYYY-MM-DDPer la sintassi e le opzioni del formato, vedete Display. -
si:<base scale><unit characters>per unità SI personalizzate; ad esempio,si: mF. Questa opzione è un po' più avanzata perché consente di specificare sia un'unità che la scala dei dati di origine. Ad esempio, se i dati di origine sono rappresentati come milli (migliaia di) unità, aggiungi all'unità il carattere di scala SI come prefisso. -
count:<unit>per un'unità di conteggio personalizzata. -
currency:<unit>per personalizzare un'unità monetaria.
Puoi anche incollare un'emoji nativa nel selettore di unità e sceglierla come unità personalizzata.
Unità di stringa
Amazon Managed Grafana a volte può analizzare le stringhe e mostrarle come numeri. Per fare in modo che Amazon Managed Grafana mostri la stringa originale, crea un campo override e aggiungi una proprietà dell'unità con l'unità. string
Combinazione di colori
L'opzione field color definisce il modo in cui Amazon Managed Grafana colora serie o campi. Esistono diverse modalità che funzionano in modo diverso e la loro utilità dipende in gran parte dalla visualizzazione attualmente selezionata.
Le modalità a colori continui utilizzano la percentuale di un valore rispetto a min e max per interpolare un colore.
-
Colore singolo: set di colori specifico utilizzando il selettore di colori. Ciò è particolarmente utile se si utilizza una regola di override.
-
Dalle soglie: colore derivato dalla soglia corrispondente. Questo è utile per le visualizzazioni di indicatori, statistiche e tabelle.
Colore per serie
Amazon Managed Grafana include schemi di colori che definiscono il colore per serie. Ciò è utile, ad esempio, per grafici e diagrammi a torta.
Colora per valore
Amazon Managed Grafana include anche schemi di colori continui (gradienti). Ciò è utile per le visualizzazioni che colorano singoli valori, ad esempio i pannelli stat e il pannello tabellare.
Soglie
È possibile utilizzare le soglie per modificare il colore di un campo in base al valore. Per ulteriori informazioni e istruzioni, consulta Soglie.
Mappatura dei valori
È possibile utilizzare questa opzione per impostare regole che traducono un valore di campo o un intervallo di valori in testo esplicito. È possibile aggiungere più di una mappatura di valori.
-
Tipo di mappatura: scegli un'opzione.
-
Valore: inserisci un valore. Se il valore del campo è maggiore o uguale al valore, viene visualizzato il testo.
-
Da e a: immettere un intervallo. Se il valore del campo è compreso o uguale ai valori dell'intervallo, viene visualizzato il testo.
-
-
Testo: testo che viene visualizzato se le condizioni sono soddisfatte in un campo. Questo campo accetta variabili.
