pmdumptext(1)

pmdumptext(1) – Linux manualsida

NAMN

pmdumptext – dumpa prestandamätvärden till en ASCII-tabell

SYNOPSIS

pmdumptext [-CFGHilmMNoruVXz?] [-a archive] [-A align] [-c config]
           [-d delimiter] [-D debug] [-f format] [-h host]
           [-n pmnsfile] [-O offset] [-P precision] [-R lines]
           [-s sample] [-S starttime] [-t interval] [-T endtime]
           [-U string] [-w width] [-Z timezone] [metric ...]

BESKRIVNING

pmdumptext skriver ut värden för prestandamätvärden som samlats in live eller från en uppsättning Performance Co-Pilot-arkiv, PCP-arkiv. Som standard visas mätvärdena i tabbseparerade kolumner, föregångna av en tidsstämpel.

Om inte en annan värd anges med alternativet -h, eller en eller flera arkivuppsättningar anges med alternativet -a, eller ett uttryckligt prefix av typen host: eller archive/ anges i metric, kontaktar pmdumptext Performance Metrics Collector Daemon, PMCD, på den lokala värden för att hämta den begärda informationen.

pmdumptext kan köras i interaktivt läge med alternativet -i. Då visas värdena i kolumner med lika bredd. Utan detta alternativ görs inget försök att justera värdena, vilket gör utdata enklare att tolka för andra program.

Utdataformatet kan styras ytterligare genom att ändra värdenas precision med -P, kolumnbredden med -w och värdeformatet med alternativen -G och -F. Dessa används för kortaste formen av vetenskaplig eller fast notation respektive fastbreddsformat.

Som standard skalar pmdumptext mätvärden till kanoniska enheter: byte, sekunder och antal. Ett undantag är alternativet -r, där värdena inte skalas. Alternativet -u rapporterar enheterna för varje mätvärde.

De metrics som ska dumpas kan anges på kommandoraden, i en config-fil eller skickas till pmdumptext via stdin. Ett mätvärde består av en valfri källa, värd eller arkiv, mätvärdesnamnet och en valfri instanslista direkt efter namnet.

Ett kolon används för att skilja ett värdnamn från mätvärdet, och ett snedstreck, /, används för att skilja ett arkivnamn från mätvärdet. Instanser anges inom hakparenteser och separeras med kommatecken om fler än en anges.

Exempel på giltiga mätvärden:

kernel.all.cpu.idle
myhost:kernel.all.cpu.idle[cpu0,cpu3]
/path/to/myarchive/kernel.all.cpu.idle[cpu1]

När ett metric inte innehåller prefixet host: eller archive/, till exempel kernel.all.cpu.idle ovan, bestäms mätvärdets källa enligt följande regler:

1. PMCD på host från alternativet -h, om ett sådant finns.
2. Annars archive från det första -a-alternativet, om ett sådant finns.
3. Annars värden från det första tidigare metric med prefixet host:, om ett sådant finns.
4. Annars arkivet från det första tidigare metric med prefixet archive/, om ett sådant finns.
5. Annars PMCD på den lokala värden, vilket motsvarar local:: följt av mätvärdet.

Formatet för ett metric beskrivs ytterligare i PCPIntro(1) i avsnittet om specifikationer för prestandamätvärden.

Ett normaliseringsvärde kan valfritt följa efter ett mätvärdesnamn i en config-fil eller på stdin. Mätvärdet skalas då med detta värde. Om filsystemet /dev/root till exempel har en kapacitet på 1965437 byte kan procentandelen av filsystemet som används dumpas med denna konfiguration:

filesys.used[/dev/root] 19654.37

Ett normaliseringsvärde får inte användas med metrics som anges som kommandoradsargument.

Ett mätvärdesnamn behöver inte vara en lövnod i Performance Metrics Name Space, PMNS, utom när en eller flera instanser anges. För att till exempel dumpa alla filsystemmätvärden räcker det att ange filesys för att dumpa filesys.capacity, filesys.used, filesys.free och så vidare.

