Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał angielski. English

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ń.

  1. 1Sesja tracefbtracemgr działa cały czas; watchdog restartuje utraconą sesję
  2. 2Plik minutowyskompresowane dane wyjściowe trace raz na minutę
  3. 3Sumy minutowedla każdego zapytania: wykonania, czas, pobrania, odczyty, zapisy, znaczniki
  4. 4Raport oknaw ciągu 5 minut po zakończeniu okna; do 20 zapytań w każdym rankingu
  5. 5✓ HQ Monitorstrona Perf Report; link z raportu kondycji
Trzy okna raportu dziennie: rano 07:00–12:30, dzień 12:31–18:00, noc 18:01–06:59; agent sprawdza okna co 5 min, więc raport pojawia się w ciągu 5 min po zakończeniu okna
Domyślne okna. Rano, dzień i noc. Możesz zmienić okna i ich liczbę w ustawieniach agenta. Minuta bez danych jest pomijana; raport i tak jest budowany.

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 raportuCo pokazuje
      Top SQL według czasu trwaniaNajwolniejsze wykonania: czas i liczba rekordów.
      Top SQL według pobrań, odczytów, zapisówSumy dla okna: wykonania, czas, pobrania, odczyty, zapisy, znaczniki; udział w całym oknie; średnia i maksimum na wykonanie.
      Procesy i adresyObciążenie według programu i adresu klienta: połączenia, czas, liczba różnych planów i zapytań.
      Wiersz zapytaniaPełny SQL, PLAN, parametry i statystyki dla każdej tabeli: natural, index, update, insert, delete, backout, purge, expunge.
      Dziesięć rankingów w kartachCzas trwania, częstotliwość, całkowity czas, pobrania, odczyty, zapisy, plany, tagi, procedury i wyzwalacze. Dla każdej metryki widzisz rozrzut wartości.
      Przykładowe wykonanieKiedy 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 godzinIle razy i jak długo zapytanie działało w każdej godzinie okna.
      Bazy danychSumy 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

      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"

      Wiersz na stronie 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

      • 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.

      Transakcja 1001 zmieniła rekord; 1002 próbuje zmienić ten sam rekord i otrzymuje błąd; raport odnajduje zapytania transakcji 1001 po jej numerze

      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.

      Strona konfliktów. Minuty po lewej, grupa transakcji po prawej: proces i kody błędów.
      ParametrDomyślnieZnaczenie
      Wyszukiwanie konfliktówco 15 minutOstatnia minuta jest pomijana: trace wciąż ją zapisuje.
      Głębokość wyszukiwania3 godzinyIle historii przed konfliktem przeszukać w poszukiwaniu zapytań drugiej transakcji.
      Przechowywanie surowego trace6 godzinSurowe 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ć.

      Analiza i zalecenia. Problem, liczba przypadków, powiązane obiekty, zalecenie i działanie.
      Trendy. Porównanie najnowszych migawek: co urosło i kiedy obiekt urośnie o 25%.
      ZakładkaCo daje programiście
      TabeleRozmiar danych, indeksów i BLOBów, liczba rekordów, wersje rekordów i maksymalne wersje jednego rekordu.
      IndeksyGłębokość, strony, unikalne wartości, duplikaty. Głębokość 4 to żółty wiersz, 5 i więcej to czerwony.
      Zapytania i powiązaniaKtóre zapytania czytają tabelę lub indeks. Dane z raportów wydajności bliskich w czasie migawce.
      TrendyPorównanie 5, 10, 20 lub 30 migawek; próg zmiany 10%, 2% lub 0,5%. Prognoza „+25%” na podstawie trzech lub więcej migawek.
      EksportJSON 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 -x i 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.

      Wersje klientów. Ciąg wersji z klienta i liczba połączeń. Własne połączenia agenta są pokazane jako osobny wiersz.
      • 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żkaCo daje
      /v1/statusMigawka stanu serwera, cała lub według sekcji, na przykład kopie zapasowe.
      /v1/databasesLista 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}/runUruchom 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.

      Zapytanie

      Plan i indeks

      Plan zapytania i porada dotycząca indeksu, z ponownym sprawdzeniem planu po utworzeniu indeksu. Sprawdzenie kompilacji zapytania przed jego uruchomieniem.

      Schemat

      Porównaj dwie bazy danych

      Różnice w schemacie i danych, na przykład między środowiskiem deweloperskim a stanowiskiem testowym.

      Migracja

      Zaplanuj, potwierdź, wycofaj

      Migracja z planem, jednym potwierdzeniem i planem wycofania.

      Więcej: HQbird MCP

      ← Powrót do przeglądu HQbird 2027 · Stan serwera w szczegółach →