Der Befehl mfwkadm

Dieser Abschnitt enthält die deutsche Übersetzung der Man Page für den Befehl mfwkadm, einem Dienstprogrammbefehl in Man Page-Abschnitt 1M. Mit diesem Befehl verwalten Sie den Inhalt von Knotenagenten einschließlich der Module für überwachte Komponenten und den für die betreffenden Knoten definierten Überwachungsregeln (auch als Überwachungsaufträge bezeichnet). Einige der Begriffe und Beschreibungen in der Man Page wurden zur Anpassung an dieses Dokument geringfügig geändert.

Kurzbeschreibung

Leistungsüberwachung

Überwachung des Betriebsstatus

Schwellenwertüberwachung

Beschreibung

Das Dienstprogramm mfwkadm ist die Befehlszeilenschnittstelle zum Verwalten des Monitoring Framework-Aggenten (auch als Knotenagent bezeichnet). Der Knotenagent wird innerhalb des Common Agent Container ausgeführt. Mit dem Dienstprogramm mfwkadm können Sie Knotenagenten starten und stoppen sowie die von einem Knotenagent ausgeführten Überwachungsaufträge verwalten. Der Befehl muss auf dem gleichen Host ausgeführt werden, auf dem der Knotenagent läuft. Die Reihenfolge der hier aufgeführten Befehlsargumente ist einzuhalten.

Zum Ändern der Sprache der ausgegebenen Meldungen müssen Sie die Umgebungsvariable LC_MESSAGE auf Ihre Sprachumgebung setzen. Der Befehl mfwkadm verwendet die in der Datei JesmfMessages_ Sprachumgebung.pm enthaltenen Meldungen. Diese Datei befindet sich im Verzeichnis lib/resources. Falls für die gewünschte Sprachumgebung keine Meldungsdatei vorhanden ist oder keine Sprachumgebung angegeben wurde, verwendet der Befehl mfwkadm die Meldungen in der Standard-Meldungsdatei JesmfMessages.pm.

Das Dienstprogramm mfwkadm besitzt die folgenden Unterbefehle. Für Befehle, die mit einem Sternchen (*) gekennzeichnet sind, muss der Common Agent Container laufen und der Knotenagent muss geladen sein:

• start

• stop

• restart

• list-params (*)

• list-modules (*)

• info (*)

• pm-job (*)

• opstat-job (*)

• thrsh-job (*)

Je nach Anzahl der zu ladenden Common Agent Container-Module kann es sein, dass zwischen dem Starten des Knotenagenten und der Verfügbarkeit des Dienstprogramms mfwkadm eine Zeitverzögerung von einigen Sekunden bis hin zu einigen Minuten auftreten kann.. In diesem Zeitraum schlagen Befehle mit einer explizit ausgegebenen Meldung fehl.

Optionen

Die folgenden Optionen werden unterstützt.

--help

Anzeigen einer Syntaxübersicht.

Unterbefehle

start

Starten des Monitoring Framework-Knotenagenten und der zugehörigen Produktkomponenten ohne Stoppen des Common Agent Container.

Diese Aktion stellt zuerst den Knotenagenten und dann die zugehörigen Produktkomponenten im Common Agent Container bereit. Bei dieser Funktion handelt es sich um eine Schicht über den Unterbefehlen lock und undeploy des Dienstprogramms cacaoadm.

Der Unterbefehl start startet nur den Knotenagenten und die zum Monitoring Framework gehörenden Java ES-Komponentenmodule. Komponentenmodule tragen das Präfix com.sun.cmm.

Sicherheit: Der Unterbefehl start kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat. Andernfalls wird eine Fehlermeldung angezeigt, die der folgenden Meldung ähnelt:

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

stop

Stoppen des Monitoring Framework-Knotenagenten und seiner zugehörigen Java ES-Komponentenmodule im Common Agent Container.

