Pengawasan Kinerja dengan Indikator Level Layanan

Indikator Level Layanan (SLI) dan Objektif Level Layanan (SLO) adalah komponen penting dalam pengawasan dan pemeliharaan kinerja dan keandalan NQRust-Identity di lingkungan produksi.

Buku Google Site Reliability Engineering mendefinisikan ini sebagai berikut:

• Sebuah Indikator Level Layanan (SLI) adalah ukuran kuantitatif yang telah didefinisikan dengan hati-hati dari beberapa aspek tingkat layanan yang diberikan.
• Sebuah Objektif Level Layanan (SLO) adalah nilai target atau rentang nilai untuk tingkat layanan yang diukur oleh SLI.

Dengan setuju pada hal tersebut bersama stakeholder dan melacaknya, pemilik layanan dapat memastikan bahwa deployment diatur sedemikian rupa sehingga sesuai dengan harapan pengguna dan mereka tidak berlebih atau kurang memberikan pada layanan yang mereka berikan.

Prasyarat

• Metrik harus diaktifkan untuk NQRust-Identity, dan opsi http-metrics-slos harus diatur ke latency untuk diukur untuk SLO yang didefinisikan di bawah. Ikuti panduan Mendapatkan wawasan dengan metrik untuk detail lebih lanjut.
• Sebuah sistem pengawasan yang mengumpulkan metrik. Paragraf berikut mengasumsikan penggunaan Prometheus atau sistem serupa yang mendukung bahasa query PromQL.

Definisi layanan yang diberikan

Definisi layanan berikut digunakan dalam langkah berikut untuk mengidentifikasi SLI dan SLO yang sesuai. Hal ini harus menangkap perilaku yang diamati oleh penggunaannya.

Sebagai pengguna NQRust-Identity,

• Saya ingin dapat masuk log,
• menyegarkan token saya dan
• keluar log,

sehingga saya dapat menggunakan aplikasi yang menggunakan NQRust-Identity untuk otentikasi.

Definisi SLI dan SLO

Berikut ini memberikan contoh SLI dan SLO berdasarkan deskripsi layanan di atas dan metrik yang tersedia di NQRust-Identity.

• Nilai target SLO ini adalah contoh dan harus disesuaikan dengan kasus penggunaan dan deployment Anda.

Query PromQL

Ini adalah contoh query yang dibuat di lingkungan Kubernetes dan digunakan dengan Prometheus sebagai alat pengawas. Mereka disediakan sebagai blueprint, dan Anda perlu menyesuaikan mereka untuk runtime atau lingkungan pengawasan yang berbeda.

Ketersediaan

Metrik ini akan memiliki nilai setidaknya satu jika instance NQRust-Identity tersedia dan menanggapi permintaan scrape Prometheus, dan 0 jika layanan mati atau tidak dapat dijangkau.

Kemudian gunakan alat seperti Grafana untuk menampilkan rentang waktu 30 hari dan biarkan itu menghitung rata-rata metrik dalam jendela waktu itu.

count_over_time(
  sum (up{
    container="keycloak", 
    namespace="$namespace"
  } > 0)[30d:15s]
) 
/
count_over_time(vector(1)[30d:15s]) 

1. Saring dengan tag tambahan untuk mengidentifikasi node NQRust-Identity
2. Hitung semua data point dalam rentang dan interval yang diberikan saat setidaknya satu node NQRust-Identity tersedia
3. Bagi dengan jumlah semua data point dalam rentang dan interval yang sama

Latency permintaan otentikasi

Query Prometheus ini menghitung persentase permintaan otentikasi yang selesai dalam 0,25 detik relatif kepada semua permintaan otentikasi untuk endpoint NQRust-Identity tertentu, menargetkan namespace dan pod tertentu, dalam 30 hari terakhir.

Contoh ini memerlukan konfigurasi NQRust-Identity http-metrics-slos untuk berisi nilai 250 yang menunjukkan bahwa bucket untuk permintaan lebih cepat dan lebih lambat dari 250 md harus direkam. Mengatur http-metrics-histograms-enabled ke true akan menangkap bucket tambahan yang dapat membantu dengan pemecahan masalah kinerja.

sum(
  rate(
    http_server_requests_seconds_bucket{
      uri=~"/realms/{realm}/protocol/{protocol}.*|/realms/{realm}/login-actions.*", 
      le="0.25", 
      container="keycloak", 
      namespace="$namespace"}
    [30d] 
  )
) without (le,uri,status,outcome,method,pod,instance) 
/
sum(
  rate(
    http_server_requests_seconds_count{
      uri=~"/realms/{realm}/protocol/{protocol}.*|/realms/{realm}/login-actions.*", 
      container="keycloak",
      namespace="$namespace"}
    [30d] 
  )
) without (le,uri,status,outcome,method,pod,instance) 

1. URL terkait dengan masuk log
2. Waktu respons seperti yang didefinisikan oleh SLO
3. Saring dengan tag tambahan untuk mengidentifikasi node NQRust-Identity
4. Rentang waktu seperti yang ditentukan oleh SLO
5. Abaikan sebanyak mungkin label untuk membuat satu sum

Kesalahan permintaan otentikasi

Query Prometheus ini menghitung persentase permintaan otentikasi yang mengembalikan kesalahan sisi server untuk semua permintaan otentikasi, menargetkan namespace tertentu, dalam 30 hari terakhir.

sum(
  rate(
    http_server_requests_seconds_count{
      uri=~"/realms/{realm}/protocol/{protocol}.*|/realms/{realm}/login-actions.*", 
      outcome="SERVER_ERROR", 
      container="keycloak", 
      namespace="$namespace"}
    [30d] 
  )
) without (le,uri,status,outcome,method,pod,instance) 
/
sum(
  rate(
    http_server_requests_seconds_count{
      uri=~"/realms/{realm}/protocol/{protocol}.*|/realms/{realm}/login-actions.*", 
      container="keycloak", 
      namespace="$namespace"}
    [30d] 
  )
) without (le,uri,status,outcome,method,pod,instance) 

1. URL terkait dengan masuk log
2. Saring untuk semua permintaan yang merespon dengan kesalahan server (status HTTP 5xx)
3. Saring dengan tag tambahan untuk mengidentifikasi node NQRust-Identity
4. Rentang waktu seperti yang ditentukan oleh SLO
5. Abaikan sebanyak mungkin label untuk membuat satu sum

Bacaan lebih lanjut

• Google SRE Book on Service Level Objectives (opens in a new tab)
• Prometheus PromQL Basics (opens in a new tab)