pmlogdump(1)
NAMN
pmlogdump, pmdumplog — dumpa interna detaljer från ett arkiv med prestandamätvärden
SYNOPSIS
pmlogdump [-adehIilLmMrstxzV?] [-D debug] [-n pmnsfil]
[-S starttid] [-T sluttid] [-Z tidszon] arkiv
[mätvärdesnamn ...]
pmlogdump [-v fil]
BESKRIVNING
pmlogdump dumpar diverse kontroll-, metadata-, index- och tillståndsinformation från filerna i ett Performance Co-Pilot-arkiv, PCP. Arkivet har basnamnet arkiv och måste tidigare ha skapats med pmlogger(1). Alternativt kan arkiv vara namnet på en katalog som innehåller en uppsättning PCP-arkiv som kan öppnas med pmNewContext(3).
Historiskt var pmlogdump känt som pmdumplog, men det senare namnet är inte konsekvent med övriga PCP-kommandon som arbetar med PCP-arkiv. Därför föredras namnet pmlogdump. Namnet pmdumplog finns dock kvar för bakåtkompatibilitet.
Normalt arbetar pmlogdump mot det distribuerade Performance Metrics Name Space, PMNS. Om flaggan -n anges läses i stället ett alternativt lokalt PMNS in från filen pmnsfil.
Om några argument av typen mätvärdesnamn anges begränsas rapporten till information som är relevant för de namngivna prestandamätvärdena. Om mätvärdesnamn är en icke-lövnod i namnrymden, se PMNS(5), kommer pmlogdump rekursivt att gå ned genom arkivets namnrymd och rapportera alla lövnoder.
Kommandoradsflaggorna styr vilken specifik information som rapporteras.
FLAGGOR
Tillgängliga kommandoradsflaggor är:
-a, --all
Rapportera nästan allt, det vill säga flaggorna -d, -i, -L, -m, -s och -t. Valfri hjälptext med -h och etikettmetadata-strängar med -e rapporteras inte som standard.
-d, --descs
Visa metadata och beskrivningar för de prestandamätvärden som förekommer minst en gång i arkivet. Se pmLookupDesc(3) för mer information om metadata som beskriver mätvärden.
Mätvärden rapporteras i stigande ordning efter Performance Metric Identifier, PMID.
-e, --labelsets
Visa etikettmetadata om sådana finns i arkivet. Se pmLookupLabels(3) för mer information om den etikettmetadatahierarki som är kopplad till mätvärden.
-h, --helptext
Visa hjälptext för mätvärden och instansdomäner om sådan finns i arkivet. Se pmLookupText(3) för mer information om hjälptext kopplad till mätvärden.
-i, --insts
Visa instansdomänerna och eventuella variationer i deras instansmedlemmar under arkivets varaktighet. Se pmGetInDom(3) för mer information om instansdomäner.
Instansdomäner rapporteras i stigande ordning efter Instance Domain Identifier och därefter i stigande tidsordning för varje uppsättning observerade instansmedlemmar inom en instansdomän.
-I, --on-disk-insts
Visa instansdomänerna som de lagras på disk. Dessa kan använda ett annat format och en annan kodning än den som syns ovanför Performance Metrics Programming Interface, PMAPI, när pmGetInDom(3) och relaterade rutiner används.
Formatet på disk är endast av intresse vid undersökning av PCP-arkivens interna struktur.
-l, --label
Dumpa arkivets etikett. Detta visar arkivformatets version, tid och datum för arkivets start och aktuella slut, samt den värd från vilken prestandamätvärdena samlades in.
-L
Som -l, men lite mer utförlig.
-m, --metrics
Skriv ut värdena för prestandamätvärdena från arkivet. Detta är standardvisningsflaggan.
Mätvärden utan instansdomän rapporteras som:
[tidsstämpel] mätvärdes-id (mätvärdesnamn): värde1 värde2
Mätvärden med instansdomän rapporteras som:
[tidsstämpel] mätvärdes-id (mätvärdesnamn):
inst [internt-id eller "externt-id"] värde1 värde2
tidsstämpel rapporteras endast för det första mätvärdet i en grupp av mätvärden som delar samma tidsstämpel.
-M, --markrecs
Om inget mätvärdesnamn anges rapporteras -poster när de hittas i arkiv. Om argument av typen mätvärdesnamn anges rapporteras -poster inte som standard.
Flaggan -M tvingar -poster att rapporteras även när argument av typen mätvärdesnamn anges.
-poster infogas i ett PCP-arkiv av pmlogger(1), pmlogextract(1) och liknande verktyg för att ange ett tidsmässigt avbrott i tidsserien av mätvärden.
-n pmnsfil, --namespace= pmnsfil
Läs in ett alternativt Performance Metrics Name Space, PMNS(5), från filen pmnsfil.
-r, --reverse
Bearbeta arkivet i omvänd ordning, från de senaste registrerade mätvärdena till de äldsta.
-s, --sizes
Rapportera storleken i byte för varje fysisk post i arkivet.
-S starttid, --start= starttid
När flaggan -m används begränsas rapporten till de poster som loggats vid eller efter starttid. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för starttid.
-t
Dumpa det tidsmässiga index som används för att ge snabbare åtkomst till stora arkivfiler.
Indexets integritet kontrolleras också. Om indexet visar sig vara skadat kan filen *.index döpas om eller tas bort, och arkivet kommer fortfarande att vara åtkomligt. Hämtningar kan dock ta längre tid utan indexet.
Observera att ett skadat tidsindex vanligtvis är ett tecken på ett djupare problem som kan påverka alla filer i ett PCP-arkiv.
-T sluttid, --finish= sluttid
När flaggan -m används begränsas rapporten till de poster som loggats före eller vid sluttid. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för sluttid.
-v fil
Utförligt läge. Dumpa posterna från en fysisk arkivfil i hexadecimalt format.
I detta fall är fil namnet på en enskild fil, vanligen ett basnamn, sådant som annars skulle ha angetts som kommandoradsargumentet arkiv, sammanfogat med en punkt och följt av något av:
meta index en siffra
meta avser metadata, index avser det tidsmässiga indexet och en siffra avser en av volymerna med mätvärden.
Användning av -v utesluter användning av alla andra flaggor och argument.
-V, --version
Visa versionsnummer och avsluta.
-x
Utökat format för tidsstämpelrapportering som inkluderar veckodag, dag i månaden, månad och år, utöver standardformatet med timmar, minuter och sekunder.
Detta är användbart för arkiv som sträcker sig över flera dagar.
En andra -x-flagga rapporterar även tidsstämpeln som en förskjutning från arkivets start, i sekunder. Detta är användbart tillsammans med felsökningsdiagnostik från arkivhanteringsrutinerna i libpcp.
En tredje -x-flagga rapporterar även tidsstämpeln i Epoch-format, det vill säga sekunder sedan 1970-01-01 00:00:00 UTC.
-z, --hostzone
Ändra tidszonen till den lokala tidszonen på den värd som är källan till prestandamätvärdena, enligt etikettposten i arkivet.
-Z tidszon, --timezone= tidszon
Som standard rapporterar pmlogdump tiden enligt den lokala tidszonen på systemet där pmlogdump körs.
Flaggan -Z ändrar tidszonen till tidszon, i samma format som miljövariabeln TZ, se environ(7).
-?, --help
Visa användningsmeddelande och avsluta.
FILER
$PCP_LOG_DIR/pmlogger/<värdnamn>
Standardkatalog för PCP-arkiv som innehåller prestandamätvärden insamlade från värden värdnamn.
PCP-MILJÖ
Miljövariabler med prefixet PCP_ används för att parametrera 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).
FELSÖKNINGSFLAGGOR
Flaggan -D eller --debug aktiverar ytterligare diagnostik på stderr för att hjälpa till att analysera problem. Informationen kan dock ibland vara kryptisk och är främst avsedd att ge vägledning för utvecklare snarare än slutanvändare.
debug är en kommaseparerad lista med felsökningsflaggor. Använd pmdbg(1) med flaggan -l för att få en lista över tillgängliga felsökningsflaggor och deras betydelse.
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pmlogdump.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 Datorservice som har sponsrat Linux.se med webbhotell.
SE ÄVEN
PCPIntro(1), pmlogcheck(1), pmlogextract(1), pmlogger(1), pmlogger_check(1), pmlogger_daily(1), pmloglabel(1), PMAPI(3), pmGetInDom(3), pmLookupDesc(3), pmNewContext(3), pcp.conf(5), pcp.env(5) och PMNS(5).
COLOPHON
Denna sida är en del av projektet PCP — Performance Co-Pilot.
Information om projektet finns på:
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
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, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar av informationen i detta COLOPHON-avsnitt, som inte är en del av den ursprungliga manualsidan, skicka e-post till:
man-pages@man7.org
Performance Co-Pilot PCP PMLOGDUMP(1)