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å:

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

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)