본문으로 건너뛰기

Java

Java 애플리케이션에서 로그 수집을 위한 설정 방법을 안내합니다.

에이전트 업데이트​

자바 에이전트 2.1.1 버전부터 가능합니다. 업데이트 방법은 다음 문서를 참고하세요.

에이전트 설정 확인​

홈 화면 > 프로젝트 선택 > 로그 > 로그 설정

  1. 와탭 모니터링 서비스 초기 화면에서 프로젝트를 선택한 후, 로그 > 로그 설정 메뉴로 이동하세요.

  2. 로그 모니터링 시작하기 탭의 1. 에이전트 설정 확인의 안내를 참고해 에이전트 설정을 확인하세요.

에이전트 설정하기​

  1. 프로젝트의 관리 > 에이전트 설정 메뉴를 클릭하세요.

  2. 옵션 작성의 옵션 선택 드롭 다운 목록에서 직접 입력을 클릭한 후, logsink_enabled=true 옵션을 작성하고 적용 버튼을 클릭해 추가하세요.

    • 키 입력창에 logsink_enabled을 작성하세요.

    • 값 입력창에 true을 작성하세요.

  3. 로그 모니터링을 적용하기 위해 애플리케이션을 다시 시작하세요.

주요 옵션​

  • hooklog_enabled Boolean

    기본값 false

    Log 라이브러리를 후킹(Hooking)하여 로그 모니터링을 활성화합니다.

    주의

    애플리케이션 실행 전, whatap.conf에 본 옵션이 활성화되어 있어야 이후 로그 모니터링의 On/Off를 logsink_enabled 설정을 통해 동적으로 제어할 수 있습니다. 애플리케이션 실행 전에 logsink_enabled 옵션이 true로 설정된 경우 본 옵션을 별도로 설정하지 않아도 로그 모니터링이 가능합니다.

    앞으로 로그 모니터링을 활용할 가능성이 있다면, 사전에 본 옵션을 꼭 설정할 것을 권장합니다.

  • hooklog_custom_methods

    사용자 정의 로그를 등록합니다. 임의의 로그 프레임워크 내용을 전달합니다. 사이트에서 개별로 만든 로그 모듈의 로그를 추적할 때 사용합니다.

    Java
    package io.home.test;

    public class MyLog {  
      public void customLog(String log) { ... }
    }
    whatap.conf
    hooklog_custom_methods=io.home.test.MyLog.customLog

  • logsink_enabled Boolean

    기본값 false

    Log 모니터링 기능을 On/Off 합니다.

    주의

    애플리케이션 실행 전, whatap.conf에 hooklog_enabled 옵션이 설정되어 있으면 본 옵션을 통해 로그 모니터링의 On/Off를 동적으로 제어할 수 있습니다.

  • logsink_trace_enabled Boolean

    기본값 false

    Log에 트랜잭션 ID를 삽입하여, 트랜잭션 트레이스의 로그 탭을 노출할지 여부를 지정합니다.

로그 모니터링 활성화​

홈 화면 > 프로젝트 선택 > 로그 > 로그 설정

로그 모니터링 시작하기 탭의 2. 로그 모니터링 활성화에서 와탭 로그 모니터링을 활성화 또는 비활성화 할 수 있습니다.

  • 아이콘 로그 모니터링 활성화: 토글 버튼을 켜면 로그 모니터링이 활성화되고, 활성화한 날부터 15일 동안 무료로 체험하실 수 있습니다.
  • 아이콘 로그 모니터링 비활성화: 토글 버튼을 끄면 로그 모니터링이 비활성화되고, 로그를 더 이상 저장하지 않습니다.
노트

로그 모니터링 활성화 권한

에이전트 설치 후 프로젝트에 대한 수정 권한이 있는 사용자만 로그 모니터링을 활성화할 수 있습니다. 권한에 대한 자세한 내용은 다음 문서를 참고하세요.