Condividi tramite

Profilo

  • Articolo

Rappresenta una raccolta di categorie di problemi e agenti di raccolta.

Gerarchia degli elementi

Sintassi

<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>

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Richiesto Predefinito
Id Identifica in modo univoco il profilo. Stringa che deve avere almeno un carattere e non può contenere due punti o spazi. Sì
Nome Indica il nome del profilo. string Sì
Descrizione Indica la descrizione del profilo. string Sì
Base Indica la base del profilo. string No
LoggingMode Indica se WPR scrive in memoria o in un file sequenziale. Questo attributo può avere uno dei valori seguenti:
  • File
  • Memoria
 Sì File
DetailLevel Specifica se una definizione di profilo viene utilizzata per la traccia temporale (Light) o la traccia di analisi (Verbose). Questo attributo può avere uno dei valori seguenti:
  • Dettagliato
  • Chiaro
 Sì Dettagliato
Strict Indica se l'errore di un provider o di un agente di raccolta causa l'esito negativo dell'operazione di avvio. Se questo attributo è impostato su false, l'operazione di avvio ha esito positivo anche se alcuni agenti di raccolta o provider hanno esito negativo. Almeno un agente di raccolta e un provider devono avere esito positivo affinché l'operazione continui. Se questo attributo è impostato su true, le informazioni sui provider o sugli agenti di raccolta che non sono stati avviati vengono fornite come avvisi, anziché errori. boolean No false
Interno Indica se il profilo è interno. boolean No false
Default Indica se il profilo è un profilo predefinito. boolean No false

Elementi figlio

Elemento Descrizione Requisito
ProblemCategories Rappresenta una raccolta di categorie di problemi. Obbligatorio, esattamente 1.
Collezionisti Rappresenta una raccolta di agenti di raccolta per il profilo. Obbligatorio, esattamente 1.
TraceMergeProperties Rappresenta una raccolta di proprietà di tipo merge di traccia. Facoltativo, esattamente 1.

Elementi padre

Elemento Descrizione
Profili Rappresenta una raccolta di agenti di raccolta, provider e profili.

Commenti

Ogni file con estensione wprp contiene in genere almeno due definizioni di profilo: una per ogni modalità di registrazione. L'eccezione è che i profili di transizione on/off possono essere registrati solo nel file, quindi il file con estensione wprp per tali profili può contenere una sola definizione di profilo. Ogni file wprp può contenere al massimo quattro profili: uno per ogni combinazione di modalità di registrazione e livello di dettaglio. Tutti i profili in un singolo file con estensione wprp devono avere lo stesso valore per l'attributo Name .

Costruire il valore dell'attributo Id combinando i valori degli attributi Name, DetailLevel e LoggingMode , separati da punti, come illustrato nell'esempio seguente.

Per impostazione predefinita, i profili derivati hanno tutti gli attributi del profilo di base. È possibile eseguirne l'override specificandoli in modo esplicito nel profilo derivato. Per altre informazioni, vedere Ereditarietà.

Esempio

Nell'esempio di codice seguente viene illustrata una definizione di profilo.

<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>

Gli agenti di raccolta e i provider possono anche essere definiti sul posto, all'interno della definizione del profilo.

Elementi