Wiki · Funkce do hloubky
Měření a monitoring
Monitoring není o tom mít graf. Je o tom vědět o problému dřív než uživatel — od /usage po napojení na váš dohled.
/usage), přehled instalace v dashboardu
a strojový export metrik pro servery, které sledujete. Začněte první úrovní — ta je zdarma a hned.1. Kolik to stojí: /usage a /insights
| Příkaz | Co ukáže |
|---|---|
/usage | Spotřebu tokenů, rozpad ceny (vstup/výstup), stav kontextového okna, délku sezení a — když to poskytovatel umí — zbývající kvótu nebo kredit |
/insights | Přehled za posledních 30 dní: co se používalo a kolik to stálo |
Pokud se vám cena zdá vysoká, podívejte se nejdřív na velikost kontextu, ne na cenu za token. Dlouhá sezení bez úklidu jsou nejčastější důvod, proč účet roste rychleji, než by odpovídalo množství práce.
2. Přehled instalace: dashboard
Stránka Status v dashboardu se obnovuje každých 5 vteřin a ukazuje:
| Co | Význam |
|---|---|
| Verze a datum vydání | Na jaké verzi jedete (hodí se při hlášení chyby) |
| Stav brány | Běží/stopped, PID, připojené platformy a jejich stav |
| Aktivní sezení | Kolik sezení bylo aktivních za posledních 5 minut |
| Posledních 20 sezení | Model, počet zpráv, spotřeba tokenů a náhled konverzace |
3. Zdraví z příkazové řádky: hermes doctor
Návratový kód dělá z doctor použitelnou kontrolu pro cron nebo CI: dá se na něm
postavit „když se to pokazí, pošli mi zprávu“. Kontroluje i IPv6 trasu (blackholed prefix se pozná
jako varování s radou network.force_ipv4: true).
4. Strojový export metrik (OTLP)
Pro skutečný dohled — Prometheus, DataDog, OpenTelemetry Collector — umí brána posílat metriky, události a diagnostiku přes OTLP/HTTP:
| Signál | Co obsahuje |
|---|---|
| Metriky | hermes.gateway.up/state/busy/active_agents/background_work, stav platforem, časovač cronu a počty úloh |
| Události (traces) | Přechody stavu brány (starting → running → draining → stopped), změny stavu platforem, průběh cron úloh |
| Diagnostika (logs) | Jen varování a chyby s kódem a třídou chyby — nikdy text promptů ani zpráv |
Export je záměrně „bez obsahu“: neposílá prompty, zprávy, argumenty nástrojů, jména úloh ani historii sezení. Do cizího systému se tak nedostane nic z toho, co jste agentovi svěřili — a přesto poznáte, že je brána dole.
Na co hlídat
| Pravidlo | Proč |
|---|---|
hermes_gateway_up == 0 | Brána je explicitně dole (proces běží, ale nehlásí se) |
| Chybějící řada delší než interval exportu | Proces, který spadl, sám nulu nepošle — bez tohohle pravidla vám výpadek nikdo neohlásí |
hermes.platform.degraded | Platforma (Telegram, Discord) ztratila spojení, ale brána běží dál |
| Stáří posledního úspěchu cronu | Pravidelná úloha přestala běžet — častější problém než spadlá brána |
Druhé pravidlo je zkušenost z našeho provozu: měření, které posílá jen „jsem OK“, vypadá při výpadku jako klid. Vždy hlídejte i to, že data přestala chodit.
Na co si dát pozor
| Situace | Co s tím |
|---|---|
| Chybí SDK pro OTLP | Doplňuje se při prvním použití (extra otlp); bez něj brána běží dál, jen se neexportuje |
| Endpoint je nedostupný | Export nesmí shodit agenta — selhání je omezené a nezdržuje běžný provoz |
| Dashboard hlásí málo paměti | Zkraťte sezení, uberte paralelní podagenty, zvyšte RAM; hlášení zmizí po restartu brány |
| Velká spotřeba tokenů | Kratší sezení, levnější model pro pomocné úlohy (např. kurátor), méně nástrojů v kontextu |
| Monitoring máte, ale nikdo se nedívá | Nastavte práh, který pošle zprávu do Telegramu — graf, na který se nechodí, není monitoring |