메트릭스 선택

요약

명령어

기능

CATEGORY

어떤 카테고리에서 데이터를 조회할지 선택합니다. 이 <명령어>와 <오퍼랜드>는 반드시 설정해야 합니다.

OID

특정 OID로부터 수집 데이터만 조회하도록 설정합니다.

OKIND

특정 OKIND로부터 수집 데이터만 조회하도록 설정합니다.

ONODE

특정 ONODE로부터 수집 데이터만 조회하도록 설정합니다.

HEADER

프론트 단에 전달하기 위한 값을 지정합니다.

TIME-RANGE

데이터를 조회할 시작시간, 끝시간을 지정합니다.

CATEGORY

  • 기능 : 어떤 카테고리에서 데이터를 조회할지 선택합니다. 이 <명령어>와 <오퍼랜드>는 반드시 설정해야 합니다.

  • <오퍼랜드> :

    1. 문자열 : 지정한 카테고리의 데이터를 조회합니다.

      # 조회시간에 상관없이 항상 app_counter 카테고리의 데이터를 로드합니다.
      CATEGORY app_counter
      TAGLOAD
    2. JSON : 데이터 조회 시간의 길이에 따라서 카테고리가 선택되도록 지정할 수 있습니다.

      # 조회시간이 6시간, 3일, 그 이상인 경우에 대해 각각 app_counter, app_counter{m5}, app_counter{h1} 카테고리를 선택합니다.
      CATEGORY {"app_counter":6h, "app_counter{m5}":3d, "app_counter{h1}":unlimit }
      TAGLOAD
  • 주의사항 :

    1. CATEGORY의 <오퍼랜드>로 하나의 값만 지정할 수 있습니다. 여러 CATEGORY의 데이터를 한 번에 확인하고 싶은 경우, JOIN을 사용해야합니다.

    2. 로딩 방식(TAGLOAD or FLEXLOAD)에 따라서 지정 가능한 카테고리가 달라집니다.

    3. 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
  • 주의사항 :

    1. OID, OKIND, ONODE 중 한 가지 값만 지정할 수 있습니다.

    2. <오퍼랜드>가 입력되지 않은(또는 파라미터의 값이 전달되지 않은) <명령어>는 무시됩니다.

    3. OID, OKIND, ONODE를 중복해서 사용하는 경우, 가장 마지막에 입력한 <명령어>만 적용됩니다.

    4. OIDSET은 deprecated되어 OID, OKIND, ONODE 중 한 가지 <명령어>를 사용하는 것이 권장됩니다.

    5. 데이터 로드 단계에서부터 필요한 데이터만을 조회한다는 점에서 데이터 가공 단계에서 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를 지정한 값이 무시됩니다.

    mxql 8
    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