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

# 데이터 링크 구성
<a name="v10-panels-configure-data-links"></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) 섹션을 참조하세요.

데이터 링크를 사용하면 링크에 보다 세분화된 컨텍스트를 제공할 수 있습니다. 시리즈 이름 또는 커서 아래 값도 포함하는 링크를 생성할 수 있습니다. 예를 들어 시각화에 네 개의 서버가 표시되는 경우 하나 또는 두 개의 서버에 데이터 링크를 추가할 수 있습니다. 데이터 링크를 사용하여 패널을 연결할 수도 있습니다.

링크 자체는 시각화에 따라 다양한 방식으로 액세스할 수 있습니다. 예를 들어 시계열 시각화의 경우 데이터 포인트 또는 선을 선택합니다. 통계, 게이지 또는 막대 게이지와 같은 대규모 영역 시각화의 경우 시각화의 아무 곳이나 선택하여 컨텍스트 메뉴를 열 수 있습니다.

시각화에 데이터 링크가 하나만 있는 경우 시각화의 아무 곳이나 선택하면 컨텍스트 메뉴가 아닌 링크가 열립니다.

**지원되는 시각화**
+ 막대 차트
+ 막대 게이지
+ 캔들스틱
+ Canvas
+ Gauge
+ Geomap
+ 히트맵
+ 히스토그램(Histogram)
+ 파이 차트
+ Stat
+ 상태 타임라인
+ 상태 기록
+ 표
+ 시계열
+ 추세

## 데이터 링크 변수
<a name="v10-panels-data-link-variables"></a>

데이터 링크의 변수를 사용하면 보존된 데이터 필터가 있는 세부 대시보드로 사용자를 보낼 수 있습니다. 예를 들어 변수를 사용하여 레이블, 시간 범위, 시리즈 또는 변수 선택을 지정할 수 있습니다.

사용 가능한 변수 목록을 보려면 데이터 링크 **URL** 필드에 `$`를 입력합니다.

데이터 링크 URL에서 템플릿 변수를 사용할 수도 있습니다. [변수](v10-dash-variables.md) 섹션을 참조하세요.

### 시간 범위 패널 변수
<a name="v10-panels-time-range-panel-variables"></a>

이러한 변수를 사용하면 데이터 링크 URL에 현재 시간 범위를 포함할 수 있습니다.
+ `__url_time_range` – 현재 대시보드의 시간 범위(즉, `?from=now-6h&to=now`)
+ `$__from` – 자세한 내용은 [전역 변수](v10-dash-variable-add.md#v10-dash-variable-add-global) 단원을 참조하세요.
+ `$__to` – 자세한 내용은 [전역 변수](v10-dash-variable-add.md#v10-dash-variable-add-global) 단원을 참조하세요.

### 시리즈 변수
<a name="v10-panels-series-variables"></a>

시리즈별 변수는 `__series` 네임스페이스에서 사용할 수 있습니다.
+ `__series.name` - URL에 대한 시리즈 이름

### 필드 변수
<a name="v10-panels-field-variables"></a>

필드별 변수는 `__field` 네임스페이스에서 사용할 수 있습니다.
+ `__field.name` - 필드의 이름
+ `__field.labels.<LABEL>` - URL에 대한 레이블의 값. 레이블에 점이 포함된 경우 `__field.labels["<LABEL>"]` 구문을 사용합니다.

### 변수 값
<a name="v10-panels-value-variables"></a>

값별 변수는 `__value` 네임스페이스에서 사용할 수 있습니다.
+ `__value.time` - URL에 대한 값의 타임스탬프(Unix 밀리초 에포크, 즉 `?time=1560268814105`)
+ `__value.raw` – 원시 값
+ `__value.numeric` - 값의 숫자 표현
+ `__value.text` - 값의 텍스트 표현
+ `__value.calc` - 값이 계산 결과인 경우 계산 이름

데이터 링크에서 값별 변수를 사용하면 툴팁 모드의 설정 옵션에 따라 다른 결과를 표시할 수 있습니다.

### 데이터 변수
<a name="v10-panels-data-variables"></a>

다른 필드의 값에 액세스하려면 다음을 사용합니다.
+ `__data.fields[i]` – `i` 필드 값(동일한 행에 있음).
+ `__data.fields["NameOfField"]` - 인덱스 대신 이름을 사용하는 필드 값.
+ `__data.fields[i].labels.cluster` - 다른 필드의 레이블에 액세스합니다.

### 템플릿 변수
<a name="v10-panels-template-variables"></a>

템플릿 변수를 사용하는 다른 대시보드에 연결할 때 링크를 클릭하는 사람의 변수 값을 선택합니다.

`${var-myvar:queryparam}` - 여기서 `var-myvar`은 사용하려는 현재 대시보드의 템플릿 변수와 일치하는 템플릿 변수의 이름입니다.


| 변수 상태 | 생성된 URL의 결과 | 
| --- | --- | 
| 하나의 값을 선택함 | var-myvar=value1 | 
| 다중 값을 선택함 | var-myvar=value1&var-myvar=value2 | 
| All을 선택함 | var-myvar=All | 

URL에 현재 대시보드의 변수를 모두 추가하려면 `${__all_variables}`를 사용합니다.

## 데이터 링크 추가
<a name="v10-panels-add-a-datalink"></a>

패널에 데이터 링크를 추가할 수 있습니다.

1. 데이터 링크를 추가할 패널로 이동하세요.

1. 패널 위로 마우스를 가져가면 오른쪽 상단에 메뉴 아이콘이 표시됩니다.

1. 메뉴에서 **편집**을 선택하여 패널 편집기를 여세요.

1. **패널 편집** 창에서 **데이터 링크** 섹션으로 스크롤하여 확장하세요.

1. **링크 추가**를 선택하세요.

1. 열리는 대화 상자에 **제목**을 입력하세요. 사람이 읽을 수 있는 링크에 대한 레이블로, UI에 표시됩니다.

1. 연결할 **URL** 또는 변수를 입력하세요.

   데이터 링크 변수를 추가하려면 **URL** 필드를 선택한 다음, `$`를 입력하거나 Ctrl\$1Space 또는 Cmd\$1Space를 눌러 사용 가능한 변수 목록을 확인하세요.

1. 새 탭에서 링크를 열려면 **새 탭에서 열기**를 선택하세요.

1. **저장**을 선택하여 변경 사항을 저장하고 대화 상자를 닫으세요.

1. 자산에 대한 변경 사항을 저장하세요.