AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Foydalanish/Kuzatiluvchanlik

Kuzatiluvchanlik

v1.1.x · yangilandi 2026-07-07

AiHummer kuzatilishi mavjud ikki sirt: darvoza xizmat qiladi Prometey GET /metrics asoslarni o‘rganish uchun foydalanishingiz mumkin bo‘lgan endpoint, va u ixtiyoriy ravishda telemetriyani OTLP orqali yuborish Siz sozlaydigan OpenTelemetry tuguniga. Qazib olish /metrics asosiy monitoring uchun; izlar va boy metrikalar uchun AiHummer-ni OTLP kollektoriga yo’naltiring va ma’lumotlarni o’rnatilgan Grafana dashboardlari bilan vizualizatsiya qiling.

[!NOTE] pprof (/debug/pprof) hisoblanadi emas oshkor qilindi.

Prometey /metrics oxir nuqta

GET /metrics Qo’shimcha sozlamalarsiz Prometheus tekst-formatidagi metrikalarni taqdim etadi. Faqat sezgir bo’lmagan o’lchovlar ochiq — qurilish ma’lumotlari, jarayon ishlash vaqti va ish vaqti, DB ulanish hovuzining holati va tayyorgarlik o’lchovi; hech qanday ijarachi ma’lumotlari, hech qanday maxfiy ma’lumotlar, so’rov-bo’yicha yorliqlar yo’q. Izlar va batafsil metrikalar uchun OTLP push-dan foydalaning.

OTLP surish

Telemetriya yoqish uchun bitta o‘zgaruvchini sozlang:

# gateway.env — export telemetry to your OTLP collector
AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317

Bilan AIHUMMER_OTEL_ENDPOINT toʻplam, eshik telemetryni shu toʻplovchiga yuboradi. U yerdan, uni backendingizga (Tempo, metrikalar ombori, loglar) va Grafanaga yoʻnaltiring.

Panika va xatolarni qayta ishlash

Xatolar haqidagi hisobotlar hech qayerga tashqariga yuborilmaydi: shlyuzda tashqi xato kuzatuvchisining mijozi ham, tashqi DSN ham yo‘q — sizning xatolaringiz haqidagi ma’lumotlar konturingizdan chiqmaydi.

Shu bilan birga panikalarga chidamlilik to‘liq:

  • HTTP ishlovchisidagi panika oddiy xato javobiga aylanadi (AIH-… konverti bilan 500) — jarayon qulamaydi va qolgan so‘rovlarga xizmat ko‘rsatishda davom etadi;
  • fon gorutinasidagi panika ham ushlab qolinadi va shlyuzni qulatmaydi.

Ikkala holat ham tuzilmali jurnalga tushadi — ularni Jurnallar sahifasida (quyida) yoki journalctl orqali ko‘ring.

Admin UI da jonli loglar

Admin UIning Jurnallar sahifa gateway jurnalining jonli quyruqidir: yangi qatorlar har bir necha soniyada avtomatik ravishda kiradi, pastda bo’lganingizda avtomatik aylantirish bilan. Asboblar panelida chiziq qidiruvi va bir daraja filtri (hammasi / xatolar / ogohlantirishlar / ma’lumot / debugging). Bir nechta boshqa sahifalar (Dashboard, Sessiyalar, Kanallar) ham avtomatik ravishda yangilanadi, va uzun ro‘yxatlar (audit, o‘zgarishlar, bildirishnomalar va hokazo) sahifa-sahifa “Ko‘proq ko‘rsatish” tugmasi bilan yuklanadi.

Har bir xizmatning to‘liq jurnallari hali ham systemdda mavjud — aihummer logs [unit] yoki journalctl -u aihummer-gateway.

Grafana boshqaruv panellari

Tayyor Grafana boshqaruv panellari chiqarilish bilan birga keladi. Ularni Grafana tizimingizga import qilib, panellarni boshidan yaratmasdan operatsion ko‘rinishlarni oling.

Nimani tomosha qilish

Bu tizim sog‘lom ekanligini va burilishlar oqayotganini aytadigan signalardir:

Signal Nega bu muhim
Aylanish kechikishi Agent navbatlarining oxirigacha javob berish qobiliyati
Xato darajasi Muvaffaqiyatsiz burilishlar / so‘rovlar — muammolarning birinchi belgisi
Yetkazib berish tartiblari Javoblar haqiqatan ham kanallarga yetib bormoqdami
Kutilayotgan yetkazib berishlar Yetkazilmagan javoblarning ortiqcha zaxirasi; barqaror o’sish demak yetkazib berish to’xtab qolgan

Uzoq muddatli o‘sish kutayotgan yoki takror-takror muvaffaqiyatsiz bo‘lgan yetkazib berishlar bu etkazib berish ortiqcha bo‘layotganining eng aniq erta ogohlantirishidir — uni rollout va hodisalar paytida kuzating.

Tizim tugun nuqtalari

OTLP bilan birga, gateway probelar, soat va mijoz diagnostikasi uchun foydali bo‘lgan kichik HTTP endpointlarini ochadi:

Usul Tugun nuqtasi Maqsad
GET /metrics Prometheus metrikalari (yaratish, ish vaqti, DB hovuzi, tayyorlik)
GET /healthz Jonlilik + versiya
GET /readyz Tayyorlik (Postgres-ni tekshiradi; past bo’lsa 503)
GET /v1/ping Yengil vazndagi yetib borish tekshiruvi
GET /v1/time Server vaqti
POST /v1/client-log Mijoz tomonidagi log hodisalarini qabul qilish

Sog’liq va tayyorgarlik tekshiruvlari batafsil tarzda quyida ko’rib chiqilgan systemd va salomatlik tekshiruvlari.

Keyingi qayerga