lttng - Интернет в облаке

ПРОГРАММА:

ИМЯ

lttng - инструмент командной строки управления трассировщиком LTTng 2.x

СИНТАКСИС

lttng [ОПЦИИ]

ОПИСАНИЕ

Проект LTTng направлен на предоставление высокоэффективных инструментов трассировки для Linux. Его трассеры
помогает отслеживать проблемы с производительностью и отлаживать проблемы, связанные с несколькими одновременными
процессы и потоки. Также возможно отслеживание в нескольких системах.

Ассоциация лттнг инструмент командной строки из пакета lttng-tools используется для управления как ядром
и трассировка в пространстве пользователя. Каждое взаимодействие с трассировщиком должно выполняться этим инструментом или
библиотекой liblttng-ctl из пакета lttng-tools.

LTTng использует демон сеанса (lttng-сессия(8)), выступая в качестве реестра отслеживания, который
позволяет взаимодействовать с несколькими трассировщиками (ядром и пользовательским пространством) внутри одного
контейнер, сеанс трассировки. Трассы могут быть собраны из ядра и / или инструментированы
Приложения (lttng-ust(3)). Агрегирование и чтение этих трассировок выполняется с помощью
Babeltrace(1) просмотрщик текста.

Введем понятие трассировка доменов который по сути является типом трассировщика (ядро,
пользовательское пространство, JUL, LOG4J или Python на данный момент). В будущем мы могли бы увидеть больше таких трассировщиков, как
например гипервизор. Для некоторых команд вам необходимо указать, в каком домене
команда работает (-u, -k, -l, -j или -p). Например, необходимо указать домен ядра.
при включении события ядра.

Чтобы отследить ядро, демон сеанса должен быть запущен от имени пользователя root. LTTng
предусматривает использование трассировка группы (по умолчанию: трассировка). Кто бы ни был в этой группе, может
взаимодействовать с корневым демоном сеанса и таким образом отслеживать ядро. Сессионные демоны могут совместно
существует, что означает, что вы можете запустить демон сеанса от имени Алисы, который можно использовать для
отслеживать ее приложения вместе с корневым демоном или даже демоном Боба. Мы очень
рекомендуется запускать демон сеанса во время загрузки для стабильной и долгосрочной трассировки.

Каждое приложение пользовательского пространства оснащено lttng-ust(3) автоматически зарегистрируется
с помощью корневого демона сеанса и его демона пользовательского сеанса. Это позволяет каждому демону перечислить
доступные отслеживаемые приложения и точки трассировки в любой момент (см. список
команда).

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Эта программа следует обычному синтаксису командной строки GNU с длинными параметрами, начинающимися с двух
тире. Ниже приводится сводка доступных опций.

-час, --Помогите
Показать сводку возможных опций и команд.

-В, --версия
Показать версию.

-в, --подробный
Увеличьте многословие. Доступны три уровня детализации, которые запускаются
добавление v к опции (-vv или -vvv)

-д, --тихий
Подавлять все сообщения (даже ошибки).

-грамм, --группа ИМЯ
Задайте имя группы трассировки unix. (по умолчанию: трассировка)

-н, --no-session
Не запускать сеансовый демон автоматически.

--sessiond-путь PATH
Установить полный двоичный путь демона сеанса.

--список-опций
Простой список опций lttng.

--list-команды
Простой список команд lttng.

-м, --ми ТИП
Интерфейс машины

Поддерживаемый ТИП: XML

Режим машинного интерфейса (MI) преобразует традиционную красивую печать в машинную
синтаксис вывода. Режим MI обеспечивает устойчивый к изменению формата способ доступа к информации
генерируется через командную строку lttng.

При использовании режима MI данные печатаются на стандартный вывод. Ошибка и предупреждение печатаются на
STDERR с красивым форматом печати по умолчанию.

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

Для типа вывода XML файл определения схемы (XSD), используемый для проверки, может быть
находится в src / common / mi_lttng.xsd

КОМАНДЫ

добавить контекст [ПАРАМЕТРЫ]
Добавьте контекст к событиям и / или каналам.

Контекст - это в основном дополнительная информация, добавляемая к каналу. Например, вы
может попросить трассировщик добавить информацию о PID для всех событий в канале. Ты
также можно добавить счетчики модулей мониторинга производительности (perf PMU), используя ядро ​​perf
API.

Например, эта команда добавит контекстную информацию prio и две на процессор.
счетчики производительности (пропуски аппаратных ветвей и промахи кеша) для всех событий в трассировке
вывод данных:

# lttng add-context -k -t prio -t perf: cpu: branch-misses \
-t perf: cpu: cache-misses

