Поделиться через

Сложный тип ChannelType

  • Статья

Определяет канал, в который поставщики могут регистрировать события.

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

Дочерние элементы

Элемент Тип Описание
Ведение журнала ChannelLoggingType Определяет свойства файла журнала, который поддерживает канал, например его емкость и является ли файл журнала последовательным или циклическим.
Публикации ChannelPublishingType Определяет свойства ведения журнала для сеанса, который использует канал. Только каналы отладки и аналитики, а также каналы, использующие пользовательскую изоляцию, могут указывать свойства ведения журнала для своего сеанса.

Атрибуты

Имя Тип Описание
access строка Дескриптор доступа на языке определения дескриптора безопасности (SDDL), который управляет доступом к файлу журнала, который поддерживает канал. Если атрибут изоляции имеет значение Application или System, дескриптор доступа управляет доступом на чтение к файлу (разрешения на запись игнорируются). Если атрибут изоляции имеет значение Custom, дескриптор доступа управляет доступом на запись в канал и доступом на чтение к файлу.
Chid token Идентификатор, однозначно определяющий канал в списке каналов, которые определяет или импортирует поставщик. Используйте это значение при ссылке на канал в событии. Если идентификатор канала не указан, используйте имя канала для ссылки на этот канал в определении события.
Включено Логическое Определяет, включен ли канал. Задайте значение true , чтобы разрешить ведение журнала в канале; в противном случае — false. Значение по умолчанию — false (ведение журнала отключено).
Так как типы каналов отладки и аналитики являются каналами большого объема, канал следует включать только при изучении проблемы с компонентом, который выполняет запись в этот канал. В противном случае канал должен оставаться отключенным.
При каждом включении канала отладки и аналитики служба очищает события из канала.
изоляция строка Значение изоляции определяет разрешения доступа по умолчанию для канала. Можно указать одно из следующих значений.
  • Приложение
  • Системные функции
  • Custom
Изоляция по умолчанию — Application. Разрешения по умолчанию для приложения : (показано с помощью SDDL):
Текст 
            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)

Разрешения по умолчанию для system (показаны с помощью SDDL):

Текст 
            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)

Разрешения по умолчанию для пользовательской изоляции такие же, как у приложения.

Каналы, определяющие изоляцию приложений , используют один и тот же сеанс трассировки событий Windows. То же самое относится и к изоляции системы . Однако если указать пользовательскую изоляцию, служба создаст отдельный сеанс трассировки событий Windows для канала. Использование пользовательской изоляции позволяет управлять разрешениями на доступ к каналу и резервному файлу. Так как доступно только 64 сеанса трассировки событий Windows, следует ограничить использование пользовательской изоляции.
message строка

Локализованное отображаемое имя канала. Строка сообщения ссылается на локализованную строку в разделе stringTable манифеста.
name anyURI

Имя канала. Имя должно быть уникальным в списке каналов, которые использует поставщик. Соглашение об именовании каналов заключается в добавлении типа канала к имени поставщика. Например, если выбран диапазон 10.0.0.0/20 для виртуальной сети, для пространства клиентских адресов можно выбрать 10.1.0.0/24. Если поставщику присвоено имя Company-Product-Component и вы определяете операционный канал, это будет название Company-Product-Component/Operational.

Имена каналов должны содержать менее 255 символов и не могут содержать следующие символы: ">", "<", "&", "", "|", "\", ":", "", "?", "*" или символы с кодами менее 31.
символ CSymbolType

Символ, используемый для ссылки на канал в приложении. Компилятор сообщений (MC.exe) использует символ для создания константы для канала в файле заголовка, создаваемом компилятором. Если символ не указан, компилятор создаст имя.
type строка

Определяет тип канала. Можно указать один из следующих типов:

  • Администратор
  • Операционный
  • Аналитический
  • Отладка

каналы типа Администратор поддерживают события, предназначенные для конечных пользователей, администраторов и сотрудников службы поддержки. События, записанные в каналы Администратор, должны иметь четко определенное решение, с которым может действовать администратор. Примером события администрирования является событие, возникающее, когда приложению не удается подключиться к принтеру. Эти события либо хорошо документированы, либо имеют сообщение, связанное с ними, которое дает читателю прямые инструкции о том, что необходимо сделать для устранения проблемы.

Каналы рабочего типа поддерживают события, используемые для анализа и диагностики проблемы или возникновения. Они могут использоваться для запуска инструментальных средств или задач, исходя из проблемы или происхождения события. Примером события операционного типа может служить событие, происходящее при добавлении или удалении принтера из системы.

Каналы типа аналитики поддерживают события, публикуемые в большом объеме. Они описывают функционирование программы и указывают проблемы, которые не могут быть устранены вмешательством пользователя.

Каналы типа отладки поддерживают события, которые используются исключительно разработчиками для диагностики проблемы при отладке.

Каналы аналитики и отладки отключены по умолчанию и должны быть включены только для определения причины проблемы. Например, необходимо включить канал, запустить сценарий, вызывающий проблему, отключить канал, а затем запросить события. Обратите внимание, что включение канала очищает канал от существующих событий. Если канал аналитики и отладки использует циклический резервный файл, необходимо отключить канал для запроса его событий.

Все Администратор каналы используют один и тот же сеанс трассировки событий Windows; то же самое верно для операционных каналов. Однако каждый канал аналитики и отладки использует отдельный сеанс трассировки событий Windows, что является еще одной причиной включения этих типов каналов только при необходимости (доступно ограниченное количество сеансов ETW).
значение UInt8Type

Числовой идентификатор, однозначно определяющий канал в списке каналов, определяемых поставщиком. Компилятор сообщений присваивает значение, если оно не указано.

Комментарии

Если имя канала соответствует соглашению об именовании каналов, Просмотр событий Windows выдаст список канала, используя строку, следующую за обратной косой чертой. Например, если каналу присвоено имя Company-Product-Component/Operational, то Просмотр событий перечислит канал как операционный в поставщике Company-Product-Component. В противном случае в поставщике отображается все имя канала. Если оно указано, используется локализованное отображаемое имя.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]

`