시간 추적
이슈(issues/index.md)와 Merge Request(merge_requests/index.md)에 사용된 시간을 추정하고 추적할 수 있습니다.
그런 다음 시간당 총계를 보여주는 보고서를 볼 수 있습니다.
다음과 같은 작업에 대해 시간 추적을 사용할 수 있습니다:
- 이슈 또는 Merge Request에서 작업한 시간을 기록합니다.
- 이슈나 Merge Request을 완료하는 데 필요한 총 시간을 추가하거나 업데이트합니다.
- 이슈 또는 Merge Request에서 작업한 시간을 세부적으로 볼 수 있습니다.
시간을 입력하거나 삭제하려면 빠른 조치를 사용해야 합니다. 각 빠른 조치를 개별 라인에 입력하세요. 하나의 댓글에서 동일한 빠른 조치를 여러 번 사용하면 마지막 발생만 적용됩니다.
이슈 및 Merge Request의 오른쪽 사이드바에 시간 추적 정보가 표시됩니다:
추정
추정은 이슈나 Merge Request을 완료하는 데 필요한 총 시간을 나타내는 것입니다.
오른쪽 사이드바의 시간 추적 정보 위로 마우스를 올리면 추정된 잔여 시간을 볼 수 있습니다.
추정 추가
전제 조건:
- 이슈의 경우 프로젝트에 대한 적어도 기고자(role) 역할이 있어야 합니다.
- Merge Request의 경우 프로젝트에 대한 적어도 개발자(role) 역할이 있어야 합니다.
추정을 입력하려면 /estimate
빠른 조치 다음에 시간을 입력하세요.
예를 들어, 1달 2주 3일 4시간 5분의 추정을 입력해야 하는 경우, /estimate 1mo 2w 3d 4h 5m
을 입력하십시오.
사용 가능한 시간 단위를 확인하세요.
이슈나 Merge Request에는 한 가지 추정만 할 수 있습니다. 새로운 시간 추정을 입력할 때마다 이전 값을 덮어씁니다.
추정 삭제
전제 조건:
- 이슈의 경우 프로젝트에 대한 적어도 기고자(role) 역할이 있어야 합니다.
- Merge Request의 경우 프로젝트에 대한 적어도 개발자(role) 역할이 있어야 합니다.
추정을 완전히 제거하려면 /remove_estimate
빠른 조치를 사용하세요.
소요된 시간
작업 중에 사용한 시간을 기록할 수 있습니다.
각 새로운 시간 기입은 이슈나 Merge Request에 대한 현재 총 작업 시간에 추가됩니다.
이슈나 Merge Request에 소요된 시간의 총량은 1년을 초과할 수 없습니다.
소요 시간 추가
전제 조건:
- 프로젝트에 대한 적어도 기고자(role) 역할이 있어야 합니다.
사용자 인터페이스 사용
- GitLab 15.7에서 도입되었습니다.
- GitLab 17.0에서 변경되었습니다. 시간을 명시하지 않으면 현재 시간이 사용됩니다.
사용자 인터페이스를 사용하여 시간 기록을 추가하려면 다음을 수행하세요:
- 사이드바의 시간 추적 섹션에서 시간 기록 추가()를 선택하면 대화 상자가 엽니다.
-
다음을 입력합니다:
- 사용한 시간의 양.
- 옵션: 사용한 날짜. 비어 있으면 현재 시간이 사용됩니다.
- 옵션: 요약.
- 저장을 선택합니다.
사이드바의 소요 시간이 업데이트되며 모든 항목을 시간 추적 보고서에서 볼 수 있습니다.
빠른 조치 사용
사용한 시간을 입력하려면 /spend
빠른 조치 뒤에 시간을 입력하세요.
예를 들어, 1달 2주 3일 4시간 5분을 기록해야 하는 경우, /spend 1mo 2w 3d 4h 5m
을 입력하십시오.
사용 가능한 시간 단위를 확인하세요.
시간 추적 보고서에 노트를 추가하려면 설명과 빠른 조치를 사용하여 댓글을 작성합니다. 그럼 시간 추적 보고서 요약/노트 열에 표시됩니다. 예를 들어:
Draft MR and respond to initial comments
/spend 30m
시간이 사용된 날짜를 기록하려면 시간 뒤에 YYYY-MM-DD
형식으로 날짜를 입력합니다.
예를 들어, 2021년 1월 31일에 사용된 1시간을 기록하려면 /spend 1h 2021-01-31
을 입력합니다.
미래 날짜를 입력하면 시간이 기록되지 않습니다.
소요 시간 감산
전제 조건:
- 프로젝트에 대한 적어도 기고자(role) 역할이 있어야 합니다.
시간을 감산하려면 음수 값을 입력하세요. 예를 들어, /spend -3d
는 총 소요 시간에서 세 날을 제거합니다. 이미 입력된 시간보다 더 많은 시간을 제거할 수 없으며, 0분 미만의 시간을 기록할 수 없으므로 이미 입력된 것보다 많은 시간을 제거하려고 하면 GitLab은 감산을 무시합니다.
소요된 시간 삭제
- GitLab 15.1에서 삭제 버튼이 도입되었습니다.
시간 기록은 양수 또는 음수인 시간을 기록하는 단일 항목입니다.
전제 조건:
- 시간 기록자이거나 프로젝트에 대한 적어도 관리자(role) 역할이 있어야 합니다.
시간 기록을 삭제하려면 다음 중 하나를 수행합니다:
- 시간 추적 보고서에서 시간 기록 항목 오른쪽에 있는 소요 시간 삭제()를 선택합니다.
- GraphQL API를 사용합니다.
소요된 모든 시간 삭제
전제 조건:
- 프로젝트에 대한 적어도 기고자(role) 역할이 있어야 합니다.
한 번에 모든 소요 시간을 삭제하려면 /remove_time_spent
빠른 조치를 사용하세요.
시간 추적 보고서 보기
이슈 또는 Merge Request에 대한 시간 추적 보고서
이슈나 Merge Request에 소요된 시간에 대한 시간 추적 보고서를 보려면 다음을 수행하세요:
- 이슈 또는 Merge Request으로 이동합니다.
- 오른쪽 사이드바에서 시간 추적 보고서를 선택합니다.
표시된 소요 시간의 세부내용은 최대 100개까지 제한됩니다.
전역 시간 추적 보고서
- GitLab 15.11에서 플래그
global_time_tracking_report
라는 피처 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.- GitLab.com에서는 GitLab 16.5에서 활성화되었습니다.
기본적으로 이 기능은 Self-Managed GitLab에서 사용할 수 없습니다. 사용하려면 관리자가 global_time_tracking_report
라는 피처 플래그를 활성화해야 합니다. GitLab.com에서는 이 기능을 사용할 수 있지만, GitLab Dedicated에서는 사용할 수 없습니다. 또한 이 기능은 아직 제품용으로 준비되지 않았습니다.
GitLab 전역에서 이슈와 Merge Request에 대한 소요 시간 보고서를 확인할 수 있습니다.
이 기능은 실험 중인 기능입니다. 버그를 발견하면 피드백 이슈에 알려주세요.
전역 시간 추적 보고서를 보려면 다음을 수행하세요:
- 브라우저에서 전역 보고서의 URL을 입력합니다:
- Self-Managed인 경우 기본 URL에
/-/timelogs
를 추가합니다. 예:https://gitlab.example.com/-/timelogs
. - GitLab.com의 경우 https://gitlab.com/-/timelogs로 이동합니다.
- Self-Managed인 경우 기본 URL에
- 옵션: 특정 사용자로 필터링하려면
@
기호 없이 사용자 이름을 입력합니다. - 시작 및 종료 날짜를 선택합니다.
- 보고서 실행을 선택합니다.
사용 가능한 시간 단위
다음 시간 단위를 사용할 수 있습니다:
시간 단위 | 입력 방법 | 변환율 |
---|---|---|
월 |
mo , month , 또는 months
| 4 주 (160 시간) |
주 |
w , week , 또는 weeks
| 5 일 (40 시간) |
일 |
d , day , 또는 days
| 8 시간 |
시간 |
h , hour , 또는 hours
| 60 분 |
분 |
m , minute , 또는 minutes
|
표시된 단위를 시간으로 제한
GitLab Self-Managed 인스턴스에서 시간 단위의 표시를 시간으로 제한할 수 있습니다. 다음과 같이 진행하세요:
- 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
- 설정 > 기본 설정을 선택합니다.
- 로캘화를 확장합니다.
- 시간 추적 아래에서 시간 추적 단위의 표시를 시간으로 제한 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
이 옵션을 활성화하면 1w 4d 3h
대신 75h
가 표시됩니다.