システム・モニタの使用

システム・モニタ・プロセス

システム・モニタは、実行場所として構成されている各ネームスペースで、3 つのタイプのクラス (つまり、システム・モニタのコンポーネント) を使用して、以下のように 3 段階でシステム・メトリック情報の収集および配信を実行します。センサ・クラスは情報を収集し、サブスクライバ・クラスは情報を評価して通知を生成し、通知クラスは通知を適切なアラート・システムに送信します。以下に、その順序について詳しく説明します。

1. メトリック情報の取得

   センサ・クラス には、システム・メトリックまたはアプリケーション・メトリックの値を取得するためのメソッドが組み込まれています。例えば、システム・センサ・クラス SYS.Monitor.SystemSensors には、GetProcessCount() メソッド (InterSystems IRIS インスタンスのアクティブなプロセスの数を返す) と GetLockTable() メソッド (インスタンスのロック・テーブルのうち使用中の割合を返す) が含まれています。

   システム・モニタは、構成されている各センサ・クラスの GetSensors() メソッドを定期的に呼び出します。センサ・クラスは、以下のいずれかを実行します。

   • システム・モニタによってサブスクライバ・クラスに渡されるセンサの名前と値の組み合わせの配列を返します (第 2 段階を参照)。

   • 取得したセンサの値を評価して、システム・モニタによって通知クラスに送信される通知を返します (第 3 段階を参照)。

   システム・モニタに付属しているセンサ・クラスの 1 つである SYS.Monitor.SystemSensors が名前と値の配列を返します。もう 1 つのセンサ・クラス %SYS.Monitor.AppMonSensor がそれ自体の評価を実行して、それ自体の通知を生成します。

2. メトリック情報の評価

   サブスクライバ・クラスには、センサの値を評価し、通知を生成するためのメソッドが組み込まれています。システム・モニタは、名前と値の配列を返す各センサ・クラスを呼び出した後に、各サブスクライバ・クラスの Receive() メソッドを呼び出して、SensorReading プロパティにその配列を入力します。サブスクライバ・クラスは、Receive() メソッドに指定されたセンサの名前と値の組み合わせごとに値を評価し、必要に応じてテキストおよび深刻度コードが含まれた通知を返します。

   例えば、システム・モニタが、SYS.Monitor.SystemSensors.GetSensors() から返された値と名前の配列をサブスクライバ・クラスに渡した場合、以下のようになります。

   • システム・サブスクライバ SYS.Monitor.SystemSubscriber は、LockTablePercentFull 値がそのセンサに対する警告しきい値である 85 を超えていることを検出して、深刻度コード 1 と適切なテキストを含む通知を返します。

   • ヘルス・モニタ・スクライバ SYS.Monitor.Health.Control は、ProcessCount 値がそのセンサの構成済みパラメータおよび既定の通常値と比較して大きすぎると判定し、深刻度コード 2 と適切なテキストを含む通知を返します。

3. 通知の生成

   通知クラスには、1 つまたは複数のアラート・システムに通知を渡すためのメソッドが組み込まれています。システム・モニタは、各センサ・クラスおよびサブスクライバ・クラスを呼び出した後に、各通知クラスの Post() メソッドを呼び出して、Notifications プロパティにセンサ・クラスまたはサブスクライバ・クラスから返された通知を入力します。通知クラスは、各通知を目的のアラート・メソッドに渡します。例えば、システム通知は、システム・サブスクライバから返された LockTablePercentFull に関する通知とヘルス・モニタ・サブスクライバから返された ProcessCount に関する通知を受け取ると、深刻度コードとテキストをメッセージ・ログに書き込みます。この手法では、ユーザ定義のアラート・システムのほかに、相互運用プロダクション・アラート・プロセッサや TrakCare 内のアラート・システムなどの独立したアラート・システムにも通知を渡すことができます。

システム・モニタは、インスタンスの起動時に、構成されている各実行開始ネームスペースで自動的に起動し、構成されているセンサ・クラスの呼び出しを開始して、構成されているサブスクライバ・クラスにセンサの値を渡し、次に、構成されている通知クラスに通知を渡します。ネームスペースごとにユーザ独自のシステム・モニタのセンサ・クラス、サブスクライバ・クラス、および通知クラスを定義して構成することができます。"システム・モニタの既定のコンポーネント" の既定クラスを参照してください。

システム・モニタ通知の追跡

通常、システム・モニタのアラート (深刻度 2 の通知) またはシステム・モニタの警告 (深刻度 1) のシーケンスを調査する必要があります。ヘルス・モニタは、システム・モニタのアラートや警告も生成できます。

