pmval(1)

pmval(1)

NAMN

pmval, pmevent - dumpa godtyckliga värden för prestandamått

SYNOPSIS

pmval [-dgLrvVXz?] [-a arkiv] [-A justering] [--container=namn]
      [-D debug] [--derived=fil] [-f N] [-h värd]
      [-i instanser] [-K spec] [-n pmnsfil] [-O förskjutning]
      [-p port] [-s prover] [-S starttid] [-t intervall]
      [-T sluttid] [-U arkiv] [-w bredd] [-x mönster]
      [-Z tidszon] måttnamn

pmevent ...

BESKRIVNING

pmval skriver ut aktuella eller arkiverade värden för det angivna prestandamåttet. Det intressanta måttet anges med argumentet måttnamn, med möjlighet till instanskvalificering med flaggan -i enligt beskrivningen nedan.

Om inte en annan värd anges med alternativet -h, eller en uppsättning arkiv anges med alternativen -a eller -U, kontaktar pmval Performance Metrics Collector Daemon, PMCD, på den lokala värden för att hämta den information som krävs.

Argumentet måttnamn kan också anges med syntaxen för måttspecifikationer, enligt beskrivningen i PCPIntro(1), där källa, mått och instans alla kan ingå i måttnamn, till exempel:

thathost:kernel.all.load["1 minute"]

När detta format används får inget av alternativen -h, -a eller -U anges.

När syntaxen för måttspecifikationer används behandlas värdnamnet @ på ett särskilt sätt. Det gör att pmval använder en lokal kontext för att samla in mått från PMDA:er på den lokala värden utan PMCD. Endast vissa mått är tillgängliga i detta läge.

När en uppsättning arkiv behandlas kan pmval lämna ifrån sig sin egen tidsstyrning och i stället köras under kontroll av en pmtime(1)-process som använder en grafisk dialogruta för tidsstyrning. I detta fall ska antingen alternativet -g användas för att starta pmval som enda klient till en ny pmtime(1)-instans, eller också ska -p användas för att ansluta pmval till en befintlig pmtime(1)-instans via IPC-kanalen som identifieras av argumentet port.

Alternativen -S, -T, -O och -A kan användas för att definiera ett tidsfönster som begränsar de hämtade proverna, sätta en ursprunglig startpunkt inom tidsfönstret eller ange en ”naturlig” justering av provtiderna. Se PCPIntro(1) för en fullständig beskrivning av dessa alternativ.

Utmatningen från pmval skrivs till standardutmatningen. Följande symboler kan ibland förekomma i stället för ett måttvärde i utmatningen från pmval:

Ett frågetecken, ?, anger att ett värde inte längre är tillgängligt för den måttinstansen.

Ett utropstecken, !, anger att en 64-bitars räknare slog runt under provtagningen.

pmevent är ett alias för pmval.

ALTERNATIV

Tillgängliga kommandoradsalternativ är:

-a arkiv, --archive=arkiv

Prestandamåttvärden hämtas från den uppsättning Performance Co-Pilot-arkivfiler, PCP, som identifieras av argumentet arkiv. Detta är en kommaseparerad lista med namn, där varje namn kan vara basnamnet för ett arkiv eller namnet på en katalog som innehåller ett eller flera arkiv. Se även -U.

-A justering, --align=justering

Tvinga det första provet att justeras mot gränsen för en naturlig tidsenhet, justering. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för justering.

--container=container

Ange en enskild container som ska frågas.

-d, --delay

Vid uppspelning från ett arkiv begär detta alternativ att den rådande realtidsfördröjningen ska användas mellan proverna, se -t, för att skapa en paus, i stället för standardbeteendet att spela upp i full hastighet.

--derived=fil

Läs in definitioner för härledda mått från fil.

-f precision, --precision=precision

Tal rapporteras med fast decimalnotation i stället för den normala vetenskapliga notation som används som standard. precision anger antalet decimalers precision. Varje tal får högst den kolumnbredd som bestäms av standardheuristiken, eller av alternativet -w om det har angetts, och innehåller precision siffror efter decimaltecknet.

