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

# 상관관계 구성
<a name="v10-correlations-config"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

 각 상관관계는 다음 옵션으로 구성됩니다.

**Label**  
시각화에 표시된 링크 레이블.

**설명**  
선택적 설명

**소스 데이터 소스**  
링크가 표시된 결과의 소스.

**결과 필드**  
시각화에서 링크가 표시되는 위치를 정의합니다.

**대상 쿼리**  
대상 쿼리는 링크를 클릭하면 실행됩니다.

**변환**  
포함된 소스 데이터에 대한 선택적 조작이 대상 쿼리에 전달됩니다.

상관관계 생성에 대한 자세한 내용은 [상관관계 생성](v10-correlations-create.md)을 참조하세요.

## 소스 데이터 소스 및 결과 필드
<a name="v10-correlations-config-source-and-result"></a>

링크는 상관관계의 소스 데이터 소스로부터 결과에 대한 시각화 탐색에 표시됩니다. 상관관계 구성에 제공된 결과의 필드 중 하나(결과 필드)에 링크가 할당됩니다. 각 시각화는 서로 다른 방식으로 링크가 있는 필드를 표시합니다.

## 대상 쿼리
<a name="v10-correlations-config-target-query"></a>

대상 쿼리는 시각화에서 링크를 클릭하면 실행됩니다. 선택한 대상 데이터 소스의 쿼리 편집기를 사용하여 대상 쿼리를 지정할 수 있습니다. 소스 데이터 결과는 변수를 사용하여 대상 쿼리 내에서 액세스할 수 있습니다.

### 상관관계 변수
<a name="v10-correlations-config-variables"></a>

대상 쿼리 내 변수를 사용하여 쿼리와 관련된 소스 데이터에 액세스할 수 있습니다. 상관관계에서는 [Grafana 변수 구문](v10-dash-variable-syntax.md)을 사용합니다. 링크를 선택하면 변수가 소스 결과의 값으로 채워집니다. 사용할 수 있는 두 가지 변수 유형이 있습니다.
+ [필드 변수](v10-panels-configure-data-links.md#v10-panels-data-link-variables)(필드 값 및 레이블에 액세스하기 위해).
+ 상관관계 변수(필드 값 및 변환에 액세스하기 위해).

예: 소스 결과에 `employee` 필드가 포함된 경우 다음을 사용하여 필드 값에 액세스할 수 있습니다.
+ 필드 변수 `${__data.fields.employee}`.
+ `${employee}`에 위 필드 값을 매핑하는 상관관계 변수.

필드 값을 더 짧은 변수 이름에 매핑하는 것 외에도 기존 필드에 변환을 적용하여 더 많은 상관관계 변수를 생성할 수 있습니다.

상관관계는 모든 변수가 선택한 데이터 행에 값을 포함하는 경우에만 데이터 링크를 생성합니다. [전역 변수](v10-dash-variable-add.md#v10-dash-variable-add-global)는 이 규칙의 예외이며 반환된 데이터에서 채우지 않아도 됩니다. 이러한 변수는 데이터 소스에 의해 자동으로 보간됩니다.

### 상관관계 변환
<a name="v10-correlations-config-transformations"></a>

변환에서는 필드 값에서 더 많은 변수를 추출하는 방법을 제공합니다. 변환의 출력은 다른 변수로 액세스할 수 있는 새 변수 세트입니다.

변환에는 logfmt 및 정규식과 같은 두 가지 유형이 있습니다.

각 변환은 선택한 필드 값을 입력으로 사용합니다. 변환의 출력은 변환의 유형 및 옵션을 기반으로 하는 새 변수 세트입니다.

### Logfmt 변환
<a name="v10-correlations-config-logfmt-transformation"></a>

logfmt 변환은 [logfmt 키/값 페어](https://brandur.org/logfmt) 형식의 텍스트가 포함된 필드 값을 해체합니다. 각 페어는 변수(키가 변수의 이름임)가 됩니다.

logfmt 변환은 결과 필드와 다른 필드에 변환을 적용하려는 경우에만 입력 필드 이름을 지정하면 됩니다. `field = "host=srv001 endpoint=/test app=foo"`에 대한 출력 변수 예제:


| 이름 | 값 | 
| --- | --- | 
| host | srv001 | 
| 엔드포인트 | /test | 
| 앱 | foo | 

### 정규식 변환
<a name="v10-correlations-config-regular-expression-transformation"></a>

정규식 변환은 제공된 정규식을 기반으로 필드 값을 해체합니다.

정규식 변환 옵션:

**필드**  
입력 필드 이름

**expression**  
정규식. 이름 지정된 캡처 그룹은 그룹 이름과 일치하는 변수에 매핑됩니다. 이름이 지정되지 않은 일치 그룹을 사용하는 경우 첫 번째 일치 항목에서 변수가 생성됩니다. 값은 입력 필드와 일치하는 변수를 재정의하거나 mapValue가 제공되는 경우 새 변수가 생성됩니다(다음 표의 예제 참조).

**mapValue**  
이름 지정된 일치 그룹 없이 간단한 정규식 그룹과 함께 사용됩니다. 기본적으로 첫 번째 일치는 입력으로 사용되는 필드 이름으로 변수를 재정의합니다. 기본 동작을 변경하도록 mapValue 속성을 지정할 수 있습니다. 제공된 이름은 새 변수를 생성하는 데 사용됩니다. 대상 쿼리에 정확한 값과 변환으로 추출된 값의 일부가 모두 필요한 경우 유용할 수 있습니다.

예: 선택한 필드 이름이 `employee`이고 필드 값이 `John Doe`라고 가정합니다.

표현식 및 mapValue 옵션을 기반으로 하는 다양한 출력 변수:


| expression | mapValue | 출력 변수 | 설명 | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | mapValue가 제공되지 않았습니다. 첫 번째 일치는 기존 필드 이름 변수(employee)에 매핑됩니다. | 
| /(\$1w\$1) (\$1w\$1)/ | 이름 | name=John | 첫 번째 일치는 name이라는 새 변수에 매핑됩니다. | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | 이름 지정된 그룹을 사용하는 경우 출력 변수의 이름이 되며 mapValue는 무시됩니다. | 
| /(?\$1w\$1) (?\$1w\$1)/ | 이름 | firstName=John, lastName=Doe | 위와 동일 |