Cloud Monitor:Adicionar uma fonte de dados do Prometheus no Grafana

Self-managed Grafana

Esta seção usa o Grafana v10.x como exemplo. Para informações sobre como adicionar uma fonte de dados em outras versões, consulte a documentação oficial do Grafana.

1. Configure a fonte de dados do Grafana.

   1. Faça login no seu Grafana autogerenciado como administrador.

   2. No canto superior esquerdo da página, clique em no ícone de menu e escolha Administration > Data sources.

   3. Clique em + Add new data source e selecione Prometheus como tipo de fonte de dados.

   4. Na aba Settings, insira um nome personalizado no campo Name. No campo Prometheus server URL, cole a URL da API HTTP obtida em Step 1.

   5. Configure a autenticação.

      V1 instances (optional)

      Clique em + Add header. Na seção Custom HTTP Headers, clique em +Add header, defina Header como Authorization e configure Value com o token de autenticação obtido em Step 1.

      V2 instances

      Ative Basic auth. Defina User com seu AccessKey ID e Password com seu AccessKey secret.

2. Na parte inferior da página, clique em Save & Test.

3. Visualize métricas do Prometheus.

   1. Faça login no seu sistema Grafana.

   2. No canto superior esquerdo da página, clique em no ícone de menu e, em seguida, clique em Dashboards no painel de navegação à esquerda.

   3. Na página Dashboards, clique em New no canto superior direito e, depois, clique em New dashboard no menu suspenso.

   4. Clique em + Add visualization. Na página Select data source, selecione a fonte de dados criada.

   5. Na página Edit Panel, acesse a aba Query. Na seção A, insira o nome e o valor da métrica nos campos Metrics e Label filters e clique em Run queries.

      Se um gráfico da métrica for exibido, a configuração foi bem-sucedida. Caso contrário, verifique se a URL da API e o token estão corretos e se a fonte de dados contém dados de monitoramento do Prometheus.

      

Managed Service for Grafana

O Managed Service for Grafana oferece integração com um clique para fontes de dados e painéis do Prometheus.

1. Faça login no console do ARMS. No painel de navegação à esquerda, escolha Managed Service for Grafana > Workspace Management e clique em no ID do seu workspace.

2. Na página Workspace Information, localize a seção Cloud Service Integration e clique em Prometheus Monitoring Service. Em seguida, encontre sua instância e clique em Integrate.

3. Na caixa de diálogo exibida, clique em OK.

   Se estiver integrando uma instância V2 do Prometheus, insira o AccessKey ID da fonte de dados.

4. Após a conclusão da sincronização, clique em no ícone de folder à direita.

5. No Grafana, na aba Dashboards, clique em no nome de um painel para visualizar os painéis padrão pré-construídos para monitoramento de aplicações.

6. No canto superior esquerdo da página, clique em no ícone de menu e escolha Administration > Data sources para visualizar a fonte de dados de monitoramento de aplicações adicionada.

7. Visualize métricas do Prometheus.

   1. Faça login no seu sistema Grafana.

   2. No canto superior esquerdo da página, clique em no ícone de menu e, em seguida, clique em Dashboards no painel de navegação à esquerda.

   3. Na página Dashboards, clique em New no canto superior direito e, depois, clique em New dashboard no menu suspenso.

   4. Clique em + Add visualization. Na página Select data source, selecione a fonte de dados criada.

   5. Na página Edit Panel, acesse a aba Query. Na seção A, insira o nome e o valor da métrica nos campos Metrics e Label filters e clique em Run queries.

      Se um gráfico da métrica for exibido, a configuração foi bem-sucedida. Caso contrário, verifique se a URL da API e o token estão corretos e se a fonte de dados contém dados de monitoramento do Prometheus.

      

V1 instances

GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: {Token}
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}

V2 instances

GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: Basic <base64Encode(<AccessKey ID:AccessKey secret>)>
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}

Também é possível usar Python e a biblioteca requests para chamar a API. Os exemplos a seguir mostram como consultar dados de monitoramento do Prometheus com autenticação V2 Basic Auth e V1 Token.

Instâncias V2 (Basic Auth)

import base64
import requests

access_key_id = "<AccessKey ID>"
access_key_secret = "<AccessKey secret>"
http_api_url = "{http_api_url}"

credentials = f"{access_key_id}:{access_key_secret}"
auth_header = base64.b64encode(credentials.encode()).decode()

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": f"Basic {auth_header}"
}

response = requests.get(
    f"{http_api_url}/api/v1/query",
    params={"query": "up"},
    headers=headers
)

result = response.json()
print(result["status"])
print(result["data"]["result"])

Instâncias V1 (Token)

import requests

http_api_url = "{http_api_url}"
token = "{token}"

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": token
}

response = requests.get(
    f"{http_api_url}/api/v1/query",
    params={"query": "up"},
    headers=headers
)

result = response.json()
print(result["status"])
print(result["data"]["result"])