pmlogger_check – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pmlogger_check, pmlogger_daily, pmlogger_merge - Verwaltung von Performance Co-Pilot
Protokolldateien archivieren

ZUSAMMENFASSUNG

$PCP_BINADM_DIR/pmlogger_check [-CNsTV] [-c Smartgeräte App] [-l Logdatei]
$PCP_BINADM_DIR/pmlogger_daily [-NorV] [-c Smartgeräte App] [-k verwerfen] [-l Logdatei] [-m
Adressen] [-s Größe] [-t wollen] [-x komprimieren] [-X Programm] [-Y Regex]
$PCP_BINADM_DIR/pmlogger_merge [-fNV] [Eingabebasisname ... Ausgabename]

BESCHREIBUNG

Diese Reihe von Shell-Skripten und zugehörigen Steuerdateien kann zum Erstellen eines verwendet werden
Maßgeschneidertes Verwaltungs- und Managementsystem für Performance Co-Pilot (siehe
PCPintro(1)) Archivprotokolldateien.

pmlogger_daily soll einmal täglich, vorzugsweise am frühen Morgen, durchgeführt werden
möglichst bald nach Mitternacht. Seine Aufgabe besteht darin, einen oder mehrere Sätze zu aggregieren und zu rotieren
von PCP-Archiven. Nach einiger Zeit werden alte PCP-Archive verworfen. Dieser Zeitraum beträgt 14
Tage standardmäßig, kann aber mithilfe von geändert werden -k Möglichkeit. Es werden zwei besondere Werte erkannt
für den Zeitraum (verwerfen), nämlich 0 keine Archive über das aktuelle hinaus zu behalten, und für immer
um zu verhindern, dass Archive verworfen werden.

Archivdatendateien können optional nach einiger Zeit komprimiert werden, um Speicherplatz zu sparen.
Dies ist besonders bei einer großen Anzahl nützlich PMlogger Prozesse unter der Kontrolle von
pmlogger_check. Standardmäßig wird keine Komprimierung durchgeführt. Der -x Option ermöglicht Komprimierung und
Gibt die Anzahl der Tage an, nach denen Archivdatendateien komprimiert werden sollen, und die -X ganz ohne irgendetwas tun oder drücken zu müssen.
Gibt das Programm an, das für die Komprimierung verwendet werden soll – standardmäßig ist dies der Fall xz(1). Nutzung der -Y
Mit der Option kann ein regulärer Ausdruck angegeben werden, der Dateien in der Dateigruppe verursacht
angepasst, damit die Komprimierung weggelassen wird – dadurch kann nur die Datendatei komprimiert werden.
und verhindert außerdem, dass das Programm versucht, es mehr als einmal zu komprimieren. Der Standard
Regex ist „.(meta|index|Z|gz|bz2|zip|xz|lzma|lzo|lz4)$“ – solche Dateien werden mit gefiltert
-v Option zu egrep(1).

Um der Entwicklung von PMDAs und Änderungen in Produktionsprotokollierungsumgebungen Rechnung zu tragen,
pmlogger_daily ist integriert mit pmlogrewrite(1) um optional und automatisch zu ermöglichen
Neuschreiben von Archiven vor dem Zusammenführen. Wenn globale Umschreibungsregeln anzuwenden sind
über alle in den Steuerdateien genannten Archive und erstellen Sie dann das Verzeichnis
$PCP_SYSCONF_DIR/pmlogrewrite und platzieren Sie beliebige pmlogrewrite(1) Regeln hier umschreiben
Verzeichnis. Zum Umschreiben von Regeln, die nur für eine Archivfamilie gelten, verwenden Sie die
Verzeichnisname aus der/den Steuerdatei(en) - also der vierte Feld - und erstellen Sie eine Datei oder eine
Verzeichnis oder ein symbolischer Link mit dem Namen pmlogrewrite in diesem Verzeichnis und platzieren Sie die
erforderliche Umschreibungsregel(n) in der pmlogrewrite Datei oder in Dateien innerhalb der pmlogrewrite
Unterverzeichnis. pmlogger_daily wählt die Umschreiberegeln aus dem Archivverzeichnis aus, wenn
Sie existieren, sonst werden Regeln neu geschrieben $PCP_SYSCONF_DIR/pmlogrewrite wenn dieses Verzeichnis
existiert, andernfalls wird kein Umschreiben versucht.

