Bagikan melalui

Pelacakan pelacakan <>

  • Artikel

Gambaran Umum

<tracing> Grup bagian berisi pengaturan pelacakan permintaan gagal yang telah Anda konfigurasi dan berisi definisi penyedia pelacakan yang disediakan selama penginstalan atau oleh Anda di server Web Internet Information Services (IIS) 7.

Pelacakan berbasis permintaan menyediakan cara yang bagus untuk mengetahui apa yang sebenarnya terjadi dengan permintaan Anda dan mengapa itu terjadi, asalkan Anda dapat mereproduksi masalah yang dialami server. Masalah seperti performa yang buruk pada beberapa permintaan, kegagalan terkait autentikasi pada permintaan lain, atau kesalahan kode status HTTP 500 dari Halaman Server Aktif (ASP) atau ASP.NET seringkali sangat sulit untuk memecahkan masalah kecuali Anda telah mengambil jejak masalah ketika itu terjadi. Pelacakan permintaan gagal dirancang untuk menyangga peristiwa pelacakan untuk permintaan dan hanya menghapusnya ke disk ketika permintaan gagal berdasarkan definisi kegagalan yang Anda berikan.

IIS 7 hanya menampilkan pesan ini setelah Anda menginstal dan mengaktifkan modul Pelacakan. Ini menyimpan pesan-pesan ini dan informasi pelacakan lainnya dalam file khusus bernama file log pelacakan peristiwa yang gagal. Anda dapat membuka file-file ini di browser Web dan meninjau peristiwa jejak yang dihasilkan oleh IIS, peristiwa pelacakan kustom yang dihasilkan oleh modul pihak ketiga, atau keduanya. Secara default, IIS 7 menyimpan file-file ini di folder %systemroot%\inetpub\logs\FailedReqLogFiles.

Bagian <tracing> berisi <traceFailedRequests> elemen dan <traceProviderDefinition> elemen . Elemen pertama mengonfigurasi pelacakan permintaan yang gagal untuk situs web atau aplikasi Anda, dan elemen kedua menentukan penyedia pelacakan yang tersedia di server. Secara default, IIS 7 menyertakan penyedia pelacakan untuk ekstensi ASP, ASP.NET, Internet Server API (ISAPI) dan server Web itu sendiri. Anda juga dapat menyertakan penyedia pelacakan kustom.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <tracing> tidak dimodifikasi di IIS 10.0.
IIS 8.5 Elemen <tracing> tidak dimodifikasi di IIS 8.5.
IIS 8.0 Elemen <tracing> tidak dimodifikasi di IIS 8.0.
IIS 7.5 Elemen <tracing> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen <tracing> ini diperkenalkan di IIS 7.0.
IIS 6.0 T/A

Siapkan

Setelah Anda menyelesaikan penginstalan default IIS 7 dan yang lebih baru, Anda harus menginstal layanan peran pelacakan untuk menggunakan pelacakan permintaan yang gagal. Setelah menginstal layanan peran, Anda masih harus mengaktifkan pelacakan permintaan yang gagal di tingkat situs, tingkat aplikasi, atau tingkat direktori.

Windows Server 2012 atau Windows Server 2012 R2

  1. Pada taskbar, klik Manajer Server.
  2. Di Manajer Server, klik menu Kelola , lalu klik Tambahkan Peran dan Fitur.
  3. Di wizard Tambahkan Peran dan Fitur , klik Berikutnya. Pilih jenis penginstalan dan klik Berikutnya. Pilih server tujuan dan klik Berikutnya.
  4. Pada halaman Peran Server , perluas Server Web (IIS), perluas Server Web, perluas Kesehatan dan Diagnostik, lalu pilih Pelacakan. Klik Berikutnya.
    Cuplikan layar halaman Peran Server. Pelacakan disorot di menu yang diperluas. .
  5. Pada halaman Pilih fitur, klik Berikutnya.
  6. Pada halaman Konfirmasi pilihan instalasi, klik Instal.
  7. Pada halaman Hasil , klik Tutup.

Windows 8 atau Windows 8.1

  1. Pada layar Mulai, pindahkan penunjuk ke sudut kiri bawah, klik kanan tombol Mulai, lalu klik Panel Kontrol.
  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan fitur Windows.
  3. Perluas Layanan Informasi Internet, perluas World Wide Web Services, perluas Kesehatan dan Diagnostik, lalu pilih Pelacakan.
    Cuplikan layar kotak dialog Fitur Windows. Pelacakan disorot di menu drop-down.- Klik OK.
  4. Klik Tutup.

Windows Server 2008 atau Windows Server 2008 R2

  1. Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Server.
  2. Di panel hierarki Manajer Server , perluas Peran, lalu klik Server Web (IIS).
  3. Di panel Server Web (IIS), gulir ke bagian Layanan Peran , lalu klik Tambahkan Layanan Peran.
  4. Pada halaman Pilih Layanan Peran dari Wizard Tambahkan Layanan Peran, pilih Pelacakan, lalu klik Berikutnya.
    Cuplikan layar wizard Tambahkan Layanan Peran yang menampilkan halaman Layanan Peran. Pelacakan disorot di menu.
  5. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.
  6. Pada halaman Hasil , klik Tutup.

