az grafana
Nota
Essa referência faz parte da extensão amg para a CLI do Azure (versão 2.61.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 recursos do Azure Managed Grafana.
Comandos
Name | Description | Tipo | Status |
---|---|---|---|
az grafana api-key |
Comandos para gerenciar chaves 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 |
Liste as 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 | Pré-visualizar |
az grafana create |
Crie um espaço de trabalho para o recurso Grafana. Esta API é idempotente, então o usuário pode criar um novo grafana ou atualizar um grafana existente. |
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 |
Exclua um painel. |
Extensão | GA |
az grafana dashboard import |
Importe um painel. |
Extensão | GA |
az grafana dashboard list |
Liste 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. Os painéis da biblioteca dentro dos painéis serão automaticamente incluídos na sincronização. Observe que os painéis com o estado "Provisionado" serão ignorados devido a serem somente leitura. |
Extensão | Pré-visualizar |
az grafana dashboard update |
Atualize 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 |
Crie 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 |
Liste todas as fontes de dados de uma instância. |
Extensão | GA |
az grafana data-source query |
Consultar 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 um espaço de trabalho para o recurso 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 |
Exclua uma pasta. |
Extensão | GA |
az grafana folder list |
Liste 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 |
Atualize uma pasta. |
Extensão | GA |
az grafana list |
Liste todos os recursos de espaços de trabalho para o Grafana sob a assinatura especificada. |
Extensão | GA |
az grafana list-available-plugin |
Liste todos os plugins disponíveis. |
Extensão | GA |
az grafana migrate |
Migre uma instância do Grafana existente para uma instância do Azure Managed Grafana. |
Extensão | Pré-visualizar |
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 |
Exclua um canal de notificação. |
Extensão | GA |
az grafana notification-channel list |
Liste 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 |
Atualize 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 | Pré-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 |
Exclua 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 |
Obtenha as propriedades de um espaço de trabalho específico para o recurso Grafana. |
Extensão | GA |
az grafana update |
Atualize um espaço de trabalho para o recurso 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 wait |
Coloque a CLI em um estado de espera até que uma condição seja atendida. |
Extensão | GA |
az grafana backup
Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 (as 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
Faça backup de painéis e ignore algumas pastas
az grafana backup -g MyResourceGroup -n MyGrafana -d c:\temp --folders-to-exclude General "Azure Monitor" --components datasources dashboards folders
Parâmetros Obrigatórios
Nome do Azure Managed Grafana.
Parâmetros Opcionais
Tipos de artefato Grafana para backup.
Diretório para backup de artefatos Grafana.
Pastas a serem excluídas no backup ou sincronização.
Pastas a serem incluídas no backup ou sincronização.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana create
Crie um espaço de trabalho para o recurso Grafana. Esta API é idempotente, então o usuário pode criar um novo grafana ou atualizar um grafana existente.
az grafana create --name
--resource-group
[--api-key {Disabled, Enabled}]
[--deterministic-outbound-ip {Disabled, Enabled}]
[--grafana-major-version]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--principal-ids]
[--public-network-access {Disabled, Enabled}]
[--skip-identity {0, 1, f, false, n, no, t, true, y, yes}]
[--skip-role-assignments {0, 1, f, false, n, no, t, true, y, yes}]
[--sku-tier]
[--tags]
[--zone-redundancy {Disabled, Enabled}]
Exemplos
criar recurso Azure Managed Grafana com Sku padrão e acesso à rede pública habilitado
az grafana create --resource-group myResourceGroup --workspace-name myWorkspace --sku-tier Standard --public-network-access Enabled
Parâmetros Obrigatórios
O nome do espaço de trabalho do Azure Managed Grafana.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
A configuração de chave api da instância Grafana.
Se uma instância do Grafana usa IPs de saída determinísticos.
A principal versão do software Grafana para segmentar.
A geo-localização onde vive o recurso grafana.
Não espere que a operação de longa duração termine.
IDs de objeto do Azure AD separadas por espaço para usuários, grupos, etc. a serem feitas como administradores do Grafana. Uma vez fornecida, a CLI não tornará o usuário conectado atual como sintaxe abreviada do Grafana Admin Support, json-file e yaml-file. Tente "??" para mostrar mais.
Indique o estado para habilitar ou desabilitar o tráfego na interface pública.
Não habilite a identidade atribuída ao sistema. Use esta opção se quiser gerenciar a identidade por conta própria.
Ignore a criação de atribuições de função padrão para a identidade gerenciada da instância Grafana e da conta CLI atual. Use esta opção se quiser gerenciar atribuições de função por conta própria.
O Sku do recurso grafana.
As tags para o recurso grafana. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.
A configuração de redundância de zona da instância Grafana.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana delete
Exclua um espaço de trabalho para o recurso Grafana.
az grafana delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do espaço de trabalho do Azure Managed Grafana.
Não espere que a operação de longa duração termine.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana list
Liste todos os recursos de espaços de trabalho para o Grafana sob a assinatura especificada.
az grafana list [--max-items]
[--next-token]
[--resource-group]
Parâmetros Opcionais
Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token
argumento de um comando subsequente.
Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana list-available-plugin
Liste todos os plugins disponíveis.
az grafana list-available-plugin [--ids]
[--name]
[--resource-group]
[--subscription]
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do espaço de trabalho do Azure Managed Grafana.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana migrate
Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Migre uma instância do Grafana existente para uma instância do Azure Managed Grafana.
az grafana migrate --name
--src-endpoint
--src-token-or-key
[--dry-run {false, true}]
[--folders-to-exclude]
[--folders-to-include]
[--overwrite {false, true}]
[--resource-group]
Exemplos
Migre painéis e pastas de uma instância local do Grafana para uma instância do Azure Managed Grafana.
az grafana migrate -g MyResourceGroup -n MyGrafana -s http://localhost:3000 -t YourServiceTokenOrAPIKey
Parâmetros Obrigatórios
Nome do Azure Managed Grafana.
Ponto de extremidade de instância Grafana para migrar.
Token de serviço de instância Grafana (ou chave de api) para obter acesso para migrar.
Parâmetros Opcionais
Visualize as alterações sem confirmar. Tem prioridade sobre --overwrite.
Pastas a serem excluídas no backup ou sincronização.
Pastas a serem incluídas no backup ou sincronização.
Substitua painéis anteriores, painéis de biblioteca e pastas com o mesmo uid ou título.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana restore
Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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
Restaure 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 Obrigatórios
Arquivo para restaurar artefatos de Grafana.
Nome do Azure Managed Grafana.
Parâmetros Opcionais
Tipos de artefato Grafana para backup.
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.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana show
Obtenha as propriedades de um espaço de trabalho específico para o recurso Grafana.
az grafana show [--ids]
[--name]
[--resource-group]
[--subscription]
Parâmetros Opcionais
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do espaço de trabalho do Azure Managed Grafana.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana update
Atualize um espaço de trabalho para o recurso Grafana.
az grafana update [--api-key {Disabled, Enabled}]
[--deterministic-outbound-ip {Disabled, Enabled}]
[--from-address]
[--from-name]
[--grafana-major-version]
[--host]
[--ids]
[--name]
[--password]
[--public-network-access {Disabled, Enabled}]
[--resource-group]
[--skip-verify {0, 1, f, false, n, no, t, true, y, yes}]
[--sku-tier]
[--smtp {0, 1, f, false, n, no, t, true, y, yes}]
[--start-tls-policy {MandatoryStartTLS, NoStartTLS, OpportunisticStartTLS}]
[--subscription]
[--tags]
[--user]
[--zone-redundancy {Disabled, Enabled}]
Exemplos
Desativar o acesso à rede pública
az grafana update -g MyResourceGroup -n MyGrafana --public-network-access disabled
habilitar notificação de e-mail através de retransmissão SMTP sevice 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 Opcionais
A configuração de chave api da instância Grafana.
Se uma instância do Grafana usa IPs de saída determinísticos.
Endereço usado ao enviar e-mails https://pkg.go.dev/net/mail#Address.
Nome a ser usado ao enviar e-mails. O padrão é "Azure Managed Grafana Notification" https://pkg.go.dev/net/mail#Address.
A principal versão do software Grafana para segmentar.
Nome de host do servidor SMTP com porta, por exemplo, test.email.net:587.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do espaço de trabalho do Azure Managed Grafana.
Senha do SMTP auth. Se a senha contiver # ou ;, então você tem que envolvê-la com aspas triplas.
Indique o estado para habilitar ou desabilitar o tráfego na interface pública.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Verifique o SSL para o servidor SMTP. O padrão é false https://pkg.go.dev/crypto/tls#Config.
O Sku do recurso grafana.
Habilite isso para permitir que o Grafana envie e-mails.
A configuração StartTLSPolicy da configuração https://pkg.go.dev/github.com/go-mail/mail#StartTLSPolicySMTP .
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
As tags para o recurso grafana. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.
Usuário de SMTP auth.
A configuração de redundância de zona da instância Grafana.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az grafana wait
Coloque a CLI em um estado de espera até que uma condição seja atendida.
az grafana wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parâmetros Opcionais
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
Intervalo de sondagem em segundos.
O nome do espaço de trabalho do Azure Managed Grafana.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Espera máxima em segundos.
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
o .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.