lttng - Online en la nube

PROGRAMA:

NOMBRE

lttng - Herramienta de línea de comando de control de trazador LTTng 2.x

SINOPSIS

lttng [OPCIONES]

DESCRIPCIÓN

El proyecto LTTng tiene como objetivo proporcionar herramientas de rastreo altamente eficientes para Linux. Sus trazadores
ayudar a rastrear problemas de rendimiento y depurar problemas que involucran múltiples
procesos e hilos. También es posible rastrear a través de múltiples sistemas.

El ltng La herramienta de línea de comandos del paquete lttng-tools se usa para controlar tanto el kernel
y rastreo del espacio de usuario. Cada interacción con el trazador debe realizarse con esta herramienta o
por la biblioteca liblttng-ctl proporcionada por el paquete lttng-tools.

LTTng usa un demonio de sesión (sesión-de-littng(8)), actuando como un registro de rastreo, que
le permite interactuar con múltiples trazadores (kernel y espacio de usuario) dentro del mismo
contenedor, una sesión de rastreo. Las trazas se pueden recopilar del kernel y / o instrumentar
aplicaciones (lttng-ust(3)). La agregación y lectura de esos rastros se realiza mediante el
babeltrace(1) visor de texto.

Introducimos la noción de rastreo dominios que es esencialmente un tipo de trazador (kernel,
espacio de usuario, JUL, LOG4J o Python por ahora). En el futuro, podríamos ver más trazador como
por ejemplo, un hipervisor. Para algunos comandos, deberá especificar en qué dominio
el comando opera (-u, -k, -l, -j o -p). Por ejemplo, se debe especificar el dominio del kernel
al habilitar un evento del kernel.

Para rastrear el kernel, el demonio de sesión debe ejecutarse como root. LTTng
proporciona el uso de un rastreo grupo de XNUMX (predeterminado: rastreo). Quien esté en ese grupo puede
interactuar con el demonio de la sesión raíz y así rastrear el kernel. Los demonios de sesión pueden
existe, lo que significa que puede tener un demonio de sesión ejecutándose como Alice que se puede utilizar para
rastrear sus aplicaciones junto con un demonio raíz o incluso un demonio Bob. Nosotros altamente
Recomendamos iniciar el demonio de sesión en el momento del arranque para un seguimiento estable y a largo plazo.

Cada aplicación de espacio de usuario equipada con lttng-ust(3) se registrará automáticamente
con el demonio de sesión raíz y su demonio de sesión de usuario. Esto permite que cada demonio enumere
las aplicaciones rastreables y los puntos de rastreo disponibles en cualquier momento dado (consulte la lista
mando).

CAMPUS

Este programa sigue la sintaxis habitual de la línea de comandos GNU con opciones largas que comienzan con dos
guiones. A continuación se muestra un resumen de las opciones disponibles.

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-V, --versión
Mostrar versión.

-v, --verboso
Aumenta la verbosidad. Hay tres niveles de verbosidad disponibles que son activados por
poner v adicional a la opción (-vv o -vvv)

-q, --tranquilo
Suprime todos los mensajes (incluso los errores).

-gramo, --grupo NOMBRE
Establecer el nombre del grupo de seguimiento de Unix. (predeterminado: rastreo)

-norte, --sin sesión
No genere automáticamente un demonio de sesión.

--sessiond-ruta TRAYECTORIA
Establezca la ruta binaria completa del demonio de sesión.

--lista-opciones
Listado simple de opciones lttng.

--lista-de-comandos
Listado simple de comandos lttng.

-metro, --mi TIPO
Interfaz de la máquina

TIPO admitido: XML

El modo de interfaz de máquina (MI) convierte la impresión bonita tradicional en una máquina
sintaxis de salida. El modo MI proporciona una forma de acceder a la información resistente a los cambios de formato
generado a través de la línea de comando lttng.

Cuando se usa el modo MI, los datos se imprimen en stdout. El error y la advertencia están impresos en
stderr con el bonito formato predeterminado de impresión.

Si ocurre algún error durante la ejecución de un comando, el valor de retorno del
El comando será diferente a cero. En este caso, lttng NO garantiza la
sintaxis y validez de datos de la salida MI generada.

Para el tipo de salida XML, se puede utilizar un archivo de definición de esquema (XSD) para la validación.
que se encuentra en src / common / mi_lttng.xsd

COMANDOS

agregar contexto [OPCIONES]
Agregue contexto a los eventos y / o canales.

Un contexto es básicamente información adicional adjunta a un canal. Por ejemplo, tu
podría pedirle al trazador que agregue la información PID para todos los eventos en un canal. usted
también puede agregar contadores de unidades de monitoreo de rendimiento (perf PMU) usando el kernel perf
API.

Por ejemplo, este comando agregará la información de contexto 'prio' y dos por CPU
contadores de rendimiento (fallas de rama de hardware y fallas de caché), a todos los eventos en el seguimiento
salida de datos:

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

Consulte la ayuda (-h / - ayuda) para obtener una lista detallada de los
contextos

