Bagikan melalui

Kegagalan Definisi <KegagalanDefinisi>

Gambaran Umum

Elemen <failureDefinitions> menentukan kondisi untuk melacak permintaan. Kondisi kegagalan terdiri dari kode status, interval waktu, atau kombinasi keduanya. Selain itu, Anda dapat menentukan tingkat verbositas untuk pelacakan.

Catatan

Menambahkan opsi verbositas tambahan akan mengonfigurasi IIS untuk mengembalikan lebih banyak informasi dalam log jejak Anda, tetapi log verbose mungkin menjadi cukup besar. Jika file log Anda melebihi ukuran file maksimum yang ditentukan oleh atribut maxLogFileSizeKB dari <traceFailedRequestsLogging> elemen , file log Anda akan dipotok pada ukuran maksimum dan Anda harus meningkatkan ukuran file yang ditentukan dalam atribut tersebut.

Kompatibilitas

Versi Catatan
IIS 10.0 Atribut traceAllAfterTimeout ditambahkan ke <failureDefinitions> elemen di IIS 10.0.
IIS 8.5 Elemen <failureDefinitions> tidak dimodifikasi di IIS 8.5.
IIS 8.0 Elemen <failureDefinitions> tidak dimodifikasi di IIS 8.0.
IIS 7.5 Elemen <failureDefinitions> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen <failureDefinitions> 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.
    Gambar panel Kesehatan dan Diagnostik di halaman Peran Server diperluas dengan Pelacakan disorot. .
  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.
    Gambar panel World Wide Web Services dan Kesehatan dan Diagnostik 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 Kesehatan dan Diagnostik di Wizard Tambahkan 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 World Wide Web Services and Health and Diagnostics diperluas menampilkan Pelacakan dipilih.

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...
    Gambar halaman Beranda Situs Web Default yang menampilkan konsol I S Manager.

  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.
    Gambar kotak dialog Edit Pengaturan Pelacakan Permintaan Gagal Situs Web dengan perintah mengisi bidang Direktori dan Jumlah maksimum file pelacakan yang ditampilkan.

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 panel Beranda yang menampilkan konsol I I S Manager.

  4. Di panel Tindakan , klik Tambahkan...

  5. Pada halaman Tentukan Konten yang akan Dilacak dari Wizard Tambahkan Aturan Pelacakan Permintaan Gagal , pilih tipe konten yang ingin Anda lacak, lalu klik Berikutnya.
    Cuplikan layar halaman Tentukan Konten ke Pelacakan memperlihatkan opsi 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.
    Gambar Wizard Tentukan Kondisi Pelacakan di Tambahkan Aturan Pelacakan Permintaan Gagal.

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

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

  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

Atribut

Atribut Deskripsi
statusCodes Atribut string opsional.

Menentukan kode status yang ingin Anda lacak. Anda dapat memasukkan beberapa kode status dalam daftar ini dengan menggunakan koma untuk memisahkan setiap kode. Anda juga dapat memperbaiki kode status menggunakan kode sub status, seperti "404.2, 500" atau rentang kode sub status seperti "400-599". Jika Anda tidak menentukan kode substatus, semua kode substatus untuk kode status yang diberikan akan dilacak. Kode status harus dari 100 hingga 999, dan kode substatus harus dari 1 hingga 999.
timeTaken Atribut timeSpan opsional.

Menentukan waktu maksimum yang mungkin dihabiskan permintaan dalam pemrosesan sebelum ditandai sebagai gagal lalu dilacak.

Nilai defaultnya adalah 00:00:00.
traceAllAfterTimeout Atribut bool opsional.

true jika IIS harus melanjutkan pelacakan seluruh permintaan ketika batas waktu tercapai; jika tidak, false jika IIS harus memotong jejak ketika waktu habis terjadi.

Nilai defaultnya adalah false.
verbosity Atribut enum opsional.

Menentukan jumlah minimum informasi dan jenis informasi yang disimpan ke log jejak. Jika verbositas diatur ke Kesalahan, file log jejak permintaan yang gagal untuk permintaan akan dibuat ketika peristiwa pelacakan pertama yang verbositasnya adalah Kesalahan atau CriticalError diterima.

Atribut verbositas dapat menjadi salah satu nilai yang mungkin berikut.

Nilai defaultnya adalah Ignore.
Nilai Deskripsi
Ignore Tidak menyediakan informasi tentang aktivitas permintaan.

Nilai numerik adalah 0.
CriticalError Menyediakan informasi tentang tindakan yang dapat menyebabkan proses keluar atau yang akan menyebabkan proses keluar.

Nilai numerik adalah 1.
Error Menyediakan informasi tentang komponen yang mengalami kesalahan dan tidak dapat terus memproses permintaan. Kesalahan ini biasanya menunjukkan masalah sisi server.

Nilai numerik adalah 2.
Warning Menyediakan informasi tentang komponen yang mengalami kesalahan tetapi dapat terus memproses permintaan.

Nilai numerik adalah 3.

Elemen Anak

Tidak ada.

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 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 memungkinkan 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()
  • Last updated on