Lewati ke isi

Pengembangan Skrip / Objek Konektor DFF.CONN / Prometheus

Objek operasi Konektor Prometheus terutama menyediakan beberapa metode untuk mengoperasikan Prometheus.

Konektor ini terhubung ke Prometheus melalui protokol HTTP

Parameter DFF.CONN(...) adalah sebagai berikut:

Parameter Tipe Wajib / Nilai Default Deskripsi
connector_id str Wajib ID Konektor
timeout int/float 10 Waktu tunggu default permintaan HTTP untuk objek operasi saat ini, dalam detik

.query(...)

Parameter untuk mengirim permintaan HTTP ke Prometheus adalah sebagai berikut:

Parameter Tipe Wajib / Nilai Default Deskripsi
method str Wajib Metode permintaan, mis. GET, POST; juga dapat ditulis sebagai "GET /path"
path str None Jalur permintaan; jika dihilangkan, dipisahkan dari method
query dict None Parameter kueri URL
body dict None Isi permintaan JSON
timeout int/float None Waktu tunggu untuk permintaan ini; jika dihilangkan, menggunakan nilai default objek operasi
Contoh
1
2
3
4
5
6
result = prom.query('GET', '/api/v1/query_range', query={
  'query': 'up',
  'start': '2024-01-01T00:00:00Z',
  'end'  : '2024-01-02T00:00:00Z',
  'step' : '60s',
})

Ketika query berisi start dan end sekaligus, Konektor akan mencoba mengonversi keduanya menjadi waktu, mengurutkannya sesuai urutan waktu, lalu menghasilkannya sebagai string ISO 8601. Parameter lainnya diteruskan langsung ke Prometheus HTTP API.

Jika respons berupa JSON atau XML, objek hasil parsing akan dikembalikan; jika tidak, byte mentah akan dikembalikan; jika kode status HTTP lebih besar dari atau sama dengan 400, sebuah pengecualian akan dilemparkan.

Untuk informasi tentang Prometheus HTTP API, silakan lihat Dokumentasi resmi Prometheus / Querying / HTTP API