Пожалуйста, посмотрите справку (-h / - help) для получения подробного списка доступных
контексты.

Счетчики Perf доступны для каждого процессора ("perf: cpu: ...") и для каждого потока.
("perf: thread: ...") счетчики. В настоящее время счетчики на уровне ЦП можно использовать только с
домен трассировки ядра, а счетчики по потокам могут использоваться только с UST
отслеживание домена.

Если канал не указан (-c), контекст добавляется ко всем каналам, которые уже были
включено. Если в сеансе нет канала, создается канал по умолчанию. В противном случае
контекст будет добавлен только к данному каналу (-c).

If -с, --сессия опускается, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

-с, --сессия ИМЯ
Применить к имени сеанса.

-с, --канал ИМЯ
Применить к названию канала.

-к, --ядро
Подать заявку на получение трассировщика ядра

-у, --userspace
Подать заявку на трассировщик пространства пользователя

-т, --тип ТИП
Тип контекста. Вы можете повторить этот параметр в командной строке. Пожалуйста, используйте
«lttng add-context -h» для вывода списка всех доступных типов.

калибровать [ПАРАМЕТРЫ]
Определите накладные расходы LTTng

Команду LTTng calibrate можно использовать для определения совокупных средних накладных расходов.
трассирующего устройства LTTng и используемых контрольно-измерительных механизмов. Эти накладные расходы могут быть
откалиброван по времени или с использованием любого доступного счетчика производительности PMU
в системе.

На данный момент реализована только калибровка функции ядра.
приборостроение (кретпробес).

* Калибровка инструментария функций ядра

Давайте использовать пример, чтобы показать эту калибровку. Мы используем процессор i7 с 4
универсальные регистры PMU. Эту информацию можно получить, выполнив команду dmesg,
ищу "общие регистры".

Эта последовательность команд соберет трассировку выполнения kretprobe, подключенного к
пустая функция, сбор счетчиков PMU LLC (Last Level Cache) пропускает информацию
(см. lttng add-context --help, чтобы увидеть список доступных счетчиков PMU).

# lttng создать функцию калибровки
# lttng enable-event калибровка --kernel \
--функция lttng_calibrate_kretprobe
# lttng add-context --kernel -t perf: cpu: LLC-load-misses \
-t perf: cpu: LLC-store-misses \
-t perf: cpu: LLC-prefetch-misses
# начало запуска
# для a in $ (seq 1 10); делать \
lttng калибровать --kernel --function;
сделанный
# уничтожить
# babeltrace $ (ls -1drt ~ / lttng-traces / калибровка-функция-* \
| хвост -n 1)

Вывод из babeltrace можно сохранить в текстовый файл и открыть в электронной таблице.
(например, oocalc), чтобы сосредоточиться на дельте счетчика на PMU между последовательными
события "calibrate_entry" и "calibrate_return". Обратите внимание, что эти счетчики
ЦП, поэтому для учета миграции между
ПРОЦЕССОР. Следовательно, для целей калибровки должны
быть на рассмотрении.

Средний результат для i7 на 10 образцах:

Среднее стандартное отклонение
perf_LLC_load_misses: 5.0 0.577
perf_LLC_store_misses: 1.6 0.516
perf_LLC_prefetch_misses: 9.0 14.742

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

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

-к, --ядро
Подать заявку на получение трассировщика ядра

-у, --userspace
Подать заявку на трассировщик пространства пользователя

--функция
Датчик входа / возврата динамической функции (по умолчанию)

Создайте [ИМЯ] [ВАРИАНТЫ]
Создать сеанс трассировки.

Сеанс трассировки содержит канал (ы), который содержит событие (я). Это домен
агностик, что означает, что каналы и события могут быть включены для трассировщика пользовательского пространства.
и / или трассировщик ядра. Он действует как контейнер, объединяющий несколько трассировок.
источники.

При создании .lttngrc в вашем каталоге $ HOME создается файл, содержащий
имя текущего сеанса. Если NAME не указано, автоматически создается имя сеанса.
имеющий такую ​​форму: «авто-ггггммдд-ччммсс».

Если нет -о, --выход указано, трассировки будут записаны в $ HOME / lttng-traces.

Переменную среды $ HOME можно переопределить, указав среду
переменная LTTNG_HOME. Это полезно, когда пользователь, выполняющий команды, имеет не-
записываемый домашний каталог.

Имя сеанса НЕ ДОЛЖНО содержать символ '/'.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

-о, --выход PATH
Укажите выходной путь для трассировок

--нет вывода
Следы не выводятся

