Export (0) Print
Expand All

failureDefinitions Element for add for traceFailedRequests for tracing [IIS Settings Schema]

IIS 7.0

NoteNote:

For more information about the failureDefinitions element, see the following topic on the Microsoft IIS.net Web site: Failure Definitions <failureDefinitions>.

Defines the conditions in which to trace requests.

NoteNote:

The first condition that is met will generate a failed request trace log file for the request.

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute

Description

statusCodes

Optional string attribute.

Specifies the status code(s) you want to trace. You can enter multiple status codes in this list by using commas to separate each code. You can also refine your status codes using sub status codes, such as "404.2, 500" or a range of sub status codes such as "400-599". If you do not specify substatus codes, all substatus codes for the given status code will be traced. Status codes must be from 100 to 999, and substatus codes must be from 1 to 999.

timeTaken

Optional timeSpan attribute.

Specifies the maximum time that a request may spend in processing before it is marked as failed and then traced.

The default value is 00:00:00.

verbosity

Optional enum attribute.

Specifies the minimum amount of information and the type of information that is saved to the trace log. If the verbosity is set to Error, a failed request trace log file for the request will be created when the first trace event whose verbosity is either Error or CriticalError is received.

The verbosity attribute can be one of the following possible values.

The default value is Ignore.

ValueDescription
IgnoreProvides no information about the request activity. The numeric value is 0.
CriticalErrorProvides information about actions that can cause a process to exit or that are about to cause a process to exit. The numeric value is 1.
ErrorProvides information about components that experience an error and cannot continue to process requests. These errors usually indicate a server-side problem. The numeric value is 2.
WarningProvides information about components that experience an error but that can continue to process the request. The numeric value is 3.

Child Elements

None.

Parent Elements

Element

Description

configuration

Specifies the root element in every configuration file that is used by IIS 7.

system.webServer

Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

tracing

Configures request trace settings.

traceFailedRequests

Contains settings for tracing failed requests on the Web server.

add

Adds a path to the collection of path definitions.

For more information about the failureDefinitions element, see the following topic on the Microsoft IIS.net Web site: Failure Definitions <failureDefinitions>.

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Community Additions

ADD
Show:
© 2014 Microsoft