Application Real-Time Monitoring Service:Acesse dados de monitoramento do Prometheus por URLs de API HTTP

Autenticação

O Managed Service for Prometheus oferece duas versões de instância, cada uma com um método de autenticação diferente.

Pré-requisitos

Antes de começar, verifique se você tem:

• Uma instância do Prometheus conectada. Para instruções de configuração, consulte:

  • Container observability

  • Alibaba Cloud service observability

  • Host observability

• (Para Grafana) Uma instância do Grafana autogerenciada com acesso de administrador.

• (Para Prometheus V2) Um par de AccessKeys da conta e as permissões necessárias no usuário RAM associado.

Obtenha a URL da API HTTP

1. Faça login no console do CloudMonitor.

2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.

3. Na barra de navegação superior, selecione a região onde a instância do Prometheus está localizada.

4. Localize a instância do Prometheus e clique em Settings na coluna Actions.

5. Na aba Settings, copie a URL da API HTTP.

   • Use a URL pública se a instância do Grafana ou a aplicação estiver fora da rede interna da Alibaba Cloud.

   • Use a URL interna se a instância do Grafana ou a aplicação estiver na mesma região da Alibaba Cloud e puder acessar endpoints internos.

6. (Apenas Prometheus V1) Clique em Generate Token para criar um token de autenticação. Salve este token para uso posterior.

Configure uma fonte de dados no Grafana autogerenciado

Verifique a fonte de dados no Grafana

1. No Grafana, acesse Dashboards e clique em New > New dashboard.

2. Clique em + Add visualization e selecione a fonte de dados configurada.

3. Na página Edit Panel, abra a aba Query. Na seção A, insira o nome de uma métrica no campo Metrics (por exemplo, arms_prometheus_target_interval_length_seconds_sum) e configure os Label filters conforme necessário.

4. Clique em Run queries.

Se um gráfico for renderizado com dados de métricas, a fonte de dados estará funcionando corretamente. Caso nenhum gráfico apareça, verifique se a URL da API ou o token são válidos e se a fonte de dados possui informações de monitoramento. Para obter ajuda adicional, consulte Solução de problemas.

Consulte a API HTTP programaticamente

Os exemplos abaixo usam o endpoint /api/v1/query para consultas instantâneas. Para consultas de intervalo (/api/v1/query_range), metadados de séries e outros endpoints, consulte a referência da API HTTP do Prometheus.

curl -G '<your-http-api-url>/api/v1/query' \
  -H 'Authorization: <your-token>' \
  -H 'Accept: application/json' \
  --data-urlencode 'query=arms_prometheus_target_interval_length_seconds_sum' \
  --data-urlencode 'time=1635302655' \
  --data-urlencode 'timeout=1000'

import requests

token = "your-token"
api_url = "https://your-prometheus-api-url"

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

data = response.json()
for result in data["data"]["result"]:
    print(f"Metric: {result['metric']}")
    print(f"Value: {result['value']}")

curl -G '<your-http-api-url>/api/v1/query' \
  -u '<your-accesskey-id>:<your-accesskey-secret>' \
  -H 'Accept: application/json' \
  --data-urlencode 'query=arms_prometheus_target_interval_length_seconds_sum' \
  --data-urlencode 'time=1635302655' \
  --data-urlencode 'timeout=1000'

import requests
import time

# Obtain the HTTP API URL from the console.
api_url = 'http://cn-hangzhou.arms.aliyuncs.com:9090/api/v1/prometheus/{token}/{user_id}/{cluster_id}/{region}'

# Use the AccessKey ID as the username and the AccessKey secret as the password.
ak_id = 'your_access_key_id'
ak_secret = 'your_access_key_secret'

# Query a metric.
resp = requests.get(f'{api_url}/api/v1/query', params={'query': 'up'}, auth=(ak_id, ak_secret))
print(resp.json())

# Range query (the last 1 hour).
end = int(time.time())
start = end - 3600
resp = requests.get(f'{api_url}/api/v1/query_range', params={'query': 'up', 'start': start, 'end': end, 'step': '60s'}, auth=(ak_id, ak_secret))
print(resp.json())

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "15s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "146655.24420603***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "30s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "879810.747346***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "20s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "73320.13578499***"
                ]
            }
        ]
    }
}

Solução de problemas

Tópicos relacionados

• Referência da API HTTP do Prometheus -- Documentação completa da API para endpoints de consulta, incluindo consultas de intervalo (/api/v1/query_range), consultas de rótulos e metadados de séries.

• Criar um painel do Grafana -- Crie painéis usando a fonte de dados conectada.