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

Authentication

Managed Service for Prometheus supports two instance versions, each with a different authentication method.

Prerequisites

Before you begin, make sure that you have:

• A connected Prometheus instance. For setup instructions, see:

  • Container observability

  • Alibaba Cloud service observability

  • Host observability

• (For Grafana) A self-managed Grafana instance with administrator access

• (For Prometheus V2) An AccessKey pair for your account, and the associated RAM user must have the required permissions

Get the HTTP API URL

1. Log on to the CloudMonitor console.

2. In the left-side navigation pane, choose Managed Service for Prometheus > Instances.

3. In the top navigation bar, select the region where your Prometheus instance resides.

4. Find your Prometheus instance, and then click Settings in the Actions column.

5. On the Settings tab, copy the HTTP API URL.

   • Use the public URL if your Grafana instance or application is outside the Alibaba Cloud internal network.

   • Use the internal URL if your Grafana instance or application runs within the same Alibaba Cloud region and can access internal endpoints.

6. (Prometheus V1 only) Click Generate Token to create an authentication token. Save this token for later use.

Configure a self-managed Grafana data source

Configure authentication

Follow the steps for your Prometheus instance version.

Prometheus V1

If you generated a token, add it as a custom HTTP header:

1. In the Custom HTTP Headers section, click + Add header.

2. Set Header to Authorization.

3. Set Value to the authentication token.

Prometheus V2

1. Turn on Basic auth.

2. Set User to your AccessKey ID.

3. Set Password to your AccessKey secret.

Verify the data source in Grafana

1. In Grafana, go to Dashboards and click New > New dashboard.

2. Click + Add visualization and select the data source you configured.

3. On the Edit Panel page, open the Query tab. In section A, enter a metric name in the Metrics field (for example, arms_prometheus_target_interval_length_seconds_sum) and configure any Label filters as needed.

4. Click Run queries.

If a chart renders with metric data, the data source is working. If no chart appears, check whether the API URL or token is valid and whether the data source has monitoring data. For additional help, see Troubleshooting.

Query the HTTP API programmatically

The following examples use the /api/v1/query endpoint for instant queries. For range queries (/api/v1/query_range), series metadata, and other endpoints, see the Prometheus HTTP API reference.

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'

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'

{
    "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***"
                ]
            }
        ]
    }
}

Troubleshooting

Related topics

• Prometheus HTTP API reference -- Full API documentation for query endpoints including range queries (/api/v1/query_range), label queries, and series metadata

• Create a Grafana dashboard -- Build dashboards with the connected data source