pmlc(1)

NAMN

pmlc — konfigurera aktiva Performance Co-Pilot-pmlogger-instanser interaktivt

SYNOPSIS

pmlc [-eiPz?] [-D debug] [-h värd] [-n pmnsfil] [-p port]
     [-Z tidszon] [pid]

BESKRIVNING

pmlc kan användas för att ändra vilka mätvärden och instanser som en pmlogger(1) skriver till ett Performance Co-Pilot-arkiv, se PCPIntro(1). Programmet kan också ändra hur ofta mätvärden samlas in och om loggningen är obligatorisk, rådgivande, på eller av.

pmlc rapporterar även aktuell loggningsstatus för mätvärden och instanser. Det kan användas för att styra pmlogger-instanser både på fjärrvärdar och på den lokala värden.

Normalt arbetar pmlc mot det distribuerade Performance Metrics Name Space, PMNS. Om flaggan -n anges läses dock ett alternativt lokalt PMNS in från filen pmnsfil.

Om flaggan -P anges försöker pmlc starta med en anslutning till den primära pmlogger-instansen på den lokala värden. Om flaggan -p anges försöker pmlc starta med en anslutning till pmlogger på den angivna TCP/IP-porten port.

Alternativt, om pid anges, försöker pmlc vid start ansluta till den pmlogger-instans som har detta process-id.

Flaggan -h får endast användas om även -P, -p port eller ett pid anges. I så fall ansluter pmlc inledningsvis till den angivna, eventuellt fjärranslutna, pmlogger-instansen på värd i stället för på den lokala värden.

Om anslutningen till den angivna pmlogger-instansen inte kan upprättas startar pmlc utan anslutning. Dessa flaggor gör det vanligtvis möjligt att rikta samma fil med pmlc-kommandon till flera pmlogger-instanser genom att variera kommandoradsargumenten.

Observera att -P, -p port, pid och -h endast används vid den första anslutningen till en pmlogger-instans. De används inte som standardvärden om senare anslutningar görs interaktivt, se kommandot connect nedan.

Som standard rapporterar pmlc tiden enligt den lokala tidszonen på systemet där pmlc körs. Flaggan -Z ändrar tidszonen till tidszon, i samma format som miljövariabeln TZ, se environ(7). Flaggan -z ändrar tidszonen till tidszonen för den pmlogger-instans som information hämtas från.

Endast en av flaggorna -z och -Z får anges.

Om standard in kommer från en tty körs pmlc interaktivt, med promptar. Flaggan -i kan användas för att tvinga fram interaktivt beteende och används vanligtvis tillsammans med -e för att eka all kommandoindata till standardutdata.

KOMMANDON

Följande kommandon kan användas:

show [ loggers ] [ @ värd ]

Visar process-id för alla pmlogger-instanser som körs på den lokala värden, eller på värd om den anges. Process-id för den primära pmlogger-instansen visas inom parentes eftersom den kan hänvisas till som primary såväl som med sitt process-id.

connect pid [ @ värd ]

connect primary [ @ värd ]

Ansluter pmlc till den angivna pmlogger-processen. Eventuell befintlig anslutning till en pmlogger-instans stängs först.

Varje pmlogger-instans accepterar högst en anslutning åt gången. Om anslutningen lyckas är din pmlc därför den enda som styr den pmlogger-instans den är ansluten till.

new volume

Detta kommando fungerar endast när en anslutning till en pmlogger-instans har upprättats. Det instruerar pmlogger att stänga den aktuella volymen i arkivet och öppna en ny volym.

Stängda volymer kan komprimeras och/eller flyttas till ett fjärrsystem, fjärrlagring eller offline-lagring, exempelvis som en del av en regelbunden arkivhanteringsprocedur för att kontrollera storleken på de fysiska arkivfilerna på systemet där pmlogger körs.

status

Detta kommando fungerar endast när en anslutning till en pmlogger-instans har upprättats. Det skriver ut information om tillståndet för pmlogger-instansen och dess associerade arkiv.

timezone local | logger | " tidszon "

Detta kommando anger vilken tidszon som används när tider skrivs ut.

local betyder att tidszonen på den maskin där pmlc körs används.

logger betyder att tidszonen på den maskin där pmlogger-instansen körs används.

Alternativt kan en uttrycklig tidszon anges inom citattecken. Se TZ i environ(7) för detaljer.

Standardtidszonen är local, om inte någon av flaggorna -z eller -Z har angetts på kommandoraden.

flush

Detta kommando fungerar endast när en anslutning till en pmlogger-instans har upprättats. Det begär att pmlogger-instansen ska tömma alla buffertar som hör till det aktuella arkivet till disk.

För gamla användare är sync en synonym för flush.

I aktuella versioner av pmlogger(1) är alla skrivningar obuffrade och justerade efter de logiska posterna i de externa filerna. Därför gör detta kommando i praktiken ingenting, men det finns kvar av bakåtkompatibilitetsskäl.

disconnect

Koppla bort pmlc från den aktuella pmlogger-instansen, om någon finns.

sleep fördröjning

Pausa pmlc i fördröjning millisekunder. Detta kan vara användbart när pmlc används i skript, så att den aktuella pmlogger-instansen hinner behandla de senaste begärandena innan status frågas.

help

Visar en sammanfattning av tillgängliga kommandon.

h och ? är synonymer för help.

quit

Avslutar pmlc.

De återstående kommandona frågar efter och ändrar loggningstillståndet för mätvärden och instanser. De fungerar endast om pmlc har en anslutning till en pmlogger-instans.

Mätvärden kan anges som fullständigt kvalificerade namn, exempelvis:

hinv.ncpu

eller som delträd i PMNS, exempelvis:

hinv

vilket expanderas till att omfatta alla mätvärden i delträdet, exempelvis:

hinv.ncpu
hinv.cpuclock

Listor med mätvärden kan anges genom att omsluta dem med klamrar och använda mellanslag eller kommatecken mellan mätvärdena:

{hinv.ncpu hinv.ndisk}

Delträd av mätvärden kan ingå i sådana listor.

Varje enskild mätvärdesspecifikation kan dessutom kvalificeras med en mellanslags- eller kommaseparerad lista med instanser inom hakparenteser, exempelvis:

kernel.all.load["1 minute", "5 minute"]

Externa instansnamn, numeriska interna instansidentifierare eller båda kan användas i samma lista, exempelvis:

sample.colour.[red,1,"blue"]

Om en instanskvalificering används på ett delträd i PMNS måste alla mätvärden i delträdet ha samma instansdomän.

Instanskvalificeringar får inte användas på hela listor med mätvärden, men kan förekomma inuti sådana listor.

Om inga instanser anges för ett mätvärde används alla instanser. Alla instanser betyder alla instanser som är tillgängliga vid den tidpunkt då den aktuella pmlogger-instansen hämtar mätvärdena för loggning.

Om en instansdomän ändras över tid är detta inte alltid samma uppsättning instanser som visas av pmlc, eftersom pmlc endast kan visa de instanser som för närvarande är tillgängliga.

För att förhindra oavsiktliga fel får endast de instanser som för närvarande är tillgängliga för pmlc förekomma i instansspecifikationer.

query mätvärdeslista

Visar aktuellt loggningstillstånd för varje mätvärde, och instanser där det är relevant, i mätvärdeslista. Detta omfattar loggningstillstånd, exempelvis on, maybe och off, samt loggningsintervall för varje efterfrågat mätvärde och varje efterfrågad instans.

Följande förkortningar som gäller mätvärden och instanser kan förekomma i utdata:

adv    advisory, rådgivande
mand   mandatory, obligatorisk
nl     not logged, loggas inte och finns inte i arkivet
na     finns i arkivet men är inte för närvarande tillgänglig från sin PMDA

Där det är relevant visas ett instansnamn sist på raden, föregånget av sin numeriska interna instansidentifierare.

[ log ] mandatory on intervall mätvärdeslista

Denna form av kommandot log slår på loggning för mätvärdena, och eventuella instanser, i mätvärdeslista. intervall anger hur ofta de angivna mätvärdena eller instanserna ska loggas.

once anger att mätvärdena eller instanserna ska förekomma högst en gång i arkivet.

Vanligare är att det valfria nyckelordet every används följt av ett positivt tal och en av följande tidsenheter:

