표현식 쿼리(Expression queries)

표현식(expression)은 데이터 소스 쿼리를 결합하거나 조작하는 쿼리 유형입니다. 데이터 소스가 조회한 결과를 그대로 사용하지 않고, 수학 연산, 필터링, 집계, 결합을 통해 새로운 결과를 만들어냅니다. 경고 규칙과 패널 모두에서 사용할 수 있어요.

출처: Expression queries

본문

패널 편집기나 경고 규칙의 쿼리 편집기에서 Query 드롭다운을 열고 Expression을 선택하면 표현식을 추가할 수 있습니다.

표현식은 숫자로 된 쿼리 ID를 참조합니다. 예를 들어 #A, #B는 각각 A와 B 쿼리의 결과를 가리킵니다. 이렇게 참조한 결과를 수학 연산자, 조건문, 집계 함수 등으로 변환합니다.

표현식에는 여러 유형이 있습니다.

Math – 수학 연산을 수행합니다. 예: #A / 100, $A + 1, 반올림 함수 등. 산술 연산자와 함수를 이용해 숫자 값을 계산합니다.
Resample – 시계열을 일정한 시간 간격으로 리샘플링합니다. 리샘플링할 타임스탬프의 간격과 업샘플링/다운샘플링 방식을 지정합니다.
Reduce – 시계열 데이터를 단일 값으로 축약합니다. 예를 들어 last, first, mean, max, min, sum 같은 함수를 사용해 각 시계열을 타이밍 기준으로 하나의 값으로 줄입니다.
Classic conditions – 기존 그라파나 경고 조건을 사용합니다. 쿼리 결과가 감소된 값을 기준으로 설정한 조건(위/아래/다른 값)을 충족하는지 평가합니다.
Threshold – 결과 값을 임계값과 비교합니다. 예를 들어 #A가 0보다 크거나 같은지 같은 부등식 조건을 평가해 true/false를 반환합니다. 임계값을 초과할 때 경고를 발생시키는 데 유용합니다.
Binary operation – 두 개의 시계열 쿼리(예: #A와 #B)에 산술 연산을 적용합니다. +, -, *, /, %, ==, !=, >, < 같은 연산자를 지원합니다.
SQL – SQL 데이터 소스에서 SQL 표현식을 사용합니다 (별도 문서 참조).

Math 표현식에는 다음 함수를 쓸 수 있습니다.

abs(), log(), log2(), log10(), exp(), sqrt(), pow()
max(), min(), floor(), ceil(), round()
삼각함수: sin(), cos(), tan(), asin(), acos(), atan(), atan2(), sinh(), cosh(), tanh()
clamp() – 값을 주어진 최소/최대 범위 안으로 제한
sgn() – 부호 반환

경고 규칙에서는 Reduce 또는 Threshold 표현식으로 쿼리 결과를 평가해 경고를 발생시킵니다. 여러 데이터 소스를 단일 경고 규칙에서 쿼리한 뒤 표현식으로 결합할 수 있어요.