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