Partager via

Profil

  • Article

Représente une collection de catégories de problèmes et d’éléments collecteurs.

Hiérarchie d’éléments

Syntaxe

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

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Default
Id Identifie de manière unique le profil. Chaîne qui doit avoir au moins un caractère et ne peut pas contenir de points-virgules ou d’espaces. Oui
Nom Indique le nom du profil. string Oui
Description Indique la description du profil. string Oui
Base Indique la base du profil. string Non
LoggingMode Indique si WPR écrit en mémoire ou dans un fichier séquentiel. Cet attribut peut avoir l’une des valeurs suivantes :
  • File
  • Mémoire
 Oui Fichier
DetailLevel Spécifie si une définition de profil est utilisée pour le suivi de minutage (Light) ou le suivi d’analyse (Verbose). Cet attribut peut avoir l’une des valeurs suivantes :
  • Commentaires
  • Clair
 Oui Commentaires
Strictes Indique si l’échec d’un fournisseur ou d’un collecteur entraîne l’échec de l’opération de démarrage. Si cet attribut est défini sur false, l’opération de démarrage réussit même si certains collecteurs ou fournisseurs échouent. Au moins un collecteur et un fournisseur doivent réussir pour que l’opération continue. Si cet attribut est défini sur true, les informations sur les fournisseurs ou les collecteurs qui n’ont pas pu démarrer sont fournies sous forme d’avertissements, au lieu d’erreurs. boolean Non false
Interne Indique si le profil est interne. boolean Non false
Par défaut Indique si le profil est un profil par défaut. boolean Non false

Éléments enfants

Élément Description Condition requise
ProblemCategories Représente une collection de catégories de problèmes. Obligatoire, exactement 1.
Collecteurs Représente une collection de collecteurs pour le profil. Obligatoire, exactement 1.
TraceMergeProperties Représente une collection de properites de fusion de traces. Facultatif, exactement 1.

Éléments parents

Élément Description
Profils Représente une collection de collecteurs, de fournisseurs et de profils.

Notes

Chaque fichier .wprp contient généralement au moins deux définitions de profil : une pour chaque mode de journalisation. L’exception est que les profils de transition activés/désactivés peuvent être enregistrés uniquement dans un fichier, de sorte que le fichier .wprp pour ces profils ne peut contenir qu’une seule définition de profil. Chaque fichier .wprp peut contenir au plus quatre profils : un pour chaque combinaison de mode de journalisation et de niveau de détail. Tous les profils d’un fichier .wprp unique doivent avoir la même valeur pour l’attribut Name .

Construisez la valeur de l’attribut Id en combinant les valeurs des attributs Name, DetailLevel et LoggingMode , séparées par des points, comme illustré dans l’exemple suivant.

Les profils dérivés ont tous les attributs du profil de base par défaut. Celles-ci peuvent être remplacées en les spécifiant explicitement dans le profil dérivé. Pour plus d’informations, consultez Héritage.

Exemple

L’exemple de code suivant montre une définition de profil.

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

Les collecteurs et les fournisseurs peuvent également être définis sur place, à l’intérieur de la définition de profil.

Éléments