lttng - Online în cloud

PROGRAM:

NUME

lttng - instrument de linie de comandă de control al trasorului LTTng 2.x

REZUMAT

lttng [OPȚIUNI]

DESCRIERE

Proiectul LTTng își propune să ofere instrumente de urmărire extrem de eficiente pentru Linux. Următorii săi
ajuta la identificarea problemelor de performanță și la depanarea problemelor care implică mai multe concurente
procese și fire. De asemenea, este posibilă urmărirea pe mai multe sisteme.

lttng Instrumentul de linie de comandă din pachetul lttng-tools este folosit pentru a controla atât nucleul
și urmărirea spațiului utilizatorului. Fiecare interacțiune cu trasorul ar trebui să fie realizată de acest instrument sau
de biblioteca liblttng-ctl furnizată de pachetul lttng-tools.

LTTng folosește un daemon de sesiune (lttng-sesiune(8)), acționând ca un registru de urmărire, care
vă permite să interacționați cu mai mulți trasori (kernel și spațiu utilizator) în interiorul aceluiași
container, o sesiune de urmărire. Urmele pot fi adunate din nucleu și/sau instrumentate
aplicatii (lttng-ust(3)). Agregarea și citirea acelor urme se realizează folosind
babeltrace(1) vizualizator de text.

Introducem notiunea de calc domenii care este în esență un tip de trasor (nuez,
spațiu utilizator, JUL, LOG4J sau Python pentru moment). În viitor, am putea vedea mai multe trasoare ca
de exemplu un hypervisor. Pentru unele comenzi, va trebui să specificați pe ce domeniu
comanda funcționează (-u, -k, -l, -j sau -p). De exemplu, domeniul nucleului trebuie specificat
la activarea unui eveniment kernel.

Pentru a urmări nucleul, demonul de sesiune trebuie să ruleze ca root. LTTng
prevede utilizarea a calc grup (implicit: urmărire). Oricine se află în acel grup poate
interacționează cu demonul sesiunii rădăcină și, astfel, urmărește nucleul. Demonii de sesiune pot co-
există, ceea ce înseamnă că puteți avea un daemon de sesiune care rulează ca Alice cu care poate fi obișnuit
urmăriți aplicațiile ei alături de un demon rădăcină sau chiar de un demon Bob. Noi foarte
recomandăm pornirea demonului de sesiune în momentul pornirii pentru o urmărire stabilă și pe termen lung.

Fiecare aplicație de spațiu utilizator echipată cu lttng-ust(3) se va înregistra automat
cu demonul de sesiune root și demonul de sesiune utilizator al acestuia. Acest lucru permite fiecărui demon să fie listat
aplicațiile și punctele de urmărire disponibile în orice moment (vezi listă
comanda).

OPŢIUNI

Acest program urmează sintaxa obișnuită a liniei de comandă GNU cu opțiuni lungi care încep cu două
liniuțe. Mai jos este un rezumat al opțiunilor disponibile.

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-V, --versiune
Afișează versiunea.

-v, --verbos
Creșteți verbozitatea. Sunt disponibile trei niveluri de verbozitate care sunt declanșate de
punerea unui v suplimentar la opțiune (-vv sau -vvv)

-q, --Liniște
Suprimați toate mesajele (chiar și erorile).

-g, --grup NUME
Setați numele grupului de urmărire Unix. (implicit: urmărire)

-n, --fără sesiune
Nu generați automat un daemon de sesiune.

--sessiond-path PATH
Setați calea binară completă a demonului de sesiune.

--list-opțiuni
Lista simplă a opțiunilor de lttng.

--list-comenzi
Lista simplă a comenzilor lttng.

-m, --mi TIP
Interfață mașină

TIP acceptat: XML

Modul de interfață a mașinii (MI) transformă tipărirea tradițională frumoasă într-o mașină
sintaxa de ieșire. Modul MI oferă o modalitate rezistentă la schimbare de format de a accesa informații
generat prin linia de comandă lttng.

Când utilizați modul MI, datele sunt imprimate stdout. Eroarea și avertismentul sunt imprimate
stderr cu formatul implicit de imprimare destul de.

Dacă apar erori în timpul executării unei comenzi, valoarea returnată a lui
comanda va fi diferită de zero. În acest caz, lttng NU garantează
sintaxa și validitatea datelor a ieșirii MI generate.

Pentru tipul de ieșire XML, un fișier de definire a schemei (XSD) utilizat pentru validare poate fi
găsit sub src/common/mi_lttng.xsd

COMANDE

adăuga-context [OPȚIUNI]
Adăugați context la eveniment(e) și/sau canal(e).

Un context este practic informații suplimentare atașate unui canal. De exemplu, tu
ar putea cere urmăritorului să adauge informațiile PID pentru toate evenimentele dintr-un canal. Tu
poate adăuga, de asemenea, contoare de unități de monitorizare a performanței (perf PMU) folosind nucleul perf
API-ul.

De exemplu, această comandă va adăuga informațiile de context „prio” și două pe CPU
contoare de perf (eșecuri de ramuri hardware și rateuri de cache), la toate evenimentele din urmărire
date de ieșire:

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

Vă rugăm să aruncați o privire la ajutorul (-h/--help) pentru o listă detaliată a celor disponibile
contexte.

