Jira와 Error Tracking 통합

문서 > 오류 추적 > Error Tracking Ticketing System Integrations > Jira와 Error Tracking 통합

개요

Jira를 Error Tracking과 통합하여 Jira 티켓을 생성하고 Error Tracking 이슈에 연결하세요. Error Tracking에 Jira를 사용하면 다음을 수행할 수 있습니다.

Error Tracking 이슈 패널에서 직접 Jira 티켓 생성
여러 Error Tracking 이슈를 하나의 티켓으로 그룹화
자동화 규칙을 사용하여 특정 Jira 보드로 이슈를 자동으로 라우팅
특정 기준과 일치하는 Error Tracking 이슈에 대해 Jira 티켓을 자동으로 생성

전제 조건

Error Tracking 이슈에서 티켓을 생성하는 기능은 Jira Cloud 및 Data Center에서 사용할 수 있습니다. Jira와 Error Tracking 간의 이중 동기화는 Jira Cloud에서만 사용할 수 있습니다.

Datadog용 Jira 통합을 설정합니다.
다음 권한이 있는지 확인합니다.
- Error Tracking 읽기
- Error Tracking 이슈 쓰기
- 케이스 읽기
- 케이스 쓰기
- Integrations 읽기

이슈에서 티켓 생성

이슈 패널에서 직접 Jira 티켓을 생성하여 해당 이슈에 대한 조사 작업을 그룹화할 수 있습니다.

Error Tracking 탐색기로 이동합니다.
이슈를 클릭하여 이슈 패널을 엽니다.
이슈 패널의 Actions 드롭다운에서 Add Jira ticket을 클릭합니다.
티켓을 생성할 Jira 계정과 프로젝트를 선택합니다. 그런 다음, 생성할 티켓 유형을 선택합니다.
필요에 따라 Data Sync 설정에 액세스하여 Datadog과 Jira 간의 데이터 동기화 방식을 구성합니다.
Create를 클릭하여 티켓을 생성합니다.

생성된 티켓은 Error Tracking 이슈에 연결됩니다. 티켓 링크가 이슈 패널에 표시되며, 이슈 상태가 자동으로 REVIEWED로 변경됩니다.

이슈가 티켓에 연결되면 상태, 담당자 및 코멘트가 양방향으로 동기화됩니다. 이슈 상태와 티켓 상태가 동기화되는 방식에 대한 자세한 내용은 이슈와 티켓 간의 상태 양방향 동기화를 참조하세요.

여러 이슈를 하나의 티켓으로 그룹화

여러 Error Tracking 이슈를 하나의 Jira 티켓에 첨부하여 관련 이슈를 하나의 작업 단위로 그룹화할 수 있습니다.

Error Tracking 탐색기로 이동합니다.
이슈를 클릭하여 이슈 패널을 엽니다.
이슈 패널의 Actions 드롭다운에서 Add Jira ticket을 클릭합니다.
Add to Existing 탭에 이슈를 그룹화할 티켓의 URL을 붙여넣습니다.
필요에 따라 Data Sync 설정에 액세스하여 Datadog과 Jira 간의 데이터 동기화 방식을 구성합니다.
Link to Issue를 클릭하여 이슈를 티켓에 첨부합니다.
이 그룹에 추가하려는 모든 이슈에 대해 이 작업을 반복합니다.

여러 이슈가 하나의 티켓에 연결되면 해당 이슈의 상태, 담당자, 코멘트가 양방향으로 동기화됩니다. 이슈 상태와 티켓 상태가 동기화되는 방식에 대한 자세한 내용은 이슈와 티켓 간의 상태 양방향 동기화를 참조하세요.

티켓과 이슈 간의 관계는 일대다 관계입니다. 하나의 티켓은 여러 이슈에 연결될 수 있지만, 이슈는 하나의 Jira 티켓에만 연결될 수 있습니다.

이슈와 티켓 간의 상태 양방향 동기화

