• 예상
  • 예상 추가
  • 예상 제거
• 사용한 시간
  • 사용한 시간 추가
    • 사용자 인터페이스 사용
    • 빠른 조치 사용
  • 사용한 시간 빼기
  • 사용한 시간 삭제
  • 모든 소요 시간 삭제
• 항목의 시간 추적 보고서 보기
• 전체 시간 추적 보고서
• 사용 가능한 시간 단위
  • 표시된 단위 제한을 시간으로 설정하기
• 관련 주제

시간 추적

• GitLab 17.0에서 작업을 추적하는 시간 추적이 소개되었습니다.
• GitLab 17.5에서 이야기를 추적하는 시간 추적이 소개되었습니다. 귀하의 관리자는 epics의 새로운 디자인을 활성화해야 합니다.

epic과 관련한 새로운 디자인을 활성화해야 합니다. - issue - task - merge request.

그런 다음 해당 항목에 든 시간을 추적하는 보고서를 확인할 수 있습니다.

이러한 작업에 시간 추적을 사용하세요:

• 항목에 작업한 시간을 기록합니다.
• 항목을 완료하는 데 필요한 총 시간을 추가하거나 업데이트합니다.
• 항목에 작업한 시간의 세부 정보를 확인합니다.

작업한 시간을 입력하거나 제거하려면 빠른 조치를 사용해야 합니다. 각 빠른 조치를 개별 라인에 입력하세요. 한 댓글에서 하나의 빠른 조치를 여러 번 사용하면 마지막 동작만 적용됩니다.

시간 추적에 대한 데이터를 오른쪽 사이드바에서 확인할 수 있습니다:

예상

예상 값은 항목을 완료하는 데 필요한 총 시간을 보여주기 위해 만들어졌습니다.

오른쪽 사이드바에 있는 시간 추적 정보 위로 마우스를 가져가면 남은 예상 시간을 볼 수 있습니다.

예상 추가

사전 요구 사항: - issue의 경우 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다. - task의 경우 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다. - merge request의 경우 해당 프로젝트에 적어도 Developer 역할이 있어야 합니다.

예상을 입력하려면 /estimate 빠른 조치를 사용한 후 시간을 입력하세요.

예를 들어, 1달 2주 3일 4시간 5분의 예상을 입력해야 한다면, /estimate 1mo 2w 3d 4h 5m을 입력하세요. 사용 가능한 시간 단위를 확인하세요.

항목 당 하나의 예상만 있을 수 있습니다. 새로운 시간 예상을 입력할 때마다 이전 값이 덮어쓰입니다.

예상 제거

사전 요구 사항: - issue의 경우 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다. - task의 경우 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다. - merge request의 경우 해당 프로젝트에 적어도 Developer 역할이 있어야 합니다.

예상을 완전히 제거하려면 /remove_estimate 빠른 조치를 사용하세요.

사용한 시간

작업 중에 사용한 시간을 기록할 수 있습니다.

새로운 시간 기록 항목은 issue, task 또는 merge request의 현재 총 작업 시간에 추가됩니다.

issue, task 또는 merge request에 사용한 총 시간은 1년을 초과할 수 없습니다.

사용한 시간 추가

사전 요구 사항: - 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다.

사용자 인터페이스 사용

• GitLab 15.7에서 소개되었습니다.
• GitLab 17.0에서 변경되었습니다. 시간을 지정하지 않으면 현재 시간이 사용됩니다.

사용자 인터페이스를 사용하여 시간 기록을 추가하려면 다음을 수행합니다:

1. 사이드바의 시간 추적 섹션에서 시간 기록 추가 ()를 선택합니다. 대화 상자가 열립니다.

2. 다음을 입력하세요:

   • 사용한 시간.
   • 선택 사항: 사용한 시간.
   • 선택 사항: 요약.
3. 저장을 선택합니다.

사이드바의 사용한 시간 총계가 업데이트되고 시간 추적 보고서에서 모든 항목을 볼 수 있습니다.

빠른 조치 사용

사용한 시간을 입력하려면 /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을 입력하세요.

