iowatcher(1)

NAMN

iowatcher – skapa visualiseringar från blktrace-resultat

SYNOPSIS

iowatcher [optioner] [--] [programargument ...]

BESKRIVNING

iowatcher ritar grafer över resultat från en körning av blktrace(8).

Programmet kan:

• rita grafer från en befintlig blktrace-körning
• starta en ny blktrace-körning
• starta en ny blktrace-körning och samtidigt köra ett benchmarkprogram

Därefter kan iowatcher skapa en bild eller film som visar I/O från den angivna spårningen.

iowatcher kan skapa:

• SVG-filer
• MP4-filmer, med hjälp av ffmpeg
• Ogg-filmer, med hjälp av png2theora

OPTIONER

--help

Visa en kort sammanfattning av användningen.

-d, --device enhet

Styr vilken enhet som ska spåras.

För närvarande kan endast en enhet spåras åt gången.

Värdet skickas direkt till blktrace(8) och behövs endast när en ny spårning skapas.

-D, --blktrace-destination mål

Målplats för blktrace-data.

-p, --prog

Kör ett program medan blktrace(8) körs.

Programmet och dess argument måste anges efter alla andra optioner.

Tidigare krävde denna option att programmet gavs som ett enda argument, men nu anger den att iowatcher ska förvänta sig extra argument som ska köras under spårningen.

--

Avsluta tolkningen av optioner.

Om --prog anges betraktas allt efter -- som programmet som ska köras.

Detta kan vara användbart om programnamnet annars skulle kunna tolkas som en option.

-K, --keep-movie-svgs

Behåll SVG-filerna som skapas för filmläge.

-t, --trace sökväg

Ange namnet på filen eller katalogen där blktrace-utmatningen finns.

iowatcher använder en dump från blkparse(1). Därför försöker denna option gissa namnet på motsvarande per-CPU-blktrace-datafiler om dumpfilen inte redan finns.

För att lägga till flera spårningar i en och samma graf kan --trace anges mer än en gång.

Om sökväg är en katalog använder iowatcher katalogens namn som basnamn för dumpfilen, och alla spårningsfiler som hittas i katalogen behandlas.

-l, --label etikett

Sätter en etikett i grafen för en spårningsfil.

Etiketterna läggs till i samma ordning som spårningsfilerna.

-m, --movie [stil]

Skapa en film.

Filformatet beror på filändelsen som används med optionen -o.

Om filändelsen .ogv eller .ogg anges blir resultatet Ogg Theora-video, om png2theora finns tillgängligt.

Om filändelsen .mp4 anges blir resultatet MP4-video, om ffmpeg finns tillgängligt.

Andra filändelser kan användas, men slutresultatet blir då MP4.

Godkända värden för stil:

spindle

Cirkulär diskliknande effekt. Detta är standard.

rect

Rektangulär grafstil.

-T, --title titel

Ange en titel som placeras högst upp i grafen.

-o, --output fil

Filnamn för SVG-bilden eller videon.

Videoformatet beror på filnamnets ändelse. Se --movie.

-r, --rolling sekunder

Styr varaktigheten för rullande medelvärde.

iowatcher försöker jämna ut ojämna grafer genom att medelvärdesberäkna aktuell sekund tillsammans med tidigare sekunder.

Större värden ger jämnare och plattare grafer.

-h, --height höjd

Ange höjden för varje graf.

-w, --width bredd

Ange bredden för varje graf.

-c, --columns kolumner

Ange antal kolumner i grafutmatningen.

-x, --xzoom min:max

Begränsa behandlat tidsintervall till min:max.

-y, --yzoom min:max

Begränsa behandlade sektorer till min:max.

-a, --io-plot-action åtgärd

Rita åtgärd i I/O-grafen.

Godkända värden är:

• Q
• D
• C

-P, --per-process-io

Skilj mellan processer i I/O-grafen.

-O, --only-graph graf

