Cloud Monitor:Tambahkan sumber data Prometheus di Grafana

Grafana yang Dikelola Sendiri

Bagian ini menggunakan contoh Grafana v10.x. Untuk informasi tentang penambahan sumber data di versi lain, lihat dokumentasi resmi Grafana.

1. Konfigurasikan sumber data Grafana.

   1. Masuk ke Grafana yang Anda kelola sendiri sebagai administrator.

   2. Di pojok kiri atas halaman, klik ikon menu dan pilih Administration > Data sources.

   3. Klik + Add new data source dan pilih Prometheus sebagai jenis sumber data.

   4. Di tab Settings, masukkan nama kustom di bidang Name. Di bidang Prometheus server URL, tempel URL API HTTP yang Anda peroleh di Langkah 1.

   5. Konfigurasikan otentikasi.

      Instans V1 (opsional)

      Klik + Add header. Di bagian Custom HTTP Headers, klik +Add header, atur Header menjadi Authorization, dan atur Value ke token otentikasi yang diperoleh di Langkah 1.

      Instans V2

      Aktifkan Basic auth. Atur User ke ID AccessKey Anda dan Password ke rahasia AccessKey Anda.

2. Di bagian bawah halaman, klik Save & Test.

3. Kueri metrik Prometheus.

   1. Masuk ke sistem Grafana Anda.

   2. Di pojok kiri atas halaman, klik ikon menu lalu klik Dashboards di panel navigasi kiri.

   3. Di halaman Dashboards, klik New di pojok kanan atas, lalu klik New dashboard di menu drop-down.

   4. Klik + Add visualization. Di halaman Select data source, pilih sumber data yang telah Anda buat.

   5. Di halaman Edit Panel, buka tab Query. Di bagian A, masukkan nama dan nilai metrik di bidang Metrics dan Label filters, lalu klik Run queries.

      Jika grafik untuk metrik tersebut muncul, berarti pengaturan berhasil. Jika tidak, pastikan URL API dan token sudah benar serta sumber data berisi data pemantauan Prometheus.

      

Managed Service for Grafana

Managed Service for Grafana menyediakan integrasi satu-klik untuk sumber data Prometheus dan dasbor.

1. Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Managed Service for Grafana > Workspace Management, lalu klik ID ruang kerja Anda.

2. Di halaman Workspace Information, temukan bagian Cloud Service Integration dan klik Prometheus Monitoring Service. Lalu, temukan instans Anda dan klik Integrate.

3. Di kotak dialog yang muncul, klik OK.

   Jika Anda mengintegrasikan instans Prometheus V2, Anda harus memasukkan ID AccessKey untuk sumber data tersebut.

4. Setelah sinkronisasi selesai, klik ikon folder di sebelah kanan.

5. Di Grafana, pada tab Dashboards, klik nama dasbor untuk melihat dasbor default bawaan untuk pemantauan aplikasi.

6. Di pojok kiri atas halaman, klik ikon menu dan pilih Administration > Data sources untuk melihat sumber data pemantauan aplikasi yang telah ditambahkan.

7. Kueri metrik Prometheus.

   1. Masuk ke sistem Grafana Anda.

   2. Di pojok kiri atas halaman, klik ikon menu lalu klik Dashboards di panel navigasi kiri.

   3. Di halaman Dashboards, klik New di pojok kanan atas, lalu klik New dashboard di menu drop-down.

   4. Klik + Add visualization. Di halaman Select data source, pilih sumber data yang telah Anda buat.

   5. Di halaman Edit Panel, buka tab Query. Di bagian A, masukkan nama dan nilai metrik di bidang Metrics dan Label filters, lalu klik Run queries.

      Jika grafik untuk metrik tersebut muncul, berarti pengaturan berhasil. Jika tidak, pastikan URL API dan token sudah benar serta sumber data berisi data pemantauan Prometheus.

      

Instans V1

GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: {Token}
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}

Instans V2

GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: Basic <base64Encode(<AccessKey ID:AccessKey secret>)>
{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"
}

Anda juga dapat menggunakan Python dan library requests untuk memanggil API. Contoh berikut menunjukkan cara melakukan kueri data pemantauan Prometheus dengan otentikasi V2 Basic Auth dan V1 Token.

Instans V2 (Basic Auth)

import base64
import requests

access_key_id = "<AccessKey ID>"
access_key_secret = "<AccessKey secret>"
http_api_url = "{http_api_url}"

credentials = f"{access_key_id}:{access_key_secret}"
auth_header = base64.b64encode(credentials.encode()).decode()

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": f"Basic {auth_header}"
}

response = requests.get(
    f"{http_api_url}/api/v1/query",
    params={"query": "up"},
    headers=headers
)

result = response.json()
print(result["status"])
print(result["data"]["result"])

Instans V1 (Token)

import requests

http_api_url = "{http_api_url}"
token = "{token}"

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": token
}

response = requests.get(
    f"{http_api_url}/api/v1/query",
    params={"query": "up"},
    headers=headers
)

result = response.json()
print(result["status"])
print(result["data"]["result"])