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à.
Riferimento modello
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.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 8.x di Grafana, vedere. Funzionamento in Grafana versione 8
Questa sezione fornisce informazioni di riferimento per la creazione dei modelli.
Dati del modello
I seguenti dati vengono passati ai modelli di messaggio.
Nome | Type | Note |
---|---|---|
|
string |
Nome del punto di contatto a cui viene inviata la notifica. |
|
string |
attivazione se viene attivato almeno un avviso, altrimenti risolto. |
|
Alert |
Elenco degli oggetti di avviso inclusi in questa notifica (vedi sotto). |
|
KeyValue |
Etichette in base alle quali questi avvisi sono stati raggruppati. |
|
KeyValue |
Etichette comuni a tutti gli avvisi inclusi in questa notifica. |
|
KeyValue |
Annotazioni comuni a tutti gli avvisi inclusi in questa notifica. |
|
string |
Link di ritorno al Grafana che ha inviato la notifica. Se si utilizza un Alertmanager esterno, ricollega a questo Alertmanager. |
Il Alerts
tipo espone due funzioni per filtrare gli avvisi restituiti.
-
Alerts.Firing
— Restituisce un elenco di avvisi di attivazione. -
Alerts.Resolved
— Restituisce un elenco di avvisi risolti.
Avviso (tipo)
Il tipo di avviso contiene i seguenti dati.
Nome | Type | Note |
---|---|---|
Stato |
string |
|
Etichette |
KeyValue |
Un set di etichette allegate all'avviso. |
Annotazioni |
KeyValue |
Un insieme di annotazioni allegate all'avviso. |
Valori | KeyValue | I valori di tutte le espressioni, incluse le condizioni classiche |
StartsAt |
Time.time |
L'ora in cui l'allarme ha iniziato a scattare. |
EndsAt |
Tempo. Tempo |
Impostato solo se è nota l'ora di fine di un avviso. Altrimenti impostato su un periodo di timeout configurabile dal momento in cui è stato ricevuto l'ultimo avviso. |
URL del generatore |
string |
Un link a Grafana o Alertmanager esterno. |
URL silenzioso |
string |
Un link per silenziare l'avviso (con le etichette precompilate per questo avviso). Solo per gli avvisi gestiti da Grafana. |
URL del pannello di controllo |
string |
Collegamento alla dashboard di Grafana, se la regola di avviso appartiene a una di esse. Solo per gli avvisi gestiti da Grafana. |
URL del pannello |
string |
Collegamento al pannello di dashboard di Grafana, se la regola di avviso appartiene a uno. Solo per gli avvisi gestiti da Grafana. |
Impronta digitale |
string |
Impronta digitale che può essere utilizzata per identificare l'avviso. |
ValueString |
string |
Una stringa che contiene le etichette e il valore di ogni espressione ridotta nell'avviso. |
ExtendedData
L' ExtendedData oggetto contiene le seguenti proprietà.
Nome | Tipo | Descrizione | Esempio |
---|---|---|---|
Ricevitore |
|
Il nome del punto di contatto che invia la notifica. |
|
Stato |
|
Lo stato è |
|
Avvisi |
|
Elenco di tutti gli allarmi attivi e risolti in questa notifica. |
|
Avvisi di attivazione |
|
Elenco di tutti gli allarmi di attivazione contenuti in questa notifica. |
|
Avvisi risolti |
|
Elenco di tutti gli avvisi risolti in questa notifica. |
|
GroupLabels |
|
Le etichette che raggruppano questi avvisi in questa notifica. |
|
CommonLabels |
|
Le etichette comuni a tutti gli avvisi di questa notifica. |
|
CommonAnnotations |
|
Le annotazioni comuni a tutti gli avvisi di questa notifica. |
|
URL esterno |
|
Un collegamento all'area di lavoro Grafana o Alertmanager che ha inviato questa notifica. |
|
KeyValue tipo
Il KeyValue
tipo è un insieme di coppie di stringhe chiave/valore che rappresentano etichette e annotazioni.
Oltre all'accesso diretto ai dati archiviati come fileKeyValue
, esistono anche metodi per ordinare, rimuovere e trasformare i dati.
Nome | Argomenti | Valori restituiti | Note | Esempio |
---|---|---|---|---|
SortedPairs |
Elenco ordinato di coppie di stringhe di chiavi e valori |
|
||
Rimuovi |
[] stringa |
KeyValue |
Restituisce una copia della mappa chiave/valore senza le chiavi fornite. |
|
Nomi |
[] stringa |
Elenco dei nomi delle etichette |
|
|
Valori |
[] stringa |
Elenco dei valori delle etichette |
|
Time (Orario)
L'ora proviene dal time
Monday, 1st January 2022 at 10:00AM
, scrivi il seguente modello:
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
Puoi trovare un riferimento per il formato orario di Go qui
Funzioni del modello
Utilizzando le funzioni del modello è possibile elaborare etichette e annotazioni per generare notifiche dinamiche. Sono disponibili le seguenti funzioni.
Nome | Tipo di argomento | Tipo restituito | Descrizione |
---|---|---|---|
|
numero o stringa |
string |
Converte un numero in un formato più leggibile, utilizzando prefissi metrici. |
|
numero o stringa |
string |
Come humanize, ma usa 1024 come base anziché 1000. |
|
numero o stringa |
string |
Converte una durata in secondi in un formato più leggibile. |
|
numero o stringa |
string |
Converte un valore del rapporto in una frazione di 100. |
|
numero o stringa |
string |
Converte un timestamp Unix in pochi secondi in un formato più leggibile. |
|
string |
string |
Strings.title, mette in maiuscolo il primo carattere di ogni parola. |
|
string |
string |
stringhe. ToUpper, converte tutti i caratteri in maiuscolo. |
|
string |
string |
stringhe. ToLower, converte tutti i caratteri in minuscolo. |
|
motivo, testo |
Booleano |
espressione regolare. MatchString Verifica una corrispondenza regexp non ancorata. |
|
modello, sostituzione, testo |
string |
Regexp. ReplaceAllString Sostituzione Regexp, non ancorata. |
|
string - Oggetto JSON con e campi |
string |
Restituisce il percorso della visualizzazione grafica in Explore per l'espressione e l'origine dati specificate. |
|
string - Oggetto JSON con |
string |
Restituisce il percorso della vista tabulare in Explore per l'espressione e l'origine dati specificate. |
|
[] interfaccia {} |
mappa [stringa] interfaccia {} |
Converte un elenco di oggetti in una mappa con chiavi, ad esempio arg0, arg1. Utilizzate questa funzione per passare più argomenti ai modelli. |
|
nulla |
string |
Restituisce una stringa che rappresenta l'URL esterno. |
|
nulla |
string |
Restituisce il percorso dell'URL esterno. |
La tabella seguente mostra esempi di utilizzo di ciascuna funzione.
Funzione | TemplateString | Input | Expected (Atteso) |
---|---|---|---|
umanizzare |
{umanizza $value} |
1234567,0 |
1,235 M |
umanizza 1024 |
{humanize1024 $value} |
1048576,0 |
1 Mi |
Durata umanizzata |
{UmanizeDuration $value} |
899,99 |
14 m 59 s |
Umanizza la percentuale |
{humanizePercentage $value} |
0,1234567 |
12,35% |
Umanizza il timestamp |
{humanizeTimestamp $value} |
1435065584,128 |
2015-06-23 13:19:44.128 +0000 UTC |
titolo |
{$valore | titolo} |
un B C |
Aa Bb Cc |
toUpper |
{$valore | toUpper} |
un dB C |
A B C |
toLower |
{$valore | toLower} |
un B C |
a b c |
match |
{match «a+» $labels.instance} |
aa |
true |
reReplaceAll |
{{ reReplaceAll «localhost :( .*)» «my.domain: $1" $labels.instance}} |
host locale: 3000 |
mio.domain:3000 |
GraphLink |
{{graphLink «{\" expr\»:\ "up\»,\ "fonte dati\»:\ "gdev-prometheus\"}»}} |
/esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», {"datasource» :"gdev-prometheus», "expr» :"up», "instant» :false, "range» :true}] |
|
TableLink |
{{tableLink «{\" expr\»:\ "up\»,\ "fonte dati\»:\ "gdev-prometheus\"}»}} |
/esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», {"datasource» :"gdev-prometheus», "expr» :"up», "instant» :true, "range» :false}] |
|
args |
{{define «x"}} {{.arg0}} {{.arg1}} {{end}} {{template «x» (args 1 «2")}} |
1 2 |
|
URL esterno |
{URL esterno} |
http://localhost/path/prefix |
|
Prefisso del percorso |
{PathPrefix} |
/percorso/prefisso |