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

변수 유형

Grafana는 여러 유형의 변수를 사용합니다.

쿼리 변수 추가

쿼리 변수를 사용하여 지표 이름, 태그 값 또는 키 목록을 반환하는 데이터 소스 쿼리를 작성할 수 있습니다. 예를 들어 쿼리 변수는 서버 이름, 센서 ID 또는 데이터 센터 목록을 반환할 수 있습니다. 데이터 소스 쿼리를 사용하여 옵션을 동적으로 가져오면 변수 값이 변경됩니다.

쿼리 표현식에는 다른 변수에 대한 참조가 포함될 수 있으며, 실제로는 연결된 변수를 만들 수 있습니다. Grafana는 이를 감지하고 연결된 변수 중 하나가 변경되면 변수를 자동으로 새로 고칩니다.

쿼리 표현식

쿼리 표현식은 데이터 소스마다 다릅니다. 자세한 내용은 에서 데이터 원본 설명서를 참조하십시오데이터 원본에 연결.

일반 옵션 입력

쿼리 옵션 입력

사용자 지정 변수 추가

변경되지 않는 값에는 사용자 지정 변수를 사용하십시오. 이는 숫자, 문자열 또는 기타 변수일 수 있습니다.

예를 들어 변경되지 않는 서버 이름이나 지역 이름이 있는 경우 이러한 이름을 쿼리 변수 대신 사용자 지정 변수로 만들 수 있습니다. 변경되지 않으므로 다른 쿼리 변수 대신 체인 변수에 사용할 수 있습니다. 그러면 체인 변수가 업데이트될 때 Grafana가 보내야 하는 쿼리 수가 줄어듭니다. 체인 변수에 대한 자세한 내용은 을 참조하십시오. 체인 변수

일반 옵션 입력

사용자 지정 옵션 입력

텍스트 상자 변수 추가

텍스트 상자 변수에는 선택적 기본값이 있는 텍스트 입력 필드가 표시됩니다. 이 변수는 아무 값이나 입력할 수 있으므로 가장 유연한 변수입니다. 카디널리티가 높은 지표가 있거나 대시보드의 여러 패널을 동시에 업데이트하려는 경우 이 유형의 변수를 사용하십시오.

일반 옵션 입력

텍스트 옵션 입력

상수 변수 추가

숨겨진 상수를 정의하려면 상수 변수를 사용하십시오. 상수 변수는 공유하려는 대시보드의 지표 경로 접두사로 유용합니다. 대시보드를 내보내는 경우 상수 변수가 가져오기 옵션으로 변환됩니다.

상수 변수는 유연하지 않습니다. 각 상수 변수에는 값이 하나만 있습니다. 업데이트하려면 변수 설정을 업데이트해야 합니다.

상수 변수는 쿼리에 포함해야 하는 복잡한 값이 있지만 쿼리마다 다시 입력하고 싶지 않은 경우에 유용합니다. 예를 들어 서버 경로가 호출된 경우 이 경로를 라는 i-0b6a61efe2ab843gg $path_gg 변수로 바꿀 수 있습니다.

일반 옵션 입력

상수 옵션 입력

데이터 소스 변수 추가

전체 대시보드의 데이터 소스를 빠르게 변경하려면 데이터 소스 변수를 사용할 수 있습니다. 이는 데이터 원본의 인스턴스가 여러 개 있는 경우, 아마도 환경이 서로 다른 경우에 유용합니다.

일반 옵션 입력

데이터 소스 옵션 입력

간격 변수 추가

간격 변수를 사용하여 시간 범위를 나타냅니다 (예: 1m1h,1d). 대시보드 group-by-time 전체에 적용되는 명령으로 생각할 수 있습니다. 간격 변수는 비주얼리제이션에서 데이터를 그룹화하는 방식을 변경합니다. 자동 옵션을 사용하여 시간 범위당 설정된 수의 데이터 포인트를 반환할 수도 있습니다.

간격 변수를 시간 (InfluxDB의 경우), 날짜 히스토그램 간격 (for) 별로 그룹화하는 매개 변수로 사용하거나 요약 함수 매개 변수 (Graphite의 경우 OpenSearch) 로 그룹화할 수 있습니다.

일반 옵션 입력

간격 옵션 입력

간격 변수 예제

Graphite myinterval 함수에서 템플릿 변수를 사용하는 예:

summarize($myinterval, sum, false)

좀 더 복잡한 그래파이트 예제:

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

애드혹 필터 추가

일회성 또는 임시 필터를 사용하여 지정된 데이터 소스를 사용하는 모든 지표 쿼리에 자동으로 추가되는 키/값 필터를 추가할 수 있습니다. 다른 변수와 달리 쿼리에는 일회용 필터를 사용하지 않습니다. 대신 기존 쿼리에 필터를 작성하는 데 사용합니다.

일반 옵션 입력

옵션 입력

임시 필터 생성

Ad Hoc 필터는 사용 가능한 가장 복잡하고 유연한 변수 옵션 중 하나입니다. 이 변수를 사용하면 일반적인 변수 옵션 목록 대신 대시보드 전체의 임시 쿼리를 구성할 수 있습니다. 이러한 방식으로 적용하는 필터는 대시보드의 모든 패널에 적용됩니다.

체인 변수

연결 변수 또는 중첩 변수라고도 하는 체인 변수는 변수 쿼리에 하나 이상의 다른 변수가 있는 쿼리 변수입니다. 이 섹션에서는 체인 변수의 작동 방식을 설명하고 체인 변수를 사용하는 예제 대시보드에 대한 링크를 제공합니다.

체인 변수 쿼리는 데이터 원본마다 다르지만 전제는 모두 동일합니다. 체인 변수 쿼리를 지원하는 모든 데이터 원본에서 체인 변수 쿼리를 사용할 수 있습니다.