Das -r Die Befehlszeilenoption fungiert als Überschreibung und verhindert das Neuschreiben von Archiven
pmlogrewrite(1) unabhängig vom Vorhandensein von Regeldateien oder Verzeichnissen zum Umschreiben.

Standardmäßig werden alle möglichen Archive zusammengeführt. Der -o Option stellt die alte wieder her
Verhalten, bei dem nur die Archive von gestern als Zusammenführungskandidaten berücksichtigt werden.

Im Sonderfall, dass nur ein einziges Eingabearchiv zusammengeführt werden muss, pmlogmv(1) ist
Wird zum Umbenennen des Archivs verwendet, anstatt das Eingabearchiv zu kopieren pmlogger_merge.

Das -M Die Option kann verwendet werden, um das Zusammenführen (oder Umbenennen) und Umschreiben von Archiven zu deaktivieren (-M
impliziert -r). Dies ist besonders nützlich, wenn die Archive inkrementell erstellt werden
in ein Remote-Repository kopiert, z. B. mit rsync(1). Alles zusammenführen, umbenennen und neu schreiben
besteht die Gefahr einer Erhöhung der Synchronisationslast, insbesondere unmittelbar danach pmlogger_daily
ist gelaufen, also -M kann in diesen Fällen nützlich sein.

Zur Unterstützung beim Debuggen oder Diagnostizieren zeitweise auftretender Fehler -t Option kann verwendet werden.
Dadurch wird eine sehr ausführliche Ablaufverfolgung aktiviert (-VV) und erfassen Sie die Trace-Ausgabe in einer Datei mit dem Namen
$PCP_LOG_DIR/pmlogger/daily.Datumsstempel.verfolgen, woher Datumsstempel ist die Zeit pmlogger_daily
wurde im Format JJJJMMTT.HH.MM ausgeführt. zusätzlich wollen Das Argument wird dafür sorgen
Trace-Dateien erstellt mit -t wird aufbewahrt wollen Tage und dann entsorgt.

Wenn außerdem die PCP-„Notizen“-Datei ($PCP_LOG_DIR/NOTICES) ist größer als 20480
Bytes, pmlogger_daily benennt die Datei mit dem Suffix „.old“ um und beginnt eine neue
„Notices“-Datei. Der Rotationsschwellenwert kann von 20480 auf geändert werden Größe Bytes mit der
-s .

Verwendung der -m Option verursacht pmlogger_daily um eine Zusammenfassung der „Benachrichtigungen“-Datei zu erstellen
Einträge, die in den letzten 24 Stunden generiert wurden, und senden Sie diese Zusammenfassung per E-Mail an den Satz von
durch Leerzeichen getrennt Adressen. Diese tägliche Zusammenfassung wird in der Datei gespeichert
$PCP_LOG_DIR/NOTICES.daily, das leer ist, wenn keine neuen „Benachrichtigungen“-Einträge vorgenommen wurden
im letzten 24-Stunden-Zeitraum.

Das Skript $PCP_BINADM_DIR/pmlogger_daily könnte kopiert und geändert werden, um a zu implementieren
Standortspezifisches Verfahren für die Wochen- und/oder Monatsendverwaltung für einen PCP-Satz
Archiv.

pmlogger_check kann jederzeit ausgeführt werden und soll überprüfen, ob der gewünschte Satz vorhanden ist
PMlogger(1) Prozesse werden ausgeführt, und wenn nicht, starten Sie alle ausgefallenen Logger neu. Nutzung der
-s Die Option bietet die umgekehrte Funktionalität und ermöglicht den Satz von PMlogger Prozesse sein
sauber herunterfahren. Nutzung der -C Die Option fragt die Runlevel-Informationen des Systemdienstes ab
für den PMloggerund verwendet diese, um zu bestimmen, ob Prozesse gestartet oder gestoppt werden sollen.

