¶ Короткая инструкция по DBTrace
Если DBTrace нужно запустить прямо сейчас, выполните следующие действия:
- Запустите
DBTrace.exeна компьютере, где работает нужный Firebird. - В верхней части окна выберите нужную установку Firebird. Проверьте порт.
- На вкладке
Базыдобавьте файл нужной базы и включите его флажком. - Нажмите
Рекомендавнные настройки. - Нажмите
Старт. - Не закрывайте DBTrace и работайте в программе как обычно, пока проблема не проявится.
- Запишите точное время проблемы, имя пользователя, компьютер и выполненное действие.
- После проявления проблемы нажмите
Стоп. - На вкладке
Отчетывыберите полученный лог и нажмитеСформировать. - Передайте программисту всю созданную папку отчета и записанные сведения о проблеме.
Если проблема возникает редко, трассировку следует запустить до начала рабочего дня и остановить только после того, как проблема повторилась. Лог, начатый после зависания или ошибки, не содержит причины уже произошедшего события.
¶ Что подготовить перед длительным сбором
Перед началом проверьте несколько простых вещей:
- DBTrace запущен на компьютере, где установлен нужный сервер Firebird;
- выбрана именно та база, с которой работает проблемная программа;
- на диске рядом с DBTrace достаточно свободного места;
- на этом компьютере не запущена вторая копия DBTrace для той же задачи;
- сотрудник знает, куда записать время и описание проблемы.
Размер лога заранее предсказать нельзя. Он зависит не только от длительности, но и от активности базы, количества пользователей, процедур и триггеров. При длительном сборе периодически контролируйте свободное место на диске. Не удаляйте и не перемещайте активный .log во время трассировки.
¶ Что обязательно записать при проявлении проблемы
Сам по себе большой лог не всегда позволяет быстро найти нужный момент. Вместе с ним программисту нужны ориентиры:
- точная дата и время проблемы, желательно до минуты или секунды;
- имя пользователя;
- имя компьютера или рабочего места;
- база и программа, в которой выполнялась операция;
- последовательность действий перед проблемой;
- текст ошибки или снимок экрана;
- завершилась ли операция сама, была отменена или программа осталась висеть.
Пример полезной записи:
20.08.2026, примерно 16:53:40
Пользователь: Иванова
Компьютер: ARM-107
Открыла документ 12547, изменила сумму и нажала «Провести».
Программа не отвечала около 40 секунд, затем операция завершилась.
Фраза «где-то днем программа висела» почти не помогает найти событие в многочасовом логе.
¶ Если не знаете, какие настройки выбрать
Это основной и рекомендуемый способ работы с DBTrace. Он предназначен именно для ситуации, когда сотрудник знает только симптом — например, «программа зависла», «документ проводится очень долго» или «иногда появляется ошибка» — но не знает техническую причину.
Для обычной передачи диагностики программисту не нужно разбираться во всех параметрах Firebird Trace.
- Добавьте нужные базы и оставьте у них флажок
Включить базу. - Выберите пресет
Рекомендуемые настройки. - Нажмите
Старти убедитесь, что строка состояния сообщает о работающей трассировке. - Оставьте DBTrace работать до проявления проблемы.
- Когда проблема проявится, запишите ее время и действия пользователя.
- Нажмите
Стопи передайте сформированную папку отчета.
Кнопка применяет рекомендуемый профиль сразу ко всем включенным базам. Отключенные базы она не меняет.
Рекомендуемый сбор включает:
- ошибки и предупреждения;
- начало и завершение SQL;
- процедуры, функции и триггеры;
- обычные планы SQL;
- показатели производительности и время завершенных событий;
- полный текст SQL до 32768 символов, аргументы до 1024 символов и до 128 аргументов.
Порог времени устанавливается в 5000, а ограничения по ID соединения, регулярным выражениям и кодам GDS очищаются. Это принципиально для зависаний: запрос, который начался и не завершился, имеет событие EXECUTE_STATEMENT_START, но еще не имеет времени выполнения и события FINISH. Высокий порог или узкий фильтр может скрыть именно такой запрос.
¶ Почему в рекомендуемом пресете порог равен 5000
5000 означает, что запрос выполнялся от 5 секунт. Firebird будет записывать медленные события, которые выполняются от заданного времени и выше.
Надо иметь ввиду, что:
- заранее неизвестно, какая операция окажется причиной проблемы;
- зависший запрос еще не завершен, поэтому у него пока нет итогового времени выполнения.
Например, пользователь нажал кнопку в 15:10:00, после чего программа зависла. В логе может остаться событие начала запроса в 15:10:00, но не будет события завершения. Если собирать только завершенные запросы от 1000 мс, главный подозреваемый может не попасть в лог.
¶ Что рекомендуемый пресет намеренно не включает
Подробный план, подготовка/освобождение SQL и изменение контекста в рекомендуемый сбор не входят. Эти события резко увеличивают лог и обычно не нужны для первого анализа.
Это не делает рекомендуемый пресет «неполным». Он подобран для длительного первичного сбора: сохранить полезный контекст и при этом не раздувать лог еще сильнее событиями, которые нужны только при специальном исследовании разработчиком.
¶ Когда не нужно менять рекомендуемый пресет
Не меняйте его самостоятельно, если:
- причина проблемы неизвестна;
- проблема возникает редко;
- трассировка должна работать несколько часов или весь день;
- разработчик не дал конкретный ID соединения, SQL-фильтр или другой профиль;
- нужно собрать материал, достаточный для первого анализа.
Выбирать другой профиль следует только по прямой просьбе разработчика или в очевидном узком сценарии.