Анаблюдара

AiHummer анаблюдара амоуп ҩ аҿыҵра: агейтуэй иаанарԥшуеит Prometheus GET /metrics эндпоинт, шәара ахадатәи аметрикақәа скрейп ҟазҵаша, насгьы, ахыԥхьаӡакны, шәыргылаз OpenTelemetry эндпоинт ахь OTLP ала телеметриа ишьҭыр алшоит. /metrics искрейп ҟаҵа ахадатәи мониторинг азы; атрейсқәеи еиҳа ирацәоу аметрикақәеи рзы AiHummer шәхатәы OTLP-коллектор ахь иарбала насгьы адырра бундлдоу Grafana дашбордқәа рыла ишәырба.

[!NOTE] pprof (/debug/pprof) ааирԥшӡам.

Prometheus `/metrics` эндпоинт

GET /metrics Prometheus текст-форматла аметрикақәа аанарԥшуеит, даҽа аиҿкаара ада. Ааирԥшуп ахьшьаратә-акәымкәа гейджқәа мацара — билд иахьеи адырра, процесс аусуратә аамҭеи аруантайми, БД ахцпул аҭагылазаашьеи аазырхиара гейджи; аабонент дыррак, асекретқәа, ма аҭаку-зегьы-азы лейблқәа акгьы ыҟам. Атрейсқәеи еиҳа ирацәоу аметрикақәеи рзы OTLP push ишәхы.

OTLP push

Телеметриа ааҿарц акы вариабль ишьҭуп:

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

AIHUMMER_OTEL_ENDPOINT ишьҭзар, агейтуэй телеметриа убри коллектор ахь иршьҭуеит. Убрантә, шәхатәы бэкенд ахь (Tempo, аметрика хәархьара, алогқәа) насгьы Grafana ахь иаршьҭы.

Агхақәа рзы адырра (Bugsink / Sentry)

Агейтуэй иманы иануеит Sentry-протокол ала агхақәа рзы адырратә клиент — уи аусуеит хатәла-иргылоу Bugsink ала ма Sentry-иакәо дарбанзаалак DSN ала. DSN ишьҭны, апаникақәеи агхақәеи (аҿаԥхьатәи ашьаҿеи афоновтә воркерқәеи иреиҵаны) шәтрекер ахь ирышьҭуеит, акомпонент насгьы аинстанс рыла тегдоу:

# gateway.env — error reporting (Bugsink or any Sentry-compatible DSN)
AIHUMMER_SENTRY_DSN=https://<key>@<your-bugsink-or-sentry>/<project>
AIHUMMER_SENTRY_ENVIRONMENT=production   # optional; defaults to production

Ҩбагьы анашьамҭа — анашьамҭа-каталог анҭыҵхьоуп (Observability агәыԥ), убри аҟнытә шәылшоит урҭгьы web-админ UI аҟынтә ишьҭра; БД аҵакы env инаӡара имоуп. DSN шьҭымхаанӡа, адырра аанкылоуп.

Админ UI аҟны иҟоу алогқәа зхыуа

Админ UI «Логқәа» адаҟьа — агейтуэй ажурнал зхыуа: ҿыц аиҵақәа автоматла ирҭагалоуп бжьаки-бжьакны, насгьы шәыҟоу аҵыхәтәи аҭыԥ аҟны автоскролл ауеит. Атулбар аҟны — аиҵа-ԥшаара насгьы алевел-фильтр (зегьы / агхақәа / агәашәыгарақәа / ажәабжь / 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 аметрикақәа (билд, руантайм, БД пул, аазырхиара)
`GET`	`/healthz`	Аԥсра + аверсиа
`GET`	`/readyz`	Аазырхиара (Postgres агәаҭоит; 503 иланахар)
`GET`	`/v1/ping`	Имаҷу анеира агәаҭара
`GET`	`/v1/time`	Сервер аамҭа
`POST`	`/v1/client-log`	Клиент-ахьтә лог хҭысқәа рыларгара

Агәабзиареи аазырхиареи зондтә хадаран иарбоуп systemd насгьы агәабзиара агәаҭарақәа аҵаҟа.

Анаҩс аҿы

Зондтә насгьы апродукциа аԥхьатәи чеклист: systemd насгьы агәабзиара агәаҭарақәа.
Аиҭашьаны арҿыцраан иарбан уахәаԥшузеи: Арҿыцра аполитика.

Prometheus /metrics эндпоинт