Datadog 프로젝트와 Jira 프로젝트 간에 양방향 동기화가 활성화 및 구성된 경우, Error Tracking 이슈와 Jira 티켓의 상태가 미러링됩니다. 이 상태 동기화에서 예상치 못한 동작이 발생할 경우 문제 해결 섹션에서 구성을 수정하는 방법을 참조하세요.

단일 Jira 티켓에 연결된 단일 Error Tracking 이슈

단일 Error Tracking 이슈가 Jira 티켓에 연결되면 해당 상태가 양방향으로 동기화됩니다. 이러한 상태 간의 매핑은 티켓 생성 또는 자동화 규칙 양식의 Data Sync 설정에서 구성할 수 있습니다.

단일 Jira 티켓에 연결된 여러 Error Tracking 이슈

여러 Error Tracking 이슈가 동일한 Jira 티켓에 연결된 경우, 상황에 따라 해당 이슈들의 상태 간에도 동기화가 이루어집니다. 티켓 상태를 업데이트하면 연결된 모든 이슈가 매핑에 따라 이 상태를 반영하도록 업데이트됩니다.

매핑이 다음과 같이 정의되어 있다고 가정하겠습니다.

Work Management 상태 그룹	Jira 티켓 상태
`Open`	`To Do`
`In Progress`	`In Progress`
`Closed`	`Done`

이슈 상태를 업데이트하면 연결된 다른 이슈와 Jira 티켓의 결과 상태는 다음 규칙을 따릅니다.

초기 상태	작업	결과 상태
티켓이 Done 상태이고 모든 이슈가 Resolved 상태입니다.	하나의 이슈를 For Review 상태로 업데이트합니다.	해당 티켓은 To Do 상태이지만 다른 모든 이슈는 Resolved 상태로 유지됩니다.
티켓이 To Do 상태이고 모든 이슈가 For Review 상태입니다.	하나의 이슈를 Resolved 상태로 업데이트합니다.	해당 티켓은 To Do 상태이고, 하나의 이슈는 Resolved 상태이며, 다른 모든 이슈는 For Review 상태로 유지됩니다.
티켓이 Done 상태이고 연결되지 않은 For Review 상태의 이슈가 하나 있습니다.	For Review 이슈를 Done 티켓에 연결합니다.	해당 티켓이 Done 상태이고 새로 연결된 이슈를 포함한 모든 이슈가 Resolved 상태입니다.
티켓이 To Do 상태이고 연결되지 않은 Resolved 이슈가 하나 있습니다.	Resolved 이슈를 To Do 티켓에 연결합니다.	해당 티켓이 To Do 상태이고 새 이슈를 제외한 모든 이슈가 For Review 상태이지만, 새 이슈는 Resolved 상태로 유지됩니다.

자동화 규칙

규칙을 구성하여 특정 이슈를 Jira 보드에 일치시킬 수 있습니다. 이슈가 규칙과 일치되면 해당 이슈에 대해 수동 또는 자동으로 생성된 모든 티켓은 규칙에 지정된 보드로 기본 설정됩니다.

설정

Error Tracking 이슈에 대한 자동화 규칙을 생성하려면 다음 권한 중 하나가 필요합니다:

Error Tracking 쓰기
Error Tracking 설정 쓰기

자동화 규칙 생성

Jira용 자동화 규칙을 생성하려면 다음 단계를 따르세요.

Error Tracking 설정의 Ticketing & Automation 섹션으로 이동합니다.
New Rule을 클릭합니다.
규칙을 구성합니다.
- Match Criteria: 규칙을 트리거하기 위해 이슈가 충족해야 하는 조건을 정의합니다.
- Destination: 규칙과 일치하는 이슈에서 티켓이 생성될 때 대상 Jira 계정 및 프로젝트를 선택합니다. 생성할 티켓 유형을 선택하고 티켓의 필수 필드에 대한 값을 입력합니다.
- Auto-create: 이슈가 일치할 때 선택적으로 자동 티켓 생성을 활성화합니다.
Save Rule을 클릭합니다.

일치 기준

다음 속성을 기반으로 규칙을 구성합니다.

Service: 특정 서비스의 이슈 일치(예: service:web-store)
Team: 이슈 팀 소유권 기반의 이슈 일치(예: team:Shopist)

