Snapshot Monitor
본 장은 Snapshot Monitor를 이해하고 이를 XML파일로 작성하는 법을 배우기 위한 장이다.
Introduction
Snapshot Monitor는 ALTIBASE INSTANCE(AI)의 상태와 AMOND를 통한 Platform의 상태를 조회하기 위한 모니터이다. 따라서, Concepts 장에서 설명했듯이 Snapshot Monitor는 AI와 AMOND에게 직접 질의를 보내서 결과를 사용자에게 보여준다.
Snapshot Monitor의 상단에는 다음 그림과 같이 Interval(in seconds) 항목이 있어서 텍스트 박스에 1이상의 값을 입력한 뒤, Start버튼을 누르면 입력된 주기에 따라 주기적으로 값을 다시 가져와서 결과를 화면에 보여준다. 버튼을 다시 눌러주면 refresh가 종료된다.

장애상황
AI에 문제가 발생하여 Connection을 할 수 없는 경우, Warning message가 발생한다. 반면에 AMOND는 Stateless connection이기 때문에 connection에 문제가 발생하여도 Warning message를 발생시키지 않는다. 단, AI정보 자체를 입력하지 않은 경우
AI 또는 AMOND의 질의문에 문제가 있어 그 결과를 가져올 수 없는 경우, 결과의 값이 에러 상황의 값, 즉 SNAPSHOT_STRING의 경우 "--", SNAPSHOT_CHART의 경우 -1의 결과를 돌려준다.
Monitoring Elements for Snapshot Monitor
Snapshot Monitor를 위한 전반적인 구조는 XML4Monitor Overview장에서 설명한 부분과 동일하다. Snapshot Monitor에서 모니터링 대상의 상태를 보여주기 위한 monitoring element로 SNAPSHOT_STRING과 SNAPSHOT_CHART 두 가지를 제공하며 구조는 다음의 그림과 같다.

