Как списывать время в Jira: практическое руководство по ворклогам

Сначала о терминах

В русскоязычных командах одно и то же действие называют по-разному: «списать время», «залогировать», «заворклогать», «внести часы». Во всех случаях речь об одном — создать в задаче Jira ворклог (worklog): запись о том, кто, когда и сколько времени потратил на задачу, с коротким комментарием. Из ворклогов потом строятся отчёты, табели и счета заказчикам.

Названия пунктов меню в русской локализации Jira менялись от версии к версии, поэтому ниже мы указываем английские — Log work, Time tracking, Work log. По ним проще найти нужное и в интерфейсе, и в документации Atlassian.

Перед началом: включите учёт времени

Если в задаче негде списать время, дело почти всегда в настройках, а не в вас. Должны выполняться три условия:

1. Учёт времени включён для всего экземпляра. В Jira Cloud администратор сайта открывает Settings (шестерёнка) → Issues → Time tracking, в Jira Server и Data Center — Administration → Issues → Time tracking. Там же задаётся пересчёт: по умолчанию 1 день = 8 часов, 1 неделя = 5 дней. Если в компании другой рабочий день, поменяйте настройку, иначе «1d» в ворклогах будет означать не то, что думают люди.
2. У вас есть право списывать время. В схеме разрешений проекта оно обычно называется Work on issues. Редактирование и удаление своих и чужих ворклогов настраивается отдельными правами.
3. Поле Time tracking есть на экранах проекта. В проектах, управляемых компанией (company-managed), поле должно стоять на экране нужного типа задач. В командных проектах (team-managed) функцию или поле учёта времени включают в настройках проекта.

Как списать время в Jira Cloud

Интерфейс задачи в Cloud за последние годы менялся не раз, поэтому точное место зависит от вашей раскладки. Основные пути такие:

• Поле Time tracking. В панели деталей задачи нажмите на полоску учёта времени (на ней может быть написано «No time logged»). Откроется окно списания.
• Меню … (More actions). В верхней части задачи откройте меню и найдите Log work или Log time.
• Палитра команд. Во многих раскладках Cloud нажатие . в открытой задаче вызывает поиск по действиям: наберите «log» и выберите списание времени. Если на вашем сайте это не работает, путь через меню работает всегда.

В окне есть поля Time spent (затраченное время), Time remaining (оставшееся), дата и время начала и описание работы. Затраченное время пишется в нотации Jira: w — недели, d — дни, h — часы, m — минуты. Запись 1w 2d 3h 30m корректна и при настройках по умолчанию равна 59,5 рабочего часа. В повседневной работе вы чаще будете вводить что-то вроде 45m или 2h 15m.

Внимательно смотрите на дату начала. По умолчанию это текущий момент, и если в понедельник утром вы списываете пятницу, дату нужно поменять — иначе в недельном табеле всё окажется не в тот день.

Как списать время в Jira Server и Data Center

Многие компании в России работают на собственной установке Jira Server или Data Center. Здесь откройте задачу и выберите More → Log work. Настроек в окне чуть больше, чем в Cloud:

• Time spent — та же нотация, например 3h 30m.
• Date started — день и время начала работы.
• Remaining estimate — что делать с оставшейся оценкой:
  • Adjust automatically — вычесть списанное время из оставшейся оценки;
  • Use existing estimate — оценку не трогать;
  • Set to — заменить оставшуюся оценку новым значением;
  • Reduce by — уменьшить оценку на другую величину, чем списано.
• Work description — комментарий, который попадёт в ворклог.

Для большинства подходит «Adjust automatically». «Set to» пригодится, когда стало ясно, что оценка была неверной, — например, двухчасовая правка оказалась двухдневной переделкой.

Шпаргалка: Cloud и Data Center

Списание времени из коммитов (смарт-коммиты)

Если репозиторий подключён к Jira (Bitbucket, GitHub или GitLab через соответствующую интеграцию), время можно списать прямо в сообщении коммита:

git commit -m "PAY-214 #time 2h 30m Исправил лимиты возвратов для частичных refund"