- снимок
Установите сеанс в режим моментального снимка. Создан в режиме без вывода и использует
URL-адрес, если он указан, как выходной снимок по умолчанию. Каждый канал
будет установлен в режиме перезаписи и с выводом mmap (склейка не поддерживается).

--жить [ЮСЕК]
Установите сеанс исключительно в режиме реального времени. Параметр - задержка в
микросекунды до того, как данные будут сброшены и переданы в потоковом режиме. Живой режим позволяет
вы можете транслировать трассировку и просматривать ее, пока она записывается любым трассировщиком.
Для этого вам понадобится lttng-relayd, а для этого сеанса требуется сетевой URL-адрес.
(-U или -C / -D). Если ни USEC, ни URL-адрес не указаны, по умолчанию используется таймер.
значение 1000000 и сетевой URL-адрес net: //127.0.0.1.

Чтобы прочитать живую сессию, вы можете использовать Babeltrace(1) или прямая трансляция
протокол в doc / live-reading-protocol.txt. Вот пример:

$ lttng-relayd -o / tmp / lttng
$ lttng create --live 200000 -U net: // localhost
$ lttng Enable-event -a --userspace
$ старт

После старта вы сможете читать события, пока они ведутся.
записано в / tmp / lttng.

--shm-путь PATH

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

Смотрите пост в lttng-авария(1) утилита для получения дополнительной информации о восстановлении после сбоя.

-У, --set-url = URL
Задайте URL-адрес для конечной точки вывода потребителя. Это настойчиво для
время жизни сеанса. Повторите команду, чтобы изменить ее. Это установит как данные, так и
URL-адрес управления для сети.

-С, --ctrl-url = URL
Задайте URL-адрес пути управления. (Также необходимо использовать -D)

-Д, --data-url = URL
Установите URL-адрес пути к данным. (Также необходимо использовать -C)

Используя эти параметры, можно управлять каждым вызовом API индивидуально. Например, -C
не включает потребителя автоматически. Для этого вам понадобится опция -e.

URL ФОРМАТ:

proto: // [ХОСТ | IP] [: ПОРТ1 [: ПОРТ2]] [/ TRACE_PATH]

Поддерживаемые протоколы (прото):

файл://...
Полный путь к локальной файловой системе.

сеть://...
Это будет использовать сетевой транспортный уровень по умолчанию, который является TCP для обоих
управление (PORT1) и порт данных (PORT2). Порты по умолчанию соответственно
5342 и 5343. Обратите внимание, что net [6]: // еще не поддерживается.

tcp [6]: // ...
Может использоваться только с -C и -D вместе

ПРИМЕЧАНИЕ. IPv6-адрес ДОЛЖЕН быть заключен в квадратные скобки "[]" (rfc2732).

ПРИМЕРЫ:

# lttng create -U net: //192.168.1.42
Использует TCP и порты по умолчанию для данного пункта назначения.

# lttng create -U net6: // [fe80 :: f66d: 4ff: fe53: d220]
Использует TCP, порты по умолчанию и IPv6.

# lttng create s1 -U net: //myhost.com: 3229
Создайте сеанс s1 и установите его потребителем myhost.com на порт 3229 для
контролировать.

уничтожить [ИМЯ] [ВАРИАНТЫ]
Сеанс трассировки Teardown

Освободите память на стороне демона сеанса и трассировщика. Его больше нет!

Если NAME не указано, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

-a --все
Уничтожить все сеансы

--список-опций
Простой список опций

включить канал ИМЯ [, ИМЯ2, ...] (-k | -u) [ОПЦИИ]
Включить канал трассировки

Чтобы включить событие, вы должны включить и событие, и канал, содержащий
его.

If -с, --сессия опускается, имя сеанса берется из файла .lttngrc.

Должен быть указан ровно один из -k или -u.

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

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

ОПЦИИ:

-час, --Помогите
Показать эту помощь

--список-опций
Простой список опций

-с, --сессия ИМЯ
Применить к имени сеанса

-к, --ядро
Применить к трассировщику ядра

-у, --userspace
Применить к трассировщику пространства пользователя

--отказаться
Отменить событие при заполнении суббуферов (по умолчанию)

- перезаписать
Режим бортового регистратора: перезаписывает события при заполнении суббуферов. Номер
суббуфера должно быть 2 или больше.

--subbuf-размер РАЗМЕР
Размер суббуфера в байтах {+ k, + M, + G}. (uid UST по умолчанию: 131072, pid UST:
4096, ядро: 262144, метаданные: 4096) Округляется до следующей степени двойки.

