pmchart(1)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Version från den 9 maj 2026 kl. 05.48 av Admin (diskussion | bidrag) (→‎pmchart(1) – Linux manualsida)
(skillnad) ← Äldre version | Nuvarande version (skillnad) | Nyare version → (skillnad)
Hoppa till navigering Hoppa till sök

NAMN

pmchart – strip chart-verktyg för Performance Co-Pilot

SYNOPSIS

pmchart [-CLVWz?] [-a archive] [-A align] [--archive-folio folio]
        [-c configfile] [-D debug] [-f fontfamily] [-F fontsize]
        [-g geometry] [-h host] [-n pmnsfile] [-o outfile]
        [-O offset] [-p port] [-s samples] [-S starttime]
        [-t interval] [-T endtime] [-v visible] [-Z timezone]
        [-geometry geometry] [sources...]

BESKRIVNING

pmchart är ett grafiskt verktyg som ritar upp värden för prestandamätvärden som är tillgängliga genom Performance Co-Pilot, PCP. Flera diagram kan visas samtidigt, antingen justerade mot en gemensam tidsaxel, X-axeln, och genom användning av flera flikar i gränssnittet.

Mätvärden kan hämtas från en eller flera levande värdar samtidigt. Alternativt kan en eller flera uppsättningar PCP-arkiv användas som källa för historiska data. Se PCPIntro(1) för en mer ingående beskrivning av PCP-ramverkets funktioner, av vilka många används av pmchart.

Många delar av pmcharts beteende kan anpassas via gränssnittet. Särskilt användningen av vyer, se avsnittet VYER längre ned, gör att fördefinierade uppsättningar av mätvärden och diagramparametrar kan sparas för senare användning, eller användas med andra värdar och arkivuppsättningar. Det kan omfatta färger, skalning, rubriker, förklaringar och liknande.

Dialogrutan för inställningar gör det dessutom möjligt att spara och återställa anpassningar av resten av pmcharts användargränssnitt mellan olika körningar. Detta gör att standardbakgrundsfärg, markeringsfärg, verktygsfältets innehåll och placering samt många andra delar kan konfigureras.

pmchart använder i hög grad verktyget pmtime(1) för tidsstyrning. Se manualsidan för pmtime för mer information om hur det fungerar.

ALTERNATIV

Tillgängliga kommandoradsalternativ är:

-a <archive> eller --archive=<archive>
Prestandamätvärden hämtas som standard från den uppsättning PCP-arkiv som identifieras med detta alternativ. Argumentet är en kommaseparerad lista med namn, där varje namn kan vara basnamnet för ett arkiv eller namnet på en katalog som innehåller ett eller flera arkiv.
Den resulterande uppsättningen arkiv används som källa för prestandamätvärdena. Den första fliken som skapas blir en flik i arkivläge.
Flera -a-alternativ kan anges, och den resulterande listan med arkivuppsättningar används som källor för mätvärden. Alla sources som anges på kommandoraden antas vara arkivuppsättningar om detta alternativ används.
-A <align> eller --align=<align>
Tvinga det första sampelvärdet att justeras mot gränsen för en naturlig tidsenhet, align. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för align.
--archive-folio=<folio>
Läs arkiv med mätvärdeskällor från PCP-arkivfolion folio.
-c <configfile> eller --view=<configfile>
configfile anger en inledande vy som ska läsas in med standardkällan för mätvärden. Flera -c-vyer kan anges, och de öppnas alla i standardfliken med standardkällan för mätvärden.
-C eller --check
Används tillsammans med -c. Vyerna tolkas, eventuella fel rapporteras och verktyget avslutas. Detta är främst avsett för testning. Om ett andra -C-alternativ anges ansluter pmchart även till pmcd(1) för att kontrollera mätvärdenas semantik.
-f <family> eller --font-family=<family>
Ange standardtypsnittsfamiljen family som ska användas i flera diagramkomponenter, till exempel diagramrubrik, förklaring och Y-axeletikett. Standardvärdet är Sans Serif.
Denna inställning påverkar inte resten av användargränssnittet, där värdet ärvs från miljön där pmchart körs och varierar beroende på plattformens utseende och känsla.
-F <point> eller --font-size=<point>
Ange standardstorlek i punkter som ska användas i flera diagramkomponenter, till exempel diagramrubrik, förklaring och Y-axeletikett. Standardvärdet är plattformsberoende, men är antingen 7, 8 eller 9.
Denna inställning påverkar inte resten av användargränssnittet.
-g <geometry> eller --geometry=<geometry>
Generera en bild med angiven geometry, det vill säga bredd och höjd. Detta alternativ är endast användbart tillsammans med -o för att generera en utdatafil med en bild.
Argumentet geometry har formen WxH, till exempel:
240x120
När flaggan -o inte används, och du vill ange fönstergeometrin för visningen, ska du använda:
-geometry geometry
Där geometry anger önskad fönsterbredd, höjd och valfri placering.
-h <host> eller --host=<host>
Aktuella prestandamätvärden hämtas som standard från den angivna värddatorn host. Flera -h-alternativ kan anges, och listan med värdar används som källa för mätvärden. Alla sources som anges på kommandoraden antas vara värdar om detta alternativ används.
-H <path> eller --hostsfile=<path>
Ange sökvägen till en fil som innehåller en uppsättning värdnamn där pmcd(1) körs, i stället för att använda standardvärden localhost.
-K <spec> eller --spec-local=<spec>
Vid hämtning av mätvärden från en lokal kontext, se -L, kan alternativet -K användas för att styra vilka DSO-PMDA:er som ska göras tillgängliga. Argumentet spec följer syntaxen som beskrivs i pmSpecLocalPMDA(3). Mer än ett -K-alternativ kan användas.
-L eller --local-PMDA
Använd en lokal kontext för att samla in mätvärden från DSO-PMDA:er på den lokala värden utan PMCD. Se även -K.
-n <pmnsfile> eller --namespace=<pmnsfile>
Läs in en alternativ Performance Metrics Name Space, PMNS(5), från filen pmnsfile.
-o <outfile> eller --output=<outfile>
Generera en bildfil med namnet outfile och avsluta sedan. Detta är mest användbart när verktyget körs med en uppsättning arkiv och en eller flera vyer.
Den genererade bilden får det format som anges av filändelsen, vilket bestäms automatiskt från outfile. Om ingen filändelse kan bestämmas används GIF-formatet och den genererade filen får denna ändelse.
Stödda bildformat omfattar:
  • bmp
  • jpeg
  • jpg
  • png
  • ppm
  • tif
  • tiff
  • xbm
  • xpm
