AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Истифодабарӣ/Намояндагӣ

Намояндагӣ

v1.0.x · навсозӣ шуд 2026-07-07

Нобиноии AiHummer дорад ду сатҳ: дарвозаро ҳамчун як хизмат мекунад Прометей GET /metrics нуқтаи охирие, ки шумо метавонед барои маълумоти асосӣ скрапинг кунед, ва он метавонад ихтиёрӣ бошад фиристодани телеметрия тавассути OTLP ба як нуқтаи охирини OpenTelemetry, ки шумо танзим мекунед. Скрейп /metrics барои назорати асосӣ; барои ізҳо ва метрикҳои бой AiHummer-ро ба коллекционери OTLP-и худ нишон диҳед ва маълумотро бо панели Grafana-и дохилшуда визуализатсия кунед.

[!NOTE] pprof(/debug/pprof) аст не ошкоршуда.

Прометей /metrics нирӯи ниҳоӣ

GET /metrics метрикҳои матнӣ формати Prometheus-ро бе ягон танзими иловагӣ хизмат мекунад. Танҳо миқёсҳои ноназук нишон дода мешаванд — маълумоти сохт, вақти коркарди раванд ва вақти иҷро, ҳолати ҳавзи пайвасти DB ва миқёси омодагӣ; ягон маълумоти иҷорагир, сиррҳо ё барчаспҳои дар ҳар дархост нест. Барои таърихҳо ва метрикҳои муфассал, аз OTLP push истифода баред.

Тӯфони OTLP

Барои фурӯзон кардани телеметрия як тағйирёбандаи ягона таъин кунед:

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

Бо AIHUMMER_OTEL_ENDPOINT ба истгоҳ, дарвоза телеметрияро ба он ҷамъоварӣкунанда мефиристад. Аз он ҷо онро ба бахши пушти таҳрифии шумо (Темпо, анбори нишондиҳандаҳо, логҳо) ва ба Графана роҳ диҳед.

Коркарди паникаҳо ва хатогиҳо

Ҳисоботҳо дар бораи хатогиҳо ба ҳеҷ ҷои берун фиристода намешаванд: дар дарвоза на мизоҷи трекери берунии хатогиҳо ва на DSN-и берунӣ вуҷуд дорад — маълумот дар бораи хатогиҳои шумо контури шуморо тарк намекунад.

Дар айни ҳол устуворӣ ба паникаҳо пурра аст:

  • паника дар коркардкунандаи HTTP ба ҷавоби оддии хатогӣ табдил меёбад (500 бо лифофаи AIH-…) — раванд аз кор намемонад ва хизматрасонии дархостҳои дигарро идома медиҳад;
  • паника дар горутинаи пасзамина низ гирифта мешавад ва дарвозаро аз кор намебарорад.

Ҳарду ҳолат ба журнали сохторӣ меафтад — онҳоро дар саҳифаи Логҳо (дар поён) ё бо journalctl бинед.

Бурунрафтҳои зинда дар интерфейси маъмурӣ

Интерфейси идоракунии маъмур Логҳо саҳифа як пайгирии зинда аз журнали дарвоза мебошад: хати нав ҳар чанд сония ба таври худкор гирифта мешавад, бо сурхшавии автоматӣ ҳангоми будан дар поён. Панели асбобдорӣ дорост ҷустуҷӯи хат ва як сартаппакаркунандаи сатҳ (ҳама / хатоҳо / огоҳӣҳо / маълумотҳо / таҳқиқ). Чанде аз саҳифаҳои дигар (Дашборд, Сессияҳо, Каналҳо) низ ба таври худкор таҷдид мешаванд, ва рӯйхатҳои дароз (назорати аудит, тағирот, огоҳиномаҳо ва ғайра) саҳифа ба саҳифа бо тугмаи «Намудани бештар» бор карда мешаванд.

Ҳуҷҷатҳои пурраи ҳар хизматрасонӣ ҳанӯз ҳам дар systemd мавҷуданд — aihummer logs [unit] ё journalctl -u aihummer-gateway.

Рӯйпӯшҳои Grafana

Таблоҳои омодасозии Grafana бо нашр мерасанд. Онҳоро ба намунаи Grafana-и худ ворид кунед, то назарияҳои амалиётиро бидуни сохтани панели нав ба даст оред.

Чӣро тамошо кардан

Инҳо сигналҳое ҳастанд, ки ба шумо мегӯянд, систем саломат аст ва гардишҳо ҷорӣ мешаванд:

Сигнал Чаро ин муҳим аст
Тарҷумаи навбат Ҷавоби тамоми рӯйдодҳои агент
Сатҳи хатогӣ Ҷавоб надодан ба гузаришҳо / дархостҳо — аввалин нишонаи мушкилот
Тартиботи таҳвил Оё посухҳо воқеан ба каналҳо расида истодаанд
Расонидани мунтазир Шумораи посухҳои номусаллаҳ; афзоиши доимӣ маънои онро дорад, ки таҳвил лоқат мондааст

Баландшавии доимӣ дар пеш аз ҳалнашуда ё ҳамеша нокомшудаи таҳвилҳо ин равшантарин огоҳӣ пешакӣ аст, ки таҳвил ба ақиб меравад — ҳангоми паҳнкунӣ ва рӯйдодҳо онро дида бароед.

Нуқтаҳои ниҳоии система

Дар канори OTLP, дарвоза нуқтаҳои хурди HTTP-ро, ки барои нозирҳо, соатҳо ва ташхисҳои муштарӣ муфиданд, дастрас мекунад:

Усул Нуқтаи охирин Мақсад
GET /metrics Метрикҳои Prometheus (сохтан, давраи иҷро, ҳавзи DB, омодагӣ)
GET /healthz Зиндагӣ + нусха
GET /readyz Омодагӣ (санҷиши Postgres; 503 агар хомӯш бошад)
GET /v1/ping Таҷрубаи санҷиши вазни сабук
GET /v1/time Вақти сервер
POST /v1/client-log Қабул кардани рӯйдодҳои лог аз ҷониби муштарӣ

Тадқиқотҳои саломатӣ ва омодагӣ дар ҷузъиёти зери назари пурра баррасӣ шудаанд systemd ва санҷишҳои саломатӣ.

Баъд ба куҷо