babeltrace2(1)

babeltrace2(1) – Linux manualsida

Namn

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

Synopsis

babeltrace2 [--debug | --verbose | --log-level=NIVÅ]
            [--omit-home-plugin-path] [--omit-system-plugin-path]
            [--plugin-path=SÖKVÄG[:SÖKVÄG]...] [KOMMANDO] [KOMMANDOARGUMENT]

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.

Obs: Du kanske letar efter manualsidan för babeltrace2-convert(1). Kommandot convert är standardkommandot för babeltrace2 och är bakåtkompatibelt med babeltrace(1).

Se Exempel för exempel på kommandot convert.

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:

1. Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i miljövariabeln BABELTRACE_PLUGIN_PATH.
2. Den kolonseparerade listan, eller semikolonseparerade listan på Windows, över kataloger i flaggan --plugin-path.
3. $HOME/.local/lib/babeltrace2/plugins
4. /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. Detta motsvarar:

--log-level=TRACE

-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:

$HOME/.local/lib/babeltrace2/plugins

--omit-system-plugin-path

Sök inte efter insticksmoduler i:

/usr/local/lib/babeltrace2/plugins

--plugin-path=...

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

--plugin-path=SÖKVÄG[:SÖKVÄG]...

-v, --verbose

Äldre flagga. Detta motsvarar:

--log-level=INFO

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

babeltrace2 my-ctf-traces

babeltrace2 my-ctf-traces

babeltrace2 my-ctf-trace-1 my-ctf-trace-2 my-ctf-trace-3

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

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

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

babeltrace2 my-ctf-trace --stream-intersection \
            --timerange=22:55:43,22:55:46.967687564 \
            --output-format=ctf --output=out-ctf-trace

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

babeltrace2 --input-format=lttng-live net://localhost

Exempel 5: Skriv ut LTTng live-händelser

babeltrace2 net://localhost/host/myhostname/my-session-name

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

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"'

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

babeltrace2 my-trace --output-format=dummy

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

babeltrace2 ctf-trace1 ctf-trace2 ctf-trace3 --stream-intersection \
            --debug-info --output=pretty-out

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

babeltrace2 ctf-trace --component=src.my-plugin.my-src \
            --params='path="spec-trace",output-some-event-type=yes' \
            --clock-seconds

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

babeltrace2 net://localhost/host/myhostname/mysession \
            --component=sink.my-plugin.my-sink

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

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

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

babeltrace2 /path/to/ctf/trace --output-format=ctf-metadata

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:

MÖNSTER:NIVÅ

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.

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.

Exempel:

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

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Å:

• 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.

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Å:

• 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.

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Å:

• 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.

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

Sidor som hänvisar till denna sida

• babeltrace2(1)
• babeltrace2-convert(1)
• babeltrace2-help(1)
• babeltrace2-list-plugins(1)
• babeltrace2-query(1)
• babeltrace2-run(1)
• babeltrace2-intro(7)
• babeltrace2-sink.text.details(7)
• babeltrace2-sink.text.pretty(7)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/babeltrace2.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.