시간 추적
이슈 및 Merge Request에 소요된 시간을 추정하고 추적할 수 있습니다.
그런 다음 시간에 따른 총계를 보여주는 보고서를 확인할 수 있습니다.
이러한 작업에 시간 추적을 사용하세요:
- 이슈나 Merge Request에서 작업한 시간을 기록합니다.
- 이슈나 Merge Request을 완료하는 데 필요한 총 시간을 추가하거나 업데이트합니다.
- 이슈나 Merge Request에서 작업한 시간을 세부적으로 확인합니다.
시간을 입력하거나 제거하려면 빠른 작업을 사용해야 합니다. 각 빠른 작업을 개별 줄에 입력하세요. 하나의 댓글에서 동일한 빠른 작업을 여러 번 사용하면 마지막 작업만 적용됩니다.
이슈와 Merge Request의 오른쪽 사이드바에서 시간 추적 데이터를 확인할 수 있습니다:
추정
추정은 이슈나 Merge Request을 완료하는 데 필요한 총 시간을 보여주기 위해 설계되었습니다.
오른쪽 사이드바의 시간 추적 정보 위로 마우스를 가져가면 추정 시간이 표시됩니다.
추정 추가
전제 조건:
- 이슈의 경우 프로젝트에 적어도 기고자 역할이 필요합니다.
- Merge Request의 경우 프로젝트에 적어도 개발자 역할이 필요합니다.
추정을 입력하려면 /estimate 빠른 작업을 사용한 후 시간을 입력하세요.
예를 들어, 1달 2주 3일 4시간 5분을 추정하려면 /estimate 1mo 2w 3d 4h 5m을 입력하세요. 사용 가능한 시간 단위를 확인하세요.
이슈나 Merge Request에는 하나의 추정만 있을 수 있습니다. 새로운 시간 추정을 입력할 때마다 이전 값을 덮어쓰게 됩니다.
추정 제거
전제 조건:
- 이슈의 경우 프로젝트에 적어도 기고자 역할이 필요합니다.
- Merge Request의 경우 프로젝트에 적어도 개발자 역할이 필요합니다.
추정을 완전히 제거하려면 /remove_estimate 빠른 작업을 사용하세요.
소요된 시간
작업하는 동안 소요된 시간을 기록할 수 있습니다.
새로운 시간 기록 항목은 이슈나 Merge Request에 대한 현재 총 작업 시간에 추가됩니다.
이슈나 Merge Request에 소요된 총 시간은 1년을 초과할 수 없습니다.
소요된 시간 추가
전제 조건:
- 프로젝트에 적어도 기고자 역할이 필요합니다.
사용자 인터페이스 사용
- 소개됨 in GitLab 15.7.
사용자 인터페이스를 사용하여 시간 항목을 추가하려면:
- 사이드바의 시간 추적 섹션에서 시간 항목 추가 ()를 선택합니다. 대화 상자가 열립니다.
-
다음을 입력하세요:
- 소요된 시간.
- 선택 사항. 소요된 시간.
- 선택 사항. 요약.
- 저장을 선택합니다.
사이드바의 소요된 합계가 업데이트되고 시간 추적 보고서에서 모든 항목을 확인할 수 있습니다.
빠른 작업 사용
소요된 시간을 입력하려면 /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을 입력하세요.
미래 날짜를 입력하면 시간이 기록되지 않습니다.
소요된 시간 빼기
전제 조건:
- 프로젝트에 적어도 기고자 역할이 필요합니다.
소요된 시간을 빼려면 음수 값을 입력하세요. 예를 들어, /spend -3d은 총 소요된 시간에서 세 날을 제거합니다. 이미 입력된 시간보다 많이 빼려고 하면 0분 이하의 시간은 불가능하므로 GitLab은 뺄셈을 무시합니다.
소요된 시간 삭제
소요된 시간은 양수나 음수로 나타나는 하나의 시간 기록 항목입니다.
전제 조건:
- 시간 추적 보고서에서 기록한 사람이거나 프로젝트에 적어도 관리자 역할이 필요합니다.
시간 기록 항목을 삭제하려면 다음 중 하나를 사용하세요:
- 시간 추적 보고서에서 시간 기록 항목이 오른쪽에 나타날 때 소요된 시간 삭제 ()를 선택하세요.
- GraphQL API를 사용하세요.
전체 소요된 시간 삭제
전제 조건:
- 프로젝트에 적어도 기고자 역할이 필요합니다.
모든 소요된 시간을 한꺼번에 삭제하려면 /remove_time_spent 빠른 작업을 사용하세요.
시간 추적 보고서 보기
이슈나 Merge Request의 경우
이슈나 Merge Request에 소요된 시간을 보여주는 시간 추적 보고서를 보려면:
- 이슈나 Merge Request으로 이동합니다.
- 오른쪽 사이드바에서 시간 추적 보고서를 선택합니다.
표시되는 소요된 시간의 세부 사항은 최대 100개의 항목으로 제한됩니다.
글로벌 시간 추적 보고서
- 이슈 344002에서 소개된 기능으로, 기본적으로 비활성화된
global_time_tracking_report라는 플래그로 GitLab 15.11에서 소개되었습니다.- GitLab 16.5에서 GitLab.com에서 활성화되었습니다.
플래그:
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가 표시됩니다.
도움말