Lacak <URL traceUrls>

Artikel
07/19/2023

Gambaran Umum

Elemen <traceUrls> berisi kumpulan <add> elemen, yang masing-masing mendefinisikan URL untuk mengaktifkan pelacakan.

Catatan

Pelacakan Peristiwa untuk Windows (ETW) adalah fasilitas pelacakan berkecepatan tinggi tujuan umum yang disediakan oleh sistem operasi. Menggunakan mekanisme buffering dan pengelogan yang diterapkan dalam kernel, ETW menyediakan mekanisme pelacakan untuk peristiwa yang diangkat oleh aplikasi mode pengguna dan driver perangkat mode kernel. Selain itu, ETW memberi Anda kemampuan untuk mengaktifkan dan menonaktifkan pengelogan secara dinamis, sehingga mudah untuk melakukan pelacakan terperinci di lingkungan produksi tanpa memerlukan boot ulang atau mulai ulang aplikasi. Mekanisme pengelogan menggunakan buffer per prosesor yang ditulis ke disk oleh utas penulis asinkron. Ini memungkinkan aplikasi server skala besar untuk menulis peristiwa dengan gangguan minimum.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen `<traceUrls>` tidak dimodifikasi di IIS 10.0.
IIS 8.5	Elemen `<traceUrls>` tidak dimodifikasi di IIS 8.5.
IIS 8.0	Elemen `<traceUrls>` tidak dimodifikasi di IIS 8.0.
IIS 7.5	Elemen `<traceUrls>` tidak dimodifikasi dalam IIS 7.5.
IIS 7.0	Elemen `<traceUrls><httpTracing>` koleksi diperkenalkan di IIS 7.0.
IIS 6.0	T/A

Siapkan

Elemen <traceUrls><httpTracing> koleksi disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Tidak ada antarmuka pengguna untuk <httpTracing> elemen untuk IIS 7. Untuk contoh cara mengakses <httpTracing> elemen secara terprogram, lihat bagian Sampel Kode dari dokumen ini.

Konfigurasi

Atribut

Tidak ada.

Elemen Anak

Elemen	Deskripsi
`add`	Elemen opsional. Menambahkan URL pelacakan ke kumpulan URL pelacakan.
`clear`	Elemen opsional. Menghapus semua referensi untuk melacak URL dari kumpulan URL pelacakan.
`remove`	Elemen opsional. Menghapus referensi ke URL pelacakan dari kumpulan URL pelacakan.

Sampel Konfigurasi

Contoh berikut akan mengaktifkan pelacakan untuk halaman beranda sampel yang dikirim dengan IIS 7 ketika ditempatkan dalam file Web.config di akar Situs Web Default.

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

Kode Sampel

Contoh berikut memungkinkan pelacakan untuk beranda sampel yang dikirim dengan IIS 7 di situs Web bernama Contoso dengan menambahkan entri ke kumpulan untuk situs tersebut <traceUrls> .

AppCmd.exe

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

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file 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()

Bagikan melalui