Հետևելիություն

# 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 վահանակները տրամադրվում են թողարկման հետ։ Ներմցրեք դրանք Ձեր Grafana դեպքին `օպերացիոն դիտումների համար առանց վահանակներ զրոյից ստեղծելու անհրաժեշտության։ ## Ի՞նչ դիտել Սրանք սիգնալներ են, որոնք ցույց են տալիս, որ համակարգը առողջ է և գործընթացները ընթանում են։ | Սիգնալ | Ինչու է սա կարևոր | |---|---| | **պտույտի ուշացում** | Աջենտի շարժումների լիակատար արձագանքունակություն | | **Սխալի մակարդակ** | Չհաջողած շրջադարձեր / հարցումներ — խնդիրների առաջին նշանը | | **Առաքման հրահանգներ** | Պատասխանները իսկապես հասնում են արդյոք ալիքներին | | **Առաքման սպասող** | Հավաքված չուղարկված պատասխաններ; մշտական աճը նշանակում է, որ առաքումը կցկտրված է | Մշտական բարձրացում **սպասող կամ բազմիցս անհաջողված առաքումներ** նույնպես ամենակիրծող նախազգուշացումը, որ առաքումը կուտակվում է — հետևեք դրան ռոլաութների և դեպքերի ժամանակ։ ## Համակարգի ծայրային կետերը Բացի OTLP-ից, կեղծուղին տրամադրում է փոքր HTTP-ինդփոյնթներ, որոնք օգտակար են զոնդերի, ժամացույցների և հաճախորդների ախտորոշման համար: | Մեթոդ | Վերջնական կետ | Նպատակ | |---|---|---| | `GET` | `/metrics` | Prometheus մետրիկներ (կառուցում, գործարկման ժամանակ, տվյալների բազայի պուլ, պատրաստակամություն) | | `GET` | `/healthz` | Կյանքուրություն + տարբերակ | | `GET` | `/readyz` | Պատրաստություն (ստուգում է Postgres-ը; 503, եթե չի աշխատում) | | `GET` | `/v1/ping` | Թեթևակի հասանելիության ստուգում | | `GET` | `/v1/time` | Սերվերի ժամանակ | | `POST` | `/v1/client-log` | Ստանալ գրանցման իրադարձությունները հաճախորդի կողմում | Առողջության և պատրաստկության փորձարկումները մանրամասն քննարկված են բաժնում [systemd-ն և վիճակի ստուգումները](/hy/v1.0/operations/systemd-health). ## Որտեղից հետո - Չափիչներ և նախաթռիչքային արտադրական ստուգման ցուցակ: [systemd-ն և վիճակի ստուգումները](/hy/v1.0/operations/systemd-health). - Ի՞նչ նայել հաջորդական թարմացման ընթացքում: [Թարմացման քաղաքականություն](/hy/v1.0/operations/upgrade-policy).