az grafana

Referência

Observação

Essa referência faz parte da extensão amg para a CLI do Azure (versão 2.38.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az grafana . Saiba mais sobre extensões.

Comandos para gerenciar instâncias do Azure Grafana.

Para uma experiência otimizada, nem todas as APIs do plano de dados, documentadas no https://grafana.com/docs/grafana/latest/http_api/, são expostas. Sobre a lacuna de cobertura, entre em contato com .ad4g@microsoft.com

Comandos

Nome	Description	Tipo	Status
az grafana api-key	Comandos para gerenciar chaves de api.	Extensão	GA
az grafana api-key create	Crie uma nova chave de API.	Extensão	GA
az grafana api-key delete	Exclua uma chave de API.	Extensão	GA
az grafana api-key list	Listar chaves de API existentes.	Extensão	GA
az grafana backup	Faça backup do conteúdo de uma instância do Azure Managed Grafana em um arquivo.	Extensão	Visualizar
az grafana create	Crie uma instância do Espaço Gerenciado do Azure para Grafana.	Extensão	GA
az grafana dashboard	Comandos para gerenciar painéis de uma instância.	Extensão	GA
az grafana dashboard create	Crie um novo painel.	Extensão	GA
az grafana dashboard delete	Excluir um painel.	Extensão	GA
az grafana dashboard import	Importar um painel.	Extensão	GA
az grafana dashboard list	Listar todos os painéis de uma instância.	Extensão	GA
az grafana dashboard show	Obtenha os detalhes de um painel.	Extensão	GA
az grafana dashboard sync	Sincronize painéis do Azure Managed Grafana de uma instância para outra. Observe que os painéis com estado "provisionado" serão ignorados por serem somente leitura.	Extensão	Visualizar
az grafana dashboard update	Atualizar um painel.	Extensão	GA
az grafana data-source	Comandos para gerenciar fontes de dados de uma instância.	Extensão	GA
az grafana data-source create	Criar uma fonte de dados.	Extensão	GA
az grafana data-source delete	Excluir uma fonte de dados.	Extensão	GA
az grafana data-source list	Listar todas as fontes de dados de uma instância.	Extensão	GA
az grafana data-source query	Consulte uma fonte de dados com implementação de back-end.	Extensão	GA
az grafana data-source show	Obtenha os detalhes de uma fonte de dados.	Extensão	GA
az grafana data-source update	Atualizar uma fonte de dados.	Extensão	GA
az grafana delete	Exclua uma instância do Azure Managed Grafana.	Extensão	GA
az grafana folder	Comandos para gerenciar pastas de uma instância.	Extensão	GA
az grafana folder create	Criar uma nova pasta.	Extensão	GA
az grafana folder delete	Excluir uma pasta.	Extensão	GA
az grafana folder list	Listar todas as pastas de uma instância.	Extensão	GA
az grafana folder show	Obtenha os detalhes de uma pasta.	Extensão	GA
az grafana folder update	Atualizar uma pasta.	Extensão	GA
az grafana list	Listar instâncias do Azure Managed Grafana.	Extensão	GA
az grafana notification-channel	Comandos para gerenciar canais de notificação de uma instância.	Extensão	GA
az grafana notification-channel create	Crie um canal de notificação.	Extensão	GA
az grafana notification-channel delete	Excluir um canal de notificação.	Extensão	GA
az grafana notification-channel list	Listar todos os canais de notificação de uma instância.	Extensão	GA
az grafana notification-channel show	Obtenha os detalhes de um canal de notificação.	Extensão	GA
az grafana notification-channel test	Teste um canal de notificação.	Extensão	GA
az grafana notification-channel update	Atualizar um canal de notificação.	Extensão	GA
az grafana restore	Restaure uma instância do Azure Managed Grafana a partir de um arquivo.	Extensão	Visualizar
az grafana service-account	Comandos para gerenciar contas de serviço.	Extensão	GA
az grafana service-account create	Crie uma nova conta de serviço.	Extensão	GA
az grafana service-account delete	Excluir uma conta de serviço.	Extensão	GA
az grafana service-account list	Listar contas de serviço existentes.	Extensão	GA
az grafana service-account show	Obtenha os detalhes de uma conta de serviço.	Extensão	GA
az grafana service-account token	Comandos para gerenciar tokens de conta de serviço.	Extensão	GA
az grafana service-account token create	Crie um novo token de conta de serviço.	Extensão	GA
az grafana service-account token delete	Exclua um token de conta de serviço.	Extensão	GA
az grafana service-account token list	Listar tokens de conta de serviço existentes.	Extensão	GA
az grafana service-account update	Atualizar uma conta de serviço.	Extensão	GA
az grafana show	Mostrar detalhes de uma instância do Azure Managed Grafana.	Extensão	GA
az grafana update	Atualize uma instância do Azure Managed Grafana.	Extensão	GA
az grafana user	Comandos para gerenciar usuários de uma instância.	Extensão	GA
az grafana user actual-user	Obtenha os detalhes do usuário atual.	Extensão	GA
az grafana user list	Listar usuários.	Extensão	GA
az grafana user show	Obtenha os detalhes de um usuário.	Extensão	GA

az grafana backup

Versão Prévia

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Faça backup do conteúdo de uma instância do Azure Managed Grafana em um arquivo.

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

Exemplos

Painéis de backup em 2 pastas (fontes de dados são incluídas para habilitar o remapeamento de nomes ao restaurar painéis para outro espaço de trabalho)

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

fazer backup de painéis e ignorar algumas pastas

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

Parâmetros Exigidos

--name -n

Nome do Azure Managed Grafana.

Parâmetros Opcionais

--components -c

Tipos de artefato de Grafana para backup.

valores aceitos: annotations, dashboards, datasources, folders, snapshots

--directory -d

Diretório para backup de artefatos Grafana.

--folders-to-exclude -e

Pastas a serem excluídas no backup ou sincronização.

--folders-to-include -i

Pastas a serem incluídas no backup ou sincronização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana create

Crie uma instância do Espaço Gerenciado do Azure para Grafana.

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

Parâmetros Exigidos

--name -n

Nome do Azure Managed Grafana.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--deterministic-outbound-ip -i

Se habilitado, o espaço de trabalho Grafana terá IPs de saída fixos que você pode usá-los no firewall de fontes de dados. Padrão: Desativado.

valores aceitos: Disabled, Enabled

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--principal-ids

IDs de objeto do Azure AD separados por espaço para usuários, grupos, etc. a serem feitos como administradores do Grafana. Uma vez fornecida, a CLI não tornará o usuário conectado atual como Grafana Admin.

--principal-types

Tipos de entidade do Azure AD separados por espaço para emparelhar com --principal-ids.

valores aceitos: Group, ServicePrincipal, User

--skip-role-assignments

Não crie atribuições de função para a identidade gerenciada e o usuário de logon atual.

valores aceitos: false, true

valor padrão: False

--skip-system-assigned-identity -s

Não habilite a identidade atribuída ao sistema.

valores aceitos: false, true

valor padrão: False

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--zone-redundancy

Indica se a redundância de zona deve ou não ser habilitada. Padrão: Desativado.

valores aceitos: Disabled, Enabled

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana delete

Exclua uma instância do Azure Managed Grafana.

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

Parâmetros Exigidos

--name -n

Nome do Azure Managed Grafana.

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana list

Listar instâncias do Azure Managed Grafana.

az grafana list [--resource-group]

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana restore

Versão Prévia

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Restaure uma instância do Azure Managed Grafana a partir de um arquivo.

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

Exemplos

Restaurar painéis. Se estiverem em pastas, inclua "pastas" na lista de componentes; use "--remap-data-sources" para que a CLI atualize os painéis para apontar para as mesmas fontes de dados no espaço de trabalho de destino

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

Parâmetros Exigidos

--archive-file -a

Arquivo para restaurar artefatos Grafana de.

--name -n

Nome do Azure Managed Grafana.

Parâmetros Opcionais

--components -c

Tipos de artefato de Grafana para backup.

valores aceitos: annotations, dashboards, datasources, folders, snapshots

--remap-data-sources -r

Durante a restauração, atualize os painéis para fazer referência a fontes de dados definidas no espaço de trabalho de destino por meio da correspondência de nomes.

valores aceitos: false, true

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana show

Mostrar detalhes de uma instância do Azure Managed Grafana.

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

Parâmetros Exigidos

--name -n

Nome do Azure Managed Grafana.

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana update

Atualize uma instância do Azure Managed Grafana.

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]

