Bagikan melalui

Trace Failed Requests <traceFailedRequests>

  • Artikel

Gambaran Umum

Elemen ini <traceFailedRequests> memungkinkan Anda mengonfigurasi pelacakan permintaan yang gagal untuk situs Web, aplikasi, atau direktori. Elemen ini dapat berisi kumpulan <add> elemen yang menentukan aturan pelacakan, yang masing-masing menentukan ekstensi URL permintaan tempat aturan diterapkan, penyedia pelacakan dan area untuk diaktifkan, dan kondisi yang menyebabkan aturan ini mencatat peristiwa.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <traceFailedRequests> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5 Elemen <traceFailedRequests> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0 Elemen <traceFailedRequests> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5 Elemen <traceFailedRequests> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen ini <traceFailedRequests> 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 panel Server Web diperluas dengan Pelacakan dipilih. .
  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 Layanan Web Seluruh Dunia, perluas Kesehatan dan Diagnostik, lalu pilih Pelacakan.
    Cuplikan layar panel World Wide Web Services diperluas dengan Pelacakan dipilih. - 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 panel Pilih Layanan Peran diperluas dengan Pelacakan dipilih.
  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 panel Layanan Informasi Internet diperluas dengan Pelacakan dipilih.

Bagaimana Caranya

Cara mengaktifkan pelacakan

  1. Buka Pengelola 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 Pengelola 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 bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola 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 Konsol Manajer I I S dengan ikon aplikasi.

  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 di kotak Jumlah maksimum file jejak , lalu klik OK.
    Cuplikan layar kotak dialog Edit Pengaturan Pelacakan Permintaan Gagal Situs Web menampilkan Direktori dan Jumlah Maksimum File Terlacak yang diisi.

Cara mengonfigurasi definisi kegagalan

  1. Buka Pengelola 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 Pengelola 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 bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik Pengelola 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 konsol I I S Manager dengan ikon aplikasi.

  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 dengan Semua Konten dipilih.

  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 halaman Tentukan Kondisi Pelacakan dengan kotak kode status dicentang.

  7. Pada halaman Pilih Penyedia Pelacakan , pilih satu atau beberapa penyedia pelacakan di bawah Penyedia.
    Cuplikan layar halaman Pilih Penyedia Pelacakan dengan A S P dan A S P Net dipilih sebagai penyedia pelacakan.

  8. Pada halaman Pilih Penyedia Pelacakan , pilih satu atau beberapa tingkat verbositas di bawah Verbosity.
    Cuplikan layar halaman Pilih Penyedia Pelacakan dengan A S P dan A S P Net dipilih untuk verbositas Penyedia.

  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 <traceFailedRequests> elemen di tingkat server dalam file ApplicationHost.config atau di tingkat situs, tingkat aplikasi, atau tingkat URL dalam file Web.config yang sesuai.

Atribut

Tidak ada.

Elemen Anak

Elemen Deskripsi
add Elemen opsional.

Menambahkan jalur ke kumpulan definisi jalur.
remove Elemen opsional.

Menghapus referensi ke jalur dari kumpulan definisi jalur.
clear Elemen opsional.

Menghapus semua referensi ke jalur dari kumpulan definisi jalur.

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()