ALTERNATIV

Kommandoradsalternativen -A, eller --align, -O, eller --origin, -S, eller --start, och -T, eller --finish, styr justering, offset, starttid och sluttid vid visualisering av mätvärden från arkiv. Dessa alternativ är gemensamma för de flesta Performance Co-Pilot-verktyg och beskrivs fullständigt i PCPIntro(1).

Övriga tillgängliga alternativ är:

-a <archive> eller --archive=<archive>

Anger det historiska archive som mätvärden kan hämtas från för en viss värd. archive är den fullständiga sökvägen till en enskild arkivfil, namnet på en katalog som innehåller arkiv eller basnamnet för ett arkiv. Alla dessa arkiv har tidigare skapats av pmlogger(1).

Flera arkivuppsättningar, separerade med kommatecken eller angivna i olika -a-alternativ, från olika värdar kan anges, men endast en arkivuppsättning per värd är tillåten. Alla mätvärden som inte är kopplade till en specifik värd eller ett specifikt arkiv använder det första arkivet som källa.

-c <config> eller --config=<config>

Om inga metrics anges på kommandoraden kan en config-fil användas för att ange vilka mätvärden som ska dumpas. Till skillnad från kommandoradens metrics kan varje mätvärde följas av ett normaliseringsvärde. Tomma rader och rader som börjar med # ignoreras.

-C eller --check

Avsluta innan några värden dumpas, men efter att mätvärdena har tolkats. Mätvärden, instanser, normaliseringsvärden och enheter listas om -m, -l, -N och/eller -u anges.

-d <delimiter> eller --delimiter=<delimiter>

Ange den delimiter som skiljer varje utdatakolumn åt. delimiter får endast vara ett enda tecken.

-f <format> eller --time-format=<format>

Använd formatsträngen format för att formatera tidsstämpeln för varje uppsättning värden. Syntaxen är densamma som beskrivs i strftime(3). En tom formatsträng, till exempel ', tar bort tidsstämplarna från utdata.

-F eller --fixed

Skriv ut värdena i ett fastbreddsformat på 6 tecken. Positiva tal representeras som dd.ddu och negativa tal som [-]d.ddu. Suffixmultiplikatorn kan ha värdena K för 10^3, M för 10^6, G för 10^9 och T för 10^12. Exempelvis visas 4567 som 4.57K, även om mätvärdets enheter är byte.

-G eller --scientific

Skriv ut värdena med den kortaste formen av vetenskaplig notation eller decimalnotation.

-h <host> eller --host=<host>

Hämta prestandamätvärden från pmcd(1) på host i stället för från standardvärden localhost.

-H eller --headers

Visa alla rubriker innan några mätvärden dumpas. Detta motsvarar -lmNu.

-i eller --interactive

Skriv ut data i kolumner med fast bredd och med fastbreddsvärden, se -F, så att utdata blir läsbar för människor. Detta alternativ får inte användas tillsammans med -P, eftersom fastpunktsvärden inte har fast bredd.

Alternativet påverkar också utdata från alternativen -m och -u, eftersom mätvärdes-, instans- och enhetsnamn kan trunkeras.

-l eller --source

Visa mätvärdenas källa. I interaktivt läge visas mätvärdenas värd. I icke-interaktivt läge visar detta alternativ mätvärdenas källa tillsammans med mätvärdesnamnet, även om -m inte anges.

-m eller --metrics

Skriv ut mätvärdesnamnen före mätvärdena. Mätvärdenas källa och enheter kan också dumpas med alternativen -l respektive -u. I interaktivt läge kan mätvärdesnamnen trunkeras, och instansnamnen, där sådana är relevanta, trunkeras på följande rad.

-M

