HQbird за програмере
За програмере апликација
Који упит прво оптимизовати? Који код је изазвао грешку? Ко држи рекорд у конфликту? Агент прикупља одговоре из trace-а и статистике на самом серверу. Програмер их види у прегледачу и не пријављује се на сервер.
- 1 мин trace датотеке
- 3 прозора дневно извештај о перформансама
- по плану груписање упита
- 15 мин проналажење конфликта
- REST локални API за скрипте и CI
trace · process_traces · perf report
Извештај о перформансама
Агент стално држи trace сесију отвореном. Сваког минута компресује излаз у датотеку и израчунава укупне вредности за сваки упит. Када се прозор заврши, агент спаја минуте у извештај: најспорије упите и најтеже по броју добављања, читања и уписа. За сваки упит приказује се број извршавања.
- 1Trace сесијаfbtracemgr ради стално; watchdog поново покреће изгубљену сесију
- 2Минутна датотекакомпресован trace излаз једном у минуту
- 3Минутни укупни подациза сваки упит: извршавања, време, добављања, читања, уписи, ознаке
- 4Извештај прозорау року од 5 минута након завршетка прозора; до 20 упита у сваком рангирању
- 5✓ HQ MonitorСтраница Perf Report; веза из извештаја о здрављу
Зашто груписање по плану
Ако програм уноси вредности директно у 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-у
Ред на страници Errors
- Исте грешке — један редЈедан ред по минуту, бази података и типу грешке, са бројем ×N. Савет приказује прво и последње време и број конекција.
- ФилтериInclude и Exclude по тексту, бази података, програму, адреси и функцији. Клик на програм или адресу задржава само његове грешке.
- Извоз у CSVСви редови са примењеним филтерима, у UTF-8 са BOM-ом: Excel одмах отвара датотеку у колонама.
- Ако нема програмаМноги JDBC и .NET драјвери не шаљу назив програма. Тада је ред клијента краћи.
trace_monitor_conflicts · find_deadlocks
Конфликти и deadlock-ови
Грешка „update conflicts with concurrent update“ сама по себи мало говори. Потребно је знати шта је урадила друга трансакција. Зато агент одржава другу trace сесију подешену за промене података и грешке. Сваких 15 минута тражи конфликте и прави извештај.
Како читати извештај
Са леве стране је листа минута са конфликтима. Свака група је једна трансакција која је изазвала конфликте: број трансакције и време грешке.
Лева колона приказује грешке: конекцију, програм, Firebird кодове и упит који није успео. Десна колона приказује успешне упите конкурентске трансакције: време, конекцију, број трансакције, програм. Сваки упит има свој SQL, параметре, статистику и табеле.
Адреса странице чува датум и минут. Линк можете послати колеги.
| Параметар | Подразумевано | Значење |
|---|---|---|
| Претрага конфликата | сваких 15 минута | Последњи минут се прескаче: trace га још увек уписује. |
| Дубина претраге | 3 сата | Колико историје пре конфликта се прегледа при тражењу упита друге трансакције. |
| Чување сировог trace-а | 6 сати | Сирове датотеке сесије конфликата се не гомилају на серверу. Извештаји се чувају и шаљу у HQ Monitor. |
gstat · indexes · metadata
Како се база података мења
Једном дневно агент узима пуну gstat статистику. HQ Monitor парсира датотеку: величину табела и индекса, верзије записа, BLOB-ове, дубину индекса. Картица „Analysis and recommendations“ говори шта није у реду и шта треба урадити.
| Картица | Шта даје програмеру |
|---|---|
| Табеле | Величина података, индекса и 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 клијентима. Асистент види извештаје агента и ради са базом података под људском контролом: човек потврђује опасне радње.
План и индекс
План упита и савет за индекс, са поновном провером плана након креирања индекса. Провера компајлирања упита пре него што се изврши.
Упореди две базе података
Разлике у шеми и подацима, на пример између развојног окружења и тест стенда.
План, потврда, враћање
Миграција са планом, једном потврдом и планом за враћање.