Perfil

Representa una colección de categorías de problemas y elementos recopiladores.

Jerarquía de elementos

• < WindowsPerformanceRecorder>
  • < Perfiles>
    • < Perfil>

Sintaxis

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

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
Id	Identifica de forma única el perfil.	Cadena que debe tener al menos un carácter y no puede contener dos puntos o espacios.	Sí
Nombre	Indica el nombre del perfil.	string	Sí
Descripción	Indica la descripción del perfil.	string	Sí
Base	Indica la base del perfil.	string	No
LoggingMode	Indica si WPR escribe en memoria o en un archivo secuencial.	Este atributo puede tener uno de los siguientes valores: Archivo Memoria	Sí	Archivo
DetailLevel	Especifica si se usa una definición de perfil para el seguimiento de tiempo (Light) o el seguimiento de análisis (Verbose).	Este atributo puede tener uno de los siguientes valores: Verbose Claro	Sí	Verbose
Strict	Indica si el error de un proveedor o recopilador produce un error en la operación de inicio. Si este atributo se establece falseen , la operación de inicio se realiza correctamente incluso si se produce un error en algunos recopiladores o proveedores. Al menos un recopilador y un proveedor deben realizarse correctamente para que la operación continúe. Si este atributo se establece trueen , la información sobre proveedores o recopiladores que no se pudieron iniciar se proporciona como advertencias, en lugar de errores.	boolean	No	false
Interno	Indica si el perfil es interno.	boolean	No	false
Valor predeterminado	Indica si el perfil es un perfil predeterminado.	boolean	No	false

Elementos secundarios

Elemento	Descripción	Requisito
ProblemCategories	Representa una colección de categorías de problemas.	Obligatorio, exactamente 1.
Recopiladores	Representa una colección de recopiladores para el perfil.	Obligatorio, exactamente 1.
TraceMergeProperties	Representa una colección de elementos adecuados de combinación de seguimiento.	Opcional, exactamente 1.

Elementos primarios

Elemento	Descripción
Perfiles	Representa una colección de recopiladores, proveedores y perfiles.

Comentarios

Cada archivo .wprp normalmente contiene al menos dos definiciones de perfil: una para cada modo de registro. La excepción es que los perfiles de transición activados o desactivados solo se pueden registrar en el archivo, por lo que el archivo .wprp de esos perfiles solo puede contener una definición de perfil. Cada archivo .wprp puede contener como máximo cuatro perfiles: uno para cada combinación de modo de registro y nivel de detalle. Todos los perfiles de un único archivo .wprp deben tener el mismo valor para el atributo Name .

Construya el valor del atributo Id combinando los valores de los atributos Name, DetailLevel y LoggingMode , separados por puntos, como se muestra en el ejemplo siguiente.

Los perfiles derivados tienen todos los atributos del perfil base de forma predeterminada. Se pueden invalidar especificando explícitamente en el perfil derivado. Para obtener más información, vea Herencia.

Ejemplo

En el ejemplo de código siguiente se muestra una definición 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>

Los recopiladores y proveedores también se pueden definir en su lugar, dentro de la definición del perfil.

Temas relacionados

Elements