WebLogic 에이전트에 대한 트랜잭션 추적 구성

WebLogic 에이전트의 트랜잭션 추적 기능을 사용하려면 에이전트 인스턴스 환경 설정 파일 및 WebLogic 서버 시작 파일을 변경해야 합니다. 변경에 사용할 수 있는 스크립트가 제공됩니다.

시작하기 전에

트랜잭션 추적 툴킷이 올바르게 작동하기 위해 열린 파일의 자원 한계가 5,000보다 큰지 확인하십시오.

• 현재 열린 파일 한계 설정을 표시하십시오. ulimit -n
• 열린 파일 한계를 5,056으로 설정하는 예제입니다. ulimit -n 5056

이 프로시저를 수행하기 전에 WebLogic 모니터링 구성 1단계 또는 2단계를 수행하십시오.

참고: 트랜잭션 추적 기능은 Cloud APM, Advanced 오퍼링의 WebLogic 에이전트에서 제공됩니다. Cloud APM, Base 오퍼링에 있는 기본 자원 모니터링 기능을 사용하는 WebLogic 에이전트의 경우 이 단계를 건너뛰십시오.

트랜잭션 추적 기능으로 모니터하는 WebLogic 서버에 WebLogic 에이전트를 로컬로 설치해야 합니다.

이 스크립트를 실행하는 사용자 계정은 다음 디렉토리 및 파일에 대해 쓰기 권한이 있어야 합니다.

1. WEBLOGIC_HOME 디렉토리.
2. WEBLOGIC_HOME/bin 디렉토리 및 파일.
3. install_dir/config 디렉토리.
4. install_dir/config/hostname_wb_instance_name.cfg 파일.

여기서,

WEBLOGIC_HOME

WebLogic 서버 설치 디렉토리입니다.

install_dir

에이전트가 설치되는 경로입니다. 해당 로그의 기본 경로는 다음과 같습니다.

• /opt/ibm/apm/agent
• C:\IBM\APM\TMAITM6_x64

hostname

에이전트가 설치된 호스트 컴퓨터의 이름입니다.

instance_name

에이전트 구성 방법 주제에 지정되는 에이전트 인스턴스 이름입니다.

• Windows 시스템에 에이전트 구성, 3단계
• 프롬프트에 응답하여 에이전트 구성, 1단계
• 자동 응답 파일을 사용하여 에이전트 구성, 2단계

simpleConfig 스크립트를 실행하십시오.

1. WebLogic 에이전트가 설치된 WebLogic 서버에 로그인하십시오.
2. 디렉토리를 에이전트 설치 디렉토리로 변경하십시오.
   • install_dir
   • install_dir\TMAITM6_x64

   여기서 install_dir은 에이전트가 설치되는 경로입니다.

   기본 install_dir 경로는 다음에 나열됩니다.

   • /opt/ibm/apm/agent
   • C:\IBM\APM\TMAITM6_x64
3. 디렉토리를 wbdchome/8.1.4.0.0/bin으로 변경하십시오.
4. 설정 스크립트를 실행하십시오.
   • ./simpleConfig.sh
   • simpleConfig.bat
5. 사용자 환경의 매개변수를 입력하라는 프롬프트를 따르십시오.
   1. 감지된 에이전트 인스턴스 및 하위 노드 조합의 목록에서 구성할 WebLogic 에이전트 instance_name 및 하위 노드를 선택하십시오. 여기서, instance_name은 에이전트 인스턴스 이름입니다.
   2. WebLogic 서버 시작 방법의 번호를 입력하십시오.
   3. WebLogic 도메인 루트 검색 경로를 입력하십시오.
      이 경로는 WebLogic 도메인을 검색할 기본으로 사용됩니다. WEBLOGIC_HOME 환경 변수가 설정된 경우 해당 값은 기본값으로 제공됩니다.
   4. 구성할 WebLogic 서버의 WebLogic 도메인 번호를 입력하십시오.
   5. 구성할 WebLogic 서버 이름의 번호를 입력하십시오.
   WebLogic startup script의 WebLogic 시작 방법을 사용하는 구성 예제입니다.

   ./simpleconfig.sh
   
   The following agents and subnodes are not yet configured for transaction tracking:
   
   1) wlinst1 Server1
   2) wlinst1 Server2
   
   Type the number that corresponds to the agent instance and subnode that you want to configure.
   
   Type your selection here (For example: 1): 1
   
   The following WebLogic startup methods are supported:
   
   1) WebLogic startup script
   2) WebLogic Node Manager
   
   Type your selection here (default is 1): 1
   
   The path to begin looking for WebLogic domains.
   WebLogic domain search root (default is: ): /home/wlsadmin
   
   The found WebLogic domain paths are:
   
   1) /home/wlsadmin/oracle/user_projects/domains/ttdd
   
   Type the number that corresponds to the WebLogic domain containing the WebLogic server that 
   you want to configure.
   
   Type your selection here (For examble: 1): 1
   
   The following WebLogic servers are available for configuration:
   
   1) AdminServer
   2) Server1
   
   Select a WebLogic server name (default is: 2): 2
   INFO: [2000] Automatic configuration of agent environment file succeeded.
   INFO: [3000] Automatic configuration of WebLogic start script succeeded.
   INFO: [9000] Restart the WebLogic agent and WebLogic server for configuration to take effect.