Windows Vista atau Windows 7

  1. Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan Fitur Windows.
  3. Perluas Layanan Informasi Internet, lalu World Wide Web Services, lalu Kesehatan dan Diagnostik.
  4. Pilih Pelacakan, lalu klik OK.
    Cuplikan layar kotak dialog Fitur Windows. Pelacakan disorot di menu yang diperluas.

Bagaimana Caranya

Cara mengaktifkan pelacakan

  1. Buka Manajer Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , pilih koneksi server, situs, aplikasi, atau direktori yang ingin Anda konfigurasi pelacakan permintaannya gagal.

  3. Di panel Tindakan , klik Pelacakan Permintaan Gagal...
    Cuplikan layar jendela I I S Manager yang menampilkan halaman Beranda Situs Web Default.

  4. Dalam kotak dialog Edit Pengaturan Pelacakan Permintaan Gagal Situs Web , pilih kotak centang Aktifkan untuk mengaktifkan pelacakan, biarkan nilai default atau ketik direktori baru tempat Anda ingin menyimpan file log permintaan yang gagal dalam kotak Direktori , ketik jumlah file pelacakan permintaan gagal yang ingin Anda simpan dalam kotak Jumlah maksimum file jejak , lalu klik OK.
    Cuplikan layar kotak dialog Edit Pengaturan Pelacakan Permintaan Gagal Situs Web.

Cara mengonfigurasi definisi kegagalan

  1. Buka Manajer Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

  2. Di panel Koneksi , buka koneksi, situs, aplikasi, atau direktori yang ingin Anda konfigurasi pelacakan permintaannya gagal.

  3. Di panel Beranda , klik dua kali Aturan Pelacakan Permintaan Gagal.
    Cuplikan layar Manajer I I S yang menampilkan halaman Beranda Situs Web Default. Ikon untuk Aturan Pelacakan Permintaan Gagal disorot.

  4. Di panel Tindakan , klik Tambahkan...

  5. Pada halaman Tentukan Konten ke Pelacakan wizard Tambahkan Aturan Pelacakan Permintaan Gagal , pilih tipe konten yang ingin Anda lacak, lalu klik Berikutnya.
    Cuplikan layar wizard Tambahkan Aturan Pelacakan Permintaan Gagal menampilkan halaman Tentukan Konten ke Pelacakan.

  6. Pada halaman Tentukan Kondisi Pelacakan , pilih kondisi yang ingin Anda lacak, lalu klik Berikutnya. Kondisi pelacakan dapat mencakup kombinasi kode status, batas waktu yang harus diambil permintaan, atau tingkat keparahan peristiwa. Jika Anda menentukan semua kondisi, kondisi pertama yang terpenuhi menghasilkan file log jejak permintaan yang gagal.
    Cuplikan layar wizard Tambahkan Aturan Pelacakan Permintaan Gagal yang menampilkan halaman Tentukan Konten ke Pelacakan.

  7. Pada halaman Pilih Penyedia Pelacakan , pilih satu atau beberapa penyedia pelacakan di bawah Penyedia.
    Cuplikan layar wizard Tambahkan Aturan Pelacakan Permintaan Gagal yang menampilkan halaman Pilih Penyedia Pelacakan.

  8. Pada halaman Pilih Penyedia Pelacakan , pilih satu atau beberapa tingkat verbositas di bawah Verbosity.
    Cuplikan layar wizard Tambahkan Aturan Pelacakan Permintaan Gagal yang menampilkan halaman Pilih Penyedia Pelacakan. W W Server dan Peringatan dipilih.

  9. Jika Anda memilih penyedia pelacakan ASPNET atau WWW Server di langkah 8, pilih satu atau beberapa area fungsional untuk dilacak penyedia di bawah Area halaman Pilih Penyedia Pelacakan .

  10. Klik Selesai.

Konfigurasi

Anda dapat mengonfigurasi <tracing> grup bagian di tingkat server dalam file ApplicationHost.config atau di tingkat situs, tingkat aplikasi, atau tingkat direktori dalam file Web.config.

Atribut

Tidak ada.

Elemen Anak

Elemen Deskripsi
traceFailedRequests Elemen opsional.

Berisi pengaturan untuk melacak permintaan yang gagal pada server Web.
traceProviderDefinitions Elemen opsional.

Menentukan penyedia pelacakan yang digunakan pada server Web.

Sampel Konfigurasi

