Unterbefehle (Sun Java Enterprise System 5 Überwachungshandbuch)

Sun Java Enterprise System 5 Überwachungshandbuch

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.