pmlogcheck(1)

NAMN

pmlogcheck — kontrollerar ogiltiga data i ett PCP-arkiv

SYNOPSIS

pmlogcheck [-flmRrvwz?] [-D debug] [-n pmnsfil] [-S start] [-T slut] [-Z tidszon] arkiv ...

BESKRIVNING

pmlogcheck skriver ut information om typen av ogiltiga data som upptäcks i filer som ingår i PCP-arkiv. I vissa begränsade fall erbjuder programmet också en funktion för ”reparation”.

Varje arkiv har basnamnet arkiv och måste tidigare ha skapats med pmlogger(1). Alternativt kan arkiv vara namnet på en fysisk fil som utgör en del av ett PCP-arkiv.

När flera arkiv-argument anges kontrolleras alla motsvarande PCP-arkiv. Om arkiv-argumenten däremot är filnamn kontrolleras varje tillhörande PCP-arkiv högst en gång.

FLAGGOR

Följande kommandoradsflaggor finns:

-f, --full

Vid normal körning är de flesta fel i Pass 0 så allvarliga att pmlogcheck avslutas när detta inträffar. Flaggan -f tvingar pmlogcheck att fortsätta, även om allvarliga fel hittas.

-l, --label

Skriv ut arkivets etikett. Den 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.

-m, --metadataonly

Hoppa över Pass 3 och kontrollera endast arkivets metadata. Se avsnittet DRIFT nedan.

Detta kan gå betydligt snabbare i fall där volymdata inte behöver kontrolleras, särskilt för arkiv med komprimerade datavolymer.

-n pmnsfil, --namespace=pmnsfil

Läs in ett alternativt Performance Metrics Name Space, PMNS, från filen pmnsfil. Se PMNS(5).

-R, --auto-repair

Försök reparera strukturella skador, särskilt när filer är ofullständiga. Detta händer vanligen efter systemkrasch eller när filsystemet har blivit fullt. Programmet trunkerar då filerna för att bevara så mycket komplett information som möjligt.

Trunkering fungerar endast för okomprimerade filer. Därför måste arkiv med komprimerade filkomponenter först packas upp med pmlogdecompress(1).

Alla reparationsflaggor implicerar -f.

Vissa problem som upptäcks av pmlogcheck löses inte bäst genom filtrunkering. I vissa fall kan pmlogrewrite(1) vara ett bättre alternativ. Därför rekommenderas att pmlogcheck först körs utan -R för att avgöra problemens omfattning, eller att reparation görs interaktivt med -r.

-r, --repair

Samma reparationsfunktioner som -R, men flaggan -r kräver att pmlogcheck körs interaktivt. Programmet frågar användaren och kräver ett positivt svar innan någon fil trunkeras.

-S starttid, --start=starttid

Ange starttid för det tidsfönster där mätvärden ska kontrolleras i Pass 3. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för starttid.

-T sluttid, --finish=sluttid

Ange sluttid för det tidsfönster där mätvärden ska kontrolleras i Pass 3. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för sluttid.

-v, --verbose

Aktivera utförligt läge.

-w, --nowrap

Undertryck rapportering av räknaromslag.

-z, --hostzone

Använd den lokala tidszonen för den värd som är källan till prestandamätvärdesarkivet. Standard är att använda den lokala värdens tidszon.

-Z tidszon, --timezone=tidszon

Använd tidszon för datum och tid. Tidszon anges i samma format som miljövariabeln TZ, enligt beskrivningen i environ(7). Standard är att använda den lokala värdens tidszon.

-?, --help

Visa användningsmeddelande och avsluta.

DRIFT

Kontrollen sker i ett antal pass. Varje pass är utformat för att validera successivt mer komplexa semantiska relationer mellan informationen i ett PCP-arkiv.

Pass 0

Varje fysisk fil i PCP-arkivet bearbetas för att säkerställa att etikettposterna är giltiga och konsekventa, samt att varje fil innehåller ett helt antal fysiska poster med korrekta huvud- och slutfält.

Fel i detta steg är vanligtvis fatala. PCP-arkivet är troligen skadat bortom reparation, och inga fler pass med pmlogcheck försöks.

