메트릭스 선택
CATEGORY
-
기능 : 어떤 카테고리에서 데이터를 조회할지 선택합니다. 이 <명령어>와 <오퍼랜드>는 반드시 설정해야 합니다.
-
<오퍼랜드> :
-
문자열 : 지정한 카테고리의 데이터를 조회합니다.
# 조회시간에 상관없이 항상 app_counter 카테고리의 데이터를 로드합니다. CATEGORY app_counter TAGLOAD
-
JSON : 데이터 조회 시간의 길이에 따라서 카테고리가 선택되도록 지정할 수 있습니다.
# 조회시간이 6시간, 3일, 그 이상인 경우에 대해 각각 app_counter, app_counter{m5}, app_counter{h1} 카테고리를 선택합니다. CATEGORY {"app_counter":6h, "app_counter{m5}":3d, "app_counter{h1}":unlimit } TAGLOAD
-
-
주의사항 :
-
CATEGORY의 <오퍼랜드>로 하나의 값만 지정할 수 있습니다. 여러 CATEGORY의 데이터를 한 번에 확인하고 싶은 경우, JOIN을 사용해야합니다.
-
CATEGORY의 이름에 {m5} 또는 {h1}가 붙어있는 경우에 대해서는 MetricValue를 참고해주세요.
-
OID, OKIND, ONODE
-
기능 : 특정 OID, OKIND, ONODE로부터 추출된 데이터만 조회하도록 설정합니다. OID, OKIND, ONODE 중 한 가지 값만 지정할 수 있습니다.
-
<오퍼랜드> : 문자열로 하나의 값을 지정하거나, 문자열배열로 여러개의 값을 지정할 수 있습니다.
-
예시 :
CATEGORY app_counter OID 1388369480 TAGLOAD
CATEGORY app_counter OID [1388369480, 1388369481] TAGLOAD
CATEGORY app_active_stat ONODE 1693789385 TAGLOAD
-
주의사항 :
-
OID, OKIND, ONODE 중 한 가지 값만 지정할 수 있습니다.
-
<오퍼랜드>가 입력되지 않은(또는 파라미터의 값이 전달되지 않은) <명령어>는 무시됩니다.
-
OID, OKIND, ONODE를 중복해서 사용하는 경우, 가장 마지막에 입력한 <명령어>만 적용됩니다.
-
OIDSET은 deprecated되어 OID, OKIND, ONODE 중 한 가지 <명령어>를 사용하는 것이 권장됩니다.
-
데이터 로드 단계에서부터 필요한 데이터만을 조회한다는 점에서 데이터 가공 단계에서 FILTER를 적용하는 것과 차이점이 있습니다.
-
OKIND, ONODE <명령어>의 경우 CATEGORY <명렁어>에서 지정한 카테고리에 okind, onode 관련 필드(okind, onode, okindName, onodeName)가 포함되어 있는 경우만 사용할 수 있습니다. '사이트맵 > 분석 > 메트릭스 조회’에서 어떤 카테고리에 어떤 필드가 포함되어 있는지 확인할 수 있습니다. |
HEADER
-
기능 : MXQL로 조회된 데이터는 Flex 보드의 위젯에서 사용됩니다. MXQL로 조회된 데이터 중 어떤 필드를 어떤 타입으로 사용해서 Flex 보드의 위젯을 표현하는지에 대한 정보를 지정할 수 있습니다.
-
<오퍼랜드> : JSON문자열로만 지정할 수 있습니다.
-
예시 :
HEADER { apdex_satisfied$:I, apdex_tolerated$:I, apdex_total$:I, apdex$:F, category: app_counter} OID $oid CATEGORY app_counter TAGLOAD
-
주의사항 : Flex 보드의 위젯에서 사용하는 형식에 맞추어 전달해야 합니다.
TIME-RANGE
-
기능 : 데이터 조회 시간 범위를 설정할 수 있습니다. 기본적으로 테스트 환경의 DatePicker를 사용해서 시간을 지정합니다. 만약 테스트 환경에서 본 <명령어>를 사용하는 경우 DatePicker를 지정한 값이 무시됩니다.
Figure 1. 테스트 환경의 DatePicker
-- 최근 15초 동안의 데이터만 조회 TIME-RANGE { recent : 15s } CATEGORY app_counter TAGLOAD SELECT
-- etime이전 15초 동안의 데이터만 조회 (파라미터로 etime을 전달) TIME-RANGE {duration:15s, etime:$etime} CATEGORY app_counter TAGLOAD SELECT
-- stime부터 15초 동안의 데이터만 조회 (파라미터로 stime을 전달) TIME-RANGE {duration:15s, stime:$stime} CATEGORY app_counter TAGLOAD SELECT