Share via


az grafana

Nota

Questo riferimento fa parte dell'estensione amg per l'interfaccia della riga di comando di Azure (versione 2.38.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az grafana . Altre informazioni sulle estensioni.

Comandi per gestire le istanze di Azure Grafana.

Per un'esperienza ottimizzata, non tutte le API del piano dati, documentate in https://grafana.com/docs/grafana/latest/http_api/, sono esposte. In caso di gap di copertura, contattare ad4g@microsoft.com.

Comandi

Nome Descrizione Tipo Stato
az grafana api-key

Comandi per gestire le chiavi API.

Estensione Disponibilità generale
az grafana api-key create

Creare una nuova chiave API.

Estensione Disponibilità generale
az grafana api-key delete

Eliminare una chiave API.

Estensione Disponibilità generale
az grafana api-key list

Elencare le chiavi API esistenti.

Estensione Disponibilità generale
az grafana backup

Eseguire il backup del contenuto di un'istanza di Grafana gestita di Azure in un archivio.

Estensione Anteprima
az grafana create

Creare un'istanza di Grafana gestita di Azure.

Estensione Disponibilità generale
az grafana dashboard

Comandi per gestire i dashboard di un'istanza.

Estensione Disponibilità generale
az grafana dashboard create

Creare un nuovo dashboard.

Estensione Disponibilità generale
az grafana dashboard delete

Eliminare un dashboard.

Estensione Disponibilità generale
az grafana dashboard import

Importare un dashboard.

Estensione Disponibilità generale
az grafana dashboard list

Elencare tutti i dashboard di un'istanza.

Estensione Disponibilità generale
az grafana dashboard show

Ottenere i dettagli di un dashboard.

Estensione Disponibilità generale
az grafana dashboard sync

Sincronizzare i dashboard di Grafana gestiti di Azure da un'istanza a un'altra. Si noti che i dashboard con stato "provisioning" verranno ignorati a causa della sola lettura.

Estensione Anteprima
az grafana dashboard update

Aggiornare un dashboard.

Estensione Disponibilità generale
az grafana data-source

Comandi per gestire le origini dati di un'istanza di .

Estensione Disponibilità generale
az grafana data-source create

Creare un'origine dati.

Estensione Disponibilità generale
az grafana data-source delete

Eliminare un'origine dati.

Estensione Disponibilità generale
az grafana data-source list

Elencare tutte le origini dati di un'istanza di .

Estensione Disponibilità generale
az grafana data-source query

Eseguire query su un'origine dati con implementazione back-end.

Estensione Disponibilità generale
az grafana data-source show

Ottenere i dettagli di un'origine dati.

Estensione Disponibilità generale
az grafana data-source update

Aggiornare un'origine dati.

Estensione Disponibilità generale
az grafana delete

Eliminare un'istanza di Grafana gestita di Azure.

Estensione Disponibilità generale
az grafana folder

Comandi per gestire le cartelle di un'istanza.

Estensione Disponibilità generale
az grafana folder create

Crea nuova cartella.

Estensione Disponibilità generale
az grafana folder delete

Eliminare una cartella.

Estensione Disponibilità generale
az grafana folder list

Elencare tutte le cartelle di un'istanza di .

Estensione Disponibilità generale
az grafana folder show

Ottenere i dettagli di una cartella.

Estensione Disponibilità generale
az grafana folder update

Aggiornare una cartella.

Estensione Disponibilità generale
az grafana list

Elencare le istanze di Grafana gestite di Azure.

Estensione Disponibilità generale
az grafana notification-channel

Comandi per gestire i canali di notifica di un'istanza di .

Estensione Disponibilità generale
az grafana notification-channel create

Creare un canale di notifica.

Estensione Disponibilità generale
az grafana notification-channel delete

Eliminare un canale di notifica.

Estensione Disponibilità generale
az grafana notification-channel list

Elencare tutti i canali di notifica di un'istanza.

Estensione Disponibilità generale
az grafana notification-channel show

Ottenere i dettagli di un canale di notifica.

Estensione Disponibilità generale
az grafana notification-channel test

Testare un canale di notifica.

Estensione Disponibilità generale
az grafana notification-channel update

Aggiornare un canale di notifica.

Estensione Disponibilità generale
az grafana restore

Ripristinare un'istanza di Grafana gestita di Azure da un archivio.

Estensione Anteprima
az grafana service-account

Comandi per gestire gli account del servizio.

Estensione Disponibilità generale
az grafana service-account create

Creare un nuovo account del servizio.

Estensione Disponibilità generale
az grafana service-account delete

Eliminare un account del servizio.

Estensione Disponibilità generale
az grafana service-account list

Elencare gli account del servizio esistenti.

Estensione Disponibilità generale
az grafana service-account show

Ottenere i dettagli di un account del servizio.

Estensione Disponibilità generale
az grafana service-account token

Comandi per gestire i token dell'account del servizio.

Estensione Disponibilità generale
az grafana service-account token create

Creare un nuovo token dell'account del servizio.

Estensione Disponibilità generale
az grafana service-account token delete

Eliminare un token dell'account del servizio.

Estensione Disponibilità generale
az grafana service-account token list

Elencare i token dell'account del servizio esistenti.

Estensione Disponibilità generale
az grafana service-account update

Aggiornare un account del servizio.

Estensione Disponibilità generale
az grafana show

Visualizzare i dettagli di un'istanza di Grafana gestita di Azure.

Estensione Disponibilità generale
az grafana update

Aggiornare un'istanza di Grafana gestita di Azure.

Estensione Disponibilità generale
az grafana user

Comandi per gestire gli utenti di un'istanza.

Estensione Disponibilità generale
az grafana user actual-user

Ottenere i dettagli dell'utente corrente.

Estensione Disponibilità generale
az grafana user list

Elencare gli utenti.

Estensione Disponibilità generale
az grafana user show

Ottenere i dettagli di un utente.

Estensione Disponibilità generale

az grafana backup

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eseguire il backup del contenuto di un'istanza di Grafana gestita di Azure in un archivio.

az grafana backup --name
                  [--components {annotations, dashboards, datasources, folders, snapshots}]
                  [--directory]
                  [--folders-to-exclude]
                  [--folders-to-include]
                  [--resource-group]

Esempio

dashboard di backup in 2 cartelle (le origini dati sono incluse per abilitare il mapping dei nomi quando si ripristinano i dashboard in un'altra area di lavoro)

az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-include "Prod" "Compute Gateway" --components datasources dashboards folders

backup dashboard e ignorare alcune cartelle

az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp  --folders-to-exclude General "Azure Monitor" --components datasources dashboards folders

Parametri necessari

--name -n

Nome della Grafana gestita di Azure.

Parametri facoltativi

--components -c

Tipi di artefatti Grafana di cui eseguire il backup.

valori accettati: annotations, dashboards, datasources, folders, snapshots
--directory -d

Directory per il backup degli artefatti di Grafana.

--folders-to-exclude -e

Cartelle da escludere nel backup o nella sincronizzazione.

--folders-to-include -i

Cartelle da includere nel backup o nella sincronizzazione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana create

Creare un'istanza di Grafana gestita di Azure.

az grafana create --name
                  --resource-group
                  [--deterministic-outbound-ip {Disabled, Enabled}]
                  [--location]
                  [--principal-ids]
                  [--principal-types {Group, ServicePrincipal, User}]
                  [--skip-role-assignments {false, true}]
                  [--skip-system-assigned-identity {false, true}]
                  [--tags]
                  [--zone-redundancy {Disabled, Enabled}]

Parametri necessari

--name -n

Nome della Grafana gestita di Azure.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--deterministic-outbound-ip -i

Se abilitata, l'area di lavoro Grafana avrà indirizzi IP in uscita fissi che è possibile usarli nel firewall delle origini dati. Impostazione predefinita: Disabilitato.

valori accettati: Disabled, Enabled
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--principal-ids

ID oggetto di Azure AD separati da spazi per utenti, gruppi e così via da creare come Amministrazione Grafana. Una volta specificata, l'interfaccia della riga di comando non renderà l'utente connesso corrente come Grafana Amministrazione.

--principal-types

Tipi di entità di entità di Azure AD separati da spazio da associare a --principal-ids.

valori accettati: Group, ServicePrincipal, User
--skip-role-assignments

Non creare assegnazioni di ruolo per l'identità gestita e l'utente di accesso corrente.

valori accettati: false, true
valore predefinito: False
--skip-system-assigned-identity -s

Non abilitare l'identità assegnata dal sistema.

valori accettati: false, true
valore predefinito: False
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--zone-redundancy

Indica se è necessario abilitare o meno la ridondanza della zona. Impostazione predefinita: Disabilitato.

valori accettati: Disabled, Enabled
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana delete

Eliminare un'istanza di Grafana gestita di Azure.

az grafana delete --name
                  [--resource-group]
                  [--yes]

Parametri necessari

--name -n

Nome della Grafana gestita di Azure.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana list

Elencare le istanze di Grafana gestite di Azure.

az grafana list [--resource-group]

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana restore

Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ripristinare un'istanza di Grafana gestita di Azure da un archivio.

az grafana restore --archive-file
                   --name
                   [--components {annotations, dashboards, datasources, folders, snapshots}]
                   [--remap-data-sources {false, true}]
                   [--resource-group]

Esempio

Ripristinare i dashboard. Se si trovano in cartelle, includere "cartelle" nell'elenco dei componenti; usare "--remap-data-sources" in modo che l'interfaccia della riga di comando aggiorni i dashboard in modo che puntino alle stesse origini dati nell'area di lavoro di destinazione

az grafana restore -g MyResourceGroup -n MyGrafana --archive-file backup\dashboards\ServiceHealth-202307051036.tar.gz --components dashboards folders --remap-data-sources

Parametri necessari

--archive-file -a

Archivio da cui ripristinare gli artefatti di Grafana.

--name -n

Nome della Grafana gestita di Azure.

Parametri facoltativi

--components -c

Tipi di artefatti Grafana di cui eseguire il backup.

valori accettati: annotations, dashboards, datasources, folders, snapshots
--remap-data-sources -r

Durante il ripristino, aggiornare i dashboard per fare riferimento alle origini dati definite nell'area di lavoro di destinazione tramite la corrispondenza dei nomi.

valori accettati: false, true
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana show

Visualizzare i dettagli di un'istanza di Grafana gestita di Azure.

az grafana show --name
                [--resource-group]

Parametri necessari

--name -n

Nome della Grafana gestita di Azure.

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az grafana update

Aggiornare un'istanza di Grafana gestita di Azure.

az grafana update --name
                  [--api-key {Disabled, Enabled}]
                  [--deterministic-outbound-ip {Disabled, Enabled}]
                  [--from-address]
                  [--from-name]
                  [--host]
                  [--major-version]
                  [--password]
                  [--public-network-access {Disabled, Enabled}]
                  [--resource-group]
                  [--skip-verify {false, true}]
                  [--smtp {Disabled, Enabled}]
                  [--start-tls-policy {MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS}]
                  [--tags]
                  [--user]

Esempio

disabilitare l'accesso alla rete pubblica

az grafana update -g MyResourceGroup -n MyGrafana --public-network-access disabled

abilitare la notifica tramite l'inoltro SMTP sevice di mailgun

az grafana update -g MyResourceGroup -n MyGrafana --smtp enabled --from-address johndoe@outlook.com --from-name john --host "smtp.mailgun.org:587" --user "postmaster@sandbox12345.mailgun.org" --password "password" --start-tls-policy OpportunisticStartTLS --skip-verify true

Parametri necessari

--name -n

Nome della Grafana gestita di Azure.

Parametri facoltativi

--api-key --service-account

Se abilitata, sarà possibile configurare le chiavi API Grafana e gli account del servizio.

valori accettati: Disabled, Enabled
--deterministic-outbound-ip -i

Se abilitata, l'area di lavoro Grafana avrà indirizzi IP in uscita fissi che è possibile usarli nel firewall delle origini dati.

valori accettati: Disabled, Enabled
--from-address

Indirizzo usato durante l'invio di messaggi di posta elettronica.

--from-name

Nome da usare durante l'invio di messaggi di posta elettronica.

--host

URL del server SMTP (porta inclusa).

--major-version

Numero di versione principale di Grafana.

--password

Password utente server SMTP.

--public-network-access -p

Consentire l'accesso alla rete pubblica.

valori accettati: Disabled, Enabled
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--skip-verify

Ignorare la verifica di SSL per il server SMTP.

valori accettati: false, true
--smtp

Consenti a Grafana di inviare un messaggio di posta elettronica.

valori accettati: Disabled, Enabled
--start-tls-policy

Criteri TLS.

valori accettati: MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--user

Nome utente del server SMTP.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.