AiHummer
Кыргызча▾
КирүүЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Пайдалануу/Көзөмөл кылуу жөндөмдүүлүгү

Көзөмөл кылуу жөндөмдүүлүгү

v1.0.x · жаңыланды 2026-07-07

AiHummer байкоого алуу жөндөмдүүлүгүнө ээ эки бет: эшик болуп кызмат кылат Прометей GET /metrics негиздер үчүн скрейптөлө турган процесс аягы, жана ал каалаган болсо OTLP аркылуу телеметрияны жиберүү Сиз конфигурациялай турган OpenTelemetry чекитине. Чогултуу /metrics негизги мониторинг үчүн; издер жана бай метрикалар үчүн AiHummerди OTLP чогултуучуңузга багыттап, маалыматты кошулган Grafana панелдери менен визуалдаңыз.

[!NOTE] pprof (/debug/pprof) болуп саналат эмес ачык калган.

Прометей /metrics чекит

GET /metrics кошумча орнотуу жок Prometheus текст форматындагы метрикаларды сунуштайт. Факты гана сезгич эмес өлчөгүчтөр көрүнөт — курулуш маалыматы, процесстин иштөө убактысы жана аткаруу убактысы, DB байланыш бассейнинин абалы жана даярдык өлчөгүчү; эч кандай ижарачы маалыматы, эч кандай сыр, эч кандай суроо боюнча белгилер жок. Трейстер жана кеңири метрикалар үчүн OTLP push колдонулат.

OTLP түртүү

Телеметрияны күйгүзүү үчүн бир гана өзгөрмөнү орнотуңуз:

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

менен AIHUMMER_OTEL_ENDPOINT орнотулганда, шлюз телеметрияны ошол жыйналгычка жиберет. Андан кийин аны арка өнүмүңүзгө (Tempo, метрикалар сактагычы, журналдар) жана Grafanaга жиберүү керек.

Паникаларды жана каталарды иштетүү

Каталар жөнүндө отчеттор эч жакка сыртка жөнөтүлбөйт: шлюзде каталардын тышкы трекеринин кардары да, тышкы DSN да жок — сиздин каталарыңыз жөнүндө маалыматтар контуруңуздан чыкпайт.

Мында паникаларга туруктуулук толук:

  • HTTP-иштеткичтеги паника кадимки ката жообуна айланат (AIH-… конверти менен 500) — процесс кулабайт жана калган суроо-талаптарды тейлөөнү улантат;
  • фондук горутинадагы паника да кармалат жана шлюзди кулатпайт.

Эки учур тең структураланган журналга түшөт — аларды “Логдор” барагында (төмөндө) же journalctl аркылуу караңыз.

Башкаруу интерфейсиндеги жандуу журналдар

Админ UIнын “Логдор” баракча шлюз журналынын түз агымы: жаңы саптар бир нече секунд сайын автоматтык түрдө тартылып келет, сиз ылдый жагында турганда автоворкс менен. Куралдар тилкеси бар сызык боюнча издөө жана бир деңгээл фильтри (бардыгы / каталар / эскертүүлөр / маалымат / отладка). Башка бир нече беттер (Башкы такта, Сеанслар, Каналдар) да автоматтык түрдө жаңыртылат, жана узун тизмелер (текшерүү, өзгөртүүлөр, билдирүүлөр ж.б.) баракча боюнча жүктөлүп, «Көбүрөөк көрсөтүү» баскычы аркылуу ачылат.

Ар бир кызматтын толук журналдары дагы деле systemdде сакталат — aihummer logs [unit] же journalctl -u aihummer-gateway.

Grafana панелдери

Даяр Grafana панелдери чыгарылыш менен келет. Операциялык көрүнүштөрдү нөлдөн баштап панелдерди түзбөй эле алуу үчүн аларды Grafana нускаңызга импорттоңуз.

Эмне көрүү

Бул системанын ден-соолукта экенин жана айланып жатканын көрсөтүүчү сигналдар:

Сигнал Эмне үчүн бул маанилүү
Айлануу кечигүүсү Агенттин жооп кайтаруусунун башынан аягына чейин жооп процессивдүүлүгү
Каталык көрсөткүчү Алмашуулардын / сурамдын үзгүлтүккө учрашы — көйгөйдүн биринчи белгиси
Жеткирүү тартиби Жооптор чындыгында каналдарга жетип жатабы
Жеткирүүлөр күтүп жатат Жеткирилбеген жооптордун кампасы; туруктуу өсүү жеткирүүнүн токтоп калышын билдирет

Убакыт бою туруктуу өсүш жараксыз же кайталап ийгиликсиз болбогон жеткирүүлөр бул жеткирүүнүн артка бараткандыгы тууралуу эң так эрте эскертүү болуп саналат — аны ишке киргизүү жана кырдаалдар учурунда көрүп туруңуз.

Система чекиттери

OTLP менен бирге, шлюз текшерүүлөр, сааттар жана кардар диагностикалары үчүн пайдалуу кичинекей HTTP чекиттерин көрсөтөт:

Метод Акыркы чек Максат
GET /metrics Prometheus метрикасы (курулуш, иш процессинде, МБ пулу, даярдык)
GET /healthz Жандуу төрөлүүлүк + версия
GET /readyz Дайындык (Postgres текшерет; эгер иштебесе 503)
GET /v1/ping Жөнгө салынган жеткиликтүүлүк текшериү
GET /v1/time Сервердин убактысы
POST /v1/client-log Кардар тараптагы журнал окуяларын кабыл алуу

Саламаттык жана даярдык анын чоо-жайы менен камтылган systemd жана саламаттыкты текшерүү.

Келерки кайда