Visa källa för pmval(1)

= pmval(1) =

== NAMN ==

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

== SYNOPSIS ==

<pre>
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 ...
</pre>

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

<pre>
thathost:kernel.all.load["1 minute"]
</pre>

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:

<pre>
-f 3 -w 8
</pre>

skulle producera tal på formen:

<pre>
9999.999
</pre>

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:

<pre>
$ 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"]'
</pre>

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

<pre>
Sat May 22 20:32:20.971633 2021
</pre>

i stället för standardformatet:

<pre>
20:32:20.971
</pre>

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

{| class="wikitable"
! Format
! Värdeintervall
|-
| !
| Inga värden tillgängliga
|-
| 9.999E-99
| &lt; 0,1
|-
| 0.0
| 0
|-
| 9.9999
| &gt; 0 och &lt;= 0,9999
|-
| 9.999
| &gt; 0,9999 och &lt; 9,999
|-
| 99.99
| &gt; 9,999 och &lt; 99,99
|-
| 999.9
| &gt; 99,99 och &lt; 999,9
|-
| 9999.
| &gt; 999,9 och &lt; 9999
|-
| 9.999E+99
| &gt; 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:

{| class="wikitable"
! 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å:

<pre>
http://www.pcp.io/
</pre>

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

<pre>
pcp@groups.io
</pre>

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

<pre>
https://github.com/performancecopilot/pcp.git
</pre>

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/
<BR><BR>Tack till [https://datorhjalp.se/web/datorhjalp-hemma// Datorhjälp hemma] som har  sponsrat [https://www.linux.se Linux.se] med webbhotell.

[[Kategori:Linuxmanual grupp 1]]
[[Kategori:Linuxmanual]]