Kori 1월 12일, 2025에 포스트됨 1월 12일, 2025에 포스트됨 <Dev Days of Summer > 2024! 에서 진행된 세션 중 jachLog 개발자인 Juan Castillo가 직접 진행한 "로그 기록 기능을 여러분의 애플리케이션에 쉽게 넣는 방법"을 간략히 요약한다. 또한 비디오 다시보기도 함께 게시한다. jachLog란? 로그 기능을 넣을 수 있는 오픈 소스 라이브러리다. 이것을 이용하면, 손쉽게 여러분의 애플리케이션 안에서 발생되는 일들 (이벤트, 트랜젝션, 에러 등)을 다양한 방식으로 기록할 수 있다. IDE 안에서 겟잇 패키지 매니저를 통해 간편하게 다운로드 및 설치를 할 수 있다. 로그 파일이란? 시스템 안에서 발생되는 것들(이벤트, 트랜젝션, 에러 등)에 대한 기록 이런 기록들은 여러 가지 다른 방식으로 저장되고 기록될 수 있음 로그 기록은 특정 시간에 발생되는 사건에 대한 기록이며, 그 문맥을 담은 메타데이터를 같이 남길 수 있음 jachLog는 텍스트 로그 기록 기능을 기존 애플리케이션에 추가하는 것을 몇 분 만에 할 수 있도록하는 라이브러리임 jachLog를 여러분의 개발 환경(IDE) 안에 추가하는 방법 Tools > GetIt Package Manager를 통해 창을 열고 검색창에서 jachLog를 찾은 후 Install 버튼을 클릭 설치되면, 데모 프로젝트들이 IDE 안에서 열림 (어떻게 사용하는지 쉽게 이해할 수 있음) 콘솔 앱 안에서 사용해보기 실행하기 데모 프로젝트들 중 BasicConsoleDemo.exe 프로젝트를 빌드/실행(Ctrl+Shift+F9 실행 결과 보기 해당 콘솔 프로그램에 로그가 기록됨 그 로그는 ProgramData 폴더 밑 'log' 폴더 안에 별도의 텍스트 파일로도 생성됨 주요 코드 보기 Projects 창에서 프로젝트를 선택하고, View Source (Ctrl+V)를 통해 콘솔 앱의 소스 코드를 열고, 어떻게 구현하는지 살펴보자 uses 문장 안에 유닛 2 개 (UjachLogMgr, ujachLogAuto)이 추가되어 있음 jachLog.LogInfo 메서드를 통해 Info 수준의 로그를 간편하게 기록함 jachLog.LogWarning 메서드를 통해 Warning 수준의 로그를 간편하게 기록함 VCL 앱 안에서 사용해보기 실행하기 및 코드 보기 데모 중 VCLDesktopDemo.exe 프로젝트를 빌드/실행(Ctrl+Shift+F9) 코드는 위와 비슷하며, 보다 많은 기능을 볼 수 있음 이미 운영하고 있는 앱 안에 로그 기록 기능 추가해 보기 델파이 기본 제공 데모 중 Windows 10 CRM Demo 프로젝트 (\Samples\Object Pascal\VCL\Windows 10 CRM Demo)에 로그 기록 기능을 추가해 보자. uses 문장에 유닛 추가하기 (implementation 구역에 추가해도 충분함) 기본 폼의 소스 코드의 uses 문장에 유닛 2 개 (ujachLogMgr, ujachLogAuto)를 추가 jachLog의 메서드를 사용하기 로그 기록을 남기고 싶은 이벤트 핸들러 코드 안에서 jachLog의 메서드를 사용하면 됨 (예: jachLog.LogInfo 등) 이 때, 메타 데이터 등 원하는 사항들을 함께 기록할 수 있음 폼 소스 뿐만 아니라 다른 어느 소스에서도 같은 방식으로 로그 기능 (예: 데이터 모듈 소스에서도 데이터의 변화를 로그로 기록하고 싶은 경우에도 같은 방식을 구현하면 됨) 팁: UlltraEdit을 활용해 로그 파일(텍스트 파일 형식)을 실시간 모니터링하기 로그 파일을 읽을 때 UlltraEdit을 사용한다면, Polling 옵션을 켜 놓는 방법도 있음. 그러면, 파일이 업데이트 되는 것을 거의 실시간으로 볼 수 있음 로그를 여러 목적지에 기록하기 델파이 기본 제공 데모 중 HttpDownloadDemo 프로젝트 (\Samples\Object Pascal\RTL\HttpDownload)에 로그 기록 기능을 추가해 보자. (참고: HttpDownloadDemo앱은 FMX 앱이며, 멀티-쓰레드를 사용하는 앱이다) 작동하고 있는 데모 폼 안에 Memo컴포넌트를 넣고 그 안에 로그를 기록하기 (사용 중인 고객에게 바로 보여줄 수 있다) interface 구역에 코드 추가 uses 문장에 ujachLogToFMXMemo 유닛을 추가 데모 폼의 private 구역에 FLogToMemo: TjachLogToFMXMemo; 선언 implementation 구역 uses 문장에 유닛 2 개 (ujachLogMgr, ujachLogAuto)를 추가 FormCreate 이벤트 핸들러 안에서 FLogToMemo 오브젝트를 사용해 해당 폼 안에 로그를 기록하기 jachLog.UseSeparateThreadToWrite := True; //멀티-쓰레드 사용 FLogToMemo : = TjachLogToFMXMemo.Create(); FLogToMemo.Memo := Memo1; FLogToMemo.IsActive := True; jachLog.RegisterLogWriter(FLogToMemo); FormDestroy 이벤트 핸들러 안에서 LogWriter를 해제하고 FLogToMemo도 해제하기 jachLog.UnRegisterLogWriter(FLogToMemo); FLogToMemo.Free; 참고 자료 및 더 많은 내용 멀티-쓰레드로 기록하기, 로그 기록 수준 필터링 등 다양한 기능은 아래의 비디오 다시보기 을 참고하세요. 도움말, 데모 등은 깃허브 프로젝트 참고 비디오 다시보기 인용하기
Recommended Posts
이 토의에 참여하세요
지금 바로 의견을 남길 수 있습니다. 그리고 나서 가입해도 됩니다. 이미 회원이라면, 지금 로그인하고 본인 계정으로 의견을 남기세요.