AiHummer
Հայերեն▾
Մուտք
v1.0.x▾
v1.0.xstable
{ }Swagger
Շահագործում/Observability

Observability

v1.0.x · թարմացվել է 2026-07-07

AiHummer-ի observability մոդելը միայն OTLP push է։ Gateway-ն արտահանում է telemetry ձեր կարգավորած OpenTelemetry endpoint-ին — այն չի բացահայտում scrape endpoint։ Ուղարկեք տվյալները ձեր collector-ին և վիզուալիզացրեք դրանք ներառված Grafana dashboard-ներով։

[!WARNING] Չկա Prometheus /metrics endpoint և չկա pprof (/debug/pprof)։ Observability-ն միայն OTLP push է — մի կարգավորեք scrape job gateway-ի դեմ. փոխարենը ուղղորդեք AiHummer-ին ձեր OTLP collector-ին։

OTLP push

Սահմանեք մեկ փոփոխական՝ telemetry-ն միացնելու համար.

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

AIHUMMER_OTEL_ENDPOINT-ը սահմանված լինելով, gateway-ը push է անում telemetry-ն այդ collector-ին։ Այնտեղից ուղղորդեք այն ձեր backend-ին (Tempo, metrics store, log-եր) և Grafana-ի մեջ։

Կենդանի լոգեր ադմին UI-ում

Ադմին UI-ի «Լոգեր» էջը gateway-ի մատյանի կենդանի «պոչն» է. նոր տողերը քաշվում են ավտոմատ մի քանի վայրկյանը մեկ՝ ներքևի եզրին ավտոսկրոլով։ Գործիքագոտում կան տողերի որոնում և մակարդակի զտիչ (բոլորը / սխալներ / նախազգուշացումներ / ինֆո / debug)։ Մի շարք այլ էջեր (Վահանակ, Սեսիաներ, Ալիքներ) նույնպես թարմանում են ավտոմատ, իսկ երկար ցանկերը (աուդիտ, փոփոխություններ, ծանուցումներ և այլն) բեռնվում են էջ առ էջ «Ցույց տալ ավելին» կոճակով։

Բոլոր ծառայությունների ամբողջական մատյանները շարունակում են ապրել systemd-ում — aihummer logs [unit] կամ journalctl -u aihummer-gateway։

Grafana dashboard-ներ

Պատրաստի Grafana dashboard-ները մատակարարվում են թողարկման հետ։ Ներմուծեք դրանք ձեր Grafana instance-ի մեջ՝ գործառնական տեսքերն ստանալու համար՝ առանց panel-ները զրոյից կառուցելու։

Ինչին հետևել

Սրանք այն ազդանշաններն են, որ ձեզ ասում են, որ համակարգն առողջ է, և turn-երը հոսում են.

Ազդանշան Ինչու է կարևոր
Turn latency Agent-ի turn-երի սկզբից-մինչև-վերջ արձագանքելիություն
Error rate Ձախողվող turn-եր / հարցումներ — խնդրի առաջին նշանը
Delivery dispositions Արդյոք պատասխանները իրականում հասնում են ալիքներին
Outbox / DLQ խորություն Չառաքված հաղորդագրությունների կուտակում. աճող DLQ նշանակում է, որ առաքումը խցանված է

Աճող outbox կամ dead-letter-queue (DLQ) խորությունը ամենահստակ վաղ նախազգուշացումն է, որ առաքումը կուտակվում է — հետևեք դրան rollout-ների և միջադեպերի ընթացքում։

Համակարգային endpoint-ներ

OTLP-ի կողքին gateway-ը բացահայտում է փոքր HTTP endpoint-ներ, որոնք օգտակար են probe-ների, ժամացույցների և client-ի ախտորոշման համար.

Method Endpoint Նպատակ
GET /healthz Liveness + version
GET /readyz Readiness (ստուգում է Postgres-ը. 503՝ եթե անջատ է)
GET /v1/ping Թեթև հասանելիության ստուգում
GET /v1/time Սերվերի ժամանակ
POST /v1/client-log Client-side log իրադարձությունների ստացում

Health և readiness probe-ները մանրամասն նկարագրված են systemd և առողջության ստուգումներ էջում։

Ո՞ւր հաջորդիվ