히스토리

• 이터레이션에 인시던트를 추가하는 기능이 GitLab 17.0에서 도입되었습니다.

이 페이지에는 인시던트와 관련해 수행할 수 있는 모든 작업에 대한 안내가 정리되어 있습니다.

인시던트 생성#

인시던트는 수동 또는 자동으로 생성할 수 있습니다.

인시던트를 이터레이션에 추가#

인시던트를 이터레이션에 추가하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 인시던트로 이동합니다:
   • 이슈 목록에 있는 인시던트의 경우 Plan > Work items를 선택한 다음 Type = Incident로 필터링합니다.
   • 모니터 목록에 있는 인시던트의 경우 Monitor > Incidents를 선택합니다.
3. 인시던트를 선택합니다.
4. 오른쪽 사이드바의 Iteration 섹션에서 Edit를 선택합니다.
5. 드롭다운 목록에서 이 인시던트를 추가할 이터레이션을 선택합니다.
6. 드롭다운 목록 밖의 영역을 선택합니다.

또는 /iteration 퀵 액션을 사용할 수 있습니다.

Incidents 페이지에서#

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

Incidents 페이지에서 인시던트를 생성하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Monitor > Incidents를 선택합니다.
3. Create incident를 선택합니다.

Work items 페이지에서#

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

Work items 페이지에서 인시던트를 생성하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택하고 New item을 선택합니다.
3. Type 드롭다운 목록에서 Incident를 선택합니다. 이 경우 페이지에는 인시던트와 관련된 필드만 표시됩니다.
4. Create incident를 선택합니다.

알림에서#

알림을 보는 중에 인시던트 이슈를 생성할 수 있습니다. 인시던트 설명은 알림에서 채워집니다.

사전 요구 사항:

• 프로젝트에 대해 Developer, Maintainer, Owner 권한이 있어야 합니다.

알림에서 인시던트를 생성하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Monitor > Alerts를 선택합니다.
3. 원하는 알림을 선택합니다.
4. Create incident를 선택합니다.

인시던트가 생성된 후 알림에서 이를 확인하려면 View incident를 선택합니다.

알림과 연결된 인시던트를 닫으면 GitLab 이 알림의 상태를 변경하여 Resolved로 설정합니다. 이때 알림의 상태 변경에 대한 크레딧이 본인에게 부여됩니다.

알림이 트리거될 때 자동으로#

프로젝트 설정에서 알림이 트리거될 때마다 인시던트를 자동으로 생성하도록 설정할 수 있습니다.

PagerDuty 웹훅 사용#

PagerDuty와 웹훅을 설정하면 PagerDuty 인시던트마다 GitLab 인시던트를 자동으로 생성할 수 있습니다. 이 설정을 하려면 PagerDuty와 GitLab 양쪽에서 변경 작업이 필요합니다.

사전 요구 사항:

• 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.

PagerDuty와 웹훅을 설정하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > Monitor를 선택합니다
3. Incidents를 확장합니다.
4. PagerDuty integration 탭을 선택합니다.
5. Active 토글을 켭니다.
6. Save integration을 선택합니다.
7. 나중 단계에서 사용할 수 있도록 Webhook URL 값을 복사합니다.
8. 웹훅 URL을 PagerDuty 웹훅 통합에 추가하려면 PagerDuty 문서에 설명된 단계를 따릅니다.

통합이 성공했는지 확인하려면 PagerDuty에서 테스트 인시던트를 트리거하여 해당 인시던트로부터 GitLab 인시던트가 생성되는지 확인합니다.

인시던트 목록 보기#

인시던트 목록을 보려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Monitor > Incidents를 선택합니다.

인시던트의 상세 페이지를 보려면 목록에서 해당 항목을 선택합니다.

인시던트를 볼 수 있는 사용자#

히스토리

• GitLab 17.7에서 최소 사용자 권한이 Reporter에서 Planner로 변경되었습니다.

인시던트를 볼 수 있는지 여부는 프로젝트 공개 수준과 인시던트의 기밀 상태에 따라 달라집니다:

• 공개 프로젝트이고 비기밀 인시던트인 경우: 누구나 인시던트를 볼 수 있습니다.
• 비공개 프로젝트이고 비기밀 인시던트인 경우: 프로젝트에 대해 Guest, Planner, Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.
• 기밀 인시던트인 경우(프로젝트 공개 수준과 무관): 프로젝트에 대해 Planner, Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

사용자에게 할당#

적극적으로 대응하고 있는 사용자에게 인시던트를 할당합니다.

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

사용자를 할당하려면 다음과 같이 합니다:

