Добавление и удаление зондов

Каждый новый инструмент идет с одним зондом, который можно сконфигурировать. Для добавления большего количества зондов нажмите кнопку Add (+) у основания инструментального диалогового окна конфигурации.

Для удаления зонда из инструмента щелкните по зонду, чтобы выбрать его и нажать кнопку Remove (-) у основания инструментального диалогового окна конфигурации.

При добавлении зондов это - хорошая идея обеспечить описательное имя для зонда. По умолчанию, Инструменты перечисляет зонды с именами как Зонд 1 и Зонд 2.

Указание тестового провайдера

Для указания точки расположения или события, инициировавшего зонд необходимо связать надлежащего провайдера с зондом. Провайдеры являются модулями ядра, действующими как агенты для DTrace, обеспечивая инструментарий, необходимый для создания зондов. Вы не должны знать, как провайдеры работают для создания инструмента, но действительно необходимо знать основные возможности каждого провайдера. Таблица 12-1 перечисляет провайдеров, поддерживающихся Инструментальным приложением и доступных для использования в Ваших пользовательских инструментах. Списки столбцов Провайдера имя, выведенное на экран в инструментальном листе конфигурации и списках столбцов провайдера DTrace подлинное имя провайдера, используются в соответствующем сценарии DTrace.

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

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

Добавление предикатов к зонду

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

Добавить предикат к зонду

1. Нажмите кнопку Add (+) в тестовых условиях.

2. Выберите тип предиката.

3. Определите значения предиката.

Можно добавить последующие предикаты с помощью кнопок Add (+) или зонда или предиката. Для удаления предиката нажмите кнопку Remove (-) рядом с предикатом.

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

Используйте первое всплывающее меню в строке предиката для выбора данных для проверки как часть условия. Таблица 12-2 перечисляет стандартные переменные, определенные DTrace, который можно использовать в предикатах или коде сценария. Переменный столбец перечисляет имя, как это появляется в инструментальной панели конфигурации и “списках столбцов” переменной DTrace подлинное имя переменной, используемой в соответствующих сценариях DTrace. В дополнение к тестированию стандартных переменных можно протестировать против пользовательских переменных и констант от кода сценария путем указания Пользовательского типа переменной в поле предиката.

В дополнение к указанию условной переменной необходимо указать оператор сравнения и целевое значение.

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

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

Рисунок 12-3 показывает часть инструментального листа конфигурации, где Вы указываете действия своего зонда. Часть сценария просто содержит текстовое поле для Вас для ввода в коде сценария. (Инструменты не проверяют Ваш код прежде, чем передать его DTrace, так проверьте свой код тщательно.) Нижний раздел содержит средства управления для указания данных, которые Вы хотите, чтобы DTrace возвратил Инструментам. Можно использовать всплывающие меню для конфигурирования встроенных переменных DTrace, которые Вы хотите возвратить. Можно также выбрать Custom из этого всплывающего меню и возвратить одну из переменных сценария.

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

• Переменная сценария, содержащая данные

• Имя для применения к переменной в инструментальном интерфейсе

• Тип переменной

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

Поскольку сценарии DTrace работают в пространстве ядра и Инструментальном выполнении приложения в пространстве пользователя, если Вы хотите возвратить значение основанной на пользовательском указателе переменной сценария к Инструментам, необходимо создать буфер для содержания данных переменной. Самый простой способ создать буфер состоит в том, чтобы использовать copyin или copyinstr подпрограммы найдены в DTrace. copyinstr подпрограмма берет указатель на струну до и возвращает содержание строки в форме, которую можно возвратить Инструментам. Точно так же copyin подпрограмма берет указатель и значение размера и возвращает буфер данным, которые можно позже отформатировать в строку с помощью stringof ключевое слово. Обе из этих подпрограмм являются частью среды DTrace и могут использоваться от любой части определения действия Вашего зонда. Например, для возврата строки из указателя строки C-стиля Вы просто обертываете имя переменной с copyinstr подпрограмма, как показано на рисунке 12-4.

