Dies ist der Befehl pmlogextract, der im kostenlosen Hosting-Anbieter OnWorks mit einer unserer zahlreichen kostenlosen Online-Workstations wie Ubuntu Online, Fedora Online, Windows Online-Emulator oder MAC OS Online-Emulator ausgeführt werden kann.
PROGRAMM:
NAME/FUNKTION
pmlogextract - Reduzieren, Extrahieren, Verketten und Zusammenführen von Performance Co-Pilot-Archiven
ZUSAMMENFASSUNG
pmlogextract [-dfwz] [-c Konfigurationsdatei] [-S Startzeit] [-s Proben] [-T Endzeit] [-v
Volsamples] [-Z Zeitzone] Varianten des Eingangssignals: [...] Möglichkeiten für das Ausgangssignal:
BESCHREIBUNG
pmlogextract liest ein oder mehrere Performance Co-Pilot (PCP) Archivprotokolle, identifiziert durch Varianten des Eingangssignals:
und erstellt ein zeitlich zusammengeführtes und/oder reduziertes PCP-Archivprotokoll in Möglichkeiten für das Ausgangssignal:Die Natur von
Die Zusammenführung wird durch die Anzahl der eingegebenen Archivprotokolle gesteuert, während die Art der Daten
Die Reduzierung wird durch die Kommandozeilenargumente gesteuert. Die Eingabe(n) müssen PCP-Archive sein
Protokolle erstellt von PMlogger(1) mit Leistungsdaten aus der gleich Gastgeber, aber
in der Regel über verschiedene Zeiträume und möglicherweise (wenn auch nicht normalerweise) mit unterschiedlichen
Leistungsmetriken werden protokolliert.
Wenn nur einer Varianten des Eingangssignals: angegeben ist, dann kopiert das Standardverhalten einfach den Eingabe-PCP
Archivprotokoll in das Ausgabe-PCP-Archivprotokoll. Wenn zwei oder mehr PCP-Archivprotokolle
angegeben als Varianten des Eingangssignals:werden die Protokolle zusammengeführt (oder verkettet) und in Möglichkeiten für das Ausgangssignal:.
Im Ausgabearchivprotokoll wird kurz nach dem Ende ein „Markierungseintrag“ eingefügt.
jedes der Eingangsarchivprotokolle, um eine mögliche zeitliche Diskontinuität zwischen
das Ende eines Eingabearchivprotokolls und der Beginn des nächsten Eingabearchivprotokolls. Siehe
MARK AUFZEICHNUNGEN Abschnitt weiter unten für weitere Informationen. Es gibt keinen ``Mark''-Datensatz nach dem
Ende der letzte (in zeitlicher Reihenfolge) der Eingabearchivprotokolle.
COMMAND LINE OPTIONAL
Die Befehlszeilenoptionen für pmlogextract sind wie folgt:
-c Konfigurationsdatei
Extrahieren Sie nur die in Konfigurationsdatei von dem Varianten des Eingangssignals: PCP-Archivprotokoll(e).
Die Konfigurationsdatei Syntax akzeptiert von pmlogextract wird ausführlicher erläutert in der
Konfiguration Reichen Sie das Syntax .
-d Verzweifelter Modus. Wenn ein schwerwiegender Fehler auftritt, werden normalerweise alle Spuren teilweise gelöscht
geschriebenes PCP-Archiv Möglichkeiten für das Ausgangssignal: ist entfernt. Mit dem -d Option, die Möglichkeiten für das Ausgangssignal: Archivprotokoll
wird nicht entfernt.
-f Für die meisten gängigen Anwendungen werden alle Eingabearchivprotokolle im
gleiche Zeitzone. Aber wenn das nicht der Fall ist, dann pmlogextract müssen wählen Sie eine von
die Zeitzonen aus den Eingabearchivprotokollen, die als Zeitzone für die Ausgabe verwendet werden sollen
Archivprotokoll. Standardmäßig wird die Zeitzone aus dem letzte Eingabearchivprotokoll.
Die -f Option erzwingt die Zeitzone aus dem zuerst zu verwendendes Eingabearchivprotokoll.
-S Startzeit
Definieren Sie den Beginn eines Zeitfensters, um die Anzahl der abgerufenen Proben einzuschränken, oder geben Sie ein
„natürliche“ Ausrichtung der Ausgabe-Abtastzeiten; siehe PCPIntro(1). Siehe auch
die -w .
-s Proben
Das Argument Proben definiert die Anzahl der Samples, auf die geschrieben werden soll Möglichkeiten für das Ausgangssignal:. Wenn
Proben ist 0 oder -s ist nicht angegeben, pmlogextract wird bis zum Ende probieren
PCP-Archivprotokoll oder das Ende des Zeitfensters, wie angegeben durch -T, was auch immer kommt
zuerst. Das -s Die Option überschreibt die -T Option, wenn es früher auftritt.
-T Endzeit
Definieren Sie das Ende eines Zeitfensters, um die entnommenen Proben einzuschränken oder
eine „natürliche“ Ausrichtung der Ausgabe-Sample-Zeiten festlegen; siehe PCPIntro(1).
Siehe auch die -w .
-v Volsamples
Die Möglichkeiten für das Ausgangssignal: Das Archivprotokoll ist möglicherweise ein mehrbändiger Datensatz, und die -v ganz ohne irgendetwas tun oder drücken zu müssen.
Ursachen pmlogextract um danach einen neuen Band zu beginnen Volsamples Protokolldatensätze wurden
in das Archivprotokoll geschrieben.
Unabhängig von irgendjemandem -v Option ist jedes Volume eines Archivs auf nicht mehr als begrenzt
2^31 Bytes, also pmlogextract erstellt automatisch ein neues Volume für das Archiv
bevor diese Grenze erreicht ist.
-w COHO Expo bei der -S und -T Geben Sie ein Zeitfenster innerhalb desselben Tages an, -w Flagge wird verursachen
die Daten innerhalb des zu extrahierenden Zeitfensters für jeden Tag im Archivprotokoll.
Beispielsweise die Optionen -w -S @11: 00 -T @15: 00 spezifizieren Sie das pmlogextract sollte
Schließen Sie Archivprotokolldatensätze nur für die Zeiträume von 11 bis 3 Uhr an jedem Tag ein.
Wann -w Wird verwendet Möglichkeiten für das Ausgangssignal: Das Archivprotokoll enthält „Markierungs“-Datensätze, um anzuzeigen
die zeitliche Diskontinuität zwischen dem Ende eines Zeitfensters und dem Beginn des
nächsten.
-Z Zeitzone
Nutzen Sie Zeitzone bei der Anzeige von Datum und Uhrzeit. Zeitzone ist im Format der
variable Umgebung TZ wie beschrieben in Umwelt(7).
-z Verwenden Sie die lokale Zeitzone des Hosts aus den Eingabearchivprotokollen. Die Standardeinstellung ist
Verwenden Sie zunächst die Zeitzone des lokalen Hosts.
CONFIGURATION FILE SYNTAX
Die Konfigurationsdatei enthält interessante Metriken - nur die erwähnten Metriken (oder Instanzen)
explizit oder implizit in der Konfigurationsdatei enthalten sind, werden in die Möglichkeiten für das Ausgangssignal: Archiv.
Jede Spezifikation muss in einer neuen Zeile beginnen und kann sich über mehrere Zeilen erstrecken.
Konfigurationsdatei. Instanzen können ebenfalls angegeben werden, sind aber optional. Das Format
für jede Spezifikation ist
Metrik [[Instanz[,Instanz...]]]
woher Metrisch kann ein Blatt- oder Nicht-Blattname im Performance Metrics Name Space (PMNS,
sehen pmns(5)). Bezieht sich eine Metrik auf einen Nicht-Blattknoten im PMNS, pmlogextract werden wir
rekursiv das PMNS absteigen und alle Metriken einschließen, die dem absteigenden Blatt entsprechen
Knoten.
Instanzen sind optional und können als Liste mit einem oder mehreren Leerzeichen (oder Kommas) angegeben werden.
getrennte Namen, Zahlen oder Zeichenfolgen (in einfachen oder doppelten Anführungszeichen). Elemente in
Die Liste, bei der es sich um Nummern handelt, wird als interne Instanzkennung angesehen - siehe
pmGetInDom(3) für weitere Informationen. Wenn keine Beispiele angegeben sind, dann alle Instanzen der
zugehörige Metrik(en) werden extrahiert.
Alle zusätzlichen Leerzeichen werden ignoriert und Kommentare können mit einem „#“-Präfix hinzugefügt werden.
CONFIGURATION FILE BEISPIEL
Dies ist ein Beispiel für eine gültige Konfigurationsdatei:
#
# Konfigurationsdatei für pmlogextract
#
kernel.all.cpu
kernel.percpu.cpu.sys ["cpu0","cpu1"]
disk.dev ["dks0d1"]
MARK AUFZEICHNUNGEN
Wenn mehr als ein Eingabearchivprotokoll Leistungsdaten zum Ausgabearchiv beiträgt
log, dann werden ``mark'' Datensätze eingefügt, um eine mögliche Diskontinuität in der
Leistungsdaten.
Ein „Mark“-Datensatz enthält einen Zeitstempel und keine Leistungsdaten und wird verwendet, um anzuzeigen
dass es einen Zeitraum im PCP-Archivprotokoll gibt, in dem wir die Werte nicht kennen von für
Leistungskennzahlen, da es keine PMlogger(1) Erfassung von Leistungsdaten während
diesen Zeitraum. Da diese Zeiträume oft mit dem Neustart eines Dienstes verbunden sind oder
pmcd(1) oder ein System, können erhebliche Zweifel an der Kontinuität der Leistung bestehen
Daten über diesen Zeitraum.
Die Begründung für das Markieren von Datensätzen kann anhand eines Beispiels veranschaulicht werden. Betrachten wir eines
Eingabearchivprotokoll, das um 00:10 Uhr beginnt und um 09:15 Uhr am selben Tag endet, und ein weiteres
Eingabearchivprotokoll, das am selben Tag um 09:20 Uhr beginnt und am nächsten Tag um 00:10 Uhr endet
Morgen. Das wäre ein sehr häufiger Fall für Archive, die verwaltet und rotiert werden von
pmlogger_check(1) und pmlogger_daily(1).
Das Ausgabearchivprotokoll würde Folgendes enthalten:
00:10.000 erster Datensatz aus dem ersten Eingabearchivprotokoll
...
09:15.000 Letzter Datensatz aus dem ersten Eingabearchivprotokoll
09:15.001
09:20.000 erster Datensatz aus dem zweiten Eingabearchivprotokoll
...
01:10.000 Letzter Datensatz aus dem zweiten Eingangsarchivprotokoll
Der Zeitraum, in dem die Leistungsdaten fehlen, beginnt kurz nach 09:15 Uhr und endet
kurz vor 09:20. Wenn das Ausgabearchivprotokoll mit einem der PCP-Berichts
Tools wird der Datensatz „markieren“ verwendet, um einen Zeitraum fehlender Daten anzuzeigen. Zum Beispiel in
das obige Archiv, wenn man die durchschnittliche I/O-Rate in 30-Minuten-Intervallen melden würde,
auf die Stunde ausgerichtet, dann gäbe es Daten für die Intervalle, die um 09:00 und 10:00 Uhr enden
Für das Intervall, das um 09:30 endet, wurden jedoch keine Daten gemeldet, da dies einen „Markierungs“-Datensatz umfasst.
Das Vorhandensein von „Mark“-Datensätzen in einem PCP-Archivprotokoll kann festgestellt werden durch
pmdumplog(1) wobei ein Zeitstempel und die Anmerkung wird verwendet, um eine „Markierung“ anzuzeigen
Rekord.
METADATEN KONTROLLEN
Wenn mehr als ein Varianten des Eingangssignals: Archiv angegeben ist, pmlogextract führt eine Reihe von Prüfungen durch, um
Stellen Sie sicher, dass die Metadaten für Metriken, die in mehr als einem der Varianten des Eingangssignals:
Archive. Diese Prüfungen umfassen:
* Der Metrikdatentyp ist derselbe
* Die metrische Semantik ist dieselbe
* metrische Einheiten sind gleich
* Die Metrik ist entweder immer singulär oder hat immer dieselbe Instanzdomäne
* Metriken mit demselben Namen haben dieselbe PMID
* Metriken mit derselben PMID haben denselben Namen
Wenn eine dieser Prüfungen fehlschlägt, pmlogextract meldet die Details und bricht ab, ohne zu erstellen
die Möglichkeiten für das Ausgangssignal: Archiv.
Um diese semantischen Probleme zu lösen, verwenden Sie pmlogrewrite(1) zu übersetzen Varianten des Eingangssignals: Archive in
gleichwertige Archive mit konsistenten Metadaten vor der Verwendung pmlogextract.
Verwenden Sie pmlogextract online mit den Diensten von onworks.net
