개요
CloudHub의 Dashboard template variables를 사용하면 쿼리를 편집하지 않고도 Graph내 작성된 쿼리의 특정 요소를 변경할 수 있습니다. 등록된 Template variables을 선택하여 Dashboard의 데이터를 조회 할 수 있습니다.
Template variables 생성하기
Template variables는 CloudHub Dashboard를 만들 때 Graph 쿼리 및 제목에 사용됩니다.
쿼리에서 Template variables의 이름은 콜론(:)으로 묶어 선언 합니다.
Predefined template variables(사전 정의된 템플릿 변수) 또는 Custom template variables(사용자 정의 템플릿 변수)를 사용할 수 있습니다.
템플린 정의된 후 Dashboard 인터페이스(UI)에서 변수 값을 선택할 수 있습니다.
Predefined template variables
CloudHub는 UI의 요소에 Predefined template variables가 정의되어 있습니다. 이 변수는 모든 쿼리에서 사용할 수 있습니다.:dashboardTime::upperDashboardTime::interval:
dashboardTime
:dashboardTime: 이 변수는 Dashboard 우측상단의 시간 DropDown 값이 적용 됩니다.
상대 시간을 사용하는 경우 DropDown 에 지정된 시간 오프셋 (-5m, -15m, -30m 등)을 나타내며 시간은 "현
재"를 기준으로 가정합니다. 날짜 선택기로 정의된 절대 시간을 사용하는 경우 :dashboardTime:은 더 낮은 임계 값으로 채워집니다.
SELECT "usage_system" AS "System CPU Usage" FROM "telegraf".."cpu" WHERE time > :dashboardTime:
“지금”을 포함하지 않는 과거 데이터를 확인하려면 “date picker”를 사용하여 특정 시간 범위를 지정합니다.
Graph 쿼리는 보다 큼(>) 및 보다 작음(<) 연산자와
최소 값:dashboardTime:최대 값:upperDashboardTime:변수를 사용하여 쿼리를 작성합니다.
upperDashboardTime
:upperDashboardTime: 이 변수는 “date picker”를 사용할 때 지정된 최대범위 시간으로 정의됩니다.
Relative Time(상대 시간)을 이용하거나 Absolute Time(지정 시간)의 최대범위의 시간이 최대이면 최대시간은 now()로 전달됩니다.
SELECT "usage_system" AS "System CPU Usage" FROM "telegraf".."cpu" WHERE time > :dashboardTime: AND time < :upperDashboardTime:
interval
:interval: 이 변수는 Dashboard 우측상단의 interval DropDown 값이 적용됩니다.
Graph쿼리에서는 집계함수와 함께 사용돼야 하며 GROUP BY time() 절에 작성합니다.
SELECT mean("usage_system") AS "Average System CPU Usage"
FROM "telegraf".."cpu"
WHERE time > :dashboardtime:
GROUP BY time(:interval:)
Custom template variables 생성하기
Template Variables는 필터링하여 결과 값을 출력할 때 사용됩니다. Meta Query 또는 CSV를 업로드하여 변수를 만들 수 있습니다.
Template Variable 생성하기:
Dashboard 오른쪽 위의 “Variables”를 클릭한 다음 “+ Add Template Variable”를 클릭하십시오.
생성할 변수의 이름을 입력하십시오.
변수의 Type을 선택하십시오.
쿼리 결과 목록을 확인하고 기본값을 선택하십시오. CSV 또는 Map Type을 사용하는 경우 원하는 형식으로 원하는 값으로 CSV를 업로드하거나 기본값을 입력하십시오.
“Create” Click
Template variable을 생성하면 변수로 생성한 DropDown이 Dashboard의 상단에 추가되며 Graph 검색조건에 사용할 수 있습니다.
Template Variable Types
CloudHub는 다음과 같은 Template variable types를 지원합니다 :
Databases
Measurements
Field Keys
Tag Keys
Tag Values
CSV
Map
Custom Meta Query
Text
Databases
Database를 변수로 사용
Database meta query
Database template variables는 아래의 meta query를 사용하여 InfluxDB 인스턴스의 모든 Database 항목을 조회 합니다.
SHOW DATABASES
cell query의 Database variable 사용예제
SELECT mean("usage_system") FROM :db:."autogen"."cpu"
Database variable 사용 예
Database template variables는 유사하거나 동일한 형태의 Database로 표현할 경우 유용하게 사용됩니다.
각 Database에 대한 Dashboard의 정보를 빠르게 변경 할 수 있습니다.
Measurements
Measurement를 변수로 사용
Measurement meta query
Measurement template variables는 아래의 meta query를 사용하여 지정된 Database의 속한 Measurements의 항목을 조회 합니다.
SHOW MEASUREMENTS ON database_name
cell query의 Measurement variable 사용예제
SELECT * FROM "telegraf"."autogen".:measurementVar:
Measurement variable 사용 예
Measurement template variables 사용하면 각 Measurement에 해당하는 Dashboard의 정보를 빠르게 변경 할 수 있습니다.
Field Keys
field key를 변수로 사용
Field key meta query
Field key template variables는 아래의 meta query를 사용하여 지정된 Database의 Measurements의 Field로 Group By된 항목을 조회 합니다.
SHOW FIELD KEYS ON database_name FROM measurement_name
cell query의 field key variable 사용예제
SELECT :fieldKeyVar: FROM "telegraf"."autogen"."customers"
Field key variable 사용 예
Field key template variables 사용하면 Measurement의 Field key에 해당하는 Dashboard의 정보를 빠르게 변경 할 수 있습니다.
Tag Keys
tag key를 변수로 사용
Tag key meta query
Tag key template variables는 아래의 meta query를 사용하여 지정된 Database의 Measurements의 Tag key 항목을 조회 합니다.
SHOW TAG KEYS ON database_name FROM measurement_name
cell query의 tag key variable 사용예제
SELECT "usage_system" FROM "telegraf"."autogen"."cpu" GROUP BY :tagKeyVar:
Tag key variable 사용 예
Tag key template variables 사용하면 Measurement의 Tag key에 해당하는 Dashboard의 정보를 빠르게 변경 할 수 있습니다.
Tag Values
tag value를 변수로 사용
Tag value meta query
Tag value template variables는 아래의 meta query를 사용하여 지정된 Database의 Measurement의 Tag Key에 GroupBy 된 모든 항목을 조회 합니다.
SHOW TAG VALUES ON database_name FROM measurement_name WITH KEY tag_key
cell query의 tag value variable 사용예제
SELECT "usage_system" FROM "telegraf"."autogen"."cpu" WHERE "species" = :tagValueVar:
Tag value variable 사용 예
Tag value template variables 사용하면 Measurement의 Tag value에 해당하는 Dashboard의 정보를 빠르게 변경 할 수 있습니다.
CSV
변수를 CSV(쉼표로 구분 된 값)으로 선언하여 쿼리의 일부에 사용합니다.
Example CSVs:
'network_router01', 'server01', 'server01-vm-cmp', 'server01-vm03', 'server02', 'server02-vm01'
'network_router01' 'server01' 'server01-vm-cmp' 'server01-vm03' 'server02' 'server02-vm01'
필드 값이 문자열 일 경우 InfluxQL에서 작은 따옴표를 사용하므로 작은 따옴표로 묶어야합니다.
'string1','string2','string3','string4'
cell query의 CSV value variable 사용예제
SELECT "purchases" FROM "animals"."autogen"."customers" WHERE "petname" = :csvVar:
CSV variable use cases
CSV template variables는 meta query를 사용할 수 없을 경우 사용자정의 변수를 이용합니다.
Map
변수를 사용자정의 형식의 key-value 목록으로 선언하여 쿼리의 일부에 사용합니다.
key-value중 key 값은 DropDown목록에 표시됩니다. value는 쿼리의 값에 사용됩니다.
CSV type과 달리 value를 특정한 이름으로 변경하여 지정할 경우 사용됩니다.
Example CSV:
host1,"'network_router01'" host2,"'server01'" host3,"'server01-vm-cmp'" host4,"'server01-vm03'" host5,"'server02'" host6,"'server02-vm01'"
0 Comments