Los contadores de rendimiento están disponibles por CPU ("perf: cpu: ...") y por subproceso
("perf: thread: ...") contadores. Actualmente, los contadores por CPU solo se pueden usar con el
el dominio de seguimiento del kernel y los contadores por subproceso solo se pueden usar con el UST
dominio de rastreo.

Si no se proporciona ningún canal (-c), el contexto se agrega a todos los canales que ya estaban
activado. Si la sesión no tiene canal, se crea un canal predeterminado. De lo contrario
el contexto se agregará solo al canal dado (-c).

If -s, --sesión se omite, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-s, --sesión NOMBRE
Aplicar en el nombre de la sesión.

-C, --canal NOMBRE
Aplicar en el nombre del canal.

-k, --núcleo
Solicite el trazador de granos

-tu, --espacio de usuario
Solicite el rastreador de espacio de usuario

-t, --escribe TIPO
Tipo de contexto. Puede repetir esta opción en la línea de comando. Por favor use
"lttng add-context -h" para enumerar todos los tipos disponibles.

calibrar [OPCIONES]
Cuantificar la sobrecarga de LTTng

El comando LTTng calibrate se puede utilizar para averiguar la sobrecarga promedio combinada
del trazador LTTng y los mecanismos de instrumentación utilizados. Esta sobrecarga puede ser
calibrado en términos de tiempo o utilizando cualquiera de los contadores de rendimiento de PMU disponibles
en el sistema.

Por ahora, la única calibración implementada es la de la función kernel
instrumentación (kretprobes).

* Calibrar la instrumentación de la función del kernel

Usemos un ejemplo para mostrar esta calibración. Usamos un procesador i7 con 4
registros PMU de propósito general. Esta información está disponible emitiendo dmesg,
buscando "registros genéricos".

Esta secuencia de comandos recopilará un rastro ejecutando un kretprobe enganchado a un
función vacía, recopilación de contadores PMU LLC (caché de último nivel) pierde información
(consulte lttng add-context --help para ver la lista de contadores PMU disponibles).

# lttng crear función de calibración
# lttng enable-event calibrar --kernel \
--función 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
# lttng inicio
# para a en $ (seq 1 10); hacer \
lttng calibrar --kernel --función;
hecho
# lttng destruir
# babeltrace $ (ls -1drt ~ / lttng-traces / calibrate-function-*\
| cola -n 1)

La salida de babeltrace se puede guardar en un archivo de texto y abrir en una hoja de cálculo
(por ejemplo, oocalc) para centrarse en el delta del contador por PMU entre
Eventos "calibrate_entry" y "calibrate_return". Tenga en cuenta que estos contadores
CPU, por lo que los eventos de programación deberían estar presentes para tener en cuenta la migración entre
UPC. Por lo tanto, para fines de calibración, solo los eventos que permanezcan en la misma CPU deben
ser considerado.

El resultado promedio, para el i7, en 10 muestras:

Promedio Std.Dev.
perf_LLC_load_misses: 5.0 0.577
perf_LLC_store_misses: 1.6 0.516
perf_LLC_prefetch_misses: 9.0 14.742

Como podemos notar, la carga y las fallas de almacenamiento son relativamente estables en todas las ejecuciones.
(su desviación estándar es relativamente baja) en comparación con los errores de captación previa. Nosotros
puede concluir a partir de esta información que las fallas de carga y almacenamiento de LLC se pueden contabilizar
con bastante precisión, pero las captaciones previas dentro de una función parecen comportarse también
erráticamente (no hay mucho vínculo de causalidad entre el código ejecutado y la captación previa de la CPU
actividad) para ser contabilizado.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-k, --núcleo
Solicite el trazador de granos

-tu, --espacio de usuario
Solicite el rastreador de espacio de usuario

--función
Sonda de entrada / retorno de función dinámica (por defecto)

Para crear [NOMBRE] [OPCIONES]
Cree una sesión de seguimiento.

Una sesión de seguimiento contiene canales que contienen eventos. Es dominio
agnóstico, lo que significa que los canales y eventos se pueden habilitar para el rastreador de espacio de usuario
y / o el trazador de granos. Actúa como un contenedor que agrega rastreo múltiple.
fuentes.

En la creación, un .lttngrc El archivo se crea en su directorio $ HOME que contiene el
nombre de la sesión actual. Si se omite NAME, se crea automáticamente un nombre de sesión
teniendo esta forma: 'auto-aaaammdd-hhmmss'.

Si no es correcto -Oh, --producción se especifica, las trazas se escribirán en $ HOME / lttng-traces.

La variable de entorno $ HOME puede anularse definiendo el entorno
variable LTTNG_HOME. Esto es útil cuando el usuario que ejecuta los comandos no tiene
directorio de inicio grabable.

El nombre de la sesión NO DEBE contener el carácter '/'.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

-Oh, --producción TRAYECTORIA
Especificar la ruta de salida para los seguimientos

--ninguna salida
No se emitirán trazas

