Jump to content
과거의 기술자료(읽기 전용): https://tech.devgear.co.kr ×
과거의 기술자료(읽기 전용): https://tech.devgear.co.kr

Recommended Posts

에 포스트됨

<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;

참고 자료 및 더 많은 내용

비디오 다시보기

 

이 토의에 참여하세요

지금 바로 의견을 남길 수 있습니다. 그리고 나서 가입해도 됩니다. 이미 회원이라면, 지금 로그인하고 본인 계정으로 의견을 남기세요.

Guest
이 토픽(기고/질문)에 답하기

×   서식있는 텍스트로 붙여넣기.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   이전에 작성한 콘텐츠가 복원되었습니다..   편집창 비우기

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...

중요한 정보

이용약관 개인정보보호정책 이용규칙 이 사이트가 더 잘 작동하기 위해 방문자의 컴퓨터에 쿠키가 배치됩니다. 쿠키 설정 변경에서 원하는 설정을 할 수 있습니다. 변경하지 않으면 쿠키를 허용하는 것으로 이해합니다.