History Monitor
본 장은 History Monitor를 이해하고 이를 XML파일로 작성하는 법을 배우기 위한 장이다.
Introduction
History Monitor는 AMOND가 수집한 AI 또는 OS의 이력 정보를 조회/분석하기 위한 모니터이다. 따라서, Concepts 장에서 설명했듯이 History Monitor는 MR에 질의를 보내서 결과를 사용자에게 보여준다.
주의점
- AMS를 구성할 때, AI의 정보를 반드시 입력하여야 한다. 이유는 MR에 저장된 데이터를 조회할 때 다수의 AI에서 수집된 데이터가 존재하기 때문에 식별자가 필요한 데, AdminCenter2는 입력된 AI의 정보를 이용한다. 이때 AI가 동작하지 않아도 상관없다.
- AdminCenter에서 AI정보를 입력시 ID는 AMOND의 configuration file에서 설정한 AI의 ID와 일치해야 한다. 즉, amond.conf의 MANAGEDSERVER의 값과 AdminCenter2의 ALTIBASE INSTANCE의 ID를 밑의 그림을 참조한다.

장애상황
질의문에 이상이 있거나 MR에 문제가 생긴 경우 Warning message를 출력하고, 해당 모니터는 초기화가 된다. 문제를 해결 후 해당 모니터를 보기 위해서는 반드시 한번 모니터를 닫아주고 다시 열어야 한다.
모니터 사용법
모든 History Monitor는 아래의 그림과 같은 Monitor Header를 가지고 있다.

첫번째 그룹은 현재 상황을 보여주기 위한 것으로 다음과 같은 항목으로 구성되어 있다.
- 현재 표시된 데이터: 두번째 그룹에 의해 데이터가 필터링된 경우 데이터의 갯수.
- 전체 데이터: 이력 데이터가 저장된 테이블의 총 데이터 갯수
- Update data 버튼: 데이터를 테이블로부터 다시 가져온다.
두번째 그룹은 데이터 분석을 위한 것으로 다음과 같은 항목으로 구성되어 있다.
- FROM: 보여지는 데이터의 범위 중 시작점
- TO: FROM: 보여지는 데이터의 범위 중 종착점
- ANY/ALL: Threshold에 의한 컬럼들의 상태에 따라서 뒤쪽에 이어지는 Unknown, Green, Yellow, Red 조건에 따라서 컬럼들을 조합하는 조건이다. 이는 OR/AND 개념과 동일한 것으로 예를 들어 Red만 선택한 후, ANY를 선택하는 경우, Red 상태인 컬럼이 하나라도 있는 모든 레코드를 출력한다, 이에 반해 같은 조건에서 ALL을 선택하는 경우 모든 컬럼들이 Red인 레코드만 출력된다.
- Column Condition (Unknown, Green, Yellow, Red): Unknown은 Threshold가 주어지지 않은 경우의 컬럼의 상태이다. 나머지는 조건들은 Snapshot Monitor에서 설명한 조건들과 일치한다.
- Filter: 조건에 따라서 데이터를 필터링를 실행한다.
Monitoring Elements for History Monitor
XML structure
History monitor를 위한 monitoring element는 다음 그림에서 보듯이 HISTORY_CHART, HISTORY_TABLE, HISTORY_SET 세가지가 제공된다. 이 세가지는 Presentation의 방법으로 기반의 domain model은 동일하다.

- 연보라색 네모: xml element
- 노란색 네모: attribute list
- *: multiple
- 점선: 선택사항
- 실선: 필수사항
위 그림에서 오렌지 박스 부분은 선택사항이으로, 다시 말해 History Monitor를 위한 monitoring element들의 필수 요소는 질의문 한가지이며 나머지는 모두 선택사항이다.
HISTORY_CHART
HISTORY_CHART element는 이력 데이터를 추세를 차트 형태로 표현하기 위한 것이다.

