3. Definizioni del profilo
I profili di registrazione di Windows Performance Recorder (WPR) vengono archiviati in un file XML con estensione wprp. Le definizioni dei profili raggruppano le definizioni dell'agente di raccolta e del provider nel file wprp.
Profiles
È possibile definire un profilo WPR usando (<Profile> … </Profile> tag XML che fanno riferimento ai tag XML di raccolta e definizione del provider definiti nello stesso file wprp o usando l'ereditarietà in un altro file con estensione wprp. Ogni tag XML di definizione del profilo deve avere gli attributi seguenti:
ID: identificatore univoco della definizione del profilo. Usare la costruzione dell'identificatore del profilo seguente:
< Nome>.<DetailLevel>.<LoggingMode>.
Nome: stringa che indica il nome del profilo.
DetailLevel: attributo che specifica se viene usata una definizione del profilo per la traccia temporale (Luce) o la traccia di analisi (Verbose).
LoggingMode: attributo che specifica se gli eventi del profilo vengono registrati in un file sequenziale o in buffer di memoria circolare. Tutti i profili devono avere sia un file che una versione di memoria nello stesso file wprp.
Descrizione: Descrizione testuale del profilo visualizzato dall'utente.
WPR supporta la registrazione delle prestazioni per le modalità di registrazione dei file e della memoria per ogni file con estensione wprp, ad eccezione dei profili on/off. È necessario accedere/disattivare i profili a un file, ma è necessario definire sia un file che una versione di memoria. Poiché una singola definizione del profilo può supportare una sola modalità di registrazione, è possibile che siano presenti due o quattro definizioni di profilo in un file con estensione wprp, una per ogni combinazione di modalità di registrazione e livello di dettaglio. Tutte le definizioni di profilo in un singolo file wprp devono avere lo stesso attributo Name .
< Nome>.<DetailLevel>.<LoggingMode>
Nell'esempio di codice seguente viene illustrato Example1.wprp. Questo file contiene due definizioni di profilo. I puntini di sospensione (...) rappresentano il corpo del profilo.
<Profile
Id="Example1.Verbose.File"
Name="Example1"
DetailLevel="Verbose"
LoggingMode="File"
Description="Example1 profile">
…
</Profile>
<Profile
Id="Example1.Verbose.Memory"
Name="Example1"
DetailLevel="Verbose"
LoggingMode="Memory"
Description="Example1 profile">
…
</Profile>
Nell'esempio di codice seguente viene illustrato Example2.wprp. Questo file contiene quattro definizioni di profilo. I puntini di sospensione (...) rappresentano il corpo del profilo.
<Profile
Id="Example2.Verbose.File"
Name="Example2"
DetailLevel="Verbose"
LoggingMode="File"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Light.File"
Name="Example2"
DetailLevel="Light"
LoggingMode="File"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Verbose.Memory"
Name="Example2"
DetailLevel="Verbose"
LoggingMode="Memory"
Description="Example2 profile">
…
</Profile>
<Profile
Id="Example2.Light.Memory"
Name="Example2"
DetailLevel="Light"
LoggingMode="Memory"
Description="Example2 profile">
…
</Profile>
Elemento Collectors
L'elemento Collectors contiene riferimenti a raccolta eventi e sistema definiti in precedenza. Gli elementi SystemCollectorId e EventCollectorId identificano questi agente di raccolta.
Ogni elemento SystemCollectorId e EventCollectorId contiene un attributo Value obbligatorio che specifica l'attributo Id dell'agente di raccolta da usare. Ogni elemento SystemCollectorId e EventCollectorId contiene anche un elenco di elementi SystemProviderId o EventCollectorId. Questi elementi hanno una sintassi simile. Tuttavia, questi elementi fanno riferimento a provider di eventi e di sistema definiti in precedenza.
È anche possibile definire raccolta e provider all'interno della definizione del profilo.
Esempio di definizione del profilo
Nell'esempio di codice seguente viene illustrata una definizione completa del 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">
<!--Enables the system provider for this system collector. -->
<SystemProviderId
Value="system-provider"/>
</SystemCollectorId>
<EventCollectorId
Value="WPREventCollector">
<EventProviders>
<!--Enables two event providers for this event collector. -->
<EventProviderId
Value="Win32K-provider"/>
<EventProviderId
Value="Search-Core-provider"/>
</EventProviders>
</EventCollectorId>
</Collectors>
</Profile>
Argomenti correlati
Creazione di profili di registrazione