Kuzatuvchanlik
AiHummer’ning kuzatuvchanlik modeli — faqat OTLP push. Gateway telemetriyani siz sozlagan OpenTelemetry nuqtasiga eksport qiladi — u scrape nuqtasini ochmaydi. Maʼlumotlarni kollektoringizga yuboring va uni birlashtirilgan Grafana boshqaruv panellari bilan vizuallashtiring.
[!WARNING] Prometheus
/metricsnuqtasi va pprof (/debug/pprof) yoʻq. Kuzatuvchanlik faqat OTLP push — gateway-ga qarshi scrape ishini sozlamang; AiHummer’ni oʻrniga OTLP kollektoringizga yoʻnaltiring.
OTLP push
Telemetriyani yoqish uchun bitta oʻzgaruvchini oʻrnating:
# gateway.env — export telemetry to your OTLP collector
AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317AIHUMMER_OTEL_ENDPOINT oʻrnatilganda, gateway telemetriyani oʻsha kollektorga
yuboradi. U yerdan uni backend’ingizga (Tempo, metrikalar doʻkoni, loglar) va
Grafana’ga yoʻnaltiring.
Admin UI’dagi jonli loglar
Admin UI’ning «Loglar» sahifasi — gateway jurnalining jonli dumi: yangi qatorlar har necha soniyada avtomatik tortib olinadi, pastki chetga avtoaylantirish bilan. Asboblar panelida — qatorlar boʻyicha qidiruv va daraja boʻyicha filtr (hammasi / xatolar / ogohlantirishlar / info / debug). Boshqa bir qator sahifalar (Boshqaruv paneli, Sessiyalar, Kanallar) ham avtomatik yangilanadi, uzun roʻyxatlar (audit, oʻzgarishlar, bildirishnomalar va h.k.) esa «Yana koʻrsatish» tugmasi bilan sahifama-sahifa yuklanadi.
Barcha xizmatlarning toʻliq jurnallari avvalgidek systemd’da yashaydi —
aihummer logs [unit] yoki journalctl -u aihummer-gateway.
Grafana boshqaruv panellari
Tayyor Grafana boshqaruv panellari reliz bilan birga yetkaziladi. Panellarni noldan qurmasdan operatsion koʻrinishlarni olish uchun ularni Grafana instansingizga import qiling.
Nimani kuzatish kerak
Bular tizim sogʻlom va turnlar oqayotganini bildiruvchi signallardir:
| Signal | Nima uchun muhim |
|---|---|
| Turn kechikishi | Agent turnlarining oxiridan-oxirigacha javob berishi |
| Xato darajasi | Muvaffaqiyatsiz turnlar / soʻrovlar — muammoning birinchi belgisi |
| Yetkazib berish dispozitsiyalari | Javoblar haqiqatan ham kanallarga yetib boryaptimi |
| Outbox / DLQ chuqurligi | Yetkazilmagan xabarlar zaxirasi; oʻsayotgan DLQ yetkazib berish tiqilib qolganini bildiradi |
Oʻsayotgan outbox yoki dead-letter-queue (DLQ) chuqurligi — yetkazib berish zaxiralanayotganining eng aniq erta ogohlantirishidir — uni rolloutlar va hodisalar paytida kuzating.
Tizim nuqtalari
OTLP bilan birga gateway probalar, soatlar va mijoz diagnostikasi uchun foydali kichik HTTP nuqtalarini ochadi:
| Usul | Nuqta | Maqsad |
|---|---|---|
GET |
/healthz |
Tiriklik + versiya |
GET |
/readyz |
Tayyorlik (Postgres’ni tekshiradi; oʻchgan boʻlsa 503) |
GET |
/v1/ping |
Yengil yetib borish tekshiruvi |
GET |
/v1/time |
Server vaqti |
POST |
/v1/client-log |
Mijoz tomonidagi log hodisalarini qabul qilish |
Salomatlik va tayyorlik probalari systemd va salomatlik tekshiruvlari ostida batafsil yoritilgan.
Keyingi qadam qayerda
- Probalar va ishlab chiqarish oldidan parvozdan oldingi roʻyxat: systemd va salomatlik tekshiruvlari.
- Bosqichma-bosqich yangilanish paytida nimani kuzatish: Yangilanish siyosati.