*참고: 출처를 찾을 수 있습니다. 여기.
로깅 및 계측 기능은 SDK의 다소 평범한 기능 중 하나이지만, 문제를 찾아 격리하고 애플리케이션이 예상대로 실행되고 있는지 확인하는 측면에서 가장 가치 있는 기능 중 하나라고 할 수 있습니다. 이 글에서는 새로운 Couchbase SDK 2.0이 로깅을 처리하는 방법, 지원하는 프레임워크, 새 클라이언트를 사용하여 로깅을 시작하고 실행하는 방법에 대해 설명합니다.
우리 모두는 공통점이 있습니다...
우리 모두가 아파치를 지원할 때 Common.Logging 그렇습니다! 농담은 제쳐두고, 새 클라이언트는 이 공통 인터페이스를 통해 다양한 로깅 구현을 지원하므로 로깅 제공업체를 선택할 수 있는 옵션은 다음과 같습니다:
- Log4net
- NLog
- System.Console
- 사용자 지정(직접 롤링)
- 그리고 기타...
선택한 로깅 구현이 Common.Logging 인터페이스를 지원하기만 하면 바로 사용할 수 있습니다!
시작하기
클라이언트는 Common.Logging에 대한 종속성이 이미 정의된 상태로 제공되며, 바이너리가 포함된 zip 파일에 포함되거나 Nuget 패키징으로 관리됩니다. 기본 System.Console에 로깅을 사용하려면 App.Config 또는 Web.Config에 다음 구성을 추가하기만 하면 됩니다:
위의 코드 조각에서는 먼저 Logging.Common 구성을 저장할 새 구성 섹션을 정의했습니다. 그런 다음 구성 요소를 추가하고 System.Console에 대한 팩토리 어댑터와 약간의 서식을 정의했습니다. 그게 다입니다! 애플리케이션을 실행하면 모든 로깅 정보가 stdout으로 전달되는 것을 볼 수 있습니다.
stdout에 로깅하는 것은 단위 테스트 프로젝트 등에는 유용하지만 프로덕션 배포에는 적합하지 않습니다. 이 경우 log4net이나 NLog와 같은 팩토리 애펜더를 사용하고 결과를 파일이나 데이터베이스에 기록하는 것이 좋습니다(운영 데이터 저장소로 Couchbase에 다시 사용하는 것은 어떨까요?).
Log4Net 어댑터 사용
지금까지 기본 ConsoleOutLoggerFactoryAdapter를 사용하여 stdout에 쓰는 방법을 보여드렸는데, Log4Net과 같은 다른 로깅 프레임워크를 사용하는 것은 어떨까요? 프로젝트에서 Log4Net에 대한 종속성을 참조했다고 가정하면 꽤 쉽게 할 수 있습니다:
여기서는 일반적인 Common.Logging 섹션과 구성 요소를 생성한 다음 Log4NetLoggerFactoryAdapter를 지정하고 있습니다. 또한 파일 애펜더를 위한 로그4넷 섹션과 구성 요소를 지정하고 쓸 파일 경로를 추가하고 있습니다. 이는 프로덕션 환경에서 사용하는 구성과 비슷합니다. packages.config 파일에 다음 Nuget 패키지에 대한 참조가 있어야 한다는 점에 유의하세요:
대부분의 경우 이 파일을 관리하기 위해 Nuget을 사용하지만, 이 파일을 사용하면 Nuget 패키지 관리자 대화 상자를 "바로 가기"할 수 있습니다.
로그 수준에 대한 간단한 참고 사항
클라이언트는 다음과 같은 표준 로그 수준을 사용합니다:
- 추적
- Debug
- 오류
- 치명적
- 경고
- 정보
일반적으로 디버그는 작업의 일반적인 실행을 추적하는 데 전반적으로 사용됩니다. Info는 클라이언트의 구성 관리(클러스터 토폴로지 변경 등) 부분을 추적하는 데 사용되며, 포착된(그리고 다시 발생할 수 있는) 모든 예외는 오류로 기록됩니다.