6. 5.b단계에서 WebLogic 서버 시작 방법으로 WebLogic Node Manager가 선택된 경우 이 단계를 수행하십시오. 그렇지 않을 경우, 7단계로 이동하십시오.
   1. 5단계에서 출력 텍스트의 정보 메시지 번호 3011에 나열된 weblogic_nodemanager_dc_opts 파일을 여십시오.
      WebLogic Node Manager의 WebLogic 시작 방법을 사용하는 구성 출력 예제입니다.

      INFO: [2000] Automatic configuration of agent environment file succeeded.
      INFO: [3010] Automatic configuration of WebLogic start script skipped.
      INFO: [3011] Please review C:\IBM\APM\TMAITM6_x64\wbdchome\8.1.4.0.0\runtime\ttdd_win\win_Server1\
      staging\weblogic_nodemanager_dc_opts.win for required WebLogic JVM start options.
      INFO: [9000] Restart the WebLogic agent and WebLogic server for configuration to take effect.

   2. WebLogic 콘솔에 로그인하고 환경 > 서버를 선택하십시오.
   3. 구성할 서버를 선택하십시오.
   4. 구성 > 서버 시작 탭을 선택하십시오.
   5. weblogic_nodemanager_dc_opts 파일에서 WebLogic 콘솔에 있는 서버의 서버 시작 인수로 서버 시작 인수를 복사하고 변경사항을 저장하십시오.
      서버 시작 인수는 weblogic_nodemanager_dc_opts 파일에서 # Add the following lines to the server start arguments 주석 라인 뒤에 나오는 모든 라인입니다.
   6. 트랜잭션 추적 툴킷이 런타임에 공유 라이브러리 경로에 있는지 확인하십시오.
      방법을 선택하십시오.

      • Node Manager 시작 스크립트를 업데이트하십시오.
        참고: Node Manager에서 시작된 모든 WebLogic 서버에는 이 라이브러리 경로가 포함된 트랜잭션 추적 툴킷 오브젝트 파일 라이브러리로 설정됩니다.
        1. 5단계에서 출력 텍스트의 정보 메시지 번호 3011에 나열된 weblogic_nodemanager_dc_opts 파일을 여십시오.
        2. Node Manager 시작 스크립트의 트랜잭션 추적 툴킷 경로를 설정하십시오. 경로를 설정하는 명령은 weblogic_nodemanager_dc_opts 파일에서 # Make sure that the executable path available to the WebLogic server includes the toolkit lib directory 주석 라인 뒤에 나오는 라인입니다.
           • 생성된 weblogic_nodemanager_dc_opts.linux 파일에서 LD_LIBRARY_PATH 라인을 복사하여 Node Manager 시작 스크립트의 export JAVA_OPTIONS 라인 아래 붙여넣으십시오. 예: WEBLOGIC_HOME/user_projects/domains/domain_name/bin/startNodeManager.sh.
           • 생성된 weblogic_nodemanager_dc_opts.win 파일에서 PATH 라인을 복사하여 Node Manager 시작 스크립트의 export JAVA_OPTIONS 라인 아래 붙여넣으십시오. 예: WEBLOGIC_HOME\user_projects\domains\domain_name\bin\startNodeManager.bat.

           여기서, WEBLOGIC_HOME은 WebLogic 서버 설치 디렉토리이고, domain_name은 WebLogic 도메인 이름입니다.

      • Node Manager를 시작하는 사용자 계정에 대한 환경을 업데이트하십시오.
        참고: 사용자 계정에서 시작된 모든 애플리케이션에는 이 라이브러리 경로가 포함된 툴킷 오브젝트 파일 라이브러리로 설정됩니다.
        1. Node Manager를 시작하는 사용자에 대한 환경 설정을 편집하십시오.
           • 쉘 자원 파일 또는 쉘 프로파일 파일을 편집하십시오. 예를 들어, bash 쉘에서 .bashrc 또는 .bash_profile과 같습니다.
           • 제어판 > 시스템 및 보안 > 시스템 > 고급 시스템 설정 > 환경 변수... > user_name에 대한 사용자 변수 > 경로를 편집하십시오. 여기서, user_name은 WebLogic 서버를 시작하는 데 사용한 사용자 계정 이름입니다.
        2. 사용자 계정 환경에서 트랜잭션 추적 툴킷 경로를 설정하십시오. 경로를 설정하는 명령은 weblogic_nodemanager_dc_opts 파일에서 # Make sure that the executable path available to the WebLogic server includes the toolkit lib directory 주석 라인 뒤에 나오는 라인입니다.
           • 생성된 weblogic_nodemanager_dc_opts.linux 파일에서 export LD_LIBRARY_PATH 라인을 복사하십시오. export LD_LIBRARY_PATH 라인이 없으면 추가하십시오. 있으면 이를 편집하여 올바른 경로 구분 기호를 포함하는 기존 경로에 등호 기호 오른쪽에 있는 경로만 추가하십시오.
           • 생성된 weblogic_nodemanager_dc_opts.win 파일에서 set PATH 라인을 복사하십시오. 경로 변수가 user_name에 대한 사용자 변수 섹션에 없으면(여기서, user_name은 WebLogic 서버를 시작하는 데 사용된 사용자 계정 이름) 변수 이름으로 Path, 값으로 등호 기호 오른쪽의 경로를 입력하여 추가하십시오. 있으면 값을 편집하여 올바른 경로 구분 기호를 포함하는 기존 경로에 등호 기호 오른쪽에 있는 경로만 추가하십시오.
        3. 환경을 다시 로드하십시오.
   경고: startNodeManager 스크립트는 WebLogic 구성 유틸리티에서 생성됩니다. 다시 WebLogic 구성을 실행하면 변경사항을 유실할 수 있습니다.
7. WebLogic 서버 및 에이전트가 실행 중이면 다시 시작하십시오.