Edit a Tracing Rule for Failed Requests (IIS 7)
Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista
Change the settings for failed request tracing when you want to change the failure definitions for a rule. Change the settings, also, when you want to collect different information about a failed request, for example, when you want to change the length of response time allowed for a request before it is considered a failed request.
Note
Editing a configuration setting changes the setting at the local level and for any child levels that inherit the setting.
Prerequisites
For information about the levels at which you can perform this procedure, and the modules, handlers, and permissions that are required to perform this procedure, see Tracing for Failed Requests Feature Requirements (IIS 7).
Exceptions to feature requirements
- None
To edit a tracing rule for failed requests
You can perform this procedure by using the user interface (UI), by editing configuration files directly, or by writing WMI scripts.
User Interface
To Use the UI
Open IIS Manager and navigate to the level you want to manage. For information about opening IIS Manager, see Open IIS Manager (IIS 7). For information about navigating to locations in the UI, see Navigation in IIS Manager (IIS 7).
In Features View, double-click Failed Request Tracing Rules.
On the Failed Request Tracing Rules page, click the rule that you want to change, and then click Edit in the Actions pane.
In the Specify Content to Trace dialog box, click Next.
Optionally, in the Define Trace Conditions dialog box, do one or more of the following:
Change the Status code(s) for which you want to trace failures in the Status code(s) text box.
Change the Time taken (in seconds) and type the time interval in the Time taken (in seconds) text box.
Change the Event severity by selecting a new severity from the Event severity drop-down list, and then click Next.
Optionally, in the Select Trace Providers dialog box, do one or more of the following to change the provider:
Click ASP if you want to configure IIS to trace ASP requests.
Click ASPNET if you want to configure IIS to trace ASP.NET requests.
Click WWW Server if you want to configure IIS to trace WWW Server requests.
Click ISAPI Extension if you want to configure IIS to trace ISAPI requests.
Optionally, click a provider to change its verbosity level.
Under Provider Properties, click a verbosity level in the Verbosity drop-down list.
Repeat steps 7 and 8 for each provider you selected in the Select Trace Providers dialog box and for which you want to change the verbosity level.
Optionally, click a provider to change the areas you want it to trace.
Under Areas, select the areas you want the provider to trace.
Repeat steps 10 and 11 for each provider you selected in the Select Trace Providers dialog box and for which you want to change the areas the provider will trace.
Click Finish.
Note
You must specify at least one trace provider for the Finish button to be enabled.
Configuration
The procedure in this topic affects the following configuration elements:
<traceFailedRequests>
<traceAreas>
<failureDefinitions>
For more information about IIS 7 configuration, see IIS 7.0: IIS Settings Schema on MSDN.
WMI
Use the following WMI classes, methods, or properties to perform this procedure:
- TraceFailedRequestsSection
For more information about WMI and IIS, see Windows Management Instrumentation (WMI) in IIS 7. For more information about the classes, methods, or properties associated with this procedure, see the IIS WMI Provider Reference on the MSDN site.