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

Kimlik doğrulama

Managed Service for Prometheus, her biri farklı bir kimlik doğrulama yöntemi kullanan iki örnek sürümünü destekler.

Ön koşullar

Başlamadan önce aşağıdaki gereksinimlere sahip olduğunuzdan emin olun:

• Bağlı bir Prometheus örneği. Kurulum talimatları için bkz.:

  • Konteyner gözlemlenebilirliği

  • Alibaba Cloud hizmeti gözlemlenebilirliği

  • Ana bilgisayar gözlemlenebilirliği

• (Grafana için) Yönetici erişimine sahip, kendi yönetiminizdeki bir Grafana örneği

• (Prometheus V2 için) Hesabınız için bir AccessKey çifti; ilişkili RAM kullanıcısının gerekli izinlere sahip olması gerekir

HTTP API URL'sini alma

1. CloudMonitor konsoluna giriş yapın.

2. Sol gezinme bölmesinde Managed Service for Prometheus > Instances seçeneğini seçin.

3. Üst gezinme çubuğundan Prometheus örneğinizin bulunduğu bölgeyi seçin.

4. Prometheus örneğinizi bulun ve Actions sütunundaki Settings seçeneğine tıklayın.

5. Settings sekmesinde HTTP API URL'sini kopyalayın.

   • Grafana örneğiniz veya uygulamanız Alibaba Cloud dahili ağının dışında ise public URL'yi kullanın.

   • Grafana örneğiniz veya uygulamanız aynı Alibaba Cloud bölgesi içinde çalışıyorsa ve dahili uç noktalara erişebiliyorsa internal URL'yi kullanın.

6. (Yalnızca Prometheus V1) Bir kimlik doğrulama belirteci oluşturmak için Generate Token seçeneğine tıklayın. Bu belirteci daha sonra kullanmak üzere kaydedin.

Kendi yönetiminizdeki Grafana veri kaynağını yapılandırma

Grafana'daki veri kaynağını doğrulama

1. Grafana'da Dashboards menüsüne gidin ve New > New dashboard seçeneğine tıklayın.

2. + Add visualization seçeneğine tıklayın ve yapılandırdığınız veri kaynağını seçin.

3. Edit Panel sayfasında Query sekmesini açın. A bölümünde, Metrics alanına bir metrik adı girin (örneğin, arms_prometheus_target_interval_length_seconds_sum) ve gerekirse Label filters öğelerini yapılandırın.

4. Run queries seçeneğine tıklayın.

Grafikte metrik verileri görüntüleniyorsa veri kaynağı çalışıyor demektir. Grafik görünmüyorsa API URL'sinin veya belirtecin geçerli olup olmadığını ve veri kaynağında izleme verisi bulunup bulunmadığını kontrol edin. Daha fazla yardım için bkz. Sorun giderme.

HTTP API'yi programatik olarak sorgulama

Aşağıdaki örnekler anlık sorgular için /api/v1/query uç noktasını kullanır. Aralık sorguları (/api/v1/query_range), seri meta verileri ve diğer uç noktalar için Prometheus HTTP API referansına bakın.

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

Sorun giderme

İlgili konular

• Prometheus HTTP API referansı -- Aralık sorguları (/api/v1/query_range), etiket sorguları ve seri meta verileri dahil olmak üzere sorgu uç noktaları için tam API belgeleri

• Grafana panosu oluşturma -- Bağlı veri kaynağıyla panolar oluşturun