Web ゲートウェイの管理と監視

システム・ステータスの確認

[システムステータス] オプションには、すべてのアクティブな接続のステータスが表示されます。この機能を使用するには、システム管理者であることが必要です。以下の各表では、列見出しをクリックするとその列を基準にして並べ替えることができます。

サーバ接続のテスト

[サーバ接続のテスト] オプションは、InterSystems IRIS システムへの Web ゲートウェイの接続をテストする際に役立ちます。この機能を使用するには、システム管理者であることが必要です。

CSP 接続をテストするには、以下の手順を実行します。

1. Web ゲートウェイ管理ページから、[サーバ接続のテスト] を選択します。

2. 表示されたリストで、目的の InterSystems IRIS システムを選択します。

3. [接続] を選択します。

選択した内容とサーバ接続の状態に応じて、以下のいずれかの結果が表示されます。

どのような場合でも、エラー状況が返された場合は、Web ゲートウェイ・イベント・ログで追加および具体的なエラー情報を確認します。必要に応じ、ログ・レベルを上げて、追加の診断情報を取得することを検討してください。

イベント・ログの表示

Web ゲートウェイ管理ページのメイン・メニューから [イベントログを参照] オプションを使用して、Web ゲートウェイ・イベント・ログの内容を確認します。

ログ・ファイルが [イベントログ切り替えサイズ] で指定した容量に達すると、このファイルは filename.old (filename は元の完全なファイル名) にコピーされます。[イベントログ切り替えサイズ] が空白の場合 (既定)、このファイルは手動でクリアされるまで増大します。すべてのログを、日付と時刻を含む名前を付けて保存するには、[デフォルトパラメータ] ページの [すべてのログ・ファイルを残す] にチェックを付けます。各ログ・エントリには、そのログ・エントリが作成された日付、時刻、および追加情報を記録したヘッダ・レコードが表示されています。

ログ・エントリは、InterSystems IRIS インスタンスが構造化ログ機能で使用しているものと同じ、機械で判読可能な形式に従っています。つまり、Web ゲートウェイ・イベント・ログの分析には、InterSystems IRIS インスタンスのログの分析に使用しているものと同じサードパーティのツールを使用できます。効率性を高めるため、Web ゲートウェイ・イベント・ログでは、when、level、event、pid、text といった、他の構造化ログで使用されているものと同じフィールド名を使用しています。[イベントログを表示] ページでは、text および details フィールドは、フィールド名なしで表示されています。ただし、CSP.log ファイルで提供されるログ・エントリでは、名前と値のペア (NVP) 形式に完全に準拠しています。

以下に、CSP.log に表示される Web ゲートウェイ・イベント・ログのエントリの例を示します。CSP.log では各エントリが 1 行で記述されます。ただし、この例では、読みやすいように、複数の行に分割されています (\ 文字でマークされています)。

local-time="Thu Jul 21 11:39:20 2022" \
  wg-build="RT 2202.1825 (win32/apapi:srv=2.4.52/apr=1.7.0/apu=1.6.1/mpm=WinNT)" \
  wg-log-level=0 when="2022-07-21 15:39:20.831" level=WARNING event=WebGateway.SessionOpen \
  pid=17216 thread-id=2072 text="Warning" \
  details="A Connection between the Web Gateway and InterSystems IRIS has been found to be \
  closed (possibly as a result of an intermediary, such as a firewall, timing-out the TCP session)"

イベント・ログから現在のすべてのエントリを消去するには、[ログをクリア] を選択します。

ログは日付/時刻の昇順 (既定) または降順で表示できます。 フォームの右上隅にあるリンクを選択すると表示順が逆になります。このリンクには、2 つのモードを切り替える役割があります。

最後に、ほとんどのブラウザでは、1MB ほどを超えるログ・データを 1 つのフォームで表示することはできません。 このため、返されるログ・データの容量が 1MB に達すると Web ゲートウェイは表示を終了し、次ページのデータを表示するようユーザに指示します (フォームの左下隅にある [次] リンクを参照)。 また、フォームの右下隅にある [トップ] ハイパーリンクを使用すると、一連のフォームのうち最初のフォームにすばやく戻ることができます。

HTTP トレース機能の使用法

HTTP トレース機能には [HTTP トレースを表示] オプションからアクセスします。

トレース・ウィンドウは 2 つの主なフレームから構成されています。左側のフレームには、Web ゲートウェイで処理された HTTP 要求のリストがあり、時刻と (Web ゲートウェイから割り当てられた) 一意の要求 ID が示されます。それぞれの要求を選択すると、要求および応答データが右側のフレームに表示されます。リンクにより、要求メッセージと応答メッセージの表示を簡単に切り替えることができます。