Минимальный размер суббуфера для каждого трассировщика - это максимальное значение между
по умолчанию выше и размер системной страницы. Вы можете выполнить эту команду, чтобы получить
текущий размер страницы в вашей системе: $ получить конф РАЗМЕР СТРАНИЦЫ

--num-subbuf NUM
Количество суббуферов. (uid UST по умолчанию: 4, pid UST: 4, ядро: 4, метаданные:
2) Округляем до следующей степени двойки.

--переключатель-таймер ЮСЕК
Интервал переключения таймера суббуфера в мкс. (по умолчанию UST uid: 0, UST pid: 0,
ядро: 0, метаданные: 0)

- таймер чтения ЮСЕК
Интервал чтения таймера в мкс. (по умолчанию UST uid: 0, UST pid: 0, ядро:
200000, метаданные: 0)

--выход ТИП
Тип выхода канала. Возможные значения: mmap, splice (uid UST по умолчанию: mmap,
UST pid: mmap, ядро: splice, метаданные: mmap)

--buffers-uid
Использовать для каждого буфера UID (только -u). Буферы распределяются между приложениями, которые
имеют тот же UID.

--buffers-pid
Использовать для каждого буфера PID (только -u). У каждого приложения есть свои буферы.

--buffers-global
Использовать общий буфер для всей системы (только -k)

-С, --tracefile-размер РАЗМЕР
Максимальный размер каждого файла трассировки в потоке (в байтах). 0 означает
безлимитный. (по умолчанию: 0) Примечание: трассировки, созданные с помощью этой опции, могут
неточно сообщать об исключенных событиях в CTF 1.8.

-В, --tracefile-count СЧИТАТЬ
Используется вместе с опцией -C, это ограничивает количество файлов.
создано до указанного количества. 0 означает без ограничений. (по умолчанию: 0)

ПРИМЕРЫ:

$ lttng Enable-channel -k -C 4096 -W 32 chan1
Для каждого потока максимальный размер каждого файла трассировки будет 4096 байт и
будет максимум 32 разных файла. Счетчик файлов добавлен
после номера потока, как показано в следующем примере. Последний след
файл меньше 4096, так как он не был полностью заполнен.

~ / lttng-traces /[...] / chan1_0_0 (4096)
~ / lttng-traces /[...] / chan1_0_1 (4096)
~ / lttng-traces /[...] / chan1_0_2 (3245)
~ / lttng-traces /[...] / chan1_1_0 (4096)
...

$ lttng включить-канал -k -C 4096
Это создаст файлы трассировки размером 4096 байт и создаст новые,
поскольку есть данные.

включить-событие ИМЯ [, ИМЯ2, ...] (-k | -u | -j | -l | -p) [ОПЦИИ]
Включить событие трассировки

Событие трассировки всегда назначается каналу. Если -с, --канал опущено, a
канал по умолчанию с именем 'channel0'создается, и событие добавляется к нему. Если -с,
--канал опущено, но в сеансе уже существует канал, отличный от канала по умолчанию,
возвращается ошибка. Для трассировщика пользовательского пространства, используя -a --все такой же как
с использованием подстановочного знака «*».

If -с, --сессия опускается, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

-с, --сессия ИМЯ
Применить к имени сеанса

-с, --канал ИМЯ
Применить к названию канала

-a --все
Включите все точки трассировки и системные вызовы. Это фактически позволяет использовать один подстановочный знак
событие "*".

-к, --ядро
Подать заявку на получение трассировщика ядра

-у, --userspace
Подать заявку на трассировщик пространства пользователя

-дж, - июл
Подать заявку на приложение Java с помощью интерфейса регистрации Java Util (JUL)

-л, --log4j
Подать заявку на приложение Java с помощью LOG4J

-п, --питон
Подайте заявку на участие в приложении Python с помощью модуля регистрации.

- точка трассировки
Событие точки трассировки (по умолчанию). Трассировщик пространства пользователя поддерживает подстановочные знаки в конце
строки. Не забудьте процитировать, чтобы иметь дело с расширением bash. например:
"*"
"app_component: na *"

--loglevel ИМЯ
Диапазон уровней журнала трассировки от 0 до уровня журнала. Перечислено в справке (-h). За
домен JUL, диапазоны уровней логирования детализируются с помощью опции --help, таким образом
начиная с ТЯЖЕЛОГО до НАИЛУЧШЕГО. Для домена LOG4J уровни логирования варьируются от
FATAL to TRACE, которые также подробно описаны в справке. Для домена Python
уровни журналов варьируются от CRITICAL до DEBUG, которые подробно описаны в справке как
Что ж.

--loglevel-только ИМЯ
Уровень журнала точки трассировки (только этот уровень журнала). Loglevel или только loglevel
параметры должны быть объединены с именем точки трассировки или подстановочным знаком точки трассировки.

