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

• PCPIntro(1)
• pmcd(1)
• pmtrace(1)
• PMAPI(3)
• pmdatrace(3)
• pminfo(1)
• pmlogger(1)
• pmdbg(1)
• pcp.conf(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

• pmtrace(1)
• __pmaf(3)
• pmdatrace(3)

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

Sidslut

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