pmlogger_check - Online in de cloud

PROGRAMMA:

NAAM

pmlogger_check, pmlogger_dagelijks, pmlogger_samenvoegen - administratie van Performance Co-Pilot
logbestanden archiveren

KORTE INHOUD

$PCP_BINADM_DIR/pmlogger_check [-CNsTV] [-c onder controle te houden] [-l logfile]
$PCP_BINADM_DIR/pmlogger_daily [-NorV] [-c onder controle te houden] [-k afdanken] [-l logfile] [-m
adressen] [-s lengte van de duwkabel] [-t willen] [-x samendrukken] [-X programma] [-Y regex]
$PCP_BINADM_DIR/pmlogger_merge [-fNV] [invoer-basisnaam ... uitvoernaam]

PRODUCTBESCHRIJVING

Deze reeks shell-scripts en bijbehorende besturingsbestanden kunnen worden gebruikt om een
maatwerk regime van administratie en beheer voor Performance Co-Pilot (zie
PCPintro(1)) logbestanden archiveren.

pmlogger_dagelijks is bedoeld om eenmaal per dag te worden uitgevoerd, bij voorkeur in de vroege ochtend, zoals
zo snel mogelijk na middernacht. Het is zijn taak om een ​​of meer sets samen te voegen en te roteren
van PCP-archieven. Na verloop van tijd worden oude PCP-archieven weggegooid. Deze periode is 14
dagen standaard, maar kan worden gewijzigd met behulp van de -k keuze. Twee bijzondere waarden worden herkend
voor de periode (afdanken), namelijk 0 om geen archieven bij te houden buiten de huidige, en altijd
om te voorkomen dat archieven worden weggegooid.

Archiefgegevensbestanden kunnen optioneel na enige tijd worden gecomprimeerd om schijfruimte te besparen.
Dit is vooral handig voor grote aantallen pmlogger processen onder controle van
pmlogger_check. Standaard wordt er niet gecomprimeerd. De -x optie maakt compressie en
specificeert het aantal dagen waarna archiefgegevensbestanden moeten worden gecomprimeerd, en de -X optie
specificeert het programma dat voor compressie moet worden gebruikt - standaard is dit xz(1). Gebruik van de -Y
optie maakt het mogelijk een reguliere expressie op te geven die bestanden in de set bestanden veroorzaakt
overeenkomen voor weglaten van compressie - hierdoor kan alleen het gegevensbestand worden gecomprimeerd,
en voorkomt ook dat het programma het meer dan eens probeert te comprimeren. De standaard
regex is ".(meta|index|Z|gz|bz2|zip|xz|lzma|lzo|lz4)$" - dergelijke bestanden worden gefilterd met behulp van de
-v optie om egr(1).

Om tegemoet te komen aan de evolutie van PMDA's en veranderingen in productieregistratieomgevingen,
pmlogger_dagelijks is geïntegreerd met pmlogherschrijven(1) om optioneel en automatisch toe te staan
herschrijven van archieven voor het samenvoegen. Als er globale herschrijfregels zijn die moeten worden toegepast
in alle archieven die in het controlebestand(en) worden vermeld, en maak vervolgens de directory
$PCP_SYSCONF_DIR/pmlogrewrite en plaats een pmlogherschrijven(1) regels hierin herschrijven
map. Gebruik voor het herschrijven van regels die specifiek zijn voor slechts één archieffamilie de
directorynaam uit het besturingsbestand(en) - dwz de vierde veld - en maak een bestand aan, of een
directory of een symbolische koppeling met de naam pmlogherschrijven in deze map en plaats de
vereiste herschrijfregel(en) in de pmlogherschrijven bestand of in bestanden binnen de pmlogherschrijven
submap. pmlogger_dagelijks kiest herschrijfregels uit de archiefdirectory if
ze bestaan, anders herschrijven regels van $PCP_SYSCONF_DIR/pmlogrewrite als die map
bestaat, anders wordt er niet geprobeerd te herschrijven.

De -r opdrachtregeloptie werkt als een override en voorkomt dat alle archieven worden herschreven
pmlogherschrijven(1) onafhankelijk van de aanwezigheid van bestanden of mappen met herschrijfregels.

Standaard worden alle mogelijke archieven samengevoegd. De -o optie herstelt het oude
gedrag waarbij alleen de archieven van gisteren worden beschouwd als samenvoegingskandidaten.

In het speciale geval dat slechts één invoerarchief moet worden samengevoegd, pmlogmv(1) zijn
gebruikt om het archief te hernoemen, in plaats van het invoerarchief te kopiëren met pmlogger_samenvoegen.

De -M optie kan worden gebruikt om het samenvoegen (of hernoemen) en herschrijven van archieven (-M
impliceert -r). Dit is vooral handig in gevallen waarin de archieven stapsgewijs worden opgeslagen
gekopieerd naar een externe repository, bijvoorbeeld met behulp van rsync(1). Alles samenvoegen, hernoemen en herschrijven
risico op een toename van de synchronisatiebelasting, vooral direct daarna pmlogger_dagelijks
is gelopen, dus -M kan in deze gevallen nuttig zijn.

