Байкоо мүмкүнчүлүгү

# gateway.env — телеметрияны OTLP коллекторуңузга экспорттоо
AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317

# gateway.env — ката отчёттору (Bugsink же каалаган Sentry-шайкеш DSN)
AIHUMMER_SENTRY_DSN=https://<key>@<сиздин-bugsink-же-sentry>/<project>
AIHUMMER_SENTRY_ENVIRONMENT=production   # милдеттүү эмес; демейкиси production

AiHummer'дин байкоо мүмкүнчүлүгүнүн **эки бети** бар: шлюз негизги көрсөткүчтөрдү scrape кылуу үчүн **Prometheus `GET /metrics`** соңун берет, жана каалаганда сиз конфигурациялаган OpenTelemetry соңуна **телеметрияны OTLP аркылуу түртө алат**. Негизги мониторинг үчүн `/metrics`'ти scrape кылыңыз; трейстер жана кеңири метрикалар үчүн AiHummer'ди өзүңүздүн OTLP коллекторуңузга багыттап, маалыматты камтылган Grafana дашбордору менен визуализациялаңыз. > [!NOTE] > pprof (`/debug/pprof`) ачылбайт. ## Prometheus `/metrics` соңу `GET /metrics` кошумча орнотуусуз Prometheus текст форматындагы метрикаларды берет. Сезимтал эмес көрсөткүчтөр гана ачылат — курулуш маалыматы, процесстин иштеп туруу убактысы жана рантайму, DB туташуу-пулунун абалы жана даярдык gauge'у; арендатор маалыматы, сырлар же ар бир сурам боюнча этикеткалар жок. Трейстер жана кеңири метрикалар үчүн OTLP push'ту колдонуңуз. ## OTLP push Телеметрияны иштетүү үчүн бир гана өзгөрмөнү орнотуңуз: ```ini # gateway.env — телеметрияны OTLP коллекторуңузга экспорттоо AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` `AIHUMMER_OTEL_ENDPOINT` орнотулганда, шлюз телеметрияны ошол коллекторго түртөт. Ал жерден аны өзүңүздүн backend'иңизге (Tempo, метрика сактагычы, логдор) жана Grafana'га багыттаңыз. ## Ката отчёттору (Bugsink / Sentry) Шлюз **Sentry-протоколундагы** ката отчёту клиентин жеткирет — ал self-hosted **Bugsink** менен же каалаган Sentry-шайкеш DSN менен иштейт. DSN'ди коюңуз, ошондо паникалар жана каталар (жүктөлүү фазасын жана фондук воркерлерди кошкондо) компонент жана инстанция этикеткалары менен трекериңизге билдирилет: ```ini # gateway.env — ката отчёттору (Bugsink же каалаган Sentry-шайкеш DSN) AIHUMMER_SENTRY_DSN=https://<key>@<сиздин-bugsink-же-sentry>/<project> AIHUMMER_SENTRY_ENVIRONMENT=production # милдеттүү эмес; демейкиси production ``` Эки тутка тең жөндөөлөр каталогунун жазуулары (**Observability** тобу), ошондуктан аларды веб-админкадан да коюуга болот; DB мааниси env'ден жогору турат. DSN коюлганга чейин отчёт өчүк. ## Админ UI'деги тирүү логдор Админ UI'дин **«Логдор»** барагы — шлюз журналынын тирүү «куйругу»: жаңы саптар ар бир бир нече секунд сайын автоматтык түрдө тартылат, сиз ылдый жактасаңыз автопрокрутка менен. Куралдар панелинде **сап боюнча издөө** жана **деңгээл боюнча чыпка** бар (баары / каталар / эскертүүлөр / info / debug). Дагы бир нече барак (Дашборд, Сессиялар, Каналдар) да автоматтык түрдө жаңыртылат, ал эми узун тизмелер (аудит, өзгөртүүлөр, билдирмелер ж.б.) «Дагы көрсөтүү» баскычы менен барактарга бөлүнүп жүктөлөт. Ар бир кызматтын толук журналдары дагы эле systemd'де жашайт — `aihummer logs [unit]` же `journalctl -u aihummer-gateway`. ## Grafana дашбордору Даяр Grafana дашбордору релиз менен бирге келет. Операциялык көрүнүштөрдү панелдерди нөлдөн куруусуз алуу үчүн аларды өзүңүздүн Grafana инстансыңызга импорттоңуз. ## Эмнени көзөмөлдөө керек Бул системанын ден соолугун жана кезектердин агып жатканын көрсөткөн сигналдар: | Сигнал | Эмне үчүн маанилүү | |---|---| | **Кезек кечигүүсү** | Агент кезектеринин баштан аяк жооп берүү ылдамдыгы | | **Ката деңгээли** | Ийгиликсиз кезектер / суроо-талаптар — кыйынчылыктын биринчи белгиси | | **Жеткирүү дислокациялары** | Жооптор каналдарга чындап жетип жатабы | | **Outbox / DLQ тереңдиги** | Жеткирилбеген билдирүүлөрдүн артта калышы; өсүп жаткан DLQ жеткирүү тыгылып калганын билдирет | Көтөрүлүп жаткан **outbox же dead-letter-queue (DLQ) тереңдиги** — жеткирүү артта калып жатканынын эң ачык эрте эскертүүсү — аны таркатуулардын жана инциденттердин учурунда көзөмөлдөңүз. ## Системалык соңдор OTLP менен катар, шлюз текшергичтер, сааттар жана клиент диагностикасы үчүн пайдалуу кичинекей HTTP соңдорун ачат: | Метод | Соңу | Максаты | |---|---|---| | `GET` | `/metrics` | Prometheus метрикалары (курулуш, рантайм, DB пулу, даярдык) | | `GET` | `/healthz` | Жашоо жөндөмдүүлүгү + версия | | `GET` | `/readyz` | Даярдык (Postgres'ти текшерет; иштебесе 503) | | `GET` | `/v1/ping` | Жеңил жетимдүүлүк текшерүүсү | | `GET` | `/v1/time` | Сервер убактысы | | `POST` | `/v1/client-log` | Клиент тарабындагы лог окуяларын кабыл алуу | Ден соолук жана даярдык текшергичтери [systemd жана ден соолук текшерүүлөрү](/ky/v1.0/operations/systemd-health) бөлүмүндө кеңири каралган. ## Кийинки кадам кайда - Текшергичтер жана өндүрүш алдындагы текшерүү тизмеси: [systemd жана ден соолук текшерүүлөрү](/ky/v1.0/operations/systemd-health). - Жылмакай жаңыртуу учурунда эмнени көзөмөлдөө керек: [Жаңыртуу саясаты](/ky/v1.0/operations/upgrade-policy).