AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Ulanyş/Görnüp bilinýänlik

Görnüp bilinýänlik

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

AiHummer synlanylmagy bar iki ýüz: gapy hyzmat edýär Prometeý GET /metrics esaslary üçin çukurlap bilýän nokat, we islege baglylykda OTLP üsti bilen telemetriýa iberiň siz sazlaýan OpenTelemetry nokady öňe. Sypdyrmak /metrics esasy gözegçilik üçin; yzlary we baý metrikalary üçin AiHummer-iňizi OTLP ýygnagçysy bilen nokada gönükdiriň we maglumatlary birleşdirilen Grafana tablisalary bilen wizualizasiýa ediň.

[!NOTE] pprof (/debug/pprof) -dir däk açykda

Prometeý /metrics ahyry nokat

GET /metrics goşmaça sazlamasyz Prometeus tekst-format metriklerini hyzmat edýär. Diňe kän hassas bolmadyk ölçegler açylýar — gurluş maglumatlary, prosesiň iş wagty we iş wagtlykda, DB baglanyşyk hovuzynyň ýagdaýy we taýýarlyk ölçegi; kirýärler barada maglumat ýok, syrlar ýok, islege görä bellikler ýok. Izler we baý metrikler üçin OTLP itelesini ulanyň.

OTLP itekle

Telemetriýany ýandyrmak üçin bir üýtgeýji belleniň:

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

Bilen AIHUMMER_OTEL_ENDPOINT täzelenenden, gapy telemetriýany şol ýygnagçyya iberýär. Şondan, ony öz arka uýguňyza (Tempo, ölçegler baradaky dükany, gündelikler) we Grafananyň içine ugraň.

Panika we säwlikleri işlemek

Säwlikler baradaky hasabatlar daşyna hiç ýere iberilmeýär: gapyda daşarky säwlik gözegçisiniň müşderisi hem, daşarky DSN hem ýok — siziň säwlikleriňiz baradaky maglumatlar konturyňyzdan çykmaýar.

Şol bir wagtda panikalara durnuklylyk doly:

  • HTTP işleýjisindäki panika adaty säwlik jogabyna öwrülýär (AIH-… bukjaly 500) — proses ýykylmaýar we galan soraglara hyzmat etmegi dowam etdirýär;
  • fon gorutinasyndaky panika hem tutulýar we gapyny ýykmaýar.

Iki ýagdaý hem gurluşly žurnala düşýär — olary Ýazgylar sahypasynda (aşakda) ýa-da journalctl arkaly görüň.

Admin UI-de göni ýazgylar

Admin interfeýsiň Ýazgylar sahypa gatlaryň gündeliginiň göni yzy: täze setirler her birnäçe sekuntdan bir awtomatiki getirilýär, aşagynda wagtyňyz awtoscroll bilen. Gural panelinde bar setir gözleg we bir derejäni süzgi (ähli / hatalar / duýduryşlar / maglumat / debug). Başga-da birnäçe sahypalar (Dashboard, Sessions, Channels) hem otomatik täzelenýär we uzyn listler (audit, üýtgeşmeler, bildirişler we ş.m.) “Köpräk görkez” düwmesi bilen sahypa ýüklenýär.

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

Grafana tablisalary

Hazır Grafana paneliniň görnüşleri çykarmalar bilen gelýär. Olary Grafana ulgamyňyza import edip, paneli sıfyndan gurnamany gerek etmän, işjeňlik görnüşlerini alyp bilersiňiz.

Näme gözüne ilýär

Bularyň öň görkezýän signalary ulgamynyň sagdyndygyny we batyrmalaryň akýandygyny habar berýär:

Signal Näme üçin möhüm
Aýlanma gijikmesi Agentin öwürleriniň ahyrky-ahyryna çenli jogap berijiligi
Ýalňyşlyk derejesi Başarmazlyk bilen ýüzlenmeler — kynçylygyň ilkinji alamaty
Eltip bermek düzgünleri Jogaplaryň hakykatdanam kanallara ýetýän-ýetmeýändigini
Garaşylýan eltip bermeler Eltip berilmedik jogaplaryň ýagdaýy; yzygiderli ösüş eltip bermek işiniň saklanýandygyny aňladýar

Yzygiderli ýokarlanma garaşylýan ýa-da gaýtalanyp başartmadyk iberiler bu eltip bermäniň yzygiderli batlamagynyň iň aç-açan irki duýduryşydyr — ony eltip bermeleriň we hadysalaryň dowamynda synlaň.

Ulgam ugrundaky nokatlar

OTLP bilen bir hatarda, geçelge, probalar, sagat we ulanyjy diagnostikasy üçin peýdaly kiçi HTTP uçarlaryny açýar:

Usul Uly nokat Maksat
GET /metrics Prometheus ölçegleri (gurnama, iş wagty, DB hovuzy, taýýarlyk)
GET /healthz Göni gözegçilik + wersiýa
GET /readyz Täzeleşiklik (Postgres-i barlaýar; işlemese 503)
GET /v1/ping Aýratyn ýeňil ýetip bolmalygyny barlamak
GET /v1/time Serwer wagty
POST /v1/client-log Client tarapyndaky lohg wakalaryny kabul etmek

Saglyk we taýýarlyk barlaglary jikme-jik ýagdaýda gürrüň berilýär systemd we saglyk barlaglary.

Indi nire?