pmprobe(1)

NAMN

pmprobe – lättviktskontroll av prestandamätvärden

SYNOPSIS

pmprobe [-dfFiILvVz?]
        [-a arkiv] [-b batchstorlek]
        [--container=namn] [-D felsökning]
        [--derived=fil] [-h värdnamn]
        [-K spec] [-n pmnsfil]
        [-O tid] [-Z tidszon]
        [mätvärdesnamn ...]

BESKRIVNING

pmprobe avgör om prestandamätvärden som exporteras genom Performance Co-Pilot, PCP, finns tillgängliga.

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 pmprobe rekursivt ned i PMNS och rapporterar alla lövnoder under den noden.

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

Den rekursiva utökningen av PMNS kan förhindras med optionen -F, alltså go faster. Detta minskar antalet rundresor till pmcd(1) när argumenten mätvärdesnamn redan är kända lövnoder.

Utmatningsformatet är enkelt och avsett för användning i omslutande skript som skapar konfigurationsfiler för andra PCP-verktyg.

Som standard skrivs en rad per mätvärde. Raden innehåller mätvärdesnamnet följt av ett antal som anger hur många värden som finns tillgängliga.

Feltillstånd kodas som ett negativt antal värden, enligt PMAPI(3)-protokollen. De kan avkodas med pmerr(1). Efter felkoden skrivs en textbeskrivning av felet.

Om ingen annan värd anges med -h kontaktar pmprobe tjänsten Performance Metrics Collector Daemon, PMCD, på den lokala värden.

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

Optionen -L gör att pmprobe 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 finns 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 optionen -v och för varje pmLookupName(3)-begäran där pmprobe anropar funktionen med en lista över lövmätvärdesnamn.

Standardvärdet för batchstorlek är 128.

Optionen är användbar för att undvika begränsningar i PDU-begärans storlek och för att sprida hämtningar. Annars kan hämtningar få timeout om pmcd(1) eller en PMDA svarar långsamt, särskilt när många mätvärden kontrolleras.

--container= container

Ange en enskild container som ska frågas.

-d, --version

Visa versionsnummer och avsluta.

--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 är ett sätt att läsa in definitioner av härledda mätvärden och ä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 --derived och PCP_DERIVED_CONFIG för att ange samma konfiguration. Välj den ena metoden.

-f, --force

När optionen används tillsammans med -i eller -I rapporteras alla instanser som är kända vid källan för prestandadata.

Som standard rapporteras de instanser för vilka värden för närvarande finns tillgängliga. Denna uppsättning kan vara mindre än den som rapporteras med -f.

-F, --faster

Anta att angivna mätvärdesnamn är PMNS-lövnoder.

Detta gör körningen snabbare genom att undvika rekursiv genomgång.

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

Anslut till pmcd(1) på värd i stället för till standardvärden, alltså lokalvärden.

-i, --internal

Rapportera interna identifierare för varje instans.

Värdena anges i decimal form och föregås av ?.

Som specialfall rapporteras den bokstavliga strängen PM_IN_NULL för enkla mätvärden utan instanser.

-I, --external

Rapportera externa identifierare för varje instans.

Den bokstavliga strängen PM_IN_NULL rapporteras för enkla mätvärden utan instanser.

-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 i pmSpecLocalPMDA(3).

Flera -K-optioner kan användas.

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

-n pmnsfil, --namespace= pmnsfil

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

Om -n anges läses en alternativ lokal PMNS-fil in från pmnsfil.

-O tid, --origin= tid

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

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

-v, --values

Rapportera värdet för varje instans enligt formateringsreglerna i pmPrintValue(3).

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.

Optionen -v kan inte användas tillsammans med -I eller -i.

-V, --verbose

Visa en kortfattad och något kryptisk sammanfattning av antalet meddelanden som skickats och tagits emot via PMAPI-gränssnittet.

-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 optionen -h eller -a.

-Z tidszon, --timezone= tidszon

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

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

-?, --help

Visa användningsmeddelande och avsluta.

EXEMPEL

Kontrollera alla lövmätvärden under disk.dev:

pmprobe disk.dev

Exempel på utmatning:

disk.dev.read 2
disk.dev.write 2
disk.dev.total 2
disk.dev.blkread 2
disk.dev.blkwrite 2
disk.dev.blktotal 2
disk.dev.active 2
disk.dev.response 2

Visa externa instansnamn för två diskrelaterade mätvärden och ett globalt mätvärde:

pmprobe -I disk.dev.read disk.dev.write disk.all.total

Exempel på utmatning:

disk.dev.read 2 "sda" "sdb"
disk.dev.write 2 "sda" "sdb"
disk.all.total 1 PM_IN_NULL

Visa värden för några PMCD-mätvärden:

pmprobe -v pmcd.numagents pmcd.version pmcd.control.timeout

Exempel på utmatning:

pmcd.numagents 1 9
pmcd.version 1 "5.0.0"
pmcd.control.timeout 1 5

Visa värden där ett mätvärde saknas:

pmprobe -v disk.dev.total disk.all.total

Exempel på utmatning:

disk.dev.total -1012 Unknown metric name
disk.all.total 1 4992466

FILER

$PCP_VAR_DIR/pmns/*

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

Option	Beskrivning
appl0	Batchinformation när -b används.

SE ÄVEN

• PCPIntro(1)
• pmcd(1)
• pminfo(1)
• pmlogdump(1)
• PMAPI(3)
• pmErrStr(3)
• pmGetOptions(3)
• pmSpecLocalPMDA(3)
• pcp.conf(5)
• pcp.env(5)
• PMNS(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

• pcp-dstat(1)
• pminfo(1)
• pmrep(1)
• pmtrace(1)
• pmdatrace(3)
• pcp-dstat(5)

KORT SAMMANFATTNING

pmprobe används för att snabbt kontrollera om PCP-mätvärden finns och hur många värden eller instanser de har.

Kontrollera ett mätvärde:

pmprobe kernel.all.cpu.user

Kontrollera ett delträd i PMNS:

pmprobe disk.dev

Visa externa instansnamn:

pmprobe -I disk.dev.read

Visa interna instans-ID:n:

pmprobe -i disk.dev.read

Visa värden:

pmprobe -v pmcd.numagents

Fråga en annan värd:

pmprobe -h servernamn kernel.all.cpu

Fråga ett PCP-arkiv:

pmprobe -a arkiv kernel.all.cpu

pmprobe är särskilt användbart i skript, eftersom utmatningen är enkel: mätvärdesnamn följt av antal tillgängliga värden, eller ett negativt felvärde.

Sidslut

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