Назіральнасць

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

Мадэль назіральнасці AiHummer — **толькі push праз OTLP**. Шлюз экспартуе тэлеметрыю на эндпойнт OpenTelemetry, які вы наладжваеце — ён **не** выстаўляе эндпойнт для скрэйпінгу. Адпраўляйце даныя на ваш калектар і візуалізуйце іх з дапамогай уваходзячых у камплект дашбордаў Grafana. > [!WARNING] > **Няма эндпойнта Prometheus `/metrics` і няма pprof** (`/debug/pprof`). > Назіральнасць — толькі push праз OTLP — не наладжвайце задачу скрэйпінгу супраць > шлюза; замест гэтага накіруйце AiHummer на ваш калектар OTLP. ## Push праз OTLP Задайце адну зменную, каб уключыць тэлеметрыю: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` З зададзеным `AIHUMMER_OTEL_ENDPOINT` шлюз адпраўляе тэлеметрыю на гэты калектар. Адтуль накіруйце яе на ваш бэкенд (Tempo, сховішча метрык, логі) і ў Grafana. ## Жывыя логі ў адмінскім UI Старонка **«Логі»** адмінкі — жывы хвост журнала 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 і праверкі спраўнасці](/en/v1.0/operations/systemd-health). ## Куды далей - Пробы і кантрольны спіс перад запускам у прадакшн: [systemd і праверкі спраўнасці](/en/v1.0/operations/systemd-health). - За чым сачыць падчас паслядоўнага абнаўлення: [Палітыка абнаўлення](/en/v1.0/operations/upgrade-policy).