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å:

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