5개 또는 10개 수준의 복잡한 연결, 템플릿 기반 대시보드를 구축할 수 있습니다. 엄밀히 따지자면 깊이와 복잡성에는 제한이 없지만, 링크가 많을수록 쿼리 부하가 커집니다.

베스트 프랙티스 및 팁

다음 방법을 사용하면 대시보드와 변수를 더 쉽게 사용할 수 있습니다.

체인으로 연결된 새 변수 생성

변수 순서

대시보드 변수 목록에서 변수 순서를 변경하려면 각 항목의 오른쪽에 있는 위쪽 및 아래쪽 화살표를 선택합니다. Grafana 작업 공간은 이 목록에 따라 변수 드롭다운 목록을 왼쪽에서 오른쪽으로 나열하고 목록 맨 왼쪽에 변수를 표시합니다.

복잡성 고려 사항

변수에 종속성 계층이 많을수록 변수를 변경한 후 대시보드를 업데이트하는 데 시간이 더 오래 걸립니다.

예를 들어, 일련의 네 개의 연결된 변수 (국가, 지역, 서버, 지표) 가 있고 루트 변수 값 (국가) 을 변경하는 경우 Grafana 작업 공간은 대시보드의 시각화를 업데이트하기 전에 모든 종속 변수에 대한 쿼리를 실행해야 합니다.

전역 변수

Grafana에는 쿼리 편집기의 표현식에 사용할 수 있는 글로벌 내장 변수가 있습니다. 이 항목에서는 알파벳순으로 나열하고 정의합니다. 이러한 변수는 쿼리, 대시보드 링크, 패널 링크 및 데이터 링크에 유용합니다.

$__대시보드

이 변수는 현재 대시보드의 이름입니다.

$__from 및 $__to

Grafana에는 두 개의 내장 시간 범위 변수인 및 이 있습니다. $__from $__to 현재는 기본적으로 항상 에포크 밀리초로 보간되지만 날짜 형식을 제어할 수 있습니다.

위 구문은 ${__to} 다음과 함께 사용할 수도 있습니다.

URL에서도 이 변수를 사용할 수 있습니다. 예를 들어 6시간 전부터 지금까지의 시간 범위를 보여주는 대시보드로 최종 사용자를 보내려면 다음 URL을 사용하세요. https://play.grafana.org/d/000000012/grafana-play-home? 뷰패널=2&ORGID=1? 시작=지금-6시간&to=지금

$__간격

$__interval변수를 시간 (InfluxDB, Myself, Postgres, MSSQL의 경우), 날짜 히스토그램 간격 (의 경우) 별로 그룹화하는 매개 변수로 사용하거나 요약 함수 매개 변수 (Graphite의 경우 OpenSearch) 로 사용할 수 있습니다.

Grafana 작업 영역은 쿼리에서 시간별로 그룹화하는 데 사용할 수 있는 간격을 자동으로 계산합니다. 그래프에 표시할 수 있는 것보다 많은 데이터 포인트가 있는 경우 더 큰 간격으로 그룹화하여 쿼리를 더 효율적으로 만들 수 있습니다. 예를 들어 3개월 분량의 데이터를 검토할 때는 10으로 그룹화하는 것보다 1일을 기준으로 그룹화하는 것이 더 효율적입니다. 그래프가 똑같아 보이고 쿼리 속도도 빨라집니다. 시간 범위와 그래프 너비 (픽셀 수) 를 사용하여 $__interval 계산됩니다.

대략적인 계산: (from - to) / resolution

예를 들어, 시간 범위가 1시간이고 그래프가 전체 화면인 경우 간격은 다음과 같이 계산될 수 있습니다2m. 포인트는 2분 간격으로 그룹화됩니다. 시간 범위가 6개월이고 그래프가 전체 화면인 경우 간격은 1d (1일) 일 수 있습니다. 포인트는 일별로 그룹화됩니다.

InfluxDB 데이터 소스에서 레거시 $interval 변수는 동일한 변수입니다. 대신 $__interval을 사용하세요.

InfluxDB 및 OpenSearch 데이터 소스에는 간격을 하드코딩하거나 -> 구문을 사용하여 $__interval 변수의 최소 제한을 설정하는 데 사용되는 Group by time interval 필드가 있습니다. > >10m

$__interval_ms

이 변수는 시간 간격 형식의 $__interval 문자열이 아니라 밀리초 단위의 변수입니다. 예를 들어, 가 20m $__interval_ms 이면 $__interval is입니다. 1200000

$__이름

이 변수는 Singlestat 패널에서만 사용할 수 있으며 옵션 탭의 접두사 또는 접미사 필드에 사용할 수 있습니다. 변수는 시리즈 이름 또는 별칭으로 대체됩니다.

$__org

이 변수는 현재 조직의 ID입니다. ${__org.name}변수는 현재 조직의 이름입니다.

$__user

변수는 현재 사용자의 ${__user.id} ID입니다. ${__user.login}변수는 현재 사용자의 로그인 핸들입니다. 변수는 현재 사용자의 ${__user.email} 이메일입니다.

$__range

이 변수는 현재 Prometheus 데이터 소스에서만 지원됩니다. 이 변수는 현재 대시보드의 범위를 나타냅니다. 에 의해 계산됩니다to - from. 밀리초와 초로 표현하면 and라고 $__range_ms 합니다. $__range_s

$타임필터 또는 $__타임필터

$timeFilter변수는 현재 선택한 시간 범위를 표현식으로 반환합니다. 예를 들어, 시간 범위 간격 Last 7 days 표현식은 다음과 같습니다time > now() - 7d.

이 변수는 다음을 비롯한 여러 위치에서 사용됩니다.