Diese Aktion stoppt zunächst alle im Common Agent Container bereitgestellten Java ES-Komponent'enmodule und anschließend den Knotenagent. Bei dieser Funktion handelt es sich um eine Schicht über den Unterbefehlen lock und undeploy des Dienstprogramms cacaoadm.

Der Unterbefehl stop stoppt nur die Java ES-Komponentenmodule, die zum Monitoring Framework und dann dem Knotenagent selbst gehören. Komponentenmodule tragen das Präfix com.sun.cmm.

Sicherheit: Der Unterbefehl stopt kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat. Andernfalls wird eine Fehlermeldung angezeigt, die der folgenden Meldung ähnelt:

Error occured in mfwkadm Problem running /usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

restart

Neustart des Monitoring Framework-Knotenagenten und seiner zugehörigen Java ES-Komponentenmodule im Common Agent Container.

Diese Aktion versucht, den Knotenagenten und die zugehörigen Module im Common Agent Container zunächst zu stoppen und dann wieder neu zu starten. Dies geschieht in der gleichen Weise wie bei den Unterbefehlen stop und start.

Sicherheit: Der Unterbefehl restart kann nur von dem Benutzer ausgeführt werden, der den Common Agent Container gestartet hat. Andernfalls wird eine Fehlermeldung angezeigt, die der folgenden Meldung ähnelt:

Error occured in mfwkadm Problem running //usr/sbin/cacaoadm unlock com.sun.mfwk 2>&1. Stdout/Stderr: This command must be run by user: [root].

list-params

Auflisten aller Konfigurationsparameter für einen Monitoring Framework-Knotenagenten.

Sicherheit: Für diesen Befehl existiert keine Benutzerbeschränkung.

list-modules

Anzeigen einer Liste der Produktkomponenten, die das Common Monitoring Model (CMM) implementieren und im Common Agent Container geladen sind. Dieser Unterbefehl listet auch alle laufenden Instanzen jeder installierten Java ES-Komponente auf. Jede Komponente kann null, eine oder mehrere ausgeführte Instanzen besitzen.

Sicherheit:Wenn Benutzer, die den Common Agent Container nicht gestartet haben, diesen Befehl ausführen, enthält die Liste installierter Java ES-Komponenten keine Komponenteninstanzen.

info Ausgeführte_Instanz

Anzeigen von Informationen für die im Parameter Ausgeführte_Instanz bezeichnete Instanz. Der Wert in Ausgeführte_Instanz muss einer in der Ausgabe des Unterbefehls list-modules aufgeführten Instanz entsprechen.

Zu den angezeigten Informationen gehören:

• Für jeden Überwachungsauftragstyp alle zur laufenden Instanz gehörenden überwachbaren Objekte (sortiert nach Klassennamen). Zu den überwachbaren Objekten zählen all jene, für die Sie mithilfe der Unterbefehle pm-job, opstat-job oder thrsh-job Aufträge zur Überwachung der Leistung, des Betriebsstatus oder eines Schwellenwerts erstellen können.

• Für jede Klasse überwachbarer Objekte alle ihre überwachbaren Attribute einschließlich des Namen und Typs jedes Attributs.

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

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.

Überwachung des Betriebsstatus

opstat-job observable-classes

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

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

Anzeigen einer Liste aller gegenwärtig überwachbaren Objekte, für die Aufträge zur Betriebsstatusü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 opstat-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 (:) im Objektnamen.

opstat-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 der vom Unterbefehl opstat-job observable-classes aufgelisteten Klassen sein.

opstat-job list

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

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

opstat-job info Auftragsname

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

• Der Name des Auftrags zur Betriebsstatusüberwachung.

• Der Typ des Auftrags zur Betriebsstatusü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 Betriebsstatusü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 opstat-job suspend und opstat-job resume können Sie den Laufzeitstatus eines Auftrags zur Betriebsstatusüberwachung ändern.

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

