실행 중인 응용프로그램 모니터링을 위한 어댑터 구성

일반 로그 어댑터는 어댑터가 생성한 Common Base Event 오브젝트를 로깅 에이전트로 송신할 수 있도록 하는 출력기 클래스를 제공합니다. 로그 및 추적 분석기는 로깅 에이전트에 첨부하여 응용프로그램 로그를 실시간으로 모니터하고 분석하는 데 사용할 수 있습니다.

전제조건:

모니터링하기 위한 어댑터를 구성하려면 다음 단계를 수행하십시오.

출력기 구성요소 갱신

참고: 새 어댑터 구성 파일이 작성되면 기본적으로 CBELogOutputter클래스를 사용하도록 구성됩니다. 이 설정을 변경하지 않았으면 이 프로시저를 건너뛸 수 있습니다.

어댑터 구성 파일의 출력기 구성요소는 Common Base Event 오브젝트를 로깅 에이전트에 작성하는 CBELogOutputter 클래스를 사용하도록 갱신되어야 합니다. 기존 출력기 구성요소를 갱신하거나 새 출력기 구성요소를 추가할 수 있습니다.

새 출력기 구성요소를 추가하려면 다음과 같이 하십시오.

  1. 어댑터 구성 파일을 편집하려면 네비게이터 분할창에서 해당 어댑터 구성 파일을 선택하십시오. 마우스 오른쪽 단추를 누르고 열기 도구 > 어댑터 구성 편집기를 선택하십시오. 파일이 편집기에 열립니다.
  2. 어댑터 구성 편집기 창에서 어댑터 > 구성 > 컨텍스트 인스턴스 노드를 펼치십시오.
  3. 마우스 오른쪽 단추로 컨텍스트 인스턴스를 누르고 추가 > 출력기를 선택하십시오. 컨텍스트 인스턴스에 새 출력기가 작성됩니다.
  4. 출력기 유형 필드에서 LoggingAgentOutputter를 선택하십시오.
  5. agentName 특성을 누르십시오. 특성 세부사항이 오른쪽 분할창에 표시됩니다.
  6. 특성 값을 원하는 로깅 에이전트 이름으로 갱신하십시오. 이 이름은 로그 및 추적 분석기에서 모니터할 로깅 에이전트로 표시됩니다.
  7. CBELogOutputter 클래스에 정보를 로그하기 전에 출력기를 대기하게 하려면, waitUntilLoggingTime이라는 특성을 추가하고 이 특성의 값을 밀리초 단위의 시간으로 설정하십시오. 이 특성을 추가하려면 마우스 오른쪽 단추로 새로 작성된 출력기를 누르고 추가 > 특성을 선택하십시오. 새 특성이 새 출력기 노드 아래에 작성됩니다.
  8. CBELogOutputter 클래스를 사용 가능하게 하려면 컨텍스트 기본 컨텍스트 구현에 연관된 출력기 구성요소를 작성해야 합니다. 컨텍스트 > 컨텍스트 기본 구현 컨텍스트를 여십시오.
  9. 마우스 오른쪽 단추로 컨텍스트 기본 구현 컨텍스트를 누르고 추가 > 구성요소를 선택하십시오. 새 구성요소가 컨텍스트에 추가됩니다.
  10. 다음 값으로 새 구성요소를 구성하십시오.
    이름: 컨텍스트에 있는 출력기 이름
    설명: 이 출력기가 수행하는 작업의 설명
    실행 파일 클래스: org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter
    로깅 레벨:출력기 구성요소가 사용해야 하는 내부 로깅 레벨.
    99값은 출력기가 메시지를 로그하지 않는 것을 의미합니다.
    0값은 출력기가 모든 심각도의 메시지를 로그하는 것을 의미합니다.
    권장되는 50값은 치명적이거나 심각한 내부 출력기 오류 메시지가 로그되는 것을 의미합니다.
    역할: 출력기
    고유 ID: 2단계에서 컨텍스트 인스턴스에 정의된 출력기를 나타내야 합니다. 찾아보기 단추를 사용하여 올바른 ID를 선택하십시오.
  11. 어댑터 구성 파일 변경사항을 저장하십시오.

컨텍스트 인스턴스 갱신

로그 분석기가 로그 파일을 연속적으로 모니터하게 하려면, 연속 조작을 위해 어댑터 구성 파일의 컨텍스트 인스턴스 특성을 갱신해야 합니다.

  1. 어댑터 구성 파일을 편집하려면 네비게이터 Perspective에서 해당 어댑터 구성 파일을 선택하십시오. 마우스 오른쪽 단추를 누르고 열기 도구 > 어댑터 구성 편집기를 선택하십시오. 파일이 편집기에 열립니다.
  2. 편집기 창에서 어댑터 > 구성 > 컨텍스트 인스턴스를 선택하십시오. 컨텍스트 인스턴스 세부사항이 오른쪽 분할창에 표시됩니다.
  3. 연속 조작 선택란을 선택하십시오.
  4. 최대 대기 시간 및 일시정지 간격 필드를 필요한 대로 구성하십시오.
  5. 어댑터 구성 파일 변경사항을 저장하십시오.

Java 프로세스를 실행하여 어댑터 실행