Das -T Option bietet eine kürzere Form der Ausgabe für pmlogger_check das ist am besten geeignet
für eine PMlogger „Bauernhof“, wo viele Beispiele von PMlogger voraussichtlich laufen.

pmlogger_merge ist ein Wrapper-Skript für pmlogextract(1), das alle Archivprotokolle zusammenführt
passend zum Eingabebasisname Argumente und erstellt ein neues Archiv mit Ausgabename wie die
Basisname für die physischen Dateien, die ein Archivprotokoll bilden. Der Eingabebasisname
Argumente können Metazeichen im Stil von enthalten sh(1). Falls angegeben, wird die -f ganz ohne irgendetwas tun oder drücken zu müssen.
bewirkt, dass alle Eingabedateien entfernt werden, sobald das Ausgabearchiv erstellt wurde.

pmlogger_merge wird verwendet von pmlogger_daily.

Beide pmlogger_daily und pmlogger_check werden durch PCP-Logger-Steuerdateien gesteuert
spezifiziert das PMlogger Instanzen, die verwaltet werden sollen. Die Standardsteuerdatei ist
$PCP_PMLOGGERCONTROL_PATH, aber eine Alternative kann mit angegeben werden -c Möglichkeit. Wenn die
Verzeichnis $PCP_PMLOGGERCONTROL_PATH.d (oder Smartgeräte App.d aus dem -c Option) existiert, dann ist die
Der Inhalt aller darin enthaltenen zusätzlichen Steuerdateien wird an die Hauptsteuerdatei angehängt
(die existieren müssen).

Warnung: Das $PCP_PMLOGGERCONTROL_PATH und $PCP_PMLOGGERCONTROL_PATH.d-Dateien dürfen nicht sein
Beschreibbar durch jeden anderen Benutzer als Root.

Die Steuerdatei(en) sollten gemäß den folgenden Regeln angepasst werden, die für definieren
die aktuelle Version (1.1) des Steuerdateiformats.

1. Zeilen, die mit einem „#“ beginnen, sind Kommentare.
2. Zeilen, die mit „$“ beginnen, gelten als Zuweisungen zu Umgebungsvariablen in
der Stil von sh(1) und der gesamte Text, der auf das „$“ folgt, wird sein eval'ed durch das Drehbuch
Lesen der Steuerdatei und Exportieren der entsprechenden Variablen in die
Umfeld. Dies ist besonders nützlich, um Variablen festzulegen und in die zu exportieren
Umgebung der Verwaltungsskripte, z
$ PMCD_CONNECT_TIMEOUT=20
3. Dort sollen eine Versionszeile in der anfänglichen Steuerdatei des Formulars sein:
$-Version=1.1
4. Es sollte jeweils eine Zeile in der/den Steuerdatei(en) vorhanden sein PMlogger Instanz der
bilden:

Gastgeber y|n y|n Verzeichnis args