Contoarele de performanță sunt disponibile ca per-CPU ("perf:cpu:...") și per-thread
(„perf:thread:...”) contoare. În prezent, contoarele per CPU pot fi utilizate numai cu
Domeniul de urmărire a nucleului și contoarele per fir pot fi utilizate numai cu UST
domeniul de urmărire.

Dacă nu este dat niciun canal (-c), contextul este adăugat la toate canalele care au fost deja
activat. Dacă sesiunea nu are niciun canal, este creat un canal implicit. In caz contrar
contextul va fi adăugat doar canalului dat (-c).

If -da, --sesiune este omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-da, --sesiune NUME
Aplicați pe numele sesiunii.

-c, --canal NUME
Aplicați pe numele canalului.

-k, --nucleu
Aplicați pentru trasarea nucleului

-u, --spațiu utilizator
Aplicați pentru urmăritorul spațiului utilizator

-t, --tip TIP
Tipul contextului. Puteți repeta această opțiune pe linia de comandă. Vă rugăm să utilizați
„lttng add-context -h” pentru a lista toate tipurile disponibile.

calibra [OPȚIUNI]
Cuantificați costul general LTTng

Comanda de calibrare LTTng poate fi folosită pentru a afla supraîncărcarea medie combinată
a trasorului LTTng și a mecanismelor de instrumentare utilizate. Acest lucru poate fi
calibrat în termeni de timp sau folosind oricare dintre contorul de performanță PMU disponibil
pe sistem.

Deocamdată, singura calibrare implementată este cea a funcției kernel
instrumentare (kretsonde).

* Calibrați instrumentația funcției kernel

Să folosim un exemplu pentru a arăta această calibrare. Folosim un procesor i7 cu 4
registre PMU de uz general. Aceste informații sunt disponibile prin emiterea dmesg,
căutând „registre generice”.

Această secvență de comenzi va aduna o urmă care execută un kretprobe conectat la un
funcția goală, colectarea contoarelor PMU LLC (Last Level Cache) pierde informații
(vezi lttng add-context --help pentru a vedea lista contoarelor PMU disponibile).

# lttng crea funcția de calibrare
# lttng enable-event calibrate --kernel \
--function 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 start
# pentru a în $(seq 1 10); face \
lttng calibrate --kernel --function;
făcut
# lttng distruge
# babeltrace $(ls -1drt ~/lttng-traces/calibrare-function-* \
| coada -n 1)

Ieșirea de la babeltrace poate fi salvată într-un fișier text și deschisă într-o foaie de calcul
(de exemplu oocalc) pentru a se concentra pe delta contorului per-PMU între consecutive
evenimentele „calibrate_entry” și „calibrate_return”. Rețineți că aceste contoare sunt per-
CPU, astfel încât evenimentele de programare ar trebui să fie prezente pentru a lua în considerare migrarea între
CPU. Prin urmare, în scopuri de calibrare, numai evenimentele care rămân pe același CPU trebuie
Fii considerat.

Rezultatul mediu, pentru i7, pe 10 mostre:

Dev. standard mediu
perf_LLC_load_misses: 5.0 0.577
perf_LLC_store_misses: 1.6 0.516
perf_LLC_prefetch_misses: 9.0 14.742

După cum putem observa, pierderile de încărcare și stocare sunt relativ stabile pe parcursul rulărilor
(deviația lor standard este relativ scăzută) în comparație cu ratele prefetch. Noi
poate concluziona din aceste informații că pierderile de încărcare și stocare ale LLC pot fi contabilizate
pentru destul de precis, dar precărcările într-o funcție pare să se comporte și ele
neregulat (nu prea multă legătură de cauzalitate între codul executat și preluarea prealabilă a CPU
activitate) de contabilizat.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-k, --nucleu
Aplicați pentru trasarea nucleului

-u, --spațiu utilizator
Aplicați pentru urmăritorul spațiului utilizator

--funcţie
Sondă de intrare/return funcție dinamică (implicit)

crea [NUME] [OPȚIUNI]
Creați o sesiune de urmărire.

O sesiune de urmărire conține canal(e) care conține eveniment(e). Este un domeniu
agnostic, ceea ce înseamnă că canalele și evenimentele pot fi activate pentru urmăritorul spațiului utilizator
și/sau trasorul nucleului. Acționează ca un container care agregează trasări multiple
surse.

Despre creație, a .lttngrc este creat în directorul dvs. $HOME care conține fișierul
numele sesiunii curente. Dacă NAME este omis, un nume de sesiune este creat automat
având această formă: „auto-aaaammzz-hhmmss”.

Daca nu -o, --ieșire este specificat, urmele vor fi scrise în $HOME/lttng-traces.

Variabila de mediu $HOME poate fi suprascrisă prin definirea mediului
variabila LTTNG_HOME. Acest lucru este util atunci când utilizatorul care execută comenzile are un
directorul principal care poate fi scris.

Numele sesiunii NU TREBUIE să conțină caracterul „/”.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

-o, --ieșire PATH
Specificați calea de ieșire pentru urme

--fără-ieșire
Urmele nu vor fi scoase