--instantánea
Configure la sesión en modo de instantánea. Creado en modo sin salida y utiliza el
URL, si se especifica una, como salida de instantánea predeterminada. Cada canal
se configurará en modo de sobrescritura y con salida mmap (no se admite el empalme).

--En Vivo [USEC]
Configure la sesión exclusivamente en modo en vivo. El parámetro es el retraso en
microsegundos antes de que los datos se vacíen y se transmitan. El modo en vivo permite
para transmitir la traza y verla mientras está siendo registrada por cualquier trazador.
Para eso, necesita un lttng-relayd y esta sesión requiere una URL de red
(-U o -C / -D). Si no se proporciona USEC ni URL, el valor predeterminado es usar un temporizador
valor establecido en 1000000 y la URL de red establecida en net: //127.0.0.1.

Para leer una sesión en vivo, puede usar babeltrace(1) o la transmisión en vivo
protocolo en doc / live-reading-protocol.txt. Aquí hay un ejemplo:

$ lttng-relayd -o / tmp / lttng
$ lttng create --live 200000 -U net: // localhost
$ lttng habilitar evento -a --espacio de usuario
$ lttng inicio

Después del inicio, podrá leer los eventos mientras se
registrado en / tmp / lttng.

--shm-ruta TRAYECTORIA

Ruta donde se deben crear los búferes de almacenamiento de memoria compartida. Útil cuando se usa
con PRAMFS u otros sistemas de archivos de memoria persistente para extraer datos de seguimiento en
el caso de un bloqueo que requiera reiniciar.

Consulte las lttng-accidente(1) Utility para obtener más información sobre la recuperación de fallos.

-Tú, --set-url = URL
Establezca la URL para el destino de salida del consumidor. Es persistente para el
vida útil de la sesión. Rehaga el comando para cambiarlo. Esto establecerá tanto los datos como
controlar la URL de la red.

-VS, --ctrl-url = URL
Establezca la URL de la ruta de control. (Debe usar -D también)

-RE, --data-url = URL
Establecer URL de ruta de datos. (Debe usar -C también)

Con estas opciones, cada llamada a la API se puede controlar individualmente. Por ejemplo, -C
no habilita al consumidor automáticamente. Necesitará la opción -e para eso.

Enlance FORMATO:

proto: // [HOST | IP] [: PORT1 [: PORT2]] [/ TRACE_PATH]

Los protocolos admitidos son (proto):

expediente://...
Ruta completa del sistema de archivos local.

neto://...
Esto usará la capa de transporte de red predeterminada que es TCP para ambos
control (PORT1) y puerto de datos (PORT2). Los puertos predeterminados son respectivamente
5342 y 5343. Tenga en cuenta que net [6]: // aún no es compatible.

tcp [6]: // ...
Solo se puede usar con -C y -D juntos

NOTA: La dirección IPv6 DEBE estar entre corchetes '[]' (rfc2732)

EJEMPLOS:

# lttng create -U net: //192.168.1.42
Utiliza TCP y puertos predeterminados para el destino dado.

# lttng create -U net6: // [fe80 :: f66d: 4ff: fe53: d220]
Utiliza TCP, puertos predeterminados e IPv6.

# lttng create s1 -U net: //myhost.com: 3229
Cree la sesión s1 y establezca su consumidor en myhost.com en el puerto 3229 para
controlar.

destruir [NOMBRE] [OPCIONES]
Sesión de rastreo de desmontaje

Memoria libre en el daemon de sesión y el rastreador. ¡Se fue!

Si se omite NAME, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-a --todas
Destruye todas las sesiones

--lista-opciones
Lista simple de opciones

habilitar-canal NOMBRE [, NOMBRE2, ...] (-k | -u) [OPCIONES]
Habilitar el canal de seguimiento

Para habilitar un evento, debe habilitar tanto el evento como el canal que contiene
él.

If -s, --sesión se omite, el nombre de la sesión se toma del archivo .lttngrc.

Se debe especificar exactamente uno de -k o -u.

Es importante tener en cuenta que si se utiliza un cierto tipo de búfer, la sesión
configurarse con ese tipo y todos los demás canales subsiguientes deben tener el mismo tipo.

Tenga en cuenta que una vez que la sesión se ha iniciado y habilitado en el lado del trazador, es
ya no es posible habilitar un nuevo canal para esa sesión.

OPCIONES:

-h, --ayuda
Muestra esta ayuda

--lista-opciones
Lista simple de opciones

-s, --sesión NOMBRE
Aplicar en el nombre de la sesión

-k, --núcleo
Aplicar al trazador de granos

-tu, --espacio de usuario
Aplicar al rastreador de espacio de usuario

--descarte
Descartar evento cuando los subbuffers están llenos (predeterminado)

--Sobrescribir
Modo de registro de vuelo: sobrescribe los eventos cuando los subbuffers están llenos. El número
de subbuffer debe ser 2 o más.

--subbuf-tamaño TAMAÑO
Tamaño del subbuffer en bytes {+ k, + M, + G}. (uid UST predeterminado: 131072, pid UST:
4096, kernel: 262144, metadatos: 4096) Redondeado a la siguiente potencia de 2.

