Müşahidə qabiliyyəti (Observability)

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

AiHummer-in müşahidə qabiliyyəti modeli **yalnız OTLP push-dur**. Gateway telemetriyanı sizin konfiqurasiya etdiyiniz OpenTelemetry son nöqtəsinə ixrac edir — o, skreyp (scrape) son nöqtəsi **təqdim etmir**. Verilənləri öz kollektorunuza göndərin və onları komplektə daxil olan Grafana panelləri ilə vizuallaşdırın. > [!WARNING] > **Prometheus `/metrics` son nöqtəsi yoxdur və pprof yoxdur** (`/debug/pprof`). > Müşahidə qabiliyyəti yalnız OTLP push-dur — gateway-ə qarşı skreyp işi > konfiqurasiya etməyin; əvəzində AiHummer-i öz OTLP kollektorunuza yönəldin. ## OTLP push Telemetriyanı açmaq üçün tək bir dəyişən təyin edin: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` `AIHUMMER_OTEL_ENDPOINT` təyin edildikdə, gateway telemetriyanı həmin kollektora göndərir. Oradan onu öz arxa hissənizə (Tempo, metrik anbarı, loglar) və Grafana-ya yönləndirin. ## Admin UI-də canlı loglar Admin UI-nin **«Loglar»** səhifəsi gateway jurnalının canlı quyruğudur: yeni sətirlər hər bir neçə saniyədən bir avtomatik çəkilir, aşağı kənarda avto-sürüşdürmə ilə. Alət panelində — **sətirlər üzrə axtarış** və **səviyyə üzrə filtr** (hamısı / xətalar / xəbərdarlıqlar / info / debug). Bir sıra digər səhifələr (Panel, Sessiyalar, Kanallar) də avtomatik yenilənir, uzun siyahılar (audit, dəyişikliklər, bildirişlər və s.) isə «Daha çox göstər» düyməsi ilə səhifə-səhifə yüklənir. Bütün servislərin tam jurnalları əvvəlki kimi systemd-də yaşayır — `aihummer logs [unit]` və ya `journalctl -u aihummer-gateway`. ## Grafana panelləri Hazır Grafana panelləri buraxılışla birlikdə gəlir. Panelləri sıfırdan qurmadan əməliyyat görünüşlərini əldə etmək üçün onları öz Grafana nümunənizə idxal edin. ## Nəyi izləmək lazımdır Bunlar sistemin sağlam olduğunu və növbələrin axdığını sizə bildirən siqnallardır: | Siqnal | Niyə əhəmiyyət daşıyır | |---|---| | **Növbə gecikməsi** | Agent növbələrinin uçdan-uca cavabdehliyi | | **Xəta dərəcəsi** | Uğursuz növbələr / sorğular — problemin ilk əlaməti | | **Çatdırılma dispozisiyaları** | Cavabların həqiqətən kanallara çatıb-çatmadığı | | **Outbox / DLQ dərinliyi** | Çatdırılmamış mesajların ehtiyatı; böyüyən DLQ çatdırılmanın ilişdiyini bildirir | Yüksələn **outbox və ya ölü-məktub-növbəsi (DLQ) dərinliyi** çatdırılmanın yığıldığına dair ən aydın erkən xəbərdarlıqdır — onu yayımlamalar (rollout) və insidentlər zamanı izləyin. ## Sistem son nöqtələri OTLP ilə yanaşı, gateway zondlar, saatlar və müştəri diaqnostikası üçün faydalı kiçik HTTP son nöqtələri təqdim edir: | Metod | Son nöqtə | Məqsəd | |---|---|---| | `GET` | `/healthz` | Canlılıq + versiya | | `GET` | `/readyz` | Hazırlıq (Postgres-i yoxlayır; əgər işləmirsə 503) | | `GET` | `/v1/ping` | Yüngül əlçatanlıq yoxlaması | | `GET` | `/v1/time` | Server vaxtı | | `POST` | `/v1/client-log` | Müştəri tərəfli log hadisələrini qəbul edir | Sağlamlıq və hazırlıq zondları [systemd və sağlamlıq yoxlamaları](/en/v1.0/operations/systemd-health) altında ətraflı əhatə olunur. ## Sonra hara - Zondlar və istehsalata buraxılışdan əvvəlki yoxlama siyahısı: [systemd və sağlamlıq yoxlamaları](/en/v1.0/operations/systemd-health). - Yayımlama yeniləməsi zamanı nəyi izləmək lazımdır: [Yeniləmə siyasəti](/en/v1.0/operations/upgrade-policy).