Tato stránka byla strojově přeložena. Přečtěte si anglický originál. English

Pro vývojáře aplikací

Který dotaz optimalizovat jako první? Který kód způsobil chybu? Kdo drží záznam v konfliktu? Agent sbírá odpovědi z trace a statistik přímo na serveru. Vývojář je vidí v prohlížeči a nemusí se přihlašovat na server.

  • 1 min trace soubory
  • 3 okna denně zpráva o výkonu
  • podle plánu seskupování dotazů
  • 15 min hledání konfliktů
  • REST lokální API pro skripty a CI

trace · process_traces · perf report

Zpráva o výkonu

Agent má neustále otevřenou trace relaci. Každou minutu komprimuje výstup do souboru a počítá součty pro každý dotaz. Po skončení okna agent spojí minuty do zprávy: nejpomalejší dotazy a ty nejnáročnější podle fetches, čtení a zápisů. U každého dotazu je uveden počet spuštění.

  1. 1Trace relacefbtracemgr běží neustále; watchdog restartuje ztracenou relaci
  2. 2Minutový souborkomprimovaný trace výstup jednou za minutu
  3. 3Minutové součtypro každý dotaz: spuštění, čas, fetches, čtení, zápisy, značky
  4. 4Zpráva oknado 5 minut po skončení okna; až 20 dotazů v každém žebříčku
  5. 5✓ HQ MonitorStránka Perf Report; odkaz ze zprávy o stavu
Tři okna zpráv denně: ráno 07:00–12:30, den 12:31–18:00, noc 18:01–06:59; agent kontroluje okna každých 5 min, takže zpráva se objeví do 5 min po skončení okna
Výchozí okna. Ráno, den a noc. Okna a jejich počet můžete změnit v nastavení agenta. Minuta bez dat se přeskočí; zpráva se přesto sestaví.

Proč seskupovat podle plánu

Pokud program vkládá hodnoty přímo do textu SQL, každá hodnota vytvoří nový text. V jednom reálném případě počet různých textů vzrostl z 204 na 83 825 za minutu. Tisíce „různých“ dotazů jsou ve skutečnosti jeden dotaz s jedním plánem. Agent proto ve výchozím nastavení seskupuje dotazy podle klíče: prvních 10 znaků SQL bez komentářů plus plán spuštění. Dotaz bez plánu si zachová celý text. Režim změníte v nastavení agenta, pole „Perf group by“: podle plánu nebo podle plného textu SQL. Při seskupení podle textu jsou soubory a zprávy mnohem větší. Přepněte režim v příkladu níže a porovnejte žebříčky.