El tamaño mínimo del subbuffer, para cada trazador, es el valor máximo entre los
predeterminado arriba y el tamaño de la página del sistema. Puede emitir este comando para obtener
el tamaño de página actual en su sistema: $ obtenerconf TAMAÑO DE PÁGINA

--num-subbuf NUM
Número de subbuffers. (uid UST predeterminado: 4, pid UST: 4, kernel: 4, metadatos:
2) Redondeado a la siguiente potencia de 2.

--interruptor-temporizador USEC
Intervalo del temporizador de subbuffer de conmutación en µseg. (uid UST predeterminado: 0, pid UST: 0,
kernel: 0, metadatos: 0)

--temporizador de lectura USEC
Leer el intervalo del temporizador en µseg. (uid UST predeterminado: 0, pid UST: 0, kernel:
200000, metadatos: 0)

--producción TIPO
Tipo de salida de canal. Valores posibles: mmap, splice (uid de UST predeterminado: mmap,
UST pid: mmap, kernel: empalme, metadatos: mmap)

--buffers-uid
Usar por búfer UID (solo -u). Los búferes se comparten entre aplicaciones que
tienen el mismo UID.

--buffers-pid
Usar por búfer PID (solo -u). Cada aplicación tiene sus propios búferes.

--buffers-global
Usar búfer compartido para todo el sistema (solo -k)

-VS, --tracefile-tamaño TAMAÑO
Tamaño máximo de cada archivo de rastreo dentro de una secuencia (en bytes). 0 significa
ilimitado. (predeterminado: 0) Nota: las trazas generadas con esta opción pueden
Informar de manera inexacta los eventos descartados a partir del CTF 1.8.

-W, --recuento de archivos de seguimiento COUNT
Usado junto con la opción -C, esto limitará la cantidad de archivos
creado para el recuento especificado. 0 significa ilimitado. (predeterminado: 0)

EJEMPLOS:

$ lttng habilitar canal -k -C 4096 -W 32 canal1
Para cada flujo, el tamaño máximo de cada archivo de seguimiento será de 4096 bytes y
habrá un máximo de 32 archivos diferentes. Se adjunta el recuento de archivos
después del número de flujo como se ve en el siguiente ejemplo. El ultimo rastro
El archivo es menor que 4096 ya que no se llenó por completo.

~ / 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 habilitar-canal -k -C 4096
Esto creará archivos de seguimiento de 4096 bytes y creará otros nuevos siempre que
ya que hay datos disponibles.

habilitar-evento NOMBRE [, NOMBRE2, ...] (-k | -u | -j | -l | -p) [OPCIONES]
Habilitar evento de seguimiento

Un evento de seguimiento siempre se asigna a un canal. Si -C, --canal se omite, un
canal predeterminado llamado 'channel0'se crea y se le agrega el evento. Si -C,
--canal se omite, pero ya existe un canal no predeterminado dentro de la sesión,
se devuelve un error. Para el rastreador de espacio de usuario, usando -a --todas es el mismo que
utilizando el comodín "*".

If -s, --sesión se omite, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

-s, --sesión NOMBRE
Aplicar en el nombre de la sesión

-C, --canal NOMBRE
Aplicar en el nombre del canal

-a --todas
Habilite todos los puntos de seguimiento y llamadas al sistema. Esto realmente habilita un solo comodín
evento "*".

-k, --núcleo
Solicite el trazador de granos

-tu, --espacio de usuario
Solicite el rastreador de espacio de usuario

-j, --jul
Solicite la aplicación Java utilizando la interfaz Java Util Logging (JUL)

-yo, --log4j
Solicite la aplicación Java usando LOG4J

-pag, --pitón
Solicite la aplicación Python utilizando el módulo de registro.

--punto de rastreo
Evento de punto de seguimiento (predeterminado). El rastreador del espacio de usuario admite comodines al final
de cuerda. No olvide citar para tratar la expansión de bash. p.ej:
"*"
"componente_aplicación: na *"

--nivel de registro NOMBRE
El rango de nivel de registro de punto de seguimiento de 0 a nivel de registro. Listado en la ayuda (-h). Para
el dominio JUL, los rangos de nivel logarítmico se detallan con la opción --help, por lo que
desde SEVERO hasta MEJOR. Para el dominio LOG4J, los niveles de registro van desde
FATAL to TRACE que también se detallan en la ayuda. Para el dominio de Python,
loglevels van desde CRITICAL a DEBUG que se detallan en la ayuda como
bien.

--solo nivel de registro NOMBRE
Nivel de registro del punto de seguimiento (solo este nivel de registro). El nivel de registro o solo el nivel de registro
Las opciones deben combinarse con un nombre de punto de seguimiento o un comodín de punto de seguimiento.

--Investigacion (dirección | símbolo | símbolo + desplazamiento)
Sonda dinámica. La dirección y el desplazamiento pueden ser octales (0NNN ...), decimales (NNN ...) o
hexadecimal (0xNNN ...)