작성한 로그 어댑터는 Windows 환경에서 일괄처리 파일을 사용하거나 비Windows 환경에서 쉘 스크립트를 사용하여 외부적으로 실행될 수 있습니다. 아래의 파일은 로그 어댑터를 실행할 Java 프로세스를 실행하는 데 사용될 수 있는 샘플 파일입니다.
참고: 시스템에서 일반 로그 어댑터를 실행하려면 이 시스템에 Hyades가 설치되어야 합니다.

Windows 일괄처리 파일:

@rem USAGE:  runregex
@rem Change the following lines to point to the directory where you unzipped the runtime
@rem and the directory where your log adapter resides 
SET HYADES_HOME=d:\hyadesDC
SET YOUR_ADAPTER_DIRECTORY=MyAdapterDirectory
SET CONFIG_FILE=%HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%\myadapter.adapter
PUSHD %HYADES_HOME%\%YOUR_ADAPTER_DIRECTORY%
java -classpath "%HYADES_HOME%\lib\glaconfigs.jar;%HYADES_HOME%\lib\hexr.jar;%HYADES_HOME%\lib\hgla.jar;%HYADES_HOME%\lib\hglaconfig.jar;%HYADES_HOME%\lib\hlcore.jar;%HYADES_HOME%\lib\hlevents.jar;%HYADES_HOME%\lib\hparse.jar;;%HYADES_HOME%\lib\logparsers.jar;%HYADES_HOME%\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%"
POPD
비Windows 일괄처리 파일:
#!/bin/sh
# USAGE:  runregex_example.sh
# Change the following line to point to the directory where you unzipped the runtime
HYADES_HOME=/home/hyadesDC
export HYADES_HOME
YOUR_DIRECTORY=/yourdirectory
export YOUR_DIRECTORY

CONFIG_FILE=$HYADES_HOME/$YOUR_DIRECTORY/myadapter.adapter
export CONFIG_FILE

CUR_DIR=`pwd`
export CUR_DIR

cd $HYADES_HOME/$YOUR_DIRECTORY

java -classpath "$HYADES_HOME\lib\glaconfigs.jar;$HYADES_HOME\lib\hexr.jar;$HYADES_HOME\lib\hgla.jar;$HYADES_HOME\lib\hglaconfig.jar;$HYADES_HOME\lib\hlcore.jar;$HYADES_HOME\lib\hlevents.jar;$HYADES_HOME\lib\hparse.jar;;$HYADES_HOME\lib\logparsers.jar;$HYADES_HOME\lib\xalan.jar;" org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE"
cd $CUR_DIR
어댑터를 실행할 Java 프로세스를 실행하는 데 필요한 대로 파일을 구성하십시오.

실행 중인 응용프로그램 로그 모니터링

이제 실행 중인 응용프로그램 로그를 모니터할 준비가 되었습니다.

  1. 환경 설정에서 로깅이 사용 가능으로 설정되어 있는지 확인하십시오.
    1. 기본 도구 모음에서 창 > 환경 설정을 선택하십시오. 환경 설정 창이 열립니다.
    2. 왼쪽 분할창에서 프로파일링 및 로깅을 선택하십시오. 프로파일링 및 로깅 환경 설정이 오른쪽 분할창에 로드됩니다.
    3. 프로파일링 및 로깅 옵션 아래에서 로깅 사용 가능을 선택하십시오.

      프로파일링 및 로깅에 대한 환경 설정 분할창에서 로깅 사용 가능 선택란이 선택되었습니다.

    4. 확인을 선택하여 변경사항을 적용하십시오.
  2. 프로파일링 및 로깅 Perspective의 도구 모음에서 프로파일링 프로파일링 도구 아이콘 아이콘을 누르고 프로파일을 선택하십시오. 프로파일 마법사가 열립니다.
  3. 첨부 - Java 프로세스를 선택하고 목록 맨 아래에 있는 신규 단추를 누르십시오. 새 Java 프로세스 구성이 작성됩니다.
  4. 호스트 탭을 누르고 응용프로그램 로그가 상주하는 호스트를 선택하십시오.
    참고: 실행 중인 응용프로그램 로그를 모니터하려면 응용프로그램과 동일한 시스템에 Hyades 데이터 콜렉션 엔진이 실행 중이어야 합니다.
  5. 에이전트 탭을 누르고 화살표 키를 사용하여 구성된 로깅 에이전트를 선택하십시오.

    프로파일링 환경 설정 마법사에서 사용자가 작성한 로깅 에이전트가 왼쪽 분할창에 표시됩니다.

  6. 적용을 누르십시오.
  7. 실행을 눌러 로깅 에이전트에 첨부하십시오.
  8. 프로파일링 모니터 보기의 프로파일링 및 로깅 Perspective에서 로깅 에이전트를 선택하십시오.
  9. 마우스 오른쪽 단추로 에이전트를 누르고 모니터링 시작을 선택하십시오.
  10. 마우스 오른쪽 단추로 에이전트를 누르고 열기 도구 > 로그 보기를 선택하십시오. 응용프로그램 로그에서 로그 이벤트가 로그 보기에 로드됩니다.

 

관련 개념
Hyades 일반 로그 어댑터의 개요
Common Base Event 형식 스펙

관련 타스크
로그 구문 분석기 작성

관련 참조
어댑터 구성 파일 구조
어댑터 구성 편집기
정규 표현식 문법