5. Felder innerhalb einer Zeile der Steuerdatei(en) werden normalerweise durch ein oder mehrere Felder getrennt
Leerzeichen oder Tabulatoren (beziehen Sie sich jedoch auf die Beschreibung von Verzeichnis Feld für einige
wichtige Ausnahmen).
6. Das zuerst Das Feld ist der Name des Hosts, der die Quelle der Leistungsmetriken ist
hierfür PMlogger Beispiel.
7. Das zweite Das Feld gibt an, ob dies ein ist primär PMlogger Instanz (y) oder nicht (n).
Da der primäre Logger auf dem lokalen Host laufen muss, darf es höchstens einen geben
Dieses Feld kann der primäre Logger für einen bestimmten Host sein y für höchstens einen PMlogger
In diesem Fall muss der Hostname der Name des lokalen Hosts sein.
8. Das dritte Das Feld zeigt an, ob dies der Fall ist PMlogger Die Instanz muss unter gestartet werden
Kontrolle pmsocks(1) um eine Verbindung herzustellen pmcd durch eine Firewall (y or n).
9. Das vierte Feld ist ein Verzeichnisname. Alle damit verbundenen Dateien PMlogger
In diesem Verzeichnis wird eine Instanz erstellt, und dies ist das aktuelle Verzeichnis für
die Ausführung aller für die Pflege dieser Archive erforderlichen Programme. Ein nützliches
Konvention ist, dass der primäre Logger für den lokalen Host mit dem Hostnamen archiviert mein Gastgeber sind
im Verzeichnis gepflegt $PCP_LOG_DIR/pmlogger/mein Gastgeber (Hier ist die Standardeinstellung
PMlogger Startskript in $PCP_RC_DIR/pcp erstellt die Archive), während Archive
für den Remote-Host murmeln werden in gepflegt $PCP_LOG_DIR/pmlogger/murmeln.
10. Das Verzeichnisfeld enthält möglicherweise eingebettete Shell-Syntax, die von ausgewertet wird sh(1)
um den tatsächlichen Verzeichnisnamen zu erzeugen, der verwendet werden soll. Die zulässigen Konstrukte sind:
· Beliebiger Text (einschließlich Leerzeichen), der mit eingeschlossen ist $( und ).
· Beliebiger Text (einschließlich Leerzeichen), der mit eingeschlossen ist ` und ` (rückseitige Anführungszeichen).
· Beliebiger Text (einschließlich Leerzeichen), der mit eingeschlossen ist " und " (Anführungszeichen).
· Jedes Wort, das a enthält $ (Es wird angenommen, dass ein Umgebungsvariablenname eingeführt wird).
11. Alle anderen Felder werden als zu übergebende Argumente interpretiert PMlogger(1) und/oder
pmnewlog(1). Am typischsten wäre dies -c .

Die folgenden Beispielsteuerzeilen geben einen primären Logger auf dem lokalen Host an (bozo), Und
Nicht-primäre Logger zum Sammeln und Protokollieren von Leistungsmetriken von den Hosts wackelig und
boing.

$version=1.1
bozo yn $PCP_LOG_DIR/pmlogger/bozo -c config.default
wobbly nn "/store/wobbly/$(date +%Y)" -c ./wobbly.config
boing nn $PCP_LOG_DIR/pmlogger/boing -c ./pmlogger.config

Charakteristische crontab(5) Einträge zur regelmäßigen Ausführung von pmlogger_daily und pmlogger_check sind
gegeben in $PCP_SYSCONF_DIR/pmlogger/crontab (sofern nicht standardmäßig installiert in /etc/cron.d
bereits) und unten gezeigt.

# tägliche Verarbeitung von Archivprotokollen
14 0 * * * $PCP_BINADM_DIR/pmlogger_daily
# Überprüfen Sie alle 30 Minuten, ob PMlogger-Instanzen ausgeführt werden
25,55 * * * * $PCP_BINADM_DIR/pmlogger_check

Um sicherzustellen, dass beim Ausführen dieser Skripte nicht unbeabsichtigt E-Mails gesendet werden
cron(8) Diagnosen werden immer an eine Protokolldatei gesendet. Standardmäßig ist diese Datei
$PCP_LOG_DIR/pmlogger/pmlogger_daily.log or $PCP_LOG_DIR/pmlogger/pmlogger_check.log aber
Dies kann mit geändert werden -l Möglichkeit. Wenn diese Protokolldatei beim Ausführen des Skripts bereits vorhanden ist
startet, wird es mit a umbenannt .vorher Suffix (überschreibt alle zuvor gespeicherten Protokolldateien)
bevor Diagnosen in der Protokolldatei generiert werden. Der -l und -t Optionen können nicht verwendet werden
together.

Die Ausgabe von der cron Die Ausführung der Skripte kann mit erweitert werden -V Option zu
die Skripte, die eine ausführliche Verfolgung ihrer Aktivitäten ermöglichen. Standardmäßig die Skripte
Es wird keine Ausgabe generiert, es sei denn, es tritt ein Fehler oder eine Warnbedingung auf.

Verwenden Sie pmlogger_check online über die Dienste von onworks.net