다음을 통해 공유


로그 파일(.NET용 POS v1.14 SDK 설명서)

.NET용 Microsoft POS(POS for .NET)에는 .NET, 서비스 개체 및 애플리케이션 이벤트에 대한 POS를 기록하기 위한 로깅 기능이 포함되어 있습니다. 로깅 매개 변수는 .NET 레지스트리 키인 \HKLM\SOFTWARE\POSfor.NET\Logging에 대한 POS에서 읽혀지며 제반 항목은 Logger 클래스를 사용하여 작성됩니다.

로깅 설정

레지스트리 키 \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled를 0이 아닌 값으로 설정하면 로깅이 사용됩니다.

로그 파일 크기

최대 로그 파일 크기는 레지스트리 키 \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB에 지정됩니다. 로깅을 사용하는 동안 이 파일 크기를 초과하면 로깅이 중지됩니다. 애플리케이션에 반환된 예외 또는 오류는 없습니다.

기본적으로 최대 로그 파일 크기는 10MB(메가바이트)입니다.

로그 파일 위치

레지스트리 키 \HKLM\SOFTWARE\POSfor.NET\Logging\location은 로그 파일을 쓸 위치를 결정하는 데 사용됩니다.

기본적으로 이 위치는 환경 변수 %TEMP%로 설정되며, Windows에서는 기본적으로 C:\Documents and Settings\(username)\Local Settings\temp 디렉터리로 설정됩니다. 이는 사용자별 디렉터리입니다.

로그 파일 이름

로그 파일 이름은 다음 세 가지 요소로 구성됩니다.

  • 레지스트리 키 \HKLM\SOFTWARE\POSfor.NET\Logging\Name에 포함된 기본 파일 이름 이 값의 기본값은 PosFor.Net입니다.
  • 다음 형식의 타임스탬프: (yyyy-mm-dd hh-mm-ssZ)
  • 파일 확장명 .txt

다음은 일반적인 로그 파일 이름의 예입니다.

PosFor.Net(2006-08-10 18-33-29Z).txt

로그 파일 헤더

사용자, OS, 호출 스레드 및 프로세스와 같은 정보가 포함된 헤더는 생성 시 각 로그 파일에 기록됩니다. 이 헤더에는 다음 필드가 포함되어 있습니다.

  • 현재 사용자: 현재 사용자의 이름
  • 컴퓨터 이름: 로그를 만드는 컴퓨터의 이름
  • OS 버전: 서비스 팩을 포함하여 실행 중인 Windows 버전
  • .Net 런타임: .NET 런타임의 버전
  • 프로세스 ID: 로그 파일을 만든 프로세스의 PID
  • 스레드 ID: 로그를 만든 스레드
  • 최대 로그 파일 크기: 이 로그 파일에 사용할 최대 파일 크기
  • 파일: 로그 파일을 만든 실행 파일의 이름
  • InternalName: 실행 파일의 내부 이름
  • OriginalFilename: 실행 파일의 원래 이름
  • FileVersion: 실행 파일에 저장된 버전 정보
  • FileDescription: 실행 파일에 저장된 설명
  • 제품: 실행 파일에 저장된 제품 설명
  • ProductVersion: 실행 파일에 저장된 파일 버전
  • 디버그: 디버그 플래그
  • 패치됨: 패치된 파일
  • PreRelease: 시험판 플래그
  • PrivateBuild: 프라이빗 빌드 플래그
  • SpecialBuild: 특수 빌드 플래그
  • 언어: 로그 파일을 만드는 데 사용되는 언어

로그 파일 항목

로그 항목은 .NET용 POS에서 만들거나 애플리케이션 또는 서비스 개체에서 만들 수 있습니다. 항목은 Logger 클래스의 인스턴스에서 적절한 메서드를 호출하여 생성됩니다.

각 항목에는 다음 필드가 포함됩니다.

  • Timestamp.

  • 해당 항목을 만든 스레드 ID

  • 중요도 수준입니다. 각 로그 항목은 그와 관련된 Logger 메서드에 따라 결정되는 중요도 수준으로 표시됩니다.

    로그 항목의 중요도 태그 해당 로거 메서드
    정보 Logger.Info
    경고 Logger.Warning
    오류 Logger.Error
  • 로거 메서드를 호출한 코드에서 지정한 이름 문자열입니다. 이 문자열은 로거 메서드가 호출될 때 지정되며 실행 파일의 이름을 반드시 포함하지 않을 수도 있습니다.

  • 예를 들어 로그 파일의 일반적인 항목은 다음과 같이 표시됩니다. [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()

의견

로그 파일이 열려 있고 애플리케이션이 Refresh() 메서드를 호출하는 경우 파일은 닫히며 타임스탬프가 업데이트된 새 파일이 만들어집니다.

참고 항목

참조

개념

기타 리소스