필수 요소들
QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항
- 질의문의 첫 컬럼이 반드시 알티베이스는 DATE형이어야 하고 다른 DB는 Timestamp타입이어야 한다.
- 질의문에서 조회할 테이블의 이름에 테이블 이름을 직접 기입하는 대신에 ProfileJob이름을 "#"으로 감싸주면 AdminCenter2가 실제 테이블 이름으로 치환시켜준다. 실제 테이블 이름을 바로 기입하여도 동작하지만, AMOND의 정책에 의하여 테이블 이름이 변경될 수 있다는 점을 알아야 한다.
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를 주어서 데이터를 분석하기 편하게 하기 위한 것이다.

필수 요소들
QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항
- 질의문의 첫 컬럼이 반드시 알티베이스는 DATE형이어야 하고 다른 DB는 Timestamp타입이어야 한다.
- 질의문에서 조회할 테이블의 이름에 테이블 이름을 직접 기입하는 대신에 ProfileJob이름을 "#"으로 감싸주면 AdminCenter2가 실제 테이블 이름으로 치환시켜준다. 실제 테이블 이름을 바로 기입하여도 동작하지만, AMOND의 정책에 의하여 테이블 이름이 변경될 수 있다는 점을 알아야 한다.
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가 어디인지 정의한다.
- TYPE: Threshold의 YELLOW, RED값이 결과값에게 어떻게 비교되어야 하는지 정의하는 attribute이다. 다섯가지 타입 - GT(Greater Than), GTE (Greater Than or Equal), LT (Less Than), LTE (Less Than or Equal), NONE - 중 한가지를 선택해야 한다. NONE을 쓰는 것은 THRESHOLD를 생략하는 것과 같은 결과이다.
- YELLOW: YELLOW value range를 정의한다. 예를 들어 TYPE='GT'이고 YELLOW='50'이면 50이상의 질의 결과에 대해서는 노란색으로 표현된다.
- RED: RED value range를 정의한다. 예를 들어 TYPE='GT'이고 RED='90'이면 90이상의 질의 결과에 대해서는 배경색이 빨간색으로 표현된다.
주의할 점은 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의 모든 특성을 지니고 있다.

필수 요소들
QUERY
QUERY element는 질의문을 위한 element로 History Monitor에서 single query만 지원한다.
주의사항
- 질의문의 첫 컬럼이 반드시 알티베이스는 DATE형이어야 하고 다른 DB는 Timestamp타입이어야 한다.
- 질의문에서 조회할 테이블의 이름에 테이블 이름을 직접 기입하는 대신에 ProfileJob이름을 "#"으로 감싸주면 AdminCenter2가 실제 테이블 이름으로 치환시켜준다. 실제 테이블 이름을 바로 기입하여도 동작하지만, AMOND의 정책에 의하여 테이블 이름이 변경될 수 있다는 점을 알아야 한다.
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가 어디인지 정의한다.
- TYPE: Threshold의 YELLOW, RED값이 결과값에게 어떻게 비교되어야 하는지 정의하는 attribute이다. 다섯가지 타입 - GT(Greater Than), GTE (Greater Than or Equal), LT (Less Than), LTE (Less Than or Equal), NONE - 중 한가지를 선택해야 한다. NONE을 쓰는 것은 THRESHOLD를 생략하는 것과 같은 결과이다.
- YELLOW: YELLOW value range를 정의한다. 예를 들어 TYPE='GT'이고 YELLOW='50'이면 50이상의 질의 결과에 대해서는 노란색으로 표현된다.
- RED: RED value range를 정의한다. 예를 들어 TYPE='GT'이고 RED='90'이면 90이상의 질의 결과에 대해서는 배경색이 빨간색으로 표현된다.
주의할 점은 History Monitor에서의 Threshold는 All-or-nothing이다. 즉, 생략하거나 첫 컬럼을 제외한 모든 컬럼의 Threshold를 제공하여야 한다. 특정 컬럼의 Threshold를 지정하고 싶지 않은 경우는 Threshold type을 NONE으로 기입하면 된다.
위의 예제에서는 Threshold가 하나 밖에 없는데 이는 시간을 제외한 데이터 컬럼이 하나밖에 없기 때문이다.
sample
AdminCenter2와 함께 배포된 _XmlSamples/History_Set.xml을 참조한다.