--instantaneu
Setați sesiunea în modul instantaneu. Creat în modul fără ieșire și folosește
Adresa URL, dacă este specificată una, ca rezultat implicit al instantaneului. Fiecare canal
va fi setat în modul de suprascriere și cu ieșire mmap (splicing nu este acceptat).

--Trăi [USEC]
Setați sesiunea exclusiv în modul live. Parametrul este întârzierea în
microsecunde înainte ca datele să fie spălate și transmise în flux. Modul live permite
trebuie să transmiteți în flux urmărirea și să o vizualizați în timp ce este înregistrată de orice urmăritor.
Pentru aceasta, aveți nevoie de un retransmis de lttng și această sesiune necesită o adresă URL de rețea
(-U sau -C/-D). Dacă nu sunt furnizate USEC sau URL, implicit este utilizarea unui temporizator
valoarea setată la 1000000 și adresa URL a rețelei setată la net://127.0.0.1.

Pentru a citi o sesiune live, puteți folosi babeltrace(1) sau transmisia în direct
protocol în doc/live-reading-protocol.txt. Iată un exemplu:

$ lttng-relayd -o /tmp/lttng
$ lttng create --live 200000 -U net://localhost
$ lttng enable-event -a --userspace
$ lttng start

După pornire, veți putea citi evenimentele în timp ce acestea sunt
înregistrat în /tmp/lttng.

--shm-cale PATH

Calea în care ar trebui să fie create tampoanele de stocare a memoriei partajate. Util când este folosit
cu PRRAMFS sau alte sisteme de fișiere cu memorie persistentă pentru a extrage datele de urmărire
în cazul unui accident care necesită o repornire.

A se vedea lttng-crash(1) utilitar pentru mai multe informații despre recuperarea în caz de accident.

-U, --set-url=URL
Setați adresa URL pentru destinația de ieșire a consumatorului. Este persistent pentru
durata de viață a sesiunii. Repetați comanda pentru a o schimba. Acest lucru va seta atât datele, cât și
URL de control pentru rețea.

-C, --ctrl-url=URL
Setați adresa URL a căii de control. (Trebuie să folosești și -D)

-D, --data-url=URL
Setați adresa URL a căii de date. (Trebuie să folosești și -C)

Folosind aceste opțiuni, fiecare apel API poate fi controlat individual. De exemplu, -C
nu activează automat consumatorul. Veți avea nevoie de opțiunea -e pentru asta.

URL-ul FORMAT:

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

Protocoalele acceptate sunt (proto):

fişier://...
Calea completă a sistemului de fișiere local.

net://...
Aceasta va folosi stratul implicit de transport al rețelei, care este TCP pentru ambele
control (PORT1) și portul de date (PORT2). Porturile implicite sunt, respectiv
5342 și 5343. Rețineți că net[6]:// nu este încă acceptat.

tcp[6]://...
Poate fi folosit numai împreună cu -C și -D

NOTĂ: adresa IPv6 TREBUIE să fie cuprinsă între paranteze „[]” (rfc2732)

EXEMPLE:

# lttng create -U net://192.168.1.42
Utilizează TCP și porturile implicite pentru destinația dată.

# lttng create -U net6://[fe80::f66d:4ff:fe53:d220]
Utilizează TCP, porturi implicite și IPv6.

# lttng create s1 -U net://myhost.com:3229
Creați sesiunea s1 și setați-i consumatorul la myhost.com pe portul 3229 pentru
controla.

distruge [NUME] [OPȚIUNI]
Sesiune de urmărire a demontării

Memorie liberă pe partea demonului de sesiune și a urmăritorului. S-a dus!

Dacă NAME este omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-A, --toate
Distrugeți toate sesiunile

--list-opțiuni
Lista simplă de opțiuni

activare-canal NUME[,NUME2,...] (-k | -u) [OPȚIUNI]
Activați canalul de urmărire

Pentru a activa un eveniment, trebuie să activați atât evenimentul, cât și canalul care conține
aceasta.

If -da, --sesiune este omis, numele sesiunii este preluat din fișierul .lttngrc.

Trebuie specificat exact unul dintre -k sau -u.

Este important de reținut că, dacă se folosește un anumit tip de buffer-uri, sesiunea va fi
fie setat cu acel tip și toate celelalte canale ulterioare trebuie să aibă același tip.

Rețineți că, odată ce sesiunea a fost pornită și activată pe partea de urmărire, este
nu mai este posibil să activați un nou canal pentru acea sesiune.

OPȚIUNI:

-h, --Ajutor
Arată acest ajutor

--list-opțiuni
Lista simplă de opțiuni

-da, --sesiune NUME
Aplicați pe numele sesiunii

-k, --nucleu
Aplicați pe trasorul nucleului

-u, --spațiu utilizator
Aplicați la urmăritorul spațiului utilizator

--arunca
Eliminați evenimentul când sub-tamponele sunt pline (implicit)

--sobrescrie
Mod înregistrare de zbor: suprascrie evenimentele când subbufferele sunt pline. Numarul
de sub-tampon trebuie să fie 2 sau mai mult.

--subbuf-size MĂRIMEA
Dimensiunea sub-tampon în octeți {+k,+M,+G}. (uid UST implicit: 131072, pid UST:
4096, nucleu: 262144, metadate: 4096) Rotunjit la următoarea putere de 2.

