Создание сеанса расширенных событий в диалоговом окне «Создание сеанса»

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

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

В начало

Чтобы открыть диалоговое окно нового сеанса, разверните в обозревателе объектов узел Управление, а затем узел Расширенные события. Щелкните правой кнопкой мыши Сеансы и выберите Создать сеанс.

Разрешения

Для создания сеанса расширенных событий требуется разрешение ALTER ANY EVENT SESSION.

Создание сеанса расширенных событий в диалоговом окне «Создание сеанса»

Выберите шаблон и расписание сеанса событий на странице Общие.

Выберите шаблон и расписание сеанса событий

  1. В обозревателе объектов разверните узел Управление, затем узел Расширенные события. Щелкните правой кнопкой мыши Сеансы и выберите Создать сеанс.

  2. На странице Общие в поле Имя сеанса введите для сеанса события осмысленное имя.

  3. В поле Шаблон выберите необходимый шаблон из раскрывающегося списка.

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

  4. Если требуется начать сеанс при запуске сервера, то в разделе Расписание установите флажок для пункта Начать сеанс события при запуске сервера.

    Если нужно начать сеанс после создания сеанса, установите флажок для пункта Начать сеанс события сразу после создания сеанса.

  5. Для просмотра данных сеанса событий, передаваемых в режиме реального времени, нажмите кнопку Смотреть данные, передаваемые в режиме реального времени, на экране по мере их захвата. Данные, передаваемые в режиме реального времени, будут отображаться сразу после создания сеанса.

  6. В разделе Отслеживание причинности установите флажок для пункта Следить за тем, как события связаны друг с другом, чтобы отслеживать взаимосвязи между несколькими задачами.

    Дополнительные сведения об отслеживании причинности см. в подразделе «Характеристики и содержимое сеанса» раздела Сеансы расширенных событий SQL Server.

    Чтобы добавить события в сеанс, в разделе Выбор страницы нажмите кнопку События.

    ПримечаниеПримечание

    Не нажимайте кнопку ОК до завершения создания сеанса событий.

На странице События найдите и добавьте события, которые необходимо отслеживать в сеансе.

Добавление событий к сеансу

  1. В диалоговом окне нового сеанса в разделе Выбор страницы выберите События.

  2. На странице События нажмите кнопку Выбор (кнопка Выбор недоступна, если экран Выбор событий для отслеживания уже открыт).

    В диалоговом окне Найти в расширенных событиях в поле Найти введите текст для поиска. Например, если необходимо найти событие lock_acquired, можно ввести lock или lock acquire.

  3. В разделе Библиотека событий выберите в раскрывающемся списке способ поиска событий для отслеживания. Например, можно выполнить поиск имен событий или имен событий и их описаний. Введите условия поиска в поле Поиск.

    ПримечаниеПримечание

    События из канала Debug скрыты по умолчанию. Чтобы просмотреть события отладки, выберите Отладка в раскрывающемся списке Каналы.

    Сведения о выбранных событиях отображаются на панели «Сведения» в разделе Библиотека событий.

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

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

    ПримечаниеПримечание

    В разделе Библиотека событий можно выбрать несколько событий одновременно с помощью клавиш CTRL или SHIFT.

    Для настройки выбранных событий нажмите кнопку Настройка.

    ПримечаниеПримечание

    Не нажимайте кнопку ОК до завершения создания сеанса событий.

Добавление целевых объектов в сеанс событий производится на странице Хранение данных. Целевые объекты хранят данные и могут выполнять действия, такие как сохранение событий в файл для дальнейшего просмотра и статистической обработки данных сеанса. Дополнительные сведения о целевых объектах расширенных событий см. в разделе Цели расширенных событий SQL Server.

Ниже приведены целевые объекты, которые могут быть использованы для сеанса расширенных событий.

  • etw_classic_sync_target. Служит для согласования событий SQL Server с данными событий приложений и операционной системы Windows.

  • event_counter. Относится ко всем событиям, происходящими после запуска сеанса расширенных событий. Эта цель используется для получения сведений о характеристиках рабочей нагрузки без затрат на сбор всех событий.

  • event_file. Используется для записи выходных данных сеанса событий из полных буферов памяти на диск.

  • histogram. Используется для подсчета количества указанных событий на основании указанного действия или столбца события.

  • pair_matching. Эта цель позволяет определить, что указанное парное событие не произошло в правильной последовательности.

  • ring_buffer. Используется для хранения данных о событиях в памяти по принципу очереди (FIFO) или по принципу FIFO для каждого события.

