개요

bsr은 기존 로그 구조를 대폭 개선 하여 로그 수준 지정, 실시간 로깅, 와치 기능, CLI 로그 기능, 롤링되는 로그에 대한 파일 저장 기능 이 추가되어 관리자 및 개발자를 위한 편리한 디버깅 시스템을 제공합니다.

• bsr로그는 드라이버에서 기록하는 로그이며 CLI로그는 bsradm, bsrsetup, bsrmeta 에서 기록하는 로그 입니다.

...

로그 시스템을 통해 bsr 전반의 동작과정을 모니터링하고 문제가 발생했을 때 디버깅 할 수 있는 환경을 제공합니다. bsr 의 로그는 지정한 최대크기 만큼 실시간 파일로 기록되며 최대 파일크기 이상 초과 시 스스로 백업합니다. 로그는 bsr 커널 모듈에서 기록하는 커널로그와 bsr 유틸리티에서 기록하는 응용로그로 분리되어 있어서 각각 개별적으로 저장됩니다.

로그 파일이 저장되는 경로는 다음과 같으며 windows는 notepad, linux는 vi로 직접 파일을 읽어서 볼 수 있습니다.

• windows는 “%BSR_PATH%\..\log\” 경로에 저장됩니다.

• linux는 “/var/log/bsr/” 경로에 저장됩니다.

유형

로그는 커널 로그와 응용 로그가 있으며 커널과 응용 계층 각각의 영역에서 발생한 로그를 저장합니다. 커널로그는 bsr 커널 모듈의 동작을 추적하며, 응용로그는 bsr 유틸리티의 동작과정을 추적하기 위한 용도로 사용합니다.

커널 로그는 시스템로그와 디버그로그 그리고 feature 로그로 분류되며 다음의 용도에 따라 사용합니다.

• 디버그 로그는 bsr의 일반적인 동작과 상태를 추적하기 위한 로그입니다.

• 시스템 로그는 bsr 복제 운영에 문제가 발생하거나 시스템에 영향을 줄 만한 중요한 정보를 기록하기 위한 로그 입니다.

• feature 로그는 상세 디버그 로그로서 개발자를 위한 용도로 사용합니다.

조회

설정 정보

bsrcon /get_log_info 명령을 통해 확인 할 실행하여 로그 유형에 따른 수준, 백업 파일 단위 정보를 확인할 수 있습니다.

# bsrcon /get_log_info
Current log level.
    system-lv : err(3)
    debug-lv : info(6)

The maximum  feature-lv : 0size of cli log file is 5M.
Number of log files that can be saved.
Maximum
    bsradm : 2
    bsrsetup : 2
    bsrmeta : 2

The maximum size of onedriver log file is 50M 48M or 100000 log count.
Number of log files that can be saved.
    bsrdriver : 15
Output category during debug log.
    bsradm : 2
    bsrsetup : 2
    bsrmeta : 2

• 로그 레벨

  • bsr로그에서만 사용하며 system, debug, feature 3개의 로그 레벨을 설정 할 수 있으며 로그 발생 시 설정한 로그레벨 보다 낮거나 같을때 기록합니다.

    • system : bsr로그 발생 시 시스템 이벤트 로그에 기록하는 레벨 이며 기본 값은 err(3) 입니다.

      • 로그 레벨은 emerg(0) alert(1) criti(2) err(3) warning(4) notice(5) info(6) debug(7) 입니다.

    • debug : bsr로그 발생 시 파일 및 메모리에 기록하는 레벨 이며 기본 값은 info(6) 입니다.

      • 로그 레벨은 emerg(0) alert(1) criti(2) err(3) warning(4) notice(5) info(6) debug(7) 입니다.

    • feature : 부가적인 로그 레벨로 debug 레벨에 상관없이 파일 및 메모리에 기록하며 성능 또는 정합성 테스트 시 사용 되며 기본 값은 none(0) 입니다.

      • 로그 레벨은 none(0) oos(1) latency(2) verify(4) 입니다.

• 최대 저장 로그 파일 수

  • 로그는 실시간으로 파일에 저장되며 로그 파일이 50M 보다 크면 해당 로그 파일 이름을 변경 및 저장 후 다시 로그를 저장합니다.

    • bsr로그(bsrdriver) 기본 값은 15, CLI로그(bsradm, bsrsetup, bsrmeta) 기본 값은 2 입니다.

    • bsr로그에 경우 파일에 크기가 50M가 되지 않아도 10만개 이상 로그가 발생하면 로그 파일 이름 변경 및 저장을 하게됩니다.

설정

bsrcon 명령을 통해 설정 할 수 있습니다.

• 로그 레벨

  • bsr로그에만 해당되며 bsrcon 명령을 통해 로그 레벨을 설정 할 수 있습니다.

    • system 로그 레벨 설정 : bsrcon /minlog_lv sys 3

    • debug 로그 레벨 설정 : bsrcon /minlog_lv dbg 6

    • feature 로그 설정 : bsrcon /minlog_lv feature 2