Dimensiunea minimă a subbufferului, pentru fiecare trasor, este valoarea maximă dintre
implicit de mai sus și dimensiunea paginii de sistem. Puteți lansa această comandă pentru a obține
dimensiunea actuală a paginii pe sistemul dvs.: $ getconf MĂRIMEA PAGINII

--num-subbuf NUM
Numărul de subtampoane. (uid UST implicit: 4, pid UST: 4, nucleu: 4, metadate:
2) Rotunjit la următoarea putere de 2.

--switch-timer USEC
Comutați intervalul temporizatorului sub-tampon în µsec. (uid UST implicit: 0, pid UST: 0,
nucleu: 0, metadate: 0)

--timer de citire USEC
Citiți intervalul temporizatorului în µsec. (uid UST implicit: 0, pid UST: 0, nucleu:
200000, metadate: 0)

--ieșire TIP
Tip de ieșire canal. Valori posibile: mmap, splice (uid UST implicit: mmap,
UST pid: mmap, kernel: splice, metadate: mmap)

--buffer-uid
Utilizați pe tampon UID (numai -u). Bufferele sunt partajate între aplicațiile care
au același UID.

--tampoane-pid
Utilizați pe tampon PID (numai -u). Fiecare aplicație are propriile sale tampon.

--tampoane-global
Utilizați tampon partajat pentru întregul sistem (doar -k)

-C, --tracefile-size MĂRIMEA
Dimensiunea maximă a fiecărui fișier de urmărire dintr-un flux (în octeți). 0 înseamnă
nelimitat. (implicit: 0) Notă: urmele generate cu această opțiune pot
raportați incorect evenimentele eliminate începând cu CTF 1.8.

-W, --tracefile-count COUNT
Folosit împreună cu opțiunea -C, aceasta va limita numărul de fișiere
creat la numărul specificat. 0 înseamnă nelimitat. (implicit: 0)

EXEMPLE:

$ lttng activare-canal -k -C 4096 -W 32 canal1
Pentru fiecare flux, dimensiunea maximă a fiecărui fișier de urmărire va fi de 4096 de octeți și
vor exista maximum 32 de fișiere diferite. Numărul de fișiere este atașat
după numărul fluxului, așa cum se vede în exemplul următor. Ultima urmă
fișierul este mai mic decât 4096, deoarece nu a fost complet completat.

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

$ lttng enable-channel -k -C 4096
Acest lucru va crea fișiere de urmărire de 4096 de octeți și va crea altele noi cât timp
deoarece există date disponibile.

activare-eveniment NUME[,NUME2,...] (-k | -u | -j | -l | -p) [OPȚIUNI]
Activați evenimentul de urmărire

Un eveniment de urmărire este întotdeauna atribuit unui canal. Dacă -c, --canal este omis, a
canal implicit numit „channel0' este creat și evenimentul este adăugat la acesta. Dacă -c,
--canal este omis, dar un canal care nu este implicit există deja în cadrul sesiunii,
este returnată o eroare. Pentru urmăritorul spațiului utilizator, folosind -A, --toate este la fel ca
folosind wildcardul „*”.

If -da, --sesiune este omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

-da, --sesiune NUME
Aplicați pe numele sesiunii

-c, --canal NUME
Aplicați pe numele canalului

-A, --toate
Activați toate punctele de urmărire și apelurile de sistem. Acest lucru activează de fapt un singur wildcard
evenimentul „*”.

-k, --nucleu
Aplicați pentru trasarea nucleului

-u, --spațiu utilizator
Aplicați pentru urmăritorul spațiului utilizator

-j, --iul
Aplicați pentru aplicația Java folosind interfața Java Util Logging (JUL)

-l, --log4j
Aplicați pentru aplicația Java folosind LOG4J

-p, --piton
Aplicați pentru aplicația Python folosind modulul de înregistrare.

--punct de urmărire
Eveniment Tracepoint (implicit). Userspace Tracer acceptă metacaracterele la sfârșit
de sfoară. Nu uitați să citați pentru a vă ocupa de extinderea bash. de exemplu:
„*”
„app_component:na*”

--loglevel NUME
Intervalul nivelului de jurnal al punctului de urmărire de la 0 la nivelul jurnalului. Listate în ajutor (-h). Pentru
domeniul JUL, intervalele de nivel de jurnal sunt detaliate cu opțiunea --help astfel
incepand de la SEVERE pana la FINE. Pentru domeniul LOG4J, loglevelurile variază de la
FATAL to TRACE care sunt detaliate și în ajutor. Pentru domeniul Python,
jurnalele variază de la CRITIC la DEBUG, care sunt detaliate în ajutor ca
bine.

--loglevel-only NUME
Tracepoint loglevel (doar acest nivel de jurnal). Nivelul de jurnal sau doar nivelul de jurnal
opțiunile ar trebui să fie combinate cu un nume de punct de urmărire sau un metacar pentru punct de urmărire.

--sondă (adresa | simbol | simbol+offset)
Sondă dinamică. Adr și offset pot fi octale (0NNN...), zecimale (NNN...) sau
hexazecimal (0xNNN...)

--funcţie (adresa | simbol | simbol+offset)
Sondă de intrare/return funcție dinamică. Addr și offset pot fi octale (0NNN...),
zecimal (NNN...) sau hexazecimal (0xNNN...)