Настройка глобальных полей для сеанса

  1. На странице События после выбора события или событий, которые необходимо добавить к сеансу событий, нажмите кнопку Настройка.

    После нажатия кнопки Настройка раскроется раздел Библиотека событий, а раздел Выбранные события перейдет в левую часть страницы. Раздел Параметры конфигурации событий, который служит для настройки событий, появится в правой части страницы. Используйте вкладки на этой странице для настройки действий для сеанса события.

  2. На вкладке Глобальные поля выберите поля, которые необходимо применить к выбранным событиям.

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

    ПримечаниеПримечание

    Если два уже выбранных события имеют разные настроенные действия, то в области «Расширенные события» будут отображаться частично проверенные действия. Чтобы можно было быстро найти включенные действия, отсортируйте их по состоянию «вкл./выкл.», щелкнув по заголовку столбца над полями выбора.

  3. На вкладке Фильтры примените фильтры (также называемые предикатами) для ограничения событий, которые необходимо записывать.

    Если фильтр применен к выбранному событию, то в столбце появляется флажок.

    ПримечаниеПримечание

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

    ПримечаниеПримечание

    При настройке предложения группирования для фильтра лишние круглые скобки будут удалены из фильтра после сохранения результата. Например, при создании фильтра группирования Предложения 1 и Предложения 2 предложения будут заключаться в круглые скобки. После сохранения фильтра лишние круглые скобки будут удалены. Удаление круглых скобок не влияет на логику фильтрации.

  4. На вкладке Поля событий выберите поля событий, которые необходимо применить к выбранному событию.

    События содержат число полей, которые собираются всегда и отображаются на вкладке Поля событий без флажка. Событие также может иметь дополнительные поля, сбор которых по умолчанию не выполняется (например, не производится сбор ресурсоемких необязательных полей). Дополнительные поля также приводятся на вкладке Поля событий с флажками. Чтобы производился сбор для дополнительного поля, установите для него флажок.

    ПримечаниеПримечание

    В параметрах поля события отображаются поля, которые будут записываться и которые можно будет просмотреть в результатах трассировки. (Расширенные события отображают только типы данных полей событий. Например, поля только для чтения не отображаются.) Если выбрано несколько событий, то диалоговое окно «Создание сеанса» на вкладке Поля событий будет отображаться пустым.

  5. Чтобы добавить в сеанс событий целевые объекты, в разделе Выбор страницы выберите Хранение данных.

    ПримечаниеПримечание

    Не нажимайте кнопку ОК до завершения создания сеанса событий.

