Application Real-Time Monitoring Service:Akses data pemantauan Prometheus melalui URL API HTTP

Otentikasi

Managed Service for Prometheus mendukung dua versi instans, masing-masing dengan metode otentikasi berbeda.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Instans Prometheus yang terhubung. Untuk petunjuk penyiapan, lihat:

  • Observabilitas kontainer

  • Observabilitas layanan Alibaba Cloud

  • Observabilitas host

• (Untuk Grafana) Instans Grafana yang dikelola sendiri dengan akses administrator

• (Untuk Prometheus V2) Pasangan Kunci Akses untuk akun Anda, dan Pengguna RAM terkait harus memiliki izin yang diperlukan

Dapatkan URL API HTTP

1. Masuk ke Konsol CloudMonitor.

2. Di panel navigasi sebelah kiri, pilih Managed Service for Prometheus > Instances.

3. Di bilah navigasi atas, pilih wilayah tempat instans Prometheus Anda berada.

4. Temukan instans Prometheus Anda, lalu klik Settings di kolom Actions.

5. Di tab Settings, salin URL API HTTP.

   • Gunakan URL publik jika instans Grafana atau aplikasi Anda berada di luar jaringan internal Alibaba Cloud.

   • Gunakan URL internal jika instans Grafana atau aplikasi Anda berjalan di wilayah Alibaba Cloud yang sama dan dapat mengakses titik akhir internal.

6. (Hanya untuk Prometheus V1) Klik Generate Token untuk membuat token otentikasi. Simpan token ini untuk digunakan nanti.

Konfigurasi sumber data Grafana yang dikelola sendiri

Konfigurasi otentikasi

Ikuti langkah-langkah berikut sesuai versi instans Prometheus Anda.

Prometheus V1

Jika Anda telah menghasilkan token, tambahkan sebagai Header HTTP kustom:

1. Di bagian Custom HTTP Headers, klik + Add header.

2. Atur Header menjadi Authorization.

3. Atur Value menjadi token otentikasi.

Prometheus V2

1. Aktifkan Basic auth.

2. Atur User menjadi ID AccessKey Anda.

3. Atur Password menjadi Rahasia AccessKey Anda.

Verifikasi sumber data di Grafana

1. Di Grafana, buka Dashboards dan klik New > New dashboard.

2. Klik + Add visualization dan pilih sumber data yang telah Anda konfigurasi.

3. Di halaman Edit Panel, buka tab Query. Di bagian A, masukkan nama metrik di bidang Metrics (misalnya, arms_prometheus_target_interval_length_seconds_sum) dan konfigurasikan Label filters sesuai kebutuhan.

4. Klik Run queries.

Jika grafik ditampilkan dengan data metrik, berarti sumber data berfungsi. Jika tidak ada grafik yang muncul, periksa apakah URL API atau token valid dan apakah sumber data memiliki data pemantauan. Untuk bantuan tambahan, lihat Pemecahan Masalah.

Kueri API HTTP secara terprogram

Contoh berikut menggunakan titik akhir /api/v1/query untuk kueri instan. Untuk kueri rentang (/api/v1/query_range), metadata deret waktu, dan titik akhir lainnya, lihat referensi API HTTP 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

# Dapatkan URL API HTTP dari konsol.
api_url = 'http://cn-hangzhou.arms.aliyuncs.com:9090/api/v1/prometheus/{token}/{user_id}/{cluster_id}/{region}'

# Gunakan ID AccessKey sebagai username dan Rahasia AccessKey sebagai password.
ak_id = 'your_access_key_id'
ak_secret = 'your_access_key_secret'

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

# Kueri rentang (1 jam terakhir).
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***"
                ]
            }
        ]
    }
}

Pemecahan Masalah

Topik Terkait

• Referensi API HTTP Prometheus — Dokumentasi lengkap API untuk titik akhir kueri termasuk kueri rentang (/api/v1/query_range), kueri label, dan metadata deret waktu

• Buat dasbor Grafana — Bangun dasbor dengan sumber data yang telah terhubung