로그를 기록하기 위해서는 로그를 기록할 장치에 대한 정보를 필요로 합니다. 로그를 기록하는 역할을 담당하는 기록기에서 직접 해당 정보를 받을 수도 있지만, 프레임워크에서 제공하는 Configuration 구성요소를 사용하면 App.config 또는 Web.config 에서 로그에 대한 환경을 명시적으로 설정하고 시스템 전체에 걸쳐 사용을 할 수 있게 됩니다.

App.config 혹은 Web.config 설정

<configSections> <section name="GlobalSection" type="Devpia.DFX.Tutorial.Web.GlobalConfigSection, Devpia.DFX.Tutorial.Web" /> </configSections> <GlobalSection> <!-- 로그에 대한 설정 부분 --> <LogGroup> <!-- 파일 로그 설정 --> <FileLog name="FLog" repositoryPath="" filenameFormat="DEXTFramework_{0}" extensionName="log" datetimeFormat="yyyyMMdd" savingOption="Dividing" /> <!-- Windows Event 로그 설정 --> <EventLog name="ELog" source="DEXTFramework" logName="DEXTFramework_information" machine="."/> <!-- E-mail 로그 설정 --> <EmailLog name="MLog" server="localhost" port="25" fromAddress="syslogger@localhost" fromName="System Logger" useHtml="true" credAccount="" credPassword=""> <Receivers> <add name="rcv01" rcvAddress="user01@DEXTFramework.com" rcvName="User01" rcvType="To"/> <add name="rcv02" rcvAddress="user02@DEXTFramework.com" rcvName="User02" rcvType="Cc"/> <add name="rcv03" rcvAddress="user03@DEXTFramework.com" rcvName="User03" rcvType="Bcc"/> </Receivers> </EmailLog> </LogGroup> </GlobalSection>

GlobalSection 구성을 읽기 위해서 GlobalConfiguration 클래스를 생성합니다.

GlobalConfiguration

public class GlobalConfiguration : BaseConfigSection { [ConfigurationProperty("LogGroup")] public LogConfigurationGroup LogGroup { get { return (LogConfigurationGroup)this["LogGroup"]; } set { this["LogGroup"] = value; } } public static GlobalConfiguration GetConfig(string sectionName) { GlobalConfiguration config = ConfigurationManager.GetSection(sectionName) as GlobalConfiguration; return config; } }

로그 구성 정보를 가져오는 소스입니다.

소스코드

GlobalConfiguration conf = GlobalConfiguration.GetConfig("GlobalSection"); StringBuilder sb = new StringBuilder(); sb.Append("파일 기반 로그 환경 정보<br/>"); FileLogConfiguration fconf = conf.LogGroup.FileLog; sb.AppendFormat("파일 로그 정보 기반 로그 파일명: {0}<br/>", fconf.GetLogFilePath(DateTime.Now, DEXTFramework.Diagnostics.Log.LogType.Error)); sb.Append("<br/>윈도우 이벤트 로그 기반 환경 정보<br/>"); EventLogConfiguration weconf = conf.LogGroup.EventLog; sb.AppendFormat("SOURCE: {0}<br/>LOG-NAME: {1}<br/>MACHINE: {2}<br/>", weconf.Source, weconf.LogName, weconf.Machine); sb.Append("<br/>E-mail 기반 환경 정보<br/>"); EmailLogConfiguration mconf = conf.LogGroup.EmailLog; sb.AppendFormat( "서버: {0}<br/>포트번호: {1}<br/>발신자주소: {2}<br/>발신자이름: {3}<br/> HTML사용여부: {4}", mconf.Server, mconf.Port, mconf.FromAddress, mconf.FromName, mconf.UseHtml); foreach (EmailLogConfiguration.EmailReceiverConfiguration rcv in mconf.Receivers) { sb.AppendFormat("사용자 정보<br/>주소:{0} 이름:{1} 타입:{2}", rcv.ReceiverAddress, rcv.ReceiverName, rcv.ReceiverType); } sb.Append("<br/><br/>메시지 큐 기반 환경 정보<br/>"); MessageQueueLogConfiguration qconf = conf.LogGroup.MsmqLog; sb.AppendFormat(string.Format("MSMQ Path:{0}", qconf.Path)); LblConfig.Text = sb.ToString();

<FileLog> 구성요소 정보

• repositoryPath: 로그 정보가 기록될 파일의 저장 위치입니다.
• filenameFormat: 로그 파일 이름의 한 부분으로써 {0} 자리에 datetimeFormat 값이 대치됩니다.
• extensionName: 로그 파일의 확장자명입니다.
• datetimeFormat: 로그 파일 이름의 한 부분으로써 로그가 기록되는 일자를 나타내기도 하며, 로그 파일을 분리하는 기준이 됩니다.
• savingOption: 로그타입(Error, Warning, Information)에 따른 파일 분리 정책
  • Sharing: 로그 타입에 상관없이 하나의 파일에 기록됩니다.
  • Dividing: 로그 타입에 따라 파일이 분리됩니다.

<EventLog> 구성요소 정보

• source: 로그를 기록하는 대상이 되는 Source 이름입니다.
• logName: 윈도우 이벤트 로그를 구분짓는 로그 이름입니다.
• machine: 로그를 기록하는 대상이 되는 머신(서버) 이름입니다. '.' 문자는 localhost를 나타냅니다.

# 윈도우 이벤트 로그는 로그타입과 상관없이 하나의 로그에 기록이 됩니다. 다만 로그 타입에 따라 이벤트 로그 종류값을 다르게 쓰기때문에 이벤트 뷰어에서 필터링을 걸어 타입에 따라 리스팅이 가능합니다.

<MailLog> 구성요소 정보

• server: SMTP 서버
• port: SMTP 서버 포트
• fromAddress: 발신자 e-mail 주소
• fromName: 발신자 대표명
• useHtml: 본문 HTML 사용여부[true|false]
• credAccount: 인증 필요 시 사용자 계정
• credPassword: 인증 필요 시 사용자 비밀번호
• Receivers: 로그 정보를 받을 대상
  • rcvAddress: 받는 e-mail 주소
  • rcvName: 받는 사람 대표명
  • rcvType: 발송 타입[To|Cc|Bcc]