# 인시던트 보고서 생성
<a name="Investigations-Incident-Reports"></a>

인시던트 보고서는 인시던트 조사에 대한 보고서를 더 쉽고 빠르게 작성하는 데 도움이 됩니다. 이 보고서를 사용하면 경영진에게 세부 정보를 제공하거나, 팀원들이 인시던트를 통해 교훈을 얻고 향후 이러한 인시던트 발생을 방지하기 위한 조치를 취하도록 지원할 수 있습니다. 보고서의 구조는 이러한 유형의 보고서에 대한 업계 표준을 기반으로 하며, 장기 보존하려는 경우 다른 리포지토리에 복사할 수 있습니다.

AWS Management Console을 사용하여 CloudWatch 조사에서 {{조사 그룹}} 리소스를 생성할 경우, 해당 그룹에 대한 IAM 역할이 생성되어 조사 중에도 리소스에 대한 액세스 권한을 부여할 수 있습니다. CloudWatch 조사 인시던트 보고서를 생성하려면 조사 그룹에 추가 권한을 부여해야 합니다. 새로운 관리형 정책인 `AIOpsAssistantIncidentReportPolicy`는 필요한 권한을 제공하며, 2025년 10월 10일 이후 AWS Management Console을 사용하여 생성된 조사 그룹에는 이 정책이 자동으로 추가됩니다. 자세한 내용은 [AIOpsAssistantIncidentReportPolicy](managed-policies-cloudwatch.md#managed-policies-QInvestigations-AIOpsAssistantIncidentReportPolicy) 섹션을 참조하세요.

**참고**  
CDK 또는 SDK를 사용할 경우, 조사 그룹 역할을 명시적으로 추가한 후 역할에 대한 역할 정책 또는 그에 상응하는 인라인 권한을 지정해야 합니다. 권한에 대한 자세한 내용은 [CloudWatch 조사의 보안](Investigations-Security.md) 섹션을 참조하세요.

이러한 보고서는 이해관계자와 쉽게 공유하고 조직의 학습에 사용할 수 있는 구조화된 형식으로 조사 결과, 근본 원인, 타임라인 이벤트, 권장 수정 조치를 캡처합니다.

인시던트 보고서 생성은 모든 CloudWatch 조사 사용자에게 추가 비용 없이 제공되며 조사 워크플로와 원활하게 통합됩니다.

**인시던트 보고서의 작동 방식**

1. 인시던트에 대한 조사를 실행합니다.

1. 하나 이상의 가설을 수락합니다. 수락하는 각 가설은 보고서에 반영됩니다. 가설은 100% 정확하지 않아도 괜찮습니다.

1. **인시던트 보고서**를 선택합니다. 조사가 진행되는 동안 AI는 조사를 위해 수집된 데이터 및 도출된 사실을 구문 분석합니다. '사실'이라는 건 보고서 생성의 근거를 형성하는 인시던트에 대한 원자성 정보입니다. 사실 추출을 마치려면 몇 분 정도 걸릴 수 있습니다.

1. 사실 추출이 완료되면 다음과 같은 영역에서 사용 가능한 사실을 검토할 수 있습니다.

   1. **인시던트 개요** - 심각도, 기간, 운영 가설을 비롯한 인시던트에 대한 대략적인 개요입니다.

   1. **영향 평가** - 인시던트가 고객, 서비스 기능, 비즈니스 운영에 미치는 영향과 관련된 지표 및 분석입니다.

   1. **감지 및 대응** - 인시던트를 탐지한 방법과 시점, 인시던트에 대응한 방법과 관련된 지표 및 분석입니다.

   1. **근본 원인 분석** - 조사 가설을 기반으로 근본적인 원인을 자세히 분석합니다.

   1. **완화 및 해결** - 완화 단계 및 해결 조치와 관련된 지표 및 분석으로, 인시던트 완화 및 해결에 걸리는 시간을 측정한 값도 함께 다룹니다.

   1. **학습 및 다음 단계** - 팀원 전체가 고려해야 할 권장 조치 목록으로, 조사 결과를 통해 자동으로 생성됩니다. 이러한 권장 사항에는 유사한 인시던트에 대한 예방 조치, 모니터링 및 대응 프로세스에 대한 권장 개선 사항이 포함될 수 있습니다.

1. 사실을 검토한 후, **보고서 생성**을 선택하여 인시던트에 대한 포괄적인 분석을 생성합니다. 선택된 사실은 핵심적인 참조 기준 역할을 하는 반면, 보고서는 조사 동안 수집된 모든 사용 가능한 정보를 가져옵니다. 이 프로세스는 몇 분 정도 걸릴 수 있습니다.

1. 보고서를 생성한 후 다음 작업 중 하나를 수행할 수 있습니다.
   + 보고서를 있는 그대로 사용:
     + 필요한 경우 이를 복사하여 외부 편집기에서 편집합니다.
     + 나중에 참조할 수 있도록 저장합니다.
   + 데이터를 더 추가하여 보고서 개선:
     + **Add facts**(권장 방법)를 선택하여 인시던트 티켓 또는 사용자 지정 서술 같은 추가적인 텍스트 기반 콘텐츠를 입력합니다. AI가 이 콘텐츠를 분석하여 기존 사실을 보강하거나 새로운 사실을 추론합니다.
     + 사실을 직접 편집(매우 제한적으로 사용) - 수동으로 편집한 사실은 조사 타임라인과 일치하지 않을 수 있습니다. **Add facts**를 선택했을 때 원하는 결과를 달성하지 못한 경우에만 최후의 수단으로 사용해야 합니다.
   + **보고서 재생성**을 선택해 업데이트된 정보를 사용하여 새 보고서를 생성합니다.

**Topics**
+ [인시던트 보고서에 있는 AI 도출 사실에 대한 이해](Investigations-IncidentReports-ai-facts.md)
+ [인시던트 보고서 용어](Investigations-IncidentReports-terms.md)
+ [조사에서 보고서 생성](Investigations-IncidentReports-Generate.md)
+ [인시던트 보고서에서 5 Whys 분석 사용](incident-report-5whys.md)