• Protokolliert der Auftrag zur Betriebsstatusüberwachung nach Ereignissen? Das bedeutet, das die Ergebnisse des Auftrags zur Betriebsstatusüberwachung in diesem Fall als Benachrichtigungen an einen registrierten Client gesendet werden.

• Protokolliert der Auftrag zur Betriebsstatusüberwachung in eine Datei? Das bedeutet, das die Ergebnisse des Auftrags zur Betriebsstatusüberwachung in diesem Fall in eine Datei geschrieben werden und nur die Dateinamen an einen registrierten Client gesendet werden.

• Das Protokollformat des Auftrags zur Betriebsstatusüberwachung (immer XML).

• Der Zeitplan des Auftrags zur Betriebsstatusüberwachung: Der Zeitplan gibt an, an welchen Tagen und zu welcher Uhrzeit ein Auftrag aktiv sein und Daten erfassen soll.

• Aufträge vom Typ “by-object”: Die Liste aller überwachten Objekte (nach Namen geordnet).

• Aufträge vom Typ “by-class”: Die Liste aller überwachten Klassen (nach Namen geordnet).

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

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

Erstellt für ein Objekt bzw. mehrere Objekte einen neuen Auftrag zur Betriebsstatusüberwachung. 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 Auftrag zur Betriebsstatusüberwachung eindeutig spezifiziert. Der Wert des Parameters Auftragsname darf nicht bereits von einem anderen Auftrag zur Betriebsstatusüberwachung verwendet werden.

granularity=Ganzzahliger_Wert

Die Zeit (in Sekunden), die zwischen zwei Datenerfassungszeitpunkten vergeht , wenn der Auftrag den Status “active on-duty” besitzt.

object=Objektname [object= Objektname ...]

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

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

opstat-job delete Auftragsname

Löschen des Auftrags zur Betriebsstatusüberwachung Auftragsname. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl opstat-job list ausgegebenen Liste entsprechen.

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

opstat-job suspend Auftragsname

Anhalten des Auftrags zur Betriebsstatusüberwachung 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 opstat-job resume wieder aktiviert werden. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl opstat-job list ausgegebenen Liste entsprechen.

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

opstat-job resume Auftragsname

Fortsetzen des Auftrags zur Betriebsstatusüberwachung 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 opstat-job list ausgegebenen Liste entsprechen. Dies ist das Gegenstück zum Unterbefehl opstat-job suspend.

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

Schwellenwertüberwachung

thrsh-job observable-classes

Anzeigen einer Liste aller gegenwärtig überwachbaren Objektklassen, für die Schwellenwertüberwachungsaufträge erstellt werden können.

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

Anzeigen einer Liste aller gegenwärtig überwachbaren Objekte, für die Schwellenwertüberwachungsaufträge 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 thrsh-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 (:) im Objektnamen.

thrsh-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 der vom Unterbefehl thrsh-job observable-classes aufgelisteten Klassen sein.

thrsh-job list

Anzeigen einer Liste aller gegenwärtig definierten Schwellenwertüberwachungsaufträge. Aufträge werden für das jeweilige Objekt ausgegeben, für das ein Schwellenwertü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 thrsh-job info ausgegeben werden.

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

thrsh-job info Auftragsname

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

• Der Name des Auftrags zur Schwellenwertüberwachung.

• Die Anzahl der ausgeführten Schwellenwertüberwachungsaufträge. In dieser Version sind lediglich einfache Schwellenwertüberwachungsaufträge möglich, die ein Attribut bzw. ein Objekt überwachen.

• Der Status des Auftrags zur Schwellenwertü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 thrsh-job suspend und thrsh-job resume können Sie den Laufzeitstatus eines Schwellenwertüberwachungsauftrags ändern.

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

• Der Zeitplan des Auftrags zur Schwellenwertüberwachung. Der Zeitplan gibt an, an welchen Tagen und zu welcher Uhrzeit ein Auftrag aktiv sein und Daten erfassen soll.

