Application Real-Time Monitoring Service:Access Prometheus monitoring data through HTTP API URLs

Autenticación

Managed Service for Prometheus admite dos versiones de instancia y cada una utiliza un método de autenticación distinto.

Requisitos previos

Antes de empezar, compruebe que cuenta con lo siguiente:

• Una instancia de Prometheus conectada. Para consultar las instrucciones de configuración, consulte:

  • Container observability

  • Alibaba Cloud service observability

  • Host observability

• (Para Grafana) Una instancia de Grafana autogestionada con acceso de administrador.

• (Para Prometheus V2) Un par de AccessKey para su cuenta, y el usuario de RAM asociado debe tener los permisos obligatorios.

Obtención de la URL de API HTTP

1. Inicie sesión en la consola de CloudMonitor.

2. En el panel de navegación izquierdo, elija Managed Service for Prometheus > Instances.

3. En la barra de navegación superior, seleccione la región donde reside su instancia de Prometheus.

4. Busque su instancia de Prometheus y haga clic en Settings dentro de la columna Actions.

5. En la pestaña Settings, copie la URL de API HTTP.

   • Utilice la URL pública si su instancia de Grafana o su aplicación se encuentra fuera de la red interna de Alibaba Cloud.

   • Utilice la URL interna si su instancia de Grafana o su aplicación se ejecuta dentro de la misma región de Alibaba Cloud y puede acceder a los endpoint internos.

6. (Solo para Prometheus V1) Haga clic en Generate Token para crear un token de autenticación. Guarde este token para usarlo más adelante.

Configuración de un origen de datos en Grafana autogestionado

Comprobación del origen de datos en Grafana

1. En Grafana, vaya a Dashboards y haga clic en New > New dashboard.

2. Haga clic en + Add visualization y seleccione el origen de datos que configuró.

3. En la página Edit Panel, abra la pestaña Query. En la sección A, introduzca el nombre de una métrica en el campo Metrics (por ejemplo, arms_prometheus_target_interval_length_seconds_sum) y configure los Label filters según sea necesario.

4. Haga clic en Run queries.

Si se muestra una gráfica con datos de métricas, el origen de datos funciona correctamente. Si no aparece ninguna gráfica, compruebe que la URL de la API o el token sean válidos y que el origen de datos contenga información de monitoreo. Para obtener más ayuda, consulte Solución de problemas.

Consulta programática de la API HTTP

Los siguientes ejemplos utilizan el endpoint /api/v1/query para consultas instantáneas. Para consultas por rango (/api/v1/query_range), metadatos de series y otros endpoint, consulte la referencia de la API HTTP de 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***"
                ]
            }
        ]
    }
}

Solución de problemas

Temas relacionados

• Referencia de la API HTTP de Prometheus: documentación completa de la API para los endpoint de consulta, incluidas las consultas por rango (/api/v1/query_range), las consultas de etiquetas y los metadatos de series.

• Crear un panel de Grafana: construya paneles con el origen de datos conectado.