방법: 추적 소스 생성 및 초기화

비고

이 문서는 .NET Framework에만 적용됩니다. .NET 6 이상 버전을 포함하여 .NET의 최신 구현에는 적용되지 않습니다.

이 TraceSource 클래스는 애플리케이션에서 애플리케이션과 연결할 수 있는 추적을 생성하는 데 사용됩니다. TraceSource 에서는 이벤트를 쉽게 추적하고, 데이터를 추적하고, 정보 추적을 실행할 수 있는 추적 메서드를 제공합니다. 추적 출력은 TraceSource 구성 파일을 사용하거나 사용하지 않고 만들거나 초기화할 수 있습니다. 이 항목에서는 두 옵션 모두에 대한 지침을 제공합니다. 그러나 구성 파일을 사용하여 런타임에 추적 원본에서 생성된 추적을 쉽게 재구성하는 것이 좋습니다.

구성 파일을 사용하여 추적 원본을 만들고 초기화하려면

1. Visual Studio 콘솔 애플리케이션 프로젝트(.NET Framework)를 만들고 제공된 코드를 다음 코드로 바꿉니다. 이 코드는 오류 및 경고를 기록하고 그 중 일부를 콘솔에 출력하며, 그 중 일부는 구성 파일의 항목에 의해 생성된 myListener 파일에 출력됩니다.

   using System;
   using System.Diagnostics;
   
   class TraceTest
   {
   
       private static TraceSource mySource =
               new TraceSource("TraceSourceApp");
           static void Main(string[] args)
           {
              // Issue an error and a warning message. Only the error message
               // should be logged.
               Activity1();
   
               // Save the original settings from the configuration file.
               EventTypeFilter configFilter =
                   (EventTypeFilter)mySource.Listeners["console"].Filter;
   
               // Create a new event type filter that ensures
               // warning messages will be written.
               mySource.Listeners["console"].Filter =
                   new EventTypeFilter(SourceLevels.Warning);
   
               // Allow the trace source to send messages to listeners
               // for all event types. This statement will override
               // any settings in the configuration file.
               // If you do not change the switch level, the event filter
               // changes have no effect.
               mySource.Switch.Level = SourceLevels.All;
   
               // Issue a warning and a critical message. Both should be logged.
               Activity2();
   
               // Restore the original filter settings.
               mySource.Listeners["console"].Filter = configFilter;
               Activity3();
               mySource.Close();
               return;
           }
           static void Activity1()
           {
               mySource.TraceEvent(TraceEventType.Error, 1,
                   "Error message.");
               mySource.TraceEvent(TraceEventType.Warning, 2,
                   "Warning message.");
           }
           static void Activity2()
           {
               mySource.TraceEvent(TraceEventType.Critical, 3,
                   "Critical message.");
               mySource.TraceEvent(TraceEventType.Warning, 2,
                   "Warning message.");
           }
           static void Activity3()
           {
               mySource.TraceEvent(TraceEventType.Error, 4,
                   "Error message.");
               mySource.TraceInformation("Informational message.");
           }
       }
   

   Imports System.Diagnostics
   
   Class TraceTest
   
       Private Shared mySource As New TraceSource("TraceSourceApp")
   
       Shared Sub Main(ByVal args() As String)
           ' Issue an error and a warning message. Only the error message
           ' should be logged.
           Activity1()
   
           ' Save the original settings from the configuration file.
           Dim configFilter As EventTypeFilter = CType(mySource.Listeners("console").Filter, EventTypeFilter)
   
           ' Create a new event type filter that ensures 
           ' warning messages will be written.
           mySource.Listeners("console").Filter = New EventTypeFilter(SourceLevels.Warning)
   
           ' Allow the trace source to send messages to listeners 
           ' for all event types. This statement will override 
           ' any settings in the configuration file.
           ' If you do not change the switch level, the event filter
           ' changes have no effect.
           mySource.Switch.Level = SourceLevels.All
   
           ' Issue a warning and a critical message. Both should be logged.
           Activity2()
   
           ' Restore the original filter settings.
           mySource.Listeners("console").Filter = configFilter
           Activity3()
           mySource.Close()
           Return
   
       End Sub
   
       Shared Sub Activity1()
           mySource.TraceEvent(TraceEventType.Error, 1, "Error message.")
           mySource.TraceEvent(TraceEventType.Warning, 2, "Warning message.")
   
       End Sub
   
       Shared Sub Activity2()
           mySource.TraceEvent(TraceEventType.Critical, 3, "Critical message.")
           mySource.TraceEvent(TraceEventType.Warning, 2, "Warning message.")
   
       End Sub
   
       Shared Sub Activity3()
           mySource.TraceEvent(TraceEventType.Error, 4, "Error message.")
           mySource.TraceInformation("Informational message.")
   
       End Sub
   End Class
   

