Баг-трекинг: workflow, басымдықтар және түзетуге арналған SLA

Жұмыс істейтін баг-трекинг төрт шешімге сүйенеді. Міндетті өрістері бар жеке Bug тапсырма түрі. Жеті мәртебеден тұратын қысқа workflow. Маңыздылық пен басымдықты бөлу. Біреу мәселе туралы жазған сәттен емес, баг расталған сәттен есептелетін SLA. Мұның бәрі Plane-да да, Jira-да да бапталады. Қиындық құралда емес, команда күн сайын сақтайтын келісімдерде.

Мақала багтарды ретке келтіргісі келетін тимлидтерге, QA-лидтерге, продактарға және IT бөлімдерінің басшыларына арналған. Төменде — баг өрістері, мәртебелер, маңыздылық пен басымдық матрицасы, SLA мысалы, қолдау мен Sentry ағыны, метрикалар, типтік қателер және Plane мен Jira-да баптаудың қысқа схемасы.

Bug тапсырма түрі: қандай өрістер керек

Баг «bug» белгісі бар кәдімгі тапсырма болмауы керек. Жеке түр өзінің өрістер жиынтығын, өз workflow-ын және адал есептілікті береді. Jira-да бұл стандартты Bug тапсырма түрі. Plane-да — өз қасиеттері бар жеке Work item type.

Өріс	Қашан толтырылады	Не үшін
Қысқа сипаттама	Жасау кезінде	Көшірмелерді іздеу және түсінікті тізім
Қайталау қадамдары	Жасау кезінде, міндетті	Оларсыз баг жұмысқа алынбайды
Күтілген және нақты нәтиже	Жасау кезінде	Багты тілектен ажыратады
Орта және нұсқа	Жасау кезінде	Браузер, ОЖ, қосымша нұсқасы, стенд
Маңыздылық	Жасау кезінде, триажда нақтыланады	Өнім қаншалықты бұзылған
Дереккөз	Жасау кезінде	Қолдау, QA, Sentry, ішкі пайдаланушы
Басымдық	Триажда	Қаншалықты тез түзетеміз
Компонент немесе модуль	Триажда	Кодтың иесі кім
Жауапты және мерзім	Триажда	Кім және қай мерзімге дейін
Түзету нұсқасы	Жабу кезінде	Релизбен байланыс

Ең көп уақыт үнемдейтін ереже: қайталау қадамдары жоқ баг авторына қайтарылады. «Анықтаймыз» емес, қайтарылады. Мұндай тәжірибенің екі-үш аптасынан кейін өтінімдердің сапасы айтарлықтай өседі.

Workflow: хабарламадан жабуға дейінгі мәртебелер

Баг workflow-ы көрінгеннен қысқа. Жұмыс нұсқасы:

1. Жаңа — баг тіркелді, оны әлі ешкім қарамаған.
2. Триаж — кезекші көшірмелерді тексереді, қайталап көреді, маңыздылық пен басымдықты қояды.
3. Расталды — баг қайталанды, басымдық пен мерзім тағайындалды. Осы сәттен бастап SLA есептеледі.
4. Жұмыста — әзірлеуші түзетіп жатыр.
5. Тексеруде — код-ревью және стендте QA тексеруі.
6. Релизге дайын — түзету біріктірілген және шығаруды күтіп тұр.
7. Жабылды — түзету продакшенде.

Түзетусіз екі соңғы нәтиже: негізгі багқа сілтемесі бар Көшірме және нақты не тексерілгені туралы пікірі бар Қайталанбайды. «Кейінге қалдырылды» деген жеке мәртебені басымдық пен мерзімге ауыстырған дұрыс: күні жоқ кейінге қалдырылған баг ешқашан қайтпайды.

Қайта ашуды жаңа баг ретінде емес, «Жабылды»-дан қайтадан «Расталды»-ға өту ретінде жасаңыз. Сонда қайта ашулар метрикасы автоматты түрде есептеледі.

Триажды қалай өткізу керек

Триаж — жиналыс емес, нақты адамның міндеті. Әзірлеушілер немесе QA арасынан кезекпен бір аптаға кезекші тағайындаңыз. Оның әр жаңа баг бойынша міндеті:

1. Сипаттама мен компонент бойынша көшірмелерді табу. Тапса — сілтемесімен «Көшірме» ретінде жабу.
2. Көрсетілген нұсқада қайталап көру. Шықпаса — авторынан деректер сұрау немесе «Қайталанбайды» ретінде жабу.
3. Маңыздылық пен қамтуды қойып, төмендегі матрица бойынша басымдықты алу.
4. Компонентті, жауаптыны және SLA бойынша мерзімді тағайындау.
5. P1 үшін біреу трекерді ашқанын күтпей, жұмыс арнасында бірден дабыл көтеру.

P1 және P2 үшін триаж үздіксіз жүреді, қалғандары үшін күніне бір-екі рет қарау жеткілікті. Аптасына бір рет өнім иесі кезекшінің шешімдерін қарап, қажет болса басымдықтарды өзгертеді. Осылайша шешім үшін жауапкершілік бір адамда, ал тексеру — басқа адамда қалады.

Маңыздылық пен басымдық: матрица

Маңыздылық (severity) — багтың өз қасиеті. Басымдық (priority) — команданың шешімі. Бір өріс екі сұраққа да жауап беруге тырысқанда, оларды шатастырады. Мысалы, басты беттегі қате жазылған сөздің маңыздылығы төмен, бірақ жарнама іске қосылар алдында жоғары басымдық алуы мүмкін.

Төрт деңгейлі маңыздылық:

• S1 Сыни — өнім немесе негізгі функция қолжетімсіз, деректер немесе ақша жоғалады, қауіпсіздік бұзылған.
• S2 Жоғары — маңызды функция дұрыс жұмыс істемейді, айналма жол жоқ.
• S3 Орташа — функция қатемен жұмыс істейді, айналма жол бар.
• S4 Төмен — косметика, мәтіндер, ыңғайсыздық.

Триажға арналған матрица: жолдар бойынша маңыздылық, бағандар бойынша қамту.

Маңыздылық ↓ / Қамту →	Барлық немесе негізгі клиенттер	Пайдаланушылардың бір бөлігі	Жекелеген жағдайлар
S1 Сыни	P1	P1	P2
S2 Жоғары	P1	P2	P3
S3 Орташа	P2	P3	P4
S4 Төмен	P3	P4	P4

Матрица әдепкі басымдықты береді. Өнім иесі оны көтеруі немесе түсіруі мүмкін, бірақ себебін пікірмен жазып. Осылайша даулы шешімдер көрінетін болып қалады.

Түзетуге арналған SLA: бастапқы мақсаттар мысалы

Төмендегі сандар — жұмыс сағаттары және P1 үшін кезекшілігі бар өнім командасына арналған мысал. Бұл норма емес, бірінші нұсқаға арналған бағдар. Мерзімдерді өз өніміңізге, клиенттермен шарттарға және команданың нақты құрамына қарай таңдаңыз.

Басымдық	Реакция (растауға дейін)	Түзету	Қашан жұмыс істейміз	Эскалация
P1	Бір сағат ішінде	Сол күні, hotfix	Тәулік бойы кезекші	Бірден тимлидке және басшыға
P2	Жұмыс күні ішінде	Ағымдағы спринтте	Жұмыс сағаттары	Мерзімге қауіп төнгенде тимлидке
P3	Екі жұмыс күні ішінде	Жақын екі спринтте	Жұмыс сағаттары	Спринтті жоспарлау кезінде
P4	Апталық триажда	Мүмкіндігінше	Жұмыс сағаттары	Тоқсанына бір рет қайта қарау

SLA-ды декорацияға айналдыратын үш ереже:

• SLA «Расталды» мәртебесінен, ал реакция «Жаңа» мәртебесінен есептеледі.
• Мерзім триажда қолмен немесе, трекер нұсқаңыз мүмкіндік берсе, автоматтандыру арқылы қойылады.
• Мерзімі өткен багтар сақталған сүзгімен — Plane-да PQL, Jira-да JQL — ізделеді және команда күн сайын көретін дашбордқа шығарылады.

Jira Service Management-те толыққанды SLA таймерлері бар. Plane-да және кәдімгі Jira-да бақылау мерзімдерге, сүзгілерге және дашбордтарға негізделеді. Өнім командаларының көпшілігі үшін бұл жеткілікті.

Қолдау мен Sentry-ден келетін ағын

Қолдаудан

