AiHummer
Монгол▾
НэвтрэхБүртгэл
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Үйл ажиллагаа/Ажиглагдах байдал

Ажиглагдах байдал

v1.1.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 байрлуулсан тохиолдолд, хаалга нь телеметрийг тэр цуглуулагчид түлхдэг. Тэндээс үүнийг өөрийн сервер рүүгээ (Tempo, метрик хадгалах сан, тэмдэглэлүүд) чиглүүлж, Grafana-д оруулна.

Паник болон алдааны боловсруулалт

Алдааны тайлан гадагш хаашаа ч илгээгддэггүй: хаалганд гадаад алдааны мөрдөгчийн клиент байхгүй бөгөөд гадаад DSN ч байхгүй — таны алдааны тухай өгөгдөл таны хүрээнээс хэзээ ч гардаггүй.

Гэсэн хэдий ч паникт тэсвэртэй байдал бүрэн:

  • HTTP боловсруулагч дахь паник нь ердийн алдааны хариу болж хувирдаг (AIH-… дугтуйтай 500) — процесс унахгүй бөгөөд бусад хүсэлтүүдийг үргэлжлүүлэн үйлчилнэ;
  • арын горутин дахь паник мөн баригдаж, хаалгыг унагаадаггүй.

Хоёул тохиолдол бүтэцлэгдсэн бүртгэлд тусдаг — тэдгээрийг Өтгөрүүлэлтүүд хуудсан дээр (доор) эсвэл journalctl-ээр үзнэ үү.

Админ UI-д амьд тэмдэглэл

Админ UI-ийн Өтгөрүүлэлтүүд хуудас нь гарцын сэтгүүлээс шууд бичлэг үзүүлж байна: шинэ мөрүүдийг хэдхэн секунд тутамд автоматаар татдаг бөгөөд та доор байх үед автоматаар гүйлгэдэг. Хэрэгслийн самбар нь шугаман хайлт мөн нэг төлөвийн шүүлтүүр (бүх / алдаа / анхааруулга / мэдээлэл / алдааг засварласан). Бусад хэд хэдэн хуудас (Dashboard, Sessions, Channels) мөн автоматаар шинэчлэгддэг бөгөөд урт жагсаалтууд (аудит, өөрчлөлт, мэдэгдэл гэх мэт) хуудсыг “Show more” товчлуураар хуудас бүрээр ачаална.

Бүх үйлчилгээний бүрэн бүртгэлүүд одоо ч systemd-д амьд хэвээр байна — aihummer logs [unit] эсвэл journalctl -u aihummer-gateway.

Графана самбарууд

Бэлэн 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 ба эрүүл мэндийн шалгалтууд.

Дараа хаашаа явах вэ