Classe FailureDefinition
Spécifie les conditions dans lesquelles une trace de requête est générée.
Syntaxe
class FailureDefinition : EmbeddedObject
Méthodes
Cette classe ne contient pas de méthodes.
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe FailureDefinition.
| Nom | Description |
|---|---|
StatusCodes |
Valeur en lecture/écriture string qui contient une liste délimitée par des virgules, sans espaces, des codes d’état HTTP qui entraînent la trace d’une requête. Si vous ne spécifiez pas de codes de sous-état, tous les codes de sous-état associés au code d’état indiqué sont tracés. Par exemple, si vous spécifiez « 404 », les traces pour 404.1, 404.2 et 404.5 sont également retournées. Les codes d’état doivent être de 100 à 999, et les codes de sous-état doivent être de 1 à 999. Remarque : Vous pouvez spécifier une plage de codes d’état (par exemple, « 400-599 »). Le deuxième nombre doit être supérieur ou égal au premier nombre. La plage ne peut pas inclure de valeurs de sous-état. |
TimeTaken |
Valeur en lecture seule datetime qui spécifie la durée pendant laquelle une requête peut passer au traitement avant d’être marquée comme ayant échoué puis tracée. La valeur par défaut est 0. Une propriété clé. |
Verbosity |
Valeur d’énumération en lecture/écriture sint32 qui spécifie le seuil des événements de trace. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Les instances de cette classe sont contenues dans la FailureDefinitions propriété de la classe TraceUrl .
Une requête aura ses événements suivis s’il dure au-delà de la valeur de la propriété TimeTaken ou si son code d’état se trouve dans la liste contenue par la propriété StatusCodes. Si les deux StatusCodes et TimeTaken sont spécifiés true, la première condition qui est évaluée entraîne la génération de la trace de la requête.
Le tableau suivant répertorie les valeurs possibles pour la propriété Verbosity. La valeur par défaut est 0 (Ignore).
Pour qu’une requête soit marquée comme ayant échoué, les événements déclenchés doivent avoir un niveau inférieur ou égal à la valeur dans Verbosity.
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | Ignore |
Ne fournit aucune information sur l’activité des requêtes. |
| 1 | CriticalError |
Fournit des informations sur les actions qui risquent ou sont sur le point d’entraîner la sortie d’un processus. |
| 2 | Error |
Fournit des informations sur les composants qui rencontrent une erreur et qui ne peuvent pas poursuivre le traitement des requêtes. Ces erreurs indiquent généralement un problème côté serveur. Valeur par défaut. |
| 3 | Warning |
Fournit des informations sur les composants qui rencontrent une erreur mais peuvent continuer à traiter les demandes. |
Hiérarchie d'héritage
FailureDefinition
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10 |
| Serveur | - IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous Windows Server 2016 |
| Produit | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Fichier MOF | WebAdministration.mof |
Voir aussi
Créer une règle de suivi pour les demandes ayant échoué
Classe EmbeddedObject
Classe TraceAreaElement
Classe TraceAreaDefinition
Classe TraceFailedRequestsSection
Classe TraceProviderDefinition
Classe TraceProviderDefinitionsSection
Classe TraceUrl