• Die Alarmkonfiguration des Schwellenwertüberwachungsauftrags. Das ist der Alarm, der ausgelöst wird, wenn der erfasste Wert des überwachten Objekts den festgelegten Schwellenwert über- bzw. unterschreitet. Es werden der Typ und der Schweregrad des Alarms angezeigt.

• Das überwachte Objekt des Schwellenwertüberwachungsauftrags.

• Der Name des Attributs, das durch den Schwellenwertüberwachungsauftrag überwacht wird.

• Der Wert des Schwellenwerts, der einen Alarm auslöst.

• Die Richtung des Werteverlaufs, die einen Schwellenwertalarm auslösen soll (RISING oder FALLING, steigend bzw. fallend).

• Die Abweichungstoleranz des Schwellenwerts. Bei der Richtung RISING wird erst wieder ein Alarm ausgelöst, wenn der überwachte Attributwert kleiner als der Schwellenwert-Abweichung ist. Bei der Richtung FALLING wird erst wieder ein Alarm ausgelöst, wenn der überwachte Attributwert größer als der Schwellenwert+Abweichung ist. Dieses Verhalten gilt auch dann, wenn die Abweichung null ist.

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

thrsh-job create Auftragsname object= Objektname granularity=Ganzzahliger_Wert attributeName= Attributname attributeType=Attribut-Typ thresholdValue= Schwellenwert thresholdOffset=Abweichung thresholdDirection= [RISING|FALLING]

Erstellt einen neuen Schwellenwertüberwachungsauftrag, der ein Attribut eines einzelnen Objekts überwacht. Beim Erstellen von Schwellenwertüberwachungsaufträgen können die folgenden Parameter eingestellt werden:

Auftragsname

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

object=Objektname

Das überwachbare Objekt, für das der Schwellenwertüberwachungsauftrag die Attributwerte zum Vergleich mit dem Schwellenwert erfasst. Der Wert des Parameters Objektname muss in der von den Unterbefehlen thrsh-job list bzw. thrsh-job observable-objects ausgegebenen Objektliste enthalten sein.

granularity=Ganzzahliger_Wert

Die Zeit (in Sekunden), die zwischen zwei Erfassungszeitpunkten eines Attributwertes vergeht , wenn der Auftrag den Status “active on-duty” besitzt.

attributeName=Attributname

Der Name des Attributs, dessen Werte der Schwellenwertüberwachungsauftrag erfasst und die mit dem Schwellenwert verglichen werden. Der Wert des Parameters Attributname muss in der von den Unterbefehlen thrsh-job info bzw. thrsh-job observable-attributes ausgegebenen Objektliste enthalten sein.

attributeType=Attribute-Typ

Der Typ des zu überwachenden Attributs. Der Wert des Parameters Attribut-Typ muss in der von den Unterbefehlen thrsh-job info bzw. thrsh-job observable-attributes ausgegebenen Objektliste enthalten sein.

thresholdValue=Schwellenwert

Der Wert des überwachten Attributs, bei dem der Schwellenwertüberwachungsauftrag einen Alarm auslösen soll, wenn er in der im Parameter thresholdDirection angegebenen Richtung über- bzw. unterschritten wird.

thresholdOffset=Abweichung

Die Abweichung legt für den Schwellenwertüberwachungsauftrag die Abweichungstoleranz für das Auslösen aufeinander folgender Alarme fest. Die Abweichung muss null oder positiv sein. Nach dem Auslösen eines Alarms wird erst wieder ein neuer Alarm ausgelöst, wenn der Wert des überwachten Attributs den im Parameter Abweichung festgelegten Wert über- bzw. unterschreitet (in Abhängigkeit vom Wert des Parameters thresholdDirection).

thresholdDirection=[RISING|FALLING]

Bei der Richtung RISING wird erst wieder ein Alarm ausgelöst, wenn der überwachte Attributwert kleiner als der Schwellenwert-Abweichung ist. Bei der Richtung FALLING wird erst wieder ein Alarm ausgelöst, wenn der überwachte Attributwert größer als der Schwellenwert+Abweichung ist. Dieses Verhalten gilt auch dann, wenn die Abweichung null ist.

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

