Managed Service for Prometheus:Access Prometheus monitoring data through HTTP API URLs

Autenticação

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

Pré-requisitos

Antes de começar, certifique-se de que você possui:

• 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 para sua conta, sendo que o usuário RAM associado deve ter as permissões necessárias

Obtenha a URL da API HTTP

1. Faça logon 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 sua instância do Prometheus está localizada.

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

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

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

   • Utilize a URL interna se sua instância do Grafana ou aplicação estiver executando na mesma região do 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 do Grafana autogerenciada

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, digite 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 está 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 utilizam 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 labels e metadados de séries

• Criar um dashboard do Grafana -- Crie dashboards utilizando a fonte de dados conectada