GitHub - cloud-barista/cb-log: cb-log is the logger library for the Cloud-Barista Multi-Cloud Framework.

cb-log

cb-log is a logger library for the Cloud-Barista Multi-Cloud Framework.

[NOTE]
cb-log is currently under development.
So, we do not recommend using the current release in production.
Please note that the functionalities of cb-log are not stable and secure yet.
If you have any difficulties in using cb-log, please let us know.
(Open an issue or Join the cloud-barista Slack)

[목 차]

실행 환경
설치 방법
설정 방법
활용 예시

[실행 환경]

배포환경: Ubuntu 18.04, Docker 19.03, Go 1.15
개발환경: Ubuntu 20.04, Ubuntu 18.04, Debian 10.6, macOS Catalina 10.15, Android 8.1
- latest Docker, latest Go

[설치 방법]

Go 설치

$ sudo apt update
$ sudo apt install -y make gcc
$ sudo snap install go --classic

cb-log 설치 방법
- 모듈 다운로드 방법(Go Module mode, default)
  - cb-log 응용 개발
    - 응용 예시: $ wget https://raw.githubusercontent.com/cloud-barista/cb-log/master/test/test.go
  - 모듈 초기화: $ go mod init test.go
  - 모듈 다운로드: $ go mod tidy
  - 다운로드 위치 예시: /home/ubuntu/go/pkg/mod/github.com/cloud-barista/cb-log@v0.3.1
- 소스 다운로드 방법(Old GOPATH mode):
  - 소스 다운로드: $ go get -u -v github.com/cloud-barista/cb-log
  - 다운로드 위치 예시: /home/ubuntu/go/src/github.com/cloud-barista/cb-log

[설정 방법]

설정 정보

Configurations	Descriptions	Default
loopcheck	설정값 변경시 자동 반영 여부 설정. 설정값: true, false	false
loglevel	로그 레벨 설정. 설정값: trace, debug, info, warn, error, fatal, panic	info
logfile	로그 파일 출력 여부 설정. 설정값: true, false	true
logfileinfo:	----- 이하 logfile true 일때 유효 -----
filename	로그를 저장할 파일 path 및 이름. 설정값: {path}logfilename	./log/cblogs.log
maxsize	개별 로그 파일 크기. 설정값: integer #megabytes	10
maxbackups	로그 파일 개수. 설정값: integer #number	50
maxage	로그 파일 유지 기간. 설정값: integer #days	31

설정 파일 예시

$ wget -r -nH --cut-dirs=3 https://raw.githubusercontent.com/cloud-barista/cb-log/master/conf/log_conf.yaml

$ vi ./conf/log_conf.yaml

#### Config for CB-Log Lib. ####

cblog:
  ## true | false
  loopcheck: false # This temp method for development is busy wait. cf) cblogger.go:levelSetupLoop().

  ## trace | debug | info | warn/warning | error | fatal | panic
  loglevel: error # If loopcheck is true, You can set this online.

  ## true | false
  logfile: true

## Config for File Output ##
logfileinfo:
  filename: ./log/cblogs.log
  maxsize: 10 # megabytes
  maxbackups: 50
  maxage: 31 # days

설정 적용 방법
- 서버 재가동: loopcheck=false 설정시
- 자동 반영: loopcheck=true 설정시
설정파일 위치 지정 방법
- 환경변수 사용 방법:
  - 환경변수 CBLOG_ROOT 설정: (ex) export CBLOG_ROOT=$HOME/go/src/github.com/cloud-barista/cb-log
  - 설정파일 위치: $CBLOG_ROOT/conf/log_conf.yaml
- 설정파일 지정 방법:
  - 설정파일 생성: (ex) /etc/my_conf.yaml
  - 코드 내 설정파일 위치 설정: GetLoggerWithConfigPath() 이용
```
import (
  "github.com/cloud-barista/cb-log"
  "github.com/sirupsen/logrus"
)

var cblogger *logrus.Logger

func init() {
  // cblog is a global variable.
  cblogger = cblog.GetLoggerWithConfigPath("MY_PROJ", "/etc/my_conf.yaml")
}
```

[활용 예시]

기본 사용 예시: GetLogger(), SetLevel(), GetLevel(), WithFields()

대상 소스: https://github.com/cloud-barista/cb-log/blob/master/test/test.go

실행 및 결과:

$ export CBLOG_ROOT=$HOME/go/src/github.com/cloud-barista/cb-log
$ cd $CBLOG_ROOT/test
$ go run test.go   # setup cb-log with $CBLOG_ROOT/conf/log_conf.yaml

####LogLevel: info
[CB-SPIDER].[INFO]: 2021-02-14 11:16:49 test.go:24, main.main() - Log Info message
[CB-SPIDER].[WARNING]: 2021-02-14 11:16:49 test.go:25, main.main() - Log Waring message
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:26, main.main() - Log Error message
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:27, main.main() - Log Error message:internal error message

####LogLevel: warning
[CB-SPIDER].[WARNING]: 2021-02-14 11:16:49 test.go:32, main.main() - Log Waring message
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:33, main.main() - Log Error message
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:34, main.main() - Log Error message:internal error message

####LogLevel: error
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:40, main.main() - Log Error message
[CB-SPIDER].[ERROR]: 2021-02-14 11:16:49 test.go:41, main.main() - Log Error message:internal error message

####LogLevel: debug
[CB-SPIDER].[DEBUG]: 2021-02-14 11:16:49 test.go:46, main.main() - WithField 테스트 	[TestField=test]
[CB-SPIDER].[DEBUG]: 2021-02-14 11:16:49 test.go:48, main.main() - WithFields 테스트 	[Field2=value2,Field3=value3,Field1=value1]
[CB-SPIDER].[DEBUG]: 2021-02-14 11:16:49 test.go:50, main.main() - WithError 테스트 	[error=테스트 오류]

