Отчеты






Текущая версия приложения способна формировать следующие типы отчетов:

  • Опрос — краткая информация о трейс-файле

  • Профиль ресурсов — подробное описание трейс-файла

  • Оптимизация (для предложения/сессии) — отчет о сравнении профилей ресурсов для 2-х или более сессий

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

Опрос

Отчет данного типа предназначен для краткого изучения трейс-файла. Он выводится в виде текста (при работе приложения с интерфейсом командной строки) или в виде диалога (при работе с графическим интерфейсом) и содержит следующие данные:

  • описание трейс-файла (даты, размер, расположение)

  • описание содержимого (уровень трассировки, версия БД, список сессий и т.п.)

  • преамбула трейс-файла

Ниже приведен пример результатов опроса:

Отчет «Опрос»
Рис. 23 Отчет «Опрос»


Инфoрмация по файлу >>>

каталог: C:\LightProfiler\trc\samples

файл: count_one_ora9.trc

создан: 25.11.2011 23:13:06

изменен: 27.11.2011 01:10:18

размер: 52400 байт


Основная информация >>>

версия БД Oracle: 9.2.0.8.0

уровень трас-ки: 12

сессия(и):

*** SESSION ID:(9.3) 2010-02-11 00:04:24.321

имеющиеся "dep": 0, 1, 2

содержит события RPC: False

содержит события LOB: False


Преамбула >>>

Dump file c:\oracle\admin\test9\udump\test9_ora_2816.trc

Thu Feb 11 00:04:24 2010

ORACLE V9.2.0.8.0 - Production vsnsta=0

vsnsql=12 vsnxtr=3

Windows 2000 Version 5.2 Service Pack 2, CPU type 586

Oracle9i Enterprise Edition Release 9.2.0.8.0 - Production

With the Partitioning, OLAP and Oracle Data Mining options

JServer Release 9.2.0.8.0 - Production

Windows 2000 Version 5.2 Service Pack 2, CPU type 586

Instance name: test9

Redo thread mounted by this instance: 1

Oracle process number: 12

Windows thread id: 2816, image: ORACLE.EXE



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

Для формирования отчета выберите пункт меню «Отчеты» - «Опрос» или нажмите соответствующую кнопку на панели инструментов профайлера.

Профиль ресурсов

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

Отчет представляет собой несколько html-файлов, формируемых в каталоге, заданном опцией «Каталог для формирования отчетов» (по умолчанию - <каталог приложения>/output). Файловая структура отчета схематично представлена ниже:

  • <имя трейс-файла>.files – каталог дополнительных данных профиля

    • stmtN.html – отчет для предложения SQL с порядковым номером N2. Описание отчета вы можете найти в разделе Разделы предложений.

    • stmtN_<tim>_<nn> - отчет для снимка состояний предложения SQL, где N – порядковый номер предложения SQL, <tim> - время фиксации снимка состояний (по данным трейс-файла), <nn> - порядковый номер снимка состояний для предложения SQL. Описание отчета вы можете найти в разделе Разделы снимков состояний.

  • <имя трейс-файла>.html – основной отчет, представляющий сводные данные по профилю ресурсов. Описание отчета вы можете найти в разделе Разделы профиля.

Примечание:

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

Формирование отчета может занимать продолжительное время (в зависимости от размера исходного трейс-файла и опций профайлера), поэтому, при формировании отчета, для файла имеющего размер больше 10 Мб, пользователю будет предложено отказаться от использования ресурсоемких опций:

Ресурсоемкие опции
Рис. 24 Ресурсоемкие опции

Запуск формирования отчета возможен через меню «Отчеты» («Активный»/ «Все») - «Профиль» или через панель инструментов приложения, или активного профайлера3. Также вы можете использовать операцию «А&П», выполняющую анализ и генерацию отчета за одно действие.

Разделы профиля

Текущая версия приложения формирует следующие разделы для отчета «Профиль ресурсов»:

  • Параметры — этот раздел содержит четыре блока для отображения следующей информации:

