BinaryLog 명령 옵션

binaryLog 명령을 사용하여 2진 로깅 저장소의 컨텐츠를 보거나 복사하고, 저장소에서 사용 가능한 서버 프로세스 인스턴스를 나열할 수 있습니다. binaryLog 명령은 Traditional 애플리케이션 서버의 프로파일 bin 디렉토리에 있는 logViewer 명령과 동등합니다.

2진 로그 및 추적 기능은 2진 형식으로 저장소에 기록됩니다. binaryLog 명령을 사용하여 저장소를 보고 조회하며 필터링할 수 있습니다. binaryLog 명령은 저장소 컨텐츠를 다양한 형식(예: 기본 및 고급 형식)의 텍스트 파일로 빠르게 변환하기 위한 옵션을 제공합니다. 명령은 로그에서 필요한 데이터를 보다 쉽게 가져올 수 있도록 하는 옵션도 제공합니다. 예를 들어, 레벨, 로거 이름 또는 날짜 및 시간별로 원하는 로그 레코드를 필터링할 수 있습니다.

구문

명령 구문은 다음과 같습니다.

binaryLog action {serverName | repositoryPath} [options]

options의 값은 action의 값에 따라 다릅니다.

매개변수

binaryLog 명령에 대해 다음 조치를 사용할 수 있습니다.

view
저장소를 읽고, 선택적으로 이 저장소를 필터링한 후 사용자가 읽을 수 있는 버전을 작성합니다.

명령 구문은 다음과 같습니다.

binaryLog view {serverName | repositoryPath} [options]

serverName

읽어 올 저장소가 있는 Liberty 서버의 이름을 지정하십시오.

repositoryPath

읽어 올 저장소의 경로를 지정하십시오. 이 경로는 일반적으로 로그 데이터 및 추적 데이터 디렉토리가 둘 다 포함된 디렉토리입니다.

참고: serverName의 값과 repositoryPath의 값을 명령행에 지정하십시오. 그렇지 않으면, 태스크가 기본 서버 인스턴스, defaultServer(존재하는 경우)에 대해 실행됩니다.

필터 옵션:

모든 필터가 선택사항입니다. 여러 필터가 사용되는 경우 논리적으로 함께 ANDed 처리됩니다.

  • --minDate=value

    최소 레코드 작성 날짜를 기반으로 한 필터입니다. 값은 날짜(예: --minDate="23/01/17") 또는 날짜 및 시간(예: --minDate="23/01/17 17:39:53:100 EST")으로 지정되어야 합니다.

    [17.0.0.1 and later]ISO-8601 형식의 날짜 및 시간을 입력할 수도 있습니다. 예를 들어, --minDate="2017-01-23" 또는 --minDate="2017-01-23T17:39:53.100-0500"을 입력하십시오.

  • --maxDate=value

    최대 레코드 작성 날짜를 기반으로 필터링합니다. 값은 날짜(예: --maxDate="2/20/13") 또는 날짜와 시간(예: --maxDate="2/20/13 16:47:21:445 EST")으로 지정됩니다.

    [17.0.0.1 and later]ISO-8601 형식의 날짜 및 시간을 입력할 수도 있습니다. 예를 들어, --maxDate="2017-01-23" 또는 --maxDate="2017-01-23T17:39:53.100-0500"을 입력하십시오.

  • --minLevel=value

    최소 레벨을 기반으로 필터링합니다. 값은 FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL 중 하나여야 합니다.

  • --maxLevel=value

    최대 레벨을 기반으로 필터링됩니다. FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL 값 중에서 하나를 지정해야 합니다.

  • --includeLogger=value[,value]*

    지정된 로거 이름의 레코드를 포함합니다. 값에는 *가 와일드카드로 포함될 수 있습니다.

  • --includeMessage=value

    메시지 이름을 기반으로 필터링합니다. 값에는 *가 와일드카드로 포함될 수 있습니다.

  • --includeThread=value

    지정된 스레드 ID의 레코드를 포함합니다. 값은 16진(예: --includeThread=2a)이어야 합니다.

  • --includeExtension=name=value[,name=value]*

    지정된 확장 이름 및 값의 레코드를 포함합니다. 값에는 * 또는 ?가 와일드카드로서 포함될 수 있습니다. 쉼표를 값에 포함하려면 "\,"를 사용해야 합니다.

  • --includeInstance=value

    지정된 서버 인스턴스의 레코드를 포함합니다. 값은 "latest" 또는 올바른 인스턴스 ID여야 합니다. 올바른 인스턴스 ID의 목록을 보려면 listInstances 조치를 사용하여 이 명령을 실행하십시오.

