babeltrace2(1) – Linux manualsida

Namn

babeltrace2 – konvertera eller bearbeta ett eller flera spår, med mera.

Synopsis

<syntaxhighlight lang="bash"> babeltrace2 [--debug | --verbose | --log-level=NIVÅ]

           [--omit-home-plugin-path] [--omit-system-plugin-path]
           [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]

</syntaxhighlight>

Beskrivning

babeltrace2 är ett kommandoradsprogram med öppen källkod för att konvertera och bearbeta spår.

Verktyget kan öppna ett eller flera spår och konvertera mellan flera format, eventuellt med ett eller flera filter i konverteringsvägen. Det kan även utföra andra åtgärder beroende på kommandot KOMMANDO. Se avsnittet Kommandon.

Mall:Obs

Se babeltrace2-intro(7) för att läsa mer om Babeltrace 2-projektet och dess grundläggande begrepp.

De flesta babeltrace2-kommandon läser in Babeltrace 2-insticksmoduler för att utföra sina operationer. Sökvägen för Babeltrace 2-insticksmoduler är, i denna ordning:

Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i miljövariabeln BABELTRACE_PLUGIN_PATH.
Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i flaggan --plugin-path.
$HOME/.local/lib/babeltrace2/plugins
/usr/local/lib/babeltrace2/plugins

Du kan använda kommandot babeltrace2-list-plugins(1) för att dynamiskt lista tillgängliga insticksmoduler och vad de erbjuder.

Se Projektets insticksmoduler för en lista över insticksmoduler som levereras med Babeltrace 2.

Flaggor

-d, --debug: Äldre flagga. Motsvarar:

<syntaxhighlight lang="bash"> --log-level=TRACE </syntaxhighlight>

-l NIVÅ, --log-level=...

Anger loggnivån för alla kända Babeltrace 2-loggare till NIVÅ, inklusive enskilda komponenter för kommandona babeltrace2-convert(1) och babeltrace2-run(1).

Du kan åsidosätta loggnivån för en specifik komponent med flaggan --log-level för kommandona babeltrace2-convert(1) eller babeltrace2-run(1).

Du kan åsidosätta loggnivån för biblioteket med miljövariabeln LIBBABELTRACE2_INIT_LOG_LEVEL.

Du kan åsidosätta loggnivån för CLI:t med miljövariabeln BABELTRACE_CLI_LOG_LEVEL.

Du kan åsidosätta loggnivån för Babeltrace 2 Python-bindningarna med miljövariabeln BABELTRACE_PYTHON_BT2_LOG_LEVEL.

Tillgängliga värden för NIVÅ:

NONE, N

Loggning är inaktiverad.

FATAL, F

Allvarliga fel som leder till att körningen avbryts omedelbart.

Den här nivån bör vara aktiverad i produktion.

ERROR, E

Fel som eventuellt fortfarande gör att körningen kan fortsätta.

När ett eller flera fel rapporteras på denna nivå kommer programmet, insticksmodulen eller biblioteket vanligtvis inte längre att utföra någon användbar uppgift, men bör ändå avslutas korrekt.

Den här nivån bör vara aktiverad i produktion.

WARN, WARNING, W

Oväntade situationer som ändå tillåter körningen att fortsätta.

Den här nivån bör vara aktiverad i produktion.

INFO, I

Informationsmeddelanden som visar framsteg eller viktiga tillstånd i programmet, insticksmodulerna eller biblioteket.

Den här nivån kan vara aktiverad i produktion.

DEBUG, D

Felsökningsinformation med högre detaljnivå än nivån TRACE.

Den här nivån bör inte vara aktiverad i produktion.

TRACE, T

Lågnivåinformation för felsökning.

Den här nivån bör inte vara aktiverad i produktion.

--omit-home-plugin-path: Sök inte efter insticksmoduler i:

<syntaxhighlight lang="bash"> $HOME/.local/lib/babeltrace2/plugins </syntaxhighlight>

--omit-system-plugin-path: Sök inte efter insticksmoduler i:

<syntaxhighlight lang="bash"> /usr/local/lib/babeltrace2/plugins </syntaxhighlight>

--plugin-path=...: Lägg till SÖKVÄG i listan över sökvägar där insticksmoduler kan hittas.

