運用ステータス監視

opstat-job observable-classes

運用ステータス監視ジョブを作成できるオブジェクトについて、現在監視可能なすべてのクラスの一覧を表示します。

opstat-job observable-objects [class= objectClass] [domain=objectDomain]

運用ステータス監視ジョブを作成できる、現在監視可能なすべてのオブジェクトの一覧を表示します。デフォルトでは、すべての監視可能クラスの、またすべてのドメイン内のすべてのオブジェクトが一覧表示されます。オブジェクトの一覧はクラス名でソートされます。

class=objectClass

オプションの objectClass を指定すると、その特定クラスの監視可能オブジェクトのみに出力が限定されます。objectClass は、opstat-job observable-classes サブコマンドによって一覧表示されるいずれかのクラスである必要があります。

domain=objectDomain

オプションの objectDomain を指定すると、そのドメイン内の監視可能オブジェクトのみに出力が限定されます。オブジェクトのドメインは、オブジェクトの名前のうちコロン (:) 記号よりも前の文字列の部分です。

opstat-job observable-attributes class= objectClass

objectClass で指定されたオブジェクトクラスのすべての監視可能属性の一覧を表示します。属性はその名前および型とともに表示されます。objectClass は、opstat-job observable-classes サブコマンドによって一覧表示されるいずれかのクラスである必要があります。

opstat-job list

現在定義されているすべての運用ステータス監視ジョブの一覧を表示します。定義されている運用ステータス監視ジョブが存在するオブジェクトごとにジョブが一覧表示され、オブジェクトはそのクラス名によってソートされます。各ジョブについて表示される情報は、opstat-job info サブコマンドによって表示されるものと同じです。

セキュリティー:共通エージェントコンテナを起動したユーザー以外によって実行された場合、ジョブは表示されません。

opstat-job info jobName

jobName で指定された運用ステータス監視ジョブについての詳細情報を表示します。jobName は、opstat-job list サブコマンドによって表示されるジョブである必要があります。このサブコマンドは次の情報を表示します。

• 運用ステータス監視ジョブの名前。

• 運用ステータス監視ジョブのタイプ。「by object」(オブジェクト別) または「by class」(クラス別) のいずれか。オブジェクト別ジョブは、1 つの名前付きオブジェクトインスタンスを監視します。クラス別ジョブは、オブジェクトクラスのすべてのインスタンスを監視します。mfwkadm ユーティリティーではクラス別ジョブを作成できないことに注意してください。

• 運用ステータス監視ジョブの状態。「active on-duty」(アクティブで監視中)、「active off-duty」(アクティブのみ)、または「suspended」(停止中) のいずれか。「アクティブで監視中」のジョブは、その時点でスケジュールに従って実行中であり、かつデータを収集中です。「アクティブのみ」のジョブは実行中ですが、その時点で作業スケジュール外であるためデータは収集していません。「停止中」のジョブは実行されておらず、データも収集していません。運用ステータス監視ジョブの実行状態を変更するには、opstat-job suspend および opstat-job resume サブコマンドを使用します。

• 運用ステータス監視ジョブの粒度 (秒数)。これは、このジョブによるデータ収集の間隔です。

• 運用ステータス監視ジョブがイベント別のレポートを行っているかどうか。これは、運用ステータス監視ジョブの結果が、登録済みクライアントに通知として送信されることを意味します。

• 運用ステータス監視ジョブがファイル別のレポートを行っているかどうか。これは、運用ステータス監視ジョブのレポートがローカルファイルに書き込まれ、ファイル名を含む通知が登録済みクライアントに送信されることを意味します。

• 運用ステータス監視ジョブのレポート形式。これは常に XML です。

• 運用ステータス監視ジョブのスケジュール。スケジュールは、ジョブが「アクティブで監視中」(データを収集する) または「アクティブのみ」(データは収集しない) の状態になる日時を指定します。

• オブジェクト別ジョブの場合、名前でソートされた監視対象オブジェクトの一覧。

• クラス別ジョブの場合、名前でソートされた監視対象クラスの一覧。

セキュリティー:共通エージェントコンテナを起動したユーザー以外によって実行された場合、情報は表示されません。

opstat-job create jobName granularity= integerValue object=objectName [object= objectName ...]

1 つ以上のオブジェクトを対象とした新しい運用ステータス監視ジョブを作成します。mfwkadm コマンドでは、クラス別ジョブは作成できません。パフォーマンス監視ジョブを作成するとき、次のパラメータを設定できます。

jobName

運用ステータス監視ジョブを一意に識別する文字列。jobName には、ほかの運用ステータス監視ジョブによってすでに使用されている文字列は指定できません。

granularity=integerValue

ジョブが「アクティブで監視中」のときに、2 回の連続する測定データ収集の開始間隔を秒数で指定します。

object=objectName [object= objectName ...]

運用ステータス監視ジョブがデータを収集してレポートする、1 つ以上の監視対象オブジェクト。objectName は、opstat-job list または opstat-job observable-objects サブコマンドによって表示されるオブジェクトである必要があります。「object=objectName」パラメータを複数指定すると、複数のオブジェクトを監視する 1 つの運用ステータス監視ジョブが作成されます。

セキュリティー:このサブコマンドを実行できるのは、共通エージェントコンテナを起動したユーザーに限られます。

opstat-job delete jobName

jobName で指定された運用ステータス監視ジョブを削除します。jobName は、opstat-job list サブコマンドによって表示されるジョブである必要があります。

セキュリティー:このサブコマンドを実行できるのは、共通エージェントコンテナを起動したユーザーに限られます。

opstat-job suspend jobName

jobName で指定された運用ステータス監視ジョブを停止します。停止されたジョブは、そのスケジュールに関係なく、実行されずデータも収集しません。ただし、ジョブの定義は残り、opstat-job resume サブコマンドによってそのジョブを再びアクティブにすることができます。jobName は、opstat-job list サブコマンドによって表示されるジョブである必要があります。

セキュリティー:このサブコマンドを実行できるのは、共通エージェントコンテナを起動したユーザーに限られます。

opstat-job resume jobName

jobName で指定された運用ステータス監視ジョブを再開します。再開されたジョブは、そのスケジュールに従ったデータ収集およびレポート送信を開始します。jobName は、opstat-job list サブコマンドによって表示されるジョブである必要があります。これは、opstat-job suspend サブコマンドとペアで機能するコマンドです。

セキュリティー:このサブコマンドを実行できるのは、共通エージェントコンテナを起動したユーザーに限られます。