Клиенттерден багтар қолдау арқылы келеді, және мұнда шикі өтініштерді тікелей әзірлеу бэклогына жібермеу маңызды. Схема: бір кіріс кезек, триаждағы кезекші, тексеруден кейін ғана багқа айналдыру.

Plane-да кіріс кезекті Intake жабады: өтінімдер мен email-формалар жеке ағынға түседі, сол жерден оларды жобаға қабылдайды немесе қабылдамайды. Jira-да бұл рөлді әдетте Jira Service Management атқарады. Байланыс сілтемемен сақталады: багта — өтініш нөмірі, өтініште — багқа сілтеме. Клиентке қолдау жауап береді, әзірлеушілер тапсырма пікірлерінде клиенттермен хат алмаспайды.

Sentry-ден

Sentry қателерді пайдаланушылардан бұрын ұстайды, бірақ әр оқиғаға тапсырма жасаса, трекер бір аптада батып кетеді. Ережелер:

• Тапсырма әрбір оқиғаға емес, Sentry-дегі мәселеге жасалады.
• Автоматты түрде — тек шектен кейін: жиілік, зардап шеккен пайдаланушылар саны, жаңа релиздегі жаңа қате.
• Қалғанын кезекші күніне бір рет қолмен талдайды.
• Тапсырмада Sentry-дегі мәселеге сілтеме сақталады, ал маңыздылықты адам қояды.

Plane-да Sentry-мен штаттық интеграция бар. Jira үшін байланысты Sentry жағындағы интеграция, Jira Automation немесе вебхуктар арқылы баптайды. Өз нұсқаңыз бен тарифіңіз үшін қай нұсқа қолжетімді екенін тексеріңіз.

Қазақстан контексі. Көптеген клиенттер мәселелер туралы WhatsApp-та, дауыстық хабарламалармен және скриншоттармен, орыс немесе қазақ тілінде хабарлайды. Қолдауға мұндай хабарламаны әзірлеушіге толығымен жібермей, қайталау қадамдары бар багқа айналдыратын шаблон керек. Екінші сәт — дербес деректер: жеке кабинеттерден скриншоттар, сипаттамалардағы телефондар мен ЖСН, Sentry оқиғаларындағы пайдаланушылар деректері. Оларды баг тіркегенге дейін жасырыңыз. Егер оларсыз болмаса және олардың Қазақстанда сақталуы маңызды болса, трекер мен қателер мониторингін ҚР-дағы серверде self-hosted контурда ұстаңыз.

Баг-трекинг метрикалары

Метрикалар көп емес, және workflow адал бапталса, олардың бәрі мәртебелерден есептеледі:

• Растауға дейінгі уақыт — «Жаңа»-дан «Расталды»-ға дейін. Триаждың жұмыс істейтінін көрсетеді.
• Басымдықтар бойынша түзетуге дейінгі уақыт — «Расталды»-дан «Жабылды»-ға дейін.
• SLA бұзушылықтарының үлесі — әр басымдық бойынша бөлек.
• Қайта ашылған багтардың үлесі — асығыс түзетулердің немесе әлсіз тексерудің белгісі.
• Продакшеннен келген багтардың үлесі — багтардың қаншасын QA емес, пайдаланушылар мен Sentry тапты.
• Ашық бэклогтың жасы — қанша баг тоқсаннан ұзақ ілініп тұр.

Plane-да метрикалар сақталған көріністер бойынша Dashboards-та, Jira-да — JQL бойынша дашбордтарда жиналады. Оларды динамикада аптасына немесе спринтке бір рет қараңыз. Трендсіз бір сан ештеңе айтпайды.

Типтік қателер

• Екі өрістің орнына бір «Басымдық» өрісі. Бәрі «жоғары» болып кетеді, және басымдық бірдеңе білдіруін тоқтатады.
• Багтар жеке түрсіз ортақ бэклогта жүреді. Сапа бойынша есеп жинау мүмкін емес.
• Кезекшісіз SLA. Егер триажға ешкім жауап бермесе, мерзімдер бірінші күннен бұзылады.
• Sentry-ден шексіз автоматты тапсырма жасау. Трекер шуға толады, ал маңызды қателер жоғалады.
• 15 мәртебелі workflow. Адамдар тапсырмаларды жылжытуды тоқтатады, ал мәртебелер өтірік айтады.
• Багтар шығару кезінде емес, мерж кезінде жабылады. Клиент қатені әлі көреді, ал трекерде ол «жабылған».
• Тұрақты тазалау жоқ. Жылдан асқан жүздеген багтан тұратын бэклогты ешкім оқымайды. Тоқсанына бір рет оларды не қайта растайды, не жабады.