Skriv ut kolumnnummer och fullständiga mätvärdesnamn innan några värden dumpas. Om flaggan -l också anges visas även mätvärdenas källa.

-n <pmnsfile> eller --namespace=<pmnsfile>

Läs in en alternativ lokal PMNS från filen pmnsfile.

-o eller --offset

När en tidsstämpel rapporteras, det vill säga om inte en tom formatsträng anges med alternativet -f, föregås tidsstämpeln av offset i sekunder från början av arkivuppsättningen eller från början av körningen av pmdumptext.

-N

Skriv ut normaliseringsfaktorerna före mätvärdena.

-p <precision> eller --precision=<precision>

Sätt värdenas precision. Detta alternativ får inte användas med -F, eftersom precisionen där är konstant. Standardprecisionen är 3.

-r eller --raw

Skriv ut råa mätvärden. Konvertera inte räknare till hastigheter och skala inte värden till kanoniska enheter. Detta alternativ gör också att pmdumptext ignorerar normaliseringsvärdena för varje mätvärde.

-R <lines> eller --repeat=<lines>

Upprepa rubriken var lines rad i utdata. Detta är användbart i interaktivt läge när ett grafiskt fönster används, för att undvika att rubriken rullar utanför fönstrets buffert och för att justera rubriken igen om fönstret ändrar storlek.

-s <samples> eller --samples=<samples>

pmdumptext avslutas efter detta antal sampel.

-t <interval> eller --interval=<interval>

Alternativet interval följer syntaxen som beskrivs i PCPIntro(1). I sin enklaste form kan det vara ett osignerat heltal, där den underförstådda enheten är sekunder. Standardintervallet är 1 sekund.

-u eller --units

Skriv ut mätvärdenas enheter före de första värdena, men efter mätvärdesnamnen om -m också anges.

-U <string> eller --unavailable=<string>

Ändra utdata när värden saknas till string. Standardsträngen är ?.

-V eller --version

Visa versionsnummer och avsluta.

-w <width> eller --widthfR=<width>

Sätt kolumnbredden för utdata. Strängar trunkeras till denna bredd och kan få suffixet ... om width är större än 5.

-X eller --extended

Skriv ut kolumnnummer och fullständiga mätvärdesnamn, ett per rad, både innan den första uppsättningen värden dumpas och varje gång rubriken upprepas.

-z eller --hostzone

Använd den lokala tidszonen för den värd som är källa för prestandamätvärdena, enligt vad som identifieras av antingen -h eller det första -a-alternativet. Standardvärdet är att använda tidszonen på den lokala värden.

-Z <timezone> eller --timezone=<timezone>

Använd timezone för datum och tid. Timezone anges i samma format som miljövariabeln TZ, enligt beskrivningen i environ(7).

-? eller --help

Visa användningsmeddelande och avsluta.

FLERA KÄLLOR

pmdumptext stöder dumpning av mätvärden från flera värdar eller arkivuppsättningar. Mätvärdena som listas på kommandoraden eller i config-filen kan sakna specifik källa eller komma från olika källor.

Det finns dock begränsningar när arkiv anges på kommandoraden, med -a, och/eller i konfigurationsfilen.

För det första får det endast finnas en arkivuppsättning för varje värd.

För det andra måste värdarna för mätvärden med värdkällor motsvara värden för en arkivuppsättning, antingen på kommandoraden eller tidigare som källa för ett annat mätvärde.

Alternativen -a och -h får inte användas tillsammans.

ENHETSKONVERTERING

Alla mätvärden som har räknarsemantik konverteras automatiskt till hastigheter över sampelintervallet.

I interaktivt läge ändrar pmdumptext också enheterna för vissa mätvärden så att de blir lättare att förstå:

• Alla mätvärden med utrymmesenheter, från byte till terabyte, skalas till byte. Observera att 1024 byte visas som 1.02K, inte 1.00K.