Om te helpen bij het debuggen of diagnosticeren van intermitterende storingen, is het -t optie kan worden gebruikt.
Dit zal zeer uitgebreide tracering inschakelen (-VV) en leg de trace-uitvoer vast in een bestand met de naam
$PCP_LOG_DIR/pmlogger/dagelijks.datumstempel.spoor, met de meeste datumstempel is de tijd pmlogger_dagelijks
werd uitgevoerd in het formaat JJJJMMDD.UU.MM. tevens de willen argumenten zullen daar voor zorgen
trace-bestanden gemaakt met -t zal worden bewaard voor willen dagen en dan weggegooid.

Bovendien, als het PCP ``notices''-bestand ($PCP_LOG_DIR/MELDINGEN) is groter dan 20480
bytes, pmlogger_dagelijks zal het bestand hernoemen met het achtervoegsel ``.old'' en een nieuw bestand starten
``meldingen'' bestand. De rotatiedrempel kan worden gewijzigd van 20480 in lengte van de duwkabel bytes met behulp van de
-s optie.

Gebruik van de -m optie oorzaken pmlogger_dagelijks om een ​​samenvatting te maken van het bestand ``meldingen''
vermeldingen die in de afgelopen 24 uur zijn gegenereerd, en e-mail die samenvatting naar de set van
ruimtegescheiden adressen. Dit dagoverzicht wordt in het dossier opgeslagen
$PCP_LOG_DIR/NOTICES.dagelijks, die leeg zal zijn als er geen nieuwe invoer voor ``aankondigingen'' is gemaakt
in de afgelopen 24 uur.

Het script $PCP_BINADM_DIR/pmlogger_daily kan worden gekopieerd en gewijzigd om een
locatiespecifieke procedure voor beheer aan het einde van de week en/of aan het einde van de maand voor een set PCP
archieven.

pmlogger_check kan op elk moment worden uitgevoerd en is bedoeld om te controleren of de gewenste set van
pmlogger(1) processen worden uitgevoerd, en zo niet om eventuele mislukte loggers opnieuw te starten. Gebruik van de
-s optie biedt de omgekeerde functionaliteit, waardoor de set van pmlogger processen om te zijn
netjes afsluiten. Gebruik van de -C optie vraagt ​​de runlevel-informatie van de systeemservice op
voor pmlogger, en gebruikt dat om te bepalen of processen moeten worden gestart of gestopt.

De -T optie biedt een kortere vorm van uitvoer voor pmlogger_check dat is het meest geschikt
voor een pmlogger ``boerderij'' waar veel voorbeelden van pmlogger worden naar verwachting uitgevoerd.

pmlogger_samenvoegen is een wrapper-script voor pmlog-extract(1) die alle archieflogboeken samenvoegt
overeenkomen met de invoer-basisnaam argumenten en maakt een nieuw archief aan met behulp van uitvoernaam de
basisnaam voor de fysieke bestanden die een archieflogboek vormen. De invoer-basisnaam
argumenten kunnen metatekens bevatten in de stijl van sh(1). Indien gespecificeerd, de -f optie
zorgt ervoor dat alle invoerbestanden worden verwijderd zodra het uitvoerarchief is gemaakt.

pmlogger_samenvoegen wordt gebruikt door pmlogger_dagelijks.

Beiden pmlogger_dagelijks en pmlogger_check worden bestuurd door PCP-loggerbesturingsbestand(en) dat
specificeert de pmlogger gevallen te beheren. Het standaard controlebestand is
$PCP_PMLOGGERCONTROL_PATH, maar een alternatief kan worden opgegeven met behulp van de -c optie. Als de
directory $PCP_PMLOGGERCONTROL_PATH.d (of onder controle te houden.d van de -c optie) bestaat, dan is de
de inhoud van eventuele aanvullende controlebestanden daarin zal worden toegevoegd aan het hoofdcontrolebestand
(die moet bestaan).

waarschuwingDe $PCP_PMLOGGERCONTROL_PATH en $PCP_PMLOGGERCONTROL_PATH.d-bestanden mogen dat niet zijn
beschrijfbaar door elke andere gebruiker dan root.

De controlebestanden moeten worden aangepast volgens de volgende regels die definiëren voor
de huidige versie (1.1) van het besturingsbestandsformaat.

1. Regels die beginnen met een ``#'' zijn opmerkingen.
2. Regels die beginnen met een ``$'' worden verondersteld toewijzingen te zijn aan omgevingsvariabelen in
de stijl van sh(1), en alle tekst na de ``$'' zal zijn eval'ed door het script
het besturingsbestand lezen en de bijbehorende variabele geëxporteerd naar het
omgeving. Dit is met name handig om variabelen in te stellen en te exporteren naar het
omgeving van de administratieve scripts, bv
$PMCD_CONNECT_TIMEOUT=20
3. Daar Dan moet je een versieregel zijn in het initiële controlebestand van het formulier:
$ versie=1.1
4. Er moet voor elk één regel in het controlebestand(en) staan pmlogger exemplaar van de
het formulier:

gastheer y|n y|n directory betoogt

5. Velden binnen een regel van het controlebestand(en) worden meestal gescheiden door een of meer
spaties of tabs (raadpleeg echter de beschrijving van het directory veld voor sommigen
belangrijke uitzonderingen).
6. De eerste veld is de naam van de host die de bron is van de prestatiestatistieken
hiervoor pmlogger aanleg.
7. De tweede veld geeft aan of dit een primair pmlogger voorbeeld (y) of niet (n).
Omdat de primaire logger op de lokale host moet draaien, en dat mag er maximaal één zijn
primaire logger voor een bepaalde host kan dit veld zijn y voor hoogstens één pmlogger
instantie, in welk geval de hostnaam de naam van de lokale host moet zijn.
8. De derde veld geeft aan of dit pmlogger instantie moet worden gestart onder de
controle pmsokken(1) om verbinding te maken met een pmcd via een firewall (y or n).
9. De vierde veld is een mapnaam. Alle bestanden die hiermee verband houden pmlogger
instantie wordt in deze map gemaakt en dit wordt de huidige map voor
de uitvoering van alle programma's die nodig zijn voor het onderhoud van die archieven. Een nuttige
conventie is dat primaire logger-archieven voor de lokale host met hostnaam mijn gastheer zijn
bijgehouden in de directory $PCP_LOG_DIR/pmlogger/mijn gastheer (dit is waar de standaard
pmlogger opstartscript erin $PCP_RC_DIR/pcp zal de archieven maken), terwijl archives
voor de externe host mompelen worden bijgehouden $PCP_LOG_DIR/pmlogger/mompelen.
10. Het directoryveld kan een ingesloten shell-syntaxis bevatten die wordt geëvalueerd door sh(1)
om de echte mapnaam te produceren die moet worden gebruikt. De toegestane constructies zijn:
· Elke tekst (inclusief witruimte) die wordt omsloten door $( en ).
· Elke tekst (inclusief witruimte) die wordt omsloten door ` en ` (terug aanhalingstekens).
· Elke tekst (inclusief witruimte) die wordt omsloten door " en " (dubbele aanhalingstekens).
· Elk woord met een $ (aangenomen om de naam van een omgevingsvariabele te introduceren).
11. Alle andere velden worden geïnterpreteerd als argumenten waaraan moet worden doorgegeven pmlogger(1) en/of
pmnieuwlog(1). Meestal is dit de -c optie.

De volgende voorbeeldcontroleregels specificeren een primaire logger op de lokale host (bozo), En
niet-primaire loggers om prestatiestatistieken van de hosts te verzamelen en te loggen wiebelen en
boing.

$versie=1.1
bozo in $PCP_LOG_DIR/pmlogger/bozo -c config.default
wankel nn "/store/wobbly/$(datum +%Y)" -c ./wobbly.config
boing nn $PCP_LOG_DIR/pmlogger/boing -c ./pmlogger.config

Typisch crontab(5) vermeldingen voor periodieke uitvoering van pmlogger_dagelijks en pmlogger_check zijn
gegeven in $PCP_SYSCONF_DIR/pmlogger/crontab (tenzij standaard geïnstalleerd in /etc/cron.d
al) en hieronder weergegeven.

# dagelijkse verwerking van archieflogs
14 0 * * * $PCP_BINADM_DIR/pmlogger_daily
# Controleer elke 30 minuten of pmlogger-instanties actief zijn
25,55 * * * * $PCP_BINADM_DIR/pmlogger_check

Om ervoor te zorgen dat er niet onbedoeld mail wordt verzonden wanneer deze scripts worden uitgevoerd
cron(8) diagnostiek wordt altijd naar een logbestand gestuurd. Standaard is dit bestand
$PCP_LOG_DIR/pmlogger/pmlogger_daily.log or $PCP_LOG_DIR/pmlogger/pmlogger_check.log maar
dit kan worden gewijzigd met behulp van de -l keuze. Als dit logbestand al bestaat wanneer het script
begint, wordt het hernoemd met een .vorige achtervoegsel (overschrijven van een eerder opgeslagen logbestand)
voordat diagnostische gegevens naar het logbestand worden gegenereerd. De -l en -t opties kunnen niet worden gebruikt
samen.

De uitvoer van de cron uitvoering van de scripts kan worden uitgebreid met behulp van de -V optie om
de scripts die uitgebreide tracering van hun activiteit mogelijk maken. Standaard de scripts
genereren geen uitvoer tenzij er een fout of waarschuwing optreedt.

Gebruik pmlogger_check online met behulp van onworks.net-services