Ова страница је машински преведена. Прочитајте енглески оригинал. English

За програмере апликација

Који упит прво оптимизовати? Који код је изазвао грешку? Ко држи рекорд у конфликту? Агент прикупља одговоре из trace-а и статистике на самом серверу. Програмер их види у прегледачу и не пријављује се на сервер.

  • 1 мин trace датотеке
  • 3 прозора дневно извештај о перформансама
  • по плану груписање упита
  • 15 мин проналажење конфликта
  • REST локални API за скрипте и CI

trace · process_traces · perf report

Извештај о перформансама

Агент стално држи trace сесију отвореном. Сваког минута компресује излаз у датотеку и израчунава укупне вредности за сваки упит. Када се прозор заврши, агент спаја минуте у извештај: најспорије упите и најтеже по броју добављања, читања и уписа. За сваки упит приказује се број извршавања.

  1. 1Trace сесијаfbtracemgr ради стално; watchdog поново покреће изгубљену сесију
  2. 2Минутна датотекакомпресован trace излаз једном у минуту
  3. 3Минутни укупни подациза сваки упит: извршавања, време, добављања, читања, уписи, ознаке
  4. 4Извештај прозорау року од 5 минута након завршетка прозора; до 20 упита у сваком рангирању
  5. 5✓ HQ MonitorСтраница Perf Report; веза из извештаја о здрављу
Три прозора извештаја дневно: јутро 07:00–12:30, дан 12:31–18:00, ноћ 18:01–06:59; агент проверава прозоре сваких 5 мин, тако да се извештај појављује у року од 5 мин након завршетка прозора
Подразумевани прозори. Јутро, дан и ноћ. Прозоре и њихов број можете променити у подешавањима агента. Минут без података се прескаче; извештај се ипак прави.

Зашто груписање по плану

Ако програм уноси вредности директно у SQL текст, свака вредност даје нови текст. У једном стварном случају, број различитих текстова је порастао са 204 на 83.825 у минути. Хиљаде „различитих“ упита су заправо један упит са једним планом. Зато агент подразумевано групише упите по кључу: првих 10 знакова SQL-а без коментара, плус план извршавања. Упит без плана задржава свој пун текст. Режим мењате у подешавањима агента, поље „Perf group by“: по плану или по пуном SQL тексту. По тексту, датотеке и извештаји постају много већи. Промените режим у примеру испод и упоредите рангирања.

