Partilhar via

Perfil

  • Artigo

Representa uma coleção de categorias de problemas e elementos de coletores.

Hierarquia de elementos

Syntax

<Profile Id          = IdType
         Name        = string
         Description = string
         Base        = string
         LoggingMode = "File" | "Memory"
         DetailLevel = "Verbose" | "Light"
         Strict      = boolean
         Internal    = boolean
         Default     = boolean>

  <!-- Child elements -->
  ProblemCategories,
  Collectors

</Profile>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Padrão
Id Identifica exclusivamente o perfil. Cadeia de caracteres que deve ter pelo menos um caractere e não pode conter dois-pontos ou espaços. Sim
Nome Indica o nome do perfil. string Sim
Descrição Indica a descrição do perfil. string Sim
Base Indica a base do perfil. string Não
LoggingMode Indica se a WPR grava na memória ou em um arquivo sequencial. Esse atributo pode ter um dos seguintes valores:
  • Arquivo
  • Memória
 Sim Arquivo
DetailLevel Especifica se uma definição de perfil é usada para rastreamento de tempo (Light) ou rastreamento de análise (Verbose). Esse atributo pode ter um dos seguintes valores:
  • Detalhado
  • Claro
 Sim Detalhado
Rigoroso Indica se a falha de um provedor ou coletor causa falha na operação de início. Se esse atributo estiver definido como false, a operação de início terá êxito mesmo se alguns coletores ou provedores falharem. Pelo menos um coletor e um provedor devem ter êxito para que a operação continue. Se esse atributo for definido truecomo , as informações sobre provedores ou coletores que não iniciaram serão fornecidas como avisos, em vez de erros. booleano Não false
Interna Indica se o perfil é interno. booleano Não false
Default Indica se o perfil é um perfil padrão. booleano Não false

Elementos filho

Elemento Descrição Requisito
ProblemaCategorias Representa uma coleção de categorias de problema. Obrigatório, exatamente 1.
Coletores Representa uma coleção de coletores para o perfil. Obrigatório, exatamente 1.
TraceMergeProperties Representa uma coleção de properites de mesclagem de rastreamento. Opcional, exatamente 1.

Elementos pai

Elemento Descrição
Perfis Representa uma coleção de coletores, provedores e perfis.

Comentários

Cada arquivo .wprp normalmente contém pelo menos duas definições de perfil: uma para cada modo de registro em log. A exceção é que os perfis de transição ativados/desativados só podem ser registrados no arquivo, portanto, o arquivo .wprp para esses perfis pode conter apenas uma definição de perfil. Cada arquivo .wprp pode conter no máximo quatro perfis: um para cada combinação de modo de registro em log e nível de detalhes. Todos os perfis em um único arquivo .wprp devem ter o mesmo valor para o atributo Name .

Construa o valor do atributo Id combinando os valores dos atributos Name, DetailLevel e LoggingMode , separados por períodos, conforme mostrado no exemplo a seguir.

Os perfis derivados têm todos os atributos do perfil base por padrão. Eles podem ser substituídos especificando-os explicitamente no perfil derivado. Para obter mais informações, consulte Herança.

Exemplo

O exemplo de código a seguir mostra uma definição de perfil.

<Profile
  Id="Example.Light.File"
  Name="Example"
  DetailLevel="Light"
  LoggingMode="File"
  Description="Example profile">
  <ProblemCategories>
    <ProblemCategory
      Value="First Level Triage"/>
  </ProblemCategories>
  <Collectors>
    <SystemCollectorId
      Value="WPRSystemCollector">
    <SystemProviderId
      Value="system-provider"/>
    </SystemCollectorId>
    <EventCollectorId
      Value="WPREventCollector">
      <EventProviders>
        <EventProviderId
          Value="Win32K-provider"/>
        <EventProviderId
          Value="Search-Core-provider"/>
      </EventProviders>
    </EventCollectorId>
  </Collectors>
</Profile>

Coletores e provedores também podem ser definidos no local, dentro da definição de perfil.

Elementos