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. Crie uma instância 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 da instância do 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. 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.

   

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