HQbird dla programistów
Dla programistów aplikacji
Które zapytanie zoptymalizować najpierw? Który kod spowodował błąd? Kto trzyma rekord w konflikcie? Agent zbiera odpowiedzi z trace i statystyk na samym serwerze. Programista widzi je w przeglądarce i nie loguje się do serwera.
- 1 min pliki trace
- 3 okna dziennie raport wydajności
- według planu grupowanie zapytań
- 15 min wyszukiwanie konfliktów
- REST lokalne API dla skryptów i CI
trace · process_traces · perf report
Raport wydajności
Agent przez cały czas utrzymuje otwartą sesję trace. Co minutę kompresuje dane wyjściowe do pliku i oblicza sumy dla każdego zapytania. Po zakończeniu okna agent łączy minuty w raport: najwolniejsze zapytania i najcięższe pod względem pobrań, odczytów i zapisów. Każde zapytanie pokazuje liczbę wykonań.
- 1Sesja tracefbtracemgr działa cały czas; watchdog restartuje utraconą sesję
- 2Plik minutowyskompresowane dane wyjściowe trace raz na minutę
- 3Sumy minutowedla każdego zapytania: wykonania, czas, pobrania, odczyty, zapisy, znaczniki
- 4Raport oknaw ciągu 5 minut po zakończeniu okna; do 20 zapytań w każdym rankingu
- 5✓ HQ Monitorstrona Perf Report; link z raportu kondycji
Dlaczego grupować według planu
Jeśli program wstawia wartości bezpośrednio do tekstu SQL, każda wartość daje nowy tekst. W jednym rzeczywistym przypadku liczba różnych tekstów wzrosła z 204 do 83 825 na minutę. Tysiące „różnych” zapytań to w rzeczywistości jedno zapytanie z jednym planem. Dlatego domyślnie agent grupuje zapytania według klucza: pierwszych 10 znaków SQL bez komentarzy plus plan wykonania. Zapytanie bez planu zachowuje pełny tekst. Tryb zmieniasz w ustawieniach agenta, pole „Perf group by”: według planu lub według pełnego tekstu SQL. Przy grupowaniu według tekstu pliki i raporty stają się znacznie większe. Przełącz tryb w poniższym przykładzie i porównaj rankingi.
Zapytania w jednej minucie
Ranking według pobrań
| Tabela raportu | Co pokazuje |
|---|---|
| Top SQL według czasu trwania | Najwolniejsze wykonania: czas i liczba rekordów. |
| Top SQL według pobrań, odczytów, zapisów | Sumy dla okna: wykonania, czas, pobrania, odczyty, zapisy, znaczniki; udział w całym oknie; średnia i maksimum na wykonanie. |
| Procesy i adresy | Obciążenie według programu i adresu klienta: połączenia, czas, liczba różnych planów i zapytań. |
| Wiersz zapytania | Pełny SQL, PLAN, parametry i statystyki dla każdej tabeli: natural, index, update, insert, delete, backout, purge, expunge. |
| Dziesięć rankingów w kartach | Czas trwania, częstotliwość, całkowity czas, pobrania, odczyty, zapisy, plany, tagi, procedury i wyzwalacze. Dla każdej metryki widzisz rozrzut wartości. |
| Przykładowe wykonanie | Kiedy się odbyło, który klient i z jakiego adresu, w której bazie danych. Jeśli wykonanie zakończyło się błędem, widzisz go; każde zapytanie ma licznik nieudanych wykonań. |
| Wykonania według godzin | Ile razy i jak długo zapytanie działało w każdej godzinie okna. |
| Bazy danych | Sumy według bazy danych serwera i głównych baz danych każdego zapytania. |
Porównanie, historia i raport na żądanie
Raport okna odpowiada na pytanie „co było dziś ciężkie”. Trzy nowe funkcje odpowiadają na pytania „co się zmieniło” i „co się działo w tej godzinie”.
- Porównywanie dwóch okienDwa raporty obok siebie: które zapytania stały się wolniejsze, które się pojawiły, a które zniknęły.
- Historia zapytania za 30 dniJak zmieniał się czas i liczba wykonań jednego zapytania z okna na okno.
- Filtr według bazy danychRaport tylko dla jednej bazy danych. Link na stronie bazy danych prowadzi do strony raportu.
- Do trace z danej minutyZ zapytania w raporcie do trace z minuty, w której działało.
- Raport na żądaniePrzycisk Build report… buduje raport dla dowolnego zakresu do 24 godzin. Filtry: baza danych, minimalny czas trwania, program. Agent buduje jeden taki raport naraz i przechowuje ostatnie 20.
- Wyszukiwanie i pobieraniePole wyszukiwania tekstu zapytania. Możesz pobrać plik źródłowy raportu.
- Niekompletny raport jest oznaczonyJeśli niektóre pliki trace jeszcze nie dotarły, raport jest oznaczony jako niekompletny. Raport zachowuje tylko czołówkę każdego rankingu, więc strona mówi „nie w rankingu”, a nie „nie działało”.
- Procedury i wyzwalaczeTe rankingi wypełniają się, gdy ustawienia trace włączą logowanie zakończenia procedur i wyzwalaczy. Domyślnie to logowanie jest wyłączone.
- Z raportu kondycjiPrzycisk Perf report otwiera właściwe okno. Wiersze zapytań są oznaczone, a pierwszy jest już rozwinięty.
- Zapytanie i tabelaKarta Queries statystyk gstat łączy zapytania z tabelami i indeksami, które czytają.
- Minuta na wykresie bazy danychKliknięcie minuty pokazuje ciężkie zapytania z trace i wszystkie połączenia z tej minuty.
- Kopiuj SQLZ parametrami lub bez, prosto do własnego narzędzia. W trybie demo przyciski są ukryte.
trace · Errors
Błędy SQL z danymi klienta
Użytkownik mówi „program zgłosił błąd”. Strona Errors pokazuje każdy błąd Firebird z trace: czas, połączenie, bazę danych, tekst i klienta. Znając nazwę programu, adres i funkcję Firebird, łatwo znajdziesz błąd w swoim kodzie.
Blok błędu w trace
Wiersz na stronie Errors
- Te same błędy — jeden wierszJeden wiersz na minutę, bazę danych i typ błędu, z licznikiem ×N. Podpowiedź pokazuje pierwszy i ostatni czas oraz liczbę połączeń.
- FiltryInclude i Exclude według tekstu, bazy danych, programu, adresu i funkcji. Kliknięcie programu lub adresu pozostawia tylko jego błędy.
- Eksport CSVWszystkie wiersze z zastosowanymi filtrami, w UTF-8 z BOM: Excel od razu otwiera plik w kolumnach.
- Jeśli nie ma programuWiele sterowników JDBC i .NET nie wysyła nazwy programu. Wtedy wiersz klienta jest krótszy.
trace_monitor_conflicts · find_deadlocks
Konflikty i zakleszczenia
Błąd „update conflicts with concurrent update” sam niewiele mówi. Musisz wiedzieć, co zrobiła druga transakcja. W tym celu agent utrzymuje drugą sesję trace skonfigurowaną pod zmiany danych i błędy. Co 15 minut szuka konfliktów i buduje raport.
Jak czytać raport
Po lewej stronie znajduje się lista minut z konfliktami. Każda grupa to jedna transakcja, która spowodowała konflikty: numer transakcji i czas błędu.
Lewa kolumna pokazuje błędy: połączenie, program, kody Firebird i zapytanie, które zakończyło się niepowodzeniem. Prawa kolumna pokazuje udane zapytania konkurencyjnej transakcji: czas, połączenie, numer transakcji, program. Każde zapytanie ma swój SQL, parametry, statystyki i tabele.
Adres strony zawiera datę i minutę. Możesz wysłać link współpracownikowi.
| Parametr | Domyślnie | Znaczenie |
|---|---|---|
| Wyszukiwanie konfliktów | co 15 minut | Ostatnia minuta jest pomijana: trace wciąż ją zapisuje. |
| Głębokość wyszukiwania | 3 godziny | Ile historii przed konfliktem przeszukać w poszukiwaniu zapytań drugiej transakcji. |
| Przechowywanie surowego trace | 6 godzin | Surowe pliki sesji konfliktu nie gromadzą się na serwerze. Raporty są przechowywane i wysyłane do HQ Monitor. |
gstat · indeksy · metadane
Jak zmienia się baza danych
Raz dziennie agent pobiera pełne statystyki gstat. HQ Monitor analizuje plik: rozmiar tabel i indeksów, wersje rekordów, BLOBy, głębokość indeksów. Zakładka „Analiza i zalecenia” mówi, co jest nie tak i co zrobić.
| Zakładka | Co daje programiście |
|---|---|
| Tabele | Rozmiar danych, indeksów i BLOBów, liczba rekordów, wersje rekordów i maksymalne wersje jednego rekordu. |
| Indeksy | Głębokość, strony, unikalne wartości, duplikaty. Głębokość 4 to żółty wiersz, 5 i więcej to czerwony. |
| Zapytania i powiązania | Które zapytania czytają tabelę lub indeks. Dane z raportów wydajności bliskich w czasie migawce. |
| Trendy | Porównanie 5, 10, 20 lub 30 migawek; próg zmiany 10%, 2% lub 0,5%. Prognoza „+25%” na podstawie trzech lub więcej migawek. |
| Eksport | JSON z pomiarami i Excel z pełną analizą. |
- Statystyki indeksówDomyślnie wyłączone; włączasz je w ustawieniach agenta. Wtedy co 6 godzin agent zlicza nieaktywne indeksy i indeksy o słabej selektywności. Indeks nieodbudowany po przywróceniu jest poważnym problemem w raporcie kondycji.
- Prognoza wzrostuZnacznik „+25%” w tabeli bazy danych pokazuje najszybciej rosnącą tabelę lub indeks i otwiera prognozę.
- Eksport schematuAgent eksportuje metadane bazy danych za pomocą
isql -xi przechowuje archiwa według daty. - Śledzenie metadanychDomyślnie wyłączone; włączasz je w ustawieniach agenta. Co 6 godzin agent porównuje nowy eksport schematu z poprzednim i zapisuje, kiedy schemat się zmienił.
LWM · MON$ · klienci
Połączenia: długie transakcje i wersje klientów
Jedna zapomniana transakcja spowalnia całą bazę danych: wersje rekordów się gromadzą, a zbieranie śmieci zatrzymuje się.
Co minutę agent zapisuje liczniki transakcji i dane połączeń. Na wykresie bazy danych Next − OAT rośnie, jeśli transakcja pozostaje otwarta przez długi czas. Tabela połączeń dla tej minuty, posortowana według Act.Tran, pokazuje program, adres i proces, który utrzymuje transakcję. Więcej o licznikach na stronie kondycji serwera.
Raz dziennie agent odczytuje, które biblioteki klienta łączą się z bazą danych i ile połączeń ma każda z nich. Wiersz „Nie wykryto. Stara wersja?” zwykle oznacza starą bibliotekę klienta.
- Metryki MON$Raz na godzinę: pamięć według programu, 5 połączeń z największą pamięcią i 5 z największym obciążeniem.
- Starzy klienci bez fałszywych alarmówWykrycie „starych klientów” liczy tylko biblioteki fbclient. Sterowniki działające bez fbclient nie są w nim liczone.
- Długie transakcje w raporcieRaport kondycji oznacza długie transakcje i wzrost Next − OAT. Wykrycie podaje użytkownika, program i adres oraz gotowe polecenie rozłączenia.
Local API · Prometheus · HQbird MCP
Twoje skrypty, CI i asystent AI
Wszystko, co widzisz w HQ Monitor, jest dostępne z Twoich własnych narzędzi. Local API agenta nasłuchuje tylko na interfejsie loopback, a każde żądanie zawiera token Bearer. Ciężkie zadania działają asynchronicznie: odpowiedź podaje numer operacji, a status odczytujesz po nim. Agent zapisuje w dzienniku audytu każde żądanie zmieniające serwer oraz każdą odmowę 401 lub 403. Żądania odczytu nie trafiają do dziennika.
# 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>
| Ścieżka | Co daje |
|---|---|
/v1/status | Migawka stanu serwera, cała lub według sekcji, na przykład kopie zapasowe. |
/v1/databases | Lista aktywnych baz danych. |
/v1/artifacts/… | Dane agenta: LWM (Light-weight Monitoring) na minutę, gstat, statystyki indeksów, metryki, najnowszy eksport schematu, raporty trace. |
/v1/jobs/{job}/run | Uruchom zadanie: kopia zapasowa, przywrócenie, sweep, sprawdzenie bazy danych, ponowne obliczenie statystyk indeksów, skrypt SQL. Powtórzenie z tym samym kluczem nie uruchamia zadania dwa razy. |
Metryki Prometheus nie przechodzą przez Local API. Mają własny adres: domyślnie 127.0.0.1, port 25000 + port Firebird. Mają własny token Bearer. Eksport jest domyślnie wyłączony; włączasz go w ustawieniach agenta. Metryki: LWM, CPU i pamięć, dyski, limity systemu operacyjnego, pliki tymczasowe.
Asystent AI w IDE
HQbird MCP łączy Firebird i dane agenta z Claude Code, Cursor, Codex i innymi klientami MCP. Asystent widzi raporty agenta i pracuje z bazą danych pod kontrolą człowieka: osoba potwierdza niebezpieczne działania.
Plan i indeks
Plan zapytania i porada dotycząca indeksu, z ponownym sprawdzeniem planu po utworzeniu indeksu. Sprawdzenie kompilacji zapytania przed jego uruchomieniem.
Porównaj dwie bazy danych
Różnice w schemacie i danych, na przykład między środowiskiem deweloperskim a stanowiskiem testowym.
Zaplanuj, potwierdź, wycofaj
Migracja z planem, jednym potwierdzeniem i planem wycofania.
← Powrót do przeglądu HQbird 2027 · Stan serwera w szczegółach →