Раздел «Параметры»
Рис. 25 Раздел «Параметры»
    • Параметры профиля — идентификаторы сессий и рассчитанные значения длительности (ЦПУ) и продолжительности (с учетом ожиданий)

    • Статистика предложений SQL – количество различных видов предложений SQL, уровни предложений

    • Опции — значения опций профайлера, использованные при формировании отчета

    • Инфoрмация трейс-файла — расположение, размер, основные даты исходного трейс-файла (создания, модификации)

  • Преамбула — заголовок трейс-файла (см.Глоссарий)

Раздел «Преамбула»
Рис. 26 Раздел «Преамбула»
  • Время отклика по событиям — распределение времени отклика сессии (см.Глоссарий) по событиям БД, их характеристики (длительность — c или ela, продолжительность – e, количество появлений и т.д.).

Раздел «Время отклика по событиям»
Рис. 27 Раздел «Время отклика по событиям»
  • Время отклика по предложениям SQL – распределение времени отклика сессии по предложениям SQL (см. Глоссарий), временные характеристики предложений SQL, количество появлений.

«Время отклика по предложениям SQL»

Рис. 28 Раздел «Время отклика по предложениям SQL»
  • Время отклика по курсорам SQL – распределение времени отклика по курсорам SQL (см. Глоссарий), временные характеристики, количество появлений.

Раздел «Время отклика по курсорам SQL»
Рис. 29 Раздел «Время отклика по курсорам SQL»
  • События — данный раздел содержит описание событий, зафиксированных в трейс-файле, их распределение по предложениям SQL.

Раздел «События»
Рис. 30 Раздел «События»
  • События в предложениях SQL (рекурсивные/ нерекурсивные) — структура этих разделов идентична структуре раздела «Время отклика по событиям», но содержит данные только соответствующего типа предложений SQL (см. Глоссарий).

  • График событий - в данном разделе время отклика сессии представлено в виде гистограммы. Для каждого интервала показаны составляющие события, количество появлений, длительность и т.п.

Раздел «График событий»
Рис. 31 Раздел «График событий»
  • Предложения SQL (обзор) — представляет собой перечень сформированных предложений в порядке появления в трейс-файле и их временные характеристики, статистику вызовов БД и т.п. Пример раздела приведен ниже:

Раздел «Предложения SQL (Обзор)»
Рис. 32 Раздел «Предложения SQL (Обзор)»
  • Предложения SQL (кратко) — перечень предложений SQL в порядке убывания времени отклика, содержащий краткую статистику и тело предложения. Пример раздела приведен ниже:

Раздел «Предложения SQL (Кратко)»
Рис. 33 Раздел «Предложения SQL (Кратко)»
  • Использование файлов данных — раздел содержит статистику обращений к файлам данных в рамках определенных событий, для всего профиля ресурсов. Формирование раздела происходит например, при обработке событий одноблочного чтения или т.п. Если в трейс-файле события обработки файлов БД не появлялись, то данный раздел будет пропущен в отчете. В общем случае, раздел состоит из четырех частей: сортировка по скорости, по продол-ти, по появлениям, по блокам (если зафиксировано обращение только к одному файлу — то будет сформирована только первая часть раздела)

Раздел «Использование файлов данных»
Рис. 34 Раздел «Использование файлов данных»
  • Снимки состояний — содержит перечень предложений SQL, в курсорах которых были зафиксированы ошибки или для которых сработали настройки «ловца» - механизма фиксации снимка курсора SQL при анализе трейс-файла. В текущей версии приложения, «ловец» фиксирует снимки при следующих условиях:

    • для курсора возникла ошибка разбора (фраза PARSE ERROR)

    • для курсора возникла ошибка выполнения или извлечения (фраза ERROR)

    • для курсора выполнено событие, которое может свидетельствовать о возникновении ошибки

    • переменные связывания содержат фразу «ora-»

    • переменные связывания содержат значения определенные пользователем

    Пример раздела приведен ниже:

Раздел «Снимки состояний»
Рис. 35 Раздел «Снимки состояний»

Разделы предложений

