babeltrace2-convert(1)

babeltrace2-convert

babeltrace2-convert – konvertera en eller flera spårningar till ett givet format

Namn

babeltrace2-convert – konvertera en eller flera spårningar till ett givet format

Synopsis

Skriv ut händelserna i en eller flera spårningar som vanlig text

babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
            [--allowed-mip-versions=VERSION] SPÅR-SÖKVÄG...

Konvertera en eller flera spårningar till ett givet format

babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
            [--allowed-mip-versions=VERSION] KONVERTERINGSARGUMENT

Visa motsvarande kommandoradsargument för babeltrace2-run för en konvertering

babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--retry-duration=TID-US]
            [--allowed-mip-versions=VERSION]
            (--run-args | --run-args-0) KONVERTERINGSARGUMENT

Skriv ut metadata-texten för ett CTF-spår

babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--output=UTSÖKVÄG]
            --output-format=ctf-metadata SPÅR-SÖKVÄG

Visa tillgängliga fjärrsessioner för LTTng

babeltrace2 [ALLMÄNNA FLAGGOR] [convert] [--output=UTSÖKVÄG]
            --input-format=lttng-live URL

Beskrivning

Kommandot convert konverterar en eller flera spårningar till ett givet format, eventuellt med filter i konverteringskedjan.

Se babeltrace2-intro(7) för mer information om Babeltrace 2 och dess grundbegrepp.

Obs

convert är standardkommandot för babeltrace2(1). Därför behöver du normalt inte ange namnet uttryckligen. Följande kommandon är likvärdiga om delen ... inte börjar med namnet på ett annat babeltrace2-kommando, som run eller list-plugins:

$ babeltrace2 convert ...
$ babeltrace2 ...

Om du vill vara säker på att just convert-kommandot körs, använd uttryckligen:

babeltrace2 convert

Mer specifikt skapar kommandot convert en konverteringsgraf.

En konverteringsgraf är en specialiserad spårbearbetningsgraf med fokus på att omvandla en eller flera spårningar till ett annat format, eventuellt genom att filtrera eller ändra deras händelser och andra meddelanden under vägen. När källströmmarna har slagits samman är grafen linjär.

En implicit komponent är en komponent som skapas och läggs till i konverteringsgrafen utan att uttryckligen instansieras med flaggan --component. En implicit komponent är enklare att skapa än en explicit komponent, och det är därför kommandot convert finns.

Exempelvis kan du ange en eller flera CTF-spårsökvägar som icke-flaggeargument för att skriva ut de sammanslagna händelserna till standardutmatningen:

$ babeltrace2 /path/to/trace /path/to/other/trace

Detta motsvarar att skapa och koppla ihop:

• en eller flera source.ctf.fs-komponenter
• en filter.utils.muxer-komponent
• en sink.text.pretty-komponent

Du kan använda flaggan --run-args för att låta convert skriva ut motsvarande argument till kommandot run i stället för att skapa och köra grafen.

Skapa explicita komponenter

För att uttryckligen skapa en komponent, använd flaggan:

--component

Den anger:

• valfritt: komponentens namn
• typen av komponentklass att instansiera: källa, filter eller sink
• namnet på insticksmodulen där komponentklassen finns
• namnet på komponentklassen att instansiera

Du kan ange --component flera gånger för att skapa flera komponenter.

Flaggorna nedan gäller för den aktuella explicita komponenten:

--log-level=LVL

sätt loggnivån för den aktuella komponenten till LVL

--params=PARAMS

lägg till PARAMS till initialiseringsparametrarna för den aktuella komponenten

Skapa implicita komponenter från argument utan flagga

När du anger ett argument utan flagga försöker convert hitta en eller flera komponenter som kan hantera detta argument.

Exempel:

$ babeltrace2 /path/to/trace

Om /path/to/trace är en CTF-spårkatalog skapas en implicit source.ctf.fs-komponent.

Om argumentet är en katalog och ingen komponent direkt kan hantera den, traverserar convert katalogen rekursivt och försöker hitta kompatibla komponenter för varje fil och underkatalog.

Följande flaggor gäller för alla implicita komponenter som skapats från det senaste argumentet utan flagga:

--log-level=LVL

sätt loggnivån till LVL

--params=PARAMS

lägg till initialiseringsparametrar

Av bakåtkompatibilitet med babeltrace(1) ignorerar convert argument utan flagga som inte leder till att någon komponent skapas. I så fall skrivs en varning till loggen och körningen fortsätter.

Skapa implicita komponenter från flaggor

Det finns flera sätt att skapa implicita komponenter via flaggor:

Implicit filter.utils.trimmer

Om du anger någon av dessa flaggor skapas en implicit filter.utils.trimmer-komponent:

• --begin
• --end
• --timerange

Implicit filter.lttng-utils.debug-info

