Sun Java Enterprise System 5 Überwachungshandbuch

Leistungsüberwachung

pm-job observable-classes

Anzeigen einer Liste aller gegenwärtig überwachbaren Objektklassen, für die Aufträge zur Leistungsüberwachung erstellt werden können.

pm-job observable-objects [class= Objektklasse] [domain=Objektdomäne]

Anzeigen einer Liste aller gegenwärtig überwachbaren Objekte, für die Aufträge zur Leistungsüberwachung erstellt werden können. Standardmäßig werden alle Objekte überwachbarer Klassen in allen Domänen aufgeführt. Die Objektliste ist nach Klassennamen sortiert.

class=Objektklasse

Die Angabe des optionalen Parameters Objektklasse beschränkt die Ausgabe auf überwachbare Objekte der angegebenen Klasse. Der Wert des Parameters Objektklasse muss eine der vom Unterbefehl pm-job observable-classes aufgelisteten Klassen sein.

domain=Objektdomäne

Die Angabe des optionalen Parameters Objektdomäne beschränkt die Ausgabe auf überwachbare Objekte der angegebenen Domäne. Unter der Domäne eines Objekts versteht man die Zeichenkette vor dem Doppelpunkt (:) in einem Objektnamen.

pm-job observable-attributes class=Objektklasse

Anzeigen einer Liste aller überwachbaren Attribute der angegebenen Objektklasse. Attribute werden mit Namen und Typ angezeigt. Der Wert des Parameters Objektklasse muss eine Klasse sein, die Leistungsüberwachung unterstützt und somit vom Unterbefehl pm-job observable-classes ausgegeben wird.

pm-job list

Anzeigen einer Liste aller gegenwärtig definierten Aufträge zur Leistungsüberwachung. Aufträge werden für das jeweilige Objekt ausgegeben, für das ein Leistungsüberwachungsauftrag definiert ist, und die entsprechenden Objekte sind nach Klassennamen sortiert. Die für jeden Auftrag angezeigten Informationen sind die gleichen, die auch vom Unterbefehl pm-job info ausgegeben werden.

Sicherheit: Wenn Benutzer, die den Common Agent Container nicht gestartet haben, diesen Befehl ausführen, werden keine Aufträge angezeigt.

pm-job info Auftragsname

Anzeigen ausführlicher Informationen zu dem von Auftragsname bezeichneten Leistungsüberwachungsauftrag. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl pm-job list ausgegebenen Liste entsprechen. Dieser Unterbefehl zeigt die folgenden Informationen an:

  • Der Name des Auftrags zur Leistungsüberwachung.

  • Der Typ des Auftrags zur Leistungsüberwachung: “by object” oder “by class.”. Aufträge vom Typ “by object” überwachen bezeichnete Objektinstanzen, während Aufträge vom Typ “by class” jede Instanz einer Objektklasse überwachen. Bitte beachten Sie, dass Aufträge vom Typ “by class” mit dem Dienstprogramm mfwkadm nicht erstellt werden können.

  • Der Status des Auftrags zur Leistungsüberwachung. “active on-duty”, “active off-duty” oder “suspended”. Ein Auftrag mit dem Status “active on-duty” ist gegenwärtig planmäßig aktiv und erfasst Daten. Ein Auftrag mit dem Status “active off-duty” läuft zwar, erfasst jedoch keine Daten, da er gegenwärtig gemäß dem Zeitplan nicht aktiv ist. Ein Auftrag mit dem Status “suspended” läuft nicht und erfasst keine Daten. Mit den Unterbefehlen pm-job suspend und pm-job resume können Sie den Laufzeitstatus eines Auftrags zur Leistungsüberwachung ändern.

  • Die Granularität (Erfassungshäufigkeit) des betreffenden Auftrags zur Leistungsüberwachung (in Sekunden). Dieser Parameter gibt an, wie häufig der Auftrag Daten erfasst.

  • Der Protokollierungszeitraum des Überwachungsauftrags. Der Protokollierungszeitraum multipliziert mit der Granularität ergibt die Benachrichtigungshäufigkeit. Wenn die Granularität beispielsweise 10 Sekunden und der Protokollierungszeitraum 6 Sekunden beträgt, erfasst dieser Auftrag alle 10 Sekunden Daten und sendet alle 60 Sekunden eine Benachrichtigung, die sechs Protokolle enthält (10*6). Wenn der Auftrag Protokollierungsdaten auch in eine Datei schreibt, sendet er alle 60 Sekunden ein Ereignis, das die Namen und Speicherorte der sechs erstellten Dateien enthält.

  • Protokolliert der Leistungsüberwachungsauftrag nach Ereignissen? Das bedeutet, das die Ergebnisse des Leistungsüberwachungsauftrags in diesem Fall als Benachrichtigungen an einen registrierten Client gesendet werden.

  • Protokolliert der Leistungsüberwachungsauftrag in eine Datei? Das bedeutet, das die Ergebnisse des Leistungsüberwachungsauftrags in diesem Fall in eine Datei geschrieben werden und nur die Dateinamen an einen registrierten Client gesendet werden.

  • Das Protokollformat des Leistungsüberwachungsauftrags (immer XML).

  • Der Zeitplan für den Leistungsüberwachungsauftrag. Der Zeitplan gibt an, an welchen Tagen und zu welcher Uhrzeit ein Auftrag aktiv sein und Daten erfassen soll.