millisecond
msec
second
sec
minute
min
hour

eller deras pluralformer.

Observera att nyckelordet default, som kan användas för standardintervallet i en pmlogger(1)-konfigurationsfil, inte kan användas i pmlc.

Interna begränsningar kräver att intervall är mindre än ungefär 74 timmar. Ett intervall-värde på noll är synonymt med once.

[ log ] mandatory off mätvärdeslista

Instruerar pmlogger-instansen att inte arkivera några av mätvärdena eller instanserna i mätvärdeslista.

[ log ] mandatory maybe mätvärdeslista

Instruerar pmlogger-instansen att respektera eventuella senare rådgivande loggningsbegäranden för mätvärdena eller instanserna i mätvärdeslista.

Om det aktuella loggningstillståndet för mätvärdena eller instanserna är obligatoriskt, antingen on eller off, sätts det nya tillståndet till maybe, vilket i praktiken motsvarar rådgivande off.

Om det aktuella tillståndet för mätvärdena eller instanserna redan är rådgivande, antingen on eller off, behålls tillståndet för dessa mätvärden eller instanser.

[ log ] advisory on intervall mätvärdeslista

[ log ] advisory off mätvärdeslista

Rådgivande loggning är endast tillämplig om det senaste loggningstillståndet som angavs för ett mätvärde eller en instans var mandatory maybe, vilket tillåter senare rådgivande loggningsstyrning, eller om loggningstillståndet redan är rådgivande.

Dessa två kommandon slår på respektive av rådgivande loggning för de angivna mätvärdena eller instanserna.

Tolkningen av intervall är densamma som ovan för mandatory-fallet.

Inget fortsättningstecken krävs för kommandon som sträcker sig över flera rader.

Ordet at kan användas på samma sätt som @.

En begäran om att arkivera alla instanser av ett mätvärde ersätter tidigare begäran om att logga antingen alla eller specifika instanser av ett mätvärde, om begäran anger en tillåten övergång i loggningstillståndet.

En begäran om att arkivera specifika instanser av ett mätvärde när alla instanser av mätvärdet redan loggas avslås av pmlogger.

FLAGGOR

Tillgängliga kommandoradsflaggor är:

-e, --echo

Eka all kommandoindata till standardutdata.

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

Anslut till pmlogger på värd i stället för på standardvärden localhost.

-i, --interactive

Tvinga fram interaktivt beteende.

-n pmnsfil, --namespace= pmnsfil

Läs in ett alternativt Performance Metrics Name Space, PMNS(5), från filen pmnsfil.

-p port, --port= port

Anslut till den primära pmlogger-instansen på TCP/IP-porten port.

-P, --primary

Anslut till den primära pmlogger-instansen.

-z, --logzone

Använd den lokala tiden för pmlogger som rapporteringstidszon.

-Z tidszon, --timezone= tidszon

Använd tidszon för datum och tid. tidszon anges i samma format som miljövariabeln TZ, se environ(7).

-?, --help

Visa användningsmeddelande och avsluta.

ÅTKOMSTKONTROLL

pmlc kan ha begränsad åtkomst till och kontroll över pmlogger(1)-processer.

Om en pmlogger(1) inte kan exportera sin kontrollinformation till den lokala pmcd(1), kan denna pmlogger(1) varken anslutas till eller styras av pmlc.

I praktiken betyder detta att pmlogger(1)-processen måste ägas av användaren pcp och/eller gruppen pcp.

Om pmlogger(1) körs på värden foo, använd följande kommando för att kontrollera att den aktuella pmlogger(1)-instansen är känd av pmcd(1):

pmlc-kommando	Nödvändig åtkomst till pmlogger
show loggers	Valfri
connect	Någon av enquire, advisory eller mandatory
status	Någon av enquire, advisory eller mandatory
query ...	Någon av enquire, advisory eller mandatory
disconnect	Valfri
log advisory ...	advisory
log mandatory ...	mandatory
new volume	mandatory

pminfo -f -h foo pmcd.pmlogger

Alternativt gäller att pmlogger(1)-instanser som inte rapporteras av kommandot:

pmlc show loggers @foo

inte är kända av pmcd(1) på värden foo.

