Standardprotokollierung der Ablaufverfolgung für Anforderungsfehler für eine Site: <traceFailedRequestsLogging>-Element

Artikel
03/25/2024

Übersicht

Das <traceFailedRequestsLogging>-Element des <siteDefaults>-Elements legt die Optionen für die Ablaufverfolgung für Anforderungsfehler für alle Sites fest, z. B. das Verzeichnis für Protokolldateien der Ablaufverfolgung für Anforderungsfehler, die maximale Anzahl von Protokolldateien der Ablaufverfolgung für Anforderungsfehler und ob die Ablaufverfolgung für Anforderungsfehler aktiviert ist.

Hinweis

Wenn das <traceFailedRequestsLogging>-Element für eine bestimmte Site sowohl im Abschnitt <siteDefaults> als auch im Abschnitt <site> konfiguriert ist, wird die Konfiguration im Abschnitt <site> für diese Site verwendet.

Hinweis

Das <traceFailedRequestsLogging>-Element legt die Optionen auf globaler Ebene für die Ablaufverfolgung für Anforderungsfehler fest, aber das Element <system.webServer/tracing/traceFailedRequests> gibt Ablaufverfolgungsregeln für Anforderungsfehler an.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<traceFailedRequestsLogging>`-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<traceFailedRequestsLogging>`-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Der Standardwert für das Attribut `maxLogFileSizeKB` wurde erhöht.
IIS 7.5	Das `<traceFailedRequestsLogging>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<traceFailedRequestsLogging>`-Element des `<siteDefaults>`-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0	N/V

Setup

Nachdem Sie die Standardinstallation von IIS 7 und höher abgeschlossen haben, müssen Sie den Rollendienst „Ablaufverfolgung“ installieren, um die Ablaufverfolgung für Anforderungsfehler zu verwenden. Nachdem Sie den Rollendienst installiert haben, müssen Sie dennoch die Ablaufverfolgung für Anforderungsfehler auf Site-, Anwendungs- oder Verzeichnisebene aktivieren.

Windows Server 2012 oder Windows Server 2012 R2

Klicken Sie auf der Taskleiste auf Server-Manager.
Klicken Sie im Server-Manager auf das Menü Verwalten und dann auf Rollen und Features hinzufügen.
Klicken Sie im Assistenten zum Hinzufügen von Rollen und Features auf Weiter. Wählen Sie den Installationstyp aus, und klicken Sie auf Weiter. Wählen Sie den Zielserver aus, und klicken Sie auf Weiter.
Erweitern Sie auf der Seite Serverrollen nacheinander Webserver (IIS), Webserver und Integrität und Diagnose, und wählen Sie dann Ablaufverfolgung aus. Klicken Sie auf Weiter.
.
Klicken Sie auf der Seite Features auswählen auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 8 oder Windows 8.1

Klicken Sie auf dem Startbildschirm in der unteren linken Ecke mit der rechten Maustaste auf die Schaltfläche Start, und wählen Sie dann Systemsteuerung aus.
Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie nacheinander Internetinformationsdienste, WWW-Dienste und Integrität und Diagnose, und wählen Sie dann Ablaufverfolgung aus.
– Klicken Sie auf OK.
Klicken Sie auf Schließen.

Windows Server 2008 oder Windows Server 2008 R2

Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und wählen Sie dann Server-Manager aus.
Erweitern Sie im Hierarchiebereich des Server-Managers den Eintrag Rollen, und klicken Sie dann auf Webserver (IIS).
Scrollen Sie im Bereich Webserver (IIS) zum Abschnitt Rollendienste, und klicken Sie dann auf Rollendienste hinzufügen.
Wählen Sie auf der Seite Rollendienste auswählen des Assistenten zum Hinzufügen von Rollendiensten die Option Nachverfolgung aus, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows Vista oder Windows 7

Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie nacheinander Internetinformationsdienste, WWW-Dienste und Integrität und Diagnose.
Wählen Sie Nachverfolgung aus, und klicken Sie dann auf OK.

Gewusst wie

Konfigurieren der Sitestandardwerte für einen Server

Öffnen Sie Internetinformationsdienste-Manager (IIS):
- Vorgehensweise unter Windows Server 2012 oder Windows Server 2012 R2:
  - Klicken Sie auf der Taskleiste auf Server-Manager, wählen Sie Tools und dann Internetinformationsdienste-Manager (IIS) aus.
- Vorgehensweise unter Windows 8 oder Windows 8.1:
  - Halten Sie die Windows-Logo-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf Systemsteuerung.
  - Klicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS).
