sadf(1)
NAMN
sadf – visa data insamlade av sar i flera format
SYNOPSIS
sadf [ -C ] [ -c | -d | -g | -j | -l | -p | -r | -x ]
[ -H ] [ -h ] [ -T | -t | -U ] [ -V ]
[ -O opts[,...] ] [ -P { cpu_list | ALL } ]
[ -s [ start_time ] ] [ -e [ end_time ] ]
[ --dev=dev_list ] [ --fs=fs_list ]
[ --iface=iface_list ] [ --int=int_list ]
[ -- sar_options ]
[ interval [ count ] ]
[ datafile | -[0-9]+ ]
BESKRIVNING
Kommandot sadf används för att visa innehållet i datafiler som skapats av sar(1).
Till skillnad från sar kan sadf skriva data i flera olika format, till exempel:
- CSV-liknande databasformat
- XML
- JSON
- råformat
- SVG-grafer
- PCP-arkiv
Standardformatet är ett format som enkelt kan hanteras av mönsterbearbetande kommandon som awk(1). Se optionen -p.
sadf kan också användas för att rita grafer över olika aktiviteter som samlats in av sar och visa dem som SVG-grafik, Scalable Vector Graphics, i en webbläsare. Se optionen -g.
sadf hämtar poster ur filen datafile och skriver dem till standardutmatningen. Filen måste ha skapats av en version av sar som är kompatibel med versionen av sadf.
Om datafile utelämnas använder sadf standardfilen för daglig systemaktivitet.
Det går också att ange:
-1 -2
och liknande som argument till sadf för att visa data från tidigare dagar. Exempelvis pekar -1 på gårdagens standardfil för systemaktivitet.
Standardfilen för daglig systemaktivitet heter:
saDD
eller:
saYYYYMMDD
Där:
- YYYY är aktuellt år
- MM är aktuell månad
- DD är aktuell dag
sadf letar efter den senaste av dessa två filer och använder den.
Som standard finns filerna i katalogen:
/var/log/sa
En annan plats kan anges. Om datafile är en katalog i stället för en vanlig fil betraktas den som katalogen där standardfilen för daglig systemaktivitet finns.
Parametrarna interval och count används för att låta sadf välja count poster med interval sekunder mellan posterna.
Om count inte anges visas alla poster som sparats i datafilen.
Alla aktivitetsflaggor från sar kan anges på kommandoraden för att bestämma vilka aktiviteter som ska rapporteras. Innan sådana flaggor anges ska ett dubbelt bindestreck anges:
--
Detta görs för att inte blanda ihop sar-flaggorna med sadf-flaggorna.
Om inga aktivitetsflaggor anges väljs endast CPU-aktivitet.
OPTIONER
-C
- Visa kommentarer som finns i filen.
-c
- Konvertera en äldre binär systemaktivitetsfil, version 9.1.6 eller senare, till aktuellt format.
Syntax:
sadf -c old_datafile > new_datafile
Konverteringen kan styras med optionen -O.
-d
- Skriv innehållet i datafilen i ett format som enkelt kan läsas in av ett relationsdatabassystem.
- Utmatningen består av fält separerade med semikolon.
Varje post innehåller:
- värdnamnet för den värd där filen skapades
- intervallvärdet, eller -1 om det inte är tillämpligt
- tidsstämpel i ett format som de flesta databaser enkelt accepterar
- ytterligare semikolonseparerade datafält enligt angivna sar-optioner
Tidsstämpelns format kan styras med optionerna:
-T -t -U
--dev= dev_list
- Ange vilka blockenheter som statistik ska visas för.
- dev_list är en kommaseparerad lista över enhetsnamn.
- Detta är användbart tillsammans med optionen -d från sar(1).
-e [ hh:mm[:ss] ]
-e [ seconds_since_the_epoch ]
- Ange rapportens sluttid.
- Standardvärdet är:
18:00:00
- Tider måste anges i 24-timmarsformat eller som sekunder sedan epoken, med ett tiosiffrigt tal.
--fs= fs_list
- Ange vilka filsystem som statistik ska visas för.
- fs_list är en kommaseparerad lista över filsystemnamn eller monteringspunkter.
- Detta är användbart tillsammans med optionen -F från sar(1).
-g
- Skriv innehållet i datafilen i SVG-format, alltså Scalable Vector Graphics.
- Detta gör det möjligt att visa grafer i en webbläsare.
Syntax:
sadf -g your_datafile [ -- sar_options ] > output.svg
Öppna därefter SVG-filen i valfri webbläsare.
Utmatningen kan styras med optionen -O.
-H
- Visa endast rapportens huvud, när detta är tillämpligt.
- Om inget format har angetts visas datafilens huvuddata, alltså metadata.
-h
- När optionen används tillsammans med -d visas alla aktiviteter horisontellt på en enda rad.
--iface= iface_list
- Ange vilka nätverksgränssnitt som statistik ska visas för.
- iface_list är en kommaseparerad lista över gränssnittsnamn.
- Detta är användbart tillsammans med optionerna:
-n DEV -n EDEV
från sar(1).
--int= int_list
- Ange vilka avbrottsnamn eller avbrottsnummer som statistik ska visas för.
- int_list är en kommaseparerad lista över värden eller intervall.
Exempel:
0-16,35,40-
- Detta är användbart tillsammans med optionen -I från sar(1).
-j
- Skriv innehållet i datafilen i JSON-format, alltså JavaScript Object Notation.
- Tidsstämplar kan styras med optionerna -T och -t.
-l
- Exportera innehållet i datafilen till ett PCP-arkiv, alltså Performance Co-Pilot.
- Arkivets namn kan anges med nyckelordet pcparchive= tillsammans med optionen -O.
OPTIONEN -O
-O opts[,...]
- Använd angivna optioner för att styra utmatningen från sadf.
Flera optioner kan anges som en kommaseparerad lista.
SVG-optioner för sadf -g
Följande optioner används för att styra SVG-utmatning från:
sadf -g
autoscale
- Rita alla grafer i en viss vy så stora som möjligt utifrån den aktuella vyns skala.
- Detta görs genom att en faktor, till exempel 10, 100 eller 1000, används för att förstora grafritningen.
- Optionen kan vara användbar när flera grafer ritas i samma vy och vissa har mycket små värden medan andra har höga värden som annars gör de små nästan osynliga.
bwcol
- Använd en svartvit palett för att rita graferna.
customcol
- Använd en anpassningsbar färgpalett i stället för standardpaletten.
- Se miljövariabeln S_COLORS_PALETTE för hur paletten anpassas.
debug
- Lägg till hjälpsamma kommentarer i SVG-filen.
height= value
- Sätt SVG-dukens höjd till value.
oneday
- Visa grafdata över en period på 24 timmar.
- Observera att timmar fortfarande skrivs i UTC som standard. Använd -T för att skriva dem i lokal tid och få ett tidsfönster som börjar vid midnatt.
packed
- Gruppera alla vyer från samma aktivitet och samma enhet på samma rad.
showidle
- Visa även tillståndet %idle i grafer för CPU-statistik.
showinfo
- Visa ytterligare information, till exempel datum och värdnamn, på varje vy.
showtoc
- Lägg till en innehållsförteckning i början av SVG-utmatningen. Den består av länkar till den första grafen för varje aktivitet.
skipempty
- Visa inte vyer där alla grafer endast har nollvärden.
Optioner vid konvertering av äldre datafiler
hz= value
- Ange antal tick per sekund för den maskin där den äldre datafilen skapades.
Optioner vid export till PCP-arkiv
pcparchive= name
- Ange namnet på PCP-arkivet som ska skapas.
Optioner för råutmatning
debug
- Visa ytterligare information i råutmatningen från sadf -r. Detta är främst användbart vid felsökning.
PROCESSORURVAL
-P { cpu_list | ALL }
- Ange att processorberoende statistik endast ska rapporteras för angiven processor eller angivna processorer.
- cpu_list är en kommaseparerad lista över värden eller intervall.
Exempel:
0,2,4-7,12-
Processor 0 är den första processorn. Processorn all är det globala genomsnittet över alla processorer.
Nyckelordet ALL rapporterar statistik för varje enskild processor och globalt för alla processorer.
UTMATNINGSFORMAT
-p
- Skriv innehållet i datafilen i ett format som enkelt kan hanteras av mönsterbearbetande kommandon som awk(1).
- Utmatningen består av fält separerade med tabulator.
Varje post innehåller:
- värdnamnet för värden där filen skapades
- intervallvärdet, eller -1 om det inte är tillämpligt
- tidsstämpeln
- enhetsnamnet, eller - om det inte är tillämpligt
- fältnamnet
- fältets värde
Tidsstämplar kan styras med:
-T -t -U
-r
- Skriv datafilens råa innehåll.
- I detta format visas räknarvärdena som de lästes från kärnan. Det betyder till exempel att inga genomsnittsvärden beräknas över förflutet tidsintervall.
- Utmatningen kan styras med optionen -O.
-x
- Skriv innehållet i datafilen i XML-format.
- Tidsstämplar kan styras med optionerna -T och -t.
- Tillhörande DTD, Document Type Definition, och XML-schema ingår i sysstat-källpaketet. De finns också på sysstat-webbplatsen.
-d
- Skriv databasvänligt semikolonseparerat format.
-j
- Skriv JSON-format.
-g
- Skriv SVG-grafer.
-l
- Exportera till PCP-arkiv.
TIDSURVAL OCH TIDSSTÄMPLAR
-s [ hh:mm[:ss] ]
-s [ seconds_since_the_epoch ]
- Ange rapportens starttid.
- Standardvärdet är:
08:00:00
- Tider måste anges i 24-timmarsformat eller som sekunder sedan epoken, med ett tiosiffrigt tal.
-e [ hh:mm[:ss] ]
-e [ seconds_since_the_epoch ]
- Ange rapportens sluttid.
- Standardvärdet är:
18:00:00
-T
- Visa tidsstämpel i lokal tid i stället för UTC, Coordinated Universal Time.
-t
- Visa tidsstämpel i den ursprungliga lokala tiden för den som skapade datafilen, i stället för UTC.
-U
- Visa tidsstämpel i UTC som sekunder sedan epoken.
ÖVRIGA OPTIONER
-V
- Skriv versionsnummer och avsluta.
-- sar_options
- Skiljer sadf-optioner från optioner som ska skickas vidare till sar(1).
Exempel:
sadf -d datafil -- -r -n DEV
Här är -d en sadf-option, medan -r -n DEV är sar-optioner.
interval count
- Välj poster med angivet intervall och antal.
datafile
- Ange vilken aktivitetsdatafil som ska läsas.
-[0-9]+
- Visa data från ett antal dagar tillbaka.
Exempel:
sadf -1
visar data från gårdagens standardfil.
MILJÖ
Kommandot sadf tar hänsyn till följande miljövariabler.
S_COLORS_PALETTE
- Anger färgerna som sadf -g använder när SVG-utmatning skapas.
- Variabeln används endast när den anpassade färgpaletten har valts med optionen customcol till -O.
Värdet är en kolonseparerad lista över egenskaper kopplade till sexsiffriga hexadecimala färgvärden.
Standardvärdet är:
0=000000:1=1a1aff:2=1affb2:3=b21aff: 4=1ab2ff:5=ff1a1a:6=ffb31a:7=b2ff1a: 8=efefef:9=000000:A=1a1aff:B=1affb2: C=b21aff:D=1ab2ff:E=ff1a1a:F=ffb31a: G=bebebe:H=000000:I=000000:K=ffffff: L=000000:T=000000:W=000000:X=000000
Egenskaper som består av en hexadecimal siffra, 0 till F, används för de första sexton färgerna i paletten. Dessa färger används för att rita graferna.
Exempel:
3=ffffff
anger att den tredje färgen i paletten är vit.
Övriga egenskaper:
G=
- Färg för rutnätslinjer.
H=
- Färg för rapporthuvudet.
I=
- Färg för ytterligare information, till exempel datum och värdnamn.
K=
- Färg för grafernas bakgrund.
L=
- Standardfärg, bland annat använd för innehållsförteckningen.
T=
- Färg för graftitlar.
W=
- Färg för varnings- och felmeddelanden.
X=
- Färg för axlar och gradering.
S_TIME_DEF_TIME
- Om denna variabel finns och har värdet UTC använder sadf UTC i stället för lokal tid för att bestämma aktuell daglig datafil i katalogen:
/var/log/sa
EXEMPEL
Läs minnes- och nätverksstatistik från systemaktivitetsfilen sa21 och visa den i ett format som kan läsas in i en databas:
sadf -d /var/log/sa/sa21 -- -r -n DEV
Hämta CPU-statistik för processor 1, alltså den andra processorn, från aktuell daglig datafil och visa den i ett format som enkelt kan hanteras av mönsterbearbetande kommandon:
sadf -p -P 1
Skapa JSON-utmatning från aktuell daglig datafil:
sadf -j
Skapa XML-utmatning:
sadf -x
Skapa SVG-grafer från en datafil:
sadf -g /var/log/sa/sa21 -- -r -n DEV > output.svg
Skapa SVG-grafer med lokal tid och innehållsförteckning:
sadf -g -T -O showtoc,showinfo /var/log/sa/sa21 -- -A > output.svg
Konvertera en äldre datafil till aktuellt format:
sadf -c old_datafile > new_datafile
Visa gårdagens data:
sadf -1
FEL
SVG-utmatning som skapas med optionen -g följer SVG 1.1-standarden.
Grafer har visats korrekt i flera webbläsare, bland annat Firefox, Chrome och Opera.
SVG-rendering är däremot trasig i Microsoft-webbläsare enligt originalmanualen, testat med Internet Explorer 11 och Edge 13.1. Därför bör dessa inte användas för SVG-utmatningen.
FILER
/var/log/sa/saDD
/var/log/sa/saYYYYMMDD
- Standardfiler för daglig systemaktivitet och deras standardplats.
- YYYY står för aktuellt år, MM för aktuell månad och DD för aktuell dag.
FÖRFATTARE
Sebastien Godard
sysstat <at> orange.fr
SE ÄVEN
Projektets webbplatser:
https://github.com/sysstat/sysstat https://sysstat.github.io/
KOLOFON
Denna sida är en del av projektet sysstat, alltså verktyg för prestandaövervakning.
Information om projektet finns på:
http://sebastien.godard.pagesperso-orange.fr/
Felrapporter för denna manualsida skickas till:
sysstat-AT-orange.fr
Sidan hämtades från projektets uppströms Git-förråd:
https://github.com/sysstat/sysstat.git
Den hämtades den 24 maj 2026. Vid den tidpunkten var datumet för den senaste hittade commiten i förrådet den 17 maj 2026.
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
HÄNVISAD FRÅN
KORT SAMMANFATTNING
sadf används för att läsa datafiler som skapats av sar(1) och skriva ut dem i andra format.
Vanliga format:
sadf -p tabulatorseparerat format för awk sadf -d semikolonseparerat databasformat sadf -j JSON sadf -x XML sadf -g SVG-grafer sadf -r rådata sadf -l PCP-arkiv
Exempel:
sadf -d /var/log/sa/sa21 -- -r -n DEV sadf -j -- -A sadf -g /var/log/sa/sa21 -- -A > output.svg sadf -p -P 1 sadf -1
Det viktiga att komma ihåg är att sadf-optionerna anges före --, medan de aktivitetsflaggor som hör till sar(1) anges efter --.