- 연보라색 네모: xml element
- 노란색 네모: attribute list
- *: multiple
- 점선: 선택사항
- 실선: 필수사항
위 그림에서 오렌지 박스 부분은 선택사항이며, SNAPSHOT_STRING과 SNAPSHOT_CHART의 특성은 다음과 같다.
- SNAPSHOT_STRING: 하나의 질의로 구성되며 결과 또한 하나의 String으로 표현되며, Threshold를 통하여 상태를 표현할 수 있다.
- SNAPSHOT_CHART: 한개 이상의 질의로 구성되며 결과가 Chart로 표현된다. 현재 Threshold를 지정하여도 상태를 표현할 수 없다.
이제 SNAPSHOT_STRING과 SNAPSHOT_CHART에 대해 좀더 자세히 알아보고 샘플을 통하여 직접 만들어 보자.
SNAPSHOT_STRING
SNAPSHOT_STRING은 AI 또는 AMOND에 하나의 질의를 보내서 그 결과를 표시하기 위한 monitoring element이다.
위 구조 그림에서 볼 수 있듯이 QUERY와 THRESHOLD element를 가지고, 다수의 결과를 가지는 질의문을 사용하는 경우 COLUMN_COUNT element를 반드시 입력해야 한다.
필수 요소들
QUERY
QUERY element는 질의문을 정의하기 위한 것으로 PCDATA, 즉 QUERY element의 시작과 종료 tag 사이에 질의문을 써 주면 된다. Attribute인 DATA_SOURCE는 질의문의 대상이 누군인지를 정의하기 위한 것으로 AI, AMOND 중 하나를 선택해야 한다.
DATA_SOURCE가 AI인 경우 질의문은 일반 SQL문을 써 준다. 다수개의 결과를 질의를 사용하는 경우, 반드시 결과의 갯수와 동일한 COLUMN_COUNT element의 값을 써 주어야 한다. 그리고 다수개의 결과를 위한 질의문을 사용하는 경우, 그 결과의 집합이 하나의 String으로 처리되기 때문에 THRESHOLD는 작동하지 않는다.
반면에 AMOND인 경우 Method name을 써야 하는데, 사용 가능한 Method는 AMOND 매뉴얼을 참조한다.
예) AI를 대상으로 질의
<SNAPSHOT_STRING NAME="DB Name">
<QUERY DATA_SOURCE="AI">SELECT RTRIM(DB_NAME) FROM V$DATABASE</QUERY>
</SNAPSHOT_STRING>
예) AI를 대상으로 한개의 결과를 위한 질의들의 집합을 사용
<SNAPSHOT_STRING NAME="MultipleQueries4String">
<QUERY DATA_SOURCE="AI" COLUMN_COUNT="3">SELECT count(t1.id)+10, count(t2.id), 'a' FROM V$SESSION t1, V$STATEMENT t2</QUERY>
</SNAPSHOT_STRING>
예) AI를 대상으로 하나 또는 여러 개의 결과를 위한 질의들의 집합을 사용
<SNAPSHOT_CHART NAME="MultipleQueries4Chart">
<!-- Multiple columns from AI -->
<QUERY DATA_SOURCE="AI" COLUMN_COUNT="2">SELECT count(t1.id)+10, count(t2.id) FROM V$SESSION t1, V$STATEMENT t2</QUERY>
<!-- Single column from AI -->
<QUERY DATA_SOURCE="AI">select ceil ((curr_size/max_size) * 100) from V$buffpool_Stat</QUERY>
<!-- Single result from AMOND -->
<QUERY DATA_SOURCE="AMOND">CPU_USAGE</QUERY>
<SERIES_NAME>SessionCount</SERIES_NAME>
<SERIES_NAME>StatementCount</SERIES_NAME>
<SERIES_NAME>BufferStat</SERIES_NAME>
<SERIES_NAME>CPU_USAGE(AMOND)</SERIES_NAME>
<!-- Optional elements -->
<MAX_AGE>120</MAX_AGE>
<CHART_SIZE HEIGHT="200" WIDTH="100" />
</SNAPSHOT_CHART>
예) AMOND를 대상으로 질의 (Method name: CPU_USAGE)
<SNAPSHOT_STRING NAME="CPU_USAGE(%)">
<QUERY DATA_SOURCE="AMOND">CPU_USAGE</QUERY>
</SNAPSHOT_STRING>
선택 요소들
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이상의 질의 결과에 대해서는 배경색이 빨간색으로 표현된다.
예) THRESHOLD 사용 예제 (500 이상이면 노란색, 800이상이면 빨간색)
<SNAPSHOT_STRING NAME="Session">
<QUERY DATA_SOURCE="AI">select count(*) from v$session</QUERY>
<THRESHOLD TYPE="GTE" YELLOW="500" RED="800" />
</SNAPSHOT_STRING>
Sample
위에서 본 예제들의 소스 코드는 다음과 같다. 아래 예에서 보듯이 SNAPSHOT_STRING요소를 포함하는 MONITOR_COLLECTION요소는 반드시 2의 배수로 지정해야 한다. 이유는 SNAPSHOT_STRING요소는 TITLE/VALUE pair로 이루어지기 때문이다. 이를 무시하는 경우, 동작은 하지만 화면의 레이아웃이 보기 싫게 배치된다.
<?xml version="1.0" encoding="UTF-16"?>
<!DOCTYPE Xml4Monitor SYSTEM "Xml4Monitor.dtd">
<Xml4Monitor>
<MONITOR NAME="SNAPSHOT_SAMPLE1" TYPE="SNAPSHOT">
<MONITOR_COLLECTION NAME="System Info" COLUMN_COUNT="2">
<!-- Data from AI without threshold -->
<SNAPSHOT_STRING NAME="DB Name">
<QUERY DATA_SOURCE="AI">SELECT RTRIM(DB_NAME) FROM V$DATABASE</QUERY>
</SNAPSHOT_STRING>
<!-- Data from AI with threshold -->
<SNAPSHOT_STRING NAME="Session">
<QUERY DATA_SOURCE="AI">select count(*) from v$session</QUERY>
<THRESHOLD TYPE="GTE" YELLOW="10" RED="20" />
</SNAPSHOT_STRING>
<!-- Data from AMOND with threshold -->
<SNAPSHOT_STRING NAME="CPU_USAGE(%)">
<QUERY DATA_SOURCE="AMOND">CPU_USAGE</QUERY>
<THRESHOLD TYPE="GTE" YELLOW="500" RED="800" />
</SNAPSHOT_STRING>
</MONITOR_COLLECTION>
</MONITOR>
</Xml4Monitor>
SNAPSHOT_CHART
SNAPSHOT_CHART는 AI 또는 AMOND에 하나 이상의 질의를 보내서 그 결과를 차트형식으로 표시하기 위한 monitoring element이다. 위 구조 그림에서 보듯이 QUERY, SERIES_NAME은 필수요소이고 MAX_AGE, CHART_SIZE, THRESHOLD는 선택요소이다.
필수 요소들
QUERY
SNAPSHOT_STRING과 거의 동일하나 차이점은 SNAPSHOT_CHART의 QUERY는 다수의 결과를 가지는 다수개의 질의를 허용한다는 점이다. 다음의 예를 보자.
<SNAPSHOT_CHART NAME="MultipleQueries">
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$SESSION </QUERY>
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$STATEMENT</QUERY>
<SERIES_NAME>SessionCount</SERIES_NAME>
<SERIES_NAME>StatementCount</SERIES_NAME>
<!-- Optional elements -->
<MAX_AGE>120</MAX_AGE>
<CHART_SIZE HEIGHT="200" WIDTH="100" />
</SNAPSHOT_CHART>
AI/AMOND의 질의 결과를 하나의 차트에서 표현하는 경우도 앞의 예와 별 다른 차이가 없다.
<!-- Data from AI/AMOND -->
<SNAPSHOT_CHART NAME="Percentage(%)">
<QUERY DATA_SOURCE="AMOND">CPU_USAGE</QUERY>
<QUERY DATA_SOURCE="AI">select ceil ((curr_size/max_size) * 100) from V$buffpool_Stat</QUERY>
<SERIES_NAME>CPU_USAGE(AMOND)</SERIES_NAME>
<SERIES_NAME>BUFFER_POOL_UTILIZATION(ALTIBASE)</SERIES_NAME>
<!-- Optional elements -->
<MAX_AGE>120</MAX_AGE>
<CHART_SIZE HEIGHT="200" WIDTH="100" />
</SNAPSHOT_CHART>
SERIES_NAME
SERIES_NAME elements는 차트내에서 각각의 데이터가 표현되는 이름이다. 반드시 질의 결과의 갯수와 SERIES_NAME element 갯수는 일치해야 한다. (위의 예를 참조한다.)
선택 요소들
위 구조 그림에서 보듯이 SNAPSHOT_CHART element는 MAX_AGE, CHART_SIZE, THRESHOLD 세가지의 Optional elements를 가지고 있다.
MAX_AGE
MAX_AGE element는 차트가 얼마나 오랜기간의 데이터를 표시할 것인가를 결정하는 요소이다. "Data from AI/AMOND" 예를 보면 120으로 되어 있는데, 이는 항상 현재부터 120초전 까지의 데이터를 차트에 표시하겠다는 의미이다. 입력하지 않을 경우 default로 60초로 셋팅된다.
CHART_SIZE
CHART_SIZE element는 해당 차트를 어떤 크기로 표시하겠다는 픽셀단위의 size hint이다. 하지만, 화면의 크기, element들의 갯수들과 같은 요소들을 고려하여 차트를 그리기 때문에 이 값은 이상적인 조건에서만 작동한다. 입력하지 않을 경우, height 200, width 100으로 셋팅한다.
THRESHOLD
현재 CHART element에서는 THRESHOLD를 표현하지 않기 때문에 본 요소는 무시된다.
Sample
위에서 본 예들의 전체 코드는 다음과 같다. 첫번째 예는 AI에게 여러 개의 질의를 보내는 예이고, 두번째 예는 AI/AMOND로 질의를 보내는 예이다. 세번째,네번째 예는 Optinoal elements를 전부 제거한 예로 동일한 예제들이다. 첫번째,두번째 예는 하나의 차트를 하나의 MONITOR_COLLECTION으로 감싼 경우이고, 세번째,네번째 예는 하나의 MONITOR_COLLECTION에 COLUMN_COUNT=2로 셋팅하여 두개의 차트를 수평으로 배열한 예이다.
<?xml version="1.0" encoding="UTF-16"?>
<!DOCTYPE Xml4Monitor SYSTEM "Xml4Monitor.dtd">
<Xml4Monitor>
<MONITOR NAME="SNAPSHOT_SAMPLE2" TYPE="SNAPSHOT">
<MONITOR_COLLECTION NAME="Chart_Examples" COLUMN_COUNT="2">
<!-- Multiple queries -->
<MONITOR_COLLECTION NAME="Example1" COLUMN_COUNT="1">
<SNAPSHOT_CHART NAME="MultipleQueries">
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$SESSION </QUERY>
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$STATEMENT</QUERY>
<SERIES_NAME>SessionCount</SERIES_NAME>
<SERIES_NAME>StatementCount</SERIES_NAME>
<!-- Optional elements -->
<MAX_AGE>120</MAX_AGE>
<CHART_SIZE HEIGHT="200" WIDTH="100" />
</SNAPSHOT_CHART>
</MONITOR_COLLECTION>
<!-- Data from AI/AMOND -->
<MONITOR_COLLECTION NAME="Example2" COLUMN_COUNT="1">
<SNAPSHOT_CHART NAME="Percentage(%)">
<QUERY DATA_SOURCE="AMOND">CPU_USAGE</QUERY>
<QUERY DATA_SOURCE="AI">select ceil ((curr_size/max_size) * 100) from V$buffpool_Stat</QUERY>
<SERIES_NAME>CPU_USAGE(AMOND)</SERIES_NAME>
<SERIES_NAME>BUFFER_POOL_UTILIZATION(ALTIBASE)</SERIES_NAME>
<!-- Optional elements -->
<MAX_AGE>120</MAX_AGE>
<CHART_SIZE HEIGHT="200" WIDTH="100" />
</SNAPSHOT_CHART>
</MONITOR_COLLECTION>
</MONITOR_COLLECTION>
<MONITOR_COLLECTION NAME="LayoutExamples" COLUMN_COUNT="2">
<!-- Multiple queries -->
<SNAPSHOT_CHART NAME="WithoutOptionalElements">
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$SESSION </QUERY>
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$STATEMENT</QUERY>
<SERIES_NAME>SessionCount</SERIES_NAME>
<SERIES_NAME>StatementCount</SERIES_NAME>
</SNAPSHOT_CHART>
<SNAPSHOT_CHART NAME="ParallelLayout">
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$SESSION </QUERY>
<QUERY DATA_SOURCE="AI">SELECT count(*) FROM V$STATEMENT</QUERY>
<SERIES_NAME>SessionCount</SERIES_NAME>
<SERIES_NAME>StatementCount</SERIES_NAME>
</SNAPSHOT_CHART>
</MONITOR_COLLECTION>
</MONITOR>
</Xml4Monitor>
이 XML 파일을 import시키면 다음과 같은 화면을 얻을 수 있다.
