시간 추적
이슈와 병합 요청에 소요된 시간을 추정하고 추적할 수 있습니다.
그 후 시간 추적 보고서를 확인하여 시간에 따른 총계를 볼 수 있습니다.
다음과 같은 작업에 시간 추적을 사용합니다.
- 이슈나 병합 요청에 대해 작업한 시간을 기록합니다.
- 이슈나 병합 요청을 완료하기까지 필요한 총 소요 시간을 추가하거나 업데이트합니다.
- 이슈나 병합 요청에 대한 작업에 사용된 시간을 자세히 볼 수 있습니다.
소요 시간을 입력하거나 입력한 시간을 표시하지 않아도 됩니다.
시간 추적 데이터를 입력하고 제거하려면 빠른 조치를 사용해야 합니다. 각 빠른 조치는 개별 라인에서 입력해야 합니다. 하나의 주석에서 한 가지 빠른 조치를 여러 번 사용하더라도 마지막으로 나온 빠른 조치만 적용됩니다.
이슈와 병합 요청의 오른쪽 사이드바에서 시간 추적 데이터를 확인할 수 있습니다:
추정
추정은 이슈나 병합 요청을 완료하는 데 필요한 총 소요 시간을 보여주기 위해 만들어졌습니다.
오른쪽 사이드바의 시간 추적 정보 위로 마우스를 올리면 추정된 남은 시간을 볼 수 있습니다.
추정 추가
필수조건:
- 이슈의 경우, 프로젝트에 대한 기고자 역할 이상이어야 합니다.
- 병합 요청의 경우, 프로젝트에 대한 개발자 역할 이상이어야 합니다.
추정을 입력하려면 /estimate
빠른 조치를 사용한 뒤 시간을 입력합니다.
예를 들어, 1달 2주 3일 4시간 5분의 추정을 입력해야 하는 경우, /estimate 1mo 2w 3d 4h 5m
과 같이 입력합니다. 사용할 수 있는 시간 단위를 확인하세요.
이슈나 병합 요청에는 하나의 추정만 설정할 수 있습니다. 새로운 추정을 입력할 때마다 이전 값을 덮어씁니다.
추정 제거
필수조건:
- 이슈의 경우, 프로젝트에 대한 기고자 역할 이상이어야 합니다.
- 병합 요청의 경우, 프로젝트에 대한 개발자 역할 이상이어야 합니다.
전체적으로 추정을 삭제하려면 /remove_estimate
빠른 조치를 사용합니다.
사용한 시간
작업하는 동안에 소요된 시간을 기록할 수 있습니다.
새로운 시간 기록 항목은 현재 총 작업 시간에 추가됩니다. 이슈나 병합 요청에 소요된 총 시간은 1년을 초과할 수 없습니다.
소요된 시간 추가
필수조건:
- 프로젝트에 대한 기고자 역할 이상이어야 합니다.
사용자 인터페이스 사용
사용자 인터페이스를 사용하여 시간 항목을 추가하려면:
- 사이드바의 시간 추적 섹션에서 시간 항목 추가 ()를 선택합니다. 대화상자가 열립니다.
-
다음을 입력합니다:
- 소요된 시간.
- 선택 사항. 소요된 시점.
- 선택 사항. 개요.
- 저장을 선택합니다.
사이드바의 소요된 시간이 업데이트되고 시간 추적 보고서에서 모든 항목을 볼 수 있습니다.
빠른 조치 사용
소요된 시간을 입력하려면 /spend
빠른 조치를 사용한 뒤 시간을 입력합니다.
예를 들어, 1달 2주 3일 4시간 5분을 기록해야 하는 경우, /spend 1mo 2w 3d 4h 5m
과 같이 입력합니다. 사용할 수 있는 시간 단위를 확인하세요.
시간 추적 보고서 항목에 설명과 빠른 조치로 주석을 생성하여 추가할 수 있습니다. 이후 시간 추적 보고서의 요약/노트 열에 표시됩니다. 예:
드래프트 MR 및 초기 코멘트에 응답
/spend 30m
시간 소요 기록을 남기려면, YYYY-MM-DD
형식을 사용하여 시간 뒤에 날짜를 입력합니다.
예를 들어, 2021년 1월 31일에 1시간을 사용하여 작업을 기록하려면, /spend 1h 2021-01-31
을 입력합니다.
미래 날짜를 입력하는 경우 시간이 기록되지 않습니다.
소요된 시간 감소
필수조건:
- 프로젝트에 대한 기고자 역할 이상이어야 합니다.
시간을 감소하려면 음수 값을 입력합니다. 예를 들어, /spend -3d
은 소요된 시간에서 세 날을 빼줍니다. 이미 입력한 시간보다 많은 시간을 빼려고 하면 GitLab이 감산을 무시합니다. 최소 소요 시간은 0분 미만으로 내려갈 수 없으므로 이미 입력한 시간보다 많은 시간을 빼다시피하면 GitLab이 감산을 무시합니다.
시간 소비 삭제
타임로그는 양수 또는 음수인 시간 소비의 단일 항목입니다.
필수 조건:
- 타임로그의 작성자이거나 프로젝트에 대한 관리자(Maintainer) 역할 이상의 권한이 있어야 합니다.
타임로그를 삭제하려면 다음 중 하나를 수행하십시오:
- 시간 추적 보고서에서 타임로그 항목 오른쪽에 있는 시간 소비 삭제를 선택합니다 ().
- GraphQL API를 사용합니다.
전체 시간 소비 삭제
필수 조건:
- 프로젝트에 대한 기술 지원자(Reporter) 역할 이상의 권한이 있어야 합니다.
일괄적으로 모든 소요 시간을 삭제하려면 /remove_time_spent
빠른 작업을 사용하십시오.
시간 추적 보고서 보기
이슈 또는 병합 요청에 대해
이슈 또는 병합 요청에 소요된 시간 추적 보고서를 보려면:
- 이슈 또는 병합 요청으로 이동합니다.
- 우측 사이드바에서 시간 추적 보고서를 선택합니다.
표시된 소요 시간의 분할은 최대 100개 항목으로 제한됩니다.
전역 시간 추적 보고서
플래그: 자체 관리 GitLab에서 이 기능은 기본적으로 사용할 수 없습니다. 사용하려면 관리자가 피처 플래그를 활성화할 수 있습니다. GitLab.com에서는 이 기능을 사용할 수 있습니다. GitLab Dedicated에서는 이 기능을 사용할 수 없습니다. 이 기능은 실제 운영에 사용할 준비가 되어 있지 않습니다.
모든 GitLab에서의 이슈 및 병합 요청에서 소요된 시간의 보고서를 볼 수 있습니다.
이 기능은 실험(Experiment)입니다. 버그를 발견하면 피드백 이슈에서 알려주십시오.
전역 시간 추적 보고서를 보려면:
- 브라우저에서 전역 보고서 URL을 입력합니다:
- 자체 관리: 기본 URL에
/-/timelogs
를 추가하십시오. 예:https://gitlab.example.com/-/timelogs
. - GitLab.com: https://gitlab.com/-/timelogs.
- 자체 관리: 기본 URL에
- 선택 사항. 특정 사용자로 필터링하려면
@
기호 없이 사용자 이름을 입력합니다. - 시작 및 종료 날짜를 선택합니다.
- 보고서 실행을 선택합니다.
사용 가능한 시간 단위
다음과 같은 시간 단위를 사용할 수 있습니다:
시간 단위 | 입력 방법 | 변환율 |
---|---|---|
월 |
mo , month 또는 months
| 4주 (160시간) |
주 |
w , week 또는 weeks
| 5일 (40시간) |
일 |
d , day 또는 days
| 8시간 |
시간 |
h , hour 또는 hours
| 60분 |
분 |
m , minute 또는 minutes
|
시간 단위 표시 제한
GitLab 자체 관리 인스턴스에서 시간 단위의 표시를 시간 단위로 제한할 수 있습니다. 다음을 수행하려면:
- 좌측 사이드바에서 검색 또는 이동을 선택합니다.
- 설정 > 환경설정을 선택합니다.
- 로컬라이제이션을 확장합니다.
- 시간 추적 아래에서 시간 추적 단위의 표시 제한 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
이 옵션을 활성화하면 75시간
대신에 1주 4일 3시간
이 표시됩니다.
관련 주제
- 시간 추적 GraphQL 참조: