ISCLOG でのログの有効化

CSP に関する問題のトラブルシューティングを行うには、ターミナルで以下のコマンドを入力することによって、Caché のログを有効にします。

 Set ^%ISCLOG = 2

ログ情報は ^ISCLOG グローバルで表示できます。このグローバルは、Caché でのイベントを記録してデバッグに備えます。参照として、以下にログのレベルを示します。

0 — Caché はログを記録しません。
1 — Caché は、例外的なイベント (エラー・メッセージなど) のみをログに記録します。
2 — Caché は、method ABC invoked with parameters X,Y,Z and returned 1234 などの詳細な情報をログに記録します。
3 — Caché は、HTTP 要求から受け取ったデータなどの未処理のデータをログに記録します。

以下のいずれかのコマンドで Caché のログをオフにできます。

 Set ^%ISCLOG = 0

または

 Kill ^%ISCLOG

ISCLOG では、以下に示すように、一部のエントリは、イベント・ログのヘッダ・フィールドに一致します。

ISCLOG	イベント・ログ
Job	Cache-PID
SessionId	Session-ID
Tag	Request-ID

以下のテーブルは、ISCLOG のフィールドと定義を示しています。

ISCLOG のフィールド

フィールド	定義
%category	CSPServer ： cspServer、cspServer2、%request、%response からのログが記録されます。
	CSPSession ： %session からのログ、および cspServer と cspServer2 のうちセッションを処理する部分からのログが記録されます。これにより、セッションのライフサイクルを監視できます。
	CSPLicense ： cspServer と cspServer2 のうちライセンスを処理する部分からのログが記録されます。
	Gateway Request ： GatewayMgr、GatewayRegistry、ゲートウェイ要求ハンドラからのログ、および cspServer2 のうちゲートウェイ要求を処理する部分からのログが記録されます。
%level	1= 例外とエラー。
	2=CSPSession に関する情報。CSPLicense に関する情報。 cspServer からの情報： %response、%session、および %request の設定後の要求処理の一部。これには、認証、ライセンス処理、リダイレクト、および CSPpage の呼び出しが含まれます。
	3= cspServer2 からの情報：要求処理のうち、%response、%session、%request、および CSP ゲートウェイとのハンドシェイク/データ転送を設定する部分。
%job	ISCLOG 要求の生成時の $job の値。イベント・ログのヘッダの Cache-PID フィールドに一致します。
%sessionid	使用可能な場合に入力されます。ISCLOG 要求の生成時のsessionid の値。イベント・ログのヘッダの Session-ID フィールドに一致します。
%tag	CSP サーバの場合、タグには、ゲートウェイからの要求 ID が含まれます (使用可能な場合)。これは、イベント・ログのヘッダの Request-ID フィールドに一致します。他のログ記録機能によって、この値を任意の値に設定することができます。 ISCLOG エントリの作成者が使用できます。CSP ゲートウェイから送信されてきた要求の ID を格納します。ISCLOG エントリを生成する場合のフィルタとして使用できます。 Set ^%ISCLOG("Tag","mytagvalue1")=1 Set ^%ISCLOG("Tag","mytagvalue2")=1 タグが付いていない ISCLOG 要求、または "mytagvalue1" タグか "mytagvalue2" タグが付いている ISCLOG 要求のみが記録されます。
%routine	現在実行されているルーチンの名前。
%message	後述の "メッセージ形式" のセクションを参照してください。

メッセージ形式

メッセージの先頭には、タグ・ラベルの名前、または現在実行されているメソッドの名前が出力されます。この名前は角括弧で囲まれています。[MyMethod] 以降のメッセージ部分。

CSPSession カテゴリのメッセージの場合は、メソッド名の後に CSPSession-Id=sessid も付きます。これは、セッションの作成前または破棄後、つまり ISCLOG エントリの SessionId フィールドが空の場合に、セッション・イベントのログを記録するために必要です。

[MyMethod] CSPSession-Id: 12ty34ui22

GatewayRegistry カテゴリのメッセージの場合は、メソッド名の後に CSPID=cspid も付きます (使用可能な場合)。これによって、ゲートウェイ要求ハンドラを介して、API 呼び出しからの個々のゲートウェイ要求を追跡できるようになります。

 [MyMethod]CSPID:334r43345 rest of message