Om pmlogger(1) startas med en konfigurationsfil som innehåller ett [access]-avsnitt, kan pmlc inte ansluta till denna pmlogger(1) om inte åtkomstkontrollerna tillåter någon form av åtkomst från den värd där pmlc körs.

Som minimum krävs att enquire-åtkomst tillåts i åtkomstkontrollavsnittet för pmlogger(1).

Om pmlc kan ansluta till den aktuella pmlogger(1)-instansen sammanfattar följande tabell vilka behörigheter som krävs för olika pmlc-kommandon:

VARNINGAR

Om alla instanser av ett mätvärde loggas och en begäran görs om att logga specifika instanser av mätvärdet med samma tillstånd och frekvens, kan begäran se ut att lyckas även om pmlogger har avvisat den.

Detta är normalt inget problem, eftersom den begärda informationen ändå placeras i arkivet av pmlogger.

I fallet där mätvärdet ska loggas en gång blir resultatet dock inte nödvändigtvis det förväntade. När pmlogger tar emot en begäran om att arkivera ett mätvärde en gång, placerar den de aktuella värdena för mätvärdet i arkivet så snart den kan, oavsett om mätvärdet redan finns i arkivet.

Detta kan användas för att tvinga in värden i arkivet.

När en begäran om att arkivera specifika instanser av ett mätvärde kommer in och avslås därför att alla instanser av mätvärdet redan loggas, placerar pmlogger inte värden för de begärda instanserna i arkivet. Den returnerar i stället aktuellt loggningstillstånd för varje begärd instans till pmlc.

De begärda och returnerade tillstånden är identiska, så pmlc rapporterar inte ett fel trots att det borde göra det.

För att säkerställa att endast vissa instanser av ett mätvärde loggas bör man alltid först stänga av loggning för alla instanser av mätvärdet och därefter slå på loggning för de specifika instanser som krävs.

DIAGNOSTIK

De flesta fel- och varningsmeddelanden är självförklarande.

Ett meddelande av formen:

Warning: unable to change logging state for...

följt av en lista med mätvärden, och eventuellt instanser, anger att pmlogger avvisade begäran för de mätvärden eller instanser som visas.

Alla mätvärden eller instanser som angavs men inte förekommer i meddelandet har fått sitt loggningstillstånd uppdaterat utan problem. Inga nyheter är goda nyheter.

Vanligtvis beror denna varning på att rådgivande loggning begärs när en obligatorisk styrning redan finns, eller på att loggning begärs för specifika instanser när alla instanser redan loggas.

MILJÖ

Om miljövariabeln PMLOGGER_REQUEST_TIMEOUT inte är satt, eller är satt till 0, blockerar pmlc tills en anslutning har upprättats med pmlogger(1) på den begärda porten.

Om PMLOGGER_REQUEST_TIMEOUT sätts till ett värde större än noll, misslyckas pmlc med ett fel efter detta antal sekunder om en anslutning inte har upprättats.

Detta kan användas av administrativa skript, såsom pmlogger_daily(1), för att polla pmlogger när den startar tills den är redo och lyssnar på sin kontrollport.

PCP-MILJÖ

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

FELSÖKNINGSFLAGGOR

Flaggan -D eller --debug aktiverar ytterligare diagnostik på stderr för att hjälpa till att analysera problem. Informationen kan dock ibland vara kryptisk och är främst avsedd att ge vägledning för utvecklare snarare än slutanvändare.

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

Felsökningsflaggor specifika för pmlc är följande:

Flagga								SE ÄVEN PCPIntro(1), pmcd(1), pmlogdump(1), pmlogger(1), pcp.conf(5), pcp.env(5), PMNS(5) och environ(7). COLOPHON Denna sida är en del av projektet PCP — Performance Co-Pilot. Information om projektet finns på: http://www.pcp.io/ 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: https://github.com/performancecopilot/pcp.git 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, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar av informationen i detta COLOPHON-avsnitt, som inte är en del av den ursprungliga manualsidan, skicka e-post till: man-pages@man7.org Performance Co-Pilot PCP PMLC(1) Sidslut Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pmlc.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 Datorservice som har sponsrat Linux.se med webbhotell.