Compartilhar via


Tutorial: como chamar as APIs do Grafana programaticamente

Neste tutorial, você aprenderá a:

  • Atribuir uma função do Espaço Gerenciado do Azure para Grafana à entidade de serviço do aplicativo
  • Recuperar detalhes do aplicativo
  • Obter um token de acesso
  • Chamar APIs do Grafana

Pré-requisitos

Entrar no Azure

Entre no portal do Azure em https://portal.azure.com/ com sua conta do Azure.

Atribuir uma função do Espaço Gerenciado do Azure para Grafana à entidade de serviço do aplicativo

  1. Abra a instância do Espaço Gerenciado para Grafana no portal do Azure.

  2. Selecione Controle de Acesso (IAM) no menu de navegação.

  3. Selecione Adicionar e Adicionar atribuição de função.

  4. Selecione a função Editor do Grafana e clique em Avançar.

  5. Em Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço.

  6. Selecione Selecionar membros, escolha sua entidade de serviço e clique em Selecionar.

  7. Selecione Examinar + atribuir.

    Captura de tela de Adicionar atribuição de função na plataforma Azure.

Recuperar detalhes do aplicativo

Agora você precisa coletar algumas informações que usará para obter um token de acesso à API do Grafana e chamar APIs do Grafana.

  1. Localize a ID de locatário:

    1. No portal do Azure, insira Microsoft Entra ID em Pesquisar recursos, serviços e documentos (G+/).
    2. Selecione ID do Microsoft Entra.
    3. Selecione Propriedades no menu à esquerda.
    4. Localize o campo ID do Locatário e salve seu valor.

    Captura de tela do portal do Azure, obtendo a ID do locatário.

  2. Encontre a ID do cliente:

    1. No portal do Azure, no Microsoft Entra ID, selecione Registros de aplicativo no menu à esquerda.
    2. Selecione seu aplicativo.
    3. Em Visão geral, localize o campo ID do aplicativo (cliente) e salve seu valor.

    Captura de tela do portal do Azure, obtendo a ID do cliente.

  3. Crie um segredo do aplicativos:

    1. No portal do Azure, no Microsoft Entra ID, selecione Registros de aplicativo no menu à esquerda.
    2. Selecione seu aplicativo.
    3. Escolha Certificados e segredos no menu à esquerda.
    4. Selecione Novo segredo do cliente.
    5. Crie um segredo do cliente e salve seu valor.

    Captura de tela do portal do Azure, criando um segredo.

    Observação

    Você só pode acessar o valor de um segredo imediatamente após criá-lo. Copie o valor antes de sair da página para usá-lo na próxima etapa deste tutorial.

  4. Encontre o URL do ponto de extremidade da Grafana:

    1. No portal do Azure, insira Espaço Gerenciado do Azure para Grafana na barra Pesquisar recursos, serviços e documentos (G+/).
    2. Selecione Espaço Gerenciado do Azure para Grafana e abra o Espaço Gerenciado para Grafana.
    3. Selecione Visão geral no menu à esquerda e salve o valor do Ponto de extremidade.

    Captura de tela da plataforma Azure. Ponto de extremidade exibido na página Visão geral.

Obter um token de acesso

Para acessar APIs do Grafana, primeiro você precisa obter um token de acesso. Você pode obter o token de acesso usando a CLI do Azure ou fazendo uma solicitação POST.

Entre na CLI do Azure executando o comando az login e substitua <client-id>, <client-secret> e <tenant-id> pela ID do aplicativo (cliente), segredo do cliente e a ID do locatário coletados na etapa anterior:

az login --service-principal --username "<client-id>" --password "<client-secret>" --tenant "<tenant-id>"

Use o comando az grafana api-key create para criar uma chave. Veja um exemplo de saída:

az grafana api-key create --key keyname --name <name> --resource-group <rg> --role editor --output json

{
  "id": 3,
  "key": "<redacted>",
  "name": "keyname"
}

Observação

Você só pode exibir essa chave aqui uma vez. Salve-a em um local seguro.

Chamar APIs do Grafana

Agora, é possível chamar a API do Grafana usando o token de acesso recuperado na etapa anterior como o cabeçalho de autorização. Por exemplo:

curl -X GET \
-H 'Authorization: Bearer <access-token>' \
https://<grafana-url>/api/user

Substitua <access-token> e <grafana-url> pelo token de acesso recuperado na etapa anterior e a URL do ponto de extremidade da instância do Grafana. Por exemplo, https://my-grafana-abcd.cuse.grafana.azure.com.

Limpar os recursos

Se você não quiser continuar usando esses recursos, exclua-os com as seguintes etapas:

  1. Excluir o Espaço Gerenciado do Azure para Grafana:

    1. No portal do Azure, no Espaço Gerenciado do Azure para Grafana, selecione Visão geral no menu à esquerda.
    2. Selecione Excluir.
    3. Insira o nome do recursos para confirmar a exclusão e selecione Excluir.
  2. Exclua o aplicativo do Microsoft Entra:

    1. No portal do Azure, no Microsoft Entra ID, selecione Registros de aplicativo no menu à esquerda.
    2. Selecione seu aplicativo.
    3. Na página Visão Geral, selecione Excluir.
    4. Selecione Excluir.

Próximas etapas