システム・モニタのアラート、警告、およびステータス・メッセージ (深刻度 0) はメッセージ・ログ (install-dir\mgr\messages.log) に書き込まれます。(すべてのシステム・モニタのステータス・メッセージおよびヘルス・モニタのステータス・メッセージは、システム・モニタ・ログ (install-dir\mgr\SystemMonitor.log) に書き込まれます。アプリケーション・モニタのアラートはログに書き込まれませんが、電子メールで送信したり、指定した通知方法で受け渡しできます。)

システム・モニタのアラートおよび警告を追跡するために、以下のことを実行できます。

• ^%SYSMONMGR ユーティリティを使用して、システム・モニタのアラートを表示します。このオプションを使用すると、すべてのセンサまたは特定のセンサのアラートの表示および記録されているすべてのアラートまたは指定の期間内に発生したアラートのみの表示を行えます。警告は表示しません。

• メッセージ・ログを監視します ("ログ・ファイルの監視" を参照)。システム・モニタのアラートのシーケンスが短期間内に指定されたセンサに対して生成される場合、最初のもののみがメッセージ・ログに書き込まれることに注意してください。

  Note:

  メッセージ・ログでは、システム・モニタ状態通知の最初の文字が大文字で示されます (例 ： [System Monitor] started in %SYS)。警告、アラート、OK メッセージは大文字で示されます (例 ： [SYSTEM MONITOR] CPUusage Warning: CPUusage = 90 ( Warnvalue is 85))。

• メッセージ・ログに表示されるアラート (およびオプションで警告) の電子メール通知を送信するようにログ・モニタを構成します (既定では、アラート・ログに書き込まれます)。この方法を使用する場合、ログ・モニタは、構成された深刻度のすべてのメッセージ・ログ・エントリに対して通知を生成するわけではないことに注意してください。約 1 時間以内に指定プロセス (システム・モニタなど) で連続エントリがある場合、通知は最初のエントリに対してのみ生成されます。例えば、ネットワークの問題によって ECP 接続および開いているトランザクションに関する複数のシステム・モニタのアラートが 15 分の間に生成された場合、ログ・モニタは、(最初に生成されたアラートに対して) 通知を 1 つのみ生成します。このため、ログ・モニタからシステム・モニタの通知を 1 通受け取ったら、すぐにシステム・モニタのアラートを表示し、メッセージ・ログを確認する必要があります。

システム・モニタのステータスおよびリソース・メトリック

以下のテーブルに、システム・モニタによってサンプリングされるシステム・ステータスおよびリソース使用量のメトリックと、警告 (深刻度 1)、アラート (深刻度 2)、および “ステータス OK” (深刻度 0) の通知の生成につながるそれぞれの通知しきい値および通知ルールを示します。

システム・モニタのヘルス状態

InterSystems IRIS インスタンスによって直接生成された両方のシステム・アラート、システム・モニタおよびそのヘルス・モニタ・コンポーネントによって生成されたアラートおよび警告など、メッセージ・ログに送信された通知に基づいて ("ログ・ファイルの監視" を参照)、システム・ヘルス全体を表す単一値を共有メモリのレジスタにシステム・モニタは保持します。

起動時、システム・ヘルスの状態は、起動プロセス中にメッセージ・ログに送信されたシステム (システム・モニタではない) のアラート数に基づいて設定されます。システム・モニタが実行されると、システムのアラートまたはシステム・モニタのアラートあるいは警告によってヘルス状態を引き上げることができます。最後のシステムのアラートまたはシステム・モニタのアラートあるいは警告が送信されてから 30 分が経過すると、ステータスは次に低いレベルに引き下げられます。以下の表に、システム・ヘルス状態がどのように決まるかを示します。

システム・モニタのヘルス状態は、以下を使用して表示できます。

• ^%SYSMONMGR の [システム・データを表示] メニューにある [システム・ヘルスの表示] オプション (HUNG はレポートしません)。

• $SYSTEM.Monitor API。システム・ステータスに直接アクセスできます。$SYSTEM.Monitor.State()Opens in a new tab を使用して、システム・ステータスを返します。SetState メソッド、Clear メソッド、Alert メソッド、GetAlerts メソッド、および ClearAlerts メソッドも参照してください。

• iris list コマンドおよび iris qlist コマンド (Windows のヘルス状態は含まれません)。

システム・モニタの既定値

システム・モニタは、拡張可能な一連の付属のクラスを呼び出し、%SYS ネームスペースで稼働し、変更可能な 3 つの既定の設定で動作します。