<syntaxhighlight lang="bash"> --plugin-path=SÖKVÄG[:SÖKVÄG]... </syntaxhighlight>

-v, --verbose: Äldre flagga. Motsvarar:

<syntaxhighlight lang="bash"> --log-level=INFO </syntaxhighlight>

Om KOMMANDO är convert, eller saknas, sätter detta också parametern verbose för den implicita komponenten sink.text.pretty till true.

Se även babeltrace2-sink.text.pretty(7).

-h, --help: Visa hjälp och avsluta.

-V, --version: Visa version och avsluta.

Kommandon

Följande kommandon har även en egen flagga --help.

convert: Konvertera ett eller flera spår till ett givet format, eventuellt med filter i konverteringsvägen.; Detta är standardkommandot. Du behöver inte uttryckligen ange kommandonamnet för att använda det.; Kommandot är bakåtkompatibelt med programmet babeltrace(1).; Se babeltrace2-convert(1).

help: Hämta hjälp för en specifik insticksmodul eller komponentklass.; Se babeltrace2-help(1).

list-plugins: Lista tillgängliga Babeltrace 2-insticksmoduler och deras komponentklasser.; Se babeltrace2-list-plugins(1).

query: Fråga efter ett objekt från en komponentklass.; Se babeltrace2-query(1).

run: Bygg en spårbearbetningsgraf och kör den.; Se babeltrace2-run(1).

Projektets insticksmoduler

Följande insticksmoduler tillhandahålls av Babeltrace 2-projektet självt.

babeltrace2-plugin-ctf(7)

CTF-spårinmatning från filsystemet och från LTTng-live-protokollet, samt utmatning till filsystemet.

Komponentklasser:

babeltrace2-source.ctf.fs(7)
babeltrace2-source.ctf.lttng-live(7)
babeltrace2-sink.ctf.fs(7)

babeltrace2-plugin-lttng-utils(7)

Verktyg för spårbearbetningsgrafer för LTTng-spår.

Komponentklass:

babeltrace2-filter.lttng-utils.debug-info(7)

babeltrace2-plugin-text(7)

Inmatning och utmatning i klartext.

Komponentklasser:

babeltrace2-source.text.dmesg(7)
babeltrace2-sink.text.details(7)
babeltrace2-sink.text.pretty(7)

babeltrace2-plugin-utils(7)

Verktyg för spårbearbetningsgrafer.

Komponentklasser:

babeltrace2-filter.utils.muxer(7)
babeltrace2-filter.utils.trimmer(7)
babeltrace2-sink.utils.counter(7)
babeltrace2-sink.utils.dummy(7)

Exempel

Följande exempel är samma som i manualsidan babeltrace2-convert(1), eftersom convert är standardkommandot för programmet babeltrace2.

Exempel 1: Skriv ut händelserna i ordning från ett eller flera CTF-spår

<syntaxhighlight lang="bash"> babeltrace2 my-ctf-traces

babeltrace2 my-ctf-traces

babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3 </syntaxhighlight>

Exempel 2: Trimma ett CTF-spår och skriv ut händelserna

<syntaxhighlight lang="bash"> babeltrace2 my-ctf-trace --begin=22:55:43.658582931 \

                        --end=22:55:46.967687564

babeltrace2 my-trace --begin=22:55:43.658582931

babeltrace2 my-trace --end=22:55:46.967687564

babeltrace2 my-trace --timerange=22:55:43,22:55:46.967687564 </syntaxhighlight>

Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår

<syntaxhighlight lang="bash"> babeltrace2 my-ctf-trace --stream-intersection \

           --timerange=22:55:43,22:55:46.967687564 \
           --output-format=ctf --output=out-ctf-trace

</syntaxhighlight>

Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live

<syntaxhighlight lang="bash"> babeltrace2 --input-format=lttng-live net://localhost </syntaxhighlight>

Exempel 5: Skriv ut LTTng live-händelser

<syntaxhighlight lang="bash"> babeltrace2 net://localhost/host/myhostname/my-session-name </syntaxhighlight>

Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår

<syntaxhighlight lang="bash"> babeltrace2 net://localhost/host/myhostname/my-session-name \

           --params=session-not-found-action=end \
           --component=sink.ctf.fs \
           --params='path="out-ctf-traces",ctf-version="1"'

