Tutorial: como chamar as APIs do Grafana programaticamente

Neste tutorial, você aprenderá a:

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Um espaço de trabalho do Espaço Gerenciado do Azure para Grafana. Criar um workspace do Espaço Gerenciado do Azure para Grafana.
• Um aplicativo do Microsoft Entra com uma entidade de serviço. Crie um aplicativo e uma entidade de serviço do Microsoft Entra. Para simplificar, use um aplicativo localizado no mesmo locatário do Microsoft Entra que o Espaço Gerenciado do Azure para Grafana.

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. No portal do Azure, abra o workspace do Espaço Gerenciado do Azure para Grafana.

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.

   

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.

   

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.

   

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.

   

   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 workspace do Espaço Gerenciado para Grafana.
   3. Selecione Visão geral no menu à esquerda e salve o valor do Ponto de extremidade.

   

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.

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

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

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

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

{
  "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, é 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 do workspace 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