--sistem
Eveniment de apel de sistem.

--filtru 'expresie'
Setați un filtru pentru un eveniment nou activat. Filtrați expresia pe câmpurile de evenimente și
context. Evenimentul va fi înregistrat dacă expresia filtrului evaluează
ADEVĂRAT. Specificați doar la prima activare a unui anumit eveniment în cadrul unei sesiuni.
Specificarea unui filtru este permisă numai la activarea evenimentelor dintr-o sesiune
înainte de a începe urmărirea. Dacă filtrul nu reușește să se conecteze cu evenimentul din interior
domeniul urmărit, evenimentul va fi eliminat.

Exemple de expresii:

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

La sfârșitul șirurilor de caractere sunt permise caracterele joker:
'seqfield1 == "te*"' În literalele șir, caracterul de escape este un „\”.
Folosiți „\*” pentru caracterul „*” și „\\” pentru secvența de caractere „\”.
Wildcard se potrivește cu orice secvență de caractere, inclusiv cu un subșir gol
(se potrivește cu 0 sau mai multe caractere).

Informațiile de context pot fi folosite pentru filtrare. Exemplele de mai jos arată
utilizarea filtrelor de context pe numele procesului (folosind un metacar), proces
Interval de ID și ID unic de fir. ID-urile procesului și ale firului de execuție
aplicațiile pot fi găsite în coloanele „PID” și „LWP” din „ps -eLf”
comanda.

„$ctx.procname == „demo*””
„$ctx.vpid >= 4433 && $ctx.vpid < 4455”
„$ctx.vtid == 1234”

Informațiile de context sunt disponibile pentru toate filtrele, indiferent dacă
comanda context a fost folosită pentru a o adăuga la canalul evenimentului, atâta timp cât
câmpul context există pentru acel domeniu. De exemplu, exemplele de filtre
dat mai sus nu va eșua niciodată să se legă: nu este necesar niciun context de adăugare pentru
canalul evenimentului.

-X, --exclude LISTA
Adăugați excluderi la punctele de urmărire UST: evenimente care se potrivesc cu oricare dintre elementele din
LISTELE separate prin virgulă nu sunt activate, chiar dacă se potrivesc cu un metacar
definirea evenimentului.

Această opțiune este aplicabilă și cu -A, --toate opțiune, caz în care toate
Punctele de urmărire UST sunt activate, cu excepția celor ale căror nume se potrivesc cu oricare dintre
articole din LIST.

dezactivare-canal NUME[,NUME2,...] (-k | -u) [OPȚIUNI]
Dezactivează canalul de urmărire

Dezactivarea unui canal dezactivează urmărirea tuturor evenimentelor canalului. Un canal
poate fi reactivat prin apelare lttng activare-canal NUME din nou.

If -da, --sesiune este omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

-da, --sesiune NUME
Aplicați pe numele sesiunii

-k, --nucleu
Aplicați pentru trasarea nucleului

-u, --spațiu utilizator
Aplicați pentru urmăritorul spațiului utilizator

dezactivare-eveniment NUME[,NUME2,...] (-k | -u | -j | -l | -p) [TIP] [OPȚIUNI]
Dezactivează evenimentul de urmărire

Evenimentul, odată dezactivat, poate fi reactivat prin apelare lttng activare-eveniment NUME
din nou.

If -da, --sesiune este omis, numele sesiunii este preluat din fișierul .lttngrc.

If -c, --canal este omis, este folosit numele implicit al canalului. Dacă -c, --canal is
omis, dar un canal care nu este implicit există deja în cadrul sesiunii, este o eroare
întors.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

-da, --sesiune NUME
Aplicați pe numele sesiunii

-c, --canal NUME
Aplicați pe numele canalului

-A, --toate-evenimentele
Dezactivează toate evenimentele. Acest lucru NU NUMAI dezactivează „*”, ci mai degrabă toate cele cunoscute
evenimentele sesiunii

-k, --nucleu
Aplicați pentru trasarea nucleului

-u, --spațiu utilizator
Aplicați pentru urmăritorul spațiului utilizator

-j, --iul
Aplicați pentru aplicația Java folosind interfața Java Util Logging (JUL)

-l, --log4j
Aplicați pentru aplicația Java folosind LOG4J

-p, --piton
Aplicați pentru aplicația Python folosind modulul de înregistrare

TIP (nucleu domeniu numai):

--toate Dezactivați orice tip de eveniment

--punct de urmărire
Dezactivați evenimentul de tip tracepoint

--sistem
Dezactivați evenimentul de tip syscall

--sondă
Dezactivați evenimentul de tip sondă

--funcţie
Dezactivați funcția de tip eveniment

listă [OPȚIUNI] [SESIUNE [OPȚIUNI SESIUNE]]
Listați informații despre sesiunea de urmărire.

Fără argumente, va lista sesiunile de urmărire disponibile.

Cu numele sesiunii, va afișa detaliile sesiunii, inclusiv
calea fișierului de urmărire, canalele asociate și starea acestora (activat și
dezactivat), evenimentele activate și multe altele.