При формировании профиля ресурсов, для определенных предложений SQL, могут формироваться подробные описания – отчеты «Детальная информация»4. Перейти в эти отчеты, вы можете по ссылке «детально» из раздела «Предложения SQL (кратко)». Текущая версия приложения формирует следующие разделы данных отчетов:

  • Краткая информация — раздел краткой информации дублирует содержимое, выводимое в разделе «Предложения SQL (кратко)».

  • Статистика — в данном разделе представлены суммарные значения по временным характеристикам предложения:

Раздел «Статистика»
Рис. 36 Раздел «Статистика»
  • События — данный раздел представляет время отклика для предложения SQL в разрезе событий БД.

Раздел «События»
Рис. 37 Раздел «События»
  • Вызовы базы данных — данный раздел представляет время отклика для предложения SQL в разрезе вызовов БД, с выводом специфической информации.

Раздел «Вызовы базы данных»
Рис. 38 Раздел «Вызовы базы данных»
  • Наборы переменных — данный раздел содержит параметры и значения переменных связывания, использованные при вызове курсора, входящего в предложение SQL. Также, для каждого набора переменных, выводится информация о сопровождающих вызовах БД. При использовании библиотеки ZeroClipboard (см. раздел Расширения), каждый набор переменных будет снабжен кнопкой «Собрать предложение SQL», при нажатии на которую, в буфер обмена будет помещен текст команды с заполненными значениями переменных связывания. Ниже приведен пример раздела:

Раздел «Наборы переменных»
Рис. 39 Раздел «Наборы переменных»
  • Гистограммы данных — этот раздел содержит информацию о соотношении количества и длительности/продолжительности выполнения предложения SQL и его событий вызовов базы данных.

Раздел «Гистограммы данных»
Рис. 40 Раздел «Гистограммы данных»
  • Планы выполнения — данный раздел содержит описание актуальных планов выполнения для курсоров, их структуру, количество появлений, и прочие доступные параметры.

Раздел «Планы выполнения»
Рис. 41 Раздел «Планы выполнения»
  • Использование файлов данных — данный раздел аналогичен разделу для отчета «Профиль ресурсов».

  • Пороговые значения — раздел, состоящий из описания структуры и других параметров курсоров предложения SQL, имеющих наибольшую и наименьшую длительность. Для описания курсоров, в данном разделе, могут быть созданы следующие подразделы: «Накопленные события», «Вызова БД», «Переменные», «График событий».

  • График событий — аналогичен разделу для отчета «Профиль ресурсов».

  • Снимки состояний — в этом разделе представлен перечень снимков состояний, доступных для предложения SQL, содержащий: время (по трейс-файлу) генерации снимка состояния, причину срабатывания «ловца», данные об ошибке (если она имела место). Для доступных снимков состояния существует возможность перейти в детальное описание — отчет «Снимок состояний». Ниже приведен пример раздела:

Раздел «Снимки состояний»
Рис. 42 Раздел «Снимки состояний»

Разделы снимков состояний

Для отчета «Снимок состояния» формируются следующие разделы:

  • Описание — представляет собой соответствующую строку из раздела «Снимки состояний» детального описания предложения SQL.

  • Предложение SQL — содержит идентификатор и текст предложения SQL

  • События – раздел аналогичен разделу «События» детального описания предложения SQL.

  • Стек – в этом разделе выводятся идентификаторы и фрагменты тел 5 предшествующих предложений SQL.

Оптимизация

В текущей версии приложения реализованы следующие типы отчетов по оптимизации:

  • Оптимизация профиля ресурсов для сессии — сравнение профилей ресурсов по времени отклика

  • Оптимизация профиля ресурсов для предложения SQL — сравнение профилей ресурсов предложений SQL по количеству появлений

Отчеты оптимизации строятся на основе данных двух или более проанализированных трейс-файлов, и представляют собой сравнение общих характеристик: длительность, продолжительность (в целом для профиля или для предложения), характеристик событий. В текущей версии приложения, сравнение данных производится парами (порядок сравнения задается пользователем при формировании отчета) — этапами. Если для сравнения было выбрано только два трейс-файла, то будет сформирован только один этап, если файлов будет N, то отчет будет содержать N-1 этапов и один итоговый этап — представляющий сравнение первого трейс-файл с последним.

