Classe FailureDefinition
Especifica as condições sob as quais um rastreamento de solicitação é gerado.
Sintaxe
class FailureDefinition : EmbeddedObject
Métodos
Essa classe não contém métodos.
Propriedades
A tabela a seguir lista as propriedades expostas pela classe FailureDefinition.
| Nome | Descrição |
|---|---|
StatusCodes |
Um valor string de leitura/gravação que contém uma lista delimitada por vírgula, sem espaços, de códigos de status HTTP que fazem com que uma solicitação seja rastreada. Se você não especificar códigos de substatus, todos os códigos de substatus para o código de status fornecido serão rastreados. Por exemplo, se você especificar "404", os rastreamentos para 404.1, 404.2 e 404.5 também serão retornados. Os códigos de status devem ser de 100 a 999 e os códigos de substatus devem ser de 1 a 999. Anotação: é possível especificar um intervalo de códigos de status (por exemplo, "400-599"). O segundo número deverá ser maior ou igual ao primeiro número. O intervalo não poderá incluir valores de substatus. |
TimeTaken |
Um valor datetime somente leitura especificando a quantidade de tempo que uma solicitação poderá gastar no processamento antes de ser marcada como falha e, em seguida, rastreada. O padrão é 0. Uma propriedade chave. |
Verbosity |
Um valor sint32 de enumeração de leitura/gravação que especifica o limite para eventos de rastreamento. Os valores possíveis estão listados posteriormente na seção Comentários. |
Subclasses
Essa classe não contém subclasses.
Comentários
As instâncias dessa classe estão contidas na propriedade FailureDefinitions da classe TraceUrl.
Uma solicitação terá os eventos rastreados se durar além do valor da propriedade TimeTaken ou se o código de status estiver na lista contida pela propriedade StatusCodes. Se StatusCodes e TimeTaken forem especificados, a primeira condição avaliada como true gerará o rastreamento da solicitação.
A tabela a seguir lista os possíveis valores da propriedade Verbosity. O padrão é 0 (Ignore).
Para que uma solicitação seja marcada como falha, os eventos gerados deverão ter um nível menor ou igual ao valor em Verbosity.
| Valor | Palavra-chave | Descrição |
|---|---|---|
| 0 | Ignore |
Não fornece informações sobre a atividade da solicitação. |
| 1 | CriticalError |
Fornece informações sobre as ações que podem causar a saída de um processo ou as que estejam prestes a causar essa saída. |
| 2 | Error |
Fornece informações sobre os componentes que apresentam um erro e não podem continuar processando as solicitações. Esses erros geralmente indicam um problema do lado do servidor. O padrão. |
| 3 | Warning |
Fornece informações sobre os componentes que apresentam erros, mas podem continuar processando solicitações. |
Hierarquia de herança
FailureDefinition
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Product | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | WebAdministration.mof |
Confira também
Criar uma regra de rastreamento para solicitações com falha
Classe EmbeddedObject
Classe TraceAreaElement
Classe TraceAreaDefinition
Classe TraceFailedRequestsSection
Classe TraceProviderDefinition
Classe TraceProviderDefinitionsSection
Classe TraceUrl