개요

로그 수준 지정, 실시간 로깅, 실시간 로그 출력, CLI 로그, 로그 롤링 파일 저장 기능으로 관리자 및 개발자를 위한 편리한 디버깅 시스템을 제공합니다.

구성

로그 파일

...

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

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

• windows는 “%BSR_PATH%\..\log\”

  저장 됩니다

  경로에 저장됩니다.

• linux

  linux는 “/var/log/bsr/”

  저장 됩니다.

• bsrwatch

  • BSR로그를 실시간으로 출력 합니다.

• bsrcon

  • 로그 레벨 및 파일 저장에 대한 설정 또는 조회를 수행 합니다.

조회

• 로그 레벨, 로그 파일 저장 조회 경로에 저장됩니다.

유형

로그는 커널 로그와 응용 로그가 있으며 커널과 응용 계층 각각의 영역에서 발생한 로그를 저장합니다. 커널로그는 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 size of 

...

cli log file is 5M.
Number of log files that can be saved.

...

    bsradm : 2
    bsrsetup : 2
    bsrmeta : 2

The maximum size of 

...

driver log file is

...

 48M or 100000 log count.
Number of log files that can be saved.
    bsrdriver : 15
Output category during debug log.
    

...

category : 

...

• 로그 조회

  • BSR로그

    • system 로그

      • system 로그는 windows는 시스템 이벤트 로그 linux는 dmesg 에서 확인이 가능합니다.

    • debug, feature 로그

      • bsrwatch 명령을 통해 실시간으로 확인이 가능 합니다.

      • 로그 파일 저장 경로에서 확인이 가능 합니다.

  • CLI로그

    • 로그 파일 저장 경로에서 확인이 가능 합니다.

설정

로그 레벨, 로그 파일 저장 설정

로그 레벨 기본 값

...

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) 입니다.

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

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

    • CLI로그 파일은 2 입니다.

    • 응용로그 파일은 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)
...

ex)
  bsr로그 레벨 info(6) 설정 => bsrcon
/minlog_lv sys 6
  bsr로그 로그 파일 저장 5개 설정 => bsrcon /maxlogfile_cnt 5
  CLI 중 bsradm 로그 파일 저장 5개 설정 => bsrcon /climaxlogfile_cnt adm 5

형식

BSR로그

시퀀스 번호, 날짜, 시간, 함수, 로그 레벨, 로그

...

형식

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

• 커널로그

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

    Code Block

    00000219 09/15/2020 1314:4342:1104.3433936220 [statebsr_changebm_lockresize] bsr_warn<4>[0xFFFFE0013C788880] worker should not initiate state changes with CS_SERIALIZE current:FFFFF801C0154B90 resource->worker.task:FFFFE0013E78BC20 00000069 07/15/2020 13:43:11.343 [print_state_change[BITMAP:23] bsr_info<6>bsrinfo<6> r0 pnode-id:0, cs(StandAlone), prole(Unknownbsr r2/0 minor 4, ds(Attaching), cflagdvflag(0x0), scf(0x2a): bsr_adm_connect, conn( StandAlone -> Unconnected ) 00000070 07/15/2020 13:43:11.343 [NetlinkWorkThread] bsr_info<6>[0xFFFFE0013C788880] bsr netlink cmd(BSR_ADM_CONNECT:10) done (cmd_pending:0) <-

  CLI로그

  • 날짜, 시간, 로그 레벨, pid, 함수, 라인, 실행 명령, 로그

    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).

...