pmdatrace(1)
NAMN
pmdatrace – PMDA för prestandamätvärden på transaktionsnivå i applikationer
SYNOPSIS
$PCP_PMDAS_DIR/trace/pmdatrace [-D felsökning] [-d domän]
[-l loggfil] [-A åtkomst] [-I port] [-M användarnamn]
[-N hinkar] [-T period] [-U enheter]
BESKRIVNING
pmdatrace är en Performance Metrics Domain Agent, PMDA, som exporterar prestandamätvärden för transaktioner från applikationsprocesser som använder biblioteket pcp_trace.
Biblioteket beskrivs i pmdatrace(3).
De exporterade mätvärdena ger i huvudsak statistik över:
- tiden det tar att slutföra varje transaktion
- genomsnittligt antal slutförda transaktioner under en given period
- genomsnittligt antal passerade observationspunkter, eller watch points, under en given period
OPTIONER
-d domän
- Anger PMDA:ns prestandamätvärdesdomän.
- Det är mycket viktigt att domännumret är både unikt och konsekvent.
- Det betyder att domän ska vara olika för varje PMDA på samma värd, men att samma domännummer ska användas för samma PMDA på alla värdar.
-l loggfil
- Anger platsen för loggfilen.
- Som standard skrivs en loggfil med namnet:
trace.log
- i den aktuella katalogen för pmcd(1) när pmdatrace startas.
- Detta är normalt:
$PCP_LOG_DIR/pmcd
- Om loggfilen inte kan skapas eller inte är skrivbar skrivs utmatningen i stället till standardfel.
-A åtkomst
- Anger värdbaserad åtkomstkontroll för pmdatrace.
- åtkomst måste vara antingen en tillåtande eller nekande specifikation.
Tillåtande form:
allow:hostspec:maxconns
Nekande form:
disallow:hostspec
Där:
allow
- Nyckelord som anger att åtkomst ska tillåtas.
disallow
- Nyckelord som anger att åtkomst ska nekas.
hostspec
- En värdspecifikation enligt samma format som används av både pmcd(1) och pmlogger(1).
maxconns
- Högsta antal anslutningar som tillåts från den angivna värdspecifikationen.
- Om maxconns anges som noll betyder det obegränsat antal anslutningar för den angivna värdspecifikationen.
-I port
- Kommunicera med pcp_trace-klienter via den angivna internetporten.
- Detta kan även anges genom att sätta miljövariabeln:
PCP_TRACE_PORT
- till ett giltigt portnummer.
- Om -I anges åsidosätter den miljövariabeln.
- Standardporten är:
4323
-T period
- Anger aggregeringsperioden som används för att beräkna senaste medelvärden och extremvärden.
- Perioden anges som ett tidsintervall med den syntax som beskrivs i PCPIntro(1) för PCP:s gemensamma -t-argument.
Exempel:
30 seconds 1 min
- Standardvärdet är 60 sekunder.
-M användarnamn
- Anger vilket användarkonto agenten ska köras under.
- I aktuella versioner av PCP är standardkontot det opriviligierade kontot:
pcp
- I äldre versioner användes superanvändarkontot:
root
- som standard.
-N hinkar
- Internt delas aggregeringsperioden in i ett antal delar, eller hinkar.
- Det rullande medelvärdet räknas om var:
period / hinkar
- sekund.
Exempel:
-T 60 -N 12
- innebär att medelvärdet räknas om var femte sekund för en period som täcker de föregående 60 sekunderna.
-U enheter
- Gör det möjligt att konfigurera dimension och skala som hör till mätvärdet för observationsvärde.
- enheter är en kommaseparerad sträng med sex heltalsvärden:
rymd-dimension,tids-dimension,antal-dimension,rymd-skala,tids-skala,antal-skala
- Standarddimensionen och standardskalan är none, vilket motsvarar:
0,0,0,0,0,0
- Enheter som hör till ett mätvärde kan enklast visas med optionen -d, alltså mätvärdesbeskrivning, till pminfo(1).
- Installationsskriptet som beskrivs nedan går igenom denna option mycket uttryckligt. Därför rekommenderas att skriptet Install används för att bygga upp specifikationen för enheter.
INSTALLATION
För att en värd ska exportera namn, hjälptext och värden för trace-prestandamätvärdena körs följande som root:
cd $PCP_PMDAS_DIR/trace ./Install
För att ångra installationen körs följande som root:
cd $PCP_PMDAS_DIR/trace ./Remove
pmdatrace startas av pmcd(1) och ska aldrig köras direkt.
Skripten Install och Remove meddelar pmcd(1) när agenten installeras eller tas bort.
FILER
$PCP_PMCDCONF_PATH
- Kommandoradsoptioner som används för att starta pmdatrace.
$PCP_PMDAS_DIR/trace/help
- Standardfil med hjälptext för trace-mätvärdena.
$PCP_DEMOS_DIR/trace/*
- Exempelprogram som använder biblioteket pcp_trace.
$PCP_PMDAS_DIR/trace/Install
- Installationsskript för agenten pmdatrace.
$PCP_PMDAS_DIR/trace/Remove
- Skript för att ångra installationen av pmdatrace.
$PCP_LOG_DIR/pmcd/trace.log
- Standardloggfil för felmeddelanden och annan information från pmdatrace.
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).
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 pmdatrace:
| Option | Beskrivning |
|---|---|
| appl0 | Tolkning av autentisering, klientändringar, IPC, samt uppdateringar av mätvärdesdata och metadata. |
| appl1 | Rådata för hastighetsmätvärden. |
SE ÄVEN
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
KORT SAMMANFATTNING
pmdatrace är PCP-agenten som tar emot trace-data från program som använder biblioteket pcp_trace eller från kommandot pmtrace(1).
Installera trace-PMDA:n:
cd $PCP_PMDAS_DIR/trace ./Install
Ta bort trace-PMDA:n:
cd $PCP_PMDAS_DIR/trace ./Remove
Visa mätvärdesbeskrivningar efter installation:
pminfo -d trace
Kontrollera trace-mätvärden:
pmprobe trace
Skicka en enkel spårningspunkt med pmtrace(1):
pmtrace min_tagg
pmdatrace ska normalt inte startas direkt. Det hanteras av pmcd(1).