yenny-y.log

NLog

Thu, 14 Dec 2023 06:09:12 GMT

NLog란?

NLog is a flexible and free logging platform for various .NET platforms, including .NET standard. NLog는 .NET standard 를 비롯한 다양한 .NET 플랫폼을 위한 유연하고 자유로운 로깅 플랫폼입니다. https://nlog-project.org

Configuration

config 파일을 사용하는 방법과 코드에서 설정하는 방법이 있습니다. 두가지 방법은 함께 사용할 수 있습니다.

1. Config 파일 사용

config 파일을 아래 순서대로 검색하다 처음 검색된 파일을 사용합니다.

독립 실행형 응용 프로그램 (.exe)

표준 응용프로그램 구성 파일 app.config (ex: 프로그램명.exe.config)
응용 프로그램 폴더에 있는 '프로그램명.exe.nlog'
응용 프로그램 폴더에 있는 'NLog.config'
NLog.dll이 위치한 폴더에 있는 'NLog.dll.nlog' (NLog.dll이 GAC(Global Assembly Cache)에 설치되지 않은 경우에만)

ASP.NET 응용 프로그램

표준 응용 프로그램 구성 파일 'web.config'
web.config 파일이 위치한 폴더에 있는 'web.nlog'
응용 프로그램의 폴더에 있는 'NLog.config'
NLog.dll이 위치한 폴더에 있는 'NLog.dll.nlog' (NLog.dll이 GAC(Global Assembly Cache)에 설치되지 않은 경우에만)

2. 코드에서 설정

Configuration API 를 사용하여 프로그래밍 방식으로 코드에서 설정할 수 있습니다. 모든 속성은 config 파일의 구조와 동일합니다.

Config 파일

0. 파일 구조

1. 기본 옵션

autoReload (Boolean) : config 파일의 변경사항을 자동으로 다시 로드할지 여부
internalLogFile (String) : 내부 로그 파일 경로
keepVariablesOnReload (Boolean) : 런타임에 할당된 변수를 config 가 다시 로드될 때 유지할지 여부
그 외 : internalLogToConsole, internalLogToConsoleError, internalLogLevel, globalThreshold, throwExceptions, throwConfigExceptions, internalLogToTrace, internalLogIncludeTimestamp, useInvariantCulture, parseMessageTemplates

2. 변수

변수는 Configuration API 를 사용하여 변경, 삭제 및 생성할 수 있습니다.

변수 정의

변수 사용

${변수명} - 정적 모드 (또는 상수 모드)
${var:변수명} - 동적 모드

3. targets