• 최대 저장 로그 파일 수

  • bsrcon 명령을 통해 최대 저장 로그 파일 수를 설정 할 수 있습니다.

    • bsr로그 최대 저장 로그 파일 수 설정 : bsrcon /maxlogfile_cnt 5

    • bsradm 최대 저장 로그 파일 수 설정 : bsrcon /climaxlogfile_cnt adm 2

    • bsrsetup 최대 저장 로그 파일 수 설정 : bsrcon /climaxlogfile_cnt setup 2

    • bsrmeta 최대 저장 로그 파일 수 설정 : bsrcon /climaxlogfile_cnt meta 2

형식

• bsr로그

  • bsr 설치 경로 하위에 있는 log 폴더에 bsrlog.txt 파일에 저장 됩니다.

  • 로그 파일 크기가 제한 된 크기보다 크면 “bsrlog.txt_날짜시간” 으로 파일 이름을 변경 및 저장하고 다음 로그 발생 시 bsrlog.txt을 생성하고 로그를 저장 합니다.

  • 로그 형식은 “순번, 날짜, 시간, 함수, 레벨, 로그” 입니다.

00000053 07/15/2020 13:43:11.327 [get_max_agreeable_size] bsr_info<6>bsr r0/0 minor 2 pnode-id:0, pdsk(DUnknown), prpl(Off), pdvflag(0x0): node_id: 0 idx: 1 bm-uuid: 0x0 flags: 0x20010 max_size: 0 (DUnknown)

CLI로그

...

bsr 설치 경로 하위에 있는 log 폴더에 CLI에 따라 각각 bsradm.log, bsrsetup.log, bsrmeta.log 파일에 저장 됩니다.

...

로그 파일 크기가 제한 된 크기보다 크면 “bsradm.log_날짜시간” 으로 파일 이름을 변경 및 저장하고 다음 로그 발생 시 bsrlog.txt을 생성하고 로그를 저장 합니다.

• bsrsetup, bsrmeta 도 동일하며 만약 CLI로그 저장 시 실행하는 CLI를 인지하지 못하면 bsrapp.log 파일에 로그가 저장 됩니다.

...

category : VOLUME IO IO_ERROR BITMAP LRU REQUEST PEER_REQUEST RESYNC_OV REPLICATION CONNECTION UUID TWOPC THREAD SEND_BUFFER STATE SOCKET DRIVER NETLINK GENL PROTOCOL MEMORY LOG ETC

Logging status command to the CLI log : disable (0)

조회

시스템 로그를 제외한 모든 로그는 로그 저장 경로에서 로그 파일을 직접 읽어서 조회할 수 있습니다.

bsrwatch

bsr 의 동작과 상태를 실시간 추적하기 위한 용도로 bsrwatch 명령을 제공합니다. bsrwatch 명령은 커널로그가 기록되는 상황을 표준 출력으로 실시간 확인할 수 있습니다.

설정

bsrcon 명령을 통해 로그 수준과 로그 파일 백업 단위를 지정할 수 있습니다.

• 로그 수준 및 로그 파일 저장 설정

  • 로그 수준 기본 값

    • system 로그는 err(3) 입니다.

    • debug 로그는 info(6) 입니다.

    • feature 로그는 none(0) 입니다.

  • 로그 파일 백업 단위 기본 값

    • 커널로그 파일은 15 입니다.

    • 응용로그 파일은 2 입니다.

bsrcon
usage: bsrcon cmds options
...
  /maxlogfile_cnt [LogFileMaxCount : 0 ~ 1000]
  /climaxlogfile_cnt [adm, setup, meta] [LogFileMaxCount : 0 ~ 255]
  /minlog_lv [sys, dbg] [Level : 0~7] level info, emerg(0) alert(1) criti(2) err(3) warning(4) notice(5) info(6) debug(7)
  /minlog_lv feature [flag : 0,1,2,4] level info, none(0) oos(1) latency(2) verify(4)
...

형식

로그의 형식은 다음과 같습니다.

• 커널로그

  • “순서” “날짜” “시간” [함수] [로그 분류:로그 인덱스] “로그 레벨” “로그 내용”

    Code Block
    00000219 09/15/2020 14:42:04.3936220 [bsr_bm_resize] [BITMAP:23] bsr_info<6> bsr r2/0 minor 4, ds(Attaching), dvflag(0x0): bitmap resize called with capacity(31451136)

• 응용로그

  • “날짜” “시간” “로그 레벨” [pid][함수][라인][실행 명령] “로그 내용”

    Code Block
    2020/07/15 16:

...

• • 18:

...

• • 39 bsr_erro [pid:

...

• • 2060][func

...

• • :err][line:1056][cmd:NULL] bsradm: Unknown command 'resoure' 2020/07/15 16:18:44 bsr_erro [pid:1160][func:err][line:

...

• • 1056][cmd:status]

...

• • '10' not defined in your config (for this host).