History Monitor

본 장은 History Monitor를 이해하고 이를 XML파일로 작성하는 법을 배우기 위한 장이다.

Introduction

History Monitor는 AMOND가 수집한 AI 또는 OS의 이력 정보를 조회/분석하기 위한 모니터이다. 따라서, Concepts 장에서 설명했듯이 History Monitor는 MR에 질의를 보내서 결과를 사용자에게 보여준다.

주의점

Configuration

장애상황

질의문에 이상이 있거나 MR에 문제가 생긴 경우 Warning message를 출력하고, 해당 모니터는 초기화가 된다. 문제를 해결 후 해당 모니터를 보기 위해서는 반드시 한번 모니터를 닫아주고 다시 열어야 한다.

모니터 사용법

모든 History Monitor는 아래의 그림과 같은 Monitor Header를 가지고 있다.
History Monitor Analysis

첫번째 그룹은 현재 상황을 보여주기 위한 것으로 다음과 같은 항목으로 구성되어 있다.

두번째 그룹은 데이터 분석을 위한 것으로 다음과 같은 항목으로 구성되어 있다.

Monitoring Elements for History Monitor

XML structure

History monitor를 위한 monitoring element는 다음 그림에서 보듯이 HISTORY_CHART, HISTORY_TABLE, HISTORY_SET 세가지가 제공된다. 이 세가지는 Presentation의 방법으로 기반의 domain model은 동일하다. History Monitor Monitoring Elements

위 그림에서 오렌지 박스 부분은 선택사항이으로, 다시 말해 History Monitor를 위한 monitoring element들의 필수 요소는 질의문 한가지이며 나머지는 모두 선택사항이다.

HISTORY_CHART

HISTORY_CHART element는 이력 데이터를 추세를 차트 형태로 표현하기 위한 것이다.
History Monitor Chart

필수 요소들

QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항

QUERY의 attribute인 DATA_SOURCE는 MR로 지정한다. 아래의 예를 참조한다.

<QUERY DATA_SOURCE="MR">select check_time, (mem_alloc_page_count*32768)/mem_max_db_size*100 as used_db_size_percentage from #VDATABASE#</QUERY>

선택 요소들

CHART_SIZE
CHART_SIZE element는 해당 차트를 어떤 크기로 표시하겠다는 픽셀단위의 size hint이다. 하지만, 화면의 크기, element들의 갯수들과 같은 요소들을 고려하여 차트를 그리기 때문에 이 값은 이상적인 조건에서만 작동한다. 입력하지 않을 경우, height 200, width 100으로 셋팅한다.
THRESHOLD
현재 CHART element에서는 THRESHOLD를 표현하지 않기 때문에 본 요소는 무시된다.

sample

AdminCenter2와 함께 배포된 _XmlSamples/History_Chart.xml을 참조한다.

HISTORY_TABLE

HISTORY_TABLE element는 이력 데이터를 테이블로 표현하기 위한 것이다. 이 형식을 지원하는 이유는 Threshold를 주어서 데이터를 분석하기 편하게 하기 위한 것이다.
History Monitor Table

필수 요소들

QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항

QUERY의 attribute인 DATA_SOURCE는 MR로 지정한다. 아래의 예를 참조한다.

<HISTORY_TABLE NAME="Session Count">
   <QUERY DATA_SOURCE="MR">select check_time, count(*) as session_count from #VSESSION# group by check_time order by check_time</QUERY>
      <TABLE_SIZE HEIGHT="250" WIDTH="400" />
      <THRESHOLD TYPE="GTE" YELLOW="50" RED="800" />
</HISTORY_TABLE>

선택 요소들

TABLE_SIZE
TABLE_SIZE element는 해당 테이블을 어떤 크기로 표시하겠다는 픽셀단위의 size hint이다. 하지만, 화면의 크기, element들의 갯수들과 같은 요소들을 고려하여 그리기 때문에 이 값은 이상적인 조건에서만 작동한다. 입력하지 않을 경우, height 200, width 100으로 셋팅한다.
THRESHOLD
THRESHOLD는 질의된 결과의 상태를 시각적으로 표현하기 위한 element이다. THRESHOLD의 Attribute list는 값을 어떻게 비교할 것인지, yellow/red range가 어디인지 정의한다.
주의할 점은 History Monitor에서의 Threshold는 All-or-nothing이다. 즉, 생략하거나 첫 컬럼을 제외한 모든 컬럼의 Threshold를 제공하여야 한다. 특정 컬럼의 Threshold를 지정하고 싶지 않은 경우는 Threshold type을 NONE으로 기입하면 된다.
위의 예제에서는 Threshold가 하나 밖에 없는데 이는 시간을 제외한 데이터 컬럼이 하나밖에 없기 때문이다.

sample

AdminCenter2와 함께 배포된 _XmlSamples/History_Table.xml을 참조한다.

HISTORY_SET

HISTORY_SET element는 이력 데이터를 차트와 테이블로 동시에 표현하기 위한 것이다. HISTORY_CHART와 HISTORY_TABLE의 모든 특성을 지니고 있다.
History Monitor Set

필수 요소들

QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항

QUERY의 attribute인 DATA_SOURCE는 MR로 지정한다. 아래의 예를 참조한다.

<HISTORY_SET NAME="Statement Count">
    <QUERY DATA_SOURCE="MR">select check_time, count(*) as stmt_count from #VSTATEMENT# group by check_time order by check_time</QUERY>
        <CHART_SIZE HEIGHT="250" WIDTH="400" />
        <THRESHOLD TYPE="LTE" YELLOW="2500000.0" RED="100.0" />
</HISTORY_SET>

선택 요소들

TABLE_SIZE
TABLE_SIZE element는 해당 테이블을 어떤 크기로 표시하겠다는 픽셀단위의 size hint이다. 하지만, 화면의 크기, element들의 갯수들과 같은 요소들을 고려하여 그리기 때문에 이 값은 이상적인 조건에서만 작동한다. 입력하지 않을 경우, height 200, width 100으로 셋팅한다.
CHART_SIZE
CHART_SIZE element는 해당 차트를 어떤 크기로 표시하겠다는 픽셀단위의 size hint이다. 하지만, 화면의 크기, element들의 갯수들과 같은 요소들을 고려하여 차트를 그리기 때문에 이 값은 이상적인 조건에서만 작동한다. 입력하지 않을 경우, height 200, width 100으로 셋팅한다.
THRESHOLD
THRESHOLD는 질의된 결과의 상태를 시각적으로 표현하기 위한 element이다. THRESHOLD의 Attribute list는 값을 어떻게 비교할 것인지, yellow/red range가 어디인지 정의한다.
주의할 점은 History Monitor에서의 Threshold는 All-or-nothing이다. 즉, 생략하거나 첫 컬럼을 제외한 모든 컬럼의 Threshold를 제공하여야 한다. 특정 컬럼의 Threshold를 지정하고 싶지 않은 경우는 Threshold type을 NONE으로 기입하면 된다.
위의 예제에서는 Threshold가 하나 밖에 없는데 이는 시간을 제외한 데이터 컬럼이 하나밖에 없기 때문이다.

sample

AdminCenter2와 함께 배포된 _XmlSamples/History_Set.xml을 참조한다.