Tipo complejo ChannelType

Define un canal en el que los proveedores pueden registrar eventos.

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

Elementos secundarios

Elemento Tipo Descripción
Registro ChannelLoggingType Define las propiedades del archivo de registro que hace una copia de seguridad del canal, como su capacidad y si el archivo de registro es secuencial o circular.
Editorial ChannelPublishingType Define las propiedades de registro de la sesión que usa el canal. Solo los canales y canales de depuración y de analítica que usan el aislamiento personalizado pueden especificar propiedades de registro para su sesión.

Atributos

Nombre Tipo Descripción
acceso string Descriptor de acceso del Lenguaje de definición de descriptores de seguridad (SDDL) que controla el acceso al archivo de registro que hace una copia de seguridad del canal. Si el atributo de aislamiento se establece en Aplicación o Sistema, el descriptor de acceso controla el acceso de lectura al archivo (se omiten los permisos de escritura). Si el atributo de aislamiento se establece en Personalizado, el descriptor de acceso controla el acceso de escritura al canal y el acceso de lectura al archivo.
chid token Identificador que identifica de forma única el canal en la lista de canales que el proveedor define o importa. Use este valor al hacer referencia al canal en un evento. Si no especifica un identificador de canal, use el nombre del canal para hacer referencia a este canal en una definición de evento.
enabled boolean Determina si el canal está habilitado. Establezca en true para permitir el registro en el canal; de lo contrario, false. El valor predeterminado es false (el registro está deshabilitado).
Dado que los tipos de canal Depurar y Analítico son canales de gran volumen, debe habilitar el canal solo al investigar un problema con un componente que escribe en ese canal. De lo contrario, el canal debe permanecer deshabilitado.
Cada vez que se habilita un canal de depuración y de analítica, el servicio borra los eventos del canal.
aislamiento de string El valor de aislamiento define los permisos de acceso predeterminados para el canal. Puede especificar uno de los siguientes valores:
  • Aplicación
  • Sistema
  • Personalizada
El aislamiento predeterminado es Application. Los permisos predeterminados para la aplicación son (se muestran mediante SDDL):
Texto
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system               (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins            (read, write, clear)
            L"(A;;0x7;;;SO)"                    // server operators           (read, write, clear)
            L"(A;;0x3;;;IU)"                    // INTERACTIVE LOGON          (read, write)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON             (read, write)
            L"(A;;0x3;;;S-1-5-3)"               // BATCH LOGON                (read, write)
            L"(A;;0x3;;;S-1-5-33)"              // write restricted service   (read, write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers          (read) 

Los permisos predeterminados para System son (se muestran mediante SDDL):

Texto
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system             (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins          (read, write, clear)
            L"(A;;0x3;;;BO)"                    // backup operators         (read, write)
            L"(A;;0x5;;;SO)"                    // server operators         (read, clear) 
            L"(A;;0x1;;;IU)"                    // INTERACTIVE LOGON        (read)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON           (read, write)
            L"(A;;0x1;;;S-1-5-3)"               // BATCH LOGON              (read)
            L"(A;;0x2;;;S-1-5-33)"              // write restricted service (write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers        (read)

Los permisos predeterminados para el aislamiento personalizado son los mismos que los de la aplicación.

Los canales que especifican el aislamiento de la aplicación usan la misma sesión ETW. Lo mismo sucede con el aislamiento del sistema. Sin embargo, si especifica Aislamiento personalizado, el servicio crea una sesión ETW independiente para el canal. El uso del aislamiento personalizado permite controlar los permisos de acceso para el canal y el archivo de respaldo. Dado que solo hay 64 sesiones ETW disponibles, debe limitar el uso del aislamiento personalizado.

message string

Nombre para mostrar localizado del canal. La cadena de mensaje hace referencia a una cadena localizada en la sección stringTable del manifiesto.

name anyURI

Nombre del canal. El nombre debe ser único dentro de la lista de canales que usa el proveedor. La convención para asignar nombres a los canales es anexar el tipo de canal al nombre del proveedor. Por ejemplo. Si el nombre del proveedor es Company-Product-Component y está definiendo un canal operativo, el nombre sería Company-Product-Component/Operational.

Los nombres de canal deben tener menos de 255 caracteres y no pueden contener los siguientes caracteres: ">", "<', '&', '"', '|', '\', ':', '`', '?', '*', or characters with codes less than 31.

símbolo CSymbolType

Símbolo que se usará para hacer referencia al canal en la aplicación. El compilador de mensajes (MC.exe) usa el símbolo para crear una constante para el canal en el archivo de encabezado que genera el compilador. Si no especifica un símbolo, el compilador genera el nombre automáticamente.

tipo string

Identifica el tipo del canal. Puede especificar uno de los siguientes tipos:

  • Administrador
  • Operativos
  • Analíticos
  • Depurar

Los canales de tipo administrador admiten eventos destinados a usuarios finales, administradores y personal de soporte técnico. Los eventos escritos en los canales de administración deben tener una solución bien definida en la que el administrador pueda actuar. Un ejemplo de un evento de administrador es un evento que tiene lugar cuando una aplicación no puede conectarse a una impresora. Estos eventos están bien documentados o tienen un mensaje asociado a ellos que proporciona al lector instrucciones directas de lo que se debe hacer para corregir el problema.

Los canales de tipo operativo admiten eventos que se usan para analizar y diagnosticar un problema o repetición. Se pueden utilizar para activar herramientas o tareas según el problema o la incidencia. Un ejemplo de un evento operativo es un evento que se produce cuando se agrega o se quita una impresora de un sistema.

Los canales de tipo analítico admiten eventos que se publican en gran volumen. Describen el funcionamiento del programa e indican los problemas que el usuario no puede administrar.

Los canales de tipo de depuración admiten eventos que solo usan los desarrolladores para diagnosticar un problema de depuración.

Los canales analíticos y de depuración están deshabilitados de forma predeterminada y solo deben habilitarse para determinar la causa de un problema. Por ejemplo, habilitaría el canal, ejecutaría el escenario que está causando el problema, deshabilitaría el canal y, a continuación, consultaría los eventos. Tenga en cuenta que al habilitar el canal se borra el canal de los eventos existentes. Si el canal analítico y de depuración usa un archivo de respaldo circular, debe deshabilitar el canal para consultar sus eventos.

Todos los canales de administración usan la misma sesión etw; lo mismo sucede con los canales operativos. Sin embargo, cada canal analítico y de depuración usa una sesión ETW independiente, que es otra razón para habilitar solo estos tipos de canal cuando sea necesario (hay un número limitado de sesiones ETW disponibles).

valor UInt8Type

Identificador numérico que identifica de forma única el canal dentro de la lista de canales que define el proveedor. El compilador de mensajes asigna el valor si no se especifica.

Comentarios

Si el nombre del canal sigue la convención de nomenclatura del canal, el Windows Visor de eventos mostrará el canal mediante la cadena que sigue a la barra diagonal inversa. Por ejemplo, si el nombre del canal es Company-Product-Component/Operational, el Visor de eventos mostrará el canal como Operativo en el proveedor Company-Product-Component. De lo contrario, el nombre completo del canal se muestra en el proveedor. Si se proporciona, se usa el nombre para mostrar localizado.

Requisitos

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

`