thrsh-job delete Auftragsname

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

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

thrsh-job suspend Auftragsname

Anhalten des Schwellenwertü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 thrsh-job resume wieder aktiviert werden. Der Wert des Parameters Auftragsname muss einem Auftrag aus der vom Unterbefehl thrsh-job list ausgegebenen Liste entsprechen.

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

thrsh-job resume Auftragsname

Fortsetzen des Schwellenwertü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 thrsh-job list ausgegebenen Liste entsprechen. Dies ist das Gegenstück zum Unterbefehl thrsh-job suspend.

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

Beispiele

Im folgenden hypothetischen Beispiel wird die Verwendung des Dienstprogramms mfwkadm mit seinen Optionen und Unterbefehlen demonstriert.

Der Unterbefehl list-modules zeigt die Java ES-Komponenteninstanzen auf dem aktuellen Host und die entsprechenden Module im Common Agent Container an. Im folgenden Beispiel sind zwei installierte Komponenten (Directory Server mit zwei ausgeführten Instanzen sowie Web Server mit einer ausgeführten Instanz) aufgeführt.

$ mfwkadm list-modules

Installed products and their running instances:
==============================================

Instances for installed product: com.sun.cmm.ds:collectionID=/opt/SUNWdsee/ds6,
name=Sun Java(TM) System Directory Server,type=CMM_InstalledProduct
-------------------------------

No instance.

Instances for installed product: com.sun.cmm.ws:collectionID=/var/opt/SUNWwbsvr7,
name=WebServer,type=CMM_InstalledProduct
-------------------------------

/wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,type=CMM_ApplicationSystem

Der folgende Unterbefehl info zeigt überwachbare Objekte in der Web Server-Instanz mit den Klassen und Attribute für jeden Objekttyp an.

$ mfwkadm info /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com,\\
type=CMM_ApplicationSystem

Information about running instance: /wsPrefix/com.sun.cmm.ws:
name=https-hostname.example.com,type=CMM_ApplicationSystem
==================================

Observable objects for performance jobs:
---------------------------------------

+ Objects of class: com.sun.cmm.settings.CMM_ApplicationSystemSetting

        /wsPrefix/com.sun.cmm.ws:name=https-hostname.example.com-setting,
type=CMM_ApplicationSystemSetting

        Observable attributes:

        Caption [STRING]
        ConfigurationDirectory [STRING]
        CreationClassName [STRING]
        Description [STRING]
        DirectoryName [STRING]
        ElementName [STRING]
        InstanceID [STRING]
        Name [STRING]
        URL [STRING]

+ Objects of class: com.sun.cmm.settings.CMM_KeepAliveSetting

        /wsPrefix/com.sun.cmm.ws:name=process-1-keepalive-setting,
type=CMM_KeepAliveSetting

        Observable attributes:

        AllocationUnit [STRING]
        Caption [STRING]
        ConnectionsUpperBound [LONG]
        CreationClassName [STRING]
        Description [STRING]
        ElementName [STRING]
        InputUnit [STRING]
        InstanceID [STRING]
        LowerAllocationLimit [LONG]
        LowerInputLimit [LONG]
        LowerOutputLimit [LONG]
        Name [STRING]
        OtherAllocationUnit [STRING]
        OtherInputUnit [STRING]
        OtherLowerAllocationLimit [LONG]
        OtherLowerInputLimit [LONG]
        OtherLowerOutputLimit [LONG]
        OtherOutputUnit [STRING]
        OtherUpperAllocationLimit [LONG]
        OtherUpperInputLimit [LONG]
        OtherUpperOutputLimit [LONG]
        OutputUnit [STRING]
        QueuedUpperBound [LONG]
        SecondsTimeout [LONG]
        TimeoutUpperBound [LONG]
        UpperAllocationLimit [LONG]
        UpperInputLimit [LONG]
        UpperOutputLimit [LONG]
        ...