--función (dirección | símbolo | símbolo + desplazamiento)
Sonda de entrada / retorno de función dinámica. La dirección y el desplazamiento pueden ser octales (0NNN ...),
decimal (NNN ...) o hexadecimal (0xNNN ...)

--llamada al sistema
Evento de llamada al sistema.

--filtrar 'expresión'
Establezca un filtro en un evento recién habilitado. Filtrar expresión en campos de eventos y
contexto. El evento se registrará si la expresión del filtro se evalúa como
VERDADERO. Solo especifique la primera activación de un evento determinado dentro de una sesión.
Solo se permite especificar un filtro cuando se habilitan eventos dentro de una sesión
antes de que se inicie el rastreo. Si el filtro no se vincula con el evento dentro
el dominio rastreado, el evento se descartará.

Ejemplos de expresiones:

'intfield> 500 && intfield <503'
'(strfield == "prueba" || intfield! = 10) && intfield> 33'
'campo doble> 1.1 && intfield <5.3'

Se permiten comodines al final de las cadenas:
'seqfield1 == "te *"' En cadenas literales, el carácter de escape es un '\'.
Utilice '\ *' para el carácter '*' y '\\' para la secuencia de caracteres '\'.
El comodín coincide con cualquier secuencia de caracteres, incluida una subcadena vacía
(coincide con 0 o más caracteres).

La información de contexto se puede utilizar para filtrar. Los ejemplos siguientes muestran
uso de filtrado de contexto en el nombre del proceso (usando un comodín), proceso
Rango de ID e ID de hilo único. El proceso y los ID de subproceso de ejecución
las aplicaciones se pueden encontrar en las columnas "PID" y "LWP" de "ps -eLf"
mando.

'$ ctx.procname == "demo *"'
'$ ctx.vpid> = 4433 && $ ctx.vpid <4455'
'$ ctx.vtid == 1234'

La información de contexto está disponible para todos los filtros, ya sea que el complemento
El comando context se ha utilizado para agregarlo al canal del evento, siempre que
el campo de contexto existe para ese dominio. Por ejemplo, los ejemplos de filtros
dado anteriormente nunca fallará en vincular: no se requiere agregar contexto para el
canal del evento.

-X, --excluir Anuncia
Agregar exclusiones a los puntos de seguimiento de UST: eventos que coinciden con cualquiera de los elementos de la
LIST separados por comas no están habilitados, incluso si coinciden con un comodín
definición del evento.

Esta opción también es aplicable con el -a --todas opción, en cuyo caso todos
Los puntos de rastreo de UST están habilitados, excepto aquellos cuyos nombres coinciden con alguno de los
elementos en LIST.

inhabilitar el canal NOMBRE [, NOMBRE2, ...] (-k | -u) [OPCIONES]
Deshabilitar el canal de seguimiento

La desactivación de un canal desactiva el seguimiento de todos los eventos del canal. Un canal
se puede reactivar llamando ltng habilitar-canal NOMBRE de nuevo.

If -s, --sesión se omite, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

-s, --sesión NOMBRE
Aplicar en el nombre de la sesión

-k, --núcleo
Solicite el trazador de granos

-tu, --espacio de usuario
Solicite el rastreador de espacio de usuario

evento de desactivación NOMBRE [, NOMBRE2, ...] (-k | -u | -j | -l | -p) [TIPO] [OPCIONES]
Deshabilitar evento de seguimiento

El evento, una vez deshabilitado, se puede volver a habilitar llamando ltng habilitar-evento NOMBRE
de nuevo.

If -s, --sesión se omite, el nombre de la sesión se toma del archivo .lttngrc.

If -C, --canal se omite, se utiliza el nombre del canal predeterminado. Si -C, --canal is
omitido, pero ya existe un canal no predeterminado dentro de la sesión, se produce un error
devuelto.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

-s, --sesión NOMBRE
Aplicar en el nombre de la sesión

-C, --canal NOMBRE
Aplicar en el nombre del canal

-a --todos los eventos
Desactiva todos los eventos. Esto NO SÓLO deshabilita "*", sino todos los
eventos de la sesión

-k, --núcleo
Solicite el trazador de granos

-tu, --espacio de usuario
Solicite el rastreador de espacio de usuario

-j, --jul
Solicite la aplicación Java utilizando la interfaz Java Util Logging (JUL)

-yo, --log4j
Solicite la aplicación Java usando LOG4J

-pag, --pitón
Solicite la aplicación Python usando el módulo de registro

TIPO (núcleo dominio solamente):

--todas Desactivar eventos de todo tipo

--punto de rastreo
Deshabilitar evento de tipo tracepoint

--llamada al sistema
Deshabilitar evento de tipo syscall

--Investigacion
Desactivar evento de tipo sonda

--función
Desactivar evento de función de tipo

lista [OPCIONES] [SESIÓN [OPCIONES DE SESIÓN]]
Enumere la información de la sesión de seguimiento.

Sin argumentos, enumerará las sesiones de seguimiento disponibles.