• Mätvärden som är räknare med tidsenheter, från nanosekunder till timmar, representerar tidsanvändning över sampelintervallet. Enhetssträngarna för sådana mätvärden ändras till Time Utilization eller förkortas till util, och värdena normaliseras till intervallet noll till ett.

EXEMPEL

För att undersöka belastningen på två värdar, foo och bar, samtidigt:

$ pmdumptext -il 'foo:kernel.all.load[1]' 'bar:kernel.all.load[1]'
             Source        foo     bar
Wed Jul 30 11:37:53      0.309   0.409
Wed Jul 30 11:37:54      0.309   0.409
Wed Jul 30 11:37:55      0.309   0.409

För att skriva ut minnesanvändningen på en fjärrvärd som heter bong med en enklare tidsstämpel:

$ pmdumptext -imu -h bong -f '%H:%M:%S' mem.util
  Metric        kernel  fs_ctl  _dirty  _clean    free    user
   Units             b       b       b       b       b       b
09:32:28         8.98M   0.97M   0.00    3.90M   7.13M  46.13M
09:32:29         8.99M   0.98M   0.00    5.71M   5.39M  46.03M
09:32:30         8.99M   1.07M   0.00    5.81M   4.55M  46.69M
09:32:31         9.03M   1.16M   0.00    6.45M   3.48M  47.00M
09:32:32         9.09M   1.18M  20.48K   6.23M   3.29M  47.30M

För att dumpa alla mätvärden som samlats in i ett arkiv med 30 sekunders intervall till en fil för vidare bearbetning av ett annat verktyg:

$ pminfo -a archive | pmdumptext -t 30s -m -a archive > outfile

FILER

$PCP_VAR_DIR/pmns/*

Standardfiler för PMNS-specifikationer.

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att parameterisera fil- och katalognamn som används av PCP.

På varje installation innehåller filen /etc/pcp.conf de lokala värdena för dessa variabler.

Variabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil, enligt beskrivningen i pcp.conf(5).

För miljövariabler som påverkar PCP-verktyg, se pmGetOptions(3).

FELSÖKNINGSALTERNATIV

Alternativet -D eller --debug aktiverar utskrift av ytterligare diagnostik till stderr för att hjälpa till att analysera problem. Informationen är ibland kryptisk och främst avsedd att ge vägledning till utvecklare snarare än slutanvändare.

debug är en kommaseparerad lista med felsökningsalternativ. Använd pmdbg(1) med alternativet -l för att få en lista över tillgängliga felsökningsalternativ och deras betydelse.

Felsökningsalternativ som är specifika för pmdumptext är:

Alternativ   Beskrivning
appl0        detaljerad diagnostik för mätvärden, deras källa och
             tidszon, metadata, enhetsnormalisering, utdataformat
             med mera

SE ÄVEN

• PCPIntro(1)
• pmcd(1)
• pmchart(1)
• pmlogger(1)
• pmrep(1)
• PMAPI(3)
• strftime(3)
• environ(7)

KOLOFON

Den här sidan är en del av projektet PCP – Performance Co-Pilot.

Information om projektet finns på:

• http://www.pcp.io/

Om du har en felrapport för denna manualsida, skicka den till:

• pcp@groups.io

Denna sida hämtades från projektets uppströms Git-arkiv:

• https://github.com/performancecopilot/pcp.git

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet den 16 januari 2026.

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

• man-pages@man7.org

Sidor som hänvisar till denna sida

• pcpintro(1)
• pmchart(1)
• pmclient(1)
• pmlogsummary(1)
• pmrep(1)
• pmval(1)
• pmview(1)

Sidinformation

HTML-renderingen skapades den 16 januari 2026 av Michael Kerrisk, författare till The Linux Programming Interface.

Mer information om Linux- och UNIX-systemprogrammeringskurser finns på:

• https://man7.org/training/

Hosting tillhandahålls av jambit GmbH.

Sidslut

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