Бақыланушылық (Observability)

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

AiHummer бақыланушылық моделі — **тек OTLP push**. Шлюз телеметрияны сіз баптаған OpenTelemetry соңғы нүктесіне экспорттайды — ол scrape соңғы нүктесін **ұсынбайды**. Деректерді өз коллекторыңызға жіберіп, жинақталған Grafana бақылау тақталарымен визуализациялаңыз. > [!WARNING] > Prometheus `/metrics` соңғы нүктесі де, pprof (`/debug/pprof`) де **жоқ**. > Бақыланушылық — тек OTLP push: шлюзге қарсы scrape тапсырмасын баптамаңыз; > оның орнына AiHummer-ді өз OTLP коллекторыңызға бағыттаңыз. ## OTLP push Телеметрияны қосу үшін жалғыз айнымалыны орнатыңыз: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` `AIHUMMER_OTEL_ENDPOINT` орнатылған кезде шлюз телеметрияны сол коллекторға жібереді. Одан әрі оны өз backend-іңізге (Tempo, метрика қоймасы, логтар) және Grafana-ға бағыттаңыз. ## Админкадағы тірі логтар Админканың **«Логтар»** беті — gateway журналының тірі құйрығы: жаңа жолдар бірнеше секунд сайын автоматты түрде тартылып тұрады, төменгі жиекте автопрокрутка бар. Тулбарда — **жолдар бойынша іздеу** және **деңгей сүзгісі** (барлығы / қателер / ескертулер / инфо / debug). Басқа бірқатар беттер (Дашборд, Сессиялар, Арналар) де автоматты түрде жаңарады, ал ұзын тізімдер (аудит, өзгерістер, хабарландырулар т.б.) «Тағы көрсету» түймесімен беттеп жүктеледі. Барлық қызметтердің толық журналдары бұрынғысынша systemd-де тұрады — `aihummer logs [unit]` немесе `journalctl -u aihummer-gateway`. ## Grafana бақылау тақталары Релизбен бірге дайын Grafana бақылау тақталары жеткізіледі. Панельдерді нөлден құрмай-ақ операциялық көріністерді алу үшін оларды өз Grafana данаңызға импорттаңыз. ## Нені бақылау керек Бұл — жүйенің сау екенін және хабарласулардың (turn) ағып жатқанын көрсететін сигналдар: | Сигнал | Неліктен маңызды | |---|---| | **Хабарласу кідірісі** | Агент хабарласуларының ұштан-ұшқа жауап беруі | | **Қателер деңгейі** | Сәтсіз хабарласулар / сұраулар — ақаудың алғашқы белгісі | | **Жеткізу диспозициялары** | Жауаптар арналарға шынымен жетіп жатыр ма | | **Outbox / DLQ тереңдігі** | Жеткізілмеген хабарламалар кезегі; өсіп жатқан DLQ жеткізудің тұрып қалғанын білдіреді | Өсіп бара жатқан **outbox немесе өлі-хат-кезегінің (DLQ) тереңдігі** жеткізудің жинақталып жатқанының ең айқын ерте ескертуі — оны таратулар (rollout) мен инциденттер кезінде бақылаңыз. ## Жүйелік соңғы нүктелер OTLP-пен қатар шлюз зондтарға, сағаттарға және клиенттік диагностикаға пайдалы шағын HTTP соңғы нүктелерін ұсынады: | Әдіс | Соңғы нүкте | Мақсаты | |---|---|---| | `GET` | `/healthz` | Тіршілік + нұсқа | | `GET` | `/readyz` | Дайындық (Postgres-ті тексереді; жұмыс істемесе 503) | | `GET` | `/v1/ping` | Жеңіл қол жетімділік тексеруі | | `GET` | `/v1/time` | Сервер уақыты | | `POST` | `/v1/client-log` | Клиент жағындағы лог оқиғаларын қабылдау | Денсаулық пен дайындық зондтары [systemd және денсаулық тексерулері](/en/v1.0/operations/systemd-health) бөлімінде толық қарастырылады. ## Әрі қарай қайда - Зондтар мен өндіріске дейінгі тексеру тізімі: [systemd және денсаулық тексерулері](/en/v1.0/operations/systemd-health). - Жылжымалы жаңарту кезінде нені бақылау керек: [Жаңарту саясаты](/en/v1.0/operations/upgrade-policy).