Dotazy v jedné minutě

    Žebříček podle fetches

      Tabulka zprávyCo ukazuje
      Top SQL podle trváníNejpomalejší spuštění: čas a počet záznamů.
      Top SQL podle fetches, čtení, zápisůSoučty za okno: spuštění, čas, fetches, čtení, zápisy, značky; podíl na celém okně; průměr a maximum na spuštění.
      Procesy a adresyZátěž podle programu a podle adresy klienta: připojení, čas, počet různých plánů a dotazů.
      Řádek dotazuPlné SQL, PLAN, parametry a statistiky podle tabulek: natural, index, update, insert, delete, backout, purge, expunge.
      Deset žebříčků v záložkáchTrvání, frekvence, celkový čas, fetches, čtení, zápisy, plány, značky, procedury a triggery. U každé metriky vidíte rozptyl hodnot.
      Ukázkové spuštěníKdy běželo, který klient a z které adresy, v které databázi. Pokud spuštění skončilo chybou, vidíte ji; každý dotaz má počítadlo neúspěšných spuštění.
      Spuštění podle hodinKolikrát a jak dlouho dotaz běžel v každé hodině okna.
      DatabázeSoučty podle databáze serveru a hlavní databáze každého dotazu.

      Porovnání, historie a zpráva na vyžádání

      Zpráva okna odpovídá na otázku „co bylo dnes náročné“. Tři nové funkce odpovídají na otázky „co se změnilo“ a „co se stalo v této hodině“.

      • Porovnání dvou okenDvě zprávy vedle sebe: které dotazy se zpomalily, které se objevily a které zmizely.
      • Historie dotazu za 30 dníJak se čas a počet spuštění jednoho dotazu měnily okno od okna.
      • Filtr podle databázeZpráva pouze pro jednu databázi. Odkaz na stránce databáze vede na stránku zprávy.
      • K trace dané minutyZ dotazu ve zprávě k trace minuty, kdy běžel.
      • Zpráva na vyžádáníTlačítko Build report… sestaví zprávu pro libovolný rozsah až 24 hodin. Filtry: databáze, minimální trvání, program. Agent sestavuje vždy jednu takovou zprávu a uchovává posledních 20.
      • Hledání a staženíVyhledávací pole pro text dotazu. Zdrojový soubor zprávy můžete stáhnout.
      • Neúplná zpráva je označenaPokud některé trace soubory ještě nedorazily, zpráva je označena jako neúplná. Zpráva uchovává pouze top každého žebříčku, takže stránka uvádí „není v žebříčku“, nikoli „neběžel“.
      • Procedury a triggeryTyto žebříčky se plní, když nastavení trace zapne logování dokončení procedur a triggerů. Ve výchozím nastavení je toto logování vypnuto.
      • Ze zprávy o stavuTlačítko Perf report otevře správné okno. Řádky dotazů jsou označeny a první je již rozbalený.
      • Dotaz a tabulkaZáložka Queries statistik gstat propojuje dotazy s tabulkami a indexy, které čtou.
      • Minuta na grafu databázeKliknutí na minutu zobrazí náročné dotazy z trace a všechna připojení dané minuty.
      • Kopírovat SQLS parametry nebo bez nich, přímo do vašeho nástroje. V demo režimu jsou tlačítka skryta.

      trace · Errors

      SQL chyby s údaji o klientovi

      Uživatel říká „program vyhodil chybu“. Stránka Errors zobrazuje každou chybu Firebird z trace: čas, připojení, databázi, text a klienta. S názvem programu, adresou a funkcí Firebird snadno najdete chybu ve svém kódu.

      Blok chyby v trace

      2026-10-17T12:00:05.0000 (4521:0x7f..) ERROR AT JStatement::execute /db/shop.fdb (ATT_370201, SHOP_APP:NONE, UTF8, TCPv4:10.0.0.5/50123) C:\Shop\shop.exe:7712 335544665 : violation of PRIMARY or UNIQUE KEY constraint "UK_ITEM"

      Řádek na stránce Errors

      tstmpattIDdb · errTxt 12:00370201/db/shop.fdb ×3 335544665 : violation of PRIMARY or UNIQUE KEY constraint "UK_ITEM" C:\Shop\shop.exe:7712 · 10.0.0.5/50123 · JStatement::execute

      • Stejné chyby — jeden řádekJeden řádek na minutu, databázi a typ chyby, s počtem ×N. Nápověda zobrazuje první a poslední čas a počet připojení.
      • FiltryInclude a Exclude podle textu, databáze, programu, adresy a funkce. Kliknutím na program nebo adresu zobrazíte pouze jejich chyby.
      • Export CSVVšechny řádky s použitými filtry, v UTF-8 s BOM: Excel otevře soubor rovnou ve sloupcích.
      • Pokud chybí programMnoho ovladačů JDBC a .NET neposílá název programu. Řádek klienta je pak kratší.

      trace_monitor_conflicts · find_deadlocks

      Konflikty a deadlocky

      Chyba „update conflicts with concurrent update“ sama o sobě mnoho neřekne. Potřebujete vědět, co dělala druhá transakce. Proto agent udržuje druhou trace relaci nastavenou na změny dat a chyby. Každých 15 minut hledá konflikty a sestavuje zprávu.

      Transakce 1001 změnila záznam; 1002 se pokusí změnit stejný záznam a dostane chybu; report najde dotazy transakce 1001 podle jejího čísla

      Jak číst report

      Vlevo je seznam minut s konflikty. Každá skupina je jedna transakce, která způsobila konflikty: číslo transakce a čas chyby.

      Levý sloupec zobrazuje chyby: připojení, program, kódy Firebird a dotaz, který selhal. Pravý sloupec zobrazuje úspěšné dotazy konkurenční transakce: čas, připojení, číslo transakce, program. Každý dotaz má své SQL, parametry, statistiky a tabulky.

      Adresa stránky uchovává datum a minutu. Odkaz můžete poslat kolegovi.

      Stránka konfliktů. Minuty vlevo, skupina transakce vpravo: proces a kódy chyb.
      ParametrVýchozíVýznam
      Hledání konfliktůkaždých 15 minutPoslední minuta se přeskakuje: trace ji ještě zapisuje.
      Hloubka hledání3 hodinyKolik historie před konfliktem projít při hledání dotazů druhé transakce.
      Uchovávání surového trace6 hodinSurové soubory relace konfliktu se na serveru nehromadí. Reporty se uchovávají a odesílají do HQ Monitor.

      gstat · indexy · metadata

      Jak se databáze mění

      Jednou denně agent pořídí úplné statistiky gstat. HQ Monitor soubor zpracuje: velikost tabulek a indexů, verze záznamů, BLOBy, hloubku indexů. Záložka „Analýza a doporučení“ říká, co je špatně a co s tím dělat.

      Analýza a doporučení. Problém, počet případů, související objekty, doporučení a akce.
      Trendy. Porovnání nejnovějších snímků: co narostlo a kdy objekt naroste o 25 %.
      ZáložkaCo dává vývojáři
      TabulkyVelikost dat, indexů a BLOBů, počet záznamů, verze záznamů a maximální počet verzí jednoho záznamu.
      IndexyHloubka, stránky, unikátní hodnoty, duplicity. Hloubka 4 je žlutý řádek, 5 a více je červený.
      Dotazy a odkazyKteré dotazy čtou tabulku nebo index. Data z reportů výkonu časově blízkých snímku.
      TrendyPorovnání 5, 10, 20 nebo 30 snímků; práh změny 10 %, 2 % nebo 0,5 %. Prognóza „+25 %“ ze tří a více snímků.
      ExportJSON s měřeními a Excel s úplnou analýzou.
      • Statistiky indexůVe výchozím nastavení vypnuto; zapnete v nastavení agenta. Poté agent každých 6 hodin spočítá neaktivní indexy a indexy se špatnou selektivitou. Index, který nebyl po obnově vytvořen, je v reportu stavu závažný problém.
      • Prognóza růstuŠtítek „+25 %“ v tabulce databáze ukazuje nejrychleji rostoucí tabulku nebo index a otevírá prognózu.
      • Export schématuAgent exportuje metadata databáze pomocí isql -x a uchovává archivy podle data.
      • Sledování metadatVe výchozím nastavení vypnuto; zapnete v nastavení agenta. Každých 6 hodin agent porovná nový export schématu s předchozím a zaznamená, kdy se schéma změnilo.

      LWM · MON$ · klienti

      Připojení: dlouhé transakce a verze klientů

      Jedna zapomenutá transakce zpomalí celou databázi: hromadí se verze záznamů a garbage collection se zastaví.

      Každou minutu agent zapisuje čítače transakcí a data připojení. Na grafu databáze Next − OAT roste, pokud transakce zůstává dlouho otevřená. Tabulka připojení pro danou minutu, seřazená podle Act.Tran, ukazuje program, adresu a proces, který transakci drží. Více o čítačích je na stránce stavu serveru.

      Jednou denně agent zjistí, které klientské knihovny se připojují k databázi a kolik připojení každá má. Řádek „Nezjištěno. Stará verze?“ obvykle znamená starou klientskou knihovnu.

      Verze klientů. Řetězec verze z klienta a počet připojení. Vlastní připojení agenta se zobrazují jako samostatný řádek.
      • Metriky MON$Jednou za hodinu: paměť podle programu, 5 připojení s největší pamětí a 5 s nejvyšší zátěží.
      • Staří klienti bez falešných poplachůZjištění „staří klienti“ počítá pouze knihovny fbclient. Ovladače, které pracují bez fbclient, se do něj nepočítají.
      • Dlouhé transakce v reportuReport stavu označuje dlouhé transakce a růst Next − OAT. Zjištění uvádí uživatele, program a adresu a dává připravený příkaz k odpojení.

      Local API · Prometheus · HQbird MCP

      Vaše skripty, CI a AI asistent

      Vše, co vidíte v HQ Monitor, je dostupné z vašich vlastních nástrojů. Local API agenta naslouchá pouze na loopback a každý požadavek nese Bearer token. Náročné úlohy běží asynchronně: odpověď vrátí číslo operace a podle něj čtete stav. Agent zapisuje každý požadavek, který mění server, a každé odmítnutí 401 nebo 403 do auditního logu. Čtecí požadavky se do logu nezapisují.

      # Local API port = 10000 + Firebird port: here Firebird uses 3055, so 13055
      # server status: the same snapshot as in the health report
      curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:13055/v1/status
      # latest performance report and latest conflict report
      curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:13055/v1/artifacts/server/traces/perf-report/latest
      curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:13055/v1/artifacts/server/traces/deadlocks/latest
      # run a backup before a migration in CI and wait for the result
      curl -X POST -H "Authorization: Bearer $TOKEN" -d '{"job_id":"nightly","reason":"before migration"}' \
           http://127.0.0.1:13055/v1/jobs/vbackup/run
      curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:13055/v1/runs/<run_id>
      CestaCo poskytuje
      /v1/statusSnímek stavu serveru, celý nebo po částech, například zálohy.
      /v1/databasesSeznam aktivních databází.
      /v1/artifacts/…Data agenta: LWM (Light-weight Monitoring) po minutách, gstat, statistiky indexů, metriky, nejnovější export schématu, trace reporty.
      /v1/jobs/{job}/runSpuštění úlohy: záloha, obnova, sweep, kontrola databáze, přepočet statistik indexů, SQL skript. Opakování se stejným klíčem úlohu nespustí dvakrát.

      Metriky Prometheus nejdou přes Local API. Mají vlastní adresu: ve výchozím nastavení 127.0.0.1, port 25000 + port Firebird. Mají vlastní Bearer token. Export je ve výchozím nastavení vypnutý; zapnete ho v nastavení agenta. Metriky: LWM, CPU a paměť, disky, limity OS, dočasné soubory.

      AI asistent v IDE

      HQbird MCP propojuje Firebird a data agenta s Claude Code, Cursor, Codex a dalšími MCP klienty. Asistent vidí reporty agenta a pracuje s databází pod lidskou kontrolou: nebezpečné akce potvrzuje člověk.

      Dotaz

      Plán a index

      Plán dotazu a doporučení indexu, s opětovnou kontrolou plánu po vytvoření indexu. Kontrola kompilace dotazu před jeho spuštěním.

      Schéma

      Porovnání dvou databází

      Rozdíly ve schématu a datech, například mezi vývojem a testovacím prostředím.

      Migrace

      Plán, potvrzení, rollback

      Migrace s plánem, jedním potvrzením a plánem rollbacku.

      Více: HQbird MCP

      ← Zpět na přehled HQbird 2027 · Stav serveru podrobně →