pmtrace(1)
NAMN
pmtrace – prestandainstrumentering från kommandoraden
SYNOPSIS
pmtrace [-q?] [-c värde | -e kommando | -v värde]
[-h värd] [-S tillstånd] tagg
BESKRIVNING
pmtrace ger ett enkelt kommandoradsgränssnitt till trace-PMDA:n, alltså Performance Metrics Domain Agent för spårning, och till det tillhörande biblioteket pcp_trace.
Standardbeteendet för pmtrace är att skicka punktspårningsdata till trace-PMDA:n.
Argumentet tagg används som identifierande namn för varje spårningspunkt.
Denna tagg blir därefter en instansidentifierare inom uppsättningen av mätvärden:
trace.point
OPTIONER
Tillgängliga kommandoradsoptioner är:
-c värde
- Tillåt att ett godtyckligt räknarvärde exporteras via mätvärdena:
trace.count
-e kommando
- Kör ett godtyckligt kommando.
- Kommandot mäts som en transaktion eftersom det har tydligt definierade start- och slutpunkter.
- Informationen görs tillgänglig via mätvärdena:
trace.transact
-h värd
- Skicka spårningsdata till trace-PMDA:n som körs på värd i stället för på lokalvärden.
- Detta åsidosätter användning av miljövariabeln PCP_TRACE_HOST.
-q
- Undertryck meddelanden från en lyckad spårning, så att pmtrace kör tyst.
-S tillstånd
- Aktivera intern felsökning och spårning.
- Värdet på tillstånd är en bitvis kombination av felsökningsflaggor enligt pmtracestate(3).
- Värdet kan anges med decimal eller hexadecimal syntax enligt strtol(3).
-v värde
- Tillåt att ett godtyckligt flyttalsvärde exporteras via mätvärdena:
trace.observe
-?
- Visa användningsmeddelande och avsluta.
DIAGNOSTIK
Alla diagnostikmeddelanden skrivs till standardfel och är avsedda att vara självförklarande.
Avslutningsstatusen för pmtrace är alltid noll, utom när optionen -e används.
När -e används returneras avslutningsstatusen från kommando.
FILER
$PCP_DEMOS_DIR/trace/pmtrace.c
- Källkod för pmtrace.
MILJÖ
Eftersom pmtrace använder biblioteksrutinerna i libpcp_trace används följande miljövariabler:
PCP_TRACE_HOST
- Anger värd för trace-PMDA.
PCP_TRACE_PORT
- Anger port för trace-PMDA.
PCP_TRACE_TIMEOUT
- Anger timeout för trace-kommunikation.
Se pmdatrace(3) för en detaljerad beskrivning av semantiken för varje variabel.
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).
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
pmtrace används för att skicka enkla spårningspunkter, räknare, observationer eller transaktioner till PCP:s trace-PMDA.
Skicka en enkel spårningspunkt:
pmtrace min_tagg
Skicka ett räknarvärde:
pmtrace -c 42 min_raknare
Skicka ett flyttalsvärde:
pmtrace -v 3.14 min_observation
Mät ett kommando som en transaktion:
pmtrace -e "kommando" min_transaktion
Skicka spårning till en annan värd:
pmtrace -h servernamn min_tagg
Kör tyst vid lyckad spårning:
pmtrace -q min_tagg