はじめに
CAIプロセスの実装をしていると、エラーが発生することがあります。標準の設定では、エラー発生時のステップを特定できないためトラブルシューティングに苦慮する場合もあると思いますが、ログレベル(CAIプロセスではトレースレベルと呼びます)を適切に設定することでエラー箇所の確認・原因の特定が容易になります。
この記事では次のポイントについて確認します。
- CAIプロセスをデバッグするための設定
- デバッグ設定時の動作
なお、この記事は次の記事の内容を理解していることを前提としています。
CAIプロセスをデバッグするための設定
開始ステップの 詳細 タブから トレースレベル を変更することでCAIプロセスをデバッグするために有用な情報を得られます。
トレースレベルは 詳細(Verbose) を選択した場合に最も詳細な情報が得られますが、デバッグ情報を記録するために動作遅延が起こる可能性がある点に留意します。
| トレースレベル | Error | Step tick | Data | コメント |
|---|---|---|---|---|
| なし(None) | × | × | × | |
| 簡易(Terse) | ○ | × | × | Error発生ステップを確認できる |
| 標準(Normal) | ○ | ○ | × | 各ステップの実行状況を確認できる |
| 詳細(Verbose) | ○ | ○ | ○ | 詳細ビューの情報強化 |
デバッグ設定時の動作
次のスクリーンショットは実際に トレースレベル を 詳細(Verbose) とした場合の表示例です(アプリケーション統合コンソールの プロセス タブにて、プロセスの ID をクリックして画面を切り替えています)。
簡易(Terse)を有効にしている場合、エラーが発生したステップに
が表示されます。
標準(Normal)または詳細(Verbose)を有効化にしている場合、エラー発生ステップに加えて、ステップの実行状況(Step tick)を
として確認できます。
トレースレベルを上げることで、各ステップの入出力フィールドにどのような値が設定されているかを確認することもできます。次のスクリーンショットでは、トレースレベルを標準以上にすることで、計算式により生成したOSコマンドにスペースが含まれていないこと(そのために期待した動作になっていないこと)を確認しています。
トレースレベルの自動リセット機能
CAIプロセスを クラウドサーバー にデプロイしている場合、トレースレベルが自動で低い値にリセットされている場合があります(製品ドキュメントのリンク - Automatic reset of tracing levels)。
例えば、もともと トレースレベル=詳細 でパブリッシュした後に、再度 トレースレベル=詳細 を選択した際に次の表示となる場合、この機能が働いている可能性があります。
入出力フィールドの値が表示されない？
特に、CAIプロセスのデプロイ先をSecure Agentとしている場合、トレースレベルを上げていても入出力フィールドの値が表示されない動作に出くわすことがあると思います。この動作は、入出力フィールドの情報取得に時間を要している可能性があります(入出力タブを表示すると、IICS・Secure Agent間で通信が行われ、入出力フィールドの情報を取得しています)。
もし、うまく入出力フィールドタブの情報が表示されない場合は、画面右上の更新ボタンをクリック、その後、出力フィールドタブ(または入力フィールドタブ)を選択して、5-60秒ほど待ってみましょう。
表示の遅延動作の他、データサイズが大きい場合に入出力フィールドの値が表示されない動作もあります。
ERROR: Unable to see the output of a service step in Application Integration console
The reason for not displaying the output data on the UI is that the output data is more than 51200 bytes.