sirupsen/logrus

어떤 프로젝트인가요?

핵심 기능

• 01표준 라이브러리 log API와 호환되어 바로 대체해 사용할 수 있습니다.
• 02Trace부터 Panic까지 7개 레벨과 구조화된 키-값 필드를 지원합니다.
• 03터미널용 컬러 출력, logfmt 스타일 텍스트, JSON 포매터를 제공합니다.
• 04syslog나 오류 추적기 같은 서비스로 로그 항목을 전달하는 훅을 지원합니다.
• 05간단한 Format 인터페이스를 구현해 사용자 지정 포매터를 추가할 수 있습니다.
• 06단위 테스트에서 기록된 메시지를 검증할 수 있는 테스트 훅을 제공합니다.

활용 사례

• Logstash나 Splunk에서 수집할 수 있도록 Go 서비스에 구조화된 JSON 로그를 추가할 때.
• 호출부를 다시 작성하지 않고 기존 프로젝트를 표준 log 패키지에서 마이그레이션할 때.
• 훅을 통해 오류 레벨 로그 항목을 외부 예외 추적기로 전송할 때.
• 특정 로그 메시지가 출력되었는지 단위 테스트에서 검증할 때.

빠른 시작

1. 1

   Logrus 모듈을 설치합니다

   go get github.com/sirupsen/logrus
2. 2

   Go 코드에서 모듈을 가져와 필드가 포함된 메시지를 로그로 남깁니다

사용 전 알아둘 점

• !Logrus는 유지보수 모드이므로 새로운 기능이 추가될 예정은 없습니다.
• !README에서는 Zerolog, Zap, Apex와 같은 대안을 안내합니다.

포함된 컬렉션

토픽

자주 묻는 질문

logrus은(는) 무엇인가요?

확장 가능한 포매터와 훅을 제공하는 Go용 구조화 로거로, API 호환성을 갖췄으며 현재는 유지보수 모드입니다. Logrus는 Go용 구조화 로거로, 표준 라이브러리의 log 패키지와 API 호환되므로 기존 log import를 거의 수정하지 않고 바꿔 쓸 수 있습니다. 키-값 필드와 로그 레벨을 포함한 항목을 기록하며, Logstash와 Splunk 같은 로그 집계 시스템을 위해 터미널용 컬러 텍스트, logfmt 스타일 텍스트 또는 JSON으로 출력할 수 있습니다.

logrus은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

logrus은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

logrus은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. logrus의 마지막 커밋은 2026년 10월 2일입니다.

logrus은(는) 어디에 사용할 수 있나요?

Logstash나 Splunk에서 수집할 수 있도록 Go 서비스에 구조화된 JSON 로그를 추가할 때. 호출부를 다시 작성하지 않고 기존 프로젝트를 표준 log 패키지에서 마이그레이션할 때. 훅을 통해 오류 레벨 로그 항목을 외부 예외 추적기로 전송할 때. 특정 로그 메시지가 출력되었는지 단위 테스트에서 검증할 때.

logrus는 어떻게 설치하나요?

Logrus 모듈을 설치합니다: go get github.com/sirupsen/logrus Go 코드에서 모듈을 가져와 필드가 포함된 메시지를 로그로 남깁니다

logrus은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sirupsen/logrus