Alternativen:

-f 3 -w 8

skulle producera tal på formen:

9999.999

Ett värde på noll för precision utelämnar decimaltecknet och alla decimaler.

-g, --guimode

Starta pmval som enda klient till en ny pmtime(1)-serverprocess för uppspelning av arkiverade prestandadata med det grafiska användargränssnittet i pmtime(1).

-h värd, --host=värd

Hämta prestandamått från pmcd(1) på värd, i stället för från den lokala standardvärden.

-i instanser, --instances=instanser

Ange en lista med ett eller flera namn på instanser för det angivna prestandamåttet. Endast dessa instanser hämtas och rapporteras. Standard är att rapportera alla instanser.

Listan måste vara ett enda argument, där elementen i listan separeras med kommatecken och/eller blanktecken.

Instansnamnet kan citeras med enkla citattecken, ''', eller dubbla citattecken, "', i de fall där instansnamnet innehåller blanktecken eller kommatecken.

Flera -i-alternativ är tillåtna som ett alternativt sätt att ange mer än en intressant instans.

Som exempel är följande kommandon likvärdiga:

$ pmval -i "'1 minute','5 minute'" kernel.all.load
$ pmval -i '"1 minute","5 minute"' kernel.all.load
$ pmval -i "'1 minute' '5 minute'" kernel.all.load
$ pmval -i "'1 minute'" -i "'5 minute'" kernel.all.load
$ pmval 'localhost:kernel.all.load["1 minute","5 minute"]'

-K spec, --spec-local=spec

När mått hämtas från en lokal kontext, se -L, kan alternativet -K användas för att styra vilka DSO-PMDA:er som ska göras åtkomliga. Argumentet spec följer syntaxen som beskrivs i pmSpecLocalPMDA(3). Mer än ett -K-alternativ kan användas.

-L, --local-PMDA

Använd en lokal kontext för att samla in mått från DSO-PMDA:er på den lokala värden utan PMCD. Se även -K.

-n pmnsfil, --namespace=pmnsfil

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

-O ursprung, --origin=ursprung

Vid rapportering av arkiverade mått börjar rapporteringen vid ursprung inom tidsfönstret, se -S och -T. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för ursprung.

-p port, --guiport=port

Anslut pmval till en befintlig pmtime(1)-instans för tidsstyrning via IPC-kanalen som identifieras av argumentet port. Detta alternativ används normalt endast av andra verktyg, till exempel pmchart(1), när de startar pmval med synkroniserad tidsstyrning.

-r, --raw

Skriv ut råa värden för kumulativa räknarmått. Normalt omvandlas kumulativa räknarmått till frekvenser. Till exempel rapporteras disköverföringar som antalet disköverföringar per sekund under det föregående provintervallet, i stället för det råa värdet för antalet disköverföringar sedan maskinen startades. Om detta alternativ anges skrivs de råa måttvärdena ut.

-s prover, --samples=prover

Argumentet prover anger antalet prover som ska hämtas och rapporteras. Om prover är 0, eller om -s inte anges, kommer pmval att ta prover och rapportera kontinuerligt i realtidsläge, eller fram till slutet av uppsättningen PCP-arkiv i arkivläge.

-S starttid, --start=starttid

Vid rapportering av arkiverade mått 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 intervall, --interval=intervall

Sätt rapporteringsintervallet till något annat än standardvärdet 1 sekund. Argumentet intervall följer syntaxen som beskrivs i PCPIntro(1), och i sin enklaste form kan det vara ett heltal utan tecken. I så fall är den underförstådda enheten sekunder.

-T sluttid, --finish=sluttid

Vid rapportering av arkiverade mått 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.

-U arkiv, --nointerp=arkiv

Prestandamåttvärden hämtas från Performance Co-Pilot-arkivet, PCP, arkiv. Argumentet är en kommaseparerad lista med namn, där varje namn kan vara basnamnet för ett arkiv eller namnet på en katalog som innehåller ett eller flera arkiv.

Till skillnad från -a rapporteras dock varje registrerat värde i arkivet för det valda måttet och de valda instanserna. Det innebär att inget interpoleringsläge används, och att provintervallet, alternativet -t, ignoreras. Se även -a.

Högst ett av alternativen -a och -U får anges.

-v, --verbose

Aktivera utförligt läge.

-V, --version

Visa versionsnummer och avsluta.

-w bredd, --width=bredd

Sätt bredden för varje utmatningskolumn till bredd kolumner. Om detta inte anges görs kolumnerna tillräckligt breda för att rymma det största värdet av den typ som skrivs ut.

-x mönster, --filter=mönster

Det angivna mönster skickas till prestandamåttets domänagent för det begärda måttnamn innan några värden begärs.

Detta har två syften. För det första ger det en mekanism för händelsefiltrering på serversidan som kan anpassas för enskilda händelseströmmar. Dessutom använder vissa domänagenter för prestandamått även PMCD:s lagringsmekanism för att tillhandahålla en enkel säkerhetsmodell. Till exempel kan känsliga loggfiler endast vara åtkomliga för en klientvärd med åtkomst via pmStore(3).

Eftersom mönster kan behandlas av regcomp(3) bör det vara en icke-tom sträng. Använd punkt, ., som ett mönster som matchar allt.

-X, --timestamp

Vid uppspelning från ett arkiv begär detta alternativ att tidsstämpeln ska rapporteras med ytterligare datuminformation och ökad precision. En ensam -X ger mikrosekunder, och ytterligare en -X ger nanosekunder.

Exempel på utökat format:

Sat May 22 20:32:20.971633 2021

i stället för standardformatet:

20:32:20.971

-z, --hostzone

Använd den lokala tidszonen för den värd som är källa till prestandamåtten, enligt vad som identifieras av antingen -h, -a eller -U. Standard är att använda tidszonen för den lokala värden.

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

-?, --help

Visa användningsmeddelande och avsluta.

VARNINGAR

Som standard försöker pmval visa icke-heltalsvärden på ett sätt som inte förvränger den inneboende precisionen, som sällan är mer än 4 signifikanta siffror, och samtidigt försöker verktyget behålla ett tabellformat i utmatningen. Dessa mål står ibland i konflikt med varandra.

Om alternativet -f, som beskrivs ovan, inte används beskriver följande tabell formaten som används för olika intervall av numeriska värden för alla mått av typen PM_TYPE_FLOAT eller PM_TYPE_DOUBLE, eller alla mått som har semantiken hos en räknare, där pmval rapporterar det frekvensomvandlade värdet:

Format	Värdeintervall
!	Inga värden tillgängliga
9.999E-99	< 0,1
0.0	0
9.9999	> 0 och <= 0,9999
9.999	> 0,9999 och < 9,999
99.99	> 9,999 och < 99,99
999.9	> 99,99 och < 999,9
9999.	> 999,9 och < 9999
9.999E+99	> 9999

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att parametrisera 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 på stderr för att hjälpa till vid felsökning. Informationen är dock ibland kryptisk och främst avsedd att ge vägledning till utvecklare snarare än slutanvändare.

debug är en kommaseparerad lista över 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 pmval är följande:

Alternativ	Beskrivning
appl0	Inledande placering på tidslinjen när -a används.

SE ÄVEN

PCPIntro(1), pmcd(1), pmchart(1), pmdumptext(1), pminfo(1), pmlogdump(1), pmlogger(1), pmrep(1), pmtime(1), PMAPI(3), pmSpecLocalPMDA(3), pmStore(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

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste hittade committen i arkivet också 16 januari 2026.

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

man-pages@

Sidor som hänvisar till denna sida

• pcpintro(1)
• pmafm(1)
• pmcd(1)
• pmchart(1)
• pmclient(1)
• pmdabash(1)
• pmdalogger(1)
• pmdapipe(1)
• pmdasystemd(1)
• pmie(1)
• pminfo(1)
• pmlogsummary(1)
• pmrep(1)
• pmstore(1)
• pmtime(1)
• webpingvis(1)
• webvis(1)
• pmregisterderived(3)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pmval.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.