Der folgende Befehl gibt die Liste definierter Leistungsüberwachungsaufträge aus. In diesem Beispiel ist ein Leistungsüberwachungsauftrag namens MeinLeistgUebAuftrag definiert, der ein Objekt überwacht:

$ mfwkadm pm-job list

BY_OBJECTS performance jobs:
===========================

Performance job information for: MeinLeistgUebAuftrag
-------------------------------

Type:                BY_OBJECTS
State:               ACTIVE_ON_DUTY
Granularity period:  30
Reporting period:    1
By event:            EVENT_SINGLE
By file:             EVENT_SINGLE
Report format:       XML
Schedule:
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Observed objects:
                /wsPrefix/com.sun.cmm.ws:name=virtualServer-hostname.example.com-
webApp-/-stats,type=CMM_VirtualServerWebModuleStats
Observed attributes:
                All available

BY_CLASSES performance jobs:
===========================

No jobs found.

Der folgende Befehl erstellt einen Auftrag zur Betriebsstatusüberwachung für zwei überwachbare Objekte aus den Unterbefehlen opstat-job info bzw. opstat-job observable-objects:

$ mfwkadm opstat-job create myOpStatJob granularity=60 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1,type=CMM_UnixProcess \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-DNSCache1,type=CMM_DnsCache

Der folgende Befehl hält den oben erstellten Auftrag an:

$ mfwkadm opstat-job suspend myOpStatJob

Der folgende Befehl zeigt die überwachbaren Klassen für potenzielle Schwellenwertüberwachungsaufträge an:

$ mfwkadm thrsh-job observable-classes

Threshold jobs observable classes:
=================================

com.sun.cmm.cim.CIM_ScopedSettingData
com.sun.cmm.cim.CIM_SettingData
com.sun.cmm.cim.CIM_StatisticalData
com.sun.cmm.cim.statistics.CIM_EthernetPortStatistics
com.sun.cmm.cim.statistics.CIM_NetworkPortStatistics
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeJVMStats
com.sun.cmm.cim.statistics.j2ee.CIM_J2eeStatistic
com.sun.cmm.settings.CMM_ApplicationSystemSetting
com.sun.cmm.settings.CMM_KeepAliveSetting
com.sun.cmm.settings.CMM_QueueTimeoutSetting
com.sun.cmm.settings.CMM_RFC2788ApplicationSystemSetting
com.sun.cmm.settings.CMM_ScopedSettingData
com.sun.cmm.settings.CMM_SoftwareResourceSetting
com.sun.cmm.settings.CMM_SWRBufferSetting
com.sun.cmm.settings.CMM_SWRLimitSetting
com.sun.cmm.settings.CMM_SWRQueueSetting
com.sun.cmm.settings.CMM_VirtualServerSetting
com.sun.cmm.statistics.CMM_ApplicationSystemStats
com.sun.cmm.statistics.CMM_ApplicationSystemWatchdogStats
com.sun.cmm.statistics.CMM_ConnectionQueueStats
com.sun.cmm.statistics.CMM_DnsCacheStats
com.sun.cmm.statistics.CMM_EthernetPortStats
com.sun.cmm.statistics.CMM_FileCacheStats
com.sun.cmm.statistics.CMM_HTTPResponsesStats
com.sun.cmm.statistics.CMM_JVMJSR174ExtStats
com.sun.cmm.statistics.CMM_JVMJSR174Stats
com.sun.cmm.statistics.CMM_JVMStats
com.sun.cmm.statistics.CMM_NetworkPortStats
com.sun.cmm.statistics.CMM_OperatingSystemStats
com.sun.cmm.statistics.CMM_ProcessorStats
com.sun.cmm.statistics.CMM_ProcessStats
com.sun.cmm.statistics.CMM_QueueTimeoutStats
com.sun.cmm.statistics.CMM_RFC2788ApplicationTableStats
com.sun.cmm.statistics.CMM_ServiceStats
com.sun.cmm.statistics.CMM_SoftwareResourceStats
com.sun.cmm.statistics.CMM_SolarisEthernetPortStats
com.sun.cmm.statistics.CMM_SolarisNetworkPortStats
com.sun.cmm.statistics.CMM_SolarisOperatingSystemStats
com.sun.cmm.statistics.CMM_SolarisProcessorStats
com.sun.cmm.statistics.CMM_SolarisProcessorSysinfoStats
com.sun.cmm.statistics.CMM_SolarisProcessorVmStats
com.sun.cmm.statistics.CMM_Statistic
com.sun.cmm.statistics.CMM_SWRBufferStats
com.sun.cmm.statistics.CMM_SWRCacheStats
com.sun.cmm.statistics.CMM_SWRLimitStats
com.sun.cmm.statistics.CMM_SWRQueueStats
com.sun.cmm.statistics.CMM_UnixOperatingSystemStats
com.sun.cmm.statistics.CMM_UnixProcessStats
com.sun.cmm.statistics.CMM_VirtualServerWebModuleStats
com.sun.cmm.statistics.CMM_WebModuleStats