Lägg till en enda graf i utmatningen.

Se avsnittet GRAFER för tillåtna värden.

Som standard ingår alla grafer. Använd -O för att bara skapa de grafer som behövs.

Optionen -O kan användas mer än en gång.

-N, --no-graph typ

Ta bort en enskild graf från utmatningen.

Se avsnittet GRAFER för tillåtna värden.

Optionen kan användas mer än en gång.

GRAFER

Värden som accepteras av optionerna -O och -N är:

io
tput
latency
queue_depth
iops
cpu-sys
cpu-io
cpu-irq
cpu-user
cpu-soft

EXEMPEL

Skapa graf från befintlig trace.dump:

iowatcher -t trace

Hoppa över I/O-grafen:

iowatcher -t trace.dump -o trace.svg -N io

Skapa endast grafer för genomströmning och latens:

iowatcher -t trace.dump -o trace.svg -O tput -O latency

Skapa en graf från två körningar och sätt etiketter på dem:

iowatcher -t ext4.dump -t xfs.dump -l Ext4 -l XFS -o trace.svg

Kör ett fio-benchmark, lagra spårningen i trace.dump, lägg till en titel högst upp och använd /dev/sda för blktrace:

iowatcher -d /dev/sda -t trace.dump -T 'Fio Benchmark' -p fio some_job_file

Skapa en film från en befintlig spårning:

iowatcher -t trace --movie -o trace.mp4

FÖRFATTARE

iowatcher skapades och underhålls av Chris Mason.

Denna manualsida skrevs till stor del av Andrew Price, baserat på Chris ursprungliga README.

COPYRIGHT

Detta program är fri programvara. Du kan distribuera det vidare och/eller ändra det enligt villkoren i GNU General Public License version 2, publicerad av Free Software Foundation.

Programmet distribueras i hopp om att det ska vara användbart, men utan någon garanti, inte ens underförstådd garanti om säljbarhet eller lämplighet för ett visst ändamål.

Se GNU General Public License för mer information.

Du bör ha fått en kopia av GNU General Public License tillsammans med programmet. Om inte, skriv till:

Free Software Foundation, Inc.
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301
USA

SE ÄVEN

• blktrace(8)
• blkparse(1)
• fio(1)
• mpstat(1)

KOLOFON

Denna sida är en del av projektet blktrace, Linux block layer I/O tracer.

Information om projektet är okänd i den ursprungliga kolofonen.

Felrapporter för denna manualsida har ingen känd särskild mottagare enligt originalet. Om du känner till vart sådana fel ska rapporteras kan du skicka information till:

man-pages@man7.org

Sidan hämtades från projektets uppströms Git-förråd:

https://git.kernel.org/pub/scm/linux/kernel/git/axboe/blktrace.git

Den hämtades den 24 maj 2026. Vid den tidpunkten var datumet för den senaste hittade commiten i förrådet den 10 december 2025.

Om du upptäcker renderingsproblem i HTML-versionen av sidan, eller anser att det finns en bättre eller mer uppdaterad källa för sidan, eller har rättelser eller förbättringar av informationen i kolofonen, kan du skicka e-post till:

man-pages@man7.org

KORT SAMMANFATTNING

iowatcher används för att skapa grafer och filmer från blktrace(8)-data.

Skapa SVG från en spårning:

iowatcher -t trace.dump -o trace.svg

Visa bara latens och genomströmning:

iowatcher -t trace.dump -O latency -O tput -o trace.svg

Skapa MP4-film:

iowatcher -t trace.dump --movie -o trace.mp4

Köra benchmark samtidigt som spårning görs:

iowatcher -d /dev/sda -t trace.dump -p fio some_job_file

Programmet är särskilt användbart när man vill förstå disk-I/O visuellt: latens, ködjup, IOPS, genomströmning och CPU-belastning.

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/iowatcher.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 Datorhjälp Stockholm som har sponsrat Linux.se med webbhotell.