Exemplos

Desabilitar o acesso à rede pública

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

habilitar notificação de email por meio de serviço de retransmissão SMTP de 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

Parâmetros Exigidos

--name -n

Nome do Azure Managed Grafana.

Parâmetros Opcionais

--api-key --service-account

Se habilitado, você poderá configurar chaves de API e contas de serviço do Grafana.

valores aceitos: Disabled, Enabled

--deterministic-outbound-ip -i

Se habilitado, o espaço de trabalho Grafana terá IPs de saída fixos que você pode usá-los no firewall de fontes de dados.

valores aceitos: Disabled, Enabled

--from-address

Endereço usado ao enviar e-mails.

--from-name

Nome a ser usado ao enviar e-mails.

--host

URL do servidor SMTP (porta incluída).

--major-version

Número da versão principal do Grafana.

--password

Senha de usuário do servidor SMTP.

--public-network-access -p

Permitir acesso à rede pública.

valores aceitos: Disabled, Enabled

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--skip-verify

Ignore a verificação de SSL para o servidor SMTP.

valores aceitos: false, true

--smtp

Permitir que Grafana envie e-mails.

valores aceitos: Disabled, Enabled

--start-tls-policy

Política de TLS.

valores aceitos: MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--user

Nome de usuário do servidor SMTP.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

valor padrão: json

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az grafana

Comandos

az grafana backup

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az grafana create

Parâmetros Exigidos

Parâmetros Opcionais

az grafana delete

Parâmetros Exigidos

Parâmetros Opcionais

az grafana list

Parâmetros Opcionais

az grafana restore

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az grafana show

Parâmetros Exigidos

Parâmetros Opcionais

az grafana update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários

Recursos adicionais