-O <origin> eller --origin=<origin>
Vid rapportering av arkiverade mätvärden börjar rapporteringen vid origin inom tidsfönstret, se -S och -T. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för origin.
-p <port> eller --guiport=<port>
Portnummer för anslutning till en befintlig pmtime-process för tidsstyrning.
-s <samples> eller --samples=<samples>
Anger antalet samples som behålls innan gamla data kastas bort och ersätts med nya värden vid aktuell tidsposition. Detta värde kan senare ändras via dialogrutan Edit Tab.
-S <starttime> eller --start=<starttime>
Vid rapportering av arkiverade mätvärden begränsas rapporten till poster som loggats vid eller efter starttime. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för starttime.
-t <interval> eller --interval=<interval>
Sätter det inledande uppdateringsintervallet till något annat än standardvärdet 1 sekund. Argumentet interval följer syntaxen som beskrivs i PCPIntro(1). I sin enklaste form kan det vara ett osignerat heltal, där den underförstådda enheten är sekunder.
-T <endtime> eller --finish=<endtime>
Vid rapportering av arkiverade mätvärden begränsas rapporten till poster som loggats före eller vid endtime. Se PCPIntro(1) för en fullständig beskrivning av syntaxen för endtime.
-v <samples> eller --visible=<samples>
Sätter det inledande antalet synliga samples som visas i alla diagram i standardfliken. Detta värde måste vara mindre än eller lika med det totala antalet sampel som behålls, alltså värdet från -s.
-V eller --version
Visa versionsnummer för pmchart och avsluta.
-W eller --white
Exportera bilder med ogenomskinlig vit bakgrund.
-z eller --hostzone
Ändra rapporteringens tidszon till den lokala tidszonen på den värd som är källa för prestandamätvärdena, enligt vad som identifieras via antingen -h eller -a.
-Z <timezone> eller --timezone=<timezone>
Som standard rapporterar pmtime tiden enligt den lokala tidszonen på systemet där pmchart körs. Alternativet -Z ändrar tidszonen till timezone i samma format som miljövariabeln TZ, enligt beskrivningen i environ(7).
-? eller --help
Visa användningsmeddelande och avsluta.

VYER

Den primära konfigurationsfilen för pmchart är vyn, som gör att metadata för ett eller flera diagram kan sparas i filsystemet. Dessa metadata beskriver alla delar av diagrammen, inklusive vilka PCP-mätvärden och instanser som ska användas, vilka värdar, vilka färger, diagramrubriker, användning av förklaringar och mycket mer.