Cu doar -k, va lista toate evenimentele disponibile ale nucleului (cu excepția apelurilor de sistem
evenimente). Doar cu -j, evenimentul JUL disponibil din aplicația înregistrată va fi
fii lista. Evenimentul corespunde numelui Logger din aplicația Java JUL.
Doar cu -l, evenimentul LOG4J disponibil din aplicația înregistrată va fi listat.
Evenimentul corespunde numelui Logger-ului din aplicația Java LOG4J. Cu -p
singur, evenimentul Python disponibil din aplicația înregistrată va fi listat. The
evenimentul corespunde numelui Logger din aplicația Python. Cu -u singur, asta
va lista toate evenimentele disponibile din spațiul utilizatorului din aplicațiile înregistrate. Aici este un
exemplu de 'lttng list -u':

PID: 7448 - Nume: /tmp/lttng-ust/tests/hello/.libs/lt-hello
ust_tests_hello:tptest_sigandler (tip: punct de urmărire)
ust_tests_hello:tptest (tip: punct de urmărire)

Acum puteți activa orice eveniment listat folosind numele: ust_tests_hello:tptest.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

-k, --nucleu
Selectați domeniul kernelului

-u, --spațiu utilizator
Selectați domeniul spațiului utilizator.

-j, --iul
Aplicați pentru aplicația Java folosind JUL

-l, --log4j
Aplicați pentru aplicația Java folosind LOG4J

-p, --piton
Aplicați pentru aplicația Python folosind modulul de înregistrare.

-f, --câmpuri
Listează câmpurile de evenimente

SESIUNE OPȚIUNI:

-c, --canal NUME
Listează detaliile unui canal

-d, --domeniu
Listați domeniile disponibile

încărca [OPȚIUNI] [NUME]
Încărcați configurația sesiunii de urmărire

Dacă NAME este omis, toate configurațiile de sesiune sunt găsite atât în ​​sesiunea utilizatorului
directorul de configurare (implicit: ~/.lttng/sessions/) și sesiunea de sistem
directorul de configurare (implicit: /etc/lttng/sessions/) va fi încărcat. Rețineți că
sesiunile din directorul de utilizatori sunt încărcate mai întâi și apoi la nivelul întregului sistem
directorul sunt încărcate.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-A, --toate
Încărcați toate configurațiile de sesiune (implicit).

-eu, --input-path PATH
Specificați calea de intrare pentru configurațiile de sesiune. Aceasta anulează
directorul implicit de configurare a sesiunii.

-f, --forta
Suprascrie configurația(e) sesiunii curente dacă o sesiune cu același nume
deja exista.

salva [OPȚIUNI] [SESIUNE]
Salvați configurația sesiunii de urmărire

Dacă SESSION este omisă, toate configurațiile sesiunii vor fi salvate în individual
.lttng fișiere din directorul de configurare a sesiunii al utilizatorului (implicit:
~/.lttng/sessions/). Schema implicită de denumire a fișierului de configurare a sesiunii este
SESIUNE.lttng.

De exemplu, un utilizator din grupul de urmărire salvează o sesiune dintr-o sesiune rădăcină
daemon îl va salva în directorul ei/său de utilizatori.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

-A, --toate
Salvați toate configurațiile de sesiune (implicit).

-o, --calea de ieșire PATH
Specificați calea de ieșire pentru sesiunile salvate. Aceasta anulează valoarea implicită
directorul de configurare a sesiunii.

-f, --forta
Suprascrieți fișierul de configurare a sesiunii dacă numele sesiunii intră în conflict.

set-sesiune NUME [OPȚIUNI]
Setați numele sesiunii curente

Se va schimba numele sesiunii în fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

instantaneu [OPȚIUNI] ACȚIUNE
Comanda instantanee pentru sesiunea LTTng.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

ACȚIUNE:

add-output [-m ] [-s ] [-n ] | -C -D

Configurați și adăugați o ieșire instantanee pentru o sesiune. Ieșirea este destinația
unde va fi trimis instantaneul. Este permisă o singură ieșire. Pentru a o schimba,
va trebui să-l ștergeți și să-l adăugați pe cel nou.

del-ieșire ID | NUME [-s ]

Ștergeți o ieșire pentru o sesiune folosind ID-ul ieșirii. Puteți specifica fie
ieșirea după nume sau utilizați ID-ul acestuia, așa cum este returnat de comanda list-output.

listă-ieșire [-s ]

Listați rezultatul unei sesiuni. Atributele rezultatelor sunt tipărite.

record [-m ] [-s ] [-n ] [ | -C -D ]

Faceți un instantaneu al buffer-urilor unei sesiuni pentru toate domeniile. Dacă este specificată o adresă URL, aceasta
este utilizat în locul unei ieșiri adăugate anterior. Specificând doar un nume sau/și
o dimensiune maximă va suprascrie valorile curente de ieșire. De exemplu, poți
înregistrați un instantaneu cu o dimensiune maximă personalizată sau cu un alt nume.

$ lttng snapshot add-output -n mysnapshot file:///data/snapshot
[...]
$ lttng înregistrare instantanee -n new_name_snapshot

Cele de mai sus vor crea un instantaneu în /data/snapshot/new_name_snapshot*
director mai degrabă decât în ​​mysnapshot*/

DETALIAT ACŢIUNE OPŢIUNI

-da, --sesiune NUME
Aplicați la numele sesiunii.

-n, --Nume NUME
Numele ieșirii instantaneului.

