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

# 대시보드 URL 변수
<a name="v9-dash-dashboard-url-variables"></a>

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

Grafana는 대시보드 URL에서 쿼리 파라미터로 전달되는 변수 값을 적용할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v9-dash-manage-dashboard-links.md) 및 [템플릿 및 변수](v9-dash-variables.md)를 참조하세요.

**변수를 쿼리 파라미터로 전달**

Grafana는 접두사가 `var-`인 쿼리 문자열 파라미터를 지정된 대시보드에서 변수로 해석합니다.

예를 들어, 이 URL에서 다음과 같습니다.

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

쿼리 파라미터 `var-example=value`는 값이 `value`인 대시보드 변수 예제를 나타냅니다.

**변수에 대한 여러 값 전달**

여러 값을 전달하려면 각 값에 대해 변수 파라미터를 한 번 반복합니다.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana는 `value1` 및 `value2`의 두 가지 값을 사용하여 대시보드 변수 예제로 `var-example=value1&var-example=value2`를 해석합니다.

**대시보드 링크에 변수 추가**

Grafana는 대시보드 설정에서 변수를 생성할 때 대시보드 링크에 변수를 추가할 수 있습니다. 변수를 추가하는 자세한 내용과 단계는 [대시보드 링크 관리](v9-dash-manage-dashboard-links.md)를 참조하세요.

**임시 필터 전달**

임시 필터는 지정된 데이터 소스를 사용하는 모든 지표 쿼리에 키 또는 값 필터를 적용합니다. 자세한 내용은 [임시 필터]()를 참조하세요.

임시 필터를 쿼리 파라미터로 전달하려면 변수 구문을 사용하여 임시 필터 변수를 전달하고 키와 연산자를 값으로, 값을 파이프로 구분된 목록으로 제공합니다.

예를 들어, 이 URL에서 다음과 같습니다.

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

쿼리 파라미터 `var-adhoc=key|=|value`는 `example_key` 키, `=` 연산자 및 `example_value` 값을 사용하여 임시 대시보드 변수로 구성된 임시 필터를 적용합니다.

**참고**  
임시 필터와 URL을 공유할 때는 URL을 인코딩해야 합니다. 위 예제에서 파이프(`(|)`)를 `%7C`로 바꾸고 등호 연산자(`(=)`)를 ` %3D`로 바꿉니다.

**URL을 사용하여 시간 범위 제어**

대시보드의 시간 범위를 설정하려면 `from`, `to`, `time` 및 `time.window` 쿼리 파라미터를 사용합니다. 변수가 아니기 때문에 `var-` 접두사는 필요하지 않습니다.