AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Ulanyş/Gözegçilik

Gözegçilik

v1.0.x · täzelendi 2026-07-07

AiHummer gözegçiligi iki ýüzlidir: gateway esaslar üçin scrape edip boljak Prometheus GET /metrics endpointini hödürleýär we isleg boýunça siz kesgitleýän OpenTelemetry endpointine telemetriýany OTLP arkaly itekläp biler. Esasy gözegçilik üçin /metrics-i scrape ediň; izler we baý metrikalar üçin AiHummer-i OTLP kollektoryňyza ugrukdyryň we maglumatlary jemlenen Grafana dashboardlary bilen görkeziň.

[!NOTE] pprof (/debug/pprof) açylmaýar.

Prometheus /metrics endpointi

GET /metrics hiç hili goşmaça sazlamasyz Prometheus tekst-formatly metrikalary hödürleýär. Diňe duýgur däl görkezijiler açylýar — gurluş maglumaty, prosesiň işleýiş wagty we runtime, DB birikme-havuz ýagdaýy we taýýarlyk görkezijisi; kärendar maglumaty ýok, syrlar ýok, haýyş-boýunça belliklery ýok. Izler we baý metrikalar üçin OTLP push-y ulanyň.

OTLP push

Telemetriýany açmak üçin ýeke-täk üýtgeýjini belläň:

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

AIHUMMER_OTEL_ENDPOINT bellenende, geýtweý telemetriýany şol kollektora itekleýär. Şol ýerden ony backendiňize (Tempo, metrik ammary, loglar) we Grafana-a ugrukdyryň.

Ýalňyş hasabaty (Bugsink / Sentry)

Gateway Sentry-protokolly ýalňyş-hasabat müşderisini iberýär — ol öz-özüni-host edýän Bugsink bilen ýa-da islendik Sentry-gabat gelýän DSN bilen işleýär. DSN-i belläň, we panikalar we ýalňyşlar (başlangyç faza we fon işgärleri hem goşulyp) komponent we nusga belligi bilen belliklenip trekeriňize hasabat berler:

# gateway.env — error reporting (Bugsink or any Sentry-compatible DSN)
AIHUMMER_SENTRY_DSN=https://<key>@<your-bugsink-or-sentry>/<project>
AIHUMMER_SENTRY_ENVIRONMENT=production   # islege bagly; deslapky ýagdaýda production

Iki düwme-de sazlamalar-katalog ýazgylary (Observability topary), şonuň üçin olary web admin UI-den hem belläp bilersiňiz; DB bahasy env-den ileri tutulýar. DSN bellenýänçä, hasabat öçük.

Admin UI-de janly loglar

Admin UI-niň «Logs» sahypasy gateway žurnalynyň janly guýrugydyr: täze setirler birnäçe sekuntdan awtomatiki çekilýär, aşakda duran wagtyňyz awto-aýlanma bilen. Gural panelinde setir gözlegi we dereje süzgüji (hemmesi / ýalňyşlar / duýduryşlar / maglumat / debug) bar. Birnäçe başga sahypa (Dashboard, Sessions, Channels) hem awtomatiki täzelenýär, uzyn sanawlar bolsa (audit, üýtgeşmeler, bildirişler we ş.m.) «Ýene görkez» düwmesi bilen sahypama-sahypa ýüklenýär.

Her hyzmatyň doly loglary henizem systemd-de ýaşaýar — aihummer logs [birlik] ýa-da journalctl -u aihummer-gateway.

Grafana dashboardlary

Taýýar Grafana dashboardlary çykarylyş bilen iberilýär. Olary Grafana instansyňyza import ediň, şeýdip panelleri noldan gurman operasion görnüşleri alyň.

Nämä seretmeli

Bular size ulgamyň sagdyndygyny we gezekleriň akýandygyny aýdýan signallardyr:

Signal Näme üçin möhüm
Gezek gijiklemesi Agent gezekleriniň ujundan-uja jogap berijiligi
Ýalňyş derejesi Şowsuz gezekler / haýyşlar — kynçylygyň ilkinji alamaty
Eltiş dispozisiýalary Jogaplaryň hakykatdanam kanallara ýetip-ýetmeýändigi
Outbox / DLQ çuňlugy Eltilmedik habarlaryň galyndysy; ösýän DLQ eltişiň dyknandygyny aňladýar

Ösýän outbox ýa-da dead-letter-queue (DLQ) çuňlugy eltişiň yza düşýändiginiň iň aýdyň irki duýduryşydyr — ony çykaryşlar we wakalar wagtynda gözegçilikde saklaň.

Ulgam endpointleri

OTLP-iň ýanynda, geýtweý probalar, sagatlar we müşderi diagnostikalary üçin peýdaly kiçi HTTP endpointlerini açýar:

Metod Endpoint Maksat
GET /metrics Prometheus metrikalary (gurluş, runtime, DB havuzy, taýýarlyk)
GET /healthz Janlylyk + wersiýa
GET /readyz Taýýarlyk (Postgres barlaýar; aşakda bolsa 503)
GET /v1/ping Ýeňil ýetişiklilik barlagy
GET /v1/time Serweriň wagty
POST /v1/client-log Müşderi tarapyndaky log wakalaryny kabul etmek

Saglyk we taýýarlyk probalary systemd & saglyk barlaglary astynda jikme-jik beýan edilýär.

Indiki nirä