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

EventCollector

  • Статья

Представляет сборщик событий для профиля.

Иерархия элементов

Синтаксис

<EventCollector Id             = IdType
                Base           = string
                Name           = string
                FileName       = string
                Realtime       = boolean
                Private        = boolean
                ProcessPrivate = boolean
                Secure         = boolean>

  <!-- Child elements -->
  BufferSize,
  Buffers,
  StackCaching,
  MaximumFileSize,
  FileMax,
  FlushTimer,
  FlushThreshold
</EventCollector>

Атрибуты и элементы

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Id Уникально идентифицирует сборщик событий. Строка, которая должна содержать по крайней мере один символ и не может содержать двоеточие (:) или пробелы. Да
Базы Определяет базу сборщика событий. строка Нет
имя; Указывает имя сеанса трассировки событий Windows. строка Да
FileName Указывает файл, в который регистрируются события. строка Да
Realtime Указывает, работает ли сборщик событий в режиме реального времени. Логическое Нет false
Частная Если задано значение true, указывает на сеанс в пользовательском режиме, который выполняется в том же процессе, что и поставщик событий. Если задано значение false, указывает на глобальный сеанс в пользовательском режиме. Логическое Нет false
ProcessPrivate Если задано значение true, указывает сеанс в пользовательском режиме, который выполняется в том же процессе, что и его поставщик событий, и должен контролироваться только процессом, который зарегистрировал поставщика. Если задано значение false, указывает на глобальный сеанс в пользовательском режиме. Используйте этот атрибут в сочетании с атрибутом Private . Логическое Нет false
Безопасность Если задано значение true, это означает, что только пользователи с правами администратора и соответствующими правами доступа могут управлять сеансом. Если задано значение false, означает, что все пользователи могут управлять сеансом. Логическое Нет false

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

Элемент Описание Требование Значение по умолчанию
BufferSize Описывает размер каждого буфера в КБ. Необязательный, 1. 128
Buffers Описывает количество буферов, выделяемых при запуске сеанса. Необязательный, 1. 64
StackCaching Описывает атрибуты кэширования стека сборщиков. Необязательный, 1.
MaximumFileSize Описывает максимальный размер файла трассировки. Необязательный, 1.
FileMax Описывает максимальное число экземпляров файла журнала, создаваемого трассировой событий Windows для трассировки автолога. Необязательный, 1.

Родительские элементы

Элемент Описание
Profiles Представляет коллекцию сборщиков, поставщиков и профилей.

Комментарии

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

Производные сборщики наследуют все атрибуты базового сборщика, если они явно не указаны в производном сборщике. Дополнительные сведения см. в разделе Наследование.

Пример

В следующем примере кода определяется сборщик событий с 64 буферами по 128 КБ каждый.

<EventCollector
  Id="WPREventCollector"
  Name="WPR Event Collector"
  FileName="somefilename.etl"> 
  <BufferSize
    Value="128"/> 
  <Buffers
    Value="64"/>
</EventCollector>

Elements (XElement Dynamic Property) (Elements (Динамическое свойство XElement))