-m, --dimensiune maximă MĂRIMEA
Dimensiunea maximă în octeți a instantaneului. Dimensiunea maximă nu include
fișier de metadate. Formatul care poate fi citit de om este acceptat: {+k,+M,+G}. De exemplu,
--dimensiune maxima 5M

-C, --ctrl-url URL-ul
Setați adresa URL a căii de control. (Trebuie să folosești și -D)

-D, --data-url URL-ul
Setați adresa URL a căii de date. (Trebuie să folosești și -C)

Începe [NUME] [OPȚIUNI]
Începeți urmărirea

Va începe urmărirea pentru toți urmăritorii pentru o anumită sesiune de urmărire. Dacă NAME este
omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

opri [NUME] [OPȚIUNI]
Opriți urmărirea

Acesta va opri urmărirea pentru toți trasorii pentru o anumită sesiune de urmărire. Inainte de
revenind, comanda verifică disponibilitatea datelor, ceea ce înseamnă că va aștepta până la
urma este lizibilă pentru sesiune. Utilizați --no-wait pentru a evita acest comportament.

Dacă NAME este omis, numele sesiunii este preluat din fișierul .lttngrc.

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

--nu așteptați
Nu așteptați disponibilitatea datelor.

urmări (-k | -u) --pid [PID1[,PID2[,...]]] [OPȚIUNI]
Adaugă una sau mai multe intrări la un tracker

urmări comanda adaugă una sau mai multe intrări la un tracker. Un tracker este o listă albă
a resurselor. Resursele urmărite au voie să emită evenimente, cu condiția ca aceste evenimente
sunt activate (vezi activare-eveniment comanda).

Intrările de urmărire pot fi eliminate din lista albă cu ajutorul dezvaluie comanda.

Începând cu această versiune, singurul tracker disponibil este PID tracker. ID-ul procesului
trackerul (PID) urmează unul sau mai multe ID-uri de proces; numai procesele cu un urmărit
PID au voie să emită evenimente. În mod implicit, toate PID-urile posibile de pe sistem sunt
urmărit: orice proces poate emite evenimente activate (echivalentul a lttng urmări --pid --toate
pentru toate domeniile).

Cu trackerul PID, este posibil, de exemplu, să înregistrați toate apelurile de sistem
numit de un proces dat:

$ lttng enable-event --kernel --all --syscall
$ lttng track --kernel --pid 2345
$ lttng start

Dacă toate PID-urile sunt urmărite (de ex lttng urmări --pid --toate, care este implicit
starea tuturor domeniilor la crearea unei sesiuni de urmărire), apoi folosind urmări comandă
cu unul sau mai multe PID-uri specifice are ca efect eliminarea mai întâi a tuturor PID-urilor din
lista albă, apoi adăugând PID-urile specificate.

Să presupunem că PID-ul maxim este 7 pentru următoarele exemple:

Lista albă inițială: [0] [1] [2] [3] [4] [5] [6] [7]

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

Lista albă: [ ] [ ] [ ] [3] [ ] [ ] [6] [7]

$ lttng untrack --userspace --pid 7

Lista albă: [ ] [ ] [ ] [3] [ ] [ ] [6] [ ]

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

Lista albă: [ ] [1] [ ] [3] [ ] [5] [6] [ ]

Trebuie remarcat faptul că instrumentul de urmărire PID urmărește ID-urile numerice ale procesului. Ar trebui a
procesului cu un anumit ID de ieșire și unui alt proces să i se dea acest ID, apoi celui din urmă
ar avea de asemenea voie să emită evenimente.

A se vedea dezvaluie documentația comenzii pentru mai multe detalii despre eliminarea intrărilor.

OPȚIUNI:

-da, --sesiune NUME
Aplicați la numele sesiunii.

-k, --nucleu
Aplicați pe trasorul nucleului.

-u, --spațiu utilizator
Aplicați la urmăritorul spațiului utilizator.

-p, --pid [PIDS]
Urmăriți ID-urile de proces PIDS (adăugați la lista albă).

PIDS este o listă de PID-uri separate prin virgulă de adăugat la instrumentul de urmărire PID.

Argumentul PIDS trebuie omis atunci când se folosește și --toate opțiune.

-A, --toate
Folosit împreună cu un gol --pid opțiune: urmăriți toate ID-urile procesului (adăugați
toate intrările în lista albă).

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

dezvaluie (-k | -u) --pid [PID1[,PID2[,...]]] [OPȚIUNI]
Elimină una sau mai multe intrări dintr-un tracker

A se vedea urmări documentația comenzii pentru a afla mai multe despre trackerele LTTng.

dezvaluie comanda elimină resurse specifice dintr-un tracker. Resursele pentru
remove trebuie să fi fost adăugat anterior de către urmări comanda. De asemenea, este posibil
pentru a elimina toate resursele din lista albă folosind --toate opțiune.

Începând cu această versiune, singurul tracker disponibil este PID tracker.

O operațiune comună este crearea unei sesiuni de urmărire, eliminarea tuturor intrărilor din
lista albă PID tracker, începeți urmărirea și apoi urmăriți manual PID-urile în timp ce
urmărirea este activă.

Să presupunem că PID-ul maxim este 7 pentru următoarele exemple:

$ lttng crea