- зонд (адрес | символ | символ + смещение)
Динамический зонд. Адрес и смещение могут быть восьмеричными (0NNN ...), десятичными (NNN ...) или
шестнадцатеричный (0xNNN ...)

--функция (адрес | символ | символ + смещение)
Динамическая функция входа / возврата датчика. Адрес и смещение могут быть восьмеричными (0NNN ...),
десятичный (NNN ...) или шестнадцатеричный (0xNNN ...)

--системный вызов
Событие системного вызова.

--фильтр 'выражение'
Установите фильтр для недавно включенного события. Выражение фильтра для полей событий и
контекст. Событие будет записано, если выражение фильтра оценивается как
ИСТИННЫЙ. Указывайте только при первой активации данного события в сеансе.
Указание фильтра разрешено только при включении событий в сеансе.
до начала трассировки. Если фильтр не может связать с событием в
отслеживаемый домен, событие будет отброшено.

Примеры выражений:

'intfield> 500 && intfield <503'
'(strfield == "test" || intfield! = 10) && intfield> 33'
'doublefield> 1.1 && intfield <5.3'

В конце строк разрешены подстановочные знаки:
'seqfield1 == "te *"' В строковых литералах escape-символом является '\'.
Используйте '\ *' для символа '*' и '\\' для последовательности символов '\'.
Подстановочный знак соответствует любой последовательности символов, включая пустую подстроку
(соответствует 0 или более символов).

Контекстная информация может использоваться для фильтрации. Примеры ниже показывают
использование контекстной фильтрации по имени процесса (с использованием подстановочного знака), процесс
Диапазон идентификаторов и уникальный идентификатор потока. Идентификаторы процесса и потока запущенного
приложения можно найти в столбцах «PID» и «LWP» файла «ps -eLf».
команда.

'$ ctx.procname == "демонстрация *"'
'$ ctx.vpid> = 4433 && $ ctx.vpid <4455'
'$ ctx.vtid == 1234'

Информация о контексте доступна для всех фильтров, независимо от того, добавлены они или нет.
команда context использовалась для добавления его в канал события, пока
поле контекста существует для этого домена. Например, примеры фильтров
приведенный выше, всегда будет ссылаться: не требуется дополнительный контекст для
канал события.

-Икс, --исключать СПИСОК
Добавить исключения в точки трассировки UST: события, соответствующие любому из элементов в
СПИСКИ, разделенные запятыми, не включены, даже если они соответствуют подстановочному знаку
определение события.

Эта опция также применима с -a --все вариант, и в этом случае все
Точки трассировки UST включены, кроме тех, чьи имена соответствуют любому из
элементы в СПИСКЕ.

отключить канал ИМЯ [, ИМЯ2, ...] (-k | -u) [ОПЦИИ]
Отключить канал трассировки

Отключение канала отключает отслеживание всех событий канала. Канал
можно повторно включить, позвонив лттнг включить канал ИМЯ снова.

If -с, --сессия опускается, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

-с, --сессия ИМЯ
Применить к имени сеанса

-к, --ядро
Подать заявку на получение трассировщика ядра

-у, --userspace
Подать заявку на трассировщик пространства пользователя

отключение-событие ИМЯ [, ИМЯ2, ...] (-k | -u | -j | -l | -p) [ТИП] [ОПЦИИ]
Отключить отслеживание события

После отключения событие можно снова включить, позвонив лттнг включить-событие ИМЯ
снова.

If -с, --сессия опускается, имя сеанса берется из файла .lttngrc.

If -с, --канал опускается, используется имя канала по умолчанию. Если -с, --канал is
опущено, но канал не по умолчанию уже существует в сеансе, ошибка
вернулся.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

-с, --сессия ИМЯ
Применить к имени сеанса

-с, --канал ИМЯ
Применить к названию канала

-a --все события
Отключить все события. Это НЕ ТОЛЬКО отключает "*", а скорее все известные
события сессии

-к, --ядро
Подать заявку на получение трассировщика ядра

-у, --userspace
Подать заявку на трассировщик пространства пользователя

-дж, - июл
Подать заявку на приложение Java с помощью интерфейса регистрации Java Util (JUL)

-л, --log4j
Подать заявку на приложение Java с помощью LOG4J

-п, --питон
Подать заявку на приложение Python с помощью модуля регистрации

ТИП (ядро домен только):

--все Отключить событие любого типа

- точка трассировки
Отключить событие типа точки трассировки

--системный вызов
Отключить событие типа syscall

- зонд
Отключить событие типа зонд

