Tutorial: Chamar APIs do Grafana programaticamente

Neste tutorial, irá aprender a:

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

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Um espaço de trabalho do Azure Managed Grafana. Crie uma instância do Azure Managed Grafana.
• Um aplicativo Microsoft Entra com uma entidade de serviço. Crie uma entidade de serviço e aplicativo Microsoft Entra. Para simplificar, use um aplicativo localizado no mesmo locatário do Microsoft Entra que sua instância do Azure Managed Grafana.

Iniciar sessão no Azure

Inicie sessão no portal do Azure em https://portal.azure.com/ com a sua conta do Azure.

Atribuir uma função do Azure Managed Grafana à entidade de serviço do seu aplicativo

1. No portal do Azure, abra sua instância do Managed Grafana.

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

3. Selecione Adicionar e, em seguida , Adicionar atribuição de função.

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

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

6. Selecione Selecionar membros, selecione sua entidade de serviço e pressione Selecionar.

7. Selecione Rever + atribuir.

   

Recuperar detalhes do aplicativo

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

1. Encontre o seu ID de inquilino:

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

   

2. Encontre o seu ID de cliente:

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

   

3. Crie um segredo de aplicativo:

   1. No portal do Azure, no Microsoft Entra ID, selecione Registros de aplicativos no menu à esquerda.
   2. Selecione a sua aplicação.
   3. Selecione Certificados & segredos no menu à esquerda.
   4. Selecione Novo segredo do cliente.
   5. Crie um novo segredo do cliente e salve seu valor.

   

   Nota

   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 Grafana:

   1. No portal do Azure, insira Azure Managed Grafana na barra de recursos, serviços e documentos de pesquisa (G+ /).
   2. Selecione Azure Managed Grafana e abra seu espaço de trabalho Managed Grafana .
   3. Selecione Visão geral no menu esquerdo e salve o valor do ponto final .

   

Obter um token de acesso

Para acessar as APIs do Grafana, 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.

CLI do Azure

Entre na CLI do Azure executando o comando az login e substitua <client-id>, <client-secret>e <tenant-id> com a ID do aplicativo (cliente), o 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. Aqui está 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"
}

Nota

Você só pode visualizar essa chave aqui uma vez. Guarde-o num local seguro.

Pedido POST

Siga o exemplo abaixo para chamar o Microsoft Entra ID e recuperar um token. Substitua <tenant-id>, <client-id>e <client-secret> pelo ID do locatário, ID do aplicativo (cliente) e segredo do cliente coletados na etapa anterior.

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id=<client-id>&client_secret=<client-secret>&resource=ce34e7e5-485f-4d76-964f-b3d2b16d1e4f' \
https://login.microsoftonline.com/<tenant-id>/oauth2/token

Aqui está um exemplo de resposta:

{
  "token_type": "Bearer",
  "expires_in": "599",
  "ext_expires_in": "599",
  "expires_on": "1575500555",
  "not_before": "1575499766",
  "resource": "ce34...1e4f",
  "access_token": "eyJ0eXAiOiJ......AARUQ"
}

Chamar APIs do Grafana

Agora você pode chamar APIs do Grafana usando o token de acesso recuperado na etapa anterior como o cabeçalho Authorization. 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 sua instância do Grafana. Por exemplo, https://my-grafana-abcd.cuse.grafana.azure.com.

Clean up resources (Limpar recursos)

Se você não vai continuar a usar esses recursos, exclua-os com as seguintes etapas:

1. Exclua o Azure Managed Grafana:

   1. No portal do Azure, no Azure Managed Grafana, selecione Visão geral no menu à esquerda.
   2. Selecione Eliminar.
   3. Digite o nome do recurso para confirmar a exclusão e selecione Excluir.

2. Exclua o aplicativo Microsoft Entra:

   1. No portal do Azure, no Microsoft Entra ID, selecione Registros de aplicativos no menu à esquerda.
   2. Selecione a sua aplicação.
   3. Na guia Visão geral, selecione Excluir.
   4. Selecione Eliminar.

Próximos passos

Como configurar fontes de dados