Contoh konfigurasi berikut mengonfigurasi pelacakan di tingkat server dalam file ApplicationHost.config. Ini mengatur pelacakan untuk semua file .aspx, menggunakan <traceAreas> elemen untuk mengatur penyedia ASPNET dan melacak terhadap semua area ASP.NET, yaitu Infrastruktur, Modul, Halaman , dan AppServices. Sampel juga menggunakan atribut verbosity untuk mengatur jumlah informasi yang dikembalikan ke file pelacakan ke peringatan. Terakhir, sampel menggunakan <failureDefinitions> elemen untuk melacak hanya permintaan yang menghasilkan kode status HTTP 404.

<tracing>
   <traceFailedRequests>
      <add path="*.aspx">
         <traceAreas>
            <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Warning" />
         </traceAreas>
         <failureDefinitions statusCodes="404" />
      </add>
   </traceFailedRequests>
</tracing>

Kode Sampel

Contoh berikut mengaktifkan pelacakan permintaan gagal verbose untuk kesalahan HTTP 500 dalam konten ASP.NET pada semua permintaan ke halaman *.aspx.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /+"[path='*.aspx'].traceAreas.[provider='ASPNET',areas='Infrastructure,Module,Page,AppServices',verbosity='Verbose']" 

appcmd.exe set config "Contoso" -section:system.webServer/tracing/traceFailedRequests /[path='*.aspx'].failureDefinitions.statusCodes:"500"

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.GetWebConfiguration("Contoso");
         ConfigurationSection traceFailedRequestsSection = config.GetSection("system.webServer/tracing/traceFailedRequests");
         ConfigurationElementCollection traceFailedRequestsCollection = traceFailedRequestsSection.GetCollection();

         ConfigurationElement addElement = traceFailedRequestsCollection.CreateElement("add");
         addElement["path"] = @"*.aspx";

         ConfigurationElementCollection traceAreasCollection = addElement.GetCollection("traceAreas");
         ConfigurationElement addElement1 = traceAreasCollection.CreateElement("add");
         addElement1["provider"] = @"ASPNET";
         addElement1["areas"] = @"Infrastructure,Module,Page,AppServices";
         addElement1["verbosity"] = @"Verbose";
         traceAreasCollection.Add(addElement1);

         ConfigurationElement failureDefinitionsElement = addElement.GetChildElement("failureDefinitions");
         failureDefinitionsElement["statusCodes"] = @"500";
         traceFailedRequestsCollection.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.GetWebConfiguration("Contoso")
      Dim traceFailedRequestsSection As ConfigurationSection = config.GetSection("system.webServer/tracing/traceFailedRequests")
      Dim traceFailedRequestsCollection As ConfigurationElementCollection = traceFailedRequestsSection.GetCollection

      Dim addElement As ConfigurationElement = traceFailedRequestsCollection.CreateElement("add")
      addElement("path") = "*.aspx"
      Dim traceAreasCollection As ConfigurationElementCollection = addElement.GetCollection("traceAreas")
      Dim addElement1 As ConfigurationElement = traceAreasCollection.CreateElement("add")
      addElement1("provider") = "ASPNET"
      addElement1("areas") = "Infrastructure,Module,Page,AppServices"
      addElement1("verbosity") = "Verbose"
      traceAreasCollection.Add(addElement1)

      Dim failureDefinitionsElement As ConfigurationElement = addElement.GetChildElement("failureDefinitions")
      failureDefinitionsElement("statusCodes") = "500"
      traceFailedRequestsCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso");
var traceFailedRequestsCollection = traceFailedRequestsSection.Collection;

var addElement = traceFailedRequestsCollection.CreateNewElement("add");
addElement.Properties.Item("path").Value = "*.aspx";
var traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection;

var addElement1 = traceAreasCollection.CreateNewElement("add");
addElement1.Properties.Item("provider").Value = "ASPNET";
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices";
addElement1.Properties.Item("verbosity").Value = "Verbose";
traceAreasCollection.AddElement(addElement1);

var failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions");
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500";
traceFailedRequestsCollection.AddElement(addElement);

adminManager.CommitChanges();

Vbscript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set traceFailedRequestsSection = adminManager.GetAdminSection("system.webServer/tracing/traceFailedRequests", "MACHINE/WEBROOT/APPHOST/Contoso")
Set traceFailedRequestsCollection = traceFailedRequestsSection.Collection

Set addElement = traceFailedRequestsCollection.CreateNewElement("add")
addElement.Properties.Item("path").Value = "*.aspx"
Set traceAreasCollection = addElement.ChildElements.Item("traceAreas").Collection

Set addElement1 = traceAreasCollection.CreateNewElement("add")
addElement1.Properties.Item("provider").Value = "ASPNET"
addElement1.Properties.Item("areas").Value = "Infrastructure,Module,Page,AppServices"
addElement1.Properties.Item("verbosity").Value = "Verbose"
traceAreasCollection.AddElement addElement1

Set failureDefinitionsElement = addElement.ChildElements.Item("failureDefinitions")
failureDefinitionsElement.Properties.Item("statusCodes").Value = "500"
traceFailedRequestsCollection.AddElement addElement

adminManager.CommitChanges()