--функция
Отключить событие типа функция

список [ВАРИАНТЫ] [СЕССИЯ [ВАРИАНТЫ СЕССИИ]]
Перечислить информацию о сеансе трассировки.

Без аргументов будут перечислены доступные сеансы трассировки.

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

Только с -k он перечислит все доступные события ядра (кроме системных вызовов
Мероприятия). Только с -j доступное событие JUL из зарегистрированного приложения будет
быть в списке. Событие соответствует имени Регистратора в приложении Java JUL.
Только с параметром -l будет отображено доступное событие LOG4J из зарегистрированного приложения.
Событие соответствует имени Регистратора в приложении Java LOG4J. С -p
в одиночку будет перечислено доступное событие Python из зарегистрированного приложения. В
событие соответствует имени Регистратора в приложении Python. Только с -u он
перечислит все доступные события пользовательского пространства из зарегистрированных приложений. Вот
пример lttng list -u:

PID: 7448 - Имя: /tmp/lttng-ust/tests/hello/.libs/lt-hello
ust_tests_hello: tptest_sighandler (тип: точка трассировки)
ust_tests_hello: tptest (тип: точка трассировки)

Теперь вы можете включить любое событие в списке, используя имя: ust_tests_hello: tptest.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

-к, --ядро
Выберите домен ядра

-у, --userspace
Выберите домен в пространстве пользователя.

-дж, - июл
Подать заявку на приложение Java с помощью JUL

-л, --log4j
Подать заявку на приложение Java с помощью LOG4J

-п, --питон
Подайте заявку на участие в приложении Python с помощью модуля регистрации.

-ф, --поля
Список полей событий

СЕССИЯ ОПЦИИ:

-с, --канал ИМЯ
Список сведений о канале

-д, --домен
Список доступных доменов

загрузка [ОПЦИИ] [ИМЯ]
Загрузить конфигурацию сеанса трассировки

Если NAME опущено, все конфигурации сеанса найдены как в сеансе пользователя
каталог конфигурации (по умолчанию: ~ / .lttng / sessions /) и системный сеанс
будет загружен каталог конфигурации (по умолчанию: / etc / lttng / sessions /). Обратите внимание, что
сначала загружаются сеансы в каталоге пользователя, а затем - в масштабе всей системы
каталог загружен.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

-a --все
Загрузить все конфигурации сеанса (по умолчанию).

-я, - входной путь PATH
Укажите входной путь для конфигураций сеанса. Это отменяет
каталог конфигурации сеанса по умолчанию.

-ф, --сила
Перезаписать текущую конфигурацию сеанса, если сеанс с тем же именем
уже существует.

спасти [ВАРИАНТЫ] [СЕССИЯ]
Сохранить конфигурацию сеанса трассировки

Если SESSION не указан, все конфигурации сеанса будут сохранены в индивидуальном
.lttng файлы в каталоге конфигурации сеанса пользователя (по умолчанию:
~ / .lttng / sessions /). Схема именования файла конфигурации сеанса по умолчанию:
СЕССИЯ.lttng.

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

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

-a --все
Сохраните все конфигурации сеанса (по умолчанию).

-о, --выходной путь PATH
Укажите путь вывода для сохраненных сеансов. Это отменяет значение по умолчанию
каталог конфигурации сеанса.

-ф, --сила
Перезаписать файл конфигурации сеанса, если имя сеанса конфликтует.

сет-сессия НАЗВАНИЕ [ОПЦИИ]
Установить имя текущего сеанса

Изменит имя сеанса в файле .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

снимок [ОПЦИИ] ДЕЙСТВИЕ
Команда моментального снимка для сеанса LTTng.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

ДЕЙСТВИЕ:

надстройка-вывод [-м ] [-s ] [-n ] | -C -D

Настройте и добавьте выходной снимок для сеанса. Выход - это пункт назначения
куда будет отправлен снимок. Разрешен только один выход. Чтобы изменить это,
вам нужно удалить его и добавить новый.

del-выход ID | ИМЯ [-s ]

Удалите вывод для сеанса, используя идентификатор вывода. Вы можете указать
вывод по имени или используйте его идентификатор, возвращенный командой list-output.

список-вывод [-s ]

Список результатов сеанса. Атрибуты вывода распечатываются.

запись [-м ] [-s ] [-n ] [ | -C -D ]

Снимок буфера (ов) сеанса для всех доменов. Если указан URL-адрес, он
используется вместо ранее добавленного вывода. Указание только имени или / и
максимальный размер переопределит текущие выходные значения. Например, вы можете
записать снимок с пользовательским максимальным размером или с другим именем.

