მოვლენადობის დაკვირვება

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

AiHummer–ის შემჩნევადობა არსებობს **ორი ზედაპირი**: ის გეიტვეი ეხმარება **პრომეთე `GET /metrics`** საბოლოო წერტილი, საიდანაც შეგიძლიათ მიიღოთ ძირითადი მონაცემები, და ასევე ის შეიძლება საჭიროებისამებრ **თელემეტრიის გაგზავნა OTLP-ის გზით** განცადო თქვენს მიერ დაყენებულ OpenTelemetry საბოლოო წერტილზე. მონაცემების აღება `/metrics` საზოგადოებრივი მონიტორინგისთვის; ტრასირებისათვის და დეტალური მეტრიკებისთვის გაუგზავნეთ AiHummer თქვენი OTLP კოლექტორზე და ვიზუალიზაციეთ მონაცემები ჩაშენებული Grafana პანელების საშუალებით. > [!NOTE] > pprof (`/debug/pprof`) არის **არა** გაღიარებული. ## პრომეთე `/metrics` საბოლოო წერტილი `GET /metrics` პროგრამა უზრუნველყოფს მეტრიკებს Prometheus-ის ფორმატში დამატებითი კონფიგურაციის გარეშე. გახსნილია მხოლოდ არასაიდუმლო ინდიკატორები — კრებულის ინფორმაცია, პროცესის მუშაობის და შესრულების დრო, მონაცემთა ბაზასთან დასაკავშირებელი კავშირის აუზის მდგომარეობა და მზადყოფნის ინდიკატორი; არ არის ქირავნილის მონაცემები, არ არის საიდუმლოებები, არა სურათები მოთხოვნის მიხედვით. ტრასა და გაფართოებული მეტრიკებისთვის გამოიყენეთ OTLP push. ## OTLP პუშ დაადგინეთ ერთი ცვლადი, რათა ჩართოთ ტელემეტრია: ```ini # gateway.env — export telemetry to your OTLP collector AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317 ``` ს `AIHUMMER_OTEL_ENDPOINT` უწყვეთ, გეითვეი აგზავნის ტელემეტრიას იმ კოლექტორზე. იქიდან, გადამისამართეთ იგი თქვენს ბექენდზე (Tempo, მეტრიკის საცავი, ლოგები) და Grafana-ში. ## პანიკებისა და შეცდომების დამუშავება შეცდომების შესახებ ანგარიშები **არსად გარეთ არ იგზავნება**: შლიუზში არ არის შეცდომების გარე ტრეკერის კლიენტი და არც გარე DSN — თქვენი შეცდომების შესახებ მონაცემები არ ტოვებს თქვენს კონტურს. პანიკებისადმი მდგრადობა კი სრულია: - HTTP-დამმუშავებელში მომხდარი პანიკა იქცევა ჩვეულებრივ შეცდომის პასუხად (500 `AIH-…` კონვერტით) — პროცესი არ ეცემა და აგრძელებს დანარჩენი მოთხოვნების მომსახურებას; - ფონურ გორუტინაში მომხდარი პანიკაც აღიკვეთება და არ ამხობს შლიუზს. ორივე შემთხვევა ხვდება სტრუქტურირებულ ჟურნალში — იხილეთ ისინი გვერდზე **ჟურნალები** (ქვემოთ) ან `journalctl`-ის მეშვეობით. ## ცოცხალი ლოგები ადმინისტრაციულ ინტერფეისში ადმინისტრატორის ინტერფეისი **ჟურნალები** გვერდი წარმოადგენს სართი შლიუზის ჟურნალის ცოცხალ ნახვას: ახალი სტრიქონები ავტომატურად ჩნდება ყოველ რამდენიმე წამში, ავტომატური სროლით, სანამ თქვენ ქვემოთ ხართ. ხელსაწყოების პანელი აქვს **სტრიქონის მოძიება** და a **სართულიანი ფილტრი** (ყველა / შეცდომები / გაფრთხილებები / ინფორმაცია / გამართვა). რამდენიმე სხვა გვერდი (კონტროლის პანელი, სესნები, არხები) ასევე ავტომატურად განახლდება, ხოლო სიგრძე სიის (აუდიტი, ცვლილებები, შეტყობინებები და ა.შ.) გვერდებად იტვირთება ღილაკის „აჩვენე მეტი“ საშუალებით ღილაკი. ყველა სამსახურის სრული ჟურნალები კვლავ systemd-შია — `aihummer logs [unit]` ან `journalctl -u aihummer-gateway`. ## გრაფანა მონიტორინგის პანელები მოემზადება Grafana-ს პანელები გამოშვებასთან ერთად. იმპორტეთ ისინი თქვენს Grafana-ის ინსტანციაში, რათა მიიღოთ ოპერაციული ხედები, ახალი პანელების შექმნის საჭიროების გარეშე. ## რას ვუყუროთ ეს არის სიგნალები, რომლებიც გეუბნებათ, რომ სისტემა ჯანმრთელია და ნაკადი მოძრაობს: | სიგნალი | რატომ არის ეს მნიშვნელოვანი | |---|---| | **ბრუნვის შეფერხება** | მოვალეობის აგენტის სრულად რეაგირება | | **შეცდომის დონე** | შეუსაბამო მორგებები / მოთხოვნები — პრობლემების პირველი ნიშანი | | **მიწოდების ბრძანებები** | პასუხები სინამდვილეში არხებს აღწევენ? | | **მიწოდების მოლოდინში** | შეგროვებული გაგზავნილი პასუხები; მუდმივი ზრდა ნიშნავს, რომ მიწოდება ჩაიძირა | მუდმივი ზრდა **მოლოდინში მყოფი ან განმეორებით წარუმატებელი გადაზიდვები** უპირატესად არის ყველაზე ნათელი ადრეული სიგნალი იმისა, რომ მიწოდება ირჭობება — თვალყური ადევნეთ ამას განთავსების და ინციდენტების დროს. ## სისტემის საბოლოო წერტილები OTLP-სთან ერთად, ბრიჯი სთავაზობს მცირე HTTP-ენდპოინტებს, რომლებიც სასარგებლოა პრობს, საათებისთვის და კლიენტების დიაგნოსტიკისთვის: | მეთოდი | საბოლოო წერტილი | მიზანი | |---|---|---| | `GET` | `/metrics` | Prometheus მეტრიკები (კომპილაცია, შესრულების დრო, მონაცემთა ბაზის პული, მზადყოფნა) | | `GET` | `/healthz` | სიცოცხლე + ვერსია | | `GET` | `/readyz` | მზადყოფნა (სრულფასოვნად ამოწმებს Postgres; 503, თუ არ მუშაობს) | | `GET` | `/v1/ping` | მსუბუქი მისაწვდომობის შემოწმება | | `GET` | `/v1/time` | სერვერის დრო | | `POST` | `/v1/client-log` | მიიღეთ ჟურნალი სერვერის მოვლენები კლაინის მხარეს | ჯანმრთელობისა და მზადყოფნის ტესტები დეტალურად განხილულია განყოფილებაში [systemd და მდგომარეობის შემოწმება](/ka/v1.0/operations/systemd-health). ## სად შემდეგ? - ზედამხედველობა და წინამოსამზადებელი კონტროლის სია წარმოებისთვის: [systemd და მდგომარეობის შემოწმება](/ka/v1.0/operations/systemd-health). - რას ეცნობა ნაკადის განახლებას დროს: [განახლების პოლიტიკა](/ka/v1.0/operations/upgrade-policy).