Om du anger någon av dessa flaggor skapas en implicit filter.lttng-utils.debug-info-komponent:

• --debug-info
• --debug-info-dir
• --debug-info-full-path
• --debug-info-target-prefix

Implicit sink.text.pretty

Om ingen annan sink-komponent anges skapas som standard en implicit sink.text.pretty-komponent.

Följande flaggor påverkar den:

• --clock-cycles
• --clock-date
• --clock-gmt
• --clock-seconds
• --color
• --fields
• --names
• --no-delta

Implicit sink.utils.dummy

För att skapa en implicit sink.utils.dummy-komponent:

--output-format=dummy

Implicit sink.ctf.fs

För att skapa en implicit sink.ctf.fs-komponent:

--output-format=ctf --output=KATALOG

Från och med denna version skapar sink.ctf.fs som standard CTF 2-spår.

Alternativ

Allmänna

Dessa flaggor kan användas före kommandonamnet.

-d, --debug

äldre flagga; motsvarar --log-level=TRACE

-l LVL, --log-level=LVL

sätt loggnivån för alla kända Babeltrace 2-loggare till LVL

--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=PATH[:PATH]...

lägg till PATH i sökvägslistan för insticksmoduler

-v, --verbose

äldre flagga; motsvarar --log-level=INFO

Explicit komponentskapelse

-c [NAMN:]TYP.PLUGIN.KLASS, --component=[NAMN:]TYP.PLUGIN.KLASS

skapa en komponent från den angivna komponentklassen och gör den till aktuell komponent

Tillgängliga typer:

• source, src
• filter, flt
• sink

Gemensamma alternativ för komponentskapelse

-l LVL, --log-level=LVL

sätt loggnivån för aktuell komponent eller aktuella implicita komponenter

Möjliga nivåer:

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

-p PARAMS, --params=PARAMS

lägg till initialiseringsparametrar

Format:

NAMN=VÄRDE[,NAMN=VÄRDE]...

Värden kan vara:

• null
• boolean
• heltal
• flyttal
• sträng
• array
• map

Äldre flaggor för implicita komponenter

-i FORMAT, --input-format=FORMAT

tvinga convert att skapa komponenter från en viss komponentklass för argument utan flagga, eller visa tillgängliga fjärrsessioner för LTTng

Tillgängliga värden:

• ctf
• lttng-live

-o FORMAT, --output-format=FORMAT

skapa en implicit sink-komponent med formatet FORMAT eller skriv ut metadata-texten för ett CTF-spår

Tillgängliga värden:

• text
• ctf
• dummy
• ctf-metadata

Implicit source.ctf.fs

--clock-force-correlate

sätter parametern force-clock-class-origin-unix-epoch till true

--clock-offset=SEK

lägg till SEK sekunder till klockklassernas offset

--clock-offset-ns=NS

lägg till NS nanosekunder till klockklassernas offset

Implicit filter.utils.trimmer

--begin=TID

sätt starttid

--end=TID

sätt sluttid

--timerange=START,SLUT

motsvarar både --begin och --end

Formatet för TID kan vara:

YYYY-MM-DD HH:MM[:SS[.NANO]]
HH:MM[:SS[.NANO]]
[-]SEK[.NANO]

Implicit filter.lttng-utils.debug-info

--debug-info

skapa en implicit felsökningsinformationskomponent

--debug-info-dir=KAT

ange katalog för felsökningsinformation

--debug-info-full-path

använd fullständiga sökvägar i stället för korta filnamn

--debug-info-target-prefix=PREFIX

lägg till PREFIX före körbarfilssökvägar från spåret

Implicit sink.text.pretty

--clock-cycles

skriv ut händelsetid i klockcykler

--clock-date

skriv ut datum och tid

--clock-gmt

använd inte lokal tidszon

--clock-seconds

skriv ut tider i sekunder sedan Unix-epoken

--color=WHEN

styr terminalfärger

Värden:

• auto
• never
• always

--fields=FIELD[,FIELD]...

aktivera visning av vissa fält

--names=NAME[,NAME]...

aktivera visning av vissa namn

--no-delta

skriv inte ut tidsdelta sedan senaste händelse

Delade alternativ

-w PATH, --output=PATH

skriv text till filen PATH, eller ange utdatakatalog för CTF-utmatning

Motsvarande babeltrace2 run-argument

--run-args

skriv ut motsvarande argument till babeltrace2-run, skal-escapade och blankstegsseparerade

--run-args-0

skriv ut motsvarande argument till babeltrace2-run, nullseparerade och utan skal-escaping

Konfiguration av konverteringsgraf

-m VERSION, --allowed-mip-versions=VERSION

tillåt endast MIP-version VERSION

--retry-duration=TID-US

sätt längden för ett enskilt försök till TID-US mikrosekunder