- Vorgehensweise unter Windows Server 2008 oder Windows Server 2008 R2:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste-Manager (IIS).
- Vorgehensweise unter Windows Vista oder Windows 7:
  - Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
  - Doppelklicken Sie auf Verwaltung und dann auf Internetinformationsdienste-Manager (IIS).
Erweitern Sie im Bereich Verbindungen den Servernamen, und klicken Sie dann auf den Knoten Sites.
Klicken Sie im Bereich Sites des Servers im Bereich Aktionen auf Website-Standardwerte festlegen.
Geben Sie im Dialogfeld Website-Standardwerte Ihre Standardoptionen für alle Websites an, und klicken Sie dann auf OK.

Konfiguration

Attribute

Attribut	Beschreibung
`customActionsEnabled`	Optionales boolesches Attribut. Gibt an, ob benutzerdefinierte Aktionen für die Ablaufverfolgung für Anforderungsfehler aktiviert sind. Der Standardwert ist `false`.
`directory`	Optionales Zeichenfolgeattribut. Gibt das Verzeichnis für die Protokollierung der Ablaufverfolgung für Anforderungsfehler für eine Site an. Der Standardwert ist `%SystemDrive%\inetpub\logs\FailedReqLogFiles`.
`enabled`	Optionales boolesches Attribut. Gibt an, ob die Protokollierung der Ablaufverfolgung für Anforderungsfehler für eine Site aktiviert (true) oder deaktiviert (false) ist. Der Standardwert ist `false`.
`maxLogFiles`	Optionales uint-Attribut. Gibt die maximale Anzahl von Protokolldateien der Ablaufverfolgung für Anforderungsfehler an, die für die Site beibehalten werden sollen. Der Standardwert ist `50`.
`maxLogFileSizeKB`	Optionales uint-Attribut. Gibt die maximale Dateigröße in Kilobyte für Protokolle der Ablaufverfolgung für Anforderungsfehler an. Hinweis: Wenn Protokolle der Ablaufverfolgung für Anforderungsfehler diesen Wert überschreiten, schneidet IIS die Protokolle bei der maximalen Dateigröße ab und gibt LOG_FILE_MAX_SIZE_TRUNCATE für das Ablaufverfolgungsereignis an. Der Standardwert ist `1024`.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel werden die traceFailedRequestsLogging-Standardoptionen für IIS 7 festgelegt.

<system.applicationHost>
   <sites>
      <siteDefaults>
         <traceFailedRequestsLogging enabled="true"
            directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles"
            maxLogFiles="20" />
      </siteDefaults>
   </sites>
</system.applicationHost>

Beispielcode

In den folgenden Codebeispielen werden die traceFailedRequestsLogging-Standardoptionen für IIS 7 konfiguriert.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.directory:"%SystemDrive%\inetpub\logs\FailedReqLogFiles" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.maxLogFiles:"20" /commit:apphost

Hinweis

Sie müssen den commit-Parameter auf apphost festlegen, wenn Sie „AppCmd.exe“ verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen in den entsprechenden Location-Abschnitt der Datei „ApplicationHost.config“ committet.

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 sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElement traceFailedRequestsLoggingElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging");
         traceFailedRequestsLoggingElement["enabled"] = true;
         traceFailedRequestsLoggingElement["directory"] = @"%SystemDrive%\inetpub\logs\FailedReqLogFiles";
         traceFailedRequestsLoggingElement["maxLogFiles"] = 20;

         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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim traceFailedRequestsLoggingElement As ConfigurationElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging")
      traceFailedRequestsLoggingElement("enabled") = True
      traceFailedRequestsLoggingElement("directory") = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
      traceFailedRequestsLoggingElement("maxLogFiles") = 20

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging");
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = true;
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\FailedReqLogFiles";
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging")
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = True
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20

adminManager.CommitChanges()

Freigeben über

Standardprotokollierung der Ablaufverfolgung für Anforderungsfehler für eine Site: <traceFailedRequestsLogging>-Element

Übersicht

Kompatibilität

Setup

Windows Server 2012 oder Windows Server 2012 R2

Windows 8 oder Windows 8.1

Windows Server 2008 oder Windows Server 2008 R2

Windows Vista oder Windows 7

Gewusst wie

Konfigurieren der Sitestandardwerte für einen Server

Konfiguration

Attribute

Untergeordnete Elemente

Konfigurationsbeispiel

Beispielcode

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Feedback

Zusätzliche Ressourcen