logrus - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #golang #android #deep-learning #java #awesome #cli #kubernetes #awesome-list #openai #ios

logrus

(★ 25,750)

Go 언어를 위한 구조화된 플러그인 방식의 로깅 라이브러리입니다.

파일 탐색기

최종 버전 다운로드 (.zip)

🚀 설치 가이드

1. 코드 내려받기

git clone https://github.com/sirupsen/logrus

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd logrus

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Logrus ![:walrus:](http://i.imgur.com/hTeVwmJ.png ":walrus:") [![Build Status](https://github.com/sirupsen/logrus/workflows/CI/badge.svg)](https://github.com/sirupsen/logrus/actions?query=workflow%3ACI) [![Go Reference](https://pkg.go.dev/badge/github.com/sirupsen/logrus.svg)](https://pkg.go.dev/github.com/sirupsen/logrus)
Logrus는 Go (golang)용 구조화된 로거로, 표준 라이브러리 로거와 완전히 API 호환됩니다.
\*\*Logrus는 현재 유지보수 모드입니다.\*\* 이 프로젝트는 보안, 버그 수정 및 성능 개선에 초점을 맞추고 있습니다. 다른 로깅 생태계(예: Go의 [log/slog](https://pkg.go.dev/log/slog))와의 상호 운용성을 제공하는 데 필요한 변경 사항을 제외하고는 새로운 기능은 계획되어 있지 않습니다.
저는 Logrus의 가장 큰 공헌이 오늘날 Golang에서 구조화된 로깅이 널리 사용되는 데 일조한 것이라고 믿습니다. 훌륭한 Go 커뮤니티에서 독립적으로 그러한 대안들을 만들어왔기 때문에, Logrus V2로 크게 깨지는(breaking) 반복 작업을 수행할 이유는 없어 보입니다. 훌륭한 대안들이 많이 등장했습니다. 오늘날 Go의 구조화된 로깅에 대해 알게 된 지식을 바탕으로 다시 설계되었다면 Logrus도 그들처럼 보였을 것입니다. 예를 들어 [Zerolog][zerolog], [Zap][zap], [Apex][apex]를 확인해 보세요.
[zerolog]: https://github.com/rs/zerolog
[zap]: https://github.com/uber-go/zap
[apex]: https://github.com/apex/log
개발 환경에서 보기 좋게 색상이 지정됩니다 (TTY가 연결된 경우, 그렇지 않으면 일반 텍스트로 출력됨):
![Colored](http://i.imgur.com/PY7qMwd.png)
logstash나 Splunk에서 쉽게 파싱할 수 있도록 `logrus.SetFormatter(&logrus.JSONFormatter{})`를 사용하는 경우:
```json lines
{"animal":"walrus","level":"info","msg":"A group of walrus emerges from the ocean","size":10,"time":"2014-03-10 19:57:38.562264131 -0400 EDT"}
{"level":"warning","msg":"The group's number increased tremendously!","number":122,"omg":true,"time":"2014-03-10 19:57:38.562471297 -0400 EDT"}
{"animal":"walrus","level":"info","msg":"A giant walrus appears!","size":10,"time":"2014-03-10 19:57:38.562500591 -0400 EDT"}
{"animal":"walrus","level":"info","msg":"Tremendously sized cow enters the ocean.","size":9,"time":"2014-03-10 19:57:38.562527896 -0400 EDT"}
{"level":"fatal","msg":"The ice breaks!","number":100,"omg":true,"time":"2014-03-10 19:57:38.562543128 -0400 EDT"}
```
TTY가 연결되지 않은 상태에서 기본 `logrus.SetFormatter(&logrus.TextFormatter{})`를 사용할 때, 출력은 [logfmt](https://pkg.go.dev/github.com/kr/logfmt) 형식과 호환됩니다:
```bash
time="2015-03-26T01:27:38-04:00" level=debug msg="Started observing beach" animal=walrus number=8
time="2015-03-26T01:27:38-04:00" level=info msg="A group of walrus emerges from the ocean" animal=walrus size=10
time="2015-03-26T01:27:38-04:00" level=warning msg="The group's number increased tremendously!" number=122 omg=true
time="2015-03-26T01:27:38-04:00" level=debug msg="Temperature changes" temperature=-4
time="2015-03-26T01:27:38-04:00" level=panic msg="It's over 9000!" animal=orca size=9009
time="2015-03-26T01:27:38-04:00" level=fatal msg="The ice breaks!" animal=orca err="It's over 9000!" number=100 omg=true size=9009
```
TTY가 연결되어 있더라도 이 동작을 보장하려면 포맷터를 다음과 같이 설정하세요:
```go
logrus.SetFormatter(&logrus.TextFormatter{
DisableColors: true,
FullTimestamp: true,
})
```
#### 로깅 메서드 이름 (Logging Method Name)
호출하는 메서드를 필드로 추가하려면 로거에 다음과 같이 지시하세요:
```go
logrus.SetReportCaller(true)
```
이렇게 하면 다음과 같이 호출자가 'method'로 추가됩니다:
```json
{"animal":"penguin","level":"fatal","method":"github.com/sirupsen/arcticcreatures.migrate","msg":"a penguin swims by","time":"2014-03-10 19:57:38.562543129 -0400 EDT"}
```
```bash
time="2015-03-26T01:27:38-04:00" level=fatal method=github.com/sirupsen/arcticcreatures.migrate msg="a penguin swims by" animal=penguin
```
이 기능은 측정 가능한 오버헤드를 추가하므로 주의하십시오. 비용은 Go 버전에 따라 다르지만, 1.6 및 1.7을 사용한 최근 테스트에서는 20%에서 40% 사이입니다. 벤치마크를 통해 여러분의 환경에서 이를 확인할 수 있습니다:
```bash
go test -bench=ReportCal
```

ler
```
#### 대소문자 구분
조직의 이름이 [소문자로 변경되었습니다][1]. 대소문자 구분으로 인해 임포트 충돌이 발생하는 경우, 소문자 임포트를 사용하세요:
`github.com/sirupsen/logrus`.
[1]: https://github.com/sirupsen/logrus/issues/570#issuecomment-313933276
#### 예제
Logrus를 사용하는 가장 간단한 방법은 패키지 수준에서 내보내진 로거를 사용하는 것입니다:
```go
package main
import "github.com/sirupsen/logrus"
func main() {
logrus.WithFields(logrus.Fields{
"animal": "walrus",
}).Info("A walrus appears")
}
```
표준 라이브러리(stdlib) 로거와 완전히 API 호환되므로, 어디서든 `log` 임포트를 `log "github.com/sirupsen/logrus"`로 교체하여 Logrus의 유연함을 누릴 수 있습니다. 원하는 대로 커스텀할 수도 있습니다:
```go
package main
import (
"os"
log "github.com/sirupsen/logrus"
)
func init() {
// 기본 ASCII 포맷터 대신 JSON으로 로그를 출력합니다.
log.SetFormatter(&log.JSONFormatter{})
// 기본 stderr 대신 stdout으로 출력합니다.
// 어떤 io.Writer든 가능하며, 아래 File 예제를 참고하세요.
log.SetOutput(os.Stdout)
// 경고(Warning) 심각도 이상만 로깅합니다.
log.SetLevel(log.WarnLevel)
}
func main() {
log.WithFields(log.Fields{
"animal": "walrus",
"size": 10,
}).Info("A group of walrus emerges from the ocean")
log.WithFields(log.Fields{
"omg": true,
"number": 122,
}).Warn("The group's number increased tremendously!")
log.WithFields(log.Fields{
"omg": true,
"number": 100,
}).Fatal("The ice breaks!")
// 일반적인 패턴은 WithFields()가 반환하는 logrus.Entry를 재사용하여
// 로깅문 간에 필드를 재사용하는 것입니다.
contextLogger := log.WithFields(log.Fields{
"common": "this is a common field",
"other": "I also should be logged always",
})
contextLogger.Info("I'll be logged with common and other field")
contextLogger.Info("Me too")
}
```
동일한 애플리케이션 내에서 여러 위치로 로깅하는 등의 더 고급 사용법을 위해 `logrus` 로거의 인스턴스를 생성할 수도 있습니다:
```go
package main
import (
"os"
"github.com/sirupsen/logrus"
)
// 로거의 새 인스턴스를 생성합니다. 인스턴스는 몇 개든 가질 수 있습니다.
var logger = logrus.New()
func main() {
// 속성을 설정하는 API는 패키지 수준에서 내보내진 로거와 약간 다릅니다. Godoc을 참고하세요.
logger.Out = os.Stdout
// 파일과 같은 임의의 `io.Writer`로 설정할 수도 있습니다.
// file, err := os.OpenFile("logrus.log", os.O\_CREATE|os.O\_WRONLY|os.O\_APPEND, 0666)
// if err == nil {
// logger.Out = file
// } else {
// logger.Info("Failed to log to file, using default stderr")
// }
logger.WithFields(logrus.Fields{
"animal": "walrus",
"size": 10,
}).Info("A group of walrus emerges from the ocean")
}
```
#### 필드 (Fields)
Logrus는 길고 구문 분석하기 어려운 에러 메시지 대신 로깅 필드를 사용하여 신중하고 구조화된 로깅을 권장합니다. 예를 들어, `logrus.Fatalf("Failed to send event %s to topic %s with key %d")` 대신 훨씬 검색하기 쉬운 다음 방식을 사용해야 합니다:
```go
logrus.WithFields(logrus.Fields{
"event": event,
"topic": topic,
"key": key,
}).Fatal("Failed to send event")
```
이 API를 사용하면 훨씬 더 유용한 로그 메시지를 생성하는 방식으로 로깅에 대해 고민하게 된다는 것을 알게 되었습니다. 이미 작성되어 있던 로그문에 필드 하나만 추가했어도 몇 시간은 아낄 수 있었던 상황을 수없이 겪었습니다. `WithFields` 호출은 선택 사항입니다.
일반적으로 Logrus에서는 `printf` 계열 함수를 사용하는 것이 필드를 추가해야 한다는 신호로 여겨져야 하지만, 여전히 Logrus와 함께 `printf` 계열 함수를 사용할 수 있습니다.
#### 기본 필드 (Default Fields)
애플리케이션 전체 또는 일부에서 로깅문에 \_항상\_ 첨부되는 필드가 있으면 유용한 경우가 많습니다. 예를 들어, 요청 컨텍스트에서 항상 `request\_id`와 `user\_ip`를 로깅하고 싶을 수 있습니다. 매 줄마다 `logger.WithFields(logrus.Fields{"request\_id": request\_id, "user\_ip": user\_ip})`를 작성하는 대신, `logrus.Entry`를 생성하여 전달할 수 있습니다:
```go
requestLogger := logger.WithFields(logrus.Fields{"request\_id": request\_id, "user\

_ip": user\_ip})
requestLogger.Info("something happened on that request") // will log request\_id와 user\_ip를 기록합니다
requestLogger.Warn("something not great happened")
```
#### Hooks
로깅 수준에 대한 훅(Hook)을 추가할 수 있습니다. 예를 들어 `Error`, `Fatal`, `Panic` 발생 시 예외 추적 서비스로 에러를 전송하거나, StatsD로 정보를 전송하거나, syslog 등 여러 곳에 동시에 로그를 남길 수 있습니다.
Logrus에는 [기본 제공 훅(built-in hooks)](hooks/)이 포함되어 있습니다. 이러한 훅이나 커스텀 훅을 `init` 함수에 추가하세요:
```go
package main
import (
"log/syslog"
"github.com/sirupsen/logrus"
airbrake "gopkg.in/gemnasium/logrus-airbrake-hook.v2"
logrus\_syslog "github.com/sirupsen/logrus/hooks/syslog"
)
func init() {
// Airbrake 훅을 사용하여 Error 심각도 이상의 에러를 예외 추적기에 보고합니다.
// 커스텀 훅을 생성할 수도 있으며, Hooks 섹션을 참고하세요.
logrus.AddHook(airbrake.NewHook(123, "xyz", "production"))
hook, err := logrus\_syslog.NewSyslogHook("udp", "localhost:514", syslog.LOG\_INFO, "")
if err != nil {
logrus.Error("로컬 syslog 디먼에 연결할 수 없습니다")
} else {
logrus.AddHook(hook)
}
}
```
참고: Syslog 훅은 로컬 syslog 연결도 지원합니다 (예: "/dev/log", "/var/run/syslog", "/var/run/log"). 자세한 내용은 [syslog hook README](hooks/syslog/README.md)를 확인하세요.
현재 알려진 서비스 훅 목록은 다음 위키 [페이지](https://github.com/sirupsen/logrus/wiki/Hooks)에서 확인할 수 있습니다.
#### 레벨 로깅 (Level logging)
Logrus에는 Trace, Debug, Info, Warning, Error, Fatal, Panic의 7가지 로깅 레벨이 있습니다.
```go
logrus.Trace("매우 낮은 수준의 무언가입니다.")
logrus.Debug("유용한 디버깅 정보입니다.")
logrus.Info("주목할 만한 일이 발생했습니다!")
logrus.Warn("이 부분을 살펴보는 것이 좋습니다.")
logrus.Error("문제가 발생했지만 종료하지는 않습니다.")
// 로깅 후 os.Exit(1)을 호출합니다
logrus.Fatal("안녕.")
// 로깅 후 panic()을 호출합니다
logrus.Panic("탈출합니다.")
```
`Logger`에 로깅 레벨을 설정하면, 해당 심각도 이상인 로그 항목만 기록됩니다:
```go
// info 레벨 이상(warn, error, fatal, panic)의 모든 로그를 기록합니다. 기본값입니다.
logrus.SetLevel(logrus.InfoLevel)
```
애플리케이션에 디버그 또는 상세(verbose) 환경이 있는 경우, 해당 환경에서 `logrus.Level = logrus.DebugLevel`을 설정하는 것이 유용할 수 있습니다.
참고: 전역(`logrus.SetLevel(...)`) 로깅과 syslog 로깅에 서로 다른 로그 레벨을 지정하고 싶다면 [syslog hook README](hooks/syslog/README.md#different-log-levels-for-local-and-remote-logging)를 확인하세요.
#### 항목 (Entries)
`WithField`나 `WithFields`로 추가된 필드 외에도, 모든 로깅 이벤트에 자동으로 추가되는 필드가 있습니다:
1. `time`. 항목이 생성된 타임스탬프입니다.
2. `msg`. `AddFields` 호출 이후 `{Info,Warn,Error,Fatal,Panic}`에 전달된 로그 메시지입니다. 예: `Failed to send event.`
3. `level`. 로깅 레벨입니다. 예: `info`.
#### 환경 (Environments)
Logrus는 환경(environment)에 대한 개념이 없습니다.
훅과 포매터가 특정 환경에서만 사용되도록 하려면 직접 처리해야 합니다. 예를 들어, 애플리케이션에 환경을 문자열로 나타내는 전역 변수 `Environment`가 있는 경우 다음과 같이 할 수 있습니다:
```go
import (
"github.com/sirupsen/logrus"
)
func init() {
// 환경 변수나 커맨드라인 플래그에 따라 환경을 설정하는 로직을 여기에 작성합니다
if Environment == "production" {
logrus.SetFormatter(&logrus.JSONFormatter{})
} else {
// TextFormatter가 기본값이므로 실제로 이 작업을 수행할 필요는 없습니다.
logrus.SetFormatter(&logrus.TextFormatter{})
}
}
```
이 설정은 `logrus`의 본래 사용 의도에 부합하지만, 프로덕션 환경에서의 JSON 형식은 Splunk나 Logstash 같은 도구로 로그를 집계하는 경우에만 주로 유용합니다.
#### 포매터 (Formatters)
기본 제공되는 로깅 포매터는 다음과 같습니다:
\* [`logrus.TextFormatter`](https://pkg.go.dev/github.com/sirupsen/logrus#TextFormatter)는 로거 출력이 TTY인 경우 색상을 적용하여 이벤트를 기록하고, 그렇지 않으면 색상 없이 기록합니다.
\* TTY가 아닐 때도 강제로 색상이 있는 출력을 하려면 `ForceColors` 필드를 `true`로 설정하세요. TTY가 있더라도 색상 출력을 강제로 사용하지 않으려면 설정하세요

`DisableColors` 필드를 `true`로 지정합니다.
\* ANSI(가상 터미널)를 지원하는 최신 Windows 터미널에서는 TextFormatter가 자동으로 컬러 출력을 활성화합니다.
\* 사용 중인 환경이 ANSI escape 시퀀스를 지원하지 않는 경우, [github.com/mattn/go-colorable](https://github.com/mattn/go-colorable)을 사용하여 로거 출력을 감싸고 `ForceColors`(또는 `CLICOLOR\_FORCE=1`)를 설정하여 래퍼를 통해 색상을 활성화할 수 있습니다.
\* 색상이 활성화되면 로그 레벨은 기본적으로 4글자로 잘립니다. 잘림 현상을 비활성화하려면 `DisableLevelTruncation` 필드를 `true`로 설정하세요.
\* TTY로 출력할 때, 모든 로그 레벨이 동일한 너비를 가리키는 열을 시각적으로 훑어보는 것이 유용할 때가 많습니다. `PadLevelText` 필드를 `true`로 설정하면 레벨 텍스트에 패딩이 추가되어 이 동작이 활성화됩니다.
\* [`logrus.JSONFormatter`](https://pkg.go.dev/github.com/sirupsen/logrus#JSONFormatter)는 필드를 JSON으로 로깅합니다.
서드파티 로깅 포매터:
\* [`FluentdFormatter`](https://github.com/joonix/log). Kubernetes 및 Google Container Engine에서 파싱할 수 있는 엔트리를 포맷합니다.
\* [`GELF`](https://github.com/fabienm/go-logrus-formatters). Graylog의 [GELF 1.1 사양](http://docs.graylog.org/en/2.4/pages/gelf.html)을 준수하도록 엔트리를 포맷합니다.
\* [`logstash`](https://github.com/bshuster-repo/logrus-logstash-hook). 필드를 [Logstash](http://logstash.net) 이벤트로 로깅합니다.
\* [`prefixed`](https://github.com/x-cray/logrus-prefixed-formatter). 대체 레이아웃과 함께 로그 엔트리 소스를 표시합니다.
\* [`zalgo`](https://github.com/aybabtme/logzalgo). Zalgo의 강력한 기능을 호출합니다.
\* [`nested-logrus-formatter`](https://github.com/antonfisher/nested-logrus-formatter). logrus 필드를 중첩 구조로 변환합니다.
\* [`powerful-logrus-formatter`](https://github.com/zput/zxcTool). 로그 출력 시 파일 이름, 로그의 줄 번호, 최신 함수의 이름을 가져옵니다. 로그를 파일에 저장합니다.
\* [`caption-json-formatter`](https://github.com/nolleh/caption\_json\_formatter). 사람이 읽을 수 있는 캡션이 추가된 logrus 메시지 JSON 포매터입니다.
\* [`easy-logrus-formatter`](https://github.com/WeiZhixiong/easy-logrus-formatter). logrus를 위한 사용자 친화적인 포매터를 제공합니다.
\* [`redactrus`](https://github.com/ibreakthecloud/redactrus). 로그에서 비밀번호, apikey, 이메일 등 민감한 정보를 마스킹합니다.
`Format` 메서드가 필요한 `Formatter` 인터페이스를 구현하여 자신만의 포매터를 정의할 수 있습니다. `Format`은 `\*Entry`를 인자로 받습니다. `entry.Data`는 모든 필드와 기본 필드가 포함된 `Fields` 타입(`map[string]any`)입니다(위의 Entries 섹션 참고):
```go
type MyJSONFormatter struct{}
logrus.SetFormatter(new(MyJSONFormatter))
func (f \*MyJSONFormatter) Format(entry \*Entry) ([]byte, error) {
// Entry에서 사용할 수 있는 Time, Level, Message는 여기에 포함되지 않습니다.
// 해당 필드에 대한 정보는 `godoc`을 참조하거나 공식 로거의 소스코드를 읽어보세요.
serialized, err := json.Marshal(entry.Data)
if err != nil {
return nil, fmt.Errorf("Failed to marshal fields to JSON, %w", err)
}
return append(serialized, '\n'), nil
}
```
#### `io.Writer`로서의 로거
Logrus는 `io.Writer`로 변환할 수 있습니다. 해당 라이터는 `io.Pipe`의 끝이며 닫는 것은 사용자의 책임입니다.
```go
w := logger.Writer()
defer w.Close()
srv := http.Server{
// logrus.Logger에 쓰는 표준 라이브러리 log.Logger를 생성합니다.
ErrorLog: log.New(w, "", 0),
}
```
해당 라이터에 기록된 각 행은 포매터와 훅을 사용하여 평소와 같이 출력됩니다. 이 엔트리들의 레벨은 `info`입니다.
즉, 표준 라이브러리 로거를 쉽게 오버라이드할 수 있습니다:
```go
logger := logrus.New()
logger.Formatter = &logrus.JSONFormatter{}
// 표준 로그 출력에 logrus 사용
// 여기서 `log`는 logrus 이름으로 임포트된 것이 아니라
// 표준 라이브러리의 log를 참조함을 유의하세요.
log.SetOutput(logger.Writer())
```
#### 로테이션
로그 로테이션은 Logrus에서 기본 제공되지 않습니다. 로그 로테이션은 오래된 로그 엔트리를 압축하고 삭제할 수 있는 외부 프로그램(예: `logrotate(8)`)을 통해 수행해야 합니다. 이는

애플리케이션 레벨 로거의 기능입니다.
#### Tools
| Tool | Description |
| ---- | ----------- |
|[Logrus Mate](https://github.com/gogap/logrus\_mate)|Logrus mate는 Logrus용 로거 관리 도구로, 설정 파일을 통해 로거의 레벨, 훅, 포맷터를 초기화할 수 있으며 환경에 따라 다른 설정으로 로거가 생성됩니다.|
|[Logrus Viper Helper](https://github.com/heirko/go-contrib/tree/master/logrusHelper)|spf13/Viper를 감싸서 설정을 로드할 수 있도록 Logrus를 지원하는 헬퍼입니다! 또한 [Logrus Mate](https://github.com/gogap/logrus\_mate)의 일부 동작을 사용하여 Logrus 설정을 단순화합니다. [sample](https://github.com/heirko/iris-contrib/blob/master/middleware/logrus-logger/example) |
#### Testing
Logrus에는 로그 메시지의 존재 여부를 검증하기 위한 내장 기능이 있습니다. 이는 `test` 훅을 통해 구현되며 다음을 제공합니다:
\* 기존 로거용 데코레이터(`test.NewLocal` 및 `test.NewGlobal`, 기본적으로 `test` 훅만 추가함)
\* 로그 메시지를 기록하기만 하고(아무것도 출력하지 않음) 하는 테스트 로거(`test.NewNullLogger`):
```go
import(
"testing"
"github.com/sirupsen/logrus"
"github.com/sirupsen/logrus/hooks/test"
"github.com/stretchr/testify/assert"
)
func TestSomething(t\*testing.T){
logger, hook := test.NewNullLogger()
logger.Error("Helloerror")
assert.Equal(t, 1, len(hook.Entries))
assert.Equal(t, logrus.ErrorLevel, hook.LastEntry().Level)
assert.Equal(t, "Helloerror", hook.LastEntry().Message)
hook.Reset()
assert.Nil(t, hook.LastEntry())
}
```
#### Fatal handlers
Logrus는 `fatal` 레벨 메시지가 기록될 때 호출될 하나 이상의 함수를 등록할 수 있습니다. 등록된 핸들러는 logrus가 `os.Exit(1)`을 수행하기 전에 실행됩니다. 이 동작은 호출자가 안전하게 종료(gracefully shut down)해야 할 때 유용할 수 있습니다. 지연된(deferred) `recover`로 가로챌 수 있는 `panic("Something went wrong...")` 호출과 달리, `os.Exit(1)` 호출은 가로챌 수 없습니다.
```go
// ...
handler := func() {
// 무엇인가를 안전하게 종료...
}
logrus.RegisterExitHandler(handler)
// ...
```
#### Thread safety
기본적으로 Logger는 동시 쓰기로부터 보호하기 위해 뮤텍스로 보호됩니다. 뮤텍스는 훅을 호출하고 로그를 작성할 때 유지됩니다.
이러한 락(locking)이 필요하지 않다고 확신하는 경우, `logger.SetNoLock()`을 호출하여 락을 비활성화할 수 있습니다.
락이 필요하지 않은 경우는 다음과 같습니다:
\* 등록된 훅이 없거나, 훅 호출이 이미 스레드 안전(thread-safe)한 경우.
\* `logger.Out`에 대한 쓰기가 이미 스레드 안전한 경우. 예:
1) `logger.Out`이 락으로 보호되는 경우.
2) `logger.Out`이 `O\_APPEND` 플래그로 열린 `os.File` 핸들러이고, 모든 쓰기가 4k보다 작은 경우. (이를 통해 멀티 스레드/멀티 프로세스 쓰기가 가능함)
(참조: )