■ Logger 클래스의 setLevel 메소드를 사용해 로깅 수준을 설정하는 방법을 보여준다. ▶ 예제 코드 (PY)
|
1 2 3 4 5 6 7 8 9 10 11 |
import logging from langchain.retrievers.multi_query import MultiQueryRetriever logging.basicConfig() logger = logging.getLogger("langchain.retrievers.multi_query") logger.setLevel(logging.INFO) |
■ getLogger 함수를 사용해 Logger 객체를 구하는 방법을 보여준다. ▶ 예제 코드 (PY)
|
1 2 3 4 5 6 7 8 9 |
import logging from langchain.retrievers.multi_query import MultiQueryRetriever logging.basicConfig() logger = logging.getLogger("langchain.retrievers.multi_query") |
■ basicConfig 함수를 사용해 WARNING 이하 메시지 출력을 방지하는 방법을 보여준다. ▶ 예제 코드 (PY)
|
1 2 3 4 5 |
import logging logging.basicConfig(level = logging.ERROR) |
■ basicConfig 함수를 사용해 로그 레벨을 설정하는 방법을 보여준다. • logging은 파이썬의 로깅 기능이다. • logging을 이용하면 출력 대상(표준 추력/파일)과 출력 레벨(DEBUG/WARNING/INFO/ERROR)을
■ LogEventInfo 클래스의 Properties 속성을 사용해 로그 데이터를 전달하는 방법을 보여준다. ▶ NLog.config
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="www.w3.org/2001/XMLSchema-instance"> <targets> <target name="file" xsi:type="File" layout="${date:format=HH\:mm\:ss.fff}|${uppercase:${level}}|${message}${newline} ${event-properties:filePath}|L:${event-properties:lineNumber}|${event-properties:memberName} ${onexception:${newline}${exception:format=tostring}}" fileName=".\Log\TestProject.log" archiveFileName=".\Log\TestProject_{#}.log" maxArchiveFiles="14" archiveEvery="Day" archiveNumbering="DateAndSequence" archiveAboveSize="104857600" archiveDateFormat="yyyyMMdd" /> <target name="console" xsi:Type="ColoredConsole" layout="${date:format=HH\:mm\:ss.fff}|${uppercase:${level}}|${message}${newline} ${event-properties:filePath}|L:${event-properties:lineNumber}|${event-properties:memberName} ${onexception:${newline}${exception:format=tostring}}" /> <target name="eventlog" xsi:Type="EventLog" layout="${date:format=HH\:mm\:ss.fff}|${uppercase:${level}}|${message}${newline} ${event-properties:filePath}|L:${event-properties:lineNumber}|${event-properties:memberName} ${onexception:${newline}${exception:format=tostring}}" machineName="." log="Application" source="TestService" /> </targets> <rules> <logger name="*" minlevel="Debug" writeTo="file" /> <logger name="*" minlevel="Debug" wrtieTo="console" /> <logger name="*" minlevel="Debug" writeTo="eventlog" /> </rules> </nlog> |
▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 |
using System; using System.Runtime.CompilerServices; using NLog; namespace TestProject { /// <summary> /// 프로그램 /// </summary> class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Private #region 로거 Logger /// <summary> /// 로거 /// </summary> private static Logger _logger { get; set; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Private #region 로거 설정하기- SetLogger() /// <summary> /// 로거 설정하기 /// </summary> private static void SetLogger() { _logger = LogManager.GetCurrentClassLogger(); } #endregion #region 추적 로그 작성하기 - LogTrace(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 추적 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogTrace ( string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Trace, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 디버그 로그 작성하기 - LogDebug(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 디버그 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogDebug ( string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Debug, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 정보 로그 작성하기 - LogInfo(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 정보 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogInfo ( string message, [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0, [CallerMemberName] string memberName = "" ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Info, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 경고 로그 작성하기 - LogWarn(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 경고 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogWarn ( string message, [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0, [CallerMemberName] string memberName = "" ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Warn, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 에러 로그 작성하기 - LogError(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 에러 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogError ( string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Error, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 에러 로그 작성하기 - LogError(exception, message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 에러 로그 작성하기 /// </summary> /// <param name="exception">예외</param> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogError ( Exception exception, string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Error, null, message) { Exception = exception }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 치명적 에러 로그 작성하기 - LogFatal(message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 치명적 에러 로그 작성하기 /// </summary> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogFatal ( string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Fatal, null, message) { Exception = null }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 치명적 에러 로그 작성하기 - LogFatal(exception, message, sourceFilePath, sourceLineNumber, memberName) /// <summary> /// 치명적 에러 로그 작성하기 /// </summary> /// <param name="exception">예외</param> /// <param name="message">메시지</param> /// <param name="filePath">소스 파일 경로</param> /// <param name="lineNumber">소스 라인 번호</param> /// <param name="memberName">멤버명</param> private static void LogFatal ( Exception exception, string message, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0 ) { LogEventInfo logEventInfo = new LogEventInfo(LogLevel.Fatal, null, message) { Exception = exception }; logEventInfo.Properties["filePath" ] = sourceFilePath; logEventInfo.Properties["lineNumber"] = sourceLineNumber; logEventInfo.Properties["memberName"] = memberName; _logger.Log(logEventInfo); } #endregion #region 프로그램 시작하기 - Main() /// <summary> /// 프로그램 시작하기 /// </summary> private static void Main() { SetLogger(); LogTrace("추적 로그"); LogDebug("디버그 로그"); LogInfo("정보 로그"); LogWarn("경로 로그"); LogError("에러 로그"); LogError(new ArgumentNullException("test"), "에러 로그"); LogError("치명적 에러 로그"); LogError(new ArgumentNullException("test"), "치명적 에러 로그"); } #endregion } } |
TestProject.zip
■ NLog.config 파일을 포함 리소스로 사용하는 방법을 보여준다. ▶ NLog.config
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="www.w3.org/2001/XMLSchema-instance"> <targets> <target name="file" xsi:type="File" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" fileName=".\Logs\Updater.log" archiveFileName=".\Logs\Updater_{#}.log" maxArchiveFiles="14" archiveEvery="Day" archiveNumbering="DateAndSequence" archiveAboveSize="104857600" archiveDateFormat="yyyyMMdd" /> <target name="console" xsi:Type="ColoredConsole" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" /> <target name="eventlog" xsi:Type="EventLog" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" machineName="." log="Application" source="TestService" /> </targets> <rules> <logger name="*" minlevel="Debug" writeTo="file" /> <logger name="*" minlevel="Debug" wrtieTo="console" /> <logger name="*" minlevel="Debug" writeTo="eventlog" /> </rules> </nlog> |
※ 상기 파일 속성을 아래와 같이 설정한다. 빌드 작업 : 포함
■ NLOG를 사용하는 방법을 보여준다. ▶ NLog.config
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="www.w3.org/2001/XMLSchema-instance"> <targets> <target name="file" xsi:type="File" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" fileName=".\Logs\Updater.log" archiveFileName=".\Logs\Updater_{#}.log" maxArchiveFiles="14" archiveEvery="Day" archiveNumbering="DateAndSequence" archiveAboveSize="104857600" archiveDateFormat="yyyyMMdd" /> <target name="console" xsi:Type="ColoredConsole" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" /> <target name="eventlog" xsi:Type="EventLog" layout="${date:format=HH\:mm\:ss.fff} | ${uppercase:${level:padding=-5}} | ${logger} | ${message}${onexception:${newline}${exception:format=tostring}}" machineName="." log="Application" source="TestService" /> </targets> <rules> <logger name="*" minlevel="Debug" writeTo="file" /> <logger name="*" minlevel="Debug" wrtieTo="console" /> <logger name="*" minlevel="Debug" writeTo="eventlog" /> </rules> </nlog> |
※ 상기 파일 속성을 아래와 같이 설정한다. 빌드 작업 : (없음) 출력 디렉터리에 복사
■ ILoggerProvider 인터페이스에서 커스텀 로그 기록기 공급자를 사용하는 방법을 보여준다. ▶ Log/ColorConsoleLoggerConfiguration.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 |
using Microsoft.Extensions.Logging; using System; namespace TestProject.Log { /// <summary> /// 색상 콘솔 로그 기록기 구성 /// </summary> public class ColorConsoleLoggerConfiguration { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 로그 레벨 - LogLevel /// <summary> /// 로그 레벨 /// </summary> public LogLevel LogLevel { get; set; } = LogLevel.Warning; #endregion #region 이벤트 ID - EventID /// <summary> /// 이벤트 ID /// </summary> public int EventID { get; set; } = 0; #endregion #region 색상 - Color /// <summary> /// 색성 /// </summary> public ConsoleColor Color { get; set; } = ConsoleColor.Yellow; #endregion } } |
▶ Log/ColorConsoleLogger.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 |
using Microsoft.Extensions.Logging; using System; namespace TestProject.Log { /// <summary> /// 색상 콘솔 로그 기록기 /// </summary> public class ColorConsoleLogger : ILogger { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 명칭 /// </summary> private readonly string name; /// <summary> /// 구성 /// </summary> private readonly ColorConsoleLoggerConfiguration configuration; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - ColorConsoleLogger(name, configuration) /// <summary> /// 생성자 /// </summary> /// <param name="name">명칭</param> /// <param name="configuration">구성</param> public ColorConsoleLogger(string name, ColorConsoleLoggerConfiguration configuration) { this.name = name; this.configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 범위 시작하기 - BeginScope<TState>(state) /// <summary> /// 범위 시작하기 /// </summary> /// <typeparam name="TState">상태 타입</typeparam> /// <param name="state">상태</param> /// <returns>리소스 해제 인터페이스</returns> public IDisposable BeginScope<TState>(TState state) { return null; } #endregion #region 이용 가능 여부 구하기 - IsEnabled(logLevel) /// <summary> /// 이용 가능 여부 구하기 /// </summary> /// <param name="logLevel">로그 레벨</param> /// <returns>이용 가능 여부</returns> public bool IsEnabled(LogLevel logLevel) { return logLevel == this.configuration.LogLevel; } #endregion #region 로그 기록하기 - Log<TState>(logLevel, eventID, state, exception, formatter) /// <summary> /// 로그 기록하기 /// </summary> /// <typeparam name="TState">상태 타입</typeparam> /// <param name="logLevel">로그 레벨</param> /// <param name="eventID">이벤트 ID</param> /// <param name="state">상태</param> /// <param name="exception">예외</param> /// <param name="formatter">포매터</param> public void Log<TState> ( LogLevel logLevel, EventId eventID, TState state, Exception exception, Func<TState, Exception, string> formatter ) { if(!IsEnabled(logLevel)) { return; } if(this.configuration.EventID == 0 || this.configuration.EventID == eventID.Id) { ConsoleColor color = Console.ForegroundColor; Console.ForegroundColor = this.configuration.Color; Console.WriteLine($"{logLevel} - {eventID.Id} " + $"- {this.name} - {formatter(state, exception)}"); Console.ForegroundColor = color; } } #endregion } } |
▶ Log/ColorConsoleLoggerProvider.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
using Microsoft.Extensions.Logging; using System.Collections.Concurrent; namespace TestProject.Log { /// <summary> /// 색상 콘솔 로기 기록기 제공자 /// </summary> public class ColorConsoleLoggerProvider : ILoggerProvider { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 구성 /// </summary> private readonly ColorConsoleLoggerConfiguration configuration; /// <summary> /// 로그 기록기 딕셔너리 /// </summary> private readonly ConcurrentDictionary<string, ColorConsoleLogger> dictionary = new ConcurrentDictionary<string, ColorConsoleLogger>(); #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - ColorConsoleLoggerProvider(configuration) /// <summary> /// 생성자 /// </summary> /// <param name="configuration">구성</param> public ColorConsoleLoggerProvider(ColorConsoleLoggerConfiguration configuration) { this.configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 로그 기록기 생성하기 - CreateLogger(categoryName) /// <summary> /// 로그 기록기 생성하기 /// </summary> /// <param name="categoryName">카테고리명</param> /// <returns>로그 기록기</returns> public ILogger CreateLogger(string categoryName) { return this.dictionary.GetOrAdd(categoryName, name => new ColorConsoleLogger(name, this.configuration)); } #endregion #region 리소스 해제하기 - Dispose() /// <summary> /// 리소스 해제하기 /// </summary> public void Dispose() { this.dictionary.Clear(); } #endregion } } |
▶ Log/ColorConsoleLoggerExtension.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
using Microsoft.Extensions.Logging; using System; namespace TestProject.Log { /// <summary> /// 색상 콘솔 로그 기록기 확장 /// </summary> public static class ColorConsoleLoggerExtension { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 색상 콘솔 로그 기록기 추가하기 - AddColorConsoleLogger(loggerFactory, configuration) /// <summary> /// 색상 콘솔 로그 기록기 추가하기 /// </summary> /// <param name="loggerFactory">로그 기록기 팩토리</param> /// <param name="configuration">구성</param> /// <returns>로그 기록기 팩토리</returns> public static ILoggerFactory AddColorConsoleLogger ( this ILoggerFactory loggerFactory, ColorConsoleLoggerConfiguration configuration ) { loggerFactory.AddProvider(new ColorConsoleLoggerProvider(configuration)); return loggerFactory; } #endregion #region 색상 콘솔 로그 기록기 추가하기 - AddColorConsoleLogger(loggerFactory) /// <summary> /// 색상 콘솔 로그 기록기 추가하기 /// </summary> /// <param name="loggerFactory">로그 기록기 팩토리</param> /// <returns>로그 기록기 팩토리</returns> public static ILoggerFactory AddColorConsoleLogger(this ILoggerFactory loggerFactory) { ColorConsoleLoggerConfiguration configuration = new ColorConsoleLoggerConfiguration(); return loggerFactory.AddColorConsoleLogger(configuration); } #endregion #region 색상 콘솔 로그 기록기 추가하기 - AddColorConsoleLogger(loggerFactory, configure) /// <summary> /// 색상 콘솔 로그 기록기 추가하기 /// </summary> /// <param name="loggerFactory">로그 기록기 팩토리</param> /// <param name="configure">구성 액션</param> /// <returns>로그 기록기 팩토리</returns> public static ILoggerFactory AddColorConsoleLogger ( this ILoggerFactory loggerFactory, Action<ColorConsoleLoggerConfiguration> configure ) { ColorConsoleLoggerConfiguration configuration = new ColorConsoleLoggerConfiguration(); configure(configuration); return loggerFactory.AddColorConsoleLogger(configuration); } #endregion } } |
■ FilterLoggingBuilderExtensions 클래스의 AddFilter 확장 메소드를 사용해 로그 필터를 추가하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; using Microsoft.Extensions.Logging.Console; using Microsoft.Extensions.Logging.Debug; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { CreateHostBuilder(argumentArray).Build().Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureLogging ( logging => { logging.AddFilter("System", LogLevel.Debug); logging.AddFilter<DebugLoggerProvider>("Microsoft", LogLevel.Information); logging.AddFilter<ConsoleLoggerProvider>("Microsoft", LogLevel.Trace); } ) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
■ ILogger<T> 인터페이스를 사용해 Startup 클래스의 Configure 메소드에서 로그를 사용하는 방법을 보여준다. ▶ Startup.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 |
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 시작 /// </summary> public class Startup { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 구성 - Configuration /// <summary> /// 구성 /// </summary> public IConfiguration Configuration { get; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - Startup(configuration) /// <summary> /// 생성자 /// </summary> /// <param name="configuration">구성</param> public Startup(IConfiguration configuration) { Configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 서비스 컬렉션 구성하기 - ConfigureServices(services) /// <summary> /// 서비스 컬렉션 구성하기 /// </summary> /// <param name="services">서비스 컬렉션</param> public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(); } #endregion #region 구성하기 - Configure(app, environment, logger) /// <summary> /// 구성하기 /// </summary> /// <param name="app">애플리케이션 빌더</param> /// <param name="environment">웹 호스트 환경</param> /// <param name="logger">로그 기록기</param> public void Configure(IApplicationBuilder app, IWebHostEnvironment environment, ILogger<Startup> logger) { if(environment.IsDevelopment()) { logger.LogInformation("IN DEVELOPMENT"); app.UseDeveloperExceptionPage(); } else { logger.LogInformation("NOT DEVELOPMENT"); app.UseExceptionHandler("/Home/Error"); app.UseHsts(); } app.UseHttpsRedirection(); app.UseStaticFiles(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints ( endpoints => { endpoints.MapControllerRoute ( name : "default", pattern : "{controller=Home}/{action=Index}/{id?}" ); } ); } #endregion } } |
■ ILogger<T> 인터페이스를 사용해 Program 클래스의 Main 정적 메소드에서 로그를 사용하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { IHost host = CreateHostBuilder(argumentArray).Build(); ILogger<Program> logger = host.Services.GetRequiredService<ILogger<Program>>(); logger.LogInformation("HOST CREATED"); host.Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
■ ILogger<T> 인터페이스를 사용해 ILogger<T> 인터페이스에 종속되는 서비스를 구성하는 방법을 보여준다. ▶ Services/ITestService.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
namespace TestProject.Services { /// <summary> /// 테스트 서비스 인터페이스 /// </summary> public interface ITestService { //////////////////////////////////////////////////////////////////////////////////////////////////// Method #region 처리하기 - Process() /// <summary> /// 처리하기 /// </summary> void Process(); #endregion } } |
▶ Services/TestService.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
using Microsoft.Extensions.Logging; namespace TestProject.Services { /// <summary> /// 테스트 서비스 /// </summary> public class TestService : ITestService { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 로그 기록기 /// </summary> private ILogger<TestService> logger; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestService(logger) /// <summary> /// 생성자 /// </summary> /// <param name="logger">로그 기록기</param> public TestService(ILogger<TestService> logger) { this.logger = logger; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 처리하기 - Process() /// <summary> /// 처리하기 /// </summary> public void Process() { this.logger.LogInformation("TEST SERVICE PROCESS"); } #endregion } } |
▶ Startup.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using TestProject.Services; namespace TestProject { /// <summary> /// 시작 /// </summary> public class Startup { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 구성 - Configuration /// <summary> /// 구성 /// </summary> public IConfiguration Configuration { get; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - Startup(configuration) /// <summary> /// 생성자 /// </summary> /// <param name="configuration">구성</param> public Startup(IConfiguration configuration) { Configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 서비스 컬렉션 구성하기 - ConfigureServices(services) /// <summary> /// 서비스 컬렉션 구성하기 /// </summary> /// <param name="services">서비스 컬렉션</param> public void ConfigureServices(IServiceCollection services) { services.AddSingleton<ITestService, TestService>(); services.AddControllersWithViews(); } #endregion #region 구성하기 - Configure(app, environment) /// <summary> /// 구성하기 /// </summary> /// <param name="app">애플리케이션 빌더</param> /// <param name="environment">웹 호스트 환경</param> public void Configure(IApplicationBuilder app, IWebHostEnvironment environment) { if(environment.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler("/Home/Error"); app.UseHsts(); } app.UseHttpsRedirection(); app.UseStaticFiles(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints ( endpoints => { endpoints.MapControllerRoute ( name : "default", pattern : "{controller=Home}/{action=Index}/{id?}" ); } ); } #endregion } } |
▶ Controllers/TestController.cs
■ ILogger<T> 인터페이스를 사용해 ILogger<T> 인터페이스에 종속되는 서비스를 구성하는 방법을 보여준다. ▶ Services/ITestService.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
namespace TestProject.Services { /// <summary> /// 테스트 서비스 인터페이스 /// </summary> public interface ITestService { //////////////////////////////////////////////////////////////////////////////////////////////////// Method #region 처리하기 - Process() /// <summary> /// 처리하기 /// </summary> void Process(); #endregion } } |
▶ Services/TestService.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
using Microsoft.Extensions.Logging; namespace TestProject.Services { /// <summary> /// 테스트 서비스 /// </summary> public class TestService : ITestService { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 로그 기록기 - Logger /// <summary> /// 로그 기록기 /// </summary> public ILogger<TestService> Logger { get; set; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestService() /// <summary> /// 생성자 /// </summary> public TestService() { } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 처리하기 - Process() /// <summary> /// 처리하기 /// </summary> public void Process() { Logger?.LogInformation("TEST SERVICE PROCESS"); } #endregion } } |
▶ Startup.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 |
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; using TestProject.Services; namespace TestProject { /// <summary> /// 시작 /// </summary> public class Startup { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 구성 - Configuration /// <summary> /// 구성 /// </summary> public IConfiguration Configuration { get; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - Startup(configuration) /// <summary> /// 생성자 /// </summary> /// <param name="configuration">구성</param> public Startup(IConfiguration configuration) { Configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 서비스 컬렉션 구성하기 - ConfigureServices(services) /// <summary> /// 서비스 컬렉션 구성하기 /// </summary> /// <param name="services">서비스 컬렉션</param> public void ConfigureServices(IServiceCollection services) { services.AddSingleton<ITestService> ( (container) => { ILogger<TestService> logger = container.GetRequiredService<ILogger<TestService>>(); return new TestService() { Logger = logger }; } ); services.AddControllersWithViews(); } #endregion #region 구성하기 - Configure(app, environment) /// <summary> /// 구성하기 /// </summary> /// <param name="app">애플리케이션 빌더</param> /// <param name="environment">웹 호스트 환경</param> public void Configure(IApplicationBuilder app, IWebHostEnvironment environment) { if(environment.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler("/Home/Error"); app.UseHsts(); } app.UseHttpsRedirection(); app.UseStaticFiles(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints ( endpoints => { endpoints.MapControllerRoute ( name : "default", pattern : "{controller=Home}/{action=Index}/{id?}" ); } ); } #endregion } } |
▶ Controllers/TestController.cs
■ 이벤트 로그를 사용하는 방법을 보여준다. ▶ appsettings.json
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
{ "Logging" : { "LogLevel" : { "Default" : "Information", "Microsoft" : "Warning", "Microsoft.Hosting.Lifetime" : "Information" }, "EventLog" : { "LogLevel" : { "Default" : "Information", "Microsoft" : "Warning", "Microsoft.Hosting.Lifetime" : "Information" } } }, "AllowedHosts" : "*" } |
▶ Controllers/TestController.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; namespace TestProject.Controllers { /// <summary> /// 테스트 컨트롤러 /// </summary> public class TestController : Controller { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 로그 기록기 /// </summary> private ILogger<TestController> logger; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestController(logger) /// <summary> /// 생성자 /// </summary> /// <param name="logger">로그 기록기</param> public TestController(ILogger<TestController> logger) { this.logger = logger; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 인덱스 페이지 처리하기 - Index() /// <summary> /// 인덱스 페이지 처리하기 /// </summary> /// <returns>액션 결과</returns> public IActionResult Index() { this.logger.LogInformation("테스트 로그 입니다."); return View(); } #endregion } } |
TestProject.zip
■ ILogger 인터페이스를 사용해 콘솔에서 로그를 생성하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Private #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> private static void Main(string[] argumentArray) { using var loggerFactory = LoggerFactory.Create ( builder => { builder .AddFilter("Microsoft" , LogLevel.Warning) .AddFilter("System" , LogLevel.Warning) .AddFilter("LoggingConsoleApp.Program", LogLevel.Debug ) .AddConsole() .AddEventLog(); } ); ILogger logger = loggerFactory.CreateLogger<Program>(); logger.LogInformation("테스트 로그 입니다."); } #endregion } } |
※ Microsoft.Extensions.Hosting 누겟 패키지를 설치한다. TestProject.zip
■ Microsoft.Extensions.Logging.EventLog 누겟을 설치하는 방법을 보여준다. 1. Visual Studio를 실행한다. 2. [도구] / [NuGet 패키지 관리자] / [패키지 관리자 콘솔] 메뉴를 실행한다.
■ ConsoleLoggerOptions 클래스의 IncludeScopes 속성을 사용해 로그 범위 활성화 여부를 설정하는 방법을 보여준다. ▶ appsettings.json
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
{ "Logging" : { "LogLevel" : { "Default" : "Information", "Microsoft" : "Warning", "Microsoft.Hosting.Lifetime" : "Information" } }, "AllowedHosts" : "*" } |
▶ appsettings.Development.json
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
{ "Logging" : { "LogLevel" : { "Default" : "Information", "Microsoft" : "Warning", "Microsoft.Hosting.Lifetime" : "Information" } } } |
▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { CreateHostBuilder(argumentArray).Build().Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureLogging ( (hostingContext, logging) => { logging.ClearProviders(); logging.AddConsole(options => options.IncludeScopes = true); logging.AddDebug(); } ) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
■ ILogger 인터페이스의 BeginScope 메소드를 사용해 로그 범위를 설정하는 방법을 보여준다. ▶ appsettings.json
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
{ "Logging" : { "Debug" : { "LogLevel" : { "Default" : "Information" } }, "Console" : { "IncludeScopes" : true, "LogLevel" : { "Microsoft" : "Warning", "Default" : "Information" } }, "LogLevel" : { "Default" : "Debug" } }, "AllowedHosts" : "*" } |
▶ appsettings.Development.json
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
{ "Logging" : { "Debug" : { "LogLevel" : { "Default" : "Information" } }, "Console" : { "IncludeScopes" : true, "LogLevel" : { "Microsoft" : "Warning", "Default" : "Information" } }, "LogLevel" : { "Default" : "Debug" } } } |
▶ Controllers/TestController.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 |
using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; namespace TestProject.Controllers { /// <summary> /// 테스트 컨트롤러 /// </summary> public class TestController : Controller { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 로그 기록기 /// </summary> private ILogger<TestController> logger; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestController(logger) /// <summary> /// 생성자 /// </summary> /// <param name="logger">로그 기록기</param> public TestController(ILogger<TestController> logger) { this.logger = logger; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 인덱스 페이지 처리하기 - Index() /// <summary> /// 인덱스 페이지 처리하기 /// </summary> /// <returns>액션 결과</returns> public IActionResult Index() { using(this.logger.BeginScope("PROCESS INDEX")) { this.logger.LogInformation(100, "BEGIN GET DATA"); // 데이터를 처리한다. this.logger.LogInformation(200, "END GET DATA"); } return View(); } #endregion } } |
TestProject.zip
■ FilterLoggingBuilderExtensions 클래스의 AddFilter 확장 메소드를 사용해 로그 필터를 설정하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { CreateHostBuilder(argumentArray).Build().Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureLogging ( logging => { logging.AddFilter ( (provider, category, logLevel) => { if(provider.Contains("ConsoleLoggerProvider") && category.Contains("Controller") && logLevel >= LogLevel.Information) { return true; } else if(provider.Contains("ConsoleLoggerProvider") && category.Contains("Microsoft") && logLevel >= LogLevel.Information) { return true; } else { return false; } } ); } ) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
■ LoggingBuilderExtensions 클래스의 SetMinimumLevel 확장 메소드를 사용해 기본 로그 수준을 설정하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { CreateHostBuilder(argumentArray).Build().Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureLogging ( logging => logging.SetMinimumLevel(LogLevel.Warning) ) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
※ 구성에 기본 로그 수준이 설정되어
■ LoggerExtensions 클래스의 Log 확장 메소드를 사용해 로그를 기록하는 방법을 보여준다. ▶ TestController.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; namespace TestProject.Controllers { /// <summary> /// 테스트 컨트롤러 /// </summary> public class TestController : Controller { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 로그 기록기 /// </summary> private readonly ILogger<TestController> logger; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestController(logger) /// <summary> /// 생성자 /// </summary> /// <param name="logger">로그 기록기</param> public TestController(ILogger<TestController> logger) { this.logger = logger; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 인덱스 페이지 처리하기 - Index() /// <summary> /// 인덱스 페이지 처리하기 /// </summary> /// <returns>액션 결과</returns> public IActionResult Index() { this.logger.Log(LogLevel.Information, 1000, "GET INDEX PAGE"); //this.logger.LogInformation(1000, "GET INDEX PAGE"); return View(); } #endregion } } |
■ ILoggerFactory 인터페이스의 CreateLogger 메소드를 사용해 명시적 범주를 설정하는 방법을 보여준다. ▶ TestController.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; namespace TestProject.Controllers { /// <summary> /// 테스트 컨트롤러 /// </summary> public class TestController : Controller { //////////////////////////////////////////////////////////////////////////////////////////////////// Field ////////////////////////////////////////////////////////////////////////////////////////// Private #region Field /// <summary> /// 로그 기록기 /// </summary> private readonly ILogger logger; #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - TestController(loggerFactory) /// <summary> /// 생성자 /// </summary> /// <param name="loggerFactory">로그 기록기 팩토리</param> public TestController(ILoggerFactory loggerFactory) { this.logger = loggerFactory.CreateLogger("TestCategory"); } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 인덱스 페이지 처리하기 - Index() /// <summary> /// 인덱스 페이지 처리하기 /// </summary> /// <returns>액션 결과</returns> public IActionResult Index() { this.logger.LogInformation("GET INDEX PAGE"); return View(); } #endregion } } |
■ HostingHostBuilderExtensions 클래스의 ConfigureLogging 확장 메소드를 사용해 콘솔 로그 기록기만 추가하는 방법을 보여준다. ▶ Program.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; namespace TestProject { /// <summary> /// 프로그램 /// </summary> public class Program { //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Static //////////////////////////////////////////////////////////////////////////////// Public #region 프로그램 시작하기 - Main(argumentArray) /// <summary> /// 프로그램 시작하기 /// </summary> /// <param name="argumentArray">인자 배열</param> public static void Main(string[] argumentArray) { CreateHostBuilder(argumentArray).Build().Run(); } #endregion #region 호스트 빌더 생성하기 - CreateHostBuilder(argumentArray) /// <summary> /// 호스트 빌더 생성하기 /// </summary> /// <param name="argumentArray">인자 배열</param> /// <returns>호스트 빌더</returns> public static IHostBuilder CreateHostBuilder(string[] argumentArray) => Host.CreateDefaultBuilder(argumentArray) .ConfigureLogging ( logging => { logging.ClearProviders(); logging.AddConsole(); } ) .ConfigureWebHostDefaults ( builder => { builder.UseStartup<Startup>(); } ); #endregion } } |
■ dotnet run 명령을 사용해 로그 환경 변수를 설정하고 프로그램을 실행하는 방법을 보여준다. 1. [명령 프롬프트]를 실행한다. 2. [명령 프롬프트]에서 아래 명령을
■ Microsoft.Extensions.Logging.Debug 누겟을 설치하는 방법을 보여준다. 1. Visual Studio를 실행한다. 2. [도구] / [NuGet 패키지 관리자] / [패키지 관리자 콘솔] 메뉴를 실행한다.