모니터 옵션:
--monitor

계속적으로 저장소를 모니터링하고 새 컨텐츠를 생성된 대로 출력합니다.

출력 옵션:
  • --format={basic | advanced | CBE-1.0.1}

    사용할 출력 형식을 지정합니다. "basic"은 기본 형식입니다.

  • --encoding=value

    출력에 사용할 문자 인코딩을 지정합니다.

  • [17.0.0.1 and later]--isoDateFormat

    ISO-8601 날짜 및 시간 형식이 출력에 사용됨을 지정합니다.

copy
저장소를 읽고, 선택적으로 저장소를 필터링한 후 컨텐츠를 새 저장소에 씁니다.
명령 구문은 다음과 같습니다.
binaryLog copy {serverName | repositoryPath} targetPath [options]
serverName

읽어 올 저장소가 있는 Liberty 서버의 이름을 지정합니다.

repositoryPath

읽어 올 저장소의 경로를 지정합니다. 이 경로는 일반적으로 로그 데이터 및 추적 데이터 디렉토리가 포함된 디렉토리입니다.

targetPath

새 저장소를 작성할 경로를 지정합니다. targetPath를 지정해야 합니다. serverName 또는 repositoryPath도 지정해야 합니다.

필터 옵션:

모든 필터가 선택사항입니다. 여러 필터가 사용되는 경우 논리적으로 함께 ANDed 처리됩니다.
  • --minDate=value

    최소 레코드 작성 날짜를 기반으로 필터링합니다. 값은 날짜(예: --minDate="23/01/17") 또는 날짜 및 시간(예: --minDate="23/01/17 17:39:53:100 EST")으로 지정되어야 합니다.

    [17.0.0.1 and later]ISO-8601 형식의 날짜 및 시간을 입력할 수도 있습니다. 예를 들어, --minDate="2017-01-23" 또는 --minDate="2017-01-23T17:39:53.100-0500"을 입력하십시오.

  • --maxDate=value

    최대 레코드 작성 날짜를 기반으로 필터링합니다. 값은 날짜(예: --maxDate="23/01/17") 또는 날짜 및 시간(예: --maxDate="23/01/17 17:39:53:100 EST")으로 지정되어야 합니다.

    [17.0.0.1 and later]ISO-8601 형식의 날짜 및 시간을 입력할 수도 있습니다. 예를 들어, --maxDate="2017-01-23" 또는 --maxDate="2017-01-23T17:39:53.100-0500"을 입력하십시오.

  • --minLevel=value

    최소 레벨을 기반으로 필터링합니다. FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL 값 중에서 하나를 지정해야 합니다.

  • --maxLevel=value

    최대 레벨을 기반으로 필터링됩니다. FINEST | FINER | FINE | DETAIL | CONFIG | INFO | AUDIT | WARNING | SEVERE | FATAL 값 중에서 하나를 지정해야 합니다.

  • --includeLogger=value[,value]*

    지정된 로거 이름의 레코드를 포함합니다. 값에는 *가 와일드카드로 포함될 수 있습니다.

  • --excludeLogger=value[,value]*

    지정된 로거 이름의 레코드를 제외합니다. 값에는 *가 와일드카드로 포함될 수 있습니다.

  • --includeMessage=value

    메시지 이름을 기반으로 필터링합니다. 값에는 *가 와일드카드로 포함될 수 있습니다.

  • --includeThread=value

    지정된 스레드 ID의 레코드를 포함합니다. 값은 16진(예: --includeThread=2a)이어야 합니다.

  • --includeExtension=name=value[,name=value]*

    지정된 확장 이름 및 값의 레코드를 포함합니다. 값에는 * 또는 ?가 와일드카드로서 포함될 수 있습니다. 쉼표를 값에 포함하려면 "\,"를 사용해야 합니다.

  • --includeInstance=value

    지정된 서버 인스턴스의 레코드를 포함합니다. 값은 "latest" 또는 올바른 인스턴스 ID여야 합니다. 올바른 인스턴스 ID의 목록을 보려면 listInstances 조치를 사용하여 이 명령을 실행하십시오.

listInstances
저장소의 서버 인스턴스 ID를 나열합니다. 서버 인스턴스는 서버가 시작된 시간부터 중지될 때까지 기록된 모든 로그/추적 레코드의 콜렉션입니다. 서버 인스턴스 ID는 binaryLog 보기 조치의 -includeInstance 옵션과 함께 사용될 수 있습니다.
[17.0.0.1 and later]
명령 구문은 다음과 같습니다.
binaryLog listInstances {serverName | repositoryPath} [options]
serverName

