기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Jira 데이터 소스에 연결
<a name="jira-AMG-datasource"></a>

Jira의 문제 데이터를 다른 소스의 애플리케이션 성능 데이터와 결합하여 개발 프로세스의 전체 그림을 확인하세요.

**참고**  
이 데이터 소스는 Grafana Enterprise 전용입니다. 자세한 내용은 [Enterprise 플러그인에 대한 액세스 관리](upgrade-to-enterprise-plugins.md) 단원을 참조하십시오.  
또한 버전 9 이상을 지원하는 워크스페이스에서 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 내용은 [플러그인을 사용하여 워크스페이스 확장](grafana-plugins.md) 단원을 참조하십시오.
+ 문제 생성 또는 해결을 기반으로 주석을 생성하여 문제와 지표 간의 관계를 확인합니다.
+ 평균 해결 시간 및 문제 처리량과 같은 자세한 Jira 통계를 추적합니다.

Jira 데이터 소스를 사용하려면 Jira 프로젝트에 액세스할 수 있는 Atlassian 계정이 필요합니다.

## 알려진 제한 사항
<a name="jira-known-limitations"></a>

Jira 추가 기능의 사용자 지정 필드 유형은 지원되지 않을 수 있습니다.

## 데이터 소스 추가
<a name="jira-adding-the-data-source"></a>

1.  Amazon Managed Grafana 워크스페이스에서 Grafana 콘솔을 열고 로그인되었는지 확인합니다.

1.  사이드 메뉴의 **구성**(톱니 아이콘) 아래에서 **데이터 소스**를 선택하세요.

1.  **데이터 소스 추가**를 선택합니다.
**참고**  
 사이드 메뉴에 **데이터 소스** 링크가 표시되지 않으면 현재 사용자에게 `Admin` 역할이 없다는 의미입니다.

1.  데이터 소스 목록에서 **Jira**를 선택하세요.

