Log4CPlus 사용자 매뉴얼 노트

Log4CPlus 사용자 매뉴얼

log4cplus는 log4j에서 영감을 받은 C++ 로깅 라이브러리로, 스레드 안전하고 설정 가능한 로깅 기능을 제공합니다. 레벨, 출력 대상을 위한 appender, 포맷팅을 위한 layout을 지원합니다. 설치는 apt-get과 같은 패키지 관리자를 이용하거나 소스에서 빌드하여 수행할 수 있습니다. 라이브러리는 2.x 버전의 경우 C++11을, 최신 3.x 시리즈의 경우 C++23을 요구합니다. CMake 프로젝트와의 통합은 Conan과 같은 패키지 관리자를 통해 용이하게 이루어집니다. 최소 예제는 기본적인 초기화, 로거 생성, 메시지 로깅을 보여줍니다. BasicConfigurator는 콘솔 로깅을 위한 간단한 기본 설정을 제공합니다. 실제 프로젝트의 경우, properties 파일을 통해 로거를 설정하기 위해 PropertyConfigurator를 사용하는 것이 좋습니다. 로그 레벨은 TRACE부터 FATAL까지 있으며, 필터링을 위한 의사 레벨로 ALL과 OFF가 있습니다. 일반적인 appender로는 ConsoleAppender, FileAppender, RollingFileAppender가 있습니다. CallbackAppender는 로그 이벤트를 사용자 정의 C 스타일 함수로 라우팅할 수 있게 합니다. Appender는 기본적으로 동기적으로 실행되지만, 성능 향상을 위해 비동기 작동을 활성화할 수 있습니다. 프로그램 종료 시 log4cplus::Logger::shutdown()을 호출하여 깔끔한 종료를 달성할 수 있습니다.