2. 애플리케이션 구성 파일이 없는 경우 프로젝트에 추가하여 1단계의 코드 예제에서 명명된 TraceSourceApp 추적 원본을 초기화합니다.

3. 1단계에서 만든 추적 원본에 대한 콘솔 추적 수신기 및 텍스트 기록기 추적 수신기를 초기화하려면 기본 구성 파일 콘텐츠를 다음 설정으로 바꿉니다.

   <configuration>
     <system.diagnostics>
       <sources>
         <source name="TraceSourceApp"
           switchName="sourceSwitch"
           switchType="System.Diagnostics.SourceSwitch">
           <listeners>
             <add name="console"
               type="System.Diagnostics.ConsoleTraceListener">
               <filter type="System.Diagnostics.EventTypeFilter"
                 initializeData="Error"/>
             </add>
             <add name="myListener"/>
             <remove name="Default"/>
           </listeners>
         </source>
       </sources>
       <switches>
         <add name="sourceSwitch" value="Error"/>
       </switches>
       <sharedListeners>
         <add name="myListener"
           type="System.Diagnostics.TextWriterTraceListener"
           initializeData="myListener.log">
           <filter type="System.Diagnostics.EventTypeFilter"
             initializeData="Error"/>
         </add>
       </sharedListeners>
     </system.diagnostics>
   </configuration>
   

   추적 수신기를 구성하는 것 외에도 구성 파일은 두 수신기 모두에 대한 필터를 만들고 추적 원본에 대한 원본 스위치를 만듭니다. 추적 수신기를 추가하는 두 가지 기술이 표시됩니다. 즉, 추적 원본에 수신기를 직접 추가하고 공유 수신기 컬렉션에 수신기를 추가한 다음 이름으로 추적 원본에 추가합니다. 두 수신기에 대해 식별된 필터는 서로 다른 소스 수준으로 초기화됩니다. 이로 인해 일부 메시지는 두 수신기 중 하나에서만 작성됩니다.

   구성 파일은 애플리케이션이 초기화될 때 추적 원본에 대한 설정을 초기화합니다. 애플리케이션은 구성 파일에서 설정한 속성을 동적으로 변경하여 사용자가 지정한 설정을 재정의할 수 있습니다. 예를 들어 현재 구성 설정에 관계없이 중요한 메시지가 항상 텍스트 파일로 전송되도록 할 수 있습니다. 예제 코드는 구성 파일 설정을 재정의하여 중요한 메시지가 추적 수신기에 출력되도록 하는 방법을 보여 줍니다.

   애플리케이션이 실행되는 동안 구성 파일 설정을 변경해도 초기 설정은 변경되지 않습니다. 설정을 변경하려면 애플리케이션을 다시 시작하거나 메서드를 사용하여 Trace.Refresh 프로그래밍 방식으로 애플리케이션을 새로 고쳐야 합니다.

구성 파일 없이 추적 원본, 수신기 및 필터를 초기화하려면