</syntaxhighlight>

Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning

<syntaxhighlight lang="bash"> babeltrace2 my-trace --output-format=dummy </syntaxhighlight>

Exempel 8: Läs tre CTF-spår i strömkorsningsläge, lägg till felsökningsinformation och skriv ut dem till en fil

<syntaxhighlight lang="bash"> babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \

           --debug-info --output=pretty-out

</syntaxhighlight>

Exempel 9: Skriv ut ett CTF-spår och spår från en uttrycklig källkomponent med händelsetider visade i sekunder sedan Unix-epoken

<syntaxhighlight lang="bash"> babeltrace2 ctf-trace --component=src.my-plugin.my-src \

           --params='path="spec-trace",output-some-event-type=yes' \
           --clock-seconds

</syntaxhighlight>

Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent

<syntaxhighlight lang="bash"> babeltrace2 net://localhost/host/myhostname/mysession \

           --component=sink.my-plugin.my-sink

</syntaxhighlight>

Exempel 11: Trimma ett CTF-spår, lägg till felsökningsinformation, använd en uttrycklig filterkomponent och skriv som ett CTF-spår

<syntaxhighlight lang="bash"> babeltrace2 /path/to/ctf/trace --timerange=22:14:38,22:15:07 \

           --debug-info --component=filter.my-plugin.my-filter \
           --params=criteria=xyz,ignore-abc=yes \
           --output-format=ctf --output=out-ctf-trace

</syntaxhighlight>

Exempel 12: Skriv ut metadatatxten för ett CTF-spår

<syntaxhighlight lang="bash"> babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata </syntaxhighlight>

Miljövariabler

Babeltrace 2-biblioteket

BABELTRACE_EXEC_ON_ABORT=...: Kör kommandoraden KOMMANDORAD, tolkad som av ett UNIX 98-skal, när någon del av Babeltrace 2-projektet oväntat avbryts.; Programmet avbryts först när det körda kommandot returnerar, och dess avslutningsstatus ignoreras.; Den här miljövariabeln ignoreras när programmet har åtkomsträttighetsflaggan setuid eller setgid satt.

BABELTRACE_TERM_COLOR=(AUTO | NEVER | ALWAYS)

Tvingar terminalfärgstöd för programmet babeltrace2(1) och projektets insticksmoduler.

Tillgängliga värden:

AUTO

Skicka endast terminalfärgkoder när standardutmatning och standardfel är anslutna till en färgkapabel terminal.

NEVER

Skicka aldrig terminalfärgkoder.

ALWAYS

Skicka alltid terminalfärgkoder.

BABELTRACE_TERM_COLOR_BRIGHT_MEANS_BOLD=0: Sätt till 0 för att skicka SGR-koderna 90 till 97 för ljusa färger i stället för fetstil, det vill säga SGR-kod 1, och vanliga färgkoder, det vill säga SGR-koderna 30 till 37.; Se även: https://en.wikipedia.org/wiki/ANSI_escape_code

BABELTRACE_PLUGIN_PATH=...: Anger listan över kataloger, i ordning, där dynamiska insticksmoduler kan hittas innan andra kataloger beaktas.; Värdet är kolonseparerat, eller semikolonseparerat på Windows.

LIBBABELTRACE2_DISABLE_PYTHON_PLUGINS=1: Inaktiverar inläsning av alla Babeltrace 2 Python-insticksmoduler.

LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL=...

Tvingar loggnivån för alla eller specifika komponenter som läggs till i någon spårbearbetningsgraf.

SPEC är ett av följande:

Ett enda loggnivåvärde, NIVÅ.

I detta fall åsidosätter libbabeltrace2 loggnivån som anges när vilken komponent som helst läggs till i någon spårbearbetningsgraf.

En semikolonavgränsad lista med specifikationer på formen:

<syntaxhighlight lang="text"> MÖNSTER:NIVÅ </syntaxhighlight>

MÖNSTER är ett globbningsmönster där endast jokertecknet * är specialtecken. Det matchar noll eller fler tecken.