Con el nombre de la sesión, mostrará los detalles de la sesión, incluido el
Traza la ruta del archivo, los canales asociados y su estado (activado y
desactivado), los eventos activados y más.

Con -k solo, enumerará todos los eventos del kernel disponibles (excepto las llamadas al sistema
eventos). Con -j solo, el evento JUL disponible de la aplicación registrada
ser lista. El evento corresponde al nombre del registrador en la aplicación Java JUL.
Con -l solo, se listará el evento LOG4J disponible de la aplicación registrada.
El evento corresponde al nombre del registrador en la aplicación Java LOG4J. Con p
solo, se listará el evento de Python disponible de la aplicación registrada. los
El evento corresponde al nombre del registrador en la aplicación Python. Con -u solo,
enumerará todos los eventos de espacio de usuario disponibles de las aplicaciones registradas. Aquí hay un
ejemplo de 'lttng list -u':

PID: 7448 - Nombre: /tmp/lttng-ust/tests/hello/.libs/lt-hello
ust_tests_hello: tptest_sighandler (tipo: tracepoint)
ust_tests_hello: tptest (tipo: tracepoint)

Ahora puede habilitar cualquier evento listado usando el nombre: ust_tests_hello: tptest.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

-k, --núcleo
Seleccione el dominio del kernel

-tu, --espacio de usuario
Seleccione el dominio del espacio de usuario.

-j, --jul
Solicite la aplicación Java usando JUL

-yo, --log4j
Solicite la aplicación Java usando LOG4J

-pag, --pitón
Solicite la aplicación Python utilizando el módulo de registro.

-F, --los campos
Lista de campos de eventos

SESIÓN OPCIONES:

-C, --canal NOMBRE
Lista de detalles de un canal

-D, --dominio
Lista de dominios disponibles

carga [OPCIONES] [NOMBRE]
Configuración de la sesión de seguimiento de carga

Si se omite NAME, todas las configuraciones de sesión se encuentran tanto en la sesión del usuario
directorio de configuración (predeterminado: ~ / .lttng / sesiones /) y la sesión del sistema
Se cargará el directorio de configuración (predeterminado: / etc / lttng / sessions /). Tenga en cuenta que
las sesiones en el directorio de usuarios se cargan primero y luego en todo el sistema
se cargan el directorio.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-a --todas
Cargue todas las configuraciones de sesión (predeterminado).

-I, --ruta de entrada TRAYECTORIA
Especifique la ruta de entrada para las configuraciones de sesión. Esto anula el
directorio de configuración de sesión predeterminado.

-F, --fuerza
Sobrescribir la (s) configuración (es) de la sesión actual si una sesión con el mismo nombre
ya existe.

ahorrar [OPCIONES] [SESIÓN]
Guardar la configuración de la sesión de seguimiento

Si se omite SESSION, todas las configuraciones de sesión se guardarán en
.lttng archivos en el directorio de configuración de la sesión del usuario (predeterminado:
~ / .lttng / sesiones /). El esquema de nomenclatura del archivo de configuración de sesión predeterminado es
SESIÓN.lttng.

Por ejemplo, un usuario del grupo de seguimiento que guarda una sesión de una sesión raíz
daemon lo guardará en su directorio de usuario.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

-a --todas
Guarde todas las configuraciones de sesión (predeterminado).

-Oh, --ruta de salida TRAYECTORIA
Especifique la ruta de salida para las sesiones guardadas. Esto anula el valor predeterminado
directorio de configuración de sesión.

-F, --fuerza
Sobrescriba el archivo de configuración de la sesión si el nombre de la sesión entra en conflicto.

sesión fija NOMBRE [OPCIONES]
Establecer el nombre de la sesión actual

Cambiará el nombre de la sesión en el archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

instantánea [OPCIONES] ACCIÓN
Comando de instantánea para la sesión LTTng.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

ACCIÓN:

agregar salida [-metro ] [-s ] [-n ] | -C -D

Configure y agregue una salida de instantánea para una sesión. La salida es el destino
donde se enviará la instantánea. Solo se permite una salida. Para cambiarlo
deberá eliminarlo y volver a agregar el nuevo.

del-salida ID | NOMBRE [-s ]

Elimina una salida para una sesión usando el ID de la salida. Puede especificar
la salida por nombre o use su ID como lo devuelve el comando list-output.

salida de lista [-s ]

Enumere el resultado de una sesión. Se imprimen los atributos de la salida.

grabar [-metro ] [-s ] [-n ] [ | -C -D ]

Realice una instantánea de los búfer (s) de una sesión para todos los dominios. Si se especifica una URL,
se utiliza en lugar de una salida agregada previamente. Especificando solo un nombre o / y
un tamaño máximo anulará los valores de salida actuales. Por ejemplo, puedes
grabar una instantánea con un tamaño máximo personalizado o con un nombre diferente.

$ lttng snapshot add-output -n mysnapshot archivo: /// data / snapshot
[...]
$ lttng registro de instantánea -n new_name_snapshot