Ur ett konceptuellt perspektiv finns det två klasser av vyer. Dessa vyer delar samma konfigurationsfilformat. Se ett senare avsnitt för en fullständig beskrivning av formatet. Skillnaderna ligger i var de installeras och hur de hanteras.

Den första klassen, systemvyer, är helt enkelt vyer som installeras som en del av pmchart-paketet. Dessa lagras i: 

$PCP_VAR_DIR/config/pmchart

När dialogrutan File→Open View visas är det dessa vyer som först listas. Systemvyerna kan inte ändras av en normal användare och bör inte ändras ens av en användare med lämpliga behörigheter, eftersom de skrivs över vid uppgradering.

Den andra klassen är användarvyer. Dessa skapas dynamiskt med dialogrutan File→Save View. Detta är en mekanism för enskilda användare att spara sina vanliga vyer.

Åtkomst till dessa vyer sker via dialogrutan File→Open View, på samma sätt som för systemvyer. När dialogrutan har öppnats kan listan över vyer växlas mellan användarvyer och systemvyer genom att klicka på de två växlingsknapparna längst upp till höger. Användarvyer lagras i: 

$HOME/.pcp/pmchart

FLIKAR

pmchart tillhandahåller det vanliga gränssnittsbegreppet flikar, som är vanligast i moderna webbläsare. Flikar gör att pmchart kan uppdatera många fler diagram än vad skärmytan egentligen tillåter, genom att tillhandahålla en mekanism för att stapla och växla mellan olika vertikala uppsättningar av diagram.

Växling mellan flikar görs genom att klicka på fliketiketterna, som finns längst upp i visningen under menyerna och verktygsfältet.

Varje flik har ett driftläge, antingen live eller arkiv. pmchart kan stödja båda lägena samtidigt. Varje flik har också totalt antal sampel, antal synliga punkter och en etikett som beskriver fliken och visas överst i pmchart-fönstret. Nya flikar kan skapas med dialogrutan File→Add Tab.

För att spara vertikal skärmyta visas gränssnittselementet för att byta mellan flikar, och dess etikett, endast när det finns mer än en flik. En flik kan stängas med menyn File→Close Tab, vilket tar bort den aktuella fliken och alla diagram som den innehöll.

BILDER OCH UTSKRIFT

En statisk kopia av den aktuellt visade vertikala diagramserien kan fångas på två sätt.

När den avsedda visningsenheten är skärmen bör menyalternativet File→Export användas. Detta gör det möjligt att exportera diagrammen i flera bildformat, inklusive PNG, JPEG, GIF och BMP. Bildstorleken kan skalas upp eller ned i valfri dimension.

Alternativt kan menyalternativet File→Print användas när den avsedda visningsenheten är papper. Detta stöder de vanliga utskriftsalternativen, till exempel val av skrivare, gråskala/färg, liggande/stående orientering och skalning till olika pappersstorlekar. Dessutom går det att skriva ut till mellanformaten PostScript och Portable Document Format, PDF.

INSPELNING

Det är möjligt att göra en inspelning av en uppsättning visade diagram för senare uppspelning med pmchart eller något av de andra Performance Co-Pilot-verktygen.

Funktionen Record→Start är enkel att konfigurera via användargränssnittet och gör det möjligt att finjustera inspelningsprocessen, inklusive inspelningsfrekvenser som skiljer sig från pmcharts uppdateringsintervall, alternativa filplatser och liknande.

pmchart skapar inspelningar som är kompatibla med PCP:s uppspelningsmekanism pmafm(1), för senare uppspelning via en ny instans av pmchart. Vid inspelning via pmchart går det dessutom att spela upp inspelningen omedelbart. När inspelningen avslutas via menyalternativet Record→Stop skapas en flik i arkivläge med den fångade vyn.

När inspelning är aktiv i en liveflik visas knappen för tidsstyrningsstatus längst ned till vänster i pmchart-fönstret med en tydlig röd punkt. När som helst under en inspelningssession i pmchart kan mängden filsystemutrymme som används av inspelningen visas med menyalternativet Record→Query.

Slutligen ger menyalternativet Record→Detach en mekanism där inspelningsprocessen kan kopplas helt loss från den körande pmchart-processen och fortsätta även när pmchart avslutas. En dialogruta visar aktuell storlek och uppskattad tillväxthastighet för inspelningen.

Om pmchart däremot avslutas medan inspelning pågår, frågar inspelningsprocessen användaren om inspelningen ska stoppas omedelbart eller fortsätta självständigt.