• 다음 예제 코드를 사용하여 구성 파일을 사용하지 않고 추적 원본을 추적할 수 있습니다. 권장되는 방법은 아니지만 추적을 보장하기 위해 구성 파일에 의존하지 않으려는 경우가 있을 수 있습니다.

  using System;
  using System.Diagnostics;
  using System.Threading;
  
  namespace TraceSourceApp
  {
      class Program
      {
          private static TraceSource mySource =
              new TraceSource("TraceSourceApp");
          static void Main(string[] args)
          {
              mySource.Switch = new SourceSwitch("sourceSwitch", "Error");
              mySource.Listeners.Remove("Default");
              TextWriterTraceListener textListener =
                  new TextWriterTraceListener("myListener.log");
              ConsoleTraceListener console =
                  new ConsoleTraceListener(false);
              console.Filter =
                  new EventTypeFilter(SourceLevels.Information);
              console.Name = "console";
              textListener.Filter =
                  new EventTypeFilter(SourceLevels.Error);
              mySource.Listeners.Add(console);
              mySource.Listeners.Add(textListener);
              Activity1();
  
              // Allow the trace source to send messages to
              // listeners for all event types. Currently only
              // error messages or higher go to the listeners.
              // Messages must get past the source switch to
              // get to the listeners, regardless of the settings
              // for the listeners.
              mySource.Switch.Level = SourceLevels.All;
  
              // Set the filter settings for the
              // console trace listener.
              mySource.Listeners["console"].Filter =
                  new EventTypeFilter(SourceLevels.Critical);
              Activity2();
  
              // Change the filter settings for the console trace listener.
              mySource.Listeners["console"].Filter =
                  new EventTypeFilter(SourceLevels.Information);
              Activity3();
              mySource.Close();
              return;
          }
          static void Activity1()
          {
              mySource.TraceEvent(TraceEventType.Error, 1,
                  "Error message.");
              mySource.TraceEvent(TraceEventType.Warning, 2,
                  "Warning message.");
          }
          static void Activity2()
          {
              mySource.TraceEvent(TraceEventType.Critical, 3,
                  "Critical message.");
              mySource.TraceInformation("Informational message.");
          }
          static void Activity3()
          {
              mySource.TraceEvent(TraceEventType.Error, 4,
                  "Error message.");
              mySource.TraceInformation("Informational message.");
          }
      }
  }
  
  

  Imports System.Diagnostics
  Imports System.Threading
  
  
  
  Class Program
      Private Shared mySource As New TraceSource("TraceSourceApp")
  
      Shared Sub Main(ByVal args() As String)
          mySource.Switch = New SourceSwitch("sourceSwitch", "Error")
          mySource.Listeners.Remove("Default")
          Dim textListener As New TextWriterTraceListener("myListener.log")
          Dim console As New ConsoleTraceListener(False)
          console.Filter = New EventTypeFilter(SourceLevels.Information)
          console.Name = "console"
          textListener.Filter = New EventTypeFilter(SourceLevels.Error)
          mySource.Listeners.Add(console)
          mySource.Listeners.Add(textListener)
          Activity1()
  
          ' Allow the trace source to send messages to 
          ' listeners for all event types. Currently only 
          ' error messages or higher go to the listeners.
          ' Messages must get past the source switch to 
          ' get to the listeners, regardless of the settings 
          ' for the listeners.
          mySource.Switch.Level = SourceLevels.All
  
          ' Set the filter settings for the 
          ' console trace listener.
          mySource.Listeners("console").Filter = New EventTypeFilter(SourceLevels.Critical)
          Activity2()
  
          ' Change the filter settings for the console trace listener.
          mySource.Listeners("console").Filter = New EventTypeFilter(SourceLevels.Information)
          Activity3()
          mySource.Close()
          Return
  
      End Sub
  
      Shared Sub Activity1()
          mySource.TraceEvent(TraceEventType.Error, 1, "Error message.")
          mySource.TraceEvent(TraceEventType.Warning, 2, "Warning message.")
  
      End Sub
  
      Shared Sub Activity2()
          mySource.TraceEvent(TraceEventType.Critical, 3, "Critical message.")
          mySource.TraceInformation("Informational message.")
  
      End Sub
  
      Shared Sub Activity3()
          mySource.TraceEvent(TraceEventType.Error, 4, "Error message.")
          mySource.TraceInformation("Informational message.")
  
      End Sub
  End Class
  
  

참고하십시오

• TraceSource
• TextWriterTraceListener
• ConsoleTraceListener
• EventTypeFilter
• 추적 및 계측 애플리케이션