Plane және Jira-да баптау

Элемент	Plane	Jira
Bug түрі	Өз қасиеттері бар Work item type	Стандартты Bug түрі және өрістер
Мәртебелер	Жобада бапталады	Workflow және workflow схемасы
Кіріс кезек	Intake, email-формалар	Jira Service Management
Сүзгілер және SLA бақылауы	PQL, Views	JQL, сүзгілер
Автоматтандыру	Automations, Runner	Jira Automation
Есептілік	Dashboards	Дашбордтар
Релизбен байланыс	Releases, Cycles	Нұсқалар, спринттер
Кодтан келетін қателер	Sentry-мен интеграция	Sentry, Automation немесе вебхуктар арқылы интеграция

Егер трекерде тапсырмаларды жылжытатын және кезекшілерге хабарлайтын ережелер бұрыннан бар болса, қай жерде қарапайым ереже жеткілікті, ал қай жерде скрипт керек екенін анықтаған пайдалы. Бұл туралы — Таск-трекердегі автоматтандыру: ережелер, скрипттер немесе AI-агенттер мақаласында. Ал егер багтар өтінімдер мен инциденттермен қатар команданыңыз ағындарының бірі ғана болса, IT бөліміне арналған таск-трекер талдауын қараңыз.

Біз мұны қалай жасаймыз

Біз диагностикадан бастаймыз: қазір багтар қай жерде жүретінін, оларды кім тіркейтінін, қанша мәртебе мен өріс шынымен пайдаланылатынын және мерзімдер қай жерде жоғалатынын қараймыз. Содан кейін бір өнім командасында Bug түрін, workflow-ды, матрицаны және SLA-ды баптаймыз, қолдау мен Sentry-ді қосамыз және екі-үш апта метрикалар жинаймыз. Схема орныққанда, оны қалған командаларға көшіреміз және процесс иесіне триаж регламентін қалдырамыз.

Процесс қалай құрылғаны және нәтижеге не кіретіні Jira және Plane таск-трекерлерін енгізу бетінде сипатталған.

---

Дереккөздер. Plane: GitHub-тағы репозиторий және тарифтер. Jira: Atlassian прайс-парағы мен тарифтері.

Терминдер қарапайым тілмен

SLA (Service Level Agreement)

Мерзімдер туралы келісім: команда багқа қанша уақытта әрекет етеді және оны қанша уақытта түзетеді. Мұнда мерзімдер басымдыққа байланысты және баг расталған сәттен есептеледі.

Workflow

Баг өтетін мәртебелер реті: «Жаңа»-дан «Жабылды»-ға дейін. Қысқа workflow-ды адамдар шынымен сақтайды, ұзынын жаңартуды тоқтатады.

Триаж

Жаңа багты алғашқы талдау: көшірмеге тексеру, қайталап көру, маңыздылық пен басымдықты бағалау. Оны жиналыс емес, тағайындалған кезекші жүргізеді.

Маңыздылық (severity) және басымдық (priority)

Маңыздылық багтың өнімді қаншалықты бұзатынын көрсетеді. Басымдық оның бизнесті ескере отырып қаншалықты тез түзетілетінін көрсетеді. Бұл екі түрлі өріс, оларды араластырмаған жөн.

Sentry

Жұмыс істеп тұрған өнімдегі қателерді автоматты түрде ұстап, тізімге жинайтын сервис. Көбінесе пайдаланушылар қолдауға жазғанға дейін мәселені байқайды.

Hotfix

Жоспарлы релизді күтпей, бөлек шығарылатын шұғыл түзету. Ең сыни багтар үшін қолданылады.

Продакшен

Тестілік стендтерден айырмашылығы, клиенттер пайдаланатын өнімнің жұмыс нұсқасы. Түзету сонда түскенде ғана баг жабылды деп саналады.

JQL және PQL

Тапсырмаларды шарттар бойынша іздеуге арналған Jira мен Plane-дағы сұраныс тілдері. Олардың көмегімен сүзгілерді, мысалы «мерзімі өткен багтарды», сақтап, дашбордқа шығарады.