활용 예시: DBMS 응용 로그 예시

설정파일 환경변수 지정 방법

환경변수 설정: export CBLOG_ROOT=$HOME/go/src/github.com/cloud-barista/cb-log
대상 소스: https://github.com/cloud-barista/cb-log/blob/master/test/sample.go

실행 및 결과

$ export CBLOG_ROOT=$HOME/go/src/github.com/cloud-barista/cb-log   
$ cd $CBLOG_ROOT/test  
$ go run sample.go   # setup cb-log with $CBLOG_ROOT/conf/log_conf.yaml

[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:25, main.main() - start.........
[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:45, main.createUser1() - start creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:59, main.createUser1() - finish creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:64, main.createUser2() - start creating user.
[CB-SPIDER].[ERROR]: 2019-08-16 23:22:51 sample.go:69, main.createUser2() - DBMS Session is closed!!
[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:78, main.createUser2() - finish creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:51 sample.go:37, main.main() - end.........

[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:25, main.main() - start.........
[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:45, main.createUser1() - start creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:59, main.createUser1() - finish creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:64, main.createUser2() - start creating user.
[CB-SPIDER].[ERROR]: 2019-08-16 23:22:53 sample.go:69, main.createUser2() - DBMS Session is closed!!
[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:78, main.createUser2() - finish creating user.
[CB-SPIDER].[INFO]: 2019-08-16 23:22:53 sample.go:37, main.main() - end.........

Log Level 변경 및 실행 결과: debug => error

$ cd $CBLOG_ROOT/test
$ vi $CBLOG_ROOT/conf/log_conf.yaml  ## debug => error
$ go run sample.go   # setup cb-log with a user defined configuration file in code
[CB-SPIDER].[ERROR]: 2019-08-16 23:22:57 sample.go:69, main.createUser2() - DBMS Session is closed!!
[CB-SPIDER].[ERROR]: 2019-08-16 23:22:59 sample.go:69, main.createUser2() - DBMS Session is closed!!

설정파일 지정 방법: GetLoggerWithConfigPath()

대상 소스: https://github.com/cloud-barista/cb-log/blob/master/test/sample-with-config-path.go

실행 및 결과

$ cd ./test
$ go run sample-with-config-path.go   # setup cb-log with a user defined configuration file in code

[CB-SPIDER ..\conf\log_conf.yaml]
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:27, main.main() - start.........
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:48, main.createUser3() - start creating user.
[CB-SPIDER].[DEBUG]: 2020-12-23 17:46:09 sample-with-config-path.go:58, main.createUser3() - msg for debugging msg!!
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:63, main.createUser3() - finish creating user.
[CB-SPIDER].[DEBUG]: 2020-12-23 17:46:09 sample-with-config-path.go:30, main.main() - msg for debugging msg!!
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:68, main.createUser4() - start creating user.
[CB-SPIDER].[ERROR]: 2020-12-23 17:46:09 sample-with-config-path.go:73, main.createUser4() - DBMS Session is closed!!
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:82, main.createUser4() - finish creating user.
[CB-SPIDER].[INFO]: 2020-12-23 17:46:09 sample-with-config-path.go:40, main.main() - end.........

Log Level 변경 및 실행 결과: debug => error

$ cd ./test
$ vi ../conf/log_conf.yaml  ## debug => error
$ go run sample-with-config-path.go   # setup cb-log with a user defined configuration file in code
[CB-SPIDER].[ERROR]: 2020-12-23 18:08:12 sample-with-config-path.go:73, main.createUser4() - DBMS Session is closed!!
[CB-SPIDER].[ERROR]: 2020-12-23 18:08:14 sample-with-config-path.go:73, main.createUser4() - DBMS Session is closed!!

Name	Name	Last commit message	Last commit date
Latest commit powerkimhub Update go version to 1.23.0 Feb 16, 2025 eea2072 · Feb 16, 2025 History 101 Commits
.github	.github	Add Issue-template and prow workflow	Mar 17, 2021
conf	conf	Add an option to disable console output	Feb 16, 2025
formatter	formatter	09-29: 소스 코드 정리	Sep 29, 2020
test	test	Update comments and texts in English	Jan 22, 2021
.gitignore	.gitignore	Add gitignore for cb-log	Dec 24, 2020
CHANGELOG.md	CHANGELOG.md	Update CHANGELOG.md	Nov 21, 2022
CODE_OF_CONDUCT.md	CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md	Feb 14, 2021
LICENSE	LICENSE	Create LICENSE	Feb 8, 2021
README.md	README.md	Update README.md	Dec 7, 2021
cblogger.go	cblogger.go	Add an option to disable console output	Feb 16, 2025
config.go	config.go	Add an option to disable console output	Feb 16, 2025
go.mod	go.mod	Update go version to 1.23.0	Feb 16, 2025
go.sum	go.sum	Bump Golang to 1.19 & Update go.mod	Aug 31, 2022
setup.env	setup.env	change the default path of CBLOG_ROOT to apply new Go version style	Dec 23, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

cb-log

[목 차]

[실행 환경]

[설치 방법]

[설정 방법]

[활용 예시]

About

Releases 18

Packages

Contributors 8

Languages

License

cloud-barista/cb-log

Folders and files

Latest commit

History

Repository files navigation

cb-log

[목 차]

[실행 환경]

[설치 방법]

[설정 방법]

[활용 예시]

About

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases 18

Packages 0

Contributors 8

Languages

Packages