Compartir a través de


Tipo complejo ChannelPublishingType

Define las propiedades de registro de la sesión que usa el canal.

<xs:complexType name="ChannelPublishingType">
    <xs:sequence
        minOccurs="0"
    >
        <xs:element name="level"
            type="UInt8Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="keywords"
            type="UInt64Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="controlGuid"
            type="GUIDType"
            minOccurs="0"
         />
        <xs:element name="bufferSize"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="minBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="fileMax"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="maxBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="latency"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="clockType"
            default="SystemTime"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="SystemTime"
                     />
                    <xs:enumeration
                        value="QPC"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:element name="sidType"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="None"
                     />
                    <xs:enumeration
                        value="Publishing"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:any
            processContents="lax"
            minOccurs="0"
            maxOccurs="unbounded"
            namespace="##other"
         />
    </xs:sequence>
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

Elementos secundarios

Elemento Tipo Descripción
bufferSize UInt32Type Cantidad de memoria, en kilobytes, que se va a asignar para cada búfer. Si espera una tasa de eventos relativamente baja, el tamaño del búfer debe establecerse en el tamaño de página de memoria. Si se espera que la tasa de eventos sea relativamente alta, debe especificar un tamaño de búfer mayor y aumentar el número máximo de búferes.
El tamaño del búfer afecta a la velocidad a la que se rellenan los búferes y se deben vaciar. Aunque un tamaño de búfer pequeño requiere menos memoria, aumenta la velocidad a la que se deben vaciar los búferes.
El tamaño de búfer predeterminado para los canales analíticos y de depuración es de 4 KB y para Administración y operativo es de 64 KB.
clockType Resolución de reloj que se va a usar al registrar la marca de tiempo para cada evento. Puede especificar SystemTime o QPC. SystemTime proporciona una marca de tiempo de baja resolución (10 milisegundos), pero es comparativamente menos costosa para recuperar. El valor predeterminado es SystemTime.
El contador de rendimiento de consultas (QPC) proporciona una marca de tiempo de alta resolución (100 nanosegundos), pero es comparativamente más costosa para recuperar. Debe QPC si tiene altas tasas de eventos o si el consumidor combina eventos de diferentes búferes.
controlGuid GUIDType Identifica el GUID de sesión de una sesión ETW que contiene eventos de WPP. Esta configuración solo se permite para los canales de tipo Depuración. Estos canales no se pueden habilitar completamente con palabras clave establecidas en cero (0x0000000000000000). Deben habilitarse con palabras clave establecidas en 0xffffffffffffffff.
fileMax UInt32Type Número máximo de veces que desea que el servicio cree un nuevo archivo de registro cuando el canal está habilitado (incluye cuando se reinicia el equipo). Si el valor es 0 o 1, el servicio sobrescribirá el archivo de registro cada vez que el canal esté habilitado y se perderán los eventos anteriores. Si el valor es mayor que 1, el servicio creará un nuevo archivo de registro cada vez que el canal esté habilitado para conservar los eventos. El valor predeterminado es 1 y el máximo que puede especificar es 16.
El servicio anexa un número decimal de tres dígitos entre 0 y fileMax 1 a cada nombre de archivo. Por ejemplo, filename.etl.xxx, donde xxx es el número decimal de tres dígitos. Los archivos se encuentran en %windir%\System32\winevt\Logs.
Palabras clave UInt64Type Máscara de bits que determina la categoría de eventos que se escriben en el canal. Si el valor del atributo keywords es 0, todos los eventos que escribe el proveedor se escriben en el canal; de lo contrario, solo los eventos que han definido una palabra clave que se incluye en la máscara de bits de las palabras clave se escriben en el canal. El valor predeterminado es 0.
Los canales de depuración que tienen establecido el atributo controlGuid deben establecer el atributo keywords en 0xFFFFFFFFFFFFFFFF.
La sesión pasa el valor de palabras clave al proveedor cuando habilita el proveedor.
Latencia UInt32Type Tiempo de espera antes de vaciar los búferes, en milisegundos. Si es cero, ETW vacía los búferes en cuanto se llenan. Si no es cero, ETW vacía todos los búferes que contienen eventos basados en el valor incluso si el búfer no está lleno. Normalmente, solo quiere vaciar los búferes cuando se llenan. Forzar el vaciado de los búferes puede aumentar el tamaño del archivo de registro con espacio de búfer no rellenado. El valor predeterminado es 1 segundo para los registros de Administración y operativos y 5 segundos para los registros analíticos y de depuración.
Nivel UInt8Type Nivel de gravedad de los eventos que se van a escribir en el canal. El servicio escribe eventos en el canal que tienen un valor de nivel menor o igual que el valor especificado. El valor predeterminado es 0, lo que significa registrar eventos con cualquier valor de nivel.
La sesión pasa el valor de nivel al proveedor cuando habilita el proveedor.
maxBuffers UInt32Type Número máximo de búferes que se van a asignar para la sesión. Normalmente, este valor es el número mínimo de búferes más veinte. Este valor debe ser mayor o igual que el valor especificado para minBuffers.
El número máximo predeterminado de búferes para los canales analíticos y de depuración es de 10 KB y para Administración y operativo es de 64 KB.
minBuffers UInt32Type Número mínimo de búferes que se van a asignar para la sesión. El valor predeterminado es cero.
sidType Determina si se debe incluir un identificador de seguridad (SID) de la entidad de seguridad con cada evento escrito en el canal. Para incluir el SID con el evento, establezca este atributo en "Publishing". El SID se establece en función de la identidad del subproceso en el momento en que se escribe el evento. Si no desea incluir el SID con el evento, establezca este atributo en "None". El valor predeterminado es "Publishing".

Observaciones

Puede especificar esta información de publicación para los tipos de canal de análisis y depuración o para cualquier canal que especifique aislamiento personalizado.

Aunque puede especificar el nivel y las palabras clave, debe tener en cuenta que estos serán los únicos eventos que recibirá del proveedor para ese canal.

Cuando un búfer está lleno, ETW vacía el búfer en el archivo de registro. Si los búferes se rellenan más rápido de lo que se pueden vaciar, se asignan y agregan nuevos búferes al grupo de búferes de la sesión, hasta el número máximo especificado. Más allá de este límite, la sesión descarta los eventos entrantes hasta que un búfer esté disponible.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]