AiHummer
Қазақша▾
КіруЖеке кабинет
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Пайдалану/Бақылануы

Бақылануы

v1.2.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 арқылы қараңыз.

Әкімші интерфейсінде тірі журналдар

Әкімші интерфейстері “Журналдар” бетті шлюз журналының тікелей тізбегі: жаңа жолдар әр бірнеше секунд сайын автоматты түрде тартылады, ал сіз төменде тұрған кезде автоматты айналдыру болады. Құралдар тақтасында сызықтық іздеу және бір деңгей сүзгісі (барлығы / қателіктер / ескертулер / ақпарат / ақауды түзету). Бірнеше басқа беттер (Басқару тақтасы, Сессиялар, Каналдар) де автоматты түрде жаңартылады, ал ұзын тізімдер (аудит, өзгерістер, хабарламалар және басқалар) бет-бет бойынша «Тағы көрсету» батырмасымен жүктеледі.

Әр қызметтің толық журналдары әлі де 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 және денсаулықты тексерулер.

Келесі қайда