イベント・ログの表示
この章では、イベント・ログの目的とその使用方法について説明します。この章は以下の節で構成されています。
イベント・ログの概要
イベント・ログは、特定のネームスペース内で実行中のプロダクションで発生したイベントが記録されたテーブルです。イベント・ログの主な目的は、プロダクションの実行中に問題が発生した場合に役立つ診断情報を提供することです。これには以下の項目が含まれます。
-
システムによって生成されたイベント・ログ・エントリ。これらのエントリは、プロダクションの開始などのイベントに対して生成されるものであり、このドキュメントでは詳しく説明していません。
これらのイベントは Ensemble 内部で生成され、処理されるシステム・イベントとは違うことに注意してください。例えば、システム・イベントにはバックグラウンド・プロセスの休止と再開が含まれます。Ensemble イベント・ログにはシステム・イベントが記録されません。
-
プロダクション内で使用されたビジネス・ホスト・クラスによって生成されたイベント・ログ・エントリ。詳細は、"Ensemble プロダクションの開発" の “Ensemble のプログラミング” の章で “イベント・ログ・エントリの生成” を参照してください。
標準的なプロダクションでは、これがイベント・ログ内で最も一般的な種類のエントリです。
-
アラート。アラートは、Ensemble プロダクションの実行中にアラート・イベントが発生した場合に該当するユーザに通知を送信します。その目的は、システム管理者またはサービス技術者に問題の存在を警告することです。アラートは電子メール、携帯電話、またはその他のメカニズムにより送信されます。すべてのアラートがイベント・ログに記録されます。
アラートを送信するためのプロダクションの構成方法は、"Ensemble の構成" の “アラートの構成” を参照してください。この章では、特定のイベントでアラートが発生する条件を指定した設定に関する情報も提供します。
-
トレース・メッセージ。トレース・メッセージについては、このドキュメントの後半で説明します。
イベント・ログを表示することによって、プロダクションの実行中に生成された情報テキスト・メッセージを調べて、プロダクションの “状態を把握する” ことができます。イベント・ログのエントリは、Ensemble データベースに永続的に格納されます。ログが蓄積されたら、時間の経過に応じてパージされます。
イベント・ログ・ページの概要
管理ポータルからイベント・ログを表示するには、[Ensemble]、[表示] の順にクリックしてから、[イベントログ] をクリックします。Ensemble に Ensemble, イベントログ ページが表示されます。
このページは以下の 3 つのペインで構成されており、各ペインではその下に示している操作を実行できます。
左 | 中央 | 右 |
---|---|---|
検索条件とパージ条件の入力 | イベント・ログ・エントリの表示 | イベント詳細の表示 |
二重矢印アイコンを使用して、右側と左側のペインを展開/縮小できます。
[イベント・ログ] ページには以下のコマンドがあります。
-
[検索] — 選択すると、左側のペインに表示されている条件に基づいて、イベント・エントリのリストをソートおよびフィルタリングできます。詳細は、“イベントの検索基準” を参照してください。
-
[キャンセル] — 選択すると、現在の検索を取り消すことができます。
-
[リセット] — 選択すると、イベント・ログ検索条件を、選択したイベント・タイプおよびクイック検索フィールドのデフォルト値にリセットできます。詳細は、“クイック検索” および “イベント・タイプ” を参照してください。
-
[前] — 選択すると、[ページサイズ] に基づいて前の結果ページが表示されます。
-
[次] — 選択すると、[ページサイズ] に基づいて次の結果ページが表示されます。
-
[エクスポート] — 選択すると、選択したエントリをテキスト・ファイル、タブ区切り (.csvファイル)、HTML または XML ファイルにエクスポートできます。このエクスポート・ファイルは、開発者やインターシステムズのサポート窓口が問題をトラブルシューティングするのに役立ちます。任意のアプリケーションを使用して、エクスポートされたイベント・ファイルを調べることができますが、エクスポート・ファイルは Ensemble にインポートすることを目的としていません。エクスポート・ファイルの形式を指定するには、[すべてのファイル (*)] ファイル・タイプ・オプションを選択してから、ファイル名に .txt、.csv、.html、または .xml というファイル・タイプを明示的に入力してください。
検索条件とパージ条件の入力
左側のペインを使用して、イベントのリストをフィルタリングするための検索条件とパージ条件を入力できます。
以下の 3 つのタイプの検索フィルタがあります。
または、次の節で説明されているように、イベント・ログからエントリを削除できます。
クイック検索
イベント・リストをフィルタリングするには、以下の値を入力します。
-
[ソート順序] — 最も古いエントリと最新エントリのどちらから順にエントリをリストするかを選択します。デフォルトは [新しいものから] です。
-
[ページサイズ] — 結果結果として中央のパネルに表示するイベント・ログ・エントリの最大数。追加のエントリを表示するには、[前へ] または [次へ] をクリックします。デフォルトは 500 です。
-
[ページ] — (読み取り専用) リストのどのページを表示するかを指定します。
-
[時刻形式] — 時刻のみを表示するか、日付と時刻を表示するかを選択します。デフォルトは [日付と時刻] です。
-
[自動更新] — リストを更新する時間間隔を選択するか、[なし] を選択します。デフォルトは [なし] (自動更新しない) です。
これらのフィールドに値を入力すると、中央のペインが更新され、入力内容が反映されます。
イベント・タイプ
必要と判断したイベントをフィルタリングするには、以下のチェックボックスにチェックを付けるかチェックを外します。
-
アサート
-
エラー
-
警告
-
情報
-
トレース
-
アラート
デフォルトのリストでは、すべてのタイプのイベントが表示されます (それぞれのイベント・タイプが選択されます)。
イベントの検索基準
[イベント・ログ] ページに表示したいメッセージが表示されない場合は、エントリのリストをフィルタリングできます。そのためには、以下のフィールドのうち 1 つ以上に値を入力します。
-
[開始時刻] — [ログ日時] 値の範囲の下限を入力します。
-
[開始ID] — [ID] 値の範囲の下限を入力します。
-
[終了時刻] — [ログ日時] 値の範囲の上限を入力します。
-
[終了ID] — [ID] 値の範囲の上限を入力します。
-
[ソース構成項目] — 構成項目を選択するか、いずれかの構成項目の名前を入力します。
-
[ソースクラス] — 特定のホスト・クラスによってログに記録されたすべてのイベントをリストするには、このフィールドに値を入力します。
-
[セッションID] — 特定のセッションに関連付けられたイベント・ログ・エントリをすべて検索します。
-
[ソース・メソッド] — 特定のメソッドによってログに記録されたすべてのイベントをリストするには、このフィールドに値を入力します。
-
[ジョブ] — 特定のシステム・ジョブによってホストされているイベントを検索するには、このフィールドに値を入力します。
-
[テキスト] — このフィールドに文字列値を入力し、テキストにこの文字列を含むすべてのイベントをリストします。
新しい検索条件を入力したら、リボン・バーの [検索] をクリックします。それにより、検索条件に従ってリストが更新されます。
イベント・ログのパージ
古くなったレコードを Ensemble イベント・ログからパージするには、エントリを保持する日数を入力して [パージ] をクリックします。
表示されるフィールドは、以下のようにイベント・ログ・エントリをパージするのに役立ちます。
-
[現在のカウント] — このプロダクションの永続ストアに現在格納されているイベント・ログ・エントリの合計数を表示する読み取り専用フィールド。[現在のカウント] を使用して、この段階でイベント・ログをパージした方がよいかどうかを判断します。
-
[これよりも新しいものをパージしない] — パージ操作のパラメータ。何日分のログを残しておくかを Ensemble で指定します。デフォルト値の 7 を使用すると、直近 7 日間のエントリが保持されます。ログのすべてのエントリをパージするには、[日] フィールドに 0 と入力します。
日数には、本日も含まれるので、1 日分のメッセージを保存する場合は、ローカル・サーバの時刻での本日に生成されたメッセージが保存されます。
[削除] をクリックすると、入力したパラメータに従ってイベント・ログのパージが直ちに開始されます。
[削除] 操作を取り消すことはできません。
ポータルには、イベント・ログを他の管理データと一緒にパージ可能な別のページが用意されています。"Ensemble の管理" の “データのパージ” を参照してください。
イベント・ログ・エントリの表示
プロダクションのライフ・サイクルで対象のイベントが発生するたびに、Ensemble はそのイベントの詳細を示すエントリをイベント・ログに書き込みます。このログは、管理ポータルの Ensemble, イベント・ログ ページで表示できます。このページのリストでは、それぞれのイベント・ログ・エントリについて以下の情報が表示されます。
-
[タイプ] — エントリのタイプを示します。タイプは、アラート、アサート、エラー、情報、トレース、または警告のいずれかです。列の色は次のようにイベント・タイプも示しています。
イベント・タイプ 列の配色 アラート 黄色の背景に赤色の太字テキスト アサート シルバーの背景に赤色の太字テキスト エラー ピンクの背景に赤色の太字テキスト 情報 (プロダクションの開始) 緑色の背景に緑色の太字テキスト 情報 (プロダクションの停止) 緑色の背景に緑色の太字テキスト トレース 淡青色の背景に青色の太字テキスト 警告 オレンジの背景に赤色の太字テキスト 情報 (その他すべて) デフォルトの行の色 -
[ID] — このイベント・ログ・エントリを構成しているメッセージの一意の識別子。
-
[ログ日時] — このエントリのログを記録した日時。
-
[セッション] — このメッセージに関連付けられたセッション ID。最初の章の “セッション” を参照してください。
[セッション] リンクをクリックすると、そのイベントが含まれていたセッションのビジュアル・トレースを表示できます。
-
[ジョブ] — このイベントをホストしたシステム・ジョブ。
-
[ソース] — メッセージを送信した構成項目 (サービス、プロセス、またはオペレーション)
-
[テキスト] — イベント・ログ・エントリに関連付けられたテキスト文字列。
イベント詳細の表示
任意のログ・エントリを選択して、そのエントリに対応するイベントの詳細を表示できます。中央のペインで行を選択すると、展開された右側のペインに以下の情報フィールドが表示されます。
このイベント・ログ・エントリを構成しているメッセージの一意の識別子。
エントリのタイプを示します。タイプは、アラート、アサート、エラー、情報、トレース、または警告のいずれかです。このタイプでは、リスト・エントリと同じ配色が使用されます。
このイベント・ログ・エントリに関連付けられたテキスト文字列。
このエントリがログに記録された日時。
該当メッセージを送信した構成項目 (サービス、プロセス、またはオペレーション)。
このメッセージに関連付けられたセッションの ID。最初の章の “セッション” を参照してください。
このイベントにセッション ID が設定されている場合は、右側のペインの上部にある [トレース] をクリックすると、このイベントが含まれていたセッションのビジュアル・トレースを表示できます。
このイベントをホストしたシステム・ジョブ。
このイベントをログに記録したビジネス・ホスト・クラス。
イベントが記録されたときに実行していたビジネス・ホスト・クラスのメソッド。
(なし)
エラーにつながる命令のリスト。