사고 관리
세부사항:
Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
- GitLab 17.0에서 도입된 사고를 반복(iteration)에 추가하는 기능.
이 페이지는 사고와 관련하여 수행할 수 있는 모든 작업에 대한 지침을 수집합니다.
사고 생성
사고를 수동으로 또는 자동으로 생성할 수 있습니다.
반복(iteration)에 사고 추가
세부사항:
Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
반복(iteration)에 사고를 추가하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 계획(Plan) > 이슈(Issues) 또는 모니터(Monitor) > 사고(Incidents)를 선택한 후, 사고를 선택하여 봅니다.
- 오른쪽 사이드바에서 반복(Iteration) 섹션에서 편집(Edit)을 선택합니다.
- 드롭다운 목록에서 이 사고를 추가할 반복을 선택합니다.
- 드롭다운 목록 외부의 아무 영역을 선택합니다.
대안으로, /iteration 빠른 작업을 사용할 수 있습니다.
사고 페이지에서
사전 요구사항:
- 프로젝트에 대해 최소한 Reporter 역할이 필요합니다.
사고 페이지에서 사고를 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 모니터(Monitor) > 사고(Incidents)를 선택합니다.
- 사고 생성(Create incident)을 선택합니다.
이슈 페이지에서
사전 요구사항:
- 프로젝트에 대해 최소한 Reporter 역할이 필요합니다.
이슈 페이지에서 사고를 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 계획(Plan) > 이슈(Issues)를 선택하고 새 이슈(New issue)를 선택합니다.
- 유형(Type) 드롭다운 목록에서 사고(Incident)를 선택합니다. 사고와 관련된 필드만 페이지에서 사용 가능합니다.
- 이슈 생성(Create issue)을 선택합니다.
경고에서
경고를 볼 때 사고 이슈를 생성합니다.
사고 설명은 경고에서 자동으로 입력됩니다.
사전 요구사항:
- 프로젝트에 대해 최소한 Developer 역할이 필요합니다.
경고에서 사고를 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 모니터(Monitor) > 경고(Alerts)를 선택합니다.
- 원하는 경고를 선택합니다.
- 사고 생성(Create incident)을 선택합니다.
사고가 생성된 후, 경고에서 이를 보려면 사고 보기(View incident)를 선택합니다.
경고에 연결된 사고를 닫으면 GitLab이 경고의 상태를 해결됨(Resolved)으로 변경합니다.
이때 경고의 상태 변경에 대한 크레딧을 얻습니다.
자동으로, 경고가 발생할 때
세부사항:
Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
프로젝트 설정에서 경고가 발생할 때마다 사고를 자동으로 생성하도록 설정할 수 있습니다.
PagerDuty 웹후크 사용
- PagerDuty V3 웹후크 지원이 GitLab 15.7에서 도입됨.
PagerDuty와 함께 웹후크를 설정하여 각 PagerDuty 사고에 대해 GitLab 사고를 자동으로 생성할 수 있습니다. 이 구성은 PagerDuty와 GitLab 모두에서 변경이 필요합니다.
사전 요구사항:
- 프로젝트에 대해 최소한 Maintainer 역할이 필요합니다.
PagerDuty와 함께 웹후크를 설정하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정(Settings) > 모니터(Monitor)를 선택합니다.
- 사고(Incidents)를 확장합니다.
- PagerDuty 통합(PagerDuty integration) 탭을 선택합니다.
- 활성화(Active) 토글을 켭니다.
- 통합 저장(Save integration)을 선택합니다.
- 나중에 사용할 웹후크 URL(Webhook URL)의 값을 복사합니다.
- PagerDuty 웹후크 통합에 웹후크 URL을 추가하려면 PagerDuty 문서에 설명된 단계를 따릅니다.
통합이 성공적으로 이루어졌는지 확인하려면 PagerDuty에서 테스트 사고를 발생시켜 GitLab 사고가 생성되었는지 확인합니다.
사고 목록 보기
사고 목록을 보려면:
- 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾으세요.
- Monitor > Incidents를 선택하세요.
사고의 상세 페이지를 보려면 목록에서 선택하세요.
사고를 볼 수 있는 사람
사고를 볼 수 있는지는 프로젝트 가시성 수준 및 사고의 기밀성 상태에 따라 다릅니다:
- 공개 프로젝트 및 비기밀 사고: 누구나 사고를 볼 수 있습니다.
- 비공개 프로젝트 및 비기밀 사고: 최소한 프로젝트에 대해 게스트 역할이 있어야 합니다.
- 기밀 사고 (프로젝트 가시성과 관계없이): 최소한 프로젝트에 대해 리포터 역할이 있어야 합니다.
사용자에게 할당
사고에 응답 중인 사용자에게 사건을 할당하세요.
전제 조건:
- 프로젝트에 대해 최소한 리포터 역할이 있어야 합니다.
사용자를 할당하려면:
- 사고에서 오른쪽 사이드바의 Assignees 옆에 있는 Edit를 선택하세요.
- 드롭다운 목록에서 assignees로 추가할 하나 또는 여러 사용자를 선택하세요.
- 드롭다운 목록 바깥의 아무 영역을 선택하세요.
심각도 변경
사용 가능한 심각도 수준에 대한 전체 설명은 사고 목록 주제를 참조하세요.
전제 조건:
- 프로젝트에 대해 최소한 리포터 역할이 있어야 합니다.
사고의 심각도를 변경하려면:
- 사고에서 오른쪽 사이드바의 Severity 옆에 있는 Edit를 선택하세요.
- 드롭다운 목록에서 새로운 심각도를 선택하세요.
또한 /severity 빠른 작업을 사용하여 심각도를 변경할 수 있습니다.
상태 변경
-
Introduced in GitLab 14.9 with a flag named
incident_escalations. Disabled by default. - Enabled on GitLab.com and self-managed in GitLab 14.10.
-
Feature flag
incident_escalationsremoved in GitLab 15.1.
전제 조건:
- 프로젝트에 대해 최소한 개발자 역할이 있어야 합니다.
사고의 상태를 변경하려면:
- 사고에서 오른쪽 사이드바의 Status 옆에 있는 Edit를 선택하세요.
- 드롭다운 목록에서 새로운 심각도를 선택하세요.
Triggered는 새로운 사고에 대한 기본 상태입니다.
온콜 응답자로서
온콜 응답자는 상태를 변경하여 사고 페이지에 응답할 수 있습니다.
상태 변경은 다음과 같은 효과를 가집니다:
- Acknowledged로 변경: 프로젝트의 에스컬레이션 정책을 기반으로 온콜 페이지 제한.
- Resolved로 변경: 사고에 대한 모든 온콜 페이지 침묵.
- Resolved에서 Triggered로 변경: 사고의 에스컬레이션 재시작.
GitLab 15.1 및 이전 버전에서는 경고로 생성된 사고의 상태를 변경하면 경고 상태도 변경됩니다. GitLab 15.2 및 이후 버전에서는 경고 상태가 독립적이며 사고 상태가 변경될 때 변경되지 않습니다.
변경 에스컬레이션 정책
사전 요구 사항:
- 프로젝트에 대한 최소 할당량인 개발자 역할을 가져야 합니다.
사고의 에스컬레이션 정책을 변경하려면:
- 사고에서 오른쪽 사이드바에서 Escalation policy 옆에 있는 Edit를 선택합니다.
- 드롭다운 목록에서 에스컬레이션 정책을 선택합니다.
기본적으로 새로운 사고에는 선택된 에스컬레이션 정책이 없습니다.
에스컬레이션 정책을 선택하면 사고 상태를 변경합니다 Triggered로 변경되고 대기 중인 대응자에게 사고를 에스컬레이션하기 시작합니다.
GitLab 15.1 및 이전 버전에서는 알림에서 생성된 사고의 에스컬레이션 정책이 알림의 에스컬레이션 정책을 반영하며 변경할 수 없습니다. GitLab 15.2 이후에서는 사고 에스컬레이션 정책이 독립적이며 변경할 수 있습니다.
사고 종료
사전 요구 사항:
- 프로젝트에 대한 최소 할당량인 리포터 역할을 가져야 합니다.
사고를 종료하려면 오른쪽 상단 모서리에서 Incident actions ()를 선택한 다음 Close incident를 선택합니다.
알림과 연결된 사고를 종료할 때 알림과 연결된 상태가 Resolved로 변경됩니다.
그런 다음 알림의 상태 변경이 귀하에게 기록됩니다.
복구 알림을 통해 사고 자동 종료
GitLab이 HTTP 또는 Prometheus 웹후크에서 복구 알림을 받으면 사고를 자동으로 종료하도록 설정합니다.
사전 요구 사항:
- 프로젝트에 대한 최소 할당량인 유지관리자 역할을 가져야 합니다.
설정을 구성하려면:
- 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- Settings > Monitor를 선택합니다.
- Incidents 섹션을 확장합니다.
- Automatically close associated incident 체크박스를 선택합니다.
- Save changes를 선택합니다.
GitLab이 복구 알림을 받으면 연결된 사고를 종료합니다.
이 작업은 사고에 시스템 노트로 기록되어 GitLab Alert 봇에 의해 자동으로 종료되었음을 나타냅니다.
사고 삭제
사전 요구 사항:
- 프로젝트에 대한 소유자 역할을 가져야 합니다.
사고를 삭제하려면:
- 사고에서 Incident actions ()를 선택합니다.
- Delete incident를 선택합니다.
대안으로:
- 사고에서 Edit title and description ()을 선택합니다.
- Delete incident를 선택합니다.
기타 작업
GitLab의 사고는 이슈를 기반으로 구축되었기 때문에 다음과 같은 공통 작업을 수행합니다:
도움말