Standard: 100000 (100 ms)

--stream-intersection

aktivera strömsnittsläge, där endast meddelanden inom den tidsperiod där alla strömmar i ett spår är aktiva tas med

Övriga äldre flaggor

-d, --debug

äldre varianten av felsökningsloggning

-v, --verbose

äldre varianten av informationsloggning; sätter även verbose-parametern för implicit sink.text.pretty

Kommandoinformation

-h, --help

visa hjälp för kommandot och avsluta

Exempel

1. Skriv ut händelserna från ett eller flera CTF-spår

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

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

3. Trimma ett CTF-spår, aktivera stream intersection och skriv ett nytt CTF-spår

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

4. Visa tillgängliga fjärrsessioner för LTTng

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

5. Skriv ut LTTng live-händelser

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

6. Spara LTTng live-spår till filsystemet som CTF 1.8

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

7. Läs ett CTF-spår så snabbt som möjligt med dummy-utdata

$ babeltrace2 my-trace --output-format=dummy

8. Läs tre CTF-spår, 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

9. Skriv ut ett CTF-spår och ett explicit källspår med tider 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

10. Skicka LTTng live-händelser till en explicit sink-komponent

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

11. Trimma ett CTF-spår, lägg till felsökningsinformation, använd ett explicit filter och skriv som CTF

$ 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

12. Skriv ut metadata-texten för ett CTF-spår

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

Miljövariabler

Babeltrace 2-biblioteket

BABELTRACE_EXEC_ON_ABORT=CMDLINE

kör kommandoraden CMDLINE när någon del av Babeltrace 2 avbryts oväntat

BABELTRACE_TERM_COLOR=(AUTO|NEVER|ALWAYS)

tvinga stöd för terminalfärger

BABELTRACE_TERM_COLOR_BRIGHT_MEANS_BOLD=0

använd ljusa färgkoder i stället för fetstil

BABELTRACE_PLUGIN_PATH=PATHS

ange sökvägar för dynamiska insticksmoduler

LIBBABELTRACE2_DISABLE_PYTHON_PLUGINS=1

inaktivera laddning av Python-insticksmoduler

LIBBABELTRACE2_FORCE_COMPONENT_LOG_LEVEL=SPEC

tvinga loggnivå för alla eller vissa komponenter

LIBBABELTRACE2_INIT_LOG_LEVEL=LVL

tvinga initial loggnivå för biblioteket

LIBBABELTRACE2_NO_DLCLOSE=1

lämna dynamiskt laddade moduler öppna vid avslut

LIBBABELTRACE2_PLUGIN_PROVIDER_DIR=DIR

katalog för dynamiskt laddade plugin-provider-objekt

Babeltrace 2 Python-bindningar

BABELTRACE_PYTHON_BT2_LOG_LEVEL=LVL

tvinga loggnivån för Python-bindningarna

Kommandoradsgränssnittet

BABELTRACE_CLI_LOG_LEVEL=LVL

tvinga loggnivån för CLI:t

BABELTRACE_CLI_WARN_COMMAND_NAME_DIRECTORY_CLASH=0

inaktivera varningen om att en relativ spårsökväg krockar med ett kommandonamn

BABELTRACE_DEBUG=1

äldre variabel; motsvarar --log-level=TRACE

BABELTRACE_VERBOSE=1

äldre variabel; motsvarar --log-level=INFO

Filer

$HOME/.local/lib/babeltrace2/plugins

Användarkatalog för insticksmoduler.

/usr/local/lib/babeltrace2/plugins

Systemkatalog för insticksmoduler.

/usr/local/lib/babeltrace2/plugin-providers

Systemkatalog för plugin-providers.

Avslutsstatus

0

lyckades

1

fel uppstod

Fel

Om du stöter på problem eller användbarhetsproblem, rapportera dem till Babeltraces felspårare:

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

Resurser

Babeltrace-projektet delar vissa kommunikationskanaler med LTTng-projektet.

• Babeltraces webbplats:

https://babeltrace.org/

• E-postlista för stöd och utveckling:

lttng-dev@lists.lttng.org

• IRC-kanal:

#lttng på irc.oftc.net

• Felspårare:

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 arbete från många regelbundna utvecklare och tillfälliga bidragsgivare.

Nuvarande projektansvarig är Jérémie Galarneau.

Upphovsrätt

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

Babeltrace distribueras under MIT-licensen:

https://opensource.org/licenses/MIT

Se även

babeltrace2-intro(7), babeltrace2(1), babeltrace2-run(1).

Källinformation

Denna sida är en del av projektet babeltrace (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

den 2026-01-16. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 2025-12-04.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar till informationen i denna källinformation (som inte är en del av den ursprungliga manualsidan), skicka e-post till:

man-pages@man7.org

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/babeltrace2-convert.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.