^%SYSMONMGR ユーティリティの使用

^%SYSMONMGR ユーティリティでは、システム・モニタを管理および構成できます。このユーティリティは任意のネームスペースで実行できます。このユーティリティを使用して行った変更は、このユーティリティが起動されたネームスペースにのみ影響します。ネームスペースで ^%SYSMONMGR を実行して構成した実行開始ネームスペースごとに個別のシステム・モニタ構成を保持する必要があります。あるネームスペースのシステム・モニタ構成に変更を加えた後は、変更を有効にするためにそのネームスペースでシステム・モニタを再起動する必要があります。

システム・モニタを管理するには、ターミナルで以下のコマンドを入力します。

%SYS>do ^%SYSMONMGR

メイン・メニューが表示されます。

1) Start/Stop System Monitor
2) Set System Monitor Options
3) Configure System Monitor Classes
4) View System Monitor State
5) Manage Application Monitor
6) Manage Health Monitor
7) View System Data
8) Exit 

Option? 

実行する操作の番号を入力します。ユーティリティを終了するには Enter キーを押します。

メイン・メニューのオプションでは、以下のテーブルに示すシステム・モニタのタスクを実行できます。

Start/Stop System Monitor

システム・モニタは、InterSystems IRIS インスタンスの起動時に、構成されている各実行開始ネームスペースで自動的に起動し、構成されているクラスの呼び出しを開始します。これは、変更できません。ただし、インスタンスの実行中に、システム・モニタを停止することはできます。ヘルス・モニタの構成を変更するには、システム・モニタを停止する必要があります。また、あるネームスペースのシステム・モニタ構成に変更を加えた後は、変更を有効にするためにそのネームスペースでシステム・モニタを再起動する必要があります。

メイン・メニューで 1 を入力すると、以下のメニューが表示されます。

1) Start System Monitor
2) Stop System Monitor
3) Exit

実行中のシステム・モニタを停止するには 2 を入力し、停止中のシステム・モニタを起動するには 1 を入力します。

Note:

システム・モニタは、メッセージ・ログのサイズを監視し、必要に応じてロール・オーバーします。システム・モニタが停止すると、メッセージ・ログは、インスタンスが再起動されるか、PurgeErrorsAndLogs タスクが実行されるまで、MaxConsoleLogSize 構成設定で設定された制限を超える場合があります。メッセージ・ログについては、"ログ・ファイルの監視" を参照してください。

Set System Monitor Options

システム・モニタのグローバル設定を変更するか、それらの設定を既定値に戻すには、システム・モニタが実行中の場合はシステム・モニタを停止し、メイン・メニューで 2 を入力します。

1) Set Sample Interval
2) Set Debugging Level
3) Reset Defaults
4) Manage Debug Data
5) Exit

1 を入力して、システム・モニタが構成されている各センサ・クラスを呼び出す間隔を設定します。既定値は 30 秒です。

2 を入力して、デバッグ・レベルを設定します。既定値は 0 (base) で、システム・モニタおよびヘルス・モニタのステータスとエラー・メッセージがシステム・モニタ・ログに書き込まれます。センサの読み取り値は保存されません。デバッグ・レベル 1 (log all sensors) では、センサ読み取り値がメッセージとともにシステム・モニタ・ログに書き込まれ、センサ読み取り値が保存されます。これは、[システム・データを表示] メニューの [センサ・データの表示] オプションを使用して表示することができます。

3 を入力して、サンプル間隔、デバッグ・レベル、およびセンサ読み取り値の保存を既定値にリセットします。

4 を入力して、センサ読み取り値を保存する日数を設定します (既定は 5)。

変更は、次回システム・モニタを起動または再起動したときに有効になります。

Configure System Monitor Components

"システム・モニタ" で説明したように、%SYS.Monitor.AbstractSensorOpens in a new tab、%SYS.Monitor.AbstractSubscriberOpens in a new tab、および %SYS.Monitor.AbstractNotificationOpens in a new tab をそれぞれ拡張して、独自のセンサ・クラス、サブスクライバ・クラス、および通知クラスを作成し、それらをシステム・モニタで構成して、"システム・モニタの既定のコンポーネント" で説明した付属のクラスの機能を拡張することができます。システム・モニタを起動および実行する場所として %SYS 以外のネームスペースを追加することもできます。

Configure System Monitor Classes

メイン・メニューで 3 を入力すると、以下のメニューが表示されます。

1) Configure Components
2) Configure Startup Namespaces
3) Exit

1 を入力すると、クラスを構成するための以下のオプションが表示されます。