Du måste skydda tecknen *, ?, [ och \ med \.

NIVÅ är ett loggnivåvärde.

I detta fall åsidosätter libbabeltrace2 loggnivån som anges när en komponent vars namn matchar MÖNSTER läggs till i någon spårbearbetningsgraf.

libbabeltrace2 kontrollerar denna miljövariabel dynamiskt innan en komponent läggs till i en spårbearbetningsgraf. Det betyder att du kan ändra den när som helst med setenv(3).

Tillgängliga värden för NIVÅ:

NONE, N

Loggning är inaktiverad.

FATAL, F

Allvarliga fel som leder till att körningen avbryts omedelbart. Den här nivån bör vara aktiverad i produktion.

ERROR, E

Fel som eventuellt fortfarande gör att körningen kan fortsätta. Den här nivån bör vara aktiverad i produktion.

WARN, WARNING, W

Oväntade situationer som ändå tillåter körningen att fortsätta. Den här nivån bör vara aktiverad i produktion.

INFO, I

Informationsmeddelanden som visar framsteg eller viktiga tillstånd. Den här nivån kan vara aktiverad i produktion.

DEBUG, D

Felsökningsinformation med högre detaljnivå än TRACE. Den här nivån bör inte vara aktiverad i produktion.

TRACE, T

Lågnivåinformation för felsökning. Den här nivån bör inte vara aktiverad i produktion.

Exempel:

ctf*:I;my-sink:D;*:W

</syntaxhighlight>

LIBBABELTRACE2_INIT_LOG_LEVEL=...

Tvingar den initiala loggnivån för Babeltrace 2-biblioteket till NIVÅ.

Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan --log-level för Babeltrace 2-bibliotekets loggare.

Tillgängliga värden för NIVÅ är:

NONE, N
FATAL, F
ERROR, E
WARN, WARNING, W
INFO, I
DEBUG, D
TRACE, T

LIBBABELTRACE2_NO_DLCLOSE=1: Gör att Babeltrace 2-biblioteket lämnar dynamiskt inlästa moduler, det vill säga insticksmoduler och insticksmodulsleverantörer, öppna vid avslut.; Detta kan vara användbart vid felsökning.

LIBBABELTRACE2_PLUGIN_PROVIDER_DIR=...: Anger katalogen från vilken Babeltrace 2-biblioteket dynamiskt läser in delade objekt för insticksmodulsleverantörer.; Om denna miljövariabel är satt åsidosätter den den förvalda katalogen för insticksmodulsleverantörer.

Babeltrace 2 Python-bindningar

BABELTRACE_PYTHON_BT2_LOG_LEVEL=...

Tvingar loggnivån för Babeltrace 2 Python-bindningarna till NIVÅ.

Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan --log-level för Python-bindningarnas loggare.

Tillgängliga värden för NIVÅ är:

NONE, N
FATAL, F
ERROR, E
WARN, WARNING, W
INFO, I
DEBUG, D
TRACE, T

Kommandoradsgränssnitt

BABELTRACE_CLI_LOG_LEVEL=...

Tvingar loggnivån för kommandoradsprogrammet babeltrace2 till NIVÅ.

Om denna miljövariabel är satt åsidosätter den loggnivån som angetts med flaggan --log-level för CLI-loggaren.

Tillgängliga värden för NIVÅ är:

NONE, N
FATAL, F
ERROR, E
WARN, WARNING, W
INFO, I
DEBUG, D
TRACE, T

BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0: Inaktiverar varningsmeddelandet som babeltrace2-convert(1) skriver ut när du konverterar ett spår med en relativ sökväg som också är namnet på ett babeltrace2-kommando.

BABELTRACE_DEBUG=1: Äldre variabel. Motsvarar att sätta flaggan --log-level till TRACE.

BABELTRACE_VERBOSE=1: Äldre variabel. Motsvarar att sätta flaggan --log-level till INFO.

Filer

$HOME/.local/lib/babeltrace2/plugins: Användarens katalog för insticksmoduler.

/usr/local/lib/babeltrace2/plugins: Systemkatalog för insticksmoduler.

/usr/local/lib/babeltrace2/plugin-providers: Systemkatalog för insticksmodulsleverantörer.

Avslutningsstatus

0: Vid lyckad körning.

1: I övriga fall.

Felrapporter

Om du stöter på ett problem eller ett användbarhetsproblem, rapportera det i Babeltrace-felhanteraren:

https://bugs.lttng.org/projects/babeltrace

Resurser

Babeltrace-projektet delar vissa kommunikationskanaler med LTTng-projektet.

Babeltrace-webbplats: https://babeltrace.org/
LTTng-webbplats: https://lttng.org/
E-postlista för support och utveckling: lttng-dev@lists.lttng.org
E-postlistans webbplats: https://lists.lttng.org
IRC-kanal: #lttng på irc.oftc.net
Felhanterare: https://bugs.lttng.org/projects/babeltrace
Git-arkiv: https://git.efficios.com/?p=babeltrace.git
GitHub-projekt: https://github.com/efficios/babeltrace
Kontinuerlig integration: https://ci.lttng.org/view/Babeltrace/
Kodgranskning: https://review.lttng.org/q/project:babeltrace

Författare

Babeltrace 2-projektet är resultatet av hårt arbete av många regelbundna utvecklare och tillfälliga bidragsgivare.

Den nuvarande projektunderhållaren är Jérémie Galarneau:

mailto:jeremie.galarneau@efficios.com

Upphovsrätt

Detta program är en del av Babeltrace 2-projektet.

Babeltrace distribueras under MIT-licensen:

https://opensource.org/licenses/MIT

Se även

babeltrace2-intro(7)
babeltrace2-convert(1)
babeltrace2-help(1)
babeltrace2-list-plugins(1)
babeltrace2-query(1)
babeltrace2-run(1)

Kolofon

Den här sidan är en del av projektet babeltrace, som innehåller bibliotek för att läsa och skriva spår samt en spårkonverterare.

Information om projektet finns på:

http://www.efficios.com/babeltrace

Om du har en felrapport för denna manualsida, skicka den till:

lttng-dev@lists.lttng.org

Denna sida hämtades från projektets uppströms Git-arkiv:

git://git.efficios.com/babeltrace.git

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 4 december 2025.

Om du upptäcker renderingsproblem i HTML-versionen av sidan, känner till en bättre eller mer uppdaterad källa, eller har rättelser eller förbättringar av informationen i denna kolofon, skicka e-post till:

man-pages@man7.org

Sidfot

<syntaxhighlight lang="text"> Babeltrace 2.2.0rc1 14 september 2019 BABELTRACE2(1) </syntaxhighlight>

babeltrace2(1)

Innehåll

babeltrace2(1) – Linux manualsida

Namn

Synopsis

Beskrivning

Flaggor

Kommandon

Projektets insticksmoduler

Exempel

Exempel 1: Skriv ut händelserna i ordning från ett eller flera CTF-spår

Exempel 2: Trimma ett CTF-spår och skriv ut händelserna

Exempel 3: Trimma ett CTF-spår, aktivera strömkorsningsläge och skriv ett CTF-spår

Exempel 4: Skriv ut tillgängliga fjärr-LTTng-sessioner via LTTng live

Exempel 5: Skriv ut LTTng live-händelser

Exempel 6: Spela in LTTng live-spår till filsystemet som CTF 1.8-spår

Exempel 7: Läs ett CTF-spår så snabbt som möjligt med dummy-utmatning

Exempel 8: Läs tre CTF-spår i strömkorsningsläge, lägg till felsökningsinformation och skriv ut dem till en fil

Exempel 9: Skriv ut ett CTF-spår och spår från en uttrycklig källkomponent med händelsetider visade i sekunder sedan Unix-epoken

Exempel 10: Skicka LTTng live-händelser till en uttrycklig sink-komponent

Exempel 11: Trimma ett CTF-spår, lägg till felsökningsinformation, använd en uttrycklig filterkomponent och skriv som ett CTF-spår

Exempel 12: Skriv ut metadatatxten för ett CTF-spår

Miljövariabler

Babeltrace 2-biblioteket

Babeltrace 2 Python-bindningar

Kommandoradsgränssnitt

Filer

Avslutningsstatus

Felrapporter

Resurser

Författare

Upphovsrätt

Se även

Kolofon

Sidfot

Sidor som hänvisar till denna sida

Navigeringsmeny