HQbird pro vývojáře
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í.
- 1Trace relacefbtracemgr běží neustále; watchdog restartuje ztracenou relaci
- 2Minutový souborkomprimovaný trace výstup jednou za minutu
- 3Minutové součtypro každý dotaz: spuštění, čas, fetches, čtení, zápisy, značky
- 4Zpráva oknado 5 minut po skončení okna; až 20 dotazů v každém žebříčku
- 5✓ HQ MonitorStránka Perf Report; odkaz ze zprávy o stavu
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ávy | Co 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 adresy | Zátěž podle programu a podle adresy klienta: připojení, čas, počet různých plánů a dotazů. |
| Řádek dotazu | Plné SQL, PLAN, parametry a statistiky podle tabulek: natural, index, update, insert, delete, backout, purge, expunge. |
| Deset žebříčků v záložkách | Trvá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 hodin | Kolikrát a jak dlouho dotaz běžel v každé hodině okna. |
| Databáze | Souč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
Řádek na stránce Errors
- 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.
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.
| Parametr | Výchozí | Význam |
|---|---|---|
| Hledání konfliktů | každých 15 minut | Poslední minuta se přeskakuje: trace ji ještě zapisuje. |
| Hloubka hledání | 3 hodiny | Kolik historie před konfliktem projít při hledání dotazů druhé transakce. |
| Uchovávání surového trace | 6 hodin | Surové 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.
| Záložka | Co dává vývojáři |
|---|---|
| Tabulky | Velikost dat, indexů a BLOBů, počet záznamů, verze záznamů a maximální počet verzí jednoho záznamu. |
| Indexy | Hloubka, stránky, unikátní hodnoty, duplicity. Hloubka 4 je žlutý řádek, 5 a více je červený. |
| Dotazy a odkazy | Které dotazy čtou tabulku nebo index. Data z reportů výkonu časově blízkých snímku. |
| Trendy | Porovná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ů. |
| Export | JSON 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 -xa 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.
- 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>
| Cesta | Co poskytuje |
|---|---|
/v1/status | Snímek stavu serveru, celý nebo po částech, například zálohy. |
/v1/databases | Seznam 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}/run | Spuš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.
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.
Porovnání dvou databází
Rozdíly ve schématu a datech, například mezi vývojem a testovacím prostředím.
Plán, potvrzení, rollback
Migrace s plánem, jedním potvrzením a plánem rollbacku.