읽어 올 저장소가 있는 Liberty 서버의 이름을 지정합니다.

repositoryPath

읽어 올 저장소의 경로를 지정합니다. 이 경로는 일반적으로 로그 데이터 및 추적 데이터 디렉토리가 포함된 디렉토리입니다.

참고: serverName의 값과 repositoryPath의 값을 명령행에 지정합니다. 그렇지 않으면, 태스크가 기본 서버 인스턴스, defaultServer(존재하는 경우)에 대해 실행됩니다.
[17.0.0.1 and later]출력 옵션:
  • --isoDateFormat

    ISO-8601 날짜 및 시간 형식이 출력에 사용됨을 지정합니다.

binaryLog 필터링 최적화에 유의하십시오. binaryLog 도구는 다음 필터 옵션과 함께 사용될 경우 로그 및 추적 데이터를 가장 효율적으로 필터링할 수 있습니다.
  • --minDate
  • --maxDate
  • --includeThread
  • --minLevel
  • --maxLevel
사용법 예제

binaryLog 명령의 다음 예제를 참조하십시오.

  • 2013년 7월 19일과 2013년 8월 2일 사이의 defaultServer 저장소의 모든 이벤트를 표시합니다.
    binaryLog view --minDate=07/19/13
    --maxDate=08/02/13
  • 서버 myServer에서 지정된 레벨이 WARNING 이상인 새 이벤트를 표시합니다. 서버가 이벤트를 로그 저장소에 기록하는 대로 고급 형식을 사용하여 표시합니다.
    binaryLog view myServer --monitor --minLevel=WARNING
    --format=advanced
  • /apps/server1/logs의 저장소에서 로그 메시지를 기록합니다. 특정 저장소의 오류 스트림에 기록된 해당 로그 메시지만 포함합니다.
    binaryLog
    view /apps/server1/logs --includeLogger=SystemErr
  • 2012년 9월 14일 오후 4시 28분(동부 일광 절약 시간 기준) 이전에 발생한 defaultServer 저장소의 이벤트를 표시합니다.
    binaryLog view
    --maxDate="09/14/12 16:28:00:000 EDT"
  • defaultServer 저장소에서 값이 'Default Executor-thread-4'인 '스레드' 확장을 포함하는 이벤트를 기록합니다.
    binaryLog view --includeExtension=thread="Default Executor-thread-4" --format=advanced 
  • defaultServer 저장소에 있는 서버 인스턴스의 목록을 표시합니다.
    binaryLog listInstances 
    
    Using D:\wlp\usr\servers\defaultServer\logs as repository directory.
    
    Instance ID 					      Start Date
    1358809441761                1/21/13 18:04:01:761 EST
    1358864476191                1/22/13 9:21:16:191 EST
    1358869523192                1/22/13 10:45:23:192 EST
    1358871281166                1/22/13 11:14:41:166 EST
    1358879829000                1/22/13 13:37:09:000 EST
    1358892222067                1/22/13 17:03:42:067 EST
  • 이전 예제의 인스턴스 ID 중 하나를 사용하여 defaultServer의 이벤트를 봅니다.
    binaryLog view --includeInstance=1358871281166
  • 최신 서버 인스턴스의 지정된 레벨이 WARNING 이상인 defaultServer의 이벤트를 d:\toSupport 디렉토리의 새 저장소로 복사합니다.
    binaryLog copy defaultServer d:\toSupport --minLevel=warning --includeInstance=latest
  • [17.0.0.1 and later]다음 명령을 실행하여 defaultServer 저장소에 대해 ISO-8601 형식의 시간 및 날짜를 봅니다.
    binaryLog view --isoDateFormat
    출력은 다음과 같습니다.
    [2017-01-16T23:36:43.891-0500] 00000150 servlet I com.ibm.ws.webcontainer.servlet.ServletWrapper doDestroy SRVE0253I:
      [hello-world] [/hello-world] [/index.jsp]: Destroy successful.
    [2017-01-16T23:36:43.900-0500] 00000150 AppMessageHel A   CWWKZ0009I: The application hello-world has stopped successfully.
  • [17.0.0.1 and later]다음 명령을 입력하여 ISO-8601 형식으로 저장소의 서버 인스턴스의 ID를 나열합니다.
    listInstances --isoDateFormat
    출력은 다음과 같습니다.
    Instance ID 					      Start Date
    1484625121871               2017-01-16T22:52:01.871-0500
    1484626095175               2017-01-16T23:08:15.175-0500

주제의 유형을 표시하는 아이콘 참조 주제

파일 이름: rwlp_logviewer.html