여러 기준을 조합하여 정밀한 라우팅 규칙을 만들 수 있습니다. 이슈 일치 쿼리는 다음 연산자를 지원합니다.

AND: 논리 AND(예: service:web-store AND team:Shopist)
OR: 논리 OR(예: service:web-store OR team:Shopist)
-: 논리 NOT(예: service:web-store -team:Shopist)

규칙은 순서대로 적용됩니다. 이슈와 일치하는 첫 번째 규칙이 적용됩니다.

자동 티켓 생성

자동화 규칙을 추가할 때 규칙과 일치하는 이슈에 대해 자동 Jira 티켓 생성을 활성화할 수 있습니다.

새로운 Error Tracking 이슈가 생성되면 규칙을 평가하고 일치하는 첫 번째 규칙을 적용합니다. 해당 일치 규칙에서 자동 티켓 생성이 활성화된 경우, 규칙에 지정된 Jira 보드에 새 Jira 티켓이 생성되고 일치하는 이슈에 연결됩니다.

문제 해결

Error Tracking에서 티켓팅 시스템을 사용할 때 예상치 못한 동작이 발생하면 다음 문제 해결 단계를 통해 문제를 신속하게 해결할 수 있습니다. 문제가 계속되면 Datadog 지원팀에 문의하세요.

Jira와 Error Tracking 간의 동기화가 중단됨

Jira 티켓과 해당 Error Tracking 이슈 간에 동기화 문제가 발생하는 경우(예: Jira 티켓을 닫을 때 이슈 상태가 업데이트되지 않는 경우), 다음 단계가 모두 올바르게 구성되었는지 확인하세요.

이슈 패널에서 이슈가 Jira 티켓에 올바르게 연결되어 있는지 확인합니다.
Datadog에서 Error Tracking 이슈와 Jira 티켓의 연결 지점 역할을 할 Work Management 작업 항목을 자동으로 생성한 상태입니다. 이슈 패널에서 이 작업 항목에 액세스하여 해당 항목이 생성된 Work Management 프로젝트를 찾을 수 있습니다. Work Management 설정에서 이 프로젝트에 Jira 통합이 활성화되어 있고 올바른 Jira 계정과 보드가 구성되어 있는지 확인하세요.
Work Management 설정에서 이 프로젝트에 Work Management와 Jira 간의 동기화가 활성화되어 있는지 확인합니다. 동기화하려는 필드에 Datadog과 Jira 간의 양방향 동기화가 구성되어 있는지 확인하세요.
Datadog과 Jira 간의 업데이트를 자동으로 동기화하려면 웹훅을 구성해야 합니다. Jira 설정에서 이 웹훅을 확인하세요. 웹훅이 누락된 경우 다음 단계에 따라 웹훅을 추가하고 Datadog과 Jira 간의 동기화 문제를 해결하세요.

Jira 티켓 리포터가 잘못된 사용자임

Error Tracking 이슈에서 Jira 티켓이 생성되면 티켓의 Reporter 필드가 티켓 생성을 트리거한 사용자가 아닌 Jira 통합을 구성한 Datadog 사용자로 설정됩니다. 이는 Datadog용 Jira 통합의 알려진 제한 사항이며 Error Tracking에서 생성된 모든 티켓에 적용됩니다. 특정 티켓의 리포터를 변경하려면 생성 후 Jira에서 직접 업데이트하세요.

각 Jira 티켓에 대해 새로운 Work Management 프로젝트가 생성됨

Datadog Work Management는 각 Jira 이슈 유형을 서로 다른 Work Management 프로젝트에 매핑합니다. 이전에 사용된 적 없는 Jira 이슈 유형을 사용하여 Error Tracking 이슈에서 티켓을 생성하면, Error Tracking 이슈와 Jira 티켓을 연결하기 위해 새로운 Work Management 프로젝트가 자동으로 생성됩니다. 이는 시간이 지남에 따라 여러 Jira 이슈 유형으로 티켓을 생성하면 이슈 유형당 하나씩 여러 Work Management 프로젝트가 생성됨을 의미합니다.