Alla inspelningstjänster som är tillgängliga från pmchart implementeras med hjälp av de grundläggande loggningstjänsterna i Performance Co-Pilot. Se pmlogger(1) och pmafm(1) för en omfattande beskrivning av dessa verktygs funktioner.

SYNTAX FÖR KONFIGURATIONSFIL

pmchart läser in fördefinierade diagramkonfigurationer, eller vyer, från externa filer som följer reglerna nedan.

I beskrivningarna nedan kan nyckelord förekomma med stora, små eller blandade bokstäver. Element som visas inom hakparenteser är valfria, och användarangivna element visas inom vinkelparenteser. Ett lodrätt streck, |, används när syntaktiska element är alternativ. Citattecken, ", kan användas för att omsluta lexikala element som kan innehålla blanktecken, till exempel rubriker, etiketter och instansnamn.

1. Första raden

Den första raden definierar konfigurationsfilens typ och bör vara: 

#kmchart

pmchart ger dock bakåtkompatibilitet för äldre vyformat med en första rad av typen: 

#pmchart

2. Kommentarer och tomma rader

Efter den första raden behandlas rader som börjar med # som första icke-blanktecken som kommentarer och hoppas över. Tomma rader hoppas också över.

3. Versionsrad

Nästa rad bör vara: 

version <n> <host-clause>

Där <n> beror på konfigurationsfiltypen och är 1 för äldre pmchart, annars 1.1, 1.2 eller 2.0 för pmchart.

Delen <host-clause> är valfri, och ignoreras, för äldre pmchart-konfigurationsfiler, men krävs för nyare pmchart-konfigurationsfiler. Den har formen: 

host literal

eller: 

host dynamic

4. Diagram

En konfiguration innehåller ett eller flera diagram som definieras på följande sätt: 

chart [title <title>] style <style> <options>

Om en rubrik anges visas den centrerad ovanför diagrammets grafyta. <title> omges vanligtvis med citattecken. Om den innehåller sekvensen %h ersätts denna med den korta formen av värdnamnet för standardkällan för mätvärden när diagrammet läses in. Alternativt kan %H användas för att infoga det fullständiga värdnamnet.

Om värdnamnet verkar vara en inet- eller IPv6-adress görs inget försök att korta det. Det används som det är i båda ersättningsfallen.

När vyn har lästs in kan rubrikens synlighet och inställning ändras med textrutan Chart Title i dialogrutan Edit→Chart.

<style> styr diagrammets inledande ritstil och ska vara ett av följande nyckelord:

  • plot – linjediagram
  • bar – stapeldiagram
  • stacking – staplat stapeldiagram
  • area – ytdiagram
  • utilization – användningsdiagram

När vyn har lästs in kan ritstilen ändras med rullistan Edit→Chart Style.

<options> är noll eller fler av följande valfria element: 

[scale [from] <ymin> [to] <ymax>] [legend <onoff>]

Om scale anges sätts den vertikala skalan för alla plottar i diagrammet till ett Y-intervall som definieras av <ymin> och <ymax>. Annars autoskalas den vertikala axeln utifrån de värden som för närvarande ritas upp.

<onoff> är ett av nyckelorden on eller off. Klausulen legend styr om diagramförklaringen under grafytan ska visas eller döljas. Standardvärdet är att förklaringen visas. När vyn har lästs in kan förklaringens synlighet växlas med knappen Show Legend i dialogrutan Edit→Chart.

5. Global klausul

pmchart stöder en global-klausul för att ange dimensionerna för huvudfönstret, med nyckelorden width och height, antalet synliga punkter med nyckelordet points samt startpositionerna för X- och Y-axeln på skärmen med nyckelorden xpos och ypos.

Varje sådant global-attribut tar ett heltalsvärde som enda kvalificerare.

6. Plottar

Varje chart har en eller flera plottar kopplade till sig, enligt en av följande specifikationer: 

plot
    [legend <title>] [color <colorspec>] [host <hostspec>]
    metric <metricname>
    [ instance <inst> | matching <pat> | not-matching <pat> ]

Nyckelordet plot kan ersättas med optional-plot. Om datakällan då inte innehåller det angivna prestandamätvärdet och/eller instansen tas denna plot tyst bort från diagrammet.

Om en rubrik anges visas den i diagramförklaringen. <title> omges vanligtvis med citattecken och kan innehålla ett eller flera jokertecken som expanderas med mätvärdesnamn, instansnamn och värdnamn för plotten.

