추적 URL <traceUrls>

아티클
07/19/2023

개요

<traceUrls> 요소는 요소의 <add> 컬렉션을 포함하며, 각 요소는 추적을 사용하도록 설정하는 URL을 정의합니다.

참고

ETW(Windows용 이벤트 추적)는 운영 체제에서 제공하는 범용 고속 추적 시설입니다. ETW는 커널에 구현된 버퍼링 및 로깅 메커니즘을 사용하여 사용자 모드 애플리케이션과 커널 모드 디바이스 드라이버 모두에서 발생하는 이벤트에 대한 추적 메커니즘을 제공합니다. 또한 ETW를 사용하면 동적으로 로깅을 사용하거나 사용하지 않도록 설정할 수 있으므로 다시 부팅하거나 애플리케이션을 다시 시작하지 않고도 프로덕션 환경에서 자세한 추적을 쉽게 수행할 수 있습니다. 로깅 메커니즘은 비동기 기록기 스레드에 의해 디스크에 기록되는 프로세서별 버퍼를 사용합니다. 이를 통해 대규모 서버 애플리케이션은 최소한의 방해가 있는 이벤트를 작성할 수 있습니다.

호환성

버전	참고
IIS 10.0	`<traceUrls>` 요소가 IIS 10.0에서 수정되지 않았습니다.
IIS 8.5	`<traceUrls>` 요소가 IIS 8.5에서 수정되지 않았습니다.
IIS 8.0	`<traceUrls>` 요소가 IIS 8.0에서 수정되지 않았습니다.
IIS 7.5	`<traceUrls>` 요소가 IIS 7.5에서 수정되지 않았습니다.
IIS 7.0	`<traceUrls>` 컬렉션의 `<httpTracing>` 요소는 IIS 7.0에서 도입되었습니다.
IIS 6.0	해당 없음

설치 프로그램

<traceUrls> 컬렉션의 <httpTracing> 요소는 IIS 7의 기본 설치에 포함됩니다.

방법

IIS 7의 요소에 <httpTracing> 대한 사용자 인터페이스가 없습니다. 프로그래밍 방식으로 요소에 <httpTracing> 액세스하는 방법에 대한 예제는 이 문서의 코드 샘플 섹션을 참조하세요.

구성

특성

없음

자식 요소

요소	Description
`add`	선택적 요소입니다. 추적 URL 컬렉션에 추적 URL을 추가합니다.
`clear`	선택적 요소입니다. 추적 URL 컬렉션에서 추적 URL에 대한 모든 참조를 제거합니다.
`remove`	선택적 요소입니다. 추적 URL 컬렉션에서 추적 URL에 대한 참조를 제거합니다.

구성 샘플

다음 예제에서는 기본 웹 사이트의 루트에 있는 Web.config 파일에 배치할 때 IIS 7과 함께 제공되는 샘플 홈페이지에 대해 추적을 사용하도록 설정합니다.

<configuration>
   <system.webServer>
      <httpTracing>
         <traceUrls>
            <add value="/iisstart.htm" />
         </traceUrls>
      </httpTracing>
   </system.webServer>
</configuration>

샘플 코드

다음 예제에서는 해당 사이트의 컬렉션에 항목을 추가하여 Contoso라는 웹 사이트에서 IIS 7과 함께 제공되는 샘플 홈페이지에 대해 추적을 <traceUrls> 사용하도록 설정합니다.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/httpTracing /+"traceUrls.[value='/iisstart.htm']" /commit:apphost

참고

AppCmd.exe 사용하여 이러한 설정을 구성할 때 commit 매개 변수 apphost 를 로 설정해야 합니다. 그러면 구성 설정이 ApplicationHost.config 파일의 적절한 위치 섹션에 커밋됩니다.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection httpTracingSection = config.GetSection("system.webServer/httpTracing", "Contoso");
         ConfigurationElementCollection traceUrlsCollection = httpTracingSection.GetCollection("traceUrls");

         ConfigurationElement addElement = traceUrlsCollection.CreateElement("add");
         addElement["value"] = @"/iisstart.htm";
         traceUrlsCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim httpTracingSection As ConfigurationSection = config.GetSection("system.webServer/httpTracing", "Contoso")

      Dim traceUrlsCollection As ConfigurationElementCollection = httpTracingSection.GetCollection("traceUrls")
      Dim addElement As ConfigurationElement = traceUrlsCollection.CreateElement("add")
      addElement("value") = "/iisstart.htm"
      traceUrlsCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso");

var traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection;
var addElement = traceUrlsCollection.CreateNewElement("add");
addElement.Properties.Item("value").Value = "/iisstart.htm";
traceUrlsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set httpTracingSection = adminManager.GetAdminSection("system.webServer/httpTracing", "MACHINE/WEBROOT/APPHOST/Contoso")

Set traceUrlsCollection = httpTracingSection.ChildElements.Item("traceUrls").Collection
Set addElement = traceUrlsCollection.CreateNewElement("add")
addElement.Properties.Item("value").Value = "/iisstart.htm"
traceUrlsCollection.AddElement addElement

adminManager.CommitChanges()

다음을 통해 공유