az grafana

  • Referenz

Hinweis

Diese Referenz ist Teil der amg-Erweiterung für die Azure CLI (Version 2.38.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az grafana-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten von Azure Grafana-Instanzen.

Für eine optimierte Benutzeroberfläche werden nicht alle Datenebenen-APIs verfügbar gemacht, die unter https://grafana.com/docs/grafana/latest/http_api/"dokumentiert" sind. Bei Der Abdeckungslücke wenden Sie sich bitte an ad4g@microsoft.com.

Befehle

Name Beschreibung Typ Status
az grafana api-key

Befehle zum Verwalten von API-Schlüsseln.

 Erweiterung Allgemein verfügbar
az grafana api-key create

Erstellen Sie einen neuen API-Schlüssel.

 Erweiterung Allgemein verfügbar
az grafana api-key delete

Löschen Sie einen API-Schlüssel.

 Erweiterung Allgemein verfügbar
az grafana api-key list

Vorhandene API-Schlüssel auflisten.

 Erweiterung Allgemein verfügbar
az grafana backup

Sichern Sie den Inhalt einer Azure Managed Grafana-Instanz in einem Archiv.

 Erweiterung Vorschau
az grafana create

Erstellen Sie eine Azure Managed Grafana-Instanz.

 Erweiterung Allgemein verfügbar
az grafana dashboard

Befehle zum Verwalten von Dashboards einer Instanz.

 Erweiterung Allgemein verfügbar
az grafana dashboard create

Erstellen Sie ein neues Dashboard.

 Erweiterung Allgemein verfügbar
az grafana dashboard delete

Löschen sie ein Dashboard.

 Erweiterung Allgemein verfügbar
az grafana dashboard import

Importieren sie ein Dashboard.

 Erweiterung Allgemein verfügbar
az grafana dashboard list

Listet alle Dashboards einer Instanz auf.

 Erweiterung Allgemein verfügbar
az grafana dashboard show

Rufen Sie die Details eines Dashboards ab.

 Erweiterung Allgemein verfügbar
az grafana dashboard sync

Synchronisieren Sie Azure Managed Grafana-Dashboards von einer Instanz mit einer anderen Instanz. Beachten Sie, dass Dashboards mit dem Status "bereitgestellt" aufgrund schreibgeschützt übersprungen werden.

 Erweiterung Vorschau
az grafana dashboard update

Aktualisieren sie ein Dashboard.

 Erweiterung Allgemein verfügbar
az grafana data-source

Befehle zum Verwalten von Datenquellen einer Instanz.

 Erweiterung Allgemein verfügbar
az grafana data-source create

Erstellen Sie eine Datenquelle.

 Erweiterung Allgemein verfügbar
az grafana data-source delete

Löscht eine Datenquelle.

 Erweiterung Allgemein verfügbar
az grafana data-source list

Listet alle Datenquellen einer Instanz auf.

 Erweiterung Allgemein verfügbar
az grafana data-source query

Abfragen einer Datenquelle mit Back-End-Implementierung.

 Erweiterung Allgemein verfügbar
az grafana data-source show

Rufen Sie die Details einer Datenquelle ab.

 Erweiterung Allgemein verfügbar
az grafana data-source update

Aktualisieren einer Datenquelle.

 Erweiterung Allgemein verfügbar
az grafana delete

Löschen Sie eine Azure Managed Grafana-Instanz.

 Erweiterung Allgemein verfügbar
az grafana folder

Befehle zum Verwalten von Ordnern einer Instanz.

 Erweiterung Allgemein verfügbar
az grafana folder create

Neuen Ordner erstellen

 Erweiterung Allgemein verfügbar
az grafana folder delete

Löschen eines Ordners.

 Erweiterung Allgemein verfügbar
az grafana folder list

Listet alle Ordner einer Instanz auf.

 Erweiterung Allgemein verfügbar
az grafana folder show

Rufen Sie die Details eines Ordners ab.

 Erweiterung Allgemein verfügbar
az grafana folder update

Aktualisieren eines Ordners.

 Erweiterung Allgemein verfügbar
az grafana list

Listet Azure Managed Grafana-Instanzen auf.

 Erweiterung Allgemein verfügbar
az grafana notification-channel

Befehle zum Verwalten von Benachrichtigungskanälen einer Instanz.

 Erweiterung Allgemein verfügbar
az grafana notification-channel create

Erstellen Sie einen Benachrichtigungskanal.

 Erweiterung Allgemein verfügbar
az grafana notification-channel delete

Löschen eines Benachrichtigungskanals.

 Erweiterung Allgemein verfügbar
az grafana notification-channel list

Listet alle Benachrichtigungskanäle einer Instanz auf.

 Erweiterung Allgemein verfügbar
az grafana notification-channel show

Rufen Sie die Details eines Benachrichtigungskanals ab.

 Erweiterung Allgemein verfügbar
az grafana notification-channel test

Testen Sie einen Benachrichtigungskanal.

 Erweiterung Allgemein verfügbar
az grafana notification-channel update

Aktualisieren eines Benachrichtigungskanals.

 Erweiterung Allgemein verfügbar
az grafana restore

Stellen Sie eine Azure Managed Grafana-Instanz aus einem Archiv wieder her.

 Erweiterung Vorschau
az grafana service-account

Befehle zum Verwalten von Dienstkonten.

 Erweiterung Allgemein verfügbar
az grafana service-account create

Erstellen Sie ein neues Dienstkonto.

 Erweiterung Allgemein verfügbar
az grafana service-account delete

Löschen Eines Dienstkontos.

 Erweiterung Allgemein verfügbar
az grafana service-account list

Auflisten vorhandener Dienstkonten.

 Erweiterung Allgemein verfügbar
az grafana service-account show

Rufen Sie die Details eines Dienstkontos ab.

 Erweiterung Allgemein verfügbar
az grafana service-account token

Befehle zum Verwalten von Dienstkontotoken.

 Erweiterung Allgemein verfügbar
az grafana service-account token create

Erstellen Sie ein neues Dienstkontotoken.

 Erweiterung Allgemein verfügbar
az grafana service-account token delete

Löschen eines Dienstkontotokens.

 Erweiterung Allgemein verfügbar
az grafana service-account token list

Auflisten vorhandener Dienstkontotoken.

 Erweiterung Allgemein verfügbar
az grafana service-account update

Aktualisieren eines Dienstkontos.

 Erweiterung Allgemein verfügbar
az grafana show

Zeigen Sie Details einer Azure Managed Grafana-Instanz an.

 Erweiterung Allgemein verfügbar
az grafana update

Aktualisieren einer Azure Managed Grafana-Instanz.

 Erweiterung Allgemein verfügbar
az grafana user

Befehle zum Verwalten von Benutzern einer Instanz.

 Erweiterung Allgemein verfügbar
az grafana user actual-user

Rufen Sie die Details des aktuellen Benutzers ab.

 Erweiterung Allgemein verfügbar
az grafana user list

Benutzer auflisten.

 Erweiterung Allgemein verfügbar
az grafana user show

Rufen Sie die Details eines Benutzers ab.

 Erweiterung Allgemein verfügbar

az grafana backup

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Sichern Sie den Inhalt einer Azure Managed Grafana-Instanz in einem Archiv.

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

Beispiele

Sicherungsdashboards unter 2 Ordnern (Datenquellen sind enthalten, um die Namensneuzuordnung zu ermöglichen, wenn Dashboards in einem anderen Arbeitsbereich wiederhergestellt werden)

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

Sichern von Dashboards und Überspringen einiger Ordner

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

Erforderliche Parameter

--name -n

Name des azure Managed Grafana.

Optionale Parameter

--components -c

Grafana Artefakttypen zur Sicherung.

Zulässige Werte: annotations, dashboards, datasources, folders, snapshots
--directory -d

Verzeichnis zum Sichern von Grafana-Artefakten.

--folders-to-exclude -e

Ordner, die in der Sicherung oder Synchronisierung ausgeschlossen werden sollen.

--folders-to-include -i

Ordner, die in die Sicherung oder Synchronisierung einbezogen werden sollen.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana create

Erstellen Sie eine Azure Managed Grafana-Instanz.

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}]