Följande jokertecken kan användas:

  • %i – kort unikt instansnamn, fram till första blanktecken
  • %I – fullständigt instansnamn
  • %h – kort värdnamn, fram till första punkten
  • %H – fullständigt värdnamn
  • %m – mätvärdesnamn förkortat till de sista två PMNS-komponenterna
  • %M – fullständigt mätvärdesnamn

För äldre pmchart-konfigurationsfiler måste nyckelordet title användas i stället för legend. Numera stöder pmchart båda nyckelorden.

Klausulen color är valfri för nyare pmchart-konfigurationsfiler, men var obligatorisk i det ursprungliga konfigurationsformatet.

<colorspec> kan vara något av följande: 

#-cycle
rgbi:rr:gg:bb
#rgb
#rrggbb
#rrrgggbbb
#rrrrggggbbbb
<Xcolor>

Varje r, g och b är en hexadecimal siffra, 0–9 eller A–F, som representerar färgkomponenterna rött, grönt respektive blått.

<Xcolor> är ett av färgnamnen från X-färgdatabasen, till exempel red eller steelblue. Se även utdata från showrgb(1).

Färgen #-cycle anger att pmchart ska använda nästa färg i en palett som används cykliskt för varje diagram. Detta är standard om color-klausulen utelämnas.

<hostspec> i host-klausulen kan vara ett värdnamn, en IP-adress eller en asterisk, *. Det senare betyder standardkällan för prestandamätvärden.

För äldre pmchart-konfigurationsfiler måste host-klausulen finnas. För nya pmchart-konfigurationsfiler är den valfri, och om den saknas används standardkällan för prestandamätvärden.

Den valfria instansspecifikationen kan vara något av följande:

Utelämnad
En plot skapas för varje instans av mätvärdet <metricname>.
instance <inst>
Endast instansen med namnet <inst> ritas upp.
matching <pat>
Alla instanser vars namn matchar mönstret <pat> ritas upp. Mönstret använder utökad reguljäruttrycksnotation i stil med egrep(1). Se PMCD-vyn för ett exempel.
not-matching <pat>
Alla instanser vars namn inte matchar mönstret <pat> ritas upp. Mönstret använder utökad reguljäruttrycksnotation i stil med egrep(1). Se Netbytes-vyn för ett exempel.

pmchart använder en ovanlig syntaktisk notation där <inst> och <pat> sträcker sig från det första icke-blanktecknet till slutet av inmatningsraden. För pmchart-konfigurationsfiler är dessa element antingen avgränsade med blanktecken eller omslutna av citattecken.

7. Flikdirektiv

Det valfria direktivet tab kan användas för att skapa vyer med flera diagram som sträcker sig över flera flikar. Syntaxen är: 

tab <label> [host <host>] [points <points> [samples <samples>]]

Alla diagramspecifikationer som följer efter detta nyckelord skapas på den nya fliken, fram till slutet av konfigurationsfilen eller tills ett annat tab-nyckelord påträffas.

PCP-MILJÖ

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

Variabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil, enligt beskrivningen i pcp.conf(5).

Särskilt värt att notera är att inställningen $PCP_XCONFIRM_PROG uttryckligen och ovillkorligen åsidosätts av pmchart. Den sätts till verktyget pmconfirm(1), så att vissa popup-dialoger, särskilt inom området inspelning, behåller ett konsekvent utseende med resten av pmchart-programmet.

FELSÖKNINGSALTERNATIV

Alternativet -D eller --debug aktiverar utskrift av ytterligare diagnostik till stderr för att hjälpa till att analysera problem. Informationen är ibland kryptisk och främst avsedd att ge vägledning till utvecklare snarare än slutanvändare.

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

Felsökningsalternativ som är specifika för pmchart är: 

Alternativ   Beskrivning
appl2        tolkning och inläsning av vyer
appl3        lexikal skanner vid vytolkning

SE ÄVEN

KOLOFON

Den här sidan är en del av projektet PCP – Performance Co-Pilot.

Information om projektet finns på:

Om du har en felrapport för denna manualsida, skicka den till:

  • pcp@groups.io

Denna sida hämtades från projektets uppströms Git-arkiv:

Sidan hämtades den 16 januari 2026. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet den 16 januari 2026.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, känner till en bättre eller mer uppdaterad källa, eller har rättelser eller förbättringar av informationen i denna kolofon, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

  • man-pages@man7.org

Sidor som hänvisar till denna sida

Sidinformation

HTML-renderingen skapades den 16 januari 2026 av Michael Kerrisk, författare till The Linux Programming Interface.

Mer information om Linux- och UNIX-systemprogrammeringskurser finns på:

Sidslut

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

Hämtad från "https://wiki.linux.se/index.php?title=pmchart(1)&oldid=9346"