$ lttng snapshot add-output -n файл mysnapshot: /// данные / снимок
[...]
$ lttng запись моментального снимка -n новое_имя_снимка

Вышеупомянутый снимок будет создан в / data / snapshot / new_name_snapshot *
каталог, а не в mysnapshot * /

ДОП ДЕЙСТВИЯ ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-с, --сессия ИМЯ
Применить к имени сеанса.

-н, --имя ИМЯ
Имя вывода снимка.

-м, --макс-размер РАЗМЕР
Максимальный размер снимка в байтах. Максимальный размер не включает
файл метаданных. Принимается удобочитаемый формат: {+ k, + M, + G}. Например,
- макс. размер 5M

-С, --ctrl-url URL
Задайте URL-адрес пути управления. (Также необходимо использовать -D)

-Д, --data-url URL
Установите URL-адрес пути к данным. (Также необходимо использовать -C)

Начало [ИМЯ] [ВАРИАНТЫ]
Начать трассировку

Он начнет трассировку для всех трассировщиков для определенного сеанса трассировки. Если ИМЯ
опущено, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

остановить [ИМЯ] [ВАРИАНТЫ]
Прекратить отслеживание

Он остановит трассировку для всех трассировщиков для определенного сеанса трассировки. До
возвращаясь, команда проверяет доступность данных, что означает, что она будет ждать, пока
трассировка доступна для чтения для сеанса. Используйте --no-wait, чтобы избежать такого поведения.

Если NAME не указано, имя сеанса берется из файла .lttngrc.

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

--Нет, подождите
Не ждите доступности данных.

трек (-k | -u) --pid [PID1 [, PID2 [, ...]]] [ОПЦИИ]
Добавляет одну или несколько записей в трекер

Ассоциация трек команда добавляет одну или несколько записей в трекер. Трекер - это белый список
ресурсов. Отслеживаемые ресурсы могут генерировать события при условии, что эти события
включены (см. включить-событие команда).

Записи трекера можно удалить из белого списка с помощью не отслеживать команда.

В этой версии единственным доступным трекером является PID трекер. ID процесса
(PID) трекер отслеживает один или несколько идентификаторов процесса; только процессы с отслеживанием
PID разрешено испускать события. По умолчанию все возможные PID в системе
отслеживается: любой процесс может генерировать разрешенные события (эквивалент лттнг трек --пид --все
для всех доменов).

С помощью трекера PID можно, например, записывать все системные вызовы.
вызывается данным процессом:

$ lttng Enable-event --kernel --all --syscall
$lttng track --kernel --pid 2345
$ старт

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

Предположим, что максимальный PID равен 7 для следующих примеров:

Начальный белый список: [0] [1] [2] [3] [4] [5] [6] [7]]

$ lttng track --userspace --pid 3,6,7

Белый список: [] [] [] [3] [] [] [6] [7]

$ lttng untrack --userspace --pid 7

Белый список: [] [] [] [3] [] [] [6] []

$ lttng track --userspace --pid 1,5

Белый список: [] [1] [] [3] [] [5] [6] []

Следует отметить, что трекер PID отслеживает числовые идентификаторы процессов. Если
процесс с заданным идентификатором выхода и другой процесс получит этот идентификатор, затем последний
также будет разрешено испускать события.

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

ОПЦИИ:

-с, --сессия ИМЯ
Применить к имени сеанса.

-к, --ядро
Применить к трассировщику ядра.

-у, --userspace
Применить к трассировщику пространства пользователя.

-п, --пид [ПИДС]
Отслеживайте идентификаторы процессов PIDS (добавить в белый список).

PIDS - это список PID, разделенных запятыми, для добавления в трекер PID.

Аргумент PIDS должен быть опущен, если также используется --все опцию.

-a --все
Используется вместе с пустым --пид опция: отслеживать все идентификаторы процессов (добавить
все записи в белый список).

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

не отслеживать (-k | -u) --pid [PID1 [, PID2 [, ...]]] [ОПЦИИ]
Удаляет одну или несколько записей из трекера

Смотрите пост в трек документацию command, чтобы узнать больше о трекерах LTTng.

Ассоциация не отслеживать Команда удаляет определенные ресурсы с трекера. Ресурсы для
remove должен быть предварительно добавлен трек команда. Также возможно
удалить все ресурсы из белого списка с помощью --все опцию.

В этой версии единственным доступным трекером является PID трекер.

Одна из распространенных операций - создать сеанс трассировки, удалить все записи из
занести в белый список трекера PID, начать отслеживание, а затем вручную отслеживать PID, пока
трассировка активна.

Предположим, что максимальный PID равен 7 для следующих примеров:

