HQbird 2027
HQbird 2027
Всё о сервере Firebird на одном экране. Бэкапы, проверенные восстановлением. Один центр мониторинга для всех серверов. Репликация и AI-ассистент, где опасные действия подтверждает человек.
- Firebird 5 · 4 · 3 · 2.5
- Windows и Linux x86-64
- 100% совместимость с Firebird
- Требования к серверу: от 2 ГБ RAM · от 2 ядер · от 5 ГБ диска
- 0 входящих портов для связи с центром
Коротко
Четыре главные идеи
Без необходимости открывать консоль сервера
Полная диагностика Firebird и ОС. Один сервер или группа серверов в одном интерфейсе, локально или в HQCenter.
Все серверы в одном месте
Для связи с центром входящие порты на серверах БД не нужны. Агенты сами берут из HQCenter новые версии Firebird и инструментов HQbird и ставят их с возможностью отката на предыдущую версию.
Репликация на нескольких узлах
Мастера, реплики, отставание и проверка данных в одном интерфейсе. Мастер переходит на другой хост без потери данных, а приложения не меняют строку подключения.
AI-ассистент под контролем человека
Работает с AI-чатами и автономными AI-агентами. Операции разделены по уровню опасности. Каждое изменение подтверждает человек. Опасные операции подтверждаются только на сервере, по второму каналу, не через чат: командой fbmcp ctl approve или, на Windows, в окне в трее.
Расширенные возможности уровня сервера
Все- Лёгкий мониторинг (LWM, Light-weight Monitoring)Производительность всех баз сервера каждую минуту, без нагрузки. Плагин fblwmon.
- Конфликты обновления и deadlockОтдельная трассировка ловит конфликты при выполнении SQL.
- Реинициализация реплики под нагрузкойМастер не останавливается. Копия базы для реплики делается автоматически, с проверкой места и длинных транзакций. В vanilla Firebird это ручная работа.
- Switchover и failoverПлановый перенос мастера на другой хост без потери данных. Аварийный перенос вручную или по правилу. Роутер ведёт приложения на текущий мастер. В vanilla Firebird это ручная работа.
- NGram-индексДля
WHERE … LIKE '%found%'в Firebird 5 HQbird. - Экспорт метрик в PrometheusМетрики Firebird и сервера в вашей Grafana.
Новое в интерфейсе
- Вся производительность на одном экранеCPU, память, диски общие и Firebird отдельно, где лежат базы и временные файлы. Метрики Firebird сразу по всем базам.
- Общий инвентарь бэкаповВсе бэкапы сервера, и сделанные другими программами. Находит потерянные копии баз и бэкапов.
Состав
- fbagent
- Агент на сервере Firebird: бэкапы, обслуживание, метрики, трассы.
- HQ Monitor
- Веб-консоль. Один сервер локально или много серверов в центре.
- HQCenter
- Центр управления парком серверов.
- HQbird Cluster
- Репликация: узлы и менеджер кластера (RCM).
- HQbird MCP
- MCP-сервер для AI-ассистентов.
DBA получает
- Бэкап, проверенный восстановлением; сразу в S3, со сжатием.
- Ежедневный отчёт о здоровье сервера; действие запускается прямо из отчёта.
- Обновление Firebird с проверкой и автоматическим откатом.
- Ответ на вопрос «кто грузит диск, CPU и память».
Разработчик получает
- Самые дорогие запросы, сгруппированные по плану.
- Ошибки SQL с приложением, адресом и функцией Firebird.
- Конфликты и deadlock при выполнении SQL.
- AI-ассистент в IDE: план запроса, совет по индексу, миграции.
Руководитель ИТ получает
- Один центр мониторинга для всего парка; для связи с ним входящие порты не нужны.
- Удалённые настройки со статусом доставки; обновления с автоматическим откатом.
- Репликацию Firebird 4 и 5 и HQbird 2.5 и 3.0 с контролем отставания.
- Права по серверам и журнал аудита.
Подробно
Группы возможностей
Девять групп: что делает HQbird и чем это полезно. Скриншоты взяты из руководств пользователя HQ Monitor и HQbird RCM. Имена серверов и баз скрыты demo-режимом.
Бэкап полезен, только если он восстанавливается. Включите в задании gbak тестовое восстановление, и агент будет восстанавливать каждый новый бэкап и записывать результат в историю задания. Если восстановление не прошло, вы увидите это в тот же день, а не в день аварии. Для nbackup есть отдельное задание восстановления.
Бэкап может идти сразу в S3, без промежуточного файла на диске сервера. Копии в S3, FTP и FTPS делает отдельное задание file_sync. Сжатие zip, gz или zstd; архив zip бэкапа gbak можно зашифровать (AES-256). Исходный файл удаляется только после проверки архива. Старые копии удаляются по правилам хранения для каждого уровня nbackup.
- 1gbak или nbackupпо расписанию; одна база или все базы по указанным путям
- 2Тестовое восстановлениеопция задания gbak; бэкап реально восстанавливается
- 3Сжатиеzip, gz, zstd; исходный файл удаляется после проверки
- 4Хранилищепапка или поток в S3; копии в S3 и FTP/FTPS делает file_sync
- 5✓ Проверенорезультат в истории задания и в отчёте о здоровье
Replace cycle: база обновляется из бэкапа
Большая база со временем фрагментируется и копит «мусор». Replace cycle делает бэкап, восстанавливает его в промежуточный файл и заменяет рабочую базу. По расписанию, без ручной ночной работы.
Рабочая база отключается безопасно: агент переводит её в shutdown, все соединения закрываются, и только потом файл переименовывается. Перед заменой агент проверяет размер восстановленной базы. Опасные ключи gbak запрещены. До и после цикла можно выполнить свои скрипты.
Если цикл прерван сбоем питания или перезапуском, агент сам откатывает или завершает его. Если нужен человек, исход так и называется: operator needed.
- Групповые заданияВсе базы по указанным путям, с подкаталогами или без, одним заданием. Если у базы есть своё задание того же вида (gbak или nbackup), группа её не копирует.
- Многоуровневый nbackupУровни 0…4 по простому расписанию, cron или плану. План виден в календаре редактора. Хранение по уровням или целыми циклами.
- ИнвентарьВсе файлы бэкапов, включая сделанные другими средствами. Видно, у какой базы нет свежей копии.
- Логи gbak в консолиПоследние строки лога и история запущенных команд видны в задании. Файл на сервере искать не нужно.
- Восстановление из S3Формат архива определяется сам, локально и из S3.
- Защита от перегрузкиОдна тяжёлая операция на базу за раз. Если база занята, gbak ждёт до 60 минут.
Каждые 10 минут агент собирает снимок состояния сервера: CPU, память, диски, лимиты ОС, firebird.log, транзакции, блокировки, запросы, бэкапы и репликацию. Отчёт о здоровье показывает это как матрицу за 24 часа, 7 или 14 дней. Красная клетка сразу говорит, где и когда была проблема.
Каждая находка объясняет причину и даёт подсказку. Рядом есть кнопка, которая открывает нужное задание или запускает его. От «нашёл» до «исправил» один экран.
- 1Находка«у базы нет свежего бэкапа»
- 2Подсказкачто настроить, с порогом и значением
- 3Кнопка действия«Добавить задачу nbackup»
- 4Run nowзапуск из консоли и ход выполнения; запуск в очереди можно отменить
- 5✓ Исправленоследующий снимок зелёный
Кто грузит сервер: Firebird или другая программа
Медленная база часто страдает не из-за Firebird. Антивирус, бэкап другой программы или соседняя служба занимают диск и CPU. HQ Monitor показывает нагрузку по программам и службам: чтение и запись, CPU, память.
Для дисков видны задержки чтения и записи, IOPS и «зависания» диска. Отдельно для диска с базами и для диска с временными файлами Firebird.
- Лёгкий мониторинг (LWM, Light-weight Monitoring)Соединения, транзакции, чтения и записи каждую минуту, без трассы.
- ТранзакцииРазрыв OIT/OAT/OST и длинные транзакции: сигнал до того, как база начнёт тормозить.
- Состояние из заголовка базыShutdown, read-only, sweep, режим nbackup. Сборщики метрик не подключаются к базе в shutdown.
- gstat с трендами и прогнозомРост таблиц и индексов, выгрузка в XLSX.
- Лимиты LinuxTasksMax, NPROC, NOFILE, OOM, threads-max. Частая причина «Firebird упал под нагрузкой» видна до аварии.
- Свободное место и temp-файлыПредупреждение до того, как закончится диск.
- firebird.log и replication.logС фильтрами, в одной консоли для всех серверов. Ошибки создания потоков и удалённые lock-файлы выделены.
- История конфиговВерсии firebird.conf, databases.conf, replication.conf и сравнение.
- Prometheus / GrafanaЭкспорт метрик в существующий мониторинг.
Sweep, пересчёт статистики индексов, проверка gfix и ваши SQL-скрипты идут по расписанию. Для sweep и SQL-скриптов можно задать окно обслуживания. По умолчанию окно есть у группового sweep (00:15–01:15) и у SQL-скриптов (03:00–04:00). На одной базе одновременно идёт только одна тяжёлая операция. Sweep, проверка gfix и пересчёт индексов пропускают занятую базу до следующего запуска.
Обновление Firebird тоже стало обычной операцией. Агент ждёт окна обновления и конца других заданий (gbak, nbackup, скрипты). Затем он останавливает Firebird, заменяет файлы и проверяет движок. Прежние файлы лежат в бэкапе обновления. Если проверка не прошла, агент сам возвращает прежнюю версию.
- 1Окно обновленияобновление только в разрешённое время
- 2Ожидание заданийgbak, nbackup и SQL-скрипты завершаются
- 3Замена файловFirebird остановлен; прежние файлы идут в бэкап обновления
- 4ПроверкаFirebird запущен и отвечает
- 5✓ Готовоили автоматический откат
Сборка, после которой на этом сервере был откат, блокируется. Агент не ставит её снова, пока блок не снимут.
- Run nowБэкап, восстановление, sweep или проверка одной кнопкой, локально или удалённо. Виден ход выполнения. Запуск в очереди или в ожидании можно отменить.
- Тест производительности сервераБазовая линия до и после смены железа, диска или настроек.
- Редактор databases.confДерево алиасов, проверка параметров по версии движка, подсказка при опечатке, бэкап перед сохранением. Из центра: доставка с ответом агента; правка в форме не трогает комментарии.
- Перенос с FBDataGuardНастройки старого HQbird импортируются автоматически.
- Переход с Firebird из пакетов ОСУстановщик находит Firebird из apt или dnf и печатает команды перехода. Пользователи и алиасы переносятся в HQbird.
- Изменения без перезапускаНовые настройки проверяются; при ошибке агент возвращает прежние.
Разработчику не нужен доступ к серверу, чтобы понять, какой запрос оптимизировать первым. Отчёт производительности собирается из трассы и группирует запросы по плану. Запросы можно сортировать по длительности, fetches, reads и writes.
Ошибка SQL приходит вместе с именем приложения, IP-адресом и функцией Firebird, в которой она возникла. Для конфликта обновления и deadlock при выполнении SQL показаны операторы обеих сторон. Их ловит отдельная трассировка. Она пишет все изменяющие операторы, поэтому даёт свою нагрузку.
Как меняется база
gstat снимается по расписанию. Отчёт трендов сравнивает снимки и показывает, какие таблицы и индексы растут быстрее всего, и делает прогноз. Статистика индексов находит неактивные индексы и индексы с плохой селективностью. Какие запросы читают индекс, показывает вкладка «Связи» отчёта gstat.
Отслеживание метаданных по умолчанию выключено и включается в настройках. Каждые 6 часов агент сравнивает новую выгрузку схемы с предыдущей и записывает, когда схема изменилась.
- Длинные транзакцииКакое соединение держит транзакцию и мешает сборке мусора.
- Версии клиентовКакие версии fbclient и драйверов подключаются к базе.
- Отчёт производительности: сравнение и история новоеДесять рейтингов запросов, процедуры и триггеры, запуски по часам. Сравнение двух периодов и история одного запроса за 30 дней.
- Отчёт по запросу новоеКнопка «Build report…» строит отчёт за любой период до 24 часов, с фильтрами по базе, длительности и программе.
- Local API (REST)Статус, метрики и запуск заданий из своих скриптов и CI.
- AI-ассистент в IDEЧерез HQbird MCP: план запроса, совет по индексу, сравнение схем, миграции прямо из Cursor или Claude Code.
Агент сам отправляет данные в центр по исходящему HTTPS. Для связи с центром входящие порты на серверах БД не нужны, весь трафик идёт в mTLS. Это работает и для серверов клиентов за NAT и межсетевыми экранами.
Настройки меняются из центра. Агент забирает новую конфигурацию, проверяет её и отвечает. Для каждого изменения виден статус доставки и причина отказа. Перед заменой настроек агент сохраняет копию прежних.
- 1Изменение в консолиформа задания или настройки
- 2ОТПРАВЛЕНОсохранено в центре, агент ещё не забрал
- 3ЗАБРАНОагент забрал и проверяет
- 4ПРИМЕНЕНОприменено; или ОТКЛОНЕНО с причиной
- Обновления из центраАгенты и продукты обновляются с проверкой подписи и автоматическим откатом.
- Центр обновляет сам себяВ окне обслуживания, с проверкой подписи и автоматическим откатом. Включает IBSurgeon; владелец центра может это запретить.
- Письма или webhook о новых проблемахИ недельный отчёт по всему парку. Функцию включает администратор центра.
- Агент бережёт серверЗадачу агента, которая берёт слишком много памяти или CPU, он ставит на паузу или останавливает. Бэкапы и отправку данных не трогает.
- Пользователи и праваПо серверам; отдельные права на изменение настроек, запуск заданий и опасные операции. Журнал аудита.
- 5 языков интерфейсаEnglish, русский, Deutsch, português (Brasil), español.
Мастер отправляет сегменты журнала репликации на реплику. Менеджер кластера (RCM) следит за всеми узлами: отставание, очереди, ошибки. Одна реплика может принимать базы от нескольких мастеров. Поддерживаются Firebird 4 и 5, а также HQbird 2.5 и 3.0.
Новая реплика создаётся через nbackup, без остановки мастера и под нагрузкой. Перед стартом RCM и узлы проверяют свободное место. Узел мастера ждёт завершения длинных транзакций.
Мастер можно перенести на другой хост. Switchover делает это планово и без потери данных: RCM сам останавливает запись, ждёт реплику и возвращает старый мастер репликой. Failover нужен, когда хост мастера потерян. Роутер на хосте приложений всегда ведёт их на текущий мастер.
Контроль и безопасность
RCM знает более 20 типов оповещений, и у каждого есть инструкция. Проверка данных сравнивает число строк каждой таблицы на мастере и на реплике. Периодическую проверку включают в настройках. Firebird мастера никогда не перезапускается автоматически; реплика только в разрешённых случаях.
Switchover и failover идут по шагам. До точки невозврата ошибка или отмена возвращают старый мастер в работу. Автоматический failover выключен по умолчанию; он включается для каждого сервиса отдельно и требует роутеров-свидетелей.
Для базы без сервиса остаётся ручной путь: «Повысить до мастера» показывает каждый шаг в строке базы. Если шаг прервался, его можно повторить.
Узлы общаются через mTLS с общим CA. Сертификаты продлеваются автоматически, ключи не покидают хост.
- Switchover новоеПлановый перенос мастера одной кнопкой в RCM или одной командой. Данные не теряются. Старый мастер сам возвращается репликой.
- Failover новоеХост мастера потерян: реплика берёт роль мастера. Вручную, с явным согласием на потерю, или по правилу сервиса.
- Роутеры новоеHAProxy на хосте приложений. После смены мастера строка подключения остаётся той же.
- Перенос файла репликиБез повторной инициализации; при ошибке откат.
- Пауза и продолжениеПосле паузы отправка продолжается с последнего сегмента, без reinit.
- Сборка кластера в три шага новоеВключить RCM на одном хосте, открыть окно сопряжения на остальных, связать хосты на странице Link hosts.
- Зависший Firebird новоеУзел сам подключается к базе каждую минуту. Порт открыт, а база не отвечает — серьёзное оповещение.
- Массовое изменение параметровПараметры репликации для многих узлов с предварительным просмотром.
- Публикация таблицВключение, исключение и контроль публикации для Firebird 4 и 5.
HQbird MCP подключает Firebird к AI-ассистенту: Claude Desktop, Claude Code, Cursor, Codex и другим MCP-клиентам. Больше 120 инструментов, Firebird 2.5–5, и все данные агента fbagent.
Главное правило: человек всегда решает. Чтение идёт без подтверждения, в транзакции только для чтения. Каждое изменение требует подтверждения. Опасные операции подтверждаются только на сервере, по второму каналу, не через чат: командой fbmcp ctl approve или, на Windows, в окне в трее. AI не может подтвердить их сам.
fbmcp ctl approve. Нужно открытое окно обслуживания. Для замены базы, монопольного окна и опасного SQL нужен также проверенный бэкап не старше 24 ч.- 1Ассистент просит«заменить базу из бэкапа»
- 2fbmcp проверяет уровеньуровень 2: окно открыто, бэкап проверен
- 3Человек на сервереодобряет командой
fbmcp ctl approve - 4Выполнениес предпросмотром того, что изменится
- 5✓ Запись в журналцепочка хэшей; проверка одной командой
- Для DBAСессии, транзакции OIT/OAT/OST, gstat, LWM, firebird.log; бэкапы и тестовое восстановление; sweep, валидация; пользователи и права с защитой от блокировки SYSDBA; трассы по шаблонам.
- Для разработчиковПлан запроса и совет по индексу с перепроверкой; проверка компиляции запроса; результат как таблица прямо в чате; сравнение схем и данных; миграции с планом отката.
- Готовые сценарииПроверка здоровья, оптимизация, аудит безопасности, ревью DDL, план миграции, готовность к аварии.
- Данные агента fbagentОтчёт о здоровье, LWM, gstat, производительность, deadlock, бэкапы. Ассистент запускает задания и меняет их настройки; учётные данные менять нельзя.
- Кластер новоеАссистент собирает кластер репликации через RCM: открывает окно сопряжения, связывает хосты, добавляет базы и проверяет реплику. Он же запускает switchover и failover; человек подтверждает их на сервере.
- Удалённый режимАссистент на ПК администратора, MCP-сервер на сервере БД. HTTPS, свой API-ключ для каждого человека, список разрешённых адресов. Пароли и пути к базам не попадают в чат.
- Уже в комплектеСтавится установщиком HQbird и обновляется агентом. На Linux сборка без подписи не ставится.
Одна команда ставит Firebird 2.5–5 вместе с агентом, консолью и MCP-сервером. Windows и Linux, x86-64. Установщик открывает в межсетевом экране порт нового Firebird и порт HQ Monitor: в Windows, firewalld или ufw. Порты кластера открываются, только когда на сервере включают RCM или окно сопряжения. Можно сначала посмотреть план установки: команда показывает, что будет сделано, и ничего не меняет.
- Несколько Firebird на одном сервереНовый экземпляр ставится рядом с существующим, на свободный порт, со своим агентом. Установленный не меняется.
- Проверка до измененийПлан установки и проверка конфига показывают проблемы заранее.
- Мастер Windows на 8 языках новоеАнглийский, португальский, немецкий, русский, испанский, польский, турецкий, китайский.
- Облако и Docker новоеГотовый образ для каждой линии Firebird: Firebird, агент и HQ Monitor в одном контейнере. Бэкапы идут прямо в S3. Подробнее.
- Linux: минимум правАгент работает от пользователя firebird; root выполняет только проверенные скрипты.
- Пароли и ключи под защитойПароли, токены и ключи доступа (например, к S3), введённые в консоли, шифруются ключом агента. В отчётах и снимках конфигов они скрыты.
- Самообновление с подписьюСборку с неверной подписью агент не ставит. На Linux сборка без подписи не ставится. Защита от понижения версии, откат при неудачном обновлении.
- Обновления без HQCenter новоеСервер без центра сам берёт обновления с сервера обновлений IBSurgeon: агент, HQ Monitor и MCP-сервер ставятся сами, пакет Firebird ждёт вашей команды.
- Права в security DBКакие пользователи есть и кто может создавать базы; приватные security DB находятся по databases.conf. Нового пользователя можно создать прямо в HQ Monitor.
- Закрытые сетиHQ Monitor работает без интернета.
- Demo-режимСкрывает имена серверов, баз и пути, чтобы безопасно делать скриншоты. Все скриншоты на этой странице сняты так.
- Контроль у владельца сервераУдалённые команды можно отключить на самом сервере. Отправку имён других программ и служб тоже.
- Журнал запросов агентаКаждый запрос, который меняет сервер, и каждый отказ — одна строка в журнале на сервере. Секреты и значения настроек не пишутся. Хранится 30 дней.
HQbird работает на облачном сервере так же, как на своём. Для Docker есть готовый образ на каждую линию Firebird: Firebird, агент и HQ Monitor в одном контейнере.
Данные лежат на томах и остаются при замене контейнера или образа. Агент сам подключается к HQCenter, поэтому серверу в облаке не нужны входящие порты для связи с центром.
- 4 образаFirebird 5, 4, 3 и 2.5. Образы открытые: вход в реестр не нужен.
- Первый запуск одной командой
docker compose up -d: контейнер сам ставит HQbird. - Несколько экземпляров на хостеУ каждого свои порты и тома. Один экземпляр без нагрузки занимает около 200–250 МБ памяти.
- ОбновленияИз HQCenter или новым образом. Оба способа сохраняют данные.
- Кластер в контейнереЭкземпляр входит в кластер так же, как сервер.
- Бэкапы в S3Бэкап идёт прямо в бакет, без файла на диске. Подробнее.
Что важно знать
- Автоматический failover в кластере выключен по умолчанию. Он включается для каждого сервиса отдельно и требует роутеров. Ручной failover всегда требует явного согласия на потерю данных.
- В HQ Monitor нет собственных оповещений и Telegram. Письма и webhook о проблемах отправляет центр; эту функцию включает администратор центра.
- MCP: опасную операцию подтверждают на сервере командой
fbmcp ctl approve. Установщик HQbird окно в трее не ставит. - MCP: результат-таблица в чате работает только в клиентах с поддержкой MCP Apps.