Lo anterior creará una instantánea en / data / snapshot / new_name_snapshot *
directorio en lugar de en mysnapshot * /

DETALLADO ACCIÓN CAMPUS

-s, --sesión NOMBRE
Aplicar al nombre de la sesión.

-norte, --nombre NOMBRE
Nombre de la salida de la instantánea.

-metro, --tamaño máximo TAMAÑO
Tamaño máximo en bytes de la instantánea. El tamaño máximo no incluye el
archivo de metadatos. Se acepta el formato legible por humanos: {+ k, + M, + G}. Por ejemplo,
- tamaño máximo 5M

-VS, --ctrl-url Enlance
Establezca la URL de la ruta de control. (Debe usar -D también)

-RE, --URL-datos Enlance
Establecer URL de ruta de datos. (Debe usar -C también)

comienzo [NOMBRE] [OPCIONES]
Empezar a rastrear

Comenzará a rastrear todos los rastreadores para una sesión de rastreo específica. Si NAME es
omitido, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

detener [NOMBRE] [OPCIONES]
Dejar de rastrear

Dejará de rastrear todos los rastreadores para una sesión de rastreo específica. Antes
Al regresar, el comando verifica la disponibilidad de datos, lo que significa que esperará hasta
la traza es legible para la sesión. Utilice --no-wait para evitar este comportamiento.

Si se omite NAME, el nombre de la sesión se toma del archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

--no, espera
No espere la disponibilidad de datos.

seguir (-k | -u) --pid [PID1 [, PID2 [, ...]]] [OPCIONES]
Agrega una o más entradas a un rastreador

El seguir El comando agrega una o más entradas a un rastreador. Un rastreador es una lista blanca
de recursos. Los recursos rastreados pueden emitir eventos, siempre que esos eventos
están habilitados (ver el habilitar-evento mando).

Las entradas del rastreador se pueden eliminar de la lista blanca con el destrabar mando.

A partir de esta versión, el único rastreador disponible es el PID rastreador. El ID de proceso
El rastreador (PID) sigue uno o más ID de proceso; solo los procesos con un seguimiento
Los PID pueden emitir eventos. De forma predeterminada, todos los PID posibles en el sistema son
rastreado: cualquier proceso puede emitir eventos habilitados (equivalente a ltng seguir --pid --todas
para todos los dominios).

Con el rastreador PID, es posible, por ejemplo, registrar todas las llamadas al sistema
llamado por un proceso dado:

$ lttng habilitar-evento --kernel --all --syscall
$ lttng pista --kernel --pid 2345
$ lttng inicio

Si se rastrean todos los PID (es decir, ltng seguir --pid --todas, que es el predeterminado
estado de todos los dominios al crear una sesión de seguimiento), luego usando el seguir comando
con uno o más PID específicos tiene el efecto de eliminar primero todos los PID de
la lista blanca y, a continuación, agregue los PID especificados.

Suponga que el PID máximo es 7 para los siguientes ejemplos:

Lista blanca inicial: [0] [1] [2] [3] [4] [5] [6] [7]

$ pista lttng --espacio de usuario --pid 3,6,7

Lista blanca: [] [] [] [3] [] [] [6] [7]

$ lttng untrack --espacio de usuario --pid 7

Lista blanca: [] [] [] [3] [] [] [6] []

$ pista lttng --espacio de usuario --pid 1,5

Lista blanca: [] [1] [] [3] [] [5] [6] []

Cabe señalar que el rastreador PID rastrea los ID numéricos del proceso. ¿Debería un
proceso con una salida de ID dada y a otro proceso se le dará esta ID, luego este último
también se le permitiría emitir eventos.

Consulte las destrabar la documentación del comando para obtener más detalles sobre la eliminación de entradas.

OPCIONES:

-s, --sesión NOMBRE
Aplicar al nombre de la sesión.

-k, --núcleo
Aplicar al trazador de granos.

-tu, --espacio de usuario
Aplicar al rastreador de espacio de usuario.

-pag, --pid [PIDS]
Seguimiento de ID de proceso PIDS (agregar a la lista blanca).

PIDS es una lista separada por comas de PID para agregar al rastreador de PID.

El argumento PIDS debe omitirse cuando también se utiliza el --todas .

-a --todas
Usado junto con un vacío --pid opción: rastrear todos los ID de proceso (agregar
todas las entradas a la lista blanca).

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

destrabar (-k | -u) --pid [PID1 [, PID2 [, ...]]] [OPCIONES]
Elimina una o más entradas de un rastreador

Consulte las seguir la documentación del comando para obtener más información sobre los rastreadores LTTng.

El destrabar comando elimina recursos específicos de un rastreador. Los recursos para
remove debe haber sido agregado previamente por el seguir mando. También es posible
para eliminar todos los recursos de la lista blanca usando el --todas .

A partir de esta versión, el único rastreador disponible es el PID rastreador.

Una operación común es crear una sesión de seguimiento, eliminar todas las entradas de
la lista blanca del rastreador de PID, comience a rastrear y luego rastree manualmente los PID mientras
el rastreo está activo.