Pass 1

Validerar integriteten hos det temporala indexet, vanligen:

arkiv.index

Eftersom det temporala indexet strikt sett är valfritt hanteras fel i detta steg genom att indexet markeras som felaktigt och ignoreras under återstående pass i pmlogcheck.

Permanent reparation kan uppnås genom att ta bort den temporala indexfilen och sedan skapa en kopia av PCP-arkivet med pmlogrewrite(1) eller pmlogextract(1). Detta skapar ett nytt temporalt index för det kopierade arkivet som en sidoeffekt.

Pass 2

Validerar integriteten hos metadatafilen, vanligen:

arkiv.meta

Pass 3

Validerar integriteten hos varje volym i PCP-arkivet, vanligen:

arkiv.0
arkiv.1

och så vidare.

Grundläggande integritetskontroller görs för att säkerställa att kodningen av värden för varje mätvärde förblir konsekvent och att värdena är välformade över alla observationer i arkivet.

Dessutom förväntas tidsstämplarna för observationerna vara monotont ökande när arkivet gås igenom.

Särskild uppmärksamhet ges åt räknarmätvärden, där type från pmLookupDesc(3) är PM_SEM_COUNTER. Dessa förväntas ha monotont ökande värden. Om värdena inte ökar monotont kan det tyda på att ett räknaromslag har inträffat, eller att det skett ett avbrott eller en återställning i den underliggande källan till prestandadata som inte fångats i arkivet.

För varje räknarmätvärde där ett omslag har upptäckts någonstans i arkivet producerar pmlogcheck utdata som beskriver:

• mätvärdets namn, med instansidentifierare där det är relevant
• den interna lagringstypen för mätvärdet
• mätvärdets värde före räknaromslaget, med tillhörande tidsstämpel
• mätvärdets värde efter omslaget, även det med tidsstämpel

Flaggan -w kan användas för att undertrycka rapportering av räknaromslag.

pmlogcheck producerar två olika tidsstämpelformat, beroende på vilket intervall programmet körs över. För intervall längre än 24 timmar visas datumet tillsammans med tiden då räknaromslaget inträffade. Om den kontrollerade datamängden omfattar mindre än 24 timmar används ett mer exakt format där tiden visas med millisekundprecision, men utan datum.

EXEMPEL

Följande kommandon är alla likvärdiga:

$ pmlogcheck myarchive
$ pmlogcheck myarchive.0
$ pmlogcheck myarchive.meta
$ pmlogcheck myarchive.0 myarchive.meta

Om den aktuella katalogen innehåller flera PCP-arkiv kontrollerar följande kommando dem alla:

$ pmlogcheck *.meta*

Detta fungerar eftersom det finns en .meta-fil för varje PCP-arkiv, men filen kan ha komprimerats, därav den avslutande jokertecknet *.

FILER

$PCP_VAR_DIR/pmns/*

Standardfiler för PMNS-specifikationer.

$PCP_LOG_DIR/pmlogger/<hostname>

Standardkatalog för PCP-arkiv som innehåller prestandadata insamlade från värden hostname.

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

FELSÖKNINGSFLAGGOR

Flaggan -D eller --debug aktiverar utskrift av ytterligare diagnostik till stderr för att hjälpa till att felsöka problem. Informationen är ibland 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.

Felsökningsflaggor som är specifika för pmlogcheck är följande:

```mediawiki

Alternativ	Beskrivning
appl0	Dumpa varje behandlad pmResult.
appl1	Rapportera varje gång ett nytt par av mått och instans upptäcks.
appl2	Rapportera räknarvärden som en del av detektering av varvning.
appl3	Rapportera förfluten tid och CPU-tid för varje körning.

```

SE ÄVEN

PCPIntro(1), pmlogdecompress(1), pmlogdump(1), pmlogextract(1), pmlogger(1), pmlogrewrite(1), pmlogsummary(1), PMAPI(3), pmLookupDesc(3), PMNS(5), pcp.conf(5) och pcp.env(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 PMLOGCHECK(1)

Sidor som hänvisar till denna sida

• pmlogdump(1)
• pmloglabel(1)
• pmlogsize(1)