Jira распознаёт ключ задачи, команду #time и длительность, а остаток сообщения использует как комментарий ворклога. Два нюанса: email в коммите должен совпадать с пользователем Jira, у которого есть право списывать время, а ворклог создаётся, когда Jira обработает коммит, а не когда вы писали код. Squash и rebase могут «проиграть» сообщение повторно, так что следите за дублями.

Смарт-коммиты удобны разработчикам, которые и так пишут ключ в каждом коммите. Но встречи, код-ревью и поддержка коммитов не порождают — и это время так не списать.

Списание времени через REST API

Для скриптов и интеграций в Jira Cloud есть POST /rest/api/3/issue/{issueIdOrKey}/worklog. Третья версия API ждёт комментарий в формате Atlassian Document Format (ADF), а поле started — с миллисекундами и смещением часового пояса:

curl -X POST \
  -u "you@company.ru:$JIRA_API_TOKEN" \
  -H "Content-Type: application/json" \
  "https://your-site.atlassian.net/rest/api/3/issue/OPS-77/worklog" \
  -d '{
    "timeSpentSeconds": 5400,
    "started": "2026-10-16T09:00:00.000+0300",
    "comment": {
      "type": "doc", "version": 1,
      "content": [{"type": "paragraph",
        "content": [{"type": "text", "text": "Обновил сертификаты на стейдже"}]}]
    }
  }'

В Data Center аналог — /rest/api/2/issue/{key}/worklog, где comment — обычная строка. В свежих версиях для аутентификации обычно используют персональный токен доступа (Personal Access Token) в заголовке Authorization: Bearer. В обоих случаях эндпоинт принимает параметр adjustEstimate, если нужно управлять оставшейся оценкой так же, как в окне Log work.

Где видны ворклоги и как их найти

Каждый ворклог отображается в задаче на вкладке Activity → Work log: автор, дата начала, длительность и комментарий. Полоска учёта времени в деталях задачи сравнивает три числа: первоначальную оценку, списанное время и оставшееся. Когда списанное плюс оставшееся превышает исходную оценку, полоска показывает перерасход — часто это первый сигнал, что задачу недооценили.

Найти задачи, в которые вы списывали время на этой неделе, можно запросом JQL:

worklogAuthor = currentUser() AND worklogDate >= startOfWeek()

Он вернёт список задач, но не сумму часов по дням: полноценного личного табеля в стандартной Jira нет. Ворклоги же читают все отчёты, фильтры и приложения для табелей, поэтому если они неверны в задаче, они неверны везде.

Типичные ошибки при списании времени

• Время на эпике, а не на истории или подзадаче. Такое время трудно атрибутировать, и в зависимости от настроек оно может суммироваться не так, как вы ожидаете. Списывайте туда, где шла работа.
• Не та дата или часовой пояс. Ворклог, начатый в 23:30 по одному поясу, в отчёте коллеги из другого может оказаться в следующем дне. Списывайте по своему рабочему дню и проверяйте время начала, когда догоняете прошлые дни.
• Дубли. Повторный запуск скриптов, «проигранные» смарт-коммиты, одна и та же встреча с двух устройств. Перед массовым вводом загляните во вкладку Work log.
• Накопленное округление. Если каждую запись округлять вверх до 30 минут, реальные 6,5 часа превращаются в 8. Выберите шаг (мы используем 15 минут) и округляйте до ближайшего, а не всегда вверх.

Как писать хорошие описания ворклогов

Комментарий к ворклогу должен объяснять, на что ушло время, — в том числе вам самим через три недели. Что работает у нас:

• Один ворклог на задачу за день. Утреннюю и вечернюю сессию по PAY-214 лучше объединить в одну запись, чем оставлять пять обрывков.
• Начинайте с глагола. «Исправил», «Провёл ревью», «Разобрался», «Выкатил».
• Называйте конкретику. Компонент, пул-реквест, клиента, окружение.

Примеры:

• PAY-214 · 2h 30m · Исправил обновление токена для истёкших SSO-сессий, добавил регрессионный тест
• OPS-77 · 1h 30m · Обновил TLS-сертификаты на стейдже, дополнил ранбук
• CASE-1501 · 45m · Ревью PR #312 (выгрузка счетов), запросил правки

«Работа над задачей» или «разработка» никому ничего не говорят — и именно такие записи вызывают вопросы в конце месяца. Как связать ворклоги с кадровым табелем и нормой часов, мы разобрали в статье «Табель учёта рабочего времени для ИТ-команд».

