Anyframe Monitoring Tool을 기반으로 특정 어플리케이션에 대한 모니터링을 수행하기 위해서는 다음과 같은 절차를 거쳐 Anyframe Monitoring Tool을 설치하고 정상 동작 여부를 확인해야 한다. (Anyframe Monitoring Tool은 IE 6.x에서만 테스트되었다.)
anyframe.tools.monitoring-x.x.x.war와 anyframe.tools.monitoring.agent-x.x.x.zip 파일을 다운로드한다. (단, war 파일일 경우 Anyframe Open Source Community를 통해 다운로드하면 파일의 확장자가 zip 형태로 처리될 수 있으므로 확장자를 변경시켜 주어야 할 것이다.) 다운로드 대상 파일은 다음과 같다.
anyframe.tools.monitoring-x.x.x.war : Anyframe Monitoring Tool
anyframe.tools.monitoring-agent-x.x.x.zip : 모니터링 대상 어플리케이션에 배포되어야 할 라이브러리 및 속성 파일
어플리케이션 서버가 Tomcat인 경우, Anyframe Monitoring Tool을 배포하는 방법에 대해 알아보도록 하자.
[Tomcat Home]\webapps 폴더 하위에 앞서 다운로드한 anyframe.tools.monitoring-x.x.x.war 파일을 옮겨 놓는다.
Tomcat 서버를 동작시키면 동일한 위치에 압축이 자동으로 해제될 것이다.
이외의 어플리케이션 서버에 대해서는 각 어플리케이션 서버 배포 방법에 맞게 다운로드한 WAR 파일을 배포하면 된다.
어플리케이션 서버가 Tomcat인 경우, Anyframe Monitoring Tool이 정상적으로 실행되었는지 확인하는 방법에 대해 알아보도록 하자.
[Tomcat Home]\bin\catalina.bat 파일을 실행하여 Anyframe Monitoring Tool을 시작시킨다.
Tomcat 서버가 정상적으로 시작되었는지 콘솔창을 통해 확인한다.
브라우저 주소창에 http://localhost:8080/anyframe.tools.monitoring-1.0.0 을 입력하고, Anyframe Monitoring Tool 화면이 뜨는지 확인한다.
Anyframe Monitoring Tool의 좌측 상단 SELECT APPLICATION을 선택하였을 때, 모니터링 대상 어플리케이션을 선택할 수 있는 팝업창이 뜬다. 모니터링 대상 어플리케이션이 실행되지 않은 경우 어플리케이션 목록이 조회되지 않을 것이다.
본 매뉴얼을 통해 제공하는 anyframe.example.monitoring 프로젝트를 다운로드한 후 Example 어플리케이션을 실행시켜 모니터링이 정상적으로 이루어지는지 테스트해 보도록 한다. (* 모니터링 대상 어플리케이션을 위한 속성 정의 및 모니터링 대상 정의를 위해서는 Configuration을 참고하도록 한다.)
모니터링을 위한 Agent 설치
특정 어플리케이션 실행에 대한 모니터링을 수행하기 위해서는 모니터링 대상 어플리케이션이 참조하는 클래스패스에 infrared-agent-all-servlet-x.x.x.jar 파일이 추가되어 있어야 함에 유의해야 한다. infrared-agent-all-servlet-x.x.x.jar 파일은 anyframe.tools.monitoring-agent-x.x.x.zip 내에 포함되어 있으며 Anyframe OpenSource Community를 통해 다운로드할 수 있다. 본 매뉴얼을 통해 제공되는 anyframe.example.monitoring의 pom.xml 내에는 Agent 라이브러리가 참조 관계로 정의되어 있다.
Anyframe Monitoring Tool의 좌측 상단 SELECT APPLICATION을 선택하였을 때, 사용자의 컴퓨터 이름과 어플리케이션 이름이 나타나는 것을 알 수 있다.
해당되는 어플리케이션을 선택하고 OK 버튼을 클릭하면 모니터링 결과를 확인할 수 있게 된다.
다운로드
다음에서 테스트 DB를 포함하고 있는 hsqldb.zip과 example 코드를 포함하고 있는 anyframe.example.monitoring.zip 파일을 다운받은 후, 압축을 해제한다. 그리고 hsqldb 폴더 내의 start.cmd (or start.sh) 파일을 실행시켜 테스트 DB를 시작시켜 놓는다.
Maven 기반 실행
Command 창에서 압축 해제 폴더로 이동한 후 mvn jetty:run이라는 명령어를 실행시킨다. Jetty Server가 정상적으로 시작되었으면 브라우저를 열고 주소창에 http://localhost:8080/anyframe.example.monitoring을 입력하여 실행 결과를 확인한다.
Eclipse 기반 실행 - m2eclipse, WTP 활용
Eclipse에서 압축 해제 프로젝트를 import한 후, 해당 프로젝트에 대해 마우스 오른쪽 버튼을 클릭하고 컨텍스트 메뉴에서 Maven > Enable Dependency Management를 선택하여 컴파일 에러를 해결한다. 그리고 해당 프로젝트에 대해 마우스 오른쪽 버튼을 클릭한 후, 컨텍스트 메뉴에서 Run As > Run on Server (Tomcat 기반)를 클릭한다. Tomcat Server가 정상적으로 시작되었으면 브라우저를 열고 주소창에 http://localhost:8080/anyframe.example.monitoring 입력하여 실행 결과를 확인한다.
Eclipse 기반 실행 - WTP 활용
Eclipse에서 압축 해제 프로젝트를 import한 후, build.xml 파일을 실행하여 참조 라이브러리를 src/main/webapp 폴더의 WEB-INF/lib내로 복사시킨다. 해당 프로젝트를 선택하고 마우스 오른쪽 버튼을 클릭한 후, 컨텍스트 메뉴에서 Run As > Run on Server를 클릭한다. Tomcat Server가 정상적으로 시작되었으면 브라우저를 열고 주소창에 http://localhost:8080/anyframe.example.monitoring을 입력하여 실행 결과를 확인한다. (* build.xml 파일 실행을 위해서는 ${ANT_HOME}/lib 내에 maven-ant-task-2.0.10.jar 파일이 있어야 한다.)