Suponga que el PID máximo es 7 para los siguientes ejemplos:

$ lttng crear

Lista blanca inicial: [0] [1] [2] [3] [4] [5] [6] [7]

$ lttng untrack --userspace --pid --todos

Lista blanca: [] [] [] [] [] [] [] []

$ lttng enable-event --espacio de usuario ...
$ lttng inicio
...
$ pista lttng --espacio de usuario --pid 3,5

Lista blanca: [] [] [] [3] [] [5] [] []

$ pista lttng --espacio de usuario --pid 2

Lista blanca: [] [] [2] [3] [] [5] [] []

Consulte las seguir la documentación del comando para obtener más detalles sobre cómo agregar entradas.

OPCIONES:

-s, --sesión NOMBRE
Aplicar al nombre de la sesión.

-k, --núcleo
Aplicar al trazador de granos.

-tu, --espacio de usuario
Aplicar al rastreador de espacio de usuario.

-pag, --pid [PIDS]
Detener el seguimiento de ID de proceso PIDS (eliminar de la lista blanca).

PIDS es una lista separada por comas de PID para eliminar del rastreador de PID.

El argumento PIDS debe omitirse cuando también se utiliza el --todas .

-a --todas
Usado junto con un vacío --pid opción: dejar de rastrear todo el proceso
ID (eliminar todas las entradas de la lista blanca).

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

versión
Mostrar información de versión

OPCIONES:

-h, --ayuda
Muestra un resumen de las posibles opciones y comandos.

--lista-opciones
Lista simple de opciones

view [SESSION_NAME] [OPCIONES]
Ver rastros de una sesión de rastreo. De forma predeterminada, se utilizará el visor de babeltrace
para ver texto. Si se omite SESSION_NAME, el nombre de la sesión se toma del
Archivo .lttngrc.

OPCIONES:

-h, --ayuda
Muestra esta ayuda

--lista-opciones
Lista simple de opciones

-t, --traza-ruta TRAYECTORIA
Rastrear la ruta del directorio para el visor

-mi, --espectador CMD
Especificar el visor y / o las opciones para usar Esto anulará completamente el
visores predeterminados, así que asegúrese de especificar el comando completo. El rastro
La ruta del directorio de la sesión se agregará al final de los argumentos.

JUL / LOG4J DOMINIO

Esta sección explica el dominio JUL y LOG4J donde JUL significa Java Util Logging. usted
puede usarlos usando el liblttng-ust- -jni.so del desplegable lttng-ust(3) proyecto.

El LTTng Java Agent usa JNI para vincular el trazador de UST a la aplicación Java que usa el
agente. Por tanto, se comporta de forma similar al dominio UST (-u). Al habilitar eventos, habilita
un nombre de registrador que luego se asignará a un punto de seguimiento de UST predeterminado llamado
lttng_jul: _evento existentes lttng_ _canal. Con la API lttng-ctl, cualquier
Los eventos JUL / LOG4J deben usar el tipo de evento tracepoint (igual que --tracepoint).

Debido al canal inmutable predeterminado, el habilitar-canal El comando NO PUEDE usarse con
el dominio JUL y LOG4J no tiene opciones.

Además, se admiten los niveles de registro. Usar ltng habilitar-evento -h para enumerarlos. Los comodines NO son
admitido excepto el "*" que significa todos los eventos (igual que -a).

Exactamente como el dominio UST, si la aplicación Java tiene el mismo UID que usted, puede
rastrearlo. Lo mismo ocurre con el grupo de seguimiento que accede a las aplicaciones raíz.

Finalmente, puede enumerar todos los nombres de registradores que están disponibles en las aplicaciones registradas para
el demonio de sesión usando ltng lista -j or -l.

A continuación, se muestra un ejemplo de cómo utilizar el dominio JUL.

$ lttng lista -j
[...]
$ lttng crear una sesión
$ lttng enable-event -s aSession -j MyCustomLoggerName
$ lttng inicio

Puede encontrar más información en la documentación de lttng-ust, consulte java-util-logging.txt

SALIR VALORES

En caso de éxito, se devuelve 0 y un valor positivo en caso de error. El valor de 1 significa un error de comando,
2 un comando indefinido, 3 un error fatal y 4 una advertencia de comando que significa que algo
salió mal durante el comando.

Cualquier otro valor superior a 10, consulte para obtener una lista detallada o utilizar
lttng_strerror () para obtener una cadena legible por humanos del código de error.

MEDIO AMBIENTE VARIABLES

Tenga en cuenta que todas las opciones de la línea de comandos anulan las variables de entorno.

LTTNG_SESSIOND_PATH
Permite especificar la ruta binaria del demonio de sesión completa a la línea de comando lttng
herramienta. También puede usar la opción --sessiond-path que tiene el mismo efecto.

LTTNG_SESSION_CONFIG_XSD_PATH
Establecer el camino en el que sesión.xsd Se puede encontrar el esquema de configuración de la sesión.

Use lttng en línea usando los servicios de onworks.net