1. 인시던트에서 오른쪽 사이드바의 Assignees 옆에 있는 Edit를 선택합니다.
2. 드롭다운 목록에서 assignees로 추가할 사용자 한 명 또는 여러 명을 선택합니다.
3. 드롭다운 목록 밖의 영역을 선택합니다.

심각도 변경#

사용 가능한 심각도 수준에 대한 전체 설명은 인시던트 목록 항목을 참고합니다.

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

인시던트의 심각도를 변경하려면 다음과 같이 합니다:

1. 인시던트에서 오른쪽 사이드바의 Severity 옆에 있는 Edit를 선택합니다.
2. 드롭다운 목록에서 새 심각도를 선택합니다.

/severity 퀵 액션을 사용해 심각도를 변경할 수도 있습니다.

상태 변경#

사전 요구 사항:

• 프로젝트에 대해 Developer, Maintainer, Owner 권한이 있어야 합니다.

인시던트의 상태를 변경하려면 다음과 같이 합니다:

1. 인시던트에서 오른쪽 사이드바의 Status 옆에 있는 Edit를 선택합니다.
2. 드롭다운 목록에서 새 심각도를 선택합니다.

Triggered는 신규 인시던트의 기본 상태입니다.

온콜 담당자로서#

온콜 담당자는 상태를 변경하여 인시던트 페이징에 대응할 수 있습니다.

상태를 변경하면 다음과 같은 효과가 있습니다:

• Acknowledged로 변경: 프로젝트의 에스컬레이션 정책에 따라 온콜 페이징을 제한합니다.
• Resolved로 변경: 해당 인시던트에 대한 모든 온콜 페이징을 무음 처리합니다.
• Resolved에서 Triggered로 변경: 인시던트의 에스컬레이션을 재시작합니다.

알림에서 생성된 인시던트의 경우, 알림 상태는 독립적이며 인시던트 상태가 변경되어도 함께 변경되지 않습니다.

에스컬레이션 정책 변경#

사전 요구 사항:

• 프로젝트에 대해 Developer, Maintainer, Owner 권한이 있어야 합니다.

인시던트의 에스컬레이션 정책을 변경하려면 다음과 같이 합니다:

1. 인시던트에서 오른쪽 사이드바의 Escalation policy 옆에 있는 Edit를 선택합니다.
2. 드롭다운 목록에서 에스컬레이션 정책을 선택합니다.

기본적으로 신규 인시던트에는 에스컬레이션 정책이 선택되어 있지 않습니다.

에스컬레이션 정책을 선택하면 인시던트 상태가 변경되어 Triggered가 되고 온콜 담당자에게 인시던트를 에스컬레이션하기 시작합니다.

알림에서 생성된 인시던트의 경우, 인시던트의 에스컬레이션 정책은 독립적이며 변경할 수 있습니다.

인시던트 닫기#

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한이 있어야 합니다.

인시던트를 닫으려면 오른쪽 위 모서리에서 Incident actions (⋮)를 선택한 다음 Close incident를 선택합니다.

알림과 연결된 인시던트를 닫으면 연결된 알림의 상태가 Resolved로 변경됩니다. 이때 알림의 상태 변경에 대한 크레딧이 본인에게 부여됩니다.

복구 알림을 통해 인시던트 자동으로 닫기#

GitLab 이 HTTP 또는 Prometheus 웹훅으로부터 복구 알림을 수신하면 인시던트를 자동으로 닫도록 설정합니다.

사전 요구 사항:

• 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.

설정을 구성하려면 다음과 같이 합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > Monitor를 선택합니다.
3. Incidents 섹션을 확장합니다.
4. Automatically close associated incident 체크박스를 선택합니다.
5. Save changes를 선택합니다.

GitLab 이 복구 알림을 수신하면 연결된 인시던트를 닫습니다. 이 작업은 GitLab Alert 봇에 의해 자동으로 닫혔음을 나타내는 시스템 노트로 인시던트에 기록됩니다.

인시던트 삭제#

사전 요구 사항:

• 프로젝트에 대해 Owner 권한이 있어야 합니다.

인시던트를 삭제하려면 다음과 같이 합니다:

1. 인시던트에서 Incident actions (⋮)를 선택합니다.
2. Delete incident를 선택합니다.

또는 다음과 같이 합니다:

1. 인시던트에서 Edit를 선택합니다.
2. Delete incident를 선택합니다.

기타 작업#

GitLab의 인시던트는 이슈를 기반으로 구축되므로 다음과 같은 작업을 공통으로 제공합니다:

• 할 일 항목 추가
• 레이블 추가
• 마일스톤 할당
• 인시던트를 기밀로 설정
• 기한 설정
• 알림 켜기/끄기
• 소요 시간 추적