pminfo(1)

NAMN

pminfo – visa information om prestandamätvärden

SYNOPSIS

pminfo [-dfFIlLmMstTvVxz?]
       [-a arkiv] [-b batchstorlek] [-c dmfil]
       [--container namn] [-D felsökning]
       [-h värdnamn] [-K spec]
       [-n|-N pmnsfil] [-O tid]
       [-r dmnamn=uttryck] [-Z tidszon]
       [mätvärdesnamn | pmid | indom]...

BESKRIVNING

pminfo visar olika typer av information om prestandamätvärden som är tillgängliga genom Performance Co-Pilot, PCP.

De mätvärden som är intressanta anges med argumenten mätvärdesnamn.

Om mätvärdesnamn är en nod som inte är ett löv i Performance Metrics Name Space, PMNS, går pminfo rekursivt ned i PMNS och rapporterar alla lövnoder under den noden.

Om inget mätvärdesnamn anges används roten av PMNS.

Om argumentet mätvärdesnamn anges i numerisk punktnotation tolkas det antingen som:

• ett tredelat pmid, alltså mätvärdesidentifierare med domän-, kluster- och objektnummer
• ett tvådelat indom, alltså instansdomänidentifierare med domän- och serienummer

I fallet pmid görs en omvänd uppslagning från PMID till namn.

I fallet indom rapporteras instansdomänen direkt. Detta läge kan användas för att rapportera sammanfattningar av instansdomänens enradshjälp och långa hjälptext.

Om ingen annan värd anges med -h kontaktar pminfo som standard Performance Metrics Collector Daemon, PMCD, på den lokala värden.

Anslutning till PMCD krävs endast om pminfo behöver:

• distribuerad PMNS-information
• metadata som beskriver mätvärden
• mätvärdesvärden
• hjälptext

Optionen -a gör att pminfo använder en angiven uppsättning arkiv i stället för att ansluta till PMCD.

Optionen -L gör att pminfo använder ett lokalt sammanhang för att samla in mätvärden från PMDA:er på den lokala värden utan PMCD. Endast vissa mätvärden är tillgängliga i detta läge.

Optionerna -a, -h och -L kan inte användas samtidigt.

OPTIONER

Tillgängliga kommandoradsoptioner är:

-a arkiv, --archive= arkiv

Hämta prestandamätvärden från en uppsättning PCP-arkiv.

Argumentet arkiv är en kommaseparerad lista med namn. Varje namn kan vara basnamnet för ett arkiv eller namnet på en katalog som innehåller ett eller flera arkiv.

-b, --batch

Ange maximalt antal mätvärden som ska hämtas i en enda begäran för optionerna -f och -v.

Standardvärdet för batchstorlek är 128.

-c dmfil, --derived= dmfil

Ange en fil som innehåller definitioner av härledda mätvärden.

Filen ska ha det format som beskrivs i pmLoadDerivedConfig(3).

Optionen -c är ett sätt att läsa in globala definitioner av härledda mätvärden. Det är ett alternativ till att använda miljövariabeln PCP_DERIVED_CONFIG, som beskrivs i PCPIntro(1).

Det är olämpligt att använda både -c och PCP_DERIVED_CONFIG för att ange samma konfiguration. Välj den ena metoden.

Se även optionen -r.

--container= container

Ange en enskild container som ska frågas.

-d, --desc

Visa mätvärdesbeskrivningar.

Beskrivningen innehåller bland annat:

• PMID
• datatyp
• datasemantik
• enheter
• skala
• tillhörande instansdomän

-f, --fetch

Hämta och skriv ut värden för alla instanser.

När data hämtas från en uppsättning arkiv visas endast de instanser som finns i den första arkivposten för ett mätvärde. Se även optionen -O.

För noggrannare undersökning av arkiv kan pmlogdump(1) vara ett bättre verktyg.

-F, --fetchall

Som -f, men försöker hårdare att hämta instanser för mätvärden som har icke-uppräkneliga instansdomäner.

Detta kan exempelvis gälla mätvärden i proc-delträdet i standard-PMNS på vissa plattformar.

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

Hämta prestandamätvärden från pmcd(1) på värd i stället för från lokalvärden.

-I, --fullindom

