대시보드 URL 변수

대시보드 URL 변수 (Dashboard URL variables)

대시보드 URL 변수를 사용하면 대시보드 URL을 공유할 때 더 많은 컨텍스트를 제공할 수 있어요. 기본 URL은 단순히 대시보드로 이동만 시키지만, 쿼리 파라미터로 변수를 전달하면 대상자가 대시보드를 열자마자 유용한 맥락을 볼 수 있게 됩니다. 시간 범위·필터·그룹 바이도 URL로 제어할 수 있어요.

출처: 문서

본문

기본 URL 공유는 이렇게 생겼어요.

https://${your-domain}/path/to/your/dashboard

여기에 변수를 쿼리 파라미터로 추가하면:

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

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

Grafana는 var- 접두사가 붙은 쿼리스트링 파라미터를 해당 대시보드의 변수로 해석합니다. 예를 들어 var-example=value는 example 변수에 value 값이 설정된 것을 의미해요.

변수에 여러 값 전달

각 값마다 변수 파라미터를 반복하면 됩니다.

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

var-example=value1&var-example=value2는 example 변수가 value1, value2 두 값을 갖는 것으로 해석돼요.

예제: Grafana Play 대시보드는 server 변수를 여러 값으로, app과 interval 변수를 단일 값으로 전달해요.

필터와 group by 차원

필터는 데이터 소스에서 사용 가능한 차원을 자동으로 쿼리하고, 사용자가 대시보드에서 필터를 추가/제거하거나 차원별 그룹 바이를 동적으로 수행하게 해줍니다. 지정된 데이터 소스를 사용하는 모든 메트릭 쿼리에 필터를 대시보드 전체에 빠르게 적용할 수 있어요. 자세한 내용은 Filter and Group by 문서를 참고하세요.

필터를 쿼리 파라미터로 전달하려면 변수 문법을 사용하고 키·연산자·값을 파이프(|)로 구분한 목록으로 제공하세요.

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

→ example_key 키, = 연산자, example_value 값으로 필터 적용.

참고: 필터가 포함된 URL을 공유할 때는 URL을 인코딩하세요. 위 예에서 파이프(|)는 %7C, 등호(=)는 %3D로 바꾸세요.

예제: Grafana Play 예시는 Filters 변수에 job = metrictank/tsdb-gw 필터 값을 전달해요.

URL로 시간 범위 제어

다음 쿼리 파라미터로 대시보드 시간 범위를 제어할 수 있어요.

from - 시간 범위 하한 (ms, epoch, 상대 시간)
to - 시간 범위 상한 (ms, epoch, 상대 시간)
time와 time.window - time-time.window/2부터 time+time.window/2까지의 범위. 둘 다 ms로 지정. 예: ?time=1500000000000&time.window=10000 → 10초 범위(1499999995000~1500000005000)
timezone - 시간대. 예: timezone=Europe/Madrid

이들은 변수가 아니므로 var- 접두사가 필요 없어요. 마지막 5분 범위 예시:

https://${your-domain}/path/to/your/dashboard?from=now-5m&to=now

대시보드 링크의 변수

대시보드 설정에서 대시보드 링크를 만들 때 "현재 대시보드 변수를 링크에 포함" 옵션을 선택하면 현재 변수가 링크에 포함됩니다. 단계별 방법은 대시보드 링크 관리를 참고하세요.

대시보드 URL 변수