追蹤 URL < traceUrls>
概觀
元素 <traceUrls>
包含元素的 <add>
集合,每個元素都會定義啟用追蹤的 URL。
注意
Windows (ETW 事件追蹤) 是作業系統所提供的一般用途高速追蹤設施。 ETW 會使用核心中實作的緩衝和記錄機制,為使用者模式應用程式和核心模式設備磁碟機所引發的事件提供追蹤機制。 此外,ETW 可讓您動態啟用和停用記錄,讓您輕鬆地在生產環境中執行詳細的追蹤,而不需要重新開機或應用程式重新開機。 記錄機制會使用非同步寫入器執行緒寫入磁片的每個處理器緩衝區。 這可讓大規模伺服器應用程式以最少的擷取方式撰寫事件。
相容性
版本 | 備註 |
---|---|
IIS 10.0 | 未在 IIS 10.0 中修改專案 <traceUrls> 。 |
IIS 8.5 | 未在 IIS 8.5 中修改專案 <traceUrls> 。 |
IIS 8.0 | 未在 IIS 8.0 中修改專案 <traceUrls> 。 |
IIS 7.5 | 未在 IIS 7.5 中修改專案 <traceUrls> 。 |
IIS 7.0 | <traceUrls> 集合的 <httpTracing> 元素是在 IIS 7.0 中引進。 |
IIS 6.0 | N/A |
安裝程式
<traceUrls>
集合的 <httpTracing>
元素包含在 IIS 7 的預設安裝中。
作法
IIS 7 的 元素沒有使用者介面 <httpTracing>
。 For examples of how to access the <httpTracing>
element programmatically, see the Code Samples section of this document.
組態
屬性
無。
子元素
元素 | 描述 |
---|---|
add |
選擇性項目。 將追蹤 URL 加入至追蹤 URL 的集合。 |
clear |
選擇性項目。 從追蹤 URL 集合中移除追蹤 URL 的所有參考。 |
remove |
選擇性項目。 從追蹤 URL 集合中移除追蹤 URL 的參考。 |
組態範例
下列範例會針對 IIS 7 隨附的範例首頁啟用追蹤,該範例會放在預設網站的根目錄中的Web.config檔案中。
<configuration>
<system.webServer>
<httpTracing>
<traceUrls>
<add value="/iisstart.htm" />
</traceUrls>
</httpTracing>
</system.webServer>
</configuration>
範例程式碼
下列範例會藉由將專案新增至 <traceUrls>
該網站的集合,啟用 Contoso 網站上 IIS 7 隨附之範例首頁的追蹤。
AppCmd.exe
appcmd.exe set config "Contoso" -section:system.webServer/httpTracing /+"traceUrls.[value='/iisstart.htm']" /commit:apphost
注意
當您使用 AppCmd.exe 來設定這些設定時,請務必將 認可 參數 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()