$ lttng создать

Начальный белый список: [0] [1] [2] [3] [4] [5] [6] [7]]

$ lttng untrack --userspace --pid --all

Белый список: [] [] [] [] [] [] [] []

$lttng enable-event --userspace ...
$ старт
...
$ lttng track --userspace --pid 3,5

Белый список: [] [] [] [3] [] [5] [] []

$ lttng track --userspace --pid 2

Белый список: [] [] [2] [3] [] [5] [] []

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

ОПЦИИ:

-с, --сессия ИМЯ
Применить к имени сеанса.

-к, --ядро
Применить к трассировщику ядра.

-у, --userspace
Применить к трассировщику пространства пользователя.

-п, --пид [ПИДС]
Прекратить отслеживание идентификаторов процессов PIDS (удалить из белого списка).

PIDS - это список PID, разделенных запятыми, которые нужно удалить из трекера PID.

Аргумент PIDS должен быть опущен, если также используется --все опцию.

-a --все
Используется вместе с пустым --пид опция: прекратить отслеживать весь процесс
ID (удалить все записи из белого списка).

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

версия
Показать информацию о версии

ОПЦИИ:

-час, --Помогите
Показать сводку возможных опций и команд.

--список-опций
Простой список опций

view [ИМЯ_СЕАНСА] [ВАРИАНТЫ]
Просмотрите следы сеанса трассировки. По умолчанию будет использоваться программа просмотра babeltrace.
для просмотра текста. Если SESSION_NAME опущено, имя сеанса берется из
.lttngrc файл.

ОПЦИИ:

-час, --Помогите
Показать эту помощь

--список-опций
Простой список опций

-т, --trace-путь PATH
Путь к каталогу трассировки для средства просмотра

-е, - зритель CMD
Укажите средство просмотра и / или параметры для использования. Это полностью переопределит
программы просмотра по умолчанию, поэтому не забудьте указать полную команду. След
путь к каталогу сеанса будет добавлен в конце аргументов

ИЮЛЬ / LOG4J ДОМЕН

В этом разделе объясняются домены JUL и LOG4J, где JUL означает ведение журнала Java Util. Ты
можно использовать их с помощью liblttng-ust- -jni.so из lttng-ust(3) проект.

Агент Java LTTng использует JNI для связи трассировщика UST с приложением Java, которое использует
агент. Таким образом, он ведет себя аналогично домену UST (-u). При включении событий вы включаете
имя регистратора, которое затем будет сопоставлено с точкой трассировки UST по умолчанию, называемой
lttng_jul: _событие в lttng_ _канал. Используя lttng-ctl API, любой
События JUL / LOG4J должны использовать тип события точки трассировки (такой же, как --tracepoint).

Из-за неизменяемого канала по умолчанию включить канал команда НЕ МОЖЕТ использоваться с
таким образом, домен JUL и LOG4J не имеет никаких опций.

Также поддерживаются лог-уровни. Использовать лттнг включить-событие -h перечислить их. Подстановочные знаки НЕ
поддерживается, кроме «*», означающего все события (то же, что и -a).

Точно так же, как домен UST, если приложение Java имеет тот же UID, что и вы, вы можете
отследить это. То же самое касается группы трассировки, обращающейся к корневым приложениям.

Наконец, вы можете перечислить каждое имя регистратора, доступное из зарегистрированных приложений для
демон сеанса с помощью лттнг список -j or -l.

Вот пример использования домена JUL.

$ lttng список -j
[...]
$ lttng создать сеанс
$ lttng Enable-event -s aSession -j MyCustomLoggerName
$ старт

Дополнительную информацию можно найти в документации lttng-ust, см. Java-util-logging.txt.

ВЫХОД ЦЕННОСТИ:

В случае успеха возвращается 0, а в случае ошибки - положительное значение. Значение 1 означает ошибку команды,
2 неопределенная команда, 3 фатальная ошибка и 4 предупреждение команды, означающее, что что-то
пошла не так во время команды.

Любое другое значение выше 10, см. для подробного списка или используйте
lttng_strerror (), чтобы получить удобочитаемую строку кода ошибки.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

Обратите внимание, что все параметры командной строки переопределяют переменные среды.

LTTNG_SESSIOND_PATH
Позволяет указать полный двоичный путь демона сеанса к командной строке lttng
инструмент. Вы также можете использовать параметр --sessiond-path, имеющий такой же эффект.

LTTNG_SESSION_CONFIG_XSD_PATH
Задайте путь, по которому сессия.xsd Схема конфигурации сеанса может быть найдена.

Используйте lttng в Интернете с помощью сервисов onworks.net