미래 날짜를 입력하면 시간이 기록되지 않습니다.

사용한 시간 빼기

사전 요구 사항: - 해당 프로젝트에 적어도 Repoter 역할이 있어야 합니다.

시간을 빼려면 음수 값을 입력하세요. 예를 들어, /spend -3d을 입력하면 총 작업 시간에서 세 시간이 제거됩니다. 이미 입력된 작업 시간보다 많이 제거하지는 못하며, 0분 미만으로 내려가지 않습니다. 따라서 입력된 시간보다 많이 제거하려고 하면 GitLab에서 제거를 무시합니다.

사용한 시간 삭제

• GitLab 15.1에서 삭제 버튼이 추가되었습니다.

시간 기록은 양수 또는 음수의 사용 시간을 나타내는 단일 항목입니다.

사전 요구 사항: - 시간 기록의 작성자이거나 해당 프로젝트에 적어도 Maintainer 역할이 있어야 합니다.

시간 기록을 삭제하려면 다음 중 하나를 수행하세요: - 시간 추적 보고서에서 시간 기록 항목 오른쪽에 사용한 시간 삭제 ()를 선택합니다. - GraphQL API를 사용합니다.

모든 소요 시간 삭제

필수 조건:

• 프로젝트에 대해 적어도 기고자 역할이 있어야 합니다.

모든 소요 시간을 한꺼번에 삭제하려면 /remove_time_spent 빠른 조치를 사용하세요.

항목의 시간 추적 보고서 보기

항목에 소요된 시간 추적 보고서를 보려면 다음을 수행하세요:

• 이슈나 병합 요청의 경우:

  1. 해당 이슈나 병합 요청으로 이동합니다.
  2. 오른쪽 사이드바에서 시간 추적 보고서를 선택합니다.

• epic이나 태스크의 경우:

  1. 해당 epic이나 태스크로 이동합니다.
  2. 오른쪽 사이드바에서 Spent 옆의 시간을 선택합니다.

표시된 소요 시간의 분해는 최대 100개의 항목으로 제한됩니다.

전체 시간 추적 보고서

• GitLab 15.11에서 global_time_tracking_report라는 플래그로 도입되었으며 기본적으로 비활성화됩니다.
• GitLab 16.5에서 GitLab.com에서 활성화됩니다.

GitLab 전체에서 이슈, 태스크 및 병합 요청에 사용된 시간의 보고서를 보여줍니다.

이 기능은 실험 중입니다. 버그를 찾으면 피드백 이슈에서 알려주세요.

전역 시간 추적 보고서를 보려면 다음을 수행하세요:

1. 브라우저에서 전역 보고서의 URL을 입력합니다:
   • 자체 호스팅의 경우, 기본 URL에 /-/timelogs를 추가합니다. 예: https://gitlab.example.com/-/timelogs.
   • GitLab.com의 경우, https://gitlab.com/-/timelogs로 이동합니다.
2. 선택 사항. 특정 사용자로 필터링하려면 @ 기호 없이 사용자 이름을 입력합니다.
3. 시작 및 종료 날짜를 선택합니다.
4. 보고 실행을 선택합니다.

사용 가능한 시간 단위

다음과 같은 시간 단위를 사용할 수 있습니다:

표시된 단위 제한을 시간으로 설정하기

GitLab 자체 호스팅 인스턴스에서 시간 단위의 표시를 시간 단위로 제한할 수 있습니다. 다음을 수행하세요:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
2. 설정 > 기본 설정을 선택합니다.
3. 지역화를 확장합니다.
4. 시간 추적 아래에서 시간 추적 단위의 표시 제한 확인란을 선택합니다.
5. 변경 사항 저장을 선택합니다.

이 옵션을 활성화하면 75h 대신 1w 4d 3h가 표시됩니다.

관련 주제

• 시간 추적 GraphQL 참조:
  • 연결
  • Edge
  • 필드
  • Timelogs
  • 그룹 timelogs
  • 프로젝트 Timelogs
  • 사용자 Timelogs