Для списка встроенных переменных, поддерживаемых Инструментами, посмотрите Таблицу 12-2. Для получения дополнительной информации о сценариях и переменных сценария, посмотрите Подсказки для Записи Пользовательских Сценариев. Для получения дополнительной информации о подпрограммах DTrace, включая copyin и copyinstr подпрограммы, см. Солярис Динамическое Руководство по Трассировке, доступное от Технологической Сети Oracle.

Запись BEGIN и сценариев END

Если Вы хотите сделать больше, чем возврат информация во встроенных переменных DTRACE к Инструментам каждый раз, когда Ваше действие стреляет, необходимо записать пользовательские сценарии. Сценарии взаимодействуют непосредственно с DTrace на уровне ядра, обеспечивая доступ к низкоуровневой информации о ядре и активном процессе. Большинство инструментов использует сценарии для сбора информации, не легко доступной от DTrace. Можно также использовать сценарии для управления необработанными данными прежде, чем возвратить его Инструментам. Например, если Вы хотите упростить сравнивать то значение графически с другими значениями в области дорожки Вашего инструмента, можно использовать сценарий для нормализации значения данных к определенному диапазону.

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

• Раздел DATA содержит определения любых глобальных переменных, которые Вы хотите использовать в Вашем инструменте.

• Раздел BEGIN содержит любой код инициализации для Вашего инструмента.

• Каждый зонд содержит код сценария как часть его действия.

• Раздел END содержит, любой очищает код для Вашего инструмента.

Все разделы сценария являются дополнительными. Вы не обязаны иметь сценарии инициализации или сценарии очистки, если Вашему инструменту не нужны они. Если Ваш инструмент определяет глобальные переменные в своем разделе DATA, однако, рекомендуется также обеспечить сценарий инициализации для установки тех переменных в известное значение. Язык D не позволяет Вам присваивать значения, встроенные с Вашими объявлениями глобальной переменной, таким образом, необходимо поместить те присвоения в раздел BEGIN. Например, простой раздел DATA мог бы состоять из единственного объявления переменной, такого как следующее:

int myVariable;

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

myVariable = 0;

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

Большая часть Вашего кода сценария, вероятно, будет связана с отдельными зондами. Каждому зонду можно было связать сценарий с его действием. Когда это прибывает время для выполнения действия зонда, DTrace выполняет код сценария сначала и затем возвращает любые запрошенные данные назад Инструментам. Поскольку пасование назад данных к Инструментам включает копирование данных от пространства ядра назад к Инструментальному пространству приложения, необходимо всегда пасовать назад данные к Инструментам путем конфигурирования надлежащих записей в “Записи следующие данные “: раздел инструментального листа конфигурации. Переменные, возвращенные вручную из Вашего кода сценария, не могут быть возвращены правильно к Инструментам.

Доступ к данным ядра из пользовательских сценариев

Поскольку сценарии DTrace выполняются в системном ядре, у них есть доступ к символам ядра. Если Вы хотите смотреть на глобальные переменные ядра и структуры данных от Ваших пользовательских инструментов, можно сделать так в сценариях DTrace. Для доступа к переменной ядра предшествуйте имени переменной с символом одинарной левой кавычки (`). Символ одинарной левой кавычки говорит DTrace искать указанную переменную за пределами текущего сценария.

Перечисление 12-1 показывает демонстрационный сценарий действия, получающий текущую информацию о загрузке от avenrun переменная ядра и использование, что переменная для вычисления одноминутной средней загрузки системы. Если необходимо было создать зонд с помощью провайдера Профиля, у Вас мог бы быть этот сценарий, собирают данные загрузки периодически и затем график та информация в Инструментах.

Перечисление 12-1  , Получающее доступ к переменным ядра из сценария DTrace

this->load1a = `avenrun[0]/1000;

this->load1b = ((`avenrun[0] % 1000) * 100) / 1000;

this->load1 = (100 * this->load1a) + this->load1b;

Определение объема переменных соответственно

Сценарии DTrace имеют чрезвычайно плоскую структуру вследствие отсутствия операторов управления потоком и желания свести тестовое время выполнения к минимуму. Однако можно определить объем переменных в сценариях DTrace к разным уровням в зависимости от потребности. Таблица 12-3 перечисляет уровни определения объема для переменных и синтаксис для использования переменных на каждом уровне.

Нахождение ошибок сценария

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