ISCLOG でのログの有効化
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 のフィールドと定義を示しています。
フィールド | 定義 |
---|---|
%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