Der folgende Befehl gibt die überwachbaren Attribute für Schwellenwertüberwachungsaufträge aus, die die Objekte der Klasse com.sun.cmm.statistics.CMM_SWRQueueStats aus dem vorherigen Beispiel überwachen:

$ mfwkadm thrsh-job observable-attributes \\
class=com.sun.cmm.statistics.CMM_SWRQueueStats

Threshold jobs observable attributes:
====================================

Class: com.sun.cmm.statistics.CMM_SWRQueueStats

Attributes:

BufferSize [LONG]
EntriesCount [LONG]
EntriesHighWaterMark [LONG]
EntriesLowWaterMark [LONG]
EntriesTotal [LONG]
ErrorCount [INTEGER]
FailedOperations [LONG]
LowerLimit [LONG]
OperationsCount [LONG]
OtherLowerLimit [LONG]
OtherUpperLimit [LONG]
OverflowsCount [LONG]
QueuedCount [LONG]
QueuedHighWater [LONG]
SampleInterval [LONG]
TotalQueuedCount [LONG]
UpperLimit [LONG]

Der folgende Befehl ist ein weiteres Beispiel für die Auftragserstellung, diesmal für einen Schwellenwertüberwachungsauftrag:

$ mfwkadm thrsh-job create myThreshJob granularity=30 \\
object=/wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-NativePool-stats,\\
type=CMM_SWRQueueStats attributeName=EntriesCount attributeType=LONG \\
thresholdValue=1000 thresholdOffset=10 thresholdDirection=RISING

Das folgende Beispiel zeigt die Ausgabe des Unterbefehls thrsh-job info den im vorigen Beispiel erstellten Schwellenwertüberwachungsauftrag:

$ mfwkadm thrsh-job info myThreshJob

Threshold job information for: myThreshJob
-----------------------------

Type:                SIMPLE
State:               ACTIVE_ON_DUTY
Granularity period:  30
Schedule:
        Global start time: Immediately
        Global stop time: Forever
        Weekly schedule: Everyday
        Daily schedule: All day
Alarm configuration:
                Type: QualityOfServiceAlarm
                Severity: INDETERMINATE
Threshold definition(s):
                Object: /wsPrefix/com.sun.cmm.ws:name=process-1-threadPool-
NativePool-stats,type=CMM_SWRQueueStats
                        Attribute: EntriesCount [LONG]
                        Value: 1000
                        Direction: RISING
                        Offset: 10

Beendigungsstatus

Bei Programmende werden die folgenden Werte zurückgegeben:

0

Erfolgreiche Kompilierung.

1

Ein Fehler ist aufgetreten.

Attribute

Siehe auch:

cacao.5, cacaoadm.1m