1. 다음 정보를 입력합니다.
   + **이름 **에 이 Jira 데이터 소스의 이름을 입력하세요.
   + **URL**에 Atlassian 인스턴스의 루트 URL(예: **https://bletchleypark.atlassian.net**)을 입력하세요.
   + **사용자**에 사용자/서비스 계정의 이메일 주소를 입력하세요.
   + **API 토큰 **에서 사용자에 대해 생성된 API 토큰을 입력하세요.

## Jira 데이터 소스 쿼리
<a name="jira-query"></a>

Jira 쿼리 편집기에서 필드 및 쿼리 문제를 선택할 수 있습니다.

Jira 데이터 소스는 Jira에 버그, 사용자 스토리, 지원 티켓 또는 Jira의 기타 태스크를 나타낼 수 있는 문제를 쿼리합니다.

**문제 필터링 및 보기**

1.  **필드**를 선택하고 드롭다운을 선택한 다음, 미리 입력을 사용하여 사용자 지정 필드를 포함해 Jira 인스턴스의 모든 필드 중에서 선택하세요. 시도할 일부 필드: 
   + **요약** - 문제의 이름.
   + **에픽 이름** - 문제가 속한 에픽.
   + **스토리 포인트 예측** - 팀이 문제에 대해 예측한 스토리 포인트 수.

1.  문제를 필터링하거나 정렬합니다. 이렇게 하려면 유효한 JQL 표현식을 입력하여 Atlassian 쿼리 언어 JQL을 사용해 **프로젝트**, **담당자** 또는 **스프린트**와 같은 필드를 기준으로 문제를 필터링하거나 정렬합니다.

여기에서 데이터를 테이블에 표시하거나 Grafana 변환을 사용하여 해당 문제 데이터를 조작하거나 계산을 실행하거나 데이터를 시계열 그래프로 변환할 수 있습니다. 자세한 내용은 [변환 적용](panel-transformations.md#apply-a-transformation) 단원을 참조하십시오.

## 시계열 쿼리
<a name="jira-timeseries-query"></a>

시계열 데이터를 표시하려면 숫자 필드와 함께 **날짜** 필드를 선택한 다음, 그래프 시각화로 전환하세요. 예: **스프린트 시작 날짜**, **스토리 포인트 예측**.

이전 예제는 그 자체로 유용하지 않습니다. 숫자 필드는 변환에서 계산될 수 있으며, 변환에서 계산되었을 가능성도 큽니다. **그룹화 기준** 변환을 사용하면 **스프린트 시작 날짜**를 기준으로 그룹화하고 **스토리 포인트 예측**을 요약하여 스프린트당 시간 경과에 따른 스토리 포인트 시각화가 가능합니다. 변환에 관한 자세한 내용은 [변환 적용](panel-transformations.md#apply-a-transformation) 섹션을 참조하세요.

## 템플릿 및 변수
<a name="jira-templates"></a>

새 Jira 쿼리 변수를 추가하려면 [쿼리 변수 추가](variables-types.md#add-a-query-variable) 섹션을 참조하세요. Jira 데이터 소스를 데이터 소스로 사용합니다.

대시보드에서 변수를 정의하고 JQL 표현식에서 참조할 수 있습니다. 예를 들어 프로젝트 상태 대시보드를 생성하고 프로젝트 중에서 선택하거나, 에픽 상태 대시보드를 선택하고 다른 에픽을 선택하거나, 태스크 상태 대시보드를 선택하고 다른 담당자를 선택할 수 있습니다.

선택할 프로젝트, 에픽, 담당자 등의 동적 목록을 가져오려면 쿼리 유형 변수를 생성하세요. 쿼리 유형 변수는 JQL을 사용하여 문제를 쿼리하고 프로젝트, 에픽, 담당자 또는 문제와 관련된 모든 항목을 반환합니다. 다음은 예제입니다.

**담당자 변수를 생성하여 담당자별로 문제 상태를 가져오세요.**

1.  **assignee**라는 **쿼리** 유형의 변수를 추가하세요.

1.  **필드: 담당자**를 선택하세요.

1.  (선택 사항) JQL 필터 **project = 'your project'**를 추가하세요.

1.  **실행**을 선택하여 담당자 목록을 확인하세요.

1. **업데이트**를 선택하여 대시보드에 변수를 추가하세요.

1. 대시보드에 새 패널을 추가하고 **assignee = \$1assignee**를 사용해 필터링하도록 JQL을 편집하세요.

   이제 드롭다운에서 선택하면 해당 사용자에게 할당된 문제만 표시됩니다.

다중 값 변수를 사용하면 여러 옵션을 선택할 수 있으며 IN 절의 일부로 사용할 수 있습니다. 예: **assignee IN (\$1assignee)**.

## Grafana의 변환을 사용하여 일반적인 질문에 답변
<a name="jira-macros"></a>

매크로는 대시보드 기간을 참조하는 변수이므로, 대시보드 기간의 범위 내에서만 문제를 필터링할 수 있습니다. 2개의 매크로가 있습니다.
+ **\$1\$1\$1timeFrom**
+ **\$1\$1\$1timeTo.**

다음 예제 JQL 쿼리는 대시보드 기간 내에 생성된 문제를 필터링합니다. `createdDate >= $__timeFrom AND createdDate <= $__timeTo` 

## 데이터 소스 최대한 활용
<a name="jira-getmost"></a>

Grafana의 변환 및 기타 기본 제공 기능을 사용하면 Jira 데이터를 보고 의미를 파악하는 데 도움이 될 수 있습니다.

### 변환을 사용하여 JQL 보강
<a name="gitlab-transformations-JQL"></a>

Grafana에는 선택할 수 있는 많은 변환이 있지만, 다음에서는 강력한 보강 기능을 제공하여 JQL에서 SQL의 기능/성능을 지원합니다.

**그룹화 기준** 이 변환은 표준 Jira JQL 구문인 Grouping에 포함되지 않는 주요 기능을 제공합니다. **그룹화 기준** 변환을 사용하면 스프린트 또는 기타 문제 필드를 기준으로 그룹화하고 그룹별로 집계하여 스프린트에서 완료된 실제 항목 및 스토리 포인트 예측과 속도 등의 지표를 얻을 수 있습니다.

**외부 조인** SQL 조인과 마찬가지로 공통 필드별로 2개 이상의 쿼리를 조인할 수 있습니다. 이렇게 하면 쿼리의 데이터세트를 결합하고 다른 변환을 사용하여 여러 쿼리/데이터세트의 값을 계산할 수 있습니다.

**계산에서 필드 추가** SQL 표현식과 마찬가지로 이 변환을 통해 다른 필드의 계산을 기반으로 데이터세트에 새 필드를 추가할 수 있습니다. 계산에 사용되는 필드는 단일 쿼리 또는 함께 조인한 쿼리일 수 있습니다. 계산을 함께 연결하고 계산된 필드에서 계산을 수행할 수도 있습니다.

### Grafana의 변환을 사용하여 일반적인 질문에 답변
<a name="gitlab-transformations-common"></a>

변환을 사용하여 데이터세트를 시각화, 집계, 그룹화 및 조인할 수 있으며, 다른 많은 유형의 변환을 사용하여 간단한 결과를 복잡한 질문에 대한 답변으로 변환할 수 있습니다.

**스프린트당 벨로시티를 어떻게 표시하나요?**

1.  **스프린트 이름**, **스토리 포인트 예측** 필드를 선택하세요..

1.  다음 JQL 필터를 추가하세요. `project = "Your Project" AND type != epic AND status = done order by created ASC` 

1.  **그룹화 기준** 변환을 추가하세요.
   + 스프린트 이름 \$1 그룹화 기준
   + 스토리 포인트 예측 \$1 계산 \$1 합계

1. **막대 게이지** 시각화를 선택하세요.

**스프린트에서 완료된 항목과 예상 항목의 차이를 어떻게 표시하나요?**

1.  쿼리를 추가하세요. 먼저 필드: **스프린트 이름**, **스프린트 시작 날짜**, **스토리 포인트 추정**을 선택하세요.

   그리고 다음 JQL 필터를 추가하세요. `project = 'Your Project' AND type != epic` 

1.  두 번째 쿼리를 추가하세요. 먼저 필드: **스프린트 이름**, **스프린트 시작 날짜**, **스토리 포인트 추정**을 선택하세요.

   그리고 다음 JQL 필터를 추가하세요. `project = 'Your Project' AND type != epic AND status = done` 

1.  **그룹화 기준** 변환을 추가하세요.
   + 스프린트 이름 \$1 그룹화 기준
   + 스프린트 시작 날짜 \$1 그룹화 기준
   + 스토리 포인트 예측 \$1 계산 \$1 합계

1. **그래프** 시각화를 선택하세요.

**프로젝트에서 문제를 완료하는 데 걸리는 평균 시간은 얼마인가요?**

1.  쿼리를 추가하세요. 먼저 필드: **생성됨**, **상태 범주 변경됨**을 선택하세요.

   그리고 다음 JQL 필터를 추가하세요. `project = 'Your Project' AND type != epic AND status = done` 

1.  다음 변환을 추가하세요. **계산에서 필드 추가**
   + 모드 = 행 축소
   + 계산 = 차이

1.  다음 변환을 추가하세요. **계산에서 필드 추가**
   + 모드 = 바이너리 연산
   + 작업 = 차이/86000000
   + 별칭 = 일

1.  다음 변환을 추가하세요. **필드 구성**
   + 다른 필드 숨기기

1.  다음 변환을 추가하세요. **값을 기준으로 데이터 필터링**
   + 필터 유형 = 포함
   + 조건 = 임의 일치
     + 필드 = 일수 \$1 일치 = 초과 \$1 값 = 1

1.  다음 변환을 추가하세요. **축소**
   + 모드 = 시리즈에서 행으로
   + 계산 = 평균

1. **통계** 시각화를 선택하세요.