Упити у једном минуту

    Рангирање по добављањима

      Табела извештајаШта приказује
      Најбољи SQL по трајањуНајспорија извршавања: време и број записа.
      Најбољи SQL по добављањима, читањима, уписимаУкупни подаци за прозор: извршавања, време, добављања, читања, уписи, ознаке; удео у целом прозору; просек и максимум по извршавању.
      Процеси и адресеОптерећење по програму и по адреси клијента: везе, време, број различитих планова и упита.
      Ред упитаПун SQL, PLAN, параметри и статистика по табелама: natural, index, update, insert, delete, backout, purge, expunge.
      Десет рангирања у језичцимаТрајање, учесталост, укупно време, добављања, читања, уписи, планови, ознаке, процедуре и тригери. За сваку метрику видите распон вредности.
      Пример извршавањаКада је извршено, који клијент и са које адресе, у којој бази података. Ако се извршавање завршило грешком, видите је; сваки упит има бројач неуспелих извршавања.
      Извршавања по сатуКолико пута и колико дуго се упит извршавао у сваком сату прозора.
      Базе податакаУкупни подаци по бази података сервера и главне базе података сваког упита.

      Поређење, историја и извештај на захтев

      Извештај прозора одговара на питање „шта је данас било тешко“. Три нове функције одговарају на питања „шта се променило“ и „шта се догодило у овом сату“.

      • Поређење два прозораДва извештаја један поред другог: који упити су постали спорији, који су се појавили и који су нестали.
      • Историја упита за 30 данаКако су се време и број извршавања једног упита мењали од прозора до прозора.
      • Филтер по бази податакаИзвештај само за једну базу података. Веза на страници базе података води до странице извештаја.
      • До trace-ова минутаОд упита у извештају до trace-ова минута када је извршен.
      • Извештај на захтевДугме Build report… прави извештај за било који опсег до 24 сата. Филтери: база података, минимално трајање, програм. Агент прави један такав извештај истовремено и чува последњих 20.
      • Претрага и преузимањеПоље за претрагу текста упита. Можете преузети изворну датотеку извештаја.
      • Непотпун извештај је означенАко неке trace датотеке још нису стигле, извештај је означен као непотпун. Извештај чува само врх сваког рангирања, тако да страница каже „није у рангирању“, а не „није се извршио“.
      • Процедуре и тригериОва рангирања се попуњавају када trace подешавања укључе евидентирање завршетка процедура и тригера. Подразумевано је ово евидентирање искључено.
      • Из извештаја о здрављуДугме Perf report отвара прави прозор. Редови упита су означени, а први је већ проширен.
      • Упит и табелаКартица Queries у gstat статистици повезује упите са табелама и индексима које читају.
      • Минут на графикону базе податакаКлик на минут приказује тешке упите из trace-а и све конекције тог минута.
      • Копирај SQLСа параметрима или без њих, директно у ваш алат. У демо режиму дугмад су скривена.

      trace · Errors

      SQL грешке са подацима клијента

      Корисник каже „програм је пријавио грешку“. Страница Errors приказује сваку Firebird грешку из trace-а: време, конекцију, базу података, текст и клијента. Са називом програма, адресом и Firebird функцијом лако ћете пронаћи грешку у свом коду.

      Блок грешке у 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"

      Ред на страници 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

      • Исте грешке — један редЈедан ред по минуту, бази података и типу грешке, са бројем ×N. Савет приказује прво и последње време и број конекција.
      • ФилтериInclude и Exclude по тексту, бази података, програму, адреси и функцији. Клик на програм или адресу задржава само његове грешке.
      • Извоз у CSVСви редови са примењеним филтерима, у UTF-8 са BOM-ом: Excel одмах отвара датотеку у колонама.
      • Ако нема програмаМноги JDBC и .NET драјвери не шаљу назив програма. Тада је ред клијента краћи.

      trace_monitor_conflicts · find_deadlocks

      Конфликти и deadlock-ови

      Грешка „update conflicts with concurrent update“ сама по себи мало говори. Потребно је знати шта је урадила друга трансакција. Зато агент одржава другу trace сесију подешену за промене података и грешке. Сваких 15 минута тражи конфликте и прави извештај.

      Трансакција 1001 је изменила запис; 1002 покушава да измени исти запис и добија грешку; извештај проналази упите трансакције 1001 по њеном броју

      Како читати извештај

      Са леве стране је листа минута са конфликтима. Свака група је једна трансакција која је изазвала конфликте: број трансакције и време грешке.

      Лева колона приказује грешке: конекцију, програм, Firebird кодове и упит који није успео. Десна колона приказује успешне упите конкурентске трансакције: време, конекцију, број трансакције, програм. Сваки упит има свој SQL, параметре, статистику и табеле.

      Адреса странице чува датум и минут. Линк можете послати колеги.

      Страница конфликата. Минути са леве стране, група трансакција са десне: процес и кодови грешака.
      ПараметарПодразумеваноЗначење
      Претрага конфликатасваких 15 минутаПоследњи минут се прескаче: trace га још увек уписује.
      Дубина претраге3 сатаКолико историје пре конфликта се прегледа при тражењу упита друге трансакције.
      Чување сировог trace-а6 сатиСирове датотеке сесије конфликата се не гомилају на серверу. Извештаји се чувају и шаљу у HQ Monitor.

      gstat · indexes · metadata

      Како се база података мења

      Једном дневно агент узима пуну gstat статистику. HQ Monitor парсира датотеку: величину табела и индекса, верзије записа, BLOB-ове, дубину индекса. Картица „Analysis and recommendations“ говори шта није у реду и шта треба урадити.

      Анализа и препоруке. Проблем, број случајева, повезани објекти, препорука и акција.
      Трендови. Поређење најновијих снимака: шта је порасло и када ће објекат порасти за 25%.
      КартицаШта даје програмеру
      ТабелеВеличина података, индекса и BLOB-ова, број записа, верзије записа и максимални број верзија једног записа.
      ИндексиДубина, странице, јединствене вредности, дупликати. Дубина 4 је жути ред, 5 и више је црвени.
      Упити и везеКоји упити читају табелу или индекс. Подаци из извештаја о перформансама блиски по времену снимку.
      ТрендовиПоређење 5, 10, 20 или 30 снимака; праг промене 10%, 2% или 0,5%. Прогноза „+25%“ из три или више снимака.
      ИзвозJSON са мерењима и Excel са потпуном анализом.
      • Статистика индексаПодразумевано искључена; укључујете је у подешавањима агента. Затим сваких 6 сати агент броји неактивне индексе и индексе са лошом селективношћу. Индекс који није изграђен након ресторовања је озбиљан у извештају о здрављу.
      • Прогноза растаОзнака „+25%“ у табели база података приказује табелу или индекс који најбрже расту и отвара прогнозу.
      • Извоз шемеАгент извози метаподатке базе података помоћу isql -x и чува архиве по датуму.
      • Праћење метаподатакаПодразумевано искључено; укључујете је у подешавањима агента. Сваких 6 сати агент упоређује нови извоз шеме са претходним и бележи када се шема променила.

      LWM · MON$ · клијенти

      Везе: дуге трансакције и верзије клијената

      Једна заборављена трансакција успорава целу базу података: верзије записа се гомилају, а сакупљање смећа се зауставља.

      Сваког минута агент уписује бројаче трансакција и податке о везама. На графикону базе података, Next − OAT расте ако трансакција остане отворена дуго времена. Табела веза за тај минут, сортирана по Act.Tran, приказује програм, адресу и процес који држи трансакцију. Више о бројачима је на страници о здрављу сервера.

      Једном дневно агент чита које се клијентске библиотеке повезују са базом података и колико веза има свака. Ред „Није откривено. Стара верзија?“ обично значи стару клијентску библиотеку.

      Верзије клијената. Низ верзије из клијента и број веза. Сопствене везе агента приказују се као посебан ред.
      • MON$ метрикеЈедном на сат: меморија по програму, 5 веза са највише меморије и 5 са највећим оптерећењем.
      • Стари клијенти без лажних узбунаНалаз „стари клијенти“ броји само fbclient библиотеке. Драјвери који раде без fbclient не улазе у тај број.
      • Дуге трансакције у извештајуИзвештај о здрављу означава дуге трансакције и раст Next − OAT. Налаз наводи корисника, програм и адресу и даје готову команду за прекид везе.

      Локални API · Prometheus · HQbird MCP

      Ваше скрипте, CI и AI асистент

      Све што видите у HQ Monitor доступно је из ваших сопствених алата. Локални API агента слуша само на loopback адреси, а сваки захтев носи Bearer токен. Тешки послови се извршавају асинхроно: одговор даје број операције, а статус читате преко њега. Агент уписује сваки захтев који мења сервер, као и свако одбијање 401 или 403, у евиденцију ревизије. Захтеви за читање не иду у евиденцију.

      # 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>
      ПутањаШта даје
      /v1/statusСнимак статуса сервера, цео или по одељку, на пример резервне копије.
      /v1/databasesСписак активних база података.
      /v1/artifacts/…Подаци агента: LWM (Light-weight Monitoring) по минуту, gstat, статистика индекса, метрике, најновији извоз шеме, извештаји трагова.
      /v1/jobs/{job}/runПокрени посао: резервна копија, ресторовање, sweep, провера базе података, поновно израчунавање статистике индекса, SQL скрипта. Понављање са истим кључем не покреће посао два пута.

      Prometheus метрике не иду преко локалног API-ја. Имају сопствену адресу: подразумевано 127.0.0.1, порт 25000 + порт Firebird-а. Имају сопствени Bearer токен. Извоз је подразумевано искључен; укључујете га у подешавањима агента. Метрике: LWM, CPU и меморија, дискови, ограничења ОС-а, привремене датотеке.

      AI асистент у IDE-у

      HQbird MCP повезује Firebird и податке агента са Claude Code, Cursor, Codex и другим MCP клијентима. Асистент види извештаје агента и ради са базом података под људском контролом: човек потврђује опасне радње.

      Упит

      План и индекс

      План упита и савет за индекс, са поновном провером плана након креирања индекса. Провера компајлирања упита пре него што се изврши.

      Шема

      Упореди две базе података

      Разлике у шеми и подацима, на пример између развојног окружења и тест стенда.

      Миграција

      План, потврда, враћање

      Миграција са планом, једном потврдом и планом за враћање.

      Више: HQbird MCP

      ← Назад на преглед HQbird 2027 · Здравље сервера детаљно →