sadf(1)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök


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

Sidslut

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

Hämtad från "https://wiki.linux.se/index.php?title=sadf(1)&oldid=9731"