Erforderliche Parameter

--name -n

Name des azure Managed Grafana.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--deterministic-outbound-ip -i

Wenn diese Option aktiviert ist, verfügt der Grafana-Arbeitsbereich über feste Ausgangs-IPs, die Sie in der Firewall der Datenquellen verwenden können. Standard: Deaktiviert.

Zulässige Werte: Disabled, Enabled
--location -l

Position. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--principal-ids

Durch Leerzeichen getrennte Azure AD-Objekt-IDs für Benutzer, Gruppen usw., die als Grafana-Administratoren erstellt werden sollen. Nach der Bereitstellung macht CLI den aktuellen angemeldeten Benutzer nicht mehr als Grafana-Administrator.

--principal-types

Durch Leerzeichen getrennte Azure AD-Prinzipaltypen, die mit --principal-ids gekoppelt werden sollen.

Zulässige Werte: Group, ServicePrincipal, User
--skip-role-assignments

Erstellen Sie keine Rollenzuweisungen für verwaltete Identität und den aktuellen Anmeldebenutzer.

Zulässige Werte: false, true
Standardwert: False
--skip-system-assigned-identity -s

Aktivieren Sie die vom System zugewiesene Identität nicht.

Zulässige Werte: false, true
Standardwert: False
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--zone-redundancy

