Müşahidə edilə bilənlik

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

AiHummer müşahidə qabiliyyətinə malikdir **iki səth**: keçid xidməti göstərir **Prometey `GET /metrics`** əsasları üçün çəkmək üçün istifadə edə biləcəyiniz endpoint və bu istəyə görə **OTLP üzərindən telemetriyanı göndərmək** quraşdırdığınız OpenTelemetry son nöqtəsinə. Çıxarın `/metrics` əsas izləmə üçün; izlər və zəngin metrikalar üçün AiHummer-i OTLP toplayıcınıza yönləndirin və verilənləri daxil olan Grafana paneli ilə vizuallaşdırın. > [!NOTE] > pprof (`/debug/pprof`)dır **yox** açıq. ## Prometey `/metrics` son nöqtə `GET /metrics` əlavə quraşdırma olmadan Prometheus mətn formatlı metriklərini təqdim edir. Yalnız həssas olmayan göstəricilər açıqlanır — quruluş məlumatı, prosesin işləmə müddəti və işləmə vaxtı, DB bağlantı hovuzu vəziyyəti və hazırlıq göstəricisi; heç bir tenant məlumatı, heç bir sirr, heç bir sorğu üzrə etiket yoxdur. İzlər və zəngin metriklər üçün OTLP push istifadə edin. ## OTLP itələmək Telemetriyanı aktiv etmək üçün tək bir dəyişəni təyin edin: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` ilə `AIHUMMER_OTEL_ENDPOINT` dəst, qapı telemetriyanı həmin toplayıcıya göndərir. Oradan onu backend-inizə (Tempo, metriklər saxlayıcısı, loqlar) və Grafanaya yönləndirin. ## Panika və xətaların idarə edilməsi Xəta hesabatları **heç yerə kənara göndərilmir**: qapıda xarici xəta izləyicisinin müştərisi də, xarici DSN də yoxdur — sizin xətalarınız barədə məlumatlar perimetrinizdən kənara çıxmır. Panikalara qarşı davamlılıq isə tamdır: - HTTP emalçısındakı panika adi xəta cavabına çevrilir (`AIH-…` zərfi ilə 500) — proses dayanmır və qalan sorğulara xidmət göstərməyə davam edir; - fon qorutinindəki panika da tutulur və qapını yıxmır. Hər iki hal strukturlaşdırılmış jurnala düşür — onları **"Jurnallar"** səhifəsində (aşağıda) və ya `journalctl` vasitəsilə oxuyun. ## Admin UI-də canlı qeydlər Admin interfeysinin **"Jurnallar"** səhifə keçid jurnalının canlı izləməsidir: hər bir neçə saniyədən bir yeni sətirlər avtomatik olaraq yüklənir və siz səhifənin altında olduğunuz zaman avtomatik olaraq aşağı sürüşdürülür. Alətlər panelində bir **xətt üzrə axtarış** və bir **səviyyə filtri** (bütün / səhvlər / xəbərdarlıqlar / məlumat / səhvlər). Bir neçə digər səhifə (Dashboard, Sessiyalar, Kanallar) da avtomatik yenilənir və uzun siyahılar (audit, dəyişikliklər, bildirişlər və s.) səhifə-səhifə "Daha çox göstər" düyməsi ilə yüklənir. Hər bir xidmətin tam qeydləri hələ də systemd-də yaşayır — `aihummer logs [unit]` və ya `journalctl -u aihummer-gateway`. ## Grafana paneli Hazır Grafana tablosları buraxılışla birlikdə gəlir. Onları Grafana nümunənizə idxal edin ki, panelləri sıfırdan qurmaq məcburiyyətində qalmadan əməliyyat baxışlarını əldə edəsiniz. ## Nəyə baxmalı Bunlar sistemin sağlam olduğunu və axınların işlədiyini sizə xəbər verən siqnallardır: | Siqnal | Niyə önəmlidir | |---|---| | **Dönüş gecikməsi** | Agent çevrilərinin başdan sona qədər cavabvericiliyi | | **Səhv nisbəti** | Uğursuz dönmələr / sorğular — problemin ilk əlaməti | | **Çatdırılma tənzimləmələri** | Cavabların həqiqətən kanallara çatıb-çatmadığı | | **Gözləyən çatdırılmalar** | Çatdırılmayan cavablar üzrə yığıntı; davamlı artım çatdırılmanın dayandığını göstərir | Davamlı artım **gözləyən və ya dəfələrlə uğursuz olmuş çatdırılmalar** çatdırılmanın yığılmağa başladığının ən aydın erkən xəbərdarlığıdır — onu yayım və hadisələr zamanı izləyin. ## Sistem son nöqtələri OTLP ilə yanaşı, keçid probe-lar, saatlar və müştəri diaqnostikası üçün faydalı kiçik HTTP son nöqtələrini təqdim edir: | Metod | Son nöqtə | Məqsəd | |---|---|---| | `GET` | `/metrics` | Prometheus metrikaları (tikinti, işləmə vaxtı, DB hovuzu, hazır olma) | | `GET` | `/healthz` | Canlılıq + versiya | | `GET` | `/readyz` | Hazırlıq (Postgres-i yoxlayır; işləmirsə 503) | | `GET` | `/v1/ping` | Yüngül əlçatımlılıq yoxlaması | | `GET` | `/v1/time` | Server vaxtı | | `POST` | `/v1/client-log` | Müştəri tərəfi qeyd hadisələrini daxil edin | Sağlamlıq və hazırlıq sondaları ətraflı şəkildə aşağıda izah olunur [systemd və sağlamlıq yoxlamaları](/az/v1.0/operations/systemd-health). ## Növbəti haradır - Prob və istehsal uçuş öncəsi yoxlama siyahısı: [systemd və sağlamlıq yoxlamaları](/az/v1.0/operations/systemd-health). - Rolling yeniləmə zamanı nə izləməli: [Yeniləmə siyasəti](/az/v1.0/operations/upgrade-policy).