Если в компании Tempo

Если ваша компания использует Tempo Timesheets, время списывают в интерфейсе Tempo. Tempo хранит свои ворклоги и синхронизирует их с ворклогами Jira, поэтому записи по-прежнему видны на вкладке Work log задачи. Правила выше — правильная задача, правильная дата, понятное описание — действуют так же. Сравнение Tempo с другими вариантами есть в нашем англоязычном обзоре альтернатив Tempo Timesheets.

Как автоматизировать списание времени

Всё описанное выше предполагает, что вы помните, что делали. Это и есть слабое место. К пятнице большинство восстанавливает неделю по приглашениям в календаре, истории чатов и догадкам, и в итоге недосписывает мелочи: двадцатиминутное ревью, быструю проверку прода.

Надёжнее восстанавливать день по активности, которая и так остаётся на компьютере:

• Заголовки окон. Вкладка Jira содержит ключ задачи: «[PAY-214] Лимиты возвратов не учитывают частичные refund».
• Ветки git. Ветка feature/PAY-214-refund-limits в заголовке IDE однозначно указывает на задачу.
• Программы и домены. Время во встречах или на дашборде мониторинга можно отнести к задаче встреч или дежурства.

Дальше инструмент готовит ворклоги, а вы их утверждаете. Так работает Timesheet Tracker — автоматический табель для Jira в Windows. Он живёт в трее и записывает активную программу, заголовок окна, домен вкладки браузера и время простоя или блокировки — локально, на вашем компьютере. Ключи Jira в заголовках, адресах и ветках git находятся на устройстве, без AI. Остаток раскладывает кнопка «Разобрать день»: AI назначает оставшиеся отрезки задачам и пишет по одному ворклогу на задачу. Для этого уходят только замаскированные заголовки, названия программ, домены и длительности — никогда полные адреса, содержимое страниц, скриншоты, нажатия клавиш или ваш токен Jira. Есть и режим «Без AI».

Вы просматриваете черновики, при необходимости нажимаете «Сменить задачу» или «Не работа», затем «Подтвердить день» и «Отправить в Jira». Ворклоги уходят в Jira Cloud или Server / Data Center без дублей, а «Экспорт CSV» выгрузит день в файл. Скриншотов и отчётов руководителю нет: приложение сделано для тех, кто сам списывает своё время. Скачивание из Microsoft Store бесплатное, первые 14 дней Pro тоже бесплатны.

Частые вопросы

Почему в задаче Jira нет кнопки Log work?

Почти всегда дело в настройках. Либо учёт времени выключен для всего сайта, либо у вас нет права Work on issues в схеме разрешений проекта, либо поле Time tracking убрали с экрана задачи. Начните с экранов: чаще всего кнопка пропадает после того, как кто-то отредактировал схему экранов.

Можно ли списать время в Jira задним числом?

Да. В окне списания времени есть поле даты начала работы: поставьте нужный день, и ворклог попадёт в него. Стандартная Jira не запрещает списывать прошлые дни, но компании иногда закрывают периоды через Tempo или собственные правила — тогда понадобится помощь администратора.

Как исправить или удалить ворклог в Jira?

Откройте задачу, перейдите на вкладку Work log в разделе Activity и воспользуйтесь действиями редактирования или удаления у нужной записи. Для своих ворклогов нужны права Edit Own Worklogs и Delete Own Worklogs, для чужих — Edit All Worklogs и Delete All Worklogs.

Как посмотреть, сколько времени я списал в Jira за неделю?

Найдите задачи запросом JQL worklogAuthor = currentUser() AND worklogDate >= startOfWeek(). Он вернёт задачи, в которые вы списывали время, но не сумму часов по дням. Полноценного личного табеля в стандартной Jira нет, поэтому для недельных отчётов обычно используют Tempo или другие приложения.

Чем смарт-коммиты отличаются от автоматического трекера времени?

Смарт-коммит списывает время, которое вы сами указали в сообщении коммита командой #time, и только на ту работу, которая заканчивается коммитом. Автоматический трекер записывает весь день, включая встречи, ревью и поддержку, и предлагает ворклоги, которые вы затем проверяете и подтверждаете.