Für “by-object”-Aufträge:

  • Die Liste überwachter Objekte (nach Namen geordnet).

  • Wenn nur eine Untermenge überwachbarer Attribute angegeben ist, werden die überwachten Attribute der überwachten Objekte nach Namen und Typen aufgeführt.

Für “by-class”-Aufträge:

  • Die Liste überwachter Klassen (nach Namen geordnet).

  • Wenn nur eine Untermenge überwachbarer Attribute angegeben ist, werden die überwachten Attribute der überwachten Klassen nach Namen und Typen aufgeführt. Diese Attribute sind für alle Klassen gleich.

Sicherheit: Wenn Benutzer, die den Common Agent Container nicht gestartet haben, diesen Befehl ausführen, werden keine Informationen angezeigt.

pm-job create Auftragsname granularity= Ganzzahliger_Wert object=Objektname [object= Objektname ...]

Erstellt für ein Objekt bzw. mehrere Objekte einen neuen Leistungsüberwachungsauftrag. Der Befehl mfwkadm kann keine Aufträge vom Typ “by class” erstellen. Beim Erstellen von Leistungsüberwachungsaufträgen können die folgenden Parameter eingestellt werden:

Auftragsname

Eine Zeichenkette, die den Leistungsüberwachungsauftrag eindeutig spezifiziert. Der Wert des Parameters Auftragsname darf nicht bereits von einem anderen Leistungsüberwachungsauftrag verwendet werden.

granularity=Ganzzahliger_Wert

Die Zeit (in Sekunden), die zwischen zwei Datenerfassungszeitpunkten vergeht , wenn der Auftrag den Status “active on-duty” besitzt. Die Granularität kann beispielsweise 300 Sekunden (5 Minuten), 900 Sekunden (15 Minuten), 1800 Sekunden (halbstündlich) oder 3600 Sekunden (stündlich) betragen. In den meisten Fällen reicht eine Granularität von 300 Sekunden aus. Manchmal ist es jedoch sinnvoller, Daten nicht so oft zu erfassen

object=Objektname [object= Objektname ...]

Ein bzw. mehrere überwachbare Objekte, für die der betreffende Leistungsüberwachungsauftrag Daten erfasst und protokolliert. Der Wert des Parameters Objektname muss in der von den Unterbefehlen pm-job list bzw. pm-job observable-objects ausgegebenen Objektliste enthalten sein. Durch Angabe mehrerer Werte für “object= Objektname” wird ein einziger Leistungsüberwachungsauftrag erstellt, der mehrere Objekte überwacht.

Sicherheit: Dieser Unterbefehl kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat.

pm-job delete Auftragsname

Löschen des Leistungsüberwachungsauftrags Auftragsname. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl pm-job list ausgegebenen Liste entsprechen.

Sicherheit: Dieser Unterbefehl kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat.

pm-job suspend Auftragsname

Anhalten des Leistungsüberwachungsauftrags Auftragsname. Angehaltene Aufträge sind nicht aktiv und erfassen unabhängig von ihrem Zeitplan keine Daten. Der Auftrag bleibt jedoch erhalten und kann mithilfe des Unterbefehls pm-job resume wieder aktiviert werden. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl pm-job list ausgegebenen Liste entsprechen.

Sicherheit: Dieser Unterbefehl kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat.

pm-job resume Auftragsname

Fortsetzen des Leistungsüberwachungsauftrags Auftragsname. Ein fortgesetzter Auftrag erfasst wieder Daten und protokolliert diese gemäß dem Zeitplan. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl pm-job list ausgegebenen Liste entsprechen. Dies ist das Gegenstück zum Unterbefehl pm-job suspend.

Sicherheit: Dieser Unterbefehl kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat.