¶ DBTrace
DBTrace - утилита для запуска трассировки Firebird и формирования простых отчетов по trace-логу.
Программа рассчитана на обычную рабочую схему: выбрать Firebird, добавить одну или несколько баз, запустить трассировку, остановить ее и построить отчеты по полученному логу.
Билд можно найти по следующему пути
\\\Secure FTP\Share42\Agbis\_NonVersion\
¶ Для чего нужна программа
DBTrace помогает собрать trace-лог Firebird без ручной работы с командной строкой fbtracemgr.
С помощью программы можно:
- запустить трассировку по одной или нескольким базам;
- выбрать, какие события нужно писать в trace-лог;
- остановить трассировку;
- сохранить trace-лог с понятным именем;
- построить отчеты по выбранному trace-логу;
- отдельно получить отчет по медленным SQL-запросам от указанного времени.
¶ Первый запуск
При запуске DBTrace автоматически ищет установленные Firebird и показывает найденные варианты в верхней части формы.
Сервер всегда используется локальный: 127.0.0.1.
Пользователь и пароль используются стандартные:
- пользователь:
SYSDBA; - пароль:
masterkey.
Нужно лишь найти нужный Firebird из списка, порт подставляется автоматически.
¶ Выбор Firebird
Если на компьютере найдено несколько Firebird, выберите нужный вариант в поле Firebird.
Обычно выбирать нужно тот Firebird, который обслуживает нужную базу и работает на указанном порту.
Если порт отличается от показанного, укажите нужный порт вручную.
¶ Добавление базы
- Откройте вкладку
Базы. - Нажмите
Добавить. - Выберите появившуюся базу в списке слева.
- Нажмите
Выбрать. - Укажите файл базы, например
E:\Agbis\DB\ARM.FDB.
Пока база не выбрана слева, правая часть формы не предназначена для заполнения. Если попытаться редактировать параметры без выбранной базы, программа покажет предупреждение.
¶ Настройки трассировки базы
Для каждой базы можно включить или отключить набор событий.
¶ Что трассировать
SQL- пишет SQL-запросы.Транзакции- пишет начало и завершение транзакций.Соединения- пишет подключения и отключения.Процедуры- пишет выполнение процедур.Триггеры- пишет выполнение триггеров.
¶ Что показывать
Ошибки- пишет ошибки Firebird.Предупреждения- пишет предупреждения Firebird.
¶ Медленные SQL от, мс
Поле задает порог времени для SQL-запросов.
Например, если указать 1000, то в отчет по медленным SQL попадут запросы от 1000 мс и дольше.
¶ Несколько баз в одной трассировке
Один запуск трассировки может включать несколько баз.
Для этого добавьте несколько баз в список слева и настройте каждую отдельно.
Чтобы временно исключить базу из трассировки, снимите галочку Включить базу.
¶ Запуск трассировки
Перед запуском проверьте:
- выбран правильный Firebird;
- указан правильный порт;
- добавлена хотя бы одна база;
- у базы заполнен путь к файлу;
- база включена галочкой
Включить базу.
Для запуска нажмите Старт.
После запуска программа создает trace-лог в папке Temp\trace_log.
Имя активного лога выглядит так:
ARM_trace_20260703_142133.log
В имени указаны:
- имя базы;
- слово
trace; - дата и время старта трассировки.
¶ Работа при активной трассировке
Если трассировка запущена и закрыть окно крестиком, программа не завершится, а свернется в трей.
Это нужно, чтобы случайно не остановить сбор trace-лога.
Чтобы вернуть окно из трея, дважды нажмите на значок программы в области уведомлений Windows.
Если трассировка не запущена, крестик закрывает программу полностью.
¶ Остановка трассировки
Для остановки нажмите Стоп.
После остановки активный лог переименовывается: к имени добавляется дата и время остановки.
Пример имени закрытого trace-лога:
ARM_trace_20260703_142133__20260703_142845.log
В имени указаны:
- имя базы;
- дата и время старта;
- дата и время остановки.
¶ Где хранятся trace-логи
Trace-логи хранятся рядом с программой в папке:
Temp\trace_log
Новые и еще не обработанные логи лежат прямо в этой папке.
После построения отчетов выбранный лог переносится в отдельную папку отчета и больше не показывается в списке доступных логов.
¶ Построение отчетов
- Откройте вкладку
Отчеты. - Выберите trace-лог в поле
Лог. - Укажите порог
SQL от, мс. - Нажмите
Сформировать.
После этого программа:
- переносит выбранный trace-лог в папку отчета;
- строит сводный отчет;
- строит отчет по ошибкам;
- строит отчет по медленным SQL;
- показывает результат на вкладке
Отчеты.
¶ Папка отчета
Папка отчета создается внутри:
Temp\trace_log
Название папки:
trace_дата_старта_дата_стопа
Пример:
trace_20260703_142133_20260703_142845
Внутри папки лежат:
- исходный trace-лог;
summary.txt- сводный отчет;errors.txt- ошибки и предупреждения;slow_sql.txt- медленные SQL-запросы.
¶ Что делать, если лог не появился
Проверьте:
- правильно ли выбран Firebird;
- совпадает ли порт;
- существует ли файл базы;
- нажата ли галочка
Включить базу; - выполнялись ли действия в базе после старта трассировки.
Если trace-сессия запустилась, но в базе ничего не происходило, лог может быть пустым или почти пустым.
¶ Что делать, если программа сообщает об ошибке Firebird
Чаще всего ошибка связана с:
- неправильным портом Firebird;
- выбран не тот Firebird;
- база не обслуживается выбранным Firebird;
- нет доступа к файлу базы;
- старый процесс трассировки еще не завершился.
При следующем запуске DBTrace автоматически убирает зависшие процессы fbtracemgr.exe, если они остались после прошлой трассировки.
¶ Краткий рабочий сценарий
- Запустить DBTrace.
- Проверить порт и Firebird.
- Добавить базу.
- Выбрать события трассировки.
- Нажать
Старт. - Выполнить нужные действия в программе, которую диагностируем.
- Нажать
Стоп. - Открыть вкладку
Отчеты. - Выбрать лог.
- Указать
SQL от, мс. - Нажать
Сформировать. - Открыть созданную папку отчета в
Temp\trace_log.