Redash v9의 경고 사용자 정의 기능

Redash의 경고 사용자 정의 기능

v8 시점에서는 실험적인 기능이라고 하는 위치 지정으로 디폴트 OFF였던 경고 커스터마이즈 기능이, v9에서는 UI·기능이 크게 개선됨과 함께 디폴트 ON이 되었습니다.
Redash v8의 경고 사용자 정의 기능 소개

메시지 맞춤설정

기본적으로 매우 간단한 경고 메시지를 사용자 정의할 수 있습니다.
기본적으로 임계값을 초과했음을 알렸지만 사용자 지정 기능을 사용하면 쿼리 실행 결과에서 메시지를 조립할 수 있습니다.


Default Template
Use Custom Template







Description 에 표시되는 것이 커스터마이즈 된 부분입니다.
이미지는 Slack을 예로 한 것입니다만, email나 PagerDuty 등 Redash에서 설정 가능한 다른 통지처에도 대응하고 있습니다( Alert Destination )

설정 화면

경고 설정 화면 하단의 Template 항목에서 Use custom template를 선택하면 사용자 정의 양식이 나타납니다.
Subject · Body 모두 템플릿 엔진의 mustache을 이용한 템플릿을 작성할 수 있습니다.

템플릿 작성 예

실행 결과에 target 열, 판매 전일 비율의 rate 열이 포함된 쿼리에 경고를 설정합니다.Body 에 다음과 같이 템플릿을 설정합니다.

ターゲット : 売上前日比
{{#QUERY_RESULT_ROWS}}
{{target}} : {{rate}}%
{{/QUERY_RESULT_ROWS}}

설정 화면에서 Preview 모드로 하면 이런 느낌이 표시됩니다. 예상대로 표시됩니다.

Subject 이나 Body 의 표시가 되는 방법은 Alert Destination 에 따라 다르므로, 어디까지나 템플릿의 기술의 확인용으로 Preview 모드를 이용하는 것이 좋을 것입니다.

템플릿에서 사용 가능한 변수

공식 문서에는 템플릿에서 사용할 수 있는 변수 목록이 나와 있습니다.
알림 설정 UI에 링크가있어 편리합니다.


개인적으로는 이 근처가 특히 사용할 것 같습니다.


변수 이름
유형
설명


ALERT_NAME
문자열
경고 이름

QUERY_URL
문자열
검색어 URL

QUERY_RESULT_VALUE
string or number
트리거로 설정된 열의 첫 번째 행 값

QUERY_RESULT_ROWS
value array
쿼리 결과 행

QUERY_RESULT_COLS
문자열 배열
쿼리 결과 열

끝에

약간의 감시나 리포팅이라면 Redash로 완결시킬 수 있을 것 같습니다.
UI의 개선도 진행되고 있어 v8 시점 로부터 꽤 사용하기 쉬워지고 있다고 느꼈습니다!