출력 대상과 레이아웃을 정의합니다. 대상 - 콘솔, 파일, DB, 메일, 클라우드, 로그 뷰어 (NLog, Log4j, Windows), 윈폼 등 (v5.2.7 기준 101개) 레이아웃 - 텍스트, JSON, CVS, Log4JXml, XML 등 (v5.2.7 기준 13개) (https://nlog-project.org/config/?tab=targets)

Console

name (String) - 대상 이름
layout (Layout) - 로그 메시지 형태
autoFlush (Boolean) - 콘솔 출력 후 자동 플러시 여부
error (Boolean) - 표준 출력 대신 표준 오류로 보낼지 여부
그 외 - header, footer, detectConsoleAvailable, encoding, writeBuffer, optimizeBufferReuse
File*
name (String) - 대상 이름
layout (Layout) - 로그 메시지 형태
maxArchiveDays (Integer) - 아카이브 파일 보관 기간
archiveEvery (Enum) - 로그 파일 아카이빙 주기 (Day, Sunday 등)
archiveAboveSize (Long) - 로그 파일 아카이빙 크기 (바이트)
maxArchiveFiles (Integer) - 아카이브 파일의 최대 개수
archiveOldFileOnStartup (Boolean) - 시작 시 기존 로그 파일을 아카이빙할지 여부
fileName (Layout) - 파일명
그 외 - header, footer, encoding, lineEnding, enableArchiveFileCompression, archiveNumbering, archiveFileName, archiveFileKind, writeFooterOnArchivingOnly, maxLogFilenames, deleteOldFileOnStartup, fileAttributes, createDirs, cleanupFileName, archiveOldFileOnStartupAboveSize, archiveDateFormat, enableFileDelete, writeBom, replaceFileContentsOnEachWrite, forceMutexConcurrentWrites, forceManaged, fileNameKind, optimizeBufferReuse, networkWrites, openFileCacheTimeout, openFileCacheSize, keepFileOpen, discardAll, concurrentWrites, concurrentWriteAttempts, concurrentWriteAttemptDelay, bufferSize, openFileFlushTimeout, autoFlush
Database*
```
>
 
```
name (String) - 대상 이름
keepConnection (Boolean) - DB 연결 유지 여부
dbProvider (String) - DB 공급자 이름 (connectionString 미제공 시 'Provider=')
dbHost (Layout) - DB 호스트명 (connectionString 미설정 시 'Server=')
dbDatabase (Layout) - DB 이름 (connectionString 미설정 시 'Database=')
dbUserName (Layout) - DB 사용자 이름 (connectionString 미설정 시 'User ID=')
dbPassword (Layout) - DB 암호 (connectionString 미설정 시 'Password=')
connectionString (Layout) - DB 연결 문자열
commandText (Layout) - SQL 명령어 (INSERT 쿼리 등)
parameter - SQL 명령어 파라미터
parameter/name (String) - 파라미터 이름
parameter/layout (Layout) - 파라미터 형태
그외 - keepConnection, connectionproperty, commandProperty, installConnectionString, install-command, uninstall-command, isolationLevel, optimizeBufferReuse, commandType, parameter/dbType, parameter/size, parameter/precision, parameter/scale, parameter/parameterType, parameter/allowDbNull, parameter/format, parameter/culture

4. rules

출력 대상이나 로그 레벨에 대한 출력 정책을 설정합니다. 로그 레벨 - Trace (0) > Debug (1) > Info (2) > Warn (3) > Error (4) > Fatal (5)

name (String) - 로깅할 로거 이름 (*, ? 사용 가능)
levels (String) - 로깅할 레벨 목록 (','로 구분하여 나열)
minlevel (Enum) - 로깅할 최소 레벨
maxlevel (Enum) - 로깅할 최대 레벨
level (Enum) - 로깅할 레벨
writeTo (String) - 로깅할 출력 대상 이름 목록 (','로 구분하여 나열)
final (Boolean) - 일치하는 규칙이 있는 경우 이후 규칙 처리 중지 여부
enabled (Boolean) - 규칙 비활성화
ruleName (String) - 규칙 이름

5. 레이아웃 렌더러

레이아웃에서 사용되는 템플릿 매크로입니다. (v5.2.7 기준 143개. https://nlog-project.org/config/?tab=layout-renderers)

${level} - 로그 레벨
${message} - 로그 메시지

호출 위치 및 호출 스택
${callsite-filename} - 호출 파일명
${callsite-linenumber} - 호출 줄 번호
${stacktrace} - 스택 트레이스

조건
${when:when=조건:inner=값1:else=값2} - 조건에 따라 값 선택
${값:whenempty=대체값} - 값이 비어있을 경우 값 대체

컨텍스트 정보
${변수명} - NLog 로깅 변수값

카운터
${guid} - GUID
${sequenceid} - 로그 시퀀스 아이디

날짜 및 시간
${date}, ${longdate}, ${shortdate} - 현재 날짜 및 시간
${ticks} - 현재 날짜 및 시간의 ticks

인코딩 및 문자열 변환
${값:padding=개수} - 개수만큼 왼쪽 패딩
${replace:inner=값:searchFor=찾기:replaceWith=바꾸기} - 문자열 바꾸기
${substring:inner=값:start=N1:length=N2} - 문자열 자르기
${값:trimWhiteSpace=true} - 공백 제거
${값:uppercase=true}, ${lowercase:값} - 대/소문자 출력
${값:json-encode=true}, ${값:xmlEncode=true} - json/xml 인코딩

환경 및 구성 파일
${appsetting:item=이름} - app 설정 값 (app.config)
${environment:변수명} - 환경 변수 값

파일 및 디렉토리
${basedir}, ${processdir}, ${tempdir} - 디렉토리 경로
${file-contents:fileName=파일명} - 파일 내용

사용자 식별
${environment-user} - 사용자/도메인 정보

프로세스, 스레드 및 어셈블리
${appdomain} - app 도메인
${assembly-version} - 어셈블리 버전
${hostname} - 호스트 이름
${local-ip} - 로컬 IP 주소
${processid}, ${processname} - 프로세스 ID/이름
${threadid}, ${threadname} - 스레드 ID/이름

예제

1. NuGet 설치

NLog
NLog.Config (옵션)

2. NLog.config 작성

  
  

> ```

3. 코드 작성

using NLog;
>
namespace NLogTest
{
    class Program
    {
        private static Logger _logger = LogManager.GetCurrentClassLogger();
        static void Main(string[] args)
        {
            _logger.Debug("[Main] Debug 로그");
            _logger.Info("[Main] Info 로그");
            _logger.Error("[Main] Error 로그");
            _logger.Fatal("[Main] Fatal 로그");
>
            Test1();
        }
>
        static void Test1()
        {
            _logger.Debug("[Test1] Debug 로그");
            _logger.Info("[Test1] Info 로그");
            _logger.Error("[Test1] Error 로그");
            _logger.Fatal("[Test1] Fatal 로그");
>
            Test2();
        }
>
        static void Test2()
        {
            _logger.Debug("[Test2] Debug 로그");
            _logger.Info("[Test2] Info 로그");
            _logger.Error("[Test2] Error 로그");
            _logger.Fatal("[Test2] Fatal 로그");
        }
    }
}

4. 결과

Console

모든 레벨 출력
스택 트레이스 출력 (Program.Main => Program.Test1 => Program.Test2)

File

Info ~ Error 레벨 로그 출력
Error 레벨 로그 출력
호출 파일명 및 줄 번호 출력 (C:\Source\NLogTest\NLogTest\Program.cs 32)

2023.12.20 2회 실행 2023.12.23 1회 실행

보관 기간이 지난 아카이브 파일 자동 삭제 (log_20231220.txt)
시작 시 기존 로그 파일 아카이빙 (log_20231220_err.txt -> log_20231220_err.0.txt)

CCTV 통합관제 솔루션 (VMS)

Mon, 03 Jul 2023 01:00:35 GMT

Project

개발 기간 | 1 년 개발 환경 | WPF / Telerik 기능 요약 | CCTV 통합관제 주요 기능 | 1. CCTV 모니터링 및 관리 2. PTZ 제어 및 영상 조정 3. 영상 백업 및 재생 4. 객체 인식 이벤트 관리 5. 사용자 계정 관리

기능

CCTV 관리 및 CCTV에서 촬영한 영상을 모니터링 하는 통합관제 솔루션입니다. 카메라 PTZ 제어 및 영상 조정 기능과 영상 백업 및 재생 기능을 제공합니다. 또한 AI선별관제 솔루션과 연동하여 객체(사람/차량) 인식 이벤트를 표시하는 기능을 지원합니다. 사용자 계정 관리를 통해 계정별로 기능 사용에 대한 권한을 부여할 수 있습니다.

화면

영상 및 타임라인 화면은 외부 모듈을 사용했고, 그 외 부분은 WPF로 구현했습니다.

공통

트리 패널
이벤트 패널

관제 모드

CCTV 영상 및 타임라인
달력 및 플레이백 제어
카메라 PTZ 제어

관리자 모드

리소스 (레코딩 서버, 카메라 등) 관리
녹화 설정
사용자 계정 관리
AI선별관제 솔루션 연동 관리

기타

로컬 프로그램 설정
카메라 정보 불러오기

세부 화면

트리
리스트
PTZ 제어
Open/Close 토글 버튼
On/Off 토글 버튼

담당 업무

MVVM 패턴의 구조 설계와 전반적인 UI 구현을 담당했습니다.

1. UI 구현

디자인에 중점을 두기 위해 View와 ViewModel/Model 이 최대한 분리되도록 구현했습니다. 또한 Control 마다 스타일을 정의해 사용하여 통일된 스타일이 적용되도록 했습니다.

2. Back-End 모듈 연동

Google Flatbuffers, C++/CLI, REST API 형태의 Back-End 모듈과 연동하는 기능을 구현했습니다.

Google Flatbuffers
- 레코딩 서버, 카메라 정보 등 필요한 리소스 정보를 요청하고 Callback 형태로 정보를 수신받습니다.

C++/CLI
- 카메라 PTZ 제어 및 영상 조정 기능을 호출할 수 있습니다. (ONVIF)
- 카메라 이벤트를 수신받습니다.

REST API
- AI 선별관제 솔루션에 로그인하고 시나리오를 편집할 수 있습니다.

3. 이벤트 메시지 수신 (TCP)

AI 선별관제에서 송신하는 이벤트 메시지를 수신받는 TCP 서버를 구현했습니다. 수신받은 이벤트는 일정 시간마다 카메라 별로 Grouping 하여 화면에 표시됩니다.

4. 다국어 기능

언어별로 리소스 파일을 분리해 추가 및 수정에 용이하도록 구현했습니다. 언어 변경 시 로그아웃이나 프로그램 재실행 없이 런타임으로 설정이 가능합니다.

판서 애니메이션

Thu, 22 Apr 2021 19:40:38 GMT

Project

개발 기간 | 3 개월 개발 환경 | WPF 기능 요약 | 이미지 파일의 문자를 인식해 판서 애니메이션 생성 및 실행 주요 기능 | 1. 이미지 파일의 문자 인식 2. 판서 애니메이션 자동 생성 / 수동 Edit 3. 판서 애니메이션 실행

기능

이미지 파일의 문자를 인식해 판서 애니메이션을 자동으로 생성하고 실행하는 프로그램입니다. 애니메이션을 수동으로 Edit 하는 기능과, 결과물을 파일 형태로 저장 및 Load 하는 기능을 제공합니다. 여러개의 이미지 파일을 처리하고 애니메이션 할 수 있습니다.

화면

MahApps.Metro와 MaterialDesignThemes를 사용했습니다. 전체적인 구조는 프로그램의 사용 Flow에 맞게 구성했고, Edit 프로그램 특성상 다양한 기능들이 있기 때문에 편의성을 위해 그림판 등의 익숙한 UI를 참고했습니다.

PROJECT

대상/배경/펜 이미지 열기
OCR 분석
파일 저장/불러오기

EDIT

애니메이션 Edit
화면 옵션 설정 (View/Hide, 색상)

ANIMATION

프로젝트별 애니메이션 재생
전체 화면에서 애니메이션 재생
재생 속도 설정

Expander

프로젝트 목록
애니메이션 목록
애니메이션의 Path 목록
애니메이션 Group 목록

담당 업무

1. 애니메이션 Edit

애니메이션 Edit 기능을 개발했습니다.

기능 목록
- 선택 모드 (단일 선택 / 다중 선택)
- 영역 편집 (사각형 / 자유형)
- 편의 기능 (Merge / Sort)
- 애니메이션 추가
- 애니메이션 Path 편집 (지우개 / 펜 / 펜 색상)
- 애니메이션 Group 편집

선택 모드

단일 선택 - 다중 선택

영역 편집
- 사각형 - 자유형 >
편의 기능
- Merge
- Sort (왼쪽 -> 오른쪽 순서로 Sequence Number 정렬) >
애니메이션 Path 편집
- 지우개 (Path 영역이 지워지면서 원본 이미지가 보임)
- 펜 (원본 이미지 위에 추가)

2. DB 기능 개발

생성한 애니메이션을 .zip 형태의 파일로 저장하고 불러오는 기능을 개발했습니다.

참고

문자 인식 이미지 파일의 문자 인식은 Tesseract 라이브러리를 사용했는데, 이미지 파일의 해상도에 따라 문자 인식률이 달라졌습니다. 인식률이 높을수록 자동으로 생성되는 애니메이션의 완성도가 높아지기 때문에 인식률을 높이기 위해 해상도를 단계별로 처리했습니다.
Layer 구조

지우개 Path 애니메이션 재생 단계 1) Cover Layer : Path 영역을 지움 2) Mask Layer : Path 영역을 배경 이미지로 채움 3) Path 에서 재생할 영역만 Mask Layer 를 지움 4) Mask Layer의 지워진 부분(3번)의 Source 이미지가 보임 5) 한 개의 Path가 다 재생될 때까지 3~4번 반복

교과/수능 성적 관리

Wed, 21 Apr 2021 08:31:36 GMT

Project

개발 기간 | 2.5 개월 개발 환경 | WPF / MariaDB / NSIS 기능 요약 | 교과/수능 성적 관리 주요 기능 | 1. Excel 형태의 성적 데이터 DB 저장 2. 최신 성적 데이터 관리 3. 설치 패키지 제공

기능

Excel 형태의 성적 데이터를 DB에 저장하고, 서버 DB를 통해 사용자들의 성적 DB를 최신 성적으로 관리해주는 프로그램입니다. DB 설치, DB 환경 구성, DB 삭제 (Uninstall) 기능을 포함하는 설치 패키지를 제공합니다.

화면

UI 디자인은 클라이언트 쪽에서 직접 개발할 예정으로, 디자인은 제외하고 MVVM 패턴 적용과 주요 기능을 개발하는 것이 클라이언트의 요구사항이었습니다. MahApps.Metro의 기본 Control을 사용했고 서버용 프로그램과 사용자용 프로그램 구분을 위해 색상을 다르게 적용했습니다.

성적 Data 등록

교과 성적 조회

수능 성적 조회

Alert

Progress

담당 업무

1. DB 설계

서버에서 사용자들에게 최신 성적 데이터를 제공하기 위해 성적 데이터 Update 상태를 관리하는 구조로 구성했습니다. 기존의 학생+성적 Table을 학생 정보와 성적 데이터로 분리해 중복 데이터를 제거했습니다.

2. DB 기능 개발

대량의 데이터를 빠르게 저장하기 위해 Bulk Insert 와 Duplicate Key Update 쿼리를 사용했습니다.

// insert 쿼리 (예시)
INSERT INTO score
(id, grade, part, name, lname, unit, avg, achive, rank)
VALUES 
('3010001', 1, 1, '국어', '독서와문법', 4, '50/72.9(17.2)', 'E(379)', '1'),
('3010001', 1, 2, '국어', '독서와문법', NULL, NULL, NULL, NULL),
('3010001', 1, 1, '국어', '국어Ⅱ', NULL, NULL, NULL, NULL),
ON DUPLICATE KEY UPDATE
name = VALUES(name), unit = VALUES(unit), avg = VALUES(avg), achive = VALUES(achive), rank = VALUES(rank)

3. 설치 패키지 생성

NSIS를 이용해 하나의 설치 패키지로 서버용과 사용자용을 선택 설치할 수 있는 설치 패키지를 생성했습니다. 프로그램 실행에 필요한 Database 및 Table을 생성하는 Console 프로그램을 개발해 설치 패키지에 포함시켰습니다.

설치 옵션 선택
Install 구성 1) .NET Framework 2) MariaDB 자동 설치 3) DB 환경 구성 4) 교과/수능 성적 관리 프로그램
Uninstall 구성 1) MariaDB 자동 삭제 2) 교과/수능 성적 관리 프로그램 삭제

SSD Toolbox

Sat, 17 Apr 2021 09:13:56 GMT

Project

개발 기간 | 2.5 개월 개발 환경 | WPF / NSIS 기능 요약 | Disk 정보 확인 및 Data Migration 주요 기능 | 1. Disk Information 2. S.M.A.R.T 정보 3. Data Migration 4. 설치 패키지 제공

기능

Disk 상태와 S.M.A.R.T 정보를 확인하고 Data Migration 기능을 제공하는 프로그램입니다. Disk 상태 및 S.M.A.R.T 정보는 SATA와 NVMe를 지원하고, Data Migration 은 Data Cloning 과 Boot Section 생성 기능을 지원합니다.

화면

디자인 가이드를 제공 받았고 대부분의 Control 을 UserControl로 생성하고 Style을 정의해 사용했습니다.

Disk Information

S.M.A.R.T

Data Migration

디자인 가이드

구현 화면

담당 업무

1. Data Migration

Windows 7/10, 32Bit/64Bit 환경에서 Data Cloning 기능과 MBR/GPT Format의 부팅 기능을 개발했습니다.

Data Migration (예시)
Data Cloning 1) Data Cloning 조건 확인 : Source Disk 와 Target Disk 상태 확인 2) Target Disk 상태 변경 : Lock > Offline 3) Disk Cloning 4) Target Disk 상태 변경 : Online > Unlock > Update Properties 참고 : https://github.com/TalAloni/RawDiskCopier
Boot Section 생성 1) MBR/GPT 확인 2) Booting 가능 드라이버 확인 3) Boot Section 생성 참고 및 사용 : WMI, DISKPART, BCDEDIT

2. NVMe

NVMe S.M.A.R.T 정보 화면과 기능을 개발했습니다. NVMe 정보는 C++로 기능을 구현해 DLL 형태로 사용했습니다. 참고 : https://crystalmark.info/en/

NVMe S.M.A.R.T 정보 (예시)

3. 설치 패키지 생성

NSIS 를 이용해 설치 패키지를 생성했습니다.

설치 패키지 구성 1) VC++ 재배포 패키지 (x86/x64) 2) .NET Framework 3) SSD Toolbox