В отчетах оптимизации применяется выделение цветом результатов сравнения характеристик трейс-файлов:

  • зеленый - уменьшение характеристики > 10 %

  • желтый — изменение характеристики в пределах до 10%

  • красный — увеличение характеристики > 10%

Оптимизация профиля ресурсов для сессии

В текущей версии приложения, каждый этап данного отчета содержит следующие разделы:

  • Информация о файлах — краткое содержание преамбулы трейс-файлов, образующих этап

Раздел «Информация о файлах»
Рис. 43 Раздел «Информация о файлах»
  • Итоговая статистика — раздел содержит информацию по сравнению значений длительности для трейс-файлов

Раздел «Итоговая статистика»
Рис. 44 Раздел «Итоговая статистика»
  • События (LHS файл) / (RHS файл) – содержат упрощенный вариант раздела «События» профиля ресурсов

  • События (улуч.(+)/ухуд.(-)) - сравнение характеристик событий

Раздел «События (улуч.(+)/ухуд.(-))»
Рис. 45 Раздел «События (улуч.(+)/ухуд.(-))»

Процесс формирования отчета «Оптимизация профиля ресурсов для сессии» состоит из следующих шагов:

  1. Выбираем пункт меню «Отчеты» - «Оптимизация»

  2. В появившемся диалоге, необходимо сделать следующее:

    1. Выбрать тип отчета - «Сессия»

    2. При необходимости можно заполнить поле ввода «Комментарий». Введенный текст будет включен в сформированный отчет.

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

Генерация отчета оптимизации для профиля сессии
Рис. 46 Генерация отчета оптимизации для профиля сессии
    1. Нажать кнопку «Продолжить», после чего будет выполнен анализ и генерация отчета.

Примечание:

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

Оптимизация профиля ресурсов для предложения SQL

В текущей версии приложения, каждый этап данного отчета содержит следующие разделы:

  • Информация о файлах— краткое содержание преамбулы трейс-файлов, образующих этап

  • Краткая информация (LHS файл)/(RHS файл) — содержат данные раздела «Краткая информация» детальной информации по предложению SQL

  • Стат-ка (улуч.(+)/ухуд.(-)) - сравнение характеристик предложений SQL, таких как длительность, продолжительность, длительность событий внутри/между вызовами

  • События (LHS файл) / (RHS файл) — содержат данные раздела «События» детальной информации предложения SQL

  • События (улуч.(+)/ухуд.(-)) - сравнение характеристик событий



Процесс формирования отчета «Оптимизация профиля ресурсов для предложения SQL» состоит из следующих шагов:

  1. Выбираем пункт меню «Отчеты» - «Оптимизация»

  2. В появившемся диалоге необходимо сделать следующее:

    1. Выбрать тип отчета - «Предложение SQL»

    2. При необходимости можно заполнить поле ввода «Комментарий». Введенный текст будет включен в сформированный отчет.

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

Генерация отчета оптимизации для профиля предложения SQL
Рис. 47 Генерация отчета оптимизации для профиля предложения SQL
    1. Нажать кнопку «Продолжить», после чего будет выполнен анализ профайлеров

Примечание:

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

  1. После выполнения анализа профайлеров, необходимо выбрать предложения SQL, чьи характеристики будут выведены в отчет. Для этого, в появившемся диалоге:

    Выбор предложений SQL
    Рис. 48 Выбор предложений SQL

    необходимо, для каждого из трейс-файлов (верхняя часть диалога) выбрать предложение SQL. Выбор предложения SQL осуществляется двойным кликом по соответствующей строке, после чего идентификатор выбранного предложения будет добавлен в верхнюю часть диалога:

    Выбор предложения SQL двойным кликом
    Рис. 49 Выбор предложения SQL двойным кликом

Примечание:

    Выбор предложения SQL необходимо осуществить для каждого трейс-файла.

  1. Нажать кнопку «Продолжить» после чего будет сформирован отчет.

1Зависит от уровня трассировки

2Порядковый номер присваивается приложением в зависимости от очередности предложения в исходном трейс-файле

3Для проанализированных профайлеров

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