Skriv instansdomänen, InDom, i utförligt läge.

-K spec, --spec-local= spec

När optionen -L används för att hämta mätvärden från ett lokalt sammanhang styr denna option vilka DSO-PMDA:er som ska göras tillgängliga.

Argumentet spec följer syntaxen som beskrivs i pmSpecLocalPMDA(3).

Flera -K-optioner kan användas.

-l, --labels

Skriv etikettuppsättningar som hör till mätvärden och instanser.

Etiketter är valfria metadata för mätvärden. De beskrivs i pmLookupLabels(3).

-L, --local-PMDA

Använd ett lokalt sammanhang för att samla in mätvärden från DSO-PMDA:er på den lokala värden utan PMCD.

Se även -K.

-m, --pmid

Skriv PMID i kort läge.

-M, --fullpmid

Skriv PMID i utförligt läge.

-n pmnsfil, --namespace= pmnsfil

Normalt arbetar pminfo mot det distribuerade Performance Metrics Name Space, PMNS.

Om -n anges läses ett alternativt lokalt PMNS in från filen pmnsfil.

-N pmnsfil, --uniqnames= pmnsfil

Optionen -N fungerar som -n, men hanterar dubbla namn för samma Performance Metric Identifier, PMID, annorlunda.

Dubbla namn tillåts med -n, men inte med -N.

-O tid, --origin= tid

När optionen används tillsammans med en arkivkälla och optionerna -f eller -F anger tid den tidpunkt i arkiven då mätvärdena ska hämtas.

Se PCPIntro(1) för fullständig beskrivning av denna option och syntaxen för argumentet tid.

-r dmnamn=uttryck, --register= dmnamn=uttryck

Registrera ett kontextspecifikt härlett mätvärde med pmAddDerivedMetric(3).

dmnamn är namnet på det nya härledda mätvärdet.

uttryck är uttrycket för det härledda mätvärdet och följer syntaxen i pmRegisterDerived(3).

Flera -r-optioner kan användas.

Se även -c.

-s, --series

Skriv tidsserieidentifierare som hör till mätvärden, instanser och källor.

Dessa unika identifierare beräknas från inneboende, icke-valfria etiketter och annan metadata som hör till varje PMAPI-sammanhang, mätvärde och instans.

Arkiv, lokalt sammanhang och pmcd(1)-anslutningar för samma värd skapar samma källidentifierare.

Se även pmLookupLabels(3) och optionen -l.

-t, --oneline

Skriv enradssammanfattningen av hjälptexten, om den finns.

-T, --helptext

Skriv hjälptexten, om den finns.

-v, --verify

Verifieringsläge.

Beskrivningar och värden hämtas, men endast feltillstånd rapporteras.

Denna option stänger tyst av utmatning från optionerna:

-f
--fetch
-l
--labels
-I
--fullindom
-M
--fullpmid
-m
--pmid
-t
--oneline
-T
--helptext

-V, --version

Visa versionsnummer och avsluta.

-x, --events

Som -f eller --fetch, men med extra funktionalitet.

Om ett värde som behandlas är av typen PM_TYPE_EVENT eller PM_TYPE_HIGHRES_EVENT packas händelseposterna upp och detaljer för varje händelsepost rapporteras.

-z, --hostzone

Ändra rapporteringens tidszon till den lokala tidszonen på värden som är källa för prestandamätvärdena.

Källan identifieras via -h eller -a.

-Z tidszon, --timezone= tidszon

Som standard rapporterar pminfo tid enligt den lokala tidszonen på systemet där pminfo körs.

Optionen -Z ändrar tidszonen till tidszon, i formatet för miljövariabeln TZ enligt environ(7).

-?, --help

Visa användningsmeddelande och avsluta.

FILER