1) List Classes
2) Add Class
3) Delete Class
4) Exit

1 を入力すると、^%SYSMONMGR を起動したネームスペースで現在構成されているクラス (付属のシステム・クラスおよびユーザが構成したクラスを含む) がリストされます。

2 を入力すると、^%SYSMONMGR を起動したネームスペースのユーザ定義のクラスを構成できます。指定するクラスは、そのネームスペースに存在し、システム・モニタによって有効なセンサ・クラス、サブスクライバ・クラス、または通知クラスとして認識される必要があります。また、クラスの説明を入力することもできます。

3 を入力すると、構成したユーザ定義クラスを削除できます。

Note:

クラスの構成または削除は、^%SYSMONMGR を起動したネームスペースにのみ影響します。

Configure System Monitor Namespaces

システム・モニタは、インスタンスの起動時に、構成されている各実行開始ネームスペース (既定では %SYS のみ) で個別のプロセスとして自動的に起動します。すべてのシステム・モニタの構成と設定は、ネームスペースに固有です。^%SYSMONMGR を使用して変更を加えた場合、その変更はこのユーティリティを起動したネームスペースにのみ影響します。

Note:

^%SYSMONMGR のすべてのインスタンスは、同一のシステム・モニタ・ログにメッセージを書き込みます。実行開始ネームスペースは、任意のネームスペースから構成できます。

メイン・メニューで 3 を入力すると、以下のメニューが表示されます。

1) Configure Components
2) Configure Startup Namespaces
3) Exit

2 を入力すると、ネームスペースを構成するための以下のオプションが表示されます。

1) List Startup Namespaces
2) Add Namespace
3) Delete Namespace
4) Exit

1 を入力すると、現在構成されている実行開始ネームスペースがリストされます。

2 を入力すると、実行開始ネームスペースを追加できます。

3 を入力すると、実行開始ネームスペースを削除できます。(%SYS は削除できません。)

View System Monitor State

メイン・メニューで 4 を入力すると、^%SYSMONMGR を起動したネームスペースのシステム・モニタとそのコンポーネントのステータスが表示されます。以下に例を示します。

       Component                   State
System Monitor                     OK
%SYS.Monitor.AppMonSensor          None
SYS.Monitor.SystemSensors          OK
SYS.Monitor.Health.Control         Running: Period is Thursday 09:00 - 11:30
SYS.Monitor.SystemSubscriber       OK
SYS.Monitor.SystemNotifier         OK

この例では、システム・モニタとそのシステム・センサ・クラス、サブスクライバ・クラス、および通知クラスが正常に動作しています。ヘルス・モニタのサブスクライバ・クラスも同様です。ただし、アプリケーション・モニタのクラスは有効化されていないため ("Manage Monitor Classes" を参照)、センサのサンプルの評価やアラートの生成は実行しません。

システム・データの表示

メイン・メニューで 7 (または、%SYS 以外のネームスペースでは 6) を入力して、システムに関するシステム・モニタ情報を表示するオプションを表示します。

1) View Sensor Data
2) View System Health
3) View Alerts
4) Exit

[Set System Monitor Options] メニューの [Manage Debug Data] オプションを使用して、センサ・データの読み取り値の保存を有効化した場合、1 を入力して、保存されたセンサの読み取り値を表示します。すべてのセンサまたは特定のセンサの保存された読み取り値を表示できます。また、保存されているセンサの読み取り値すべてを表示するか、または指定した期間の読み取り値のみを表示できます。

2 を入力して、システム・モニタのヘルス状態を表示します。これには、前の GREEN 状態と現在の状態 (GREEN でない場合) の間のすべてのアラートが含まれます。

3 を入力してシステム・モニタのアラートを表示します。すべてのセンサまたは特定のセンサのアラートを表示できます。また、[Set System Monitor Options] メニューの [Manage Debug Data] オプションを使用して指定した期間内のすべてのアラートを表示できます。あるいは、指定した期間内のアラートのみ表示できます。

システム・モニタのコンポーネントの定義

SYS.Monitor API で、ユーザ独自のセンサ・クラス、サブスクライバ・クラス、および通知クラスを定義できます。

関連項目

• システム・モニタ・ツールの概要

• システム・モニタの使用

• ヘルス・モニタの使用法

• アプリケーション・モニタ

• システム監視ツール

• Manage Email Options (システム・モニタによって生成されるものを含め、メッセージ・ログ内の通知からの電子メール・メッセージの生成に関する情報)

• ログ・ファイルの監視 (このツールによって生成されるログ・ファイルに関する情報を含む)