Couchbase .NET SDK 2.0 개발 시리즈: 로깅

*참고: 출처를 찾을 수 있습니다 여기.

SDK의 다소 단조로운 기능 중 하나일 수도 있지만, 로깅과 계측(instrumentation)은 문제 찾기 및 격리, 그리고 애플리케이션이 예상대로 실행되는지 확인하는 측면에서 아마도 가장 가치 있는 기능 중 하나일 것입니다. 이 글에서는 새로운 카우치베이스(Couchbase) SDK 2.0이 로깅을 처리하는 방식, 지원하는 프레임워크, 그리고 새 클라이언트를 사용하여 로깅을 시작하고 실행하는 방법에 대해 논의하겠습니다.

우리 모두는 공통점이 있습니다...

우리가 모두 아파치를 지지할 때 Common.Logging 농담은 그만하고, 새 클라이언트는 이 공통 인터페이스를 통해 다양한 로깅 구현을 지원하므로 로깅 제공자(프로바이더)로 선택할 수 있는 옵션은 다음과 같습니다:

• Log4net
• 엔로그
• 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를 지정합니다. 또한 파일 어펜더를 위한 log4net 섹션과 구성 요소를 지정하고 기록할 파일의 경로를 추가합니다. 이것은 프로덕션 환경에서 사용할 법한 구성과 더 유사합니다. packages.config 파일에 다음 Nuget 패키지에 대한 참조가 있어야 합니다.

       

대부분의 경우 이 파일을 관리하기 위해 NuGet을 사용하겠지만, 이 파일을 사용하면 NuGet 패키지 관리자 대화 상자를 “우회(단축)”할 수 있습니다.

로그 수준에 대한 간단한 참고 사항

클라이언트는 다음과 같은 표준 로그 레벨을 사용합니다.

• 추적하다
• 디버그
• 오류
• 치명적인
• 경고하다
• 정보

일반적으로 Debug는 작업의 전반적인 실행을 추적하는 데 사용됩니다. Info는 클라이언트의 구성 관리(클러스터 토폴로지 변경 등) 부분을 추적하는 데 사용되며, 포착된(그리고 잠시 다시 던져진) 모든 예외는 Error로 기록됩니다.