Мушоҳидапазирӣ

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

Модели мушоҳидапазирии AiHummer **танҳо push-и OTLP** аст. Шлюз (gateway) телеметрияро ба як нуқтаи интиҳоии OpenTelemetry, ки шумо танзим мекунед, содир мекунад — он як нуқтаи интиҳоии scrape-ро намоиш **намедиҳад**. Додаҳоро ба коллектори худ фиристед ва бо панелҳои Grafana-и ҳамроҳбуда онро тасвир кунед. > [!WARNING] > Ягон **нуқтаи интиҳоии `/metrics`-и Prometheus ва ягон pprof** (`/debug/pprof`) вуҷуд надорад. > Мушоҳидапазирӣ танҳо push-и OTLP аст — ягон вазифаи scrape бар зидди > шлюз танзим накунед; ба ҷои он AiHummer-ро ба коллектори OTLP-и худ равона кунед. ## Push-и OTLP Барои фаъол кардани телеметрия як тағйирёбандаро танзим кунед: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` Бо танзими `AIHUMMER_OTEL_ENDPOINT`, шлюз телеметрияро ба он коллектор push мекунад. Аз он ҷо, онро ба бэкенди худ (Tempo, анбори метрикаҳо, қайдҳо) ва ба Grafana равона кунед. ## Логҳои зинда дар интерфейси маъмурӣ Саҳифаи **«Логҳо»**-и интерфейси маъмурӣ думчаи зиндаи журнали gateway аст: сатрҳои нав ҳар чанд сония ба таври худкор кашида мешаванд, бо ҳаракати худкор дар канори поён. Дар тулбар — **ҷустуҷӯ аз рӯи сатрҳо** ва **филтр аз рӯи сатҳ** (ҳама / хатоҳо / огоҳиҳо / инфо / debug). Як қатор саҳифаҳои дигар (Дашборд, Сессияҳо, Каналҳо) низ ба таври худкор нав мешаванд, ва рӯйхатҳои дароз (аудит, тағйирот, огоҳиномаҳо ва ғ.) бо тугмаи «Бештар нишон диҳед» саҳифа ба саҳифа бор мешаванд. Журналҳои пурраи ҳамаи хидматҳо мисли пештара дар systemd зиндагӣ мекунанд — `aihummer logs [unit]` ё `journalctl -u aihummer-gateway`. ## Панелҳои Grafana Панелҳои тайёри Grafana бо релиз меоянд. Онҳоро ба нусхаи Grafana-и худ ворид кунед, то намоҳои амалиётиро бе сохтани панелҳо аз сифр ба даст оред. ## Чиро назорат бояд кард Инҳо сигналҳое мебошанд, ки ба шумо мегӯянд, ки система солим аст ва даврҳо ҷорӣ мешаванд: | Сигнал | Чаро муҳим аст | |---|---| | **Таъхири давр** | Вокунишпазирии саросарии даврҳои агент | | **Сатҳи хато** | Даврҳо / дархостҳои ноком — аввалин нишонаи мушкилӣ | | **Ҳолатҳои расонидан** | Оё ҷавобҳо воқеан ба каналҳо мерасанд | | **Чуқурии Outbox / DLQ** | Анбори паёмҳои нарасонидашуда; DLQ-и афзоянда маънои онро дорад, ки расонидан банд шудааст | Афзоиши **чуқурии outbox ё навбати паёмҳои мурда (DLQ)** равшантарин ҳушдори барвақт аст, ки расонидан банд шуда истодааст — онро ҳангоми рӯлаутҳо ва ҳодисаҳо назорат кунед. ## Нуқтаҳои интиҳоии система Дар баробари OTLP, шлюз нуқтаҳои интиҳоии хурди HTTP-ро намоиш медиҳад, ки барои зондҳо, соатҳо ва ташхиси муштариён муфид мебошанд: | Метод | Нуқтаи интиҳоӣ | Мақсад | |---|---|---| | `GET` | `/healthz` | Зиндагӣ + версия | | `GET` | `/readyz` | Омодагӣ (Postgres-ро тафтиш мекунад; 503 агар хомӯш бошад) | | `GET` | `/v1/ping` | Санҷиши сабуки дастрасӣ | | `GET` | `/v1/time` | Вақти сервер | | `POST` | `/v1/client-log` | Ворид кардани ҳодисаҳои қайди тарафи муштарӣ | Зондҳои саломатӣ ва омодагӣ ба таври муфассал дар [systemd ва санҷишҳои саломатӣ](/tg/v1.0/operations/systemd-health) фаро гирифта шудаанд. ## Минбаъд ба куҷо - Зондҳо ва рӯйхати санҷиши пеш аз парвоз дар истеҳсолот: [systemd ва санҷишҳои саломатӣ](/tg/v1.0/operations/systemd-health). - Чиро ҳангоми навсозии тадриҷӣ назорат бояд кард: [Сиёсати навсозӣ](/tg/v1.0/operations/upgrade-policy).