Сложный тип ChannelPublishingType

Статья
06/13/2023

Определяет свойства ведения журнала для сеанса, который использует канал.

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

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

Элемент	Тип	Описание
bufferSize	UInt32Type	Объем памяти в килобайтах, выделяемой для каждого буфера. Если ожидается относительно низкая частота событий, размер буфера должен быть установлен на размер страницы памяти. Если ожидается, что частота событий будет относительно высокой, следует указать больший размер буфера и увеличить максимальное число буферов. Размер буфера влияет на скорость заполнения буферов и должна быть сброшена. Хотя небольшой размер буфера требует меньше памяти, он увеличивает скорость очистки буферов. Размер буфера по умолчанию для каналов аналитики и отладки составляет 4 КБ, а для Администратор и операционных — 64 КБ.
clockType		Разрешение часов, используемое при регистрации метки времени для каждого события. Можно указать SystemTime или QPC. SystemTime предоставляет метку времени с низким разрешением (10 миллисекундах), но сравнительно дешевле для извлечения. Значение по умолчанию — SystemTime. Счетчик производительности запросов (QPC) предоставляет метку времени с высоким разрешением (100 наносекунд), но сравнительно дороже для извлечения. Если у вас высокая частота событий или потребитель объединяет события из разных буферов, следует выполнить QPC.
controlGuid	GUIDType	Идентифицирует GUID сеанса трассировки событий Windows, содержащего события WPP. Этот параметр разрешен только для каналов типа Debug. Эти каналы не могут быть полностью включены с ключевыми словами, равными нулю (0x0000000000000000). Они должны быть включены с ключевыми словами, для 0xffffffffffffffff.
fileMax	UInt32Type	Максимальное количество раз, когда служба должна создавать новый файл журнала при включении канала (включая перезагрузку компьютера). Если значение равно 0 или 1, служба будет перезаписывать файл журнала каждый раз, когда канал включен, и предыдущие события будут потеряны. Если значение больше 1, служба будет создавать новый файл журнала при каждом включении канала, чтобы сохранить события. Значение по умолчанию — 1, а максимальное значение, которое можно указать, — 16. Служба добавляет трехзначное десятичное число между 0 и fileMax 1 к каждому имени файла. Например, filename.etl.xxx, где xxx — трехзначное десятичное число. Файлы находятся в папке %windir%\System32\winevt\Logs.
Ключевые слова	UInt64Type	Битовая маска, определяющая категорию событий, записываемых в канал. Если значение атрибута keywords равно 0, все события, записываемые поставщиком, записываются в канал; В противном случае в канал записываются только те события, которые определяют ключевое слово, включенные в битовую маску ключевых слов. Значение по умолчанию равно 0. Каналы отладки, для которых задан атрибут controlGuid, должны задать для атрибута keywords значение 0xFFFFFFFFFFFFFFFF. Сеанс передает значение ключевых слов поставщику, когда он включает поставщик.
Задержки	UInt32Type	Время ожидания перед очисткой буферов в миллисекундах. Если значение равно нулю, трассировка событий Windows очищает буферы сразу после их заполнения. Если значение не равно нулю, трассировка событий Windows очищает все буферы, содержащие события, на основе значения, даже если буфер не заполнен. Как правило, буферы нужно очищать только тогда, когда они заполнены. Принудительное удаление буферов может увеличить размер файла журнала с незаполненным буферным пространством. Значение по умолчанию — 1 секунда для журналов Администратор и операционных журналов и 5 секунд для журналов аналитики и отладки.
Уровень	UInt8Type	Уровень серьезности событий, записываемых в канал. Служба записывает в канал события, имеющие значение уровня, которое меньше или равно указанному значению. Значение по умолчанию — 0, что означает регистрировать события с любым значением уровня. Сеанс передает значение уровня поставщику, когда он включает поставщик.
maxBuffers	UInt32Type	Максимальное количество буферов, выделяемых для сеанса. Как правило, это минимальное число буферов плюс двадцать. Это значение должно быть больше или равно значению, указанному для minBuffers. Максимальное число буферов по умолчанию для каналов аналитики и отладки составляет 10 КБ, а для Администратор и операционных — 64 КБ.
minBuffers	UInt32Type	Минимальное количество буферов, выделяемых для сеанса. По умолчанию используется значение ноль.
sidType		Определяет, следует ли включать идентификатор безопасности (SID) субъекта с каждым событием, записанным в канал. Чтобы включить идентификатор безопасности в событие, присвойте этому атрибуту значение "Публикация". Идентификатор безопасности задается на основе удостоверения потока во время записи события. Если вы не хотите включать идентификатор безопасности в событие, задайте для этого атрибута значение None. Значение по умолчанию — "Публикация".

При заполнении буфера трассировка событий Windows сбрасывает его в файл журнала. Если буферы заполняются быстрее, чем их можно очистить, новые буферы выделяются и добавляются в буферный пул сеанса вплоть до указанного максимального числа. За пределами этого ограничения сеанс удаляет входящие события до тех пор, пока буфер не станет доступным.

Требования

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

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

Сложный тип ChannelPublishingType

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

Комментарии

Требования

Обратная связь

Обратная связь

Дополнительные ресурсы