AiHummer
Eesti▾
SisselogimineKonto
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Tegevused/Jälgitavus

Jälgitavus

v1.1.x · uuendatud 2026-07-07

AiHummeri jälgitavus on kaks pinda: värav teenib Prometheus GET /metrics lõpp-punkt, mida saate põhiteabe kogumiseks kasutada, ja see võib valikuliselt edastada telemeetriat OTLP kaudu OpenTelemetry lõpp-punkti, mida te seadistate. Kraapimine /metrics põhimonitoorimiseks; jälgede ja rikkalike mõõdikute jaoks suunake AiHummer oma OTLP kogujale ja visualiseerige andmed kaasasolevate Grafana armatuurlaudadega.

[!NOTE] pprof (/debug/pprof) on ei paljastatud.

Prometheus /metrics lõpp-punkt

GET /metrics teenib Prometheuse teksti-formaadi mõõdikuid ilma täiendava seadistamiseta. Avalikustatakse ainult mitte-tundlikud mõõdikud — ehituse info, protsessi tööaeg ja käitusaeg, andmebaasi ühenduse-pooli olek ja valmisoleku mõõdik; mitte ühtegi üürniku andmeid, mitte ühtegi saladust, mitte ühtegi päringu kohta silti. Trasside ja rikaste mõõdikute jaoks kasutage OTLP pushi.

OTLP tõuk

Määra üks muutuja, et telemeetria sisse lülitada:

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

Koos AIHUMMER_OTEL_ENDPOINT Kui see on seadistatud, saadab värav telemeetriat sellele kogujale. Sealt suuna see oma tagasüsteemi (Tempo, mõõdikute hoidla, logid) ja Grafanasse.

Paanikate ja vigade käsitlemine

Veaaruandeid ei saadeta kunagi kuhugi väljapoole: väraval ei ole välise veajälgija klienti ega välist DSN-i — andmed teie vigade kohta ei lahku kunagi teie kontuurist.

Paanikakindlus on sellest hoolimata täielik:

  • paanika HTTP-käsitlejas muutub tavaliseks veavastuseks (500 koos AIH-… ümbrikuga) — protsess ei sure ja teenindab edasi ülejäänud päringuid;
  • paanika taustagorutiinis püütakse samuti kinni ega too väravat alla.

Mõlemad juhtumid jõuavad struktureeritud logisse — vaadake neid lehel “Logid” (allpool) või journalctl kaudu.

Reaalajas logid administraatori liideses

Admini kasutajaliidesed “Logid” leht on pääsupunkti ajakirja reaalajas jälgimise vaade: uued read tuuakse automaatselt iga paari sekundi järel, automaatse kerimisega, kui olete allosas. Tööriistaribal on joon otsing ja üks taseme filter (kõik / vead / hoiatused / info / silumine). Ka mitu muud lehte (Armatuurlaud, Sessioonid, Kanalid) värskenduvad automaatselt ning pikad loendid (audit, muudatused, teated jne) laaditakse lehekülgede kaupa „Näita rohkem“ nupuga.

Kõigi teenuste täielikud logid on endiselt süsteemis systemd aihummer logs [unit] või journalctl -u aihummer-gateway.

Grafana armatuurlaud

Valmis Grafana armatuurlaudade paketid tarnitakse koos väljaandega. Impordi need oma Grafana eksemplari, et saada operatiivseid vaateid ilma tahvleid nullist üles ehitamata.

Mida vaadata

Need on signaalid, mis ütlevad teile, et süsteem on terve ja pöörded liiguvad:

Signaal Miks see on oluline
Käigu viivitus Agendi pöörde otsast lõpuni reageerimisvõime
Vea määr Ebaõnnestuvad pöörded / päringud — esimene muretekitav märk
Tarnekorraldused Kas vastused jõuavad tegelikult kanalitesse
Ootel tarned Tarnimata vastuste kogunemine; jätkuv kasv tähendab, et kohaletoimetamine on takerdunud

Pidev tõus ootel või korduvalt ebaõnnestunud kohaletoimetamised on selgeim varajane hoiatus, et tarne hakkab tagasilükkama — jälgi seda käivitamise ja intsidentide ajal.

Süsteemi lõpp-punktid

OTLP kõrvale avab värav väikesed HTTP lõpp-punktid, mis on kasulikud sondide, kellade ja kliendi diagnostika jaoks:

Meetod Lõpp-punkt Eesmärk
GET /metrics Prometheuse mõõdikud (ehitus, käitusaeg, andmebaasi hulk, valmidus)
GET /healthz Elavus + versioon
GET /readyz Valmidus (kontrollib Postgrest; 503, kui alla)
GET /v1/ping Kergekaaluline saavutatavuse kontroll
GET /v1/time Serveri aeg
POST /v1/client-log Võta vastu kliendipoolseid logi sündmusi

Tervise- ja valmisolekuprobleemid on üksikasjalikult käsitletud all systemd ja tervisekontrollid.

Kuhu järgmine