$PCP_VAR_DIR/pmns/*

Lokala standardfiler för PMNS-specifikationer.

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att ange 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.

Miljövariabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil. Se pcp.conf(5).

För miljövariabler som påverkar PCP-verktyg, se pmGetOptions(3).

FELSÖKNINGSOPTIONER

Optionen -D eller --debug aktiverar ytterligare diagnostik på standardfel, stderr.

Informationen är ibland kryptisk och är främst avsedd att ge vägledning till utvecklare snarare än slutanvändare.

Argumentet felsökning är en kommaseparerad lista över felsökningsoptioner.

Använd pmdbg(1) med optionen -l för att få en lista över tillgängliga felsökningsoptioner och deras betydelse.

Felsökningsoptioner som är specifika för pminfo:

Option	Beskrivning
appl4	Rapportera minskning av batchstorlek om batchstorlek skulle överskrida maximal PDU-storlek.
appl5	Skriv PDU-statistik vid slutet om sammanhanget är en värd.

SE ÄVEN

• PCPIntro(1)
• pmcd(1)
• pmchart(1)
• pmlogdump(1)
• pmprobe(1)
• pmrep(1)
• pmval(1)
• PMAPI(3)
• pmAddDerivedMetric(3)
• pmGetOptions(3)
• pmLoadDerivedConfig(3)
• pmLookupLabels(3)
• pmRegisterDerived(3)
• pmSpecLocalPMDA(3)
• PMNS(5)
• pcp.conf(5)
• pcp.env(5)

KOLOFON

Denna sida är en del av projektet PCP, Performance Co-Pilot.

Information om projektet finns på:

http://www.pcp.io/

Felrapporter för denna manualsida skickas till:

pcp@groups.io

Sidan hämtades från projektets uppströms Git-förråd:

https://github.com/performancecopilot/pcp.git

Den hämtades den 24 maj 2026. Vid den tidpunkten var datumet för den senaste hittade commiten i förrådet den 24 maj 2026.

Om du upptäcker renderingsproblem i HTML-versionen av sidan, eller anser att det finns en bättre eller mer uppdaterad källa för sidan, eller har rättelser eller förbättringar av informationen i kolofonen, kan du skicka e-post till:

man-pages@man7.org

HÄNVISAD FRÅN

• guidellm2pcp(1)
• indomcachectl(1)
• pcp2arrow(1)
• pcp2elasticsearch(1)
• pcp2graphite(1)
• pcp2influxdb(1)
• pcp2json(1)
• pcp2openmetrics(1)
• pcp2opentelemetry(1)
• pcp2spark(1)
• pcp2template(1)
• pcp2xlsx(1)
• pcp2xml(1)
• pcp2zabbix(1)
• pcp-dstat(1)
• pcp-geolocate(1)
• pcpintro(1)
• pmcd(1)
• pmchart(1)
• pmclient(1)
• pmdadarwin(1)
• pmdagluster(1)
• pmdahdb(1)
• pmdalio(1)
• pmdaopenmetrics(1)
• pmdaopentelemetry(1)
• pmdaopenvswitch(1)
• pmdaoracle(1)
• pmdarabbitmq(1)
• pmdards(1)
• pmdarocestat(1)
• pmdatrace(1)
• pmdaweblog(1)
• pmfind(1)
• pmfind_check(1)
• pmie(1)
• pmprobe(1)
• pmrep(1)
• pmseries(1)
• pmstore(1)
• pmval(1)
• vllmbench2pcp(1)
• webpingvis(1)
• webvis(1)
• pcpintro(3)
• pmdalabel(3)
• pmgetoptions(3)
• pmmergelabels(3)
• pmnewcontext(3)
• pmwebapi(3)
• zbxpcp(3)
• pcp-dstat(5)

KORT SAMMANFATTNING

pminfo används för att undersöka vilka PCP-mätvärden som finns och visa information om dem.

Lista alla mätvärden från PMNS-roten:

pminfo

Visa information om ett visst mätvärde:

pminfo kernel.all.cpu.user

Visa beskrivning och metadata:

pminfo -d kernel.all.cpu.user

Visa aktuellt värde:

pminfo -f kernel.all.cpu.user

Visa enradshjälp:

pminfo -t kernel.all.cpu.user

Visa lång hjälptext:

pminfo -T kernel.all.cpu.user

Visa mätvärden från en annan värd:

pminfo -h servernamn kernel.all.cpu

Visa mätvärden från ett PCP-arkiv:

pminfo -a arkiv kernel.all.cpu

pminfo är särskilt användbart när man vill hitta mätvärdesnamn, kontrollera deras typ, enhet, instanser, hjälptext och aktuella värden.

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pminfo.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 Stockholm som har sponsrat Linux.se med webbhotell.