Добавление целевых объектов в сеанс событий

  1. В диалоговом окне «Новый сеанс» в разделе Выбор страницы выберите Хранение данных.

  2. На странице Хранение данных выберите тип целевого объекта из раскрывающегося списка.

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

  3. Нажмите кнопку Добавить, чтобы добавить целевой объект в сеанс событий. Если необходимо удалить целевой объект, нажмите кнопку Удалить.

    Свойства целевого объекта отображаются в разделе Целевые объекты. Их набор зависит от выбранного целевого объекта.

  4. Ниже перечислены свойства, которые можно указать в зависимости от выбранного целевого объекта.

    Назначение

    Свойства целевого объекта

    etw_classic_sync_target

    Имя файла журнала сеанса на сервере. Введите имя файла журнала и папки на сервере или нажмите кнопку Обзор, чтобы найти и выбрать файл журнала.

    Максимальный размер файла журнала. Введите максимальный размер файла журнала для отслеживания событий для события Windows (ETW). По умолчанию он составляет 20 мегабайт (МБ). Другую единицу хранения можно выбрать в раскрывающемся списке.

    Размер буфера. Введите размер встроенного буфера для сеанса событий. Значение по умолчанию — 128 КБ. Другую единицу хранения можно выбрать в раскрывающемся списке.

    Имя сеанса. Введите понятное имя сеанса трассировки событий Windows.

    Повторить при появлении ошибки записи в сеанс трассировки событий Windows. Установите этот флажок, чтобы производилась попытка повторной публикации события в подсистеме трассировки событий Windows.

    Максимальное число попыток. Введите максимальное число попыток публикации события в подсистеме ETW, прежде чем это событие будет удалено. По умолчанию число попыток равно нулю (0). Для этого свойства целевого объекта нуль (0) означает нулевое количество попыток.

    event_counter

    Нет свойств целевого объекта для счетчика событий.

    event_file

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

    Максимальный размер файла. Укажите максимальный размер файла целевого объекта. Если максимальный размер файла не задан, файл будет увеличиваться до заполнения диска. Размер файла по умолчанию составляет 1 ГБ. Другую единицу хранения можно выбрать в раскрывающемся списке.

    Включить переключение файлов. Установите этот флажок, чтобы включить переключение файлов для файла целевого объекта.

    Максимальное число файлов. Введите максимальное число файлов, которые необходимо хранить в файловой системе.

    гистограмма

    События для фильтрации. Выберите событие для фильтрации из раскрывающегося списка. Можно выполнить фильтрацию по любому событию в сеансе событий. Можно также выбрать из раскрывающегося списка <Нет>, чтобы включить все события и базовые сегменты в действии.

    Базовые сегменты в действии. Выберите этот параметр, чтобы создать сегменты на имя действия, которое используется в качестве источника данных, а затем выберите действие из раскрывающегося списка.

    Базовые сегменты в поле. Выберите этот параметр, чтобы создать сегменты по полю события, которое используется в качестве источника данных, а затем выберите поле из раскрывающегося списка.

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

    pair_matching

    События: начиная с. Выберите имя события из раскрывающегося списка, которое задает событие начала в парной последовательности.

    События: заканчивая. Выберите имя события из раскрывающегося списка, которое задает событие конца в парной последовательности.

    Поля и действия: начиная с. Выберите поле начала или действие в парной последовательности из раскрывающегося списка.

    Поля и действия: заканчивая. Выберите поле конца или действие в парной последовательности из раскрывающегося списка.

    Отменить новые непарные события при нехватке памяти. Установите этот флажок, чтобы остановить сбор событий по целевому объекту pair_matching при нехватке свободной памяти. Как только памяти будет достаточно, сбор событий продолжится.

    Максимальное число потерянных событий. Укажите максимальное число потерянных событий, которые необходимо хранить в памяти.

    ring_buffer

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

    Максимальный размер буферной памяти. Введите максимальный объем используемой памяти. При достижении этого значения существующие события будут удалены. Объем памяти по умолчанию равен 0 МБ, объем памяти неограничен. Другую единицу хранения можно выбрать в раскрывающемся списке.

    Оставить заданное число событий (каждого типа) при переполнении буфера. Выберите этот параметр, чтобы сохранить заданное число событий каждого типа в буфере.

    Число событий, которые необходимо хранить (каждого типа). Введите нужное число событий каждого типа, которые необходимо хранить в буфере.

  5. Чтобы задать дополнительные свойства конфигурации, выберите вкладку Дополнительно в разделе Выбор страницы.

    ПримечаниеПримечание

    Не нажимайте кнопку ОК до завершения создания сеанса событий.

Установка дополнительных параметров

  1. В диалоговом окне «Создание сеанса» в разделе Выбор страницы выберите Дополнительно.

  2. На странице Дополнительно выполните следующие действия, чтобы задать параметры Режима хранения событий для сеанса событий.

    1. Потеря одиночных событий. Выберите этот параметр, чтобы разрешить потерю одиночного события.

    2. Потеря нескольких событий. Выберите этот параметр, чтобы разрешить потерю нескольких событий.

    3. Без потери событий. Выберите этот параметр, если требуется предотвратить потерю событий. Выбирать этот параметр не рекомендуется.

      ПримечаниеПримечание

      Некоторые события, например sqlos.wait_info, несовместимы с режимом хранения Без потери событий.

  3. Чтобы задать параметры Максимальной задержки диспетчеризации для сеанса событий, выполните следующие действия.

    1. В секундах. Выберите этот параметр, чтобы увеличить или сократить максимальную задержку диспетчеризации. Задайте максимальную задержку диспетчеризации в секундах с помощью стрелок вверх и вниз.

    2. Неограниченно. Выберите этот параметр, если требуется, чтобы события отправлялись только при заполнении буфера событий.

  4. В поле Максимальный размер памяти введите максимальный размер памяти. При достижении этого значения существующие события будут удалены. Другую единицу хранения можно выбрать в раскрывающемся списке.

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

  6. Чтобы задать параметры Режима секционирования памяти для сеанса событий, выполните следующие действия.

    1. Нет. Выберите этот параметр, если требуется отключить режим секционирования памяти.

    2. На узел. Выберите этот параметр, если требуется выделить память на каждый узел.

    3. На ЦП. Выберите этот параметр, если требуется выделить память на каждый ЦП.

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

См. также

Задания

создать сеанс расширенных событий с помощью пользовательского интерфейса нового сеанса (обозреватель объектов)

создать скрипт сеанса расширенных событий

Основные понятия

Создание сеанса расширенных событий с помощью редактора запросов