Query Manager

Query Manager 화면에서는 요건에 맞는 쿼리를 직접 작성하여 exemONE 수집 DB(Clickhouse 또는 PostgreSQL)에서 데이터를 조회하고, 지표를 생성하여 대시보드·알람·알림에 활용할 수 있습니다.

화면에 들어가려면 좌측 메뉴에서 Performance Analysis > Query Manager를 선택하세요.

화면 구성​

쿼리 작성 및 실행하기​

지표 변수 설정하기​

Set Stat Variable을 활성화하면 쿼리 지표가 설정된 위젯에서 동적으로 값을 참조하여 쿼리를 실행하기 위한 변수를 설정할 수 있습니다.

지표 변수 예약어

쿼리 예약 함수

쿼리 저장 및 공유하기​

대시보드 위젯 또는 알람에서 쿼리 매니저 지표를 사용하려면 저장 시 Share Query 옵션을 활성화하여 Data Setting을 지정해야 합니다.

지표 타입​

Metric 타입​

타임시리즈(Timeseries) 차트에 적용할 수 있습니다.

쿼리의 SELECT 절에 다음 필드를 반드시 포함해야 합니다.

지표 변수 fromTime, toTime, targetIds를 사용합니다. 범례 위젯 사용 시 targetIds를 반드시 추가합니다.

select target_id, toStartOfInterval(collect_time, INTERVAL '5 s') as time, argMax(value, collect_time) as value
from metric_dist
where data_id like 'host_stat_active_memory_usage'
and collect_time >= fromTime and collect_time < toTime
and target_id in ($_get_targets_from_tags('host', targetIds))
group by target_id, time

Current 타입​

누적 바(Stacked Bar), 스코어보드(Scoreboard) 차트에 적용할 수 있습니다.

쿼리의 SELECT 절에 다음 필드를 반드시 포함해야 합니다.

동적 조회 범위 적용 시 fromTime, toTime을 사용합니다. 범례 위젯 사용 시 targetIds를 반드시 추가합니다.

SELECT target_id, max(value) as value
FROM metric_dist
WHERE data_id like 'host_stat_active_memory_usage'
AND collect_time >= fromTime
AND collect_time < toTime
AND target_id in ($_get_targets_from_tags('host', targetIds))
GROUP BY target_id

Scatter 타입​

스캐터(Scatter) 차트에 적용할 수 있습니다. 최대 10분 범위의 데이터만 표현할 수 있습니다.

쿼리의 SELECT 절에 다음 필드를 반드시 포함해야 합니다.

범례 위젯 사용 시 targetIds를 반드시 추가합니다.

SELECT
    toStartOfMinute(collect_time) as time,
    elapsed_time,
    count(*) as count,
    groupArray(instance_id) as target_ids
FROM oracle_sql_elapse_dist
WHERE collect_time >= fromTime
AND collect_time < toTime
AND instance_id in ($_get_targets_from_tags('database', targetIds))
GROUP BY time, elapsed_time

Table 타입​

이퀄라이저, 트리 그리드, 상위 리스트, 파이(그래프 타입), 필터(셀렉트2 유형) 위젯에 적용할 수 있습니다.

지표 변수는 사용 목적에 따라 다음을 참고합니다.

필터 위젯 셀렉트2 유형으로 사용하는 샘플 쿼리입니다.

select
  distinct
  target_id as value,
  system_attributes['name'] as name
from target
where target_id in ($_get_targets_from_tags('database','database;tag;*'))

대시보드 위젯 연계​

Query Manager에서 저장한 지표(Share Query 활성화 필요)를 대시보드 위젯의 데이터로 활용할 수 있습니다. 위젯 설정에서 쿼리 정의 지표 사용 옵션을 선택합니다.

아래 위젯은 Query Manager를 지원하지 않습니다.

그래프 위젯(일부)

아키텍처 위젯

비즈니스 위젯

알람 지표 등록하기​

Query Manager에서 생성한 지표를 알람으로 등록할 수 있습니다. Setting > Alert > User Alert에서 설정합니다.

지표 등록 절차는 다음과 같습니다.

알람 등록은 Setting > Alert > User Alert에서 알람 지표를 선택한 후, Table 유형 알람 등록 절차에 따라 진행합니다.

Notification 파라미터 설정하기​

Query Manager에서 등록한 지표를 알람 Notification 파라미터로 활용할 수 있습니다. Setting > Alert > Notification에서 알림을 추가하거나 편집할 때 설정합니다.

이메일, 슬랙, 텔레그램, 웹훅, 온사이트 알림 유형을 지원합니다. (KakaoTalk, SMS 미지원)

주의사항​

• Metric / Current 타입 필수 alias: 쿼리 결과 alias에 time, value가 반드시 포함되어야 합니다.
• 알람 등록 지원 범위: Clickhouse Repository 데이터만 알람 등록이 가능합니다. PostgreSQL 조회 데이터는 알람으로 설정할 수 없습니다.
• Alert Data 토글 활성화 조건: Data Type에서 Table을 1개만 지정한 경우에만 Alert Data 토글이 활성화됩니다.
• targetIds 변수 사용 시: 태그 사용이 필수입니다. target_id를 직접 바인딩해서는 안 됩니다.
• 에러 발생 시 저장 불가: 쿼리 실행 결과에 에러가 발생하면 저장할 수 없습니다. 오류를 수정한 후 저장하세요.
• 쿼리 매니저 미지원 위젯: Gauge, Action View, Heat map, Daily Comparison, Architecture 위젯, Business 위젯은 Query Manager를 지원하지 않습니다.
• Notification 파라미터 적용 영역: fixed_contents 영역에서만 파라미터를 사용할 수 있습니다.
• YAML 파일 작성 시: 들여쓰기 및 띄어쓰기(하위 항목: 2칸)에 주의가 필요합니다.
• api v3.0.508.27 미만 환경: 기존 spring.query-manager-datasource 항목을 삭제한 후 신규 설정을 적용해야 합니다.