Lista albă inițială: [0] [1] [2] [3] [4] [5] [6] [7]

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

Lista albă: [ ] [ ] [ ] [ ] [ ] [ ] [ ] [ ]

$ lttng enable-event --userspace...
$ lttng start
...
$ lttng track --userspace --pid 3,5

Lista albă: [ ] [ ] [ ] [3] [ ] [5] [ ] [ ]

$ lttng track --userspace --pid 2

Lista albă: [ ] [ ] [2] [3] [ ] [5] [ ] [ ]

A se vedea urmări documentația comenzii pentru mai multe detalii despre adăugarea de intrări.

OPȚIUNI:

-da, --sesiune NUME
Aplicați la numele sesiunii.

-k, --nucleu
Aplicați pe trasorul nucleului.

-u, --spațiu utilizator
Aplicați la urmăritorul spațiului utilizator.

-p, --pid [PIDS]
Opriți urmărirea ID-urilor de proces PIDS (eliminați din lista albă).

PIDS este o listă de PID-uri separate prin virgulă de eliminat din instrumentul de urmărire PID.

Argumentul PIDS trebuie omis atunci când se folosește și --toate opțiune.

-A, --toate
Folosit împreună cu un gol --pid opțiune: opriți urmărirea întregului proces
ID-uri (eliminați toate intrările din lista albă).

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

versiune
Afișați informații despre versiune

OPȚIUNI:

-h, --Ajutor
Afișați rezumatul opțiunilor și comenzilor posibile.

--list-opțiuni
Lista simplă de opțiuni

Vizualizează [SESSION_NAME] [OPȚIUNI]
Vizualizați urmele unei sesiuni de urmărire. În mod implicit, va fi utilizat vizualizatorul babeltrace
pentru vizualizarea textului. Dacă SESSION_NAME este omis, numele sesiunii este preluat din
fișier .lttngrc.

OPȚIUNI:

-h, --Ajutor
Arată acest ajutor

--list-opțiuni
Lista simplă de opțiuni

-t, --urme-cale PATH
Urmăriți calea directorului pentru vizualizator

-e, --vizor CMD
Specificați vizualizatorul și/sau opțiunile de utilizat. Aceasta va înlocui complet
vizualizatoare implicite, așa că asigurați-vă că specificați comanda completă. Urma
calea directorului a sesiunii va fi atașată la sfârșitul argumentelor

JUL/LOG4J DOMENIUL

Această secțiune explică domeniul JUL și LOG4J unde JUL înseamnă Java Util Logging. Tu
pot folosi acestea folosind liblttng-ust- -jni.so de la lttng-ust(3) proiect.

Agentul Java LTTng folosește JNI pentru a conecta trasarea UST la aplicația Java care utilizează
agent. Astfel, se comportă similar cu domeniul UST (-u). Când activați evenimentele, activați
un nume Logger care va fi apoi mapat la un punct de urmărire UST implicit apelat
lttng_jul: _eveniment în lttng_ _canal. Folosind API-ul lttng-ctl, orice
Evenimentele JUL/LOG4J trebuie să utilizeze tipul de eveniment tracepoint (la fel ca --tracepoint).

Din cauza canalului implicit imuabil, activare-canal comanda NU POATE fi folosită cu
domeniul JUL și LOG4J neavând astfel nicio opțiune.

De asemenea, nivelurile de jurnal sunt acceptate. Utilizare lttng activare-eveniment -h pentru a le enumera. Wildcard-urile NU sunt
acceptat, cu excepția „*” care înseamnă toate evenimentele (la fel ca -a).

Exact ca și domeniul UST, dacă aplicația Java are același UID ca și tine, poți
urmăriți-l. Același lucru este valabil și pentru grupul de urmărire care accesează aplicațiile rădăcină.

În cele din urmă, puteți enumera fiecare nume de Logger care sunt disponibile din aplicațiile înregistrate la
demonul de sesiune prin utilizarea lttng listă -j or -l.

Iată un exemplu despre cum să utilizați domeniul JUL.

$ lttng list -j
[...]
$ lttng creați o sesiune
$ lttng enable-event -s aSession -j MyCustomLoggerName
$ lttng start

Mai multe informații pot fi găsite în documentația lttng-ust, consultați java-util-logging.txt

EXIT VALORI

La succes, se returnează 0 și o valoare pozitivă la eroare. Valoarea 1 înseamnă o eroare de comandă,
2 o comandă nedefinită, 3 o eroare fatală și 4 o avertizare de comandă care înseamnă că ceva
a greșit în timpul comenzii.

Orice altă valoare peste 10, vă rugăm să consultați pentru o listă detaliată sau utilizare
lttng_strerror() pentru a obține un șir care poate fi citit de om al codului de eroare.

MEDIUL VARIABILE

Rețineți că toate opțiunile liniei de comandă înlocuiesc variabilele de mediu.

LTTNG_SESSIOND_PATH
Permite să specifice calea binară a demonului de sesiune completă către linia de comandă lttng
instrument. De asemenea, puteți utiliza opțiunea --sessiond-path având același efect.

LTTNG_SESSION_CONFIG_XSD_PATH
Setați calea în care session.xsd schema de configurare a sesiunii poate fi găsită.

Utilizați lttng online folosind serviciile onworks.net