메트릭스 선택

MXQL 문법을 이용해 메트릭스를 선택하는 명령어에 대해서 알아봅니다.

명령어	기능
CATEGORY	어떤 카테고리에서 데이터를 조회할지 선택합니다. 이 명령어와 오퍼랜드는 반드시 설정해야 합니다.
OKIND	특정 OKIND로부터 수집 데이터만 조회하도록 설정합니다.
OID	특정 OID로부터 수집 데이터만 조회하도록 설정합니다.
ONODE	특정 ONODE로부터 수집 데이터만 조회하도록 설정합니다.
HEADER	프론트 단에 전달하기 위한 값을 설정합니다.
TIME-RANGE	데이터를 조회할 시작 시간, 종료 시간을 설정합니다.

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을 사용해야합니다.
• 로딩 방식(TAGLOAD 또는 FLEXLOAD)에 따라서 설정 가능한 카테고리가 달라집니다.
• CATEGORY의 이름에 {m5} 또는 {h1}가 붙어있는 경우 MetricValue를 참고해주세요.

OID, OKIND, ONODE

특정 OID, OKIND, ONODE로부터 추출한 데이터만 조회하도록 설정합니다. OID, OKIND, ONODE 중 한 가지 값만 설정할 수 있습니다.

오퍼랜드

문자열로 하나의 값을 설정하거나 문자열 배열로 여러개의 값을 설정할 수 있습니다.

Example 1

CATEGORY app_counter
OID 1388369480
TAGLOAD

Example 2

CATEGORY app_counter
OID [1388369480, 1388369481] 
TAGLOAD

Example 3

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 문자열로만 설정할 수 있습니다.

Example

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를 설정한 값을 무시합니다.

• 최근 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