pmlogger check(1)
NAMN
pmlogger_check — administration av Performance Co-Pilot-arkivfiler
SYNOPSIS
$PCP_BINADM_DIR/pmlogger_check [-CNnPpqsTV?] [-c control] [-l loggfil]
BESKRIVNING
pmlogger_check och de relaterade verktygen pmlogger_daily(1), tillsammans med tillhörande kontrollfiler, se pmlogger.control(5), kan användas för att skapa ett anpassat system för administration och hantering av historiska arkiv med prestandadata inom Performance Co-Pilot-infrastrukturen, se PCPIntro(1).
pmlogger_check kan köras när som helst på dagen och är avsett att kontrollera att en önskad uppsättning pmlogger(1)-processer körs. Om så inte är fallet startar eller startar det om saknade loggningsprocesser.
Som standard anropar pmlogger_check även pmlogger_daily(1) med flaggan -K för att utföra eventuella arkivkomprimeringsuppgifter som krävs.
FLAGGOR
-C
Denna flagga gör att pmlogger_check frågar systemets tjänste- och körnivåinformation för pmlogger och använder detta för att avgöra om processer ska startas eller inte.
-c control, --control= control
Både pmlogger_check och pmlogger_daily(1) styrs av PCP-loggningskontrollfiler som anger vilka pmlogger-instanser som ska hanteras.
Standardfilen control är:
$PCP_PMLOGGERCONTROL_PATH
men en alternativ fil kan anges med flaggan -c.
Om katalogen:
$PCP_PMLOGGERCONTROL_PATH.d
eller:
control.d
från flaggan -c finns, läggs innehållet i eventuella ytterligare control-filer där till i huvudkontrollfilen. Huvudkontrollfilen måste finnas.
-l fil, --logfile= fil
För att säkerställa att e-post inte skickas oavsiktligt när dessa skript körs från cron(8) eller systemd(1) skickas diagnostik alltid till loggfiler.
Som standard är denna fil:
$PCP_LOG_DIR/pmlogger/pmlogger_check.log
men detta kan ändras med flaggan -l.
Om denna loggfil redan finns när skriptet startar byts dess namn till ett namn med suffixet .prev, vilket skriver över eventuell tidigare sparad loggfil, innan diagnostik skrivs till den nya loggfilen.
Flaggorna -l och -t kan inte användas tillsammans.
-N, --showme
Aktiverar ett ”visa mig”-läge där åtgärderna skrivs ut men inte utförs, på samma sätt som:
make -n
Att använda -N tillsammans med -V maximerar diagnostikmöjligheterna vid felsökning.
-n, --noerror
Tvingar avslutningsstatusen att vara 0, utom vid katastrofala fel.
Detta är användbart när kommandot anropas från en systemd(1)-tjänst eller timerenhet, så att den tillhörande enheten inte markeras som misslyckad på ett sätt som skulle hindra senare körningar från systemd(1).
-P, --only-primary
Om denna flagga anges för pmlogger_check behandlas endast posten för den primära loggaren i kontrollfilerna.
Detta är den logiska motsatsen till flaggan -p som beskrivs nedan och är avsett för RC-skript som endast startar den primära loggaren, till exempel enheten:
pmlogger.service
Flaggorna -p och -P kan inte användas tillsammans.
-p, --skip-primary
Om denna flagga anges för pmlogger_check ignoreras varje rad i kontrollfilerna som avser den primära pmlogger.
Denna flagga är avsedd för miljöer där någon systemdemon, till exempel systemd(1), ansvarar för att styra den primära pmlogger-processen, till exempel starta, stoppa och starta om den.
-q, --quick
Om denna flagga anges för pmlogger_check snabbstartar skriptet och undviker valfri extra bearbetning, till exempel att anropa pmlogger_daily(1) för att utföra arkivkomprimeringsuppgifter.
-s, --stop
Denna flagga ger motsatt funktion mot normal pmlogger_check-körning och gör det möjligt att stänga av uppsättningen av pmlogger-processer på ett rent sätt.
-T, --terse
Denna flagga gör att pmlogger_check producerar mindre utförlig utdata än standardläget.
Detta är mest lämpligt för en pmlogger-”farm” där många instanser av pmlogger förväntas köras.
-V, --verbose
Flaggan -V aktiverar utförlig spårning.
Som standard genererar pmlogger_check ingen utdata om inte ett fel- eller varningstillstånd uppstår. En andra -V ökar utförligheten.
Att använda -N tillsammans med -V maximerar diagnostikmöjligheterna vid felsökning.
-?, --help
Visa användningsmeddelande och avsluta.
KONFIGURATION
Se pmlogger.control(5) för en beskrivning av de kontrollfiler som används för att styra vilka pmlogger-instanser och vilka arkiv som hanteras av pmlogger_check och pmlogger_daily(1).
Verktyget pmlogctl(1) kan anropa pmlogger_check med kommandot sudo(1) för att köra det under PCP-användarkontot pcp, det vill säga $PCP_USER.
Om sudo är konfigurerat med den icke-standardmässiga flaggan requiretty, se nedan, kan pmlogger_check misslyckas eftersom ingen tty är konfigurerad. Detta kan lösas genom att lägga till en andra rad i konfigurationsfilen:
/etc/sudoers
Expandera $PCP_BINADM_DIR enligt din plattform:
Defaults requiretty Defaults!$PCP_BINADM_DIR/pmlogger_check !requiretty
Observera att det oprivilegierade PCP-kontot som dessa kommandon körs under använder:
/sbin/nologin
som skal. Därför är flaggan requiretty ineffektiv här och säker att inaktivera på detta sätt.
FILER
$PCP_VAR_DIR/config/pmlogger/config.default
Standardplats för konfigurationsfilen för den lokala primära pmlogger-loggaren. Den genereras normalt automatiskt av pmlogconf(1).
$PCP_ARCHIVE_DIR/<värdnamn>
Standardplats för arkiv med prestandainformation insamlad från värden värdnamn.
$PCP_ARCHIVE_DIR/<värdnamn>/lock
Tillfällig låsfil som garanterar ömsesidig uteslutning under administration av pmlogger för värden värdnamn.
Om den finns kan den tas bort säkert om varken pmlogger_daily(1) eller pmlogger_check körs.
$PCP_ARCHIVE_DIR/<värdnamn>/Latest
PCP-arkivfolio skapad av mkaf(1) för det senast startade arkivet som innehåller prestandamätvärden från värden värdnamn.
$PCP_LOG_DIR/NOTICES
PCP:s ”notices”-fil som används av pmie(1) och relaterade verktyg.
$PCP_LOG_DIR/pmlogger/pmlogger_check.log
Om den föregående körningen av pmlogger_check producerade någon utdata sparas den här.
I normalfallet finns ingen utdata, och då finns inte filen.
$PCP_ARCHIVE_DIR/SaveLogs
Om denna katalog finns sparas loggfilen från argumentet -l till pmlogger_check i denna katalog med ett namn i formatet:
<datum>-pmlogger_check.log.<pid>
Detta gör det möjligt att granska loggfilen senare, även om flera pmlogger_check-körningar har startats under tiden.
Eftersom PCP:s arkivhanteringsverktyg körs under kontot $PCP_USER, alltså användaren pcp, behöver:
$PCP_ARCHIVE_DIR/SaveLogs
vanligen ägas av användaren pcp.
$PCP_ARCHIVE_DIR/<värdnamn>/SaveLogs
Om denna katalog finns sparas loggfilen från argumentet -l för en nystartad pmlogger(1) för värdnamn i denna katalog med namnet:
arkiv.log
där arkiv är basnamnet för de PCP-arkivfiler som hör till pmlogger(1).
Detta gör det möjligt att granska loggfilen senare, även om flera pmlogger(1)-instanser för värdnamn har startats under tiden.
Eftersom PCP:s arkivhanteringsverktyg körs under kontot $PCP_USER, alltså användaren pcp, behöver:
$PCP_ARCHIVE_DIR/<värdnamn>/SaveLogs
vanligen ägas av användaren pcp.
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).
Standardbeteendet, när pmlogger(1)-konfigurationen kommer från pmlogconf(1), är att konfigurationsfilen genereras om och kontrolleras för ändringar varje gång pmlogger(1) startas från pmlogger_check.
Om PMDA-konfigurationen är stabil behövs inte detta. Genom att sätta:
$PMLOGGER_CHECK_SKIP_LOGCONF
till:
yes
inaktiveras regenerering och kontroll.
SE ÄVEN
mkaf(1), PCPIntro(1), pmie(1), pmlc(1), pmlogconf(1), pmlogctl(1), pmlogger(1), pmlogger_daily(1), pmlogger_daily_report(1), pmlogger_janitor(1), sudo(1), systemd(1), pmlogger.control(5) och cron(8).
COLOPHON
Denna sida ä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:
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 PMLOGGER_CHECK(1)
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pmlogger_check.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 hemma som har sponsrat Linux.se med webbhotell.