Jira 알람 설정
Jira 알람 설정 (Configure Jira for Alerting)
연락처 포인트의 Jira 통합을 사용하면 알림이 발생할 때 Jira 인스턴스에 이슈를 만들 수 있어요. Jira Cloud와 Jira Server/Data Center 설치를 모두 지원합니다.
출처: 문서
본문
연락처 포인트의 Jira 통합을 사용하면 알림이 발생할 때 Jira 인스턴스에 이슈(issue)를 만들 수 있어요. Jira Cloud와 Jira Server/Data Center 설치를 모두 지원합니다.
시작하기 전에 (Before you begin)
- Jira 인스턴스(Cloud, Server, Data Center)
- Jira용 API 접근 자격 증명
- 대상 Jira 프로젝트에서 이슈를 만들 수 있는 적절한 권한
연락처 포인트용 Jira 구성
- Alerts & IRM → Alerting → Notification configuration 으로 이동한 다음 Contact points 탭을 선택합니다.
- + Add contact point 를 클릭합니다.
- 연락처 포인트 이름을 입력합니다.
- Integration 목록에서 Jira 를 선택합니다.
- Jira 구성에 필요한 settings 를 설정합니다.
- Save contact point 를 클릭합니다.
연락처 포인트 테스트 방법과 알림 활성화 등 자세한 내용은 Configure contact points 문서를 참고하세요.
필수 설정 (Required Settings)
| 키 | 설명 |
|---|---|
| URL | Jira 인스턴스의 REST API URL. 지원 버전은 2 와 3 (예: https://your-domain.atlassian.net/rest/api/3). 이 필드는 Grafana Cloud에서 수정이 보호(protected) 됨 |
| Basic Auth User | 인증용 사용자명. Jira Cloud에서는 이메일 주소 사용 |
| Basic Auth Password | 비밀번호 또는 개인 토큰. Jira Cloud에서는 여기에서 개인 토큰을 얻어 비밀번호로 사용 |
| API Token | 기본 인증의 대안. API 요청을 인가하는 bearer 토큰. 자세한 내용은 Jira 문서 참고 |
| Project Key | 이슈가 생성될 프로젝트를 식별하는 프로젝트 키. 프로젝트의 고유 식별자 |
| Issue Type | 생성할 이슈 유형 (예: Task, Bug, Incident). 프로젝트에서 사용 가능한 유형을 지정해야 함 |
선택 설정 (Optional Settings)
| 키 | 설명 |
|---|---|
| Summary | 이슈 제목. 템플릿팅 지원. 최대 길이 255자 |
| Description | 이슈 설명. API 버전에 따라 텍스트, Markdown, 또는 JSON(v3 API만)일 수 있음. 필드 최대 크기 32kb. (JSON은 클라이언트에서 제한되지 않으며, 크기를 초과하면 API가 요청을 거부할 가능성이 높음) |
| Labels | Jira에서 생성된 이슈를 정리·필터링하기 위한 커스텀 라벨. 템플릿팅을 지원해 알림 데이터에 따라 동적 라벨 생성 가능 |
| Priority | 이슈 우선순위(예: Low, Medium, High, Critical). Jira 인스턴스에서 사용 가능한 옵션과 일치해야 함. 여기에서 우선순위 레벨을 커스터마이즈할 수 있음 |
| Resolve Transition | 알림이 해결될 때 이슈를 해결 상태로 이동시킬 transition 이름. 지정된 이슈 유형에 대해 Jira 워크플로우에서 사용 가능한 유효한 transition과 일치해야 함. 비어 있으면 이슈가 Done으로 이동하지 않음 |
| Reopen Transition | 알림이 다시 발생할 때 이슈를 열린 상태로 되돌리는 transition 이름. 지정된 이슈 유형의 Jira 워크플로우에서 유효한 transition과 일치해야 함. 비어 있으면 이슈가 다시 열리지 않음 |
| Reopen Duration | 이 기간(분) 안에 닫힌 이슈를 다시 열지, 새 이슈를 만들지 제어하는 시간. 미지정 시 deduplication key와 일치하는 가장 최근 이슈를 업데이트하고 (reopen transition이 지정된 경우) 다시 열음 |
| “Won’t fix” Transition | 기존 이슈 검색 시 무시해야 할 해결 상태(resolution). 이 해결 상태의 이슈는 이후 알림에서 다시 열리거나 업데이트되지 않음 |
| Deduplication Key Field | deduplication key를 저장할 커스텀 필드. 텍스트 필드여야 함. 미지정 시 deduplication key가 ALERT(hash sum) 형식의 라벨에 추가됨. 커스텀 필드 생성은 Jira 문서 참고 |
| Fields | Jira 이슈의 커스텀 필드 구성. 필드 이름은 customfield_10001 같은 형식이어야 함 |