Gibt an, ob Zonenredundanz aktiviert werden soll. Standard: Deaktiviert.

Zulässige Werte: Disabled, Enabled
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana delete

Löschen Sie eine Azure Managed Grafana-Instanz.

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

Erforderliche Parameter

--name -n

Name des azure Managed Grafana.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana list

Listet Azure Managed Grafana-Instanzen auf.

az grafana list [--resource-group]

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana restore

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Stellen Sie eine Azure Managed Grafana-Instanz aus einem Archiv wieder her.

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

Beispiele

Dashboards wiederherstellen. Wenn sie sich unter Ordnern befinden, fügen Sie "Ordner" in die Komponentenliste ein; verwenden Sie "--remap-data-sources", damit CLI Dashboards aktualisiert, um auf dieselben Datenquellen im Zielarbeitsbereich zu verweisen.

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

Erforderliche Parameter

--archive-file -a

Archivieren, um Grafana Artefakte wiederherzustellen.

--name -n

Name des azure Managed Grafana.

Optionale Parameter

--components -c

Grafana Artefakttypen zur Sicherung.

Zulässige Werte: annotations, dashboards, datasources, folders, snapshots
--remap-data-sources -r

Aktualisieren Sie während der Wiederherstellung Dashboards, um auf Datenquellen zu verweisen, die im Zielarbeitsbereich definiert sind, indem Sie den Namensabgleich durchführen.

Zulässige Werte: false, true
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana show

Zeigen Sie Details einer Azure Managed Grafana-Instanz an.

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

Erforderliche Parameter

--name -n

Name des azure Managed Grafana.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az grafana update

Aktualisieren einer Azure Managed Grafana-Instanz.

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]

Beispiele

Deaktivieren des öffentlichen Netzwerkzugriffs

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

Aktivieren der E-Mail-Benachrichtigung über SMTP-Relaysevice von 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

Erforderliche Parameter

--name -n

Name des azure Managed Grafana.

Optionale Parameter

--api-key --service-account

Wenn diese Option aktiviert ist, können Sie Grafana-API-Schlüssel und Dienstkonten konfigurieren.

Zulässige Werte: Disabled, Enabled
--deterministic-outbound-ip -i

Wenn diese Option aktiviert ist, verfügt der Grafana-Arbeitsbereich über feste Ausgangs-IPs, die Sie in der Firewall der Datenquellen verwenden können.

Zulässige Werte: Disabled, Enabled
--from-address

Adresse, die beim Senden von E-Mails verwendet wird.

--from-name

Name, der beim Senden von E-Mails verwendet werden soll.

--host

SMTP-Server-URL (port enthalten).

--major-version

Grafana Hauptversionsnummer.

--password

SMTP-Serverbenutzerkennwort.

--public-network-access -p

Zugriff auf öffentliche Netzwerke zulassen.

Zulässige Werte: Disabled, Enabled
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--skip-verify

Überspringen Sie die Überprüfung von SSL für SMTP-Server.

Zulässige Werte: false, true
--smtp

Erlauben Sie Grafana, E-Mails zu senden.

Zulässige Werte: Disabled, Enabled
--start-tls-policy

TLS-Richtlinie.

Zulässige Werte: MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--user

SMTP-Serverbenutzername.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.