Skip to main content

Tracer

TracerはPega Platform™ で使用可能なトラブルシューティングを支援するツールです。 アプリケーションでエラーが発生した場合は、原因を特定する必要があります。 エラーの原因となったイベントを確認することで、根本原因を見つけ、問題を解決できます。

たとえば、プロパティ値の設定に使われるデクレアエクスプレッションで想定外の値が返されることがあります。 このプロパティ値は特定のワークフローステージをスキップするかどうかを判断するために使用されます。 ユーザーはケースが想定外のステージに進んだことに気づき、デクレアエクスプレッションプロパティがUIに表示されていないことを発見します。 Tracerツールは実行イベントのシーケンスを文書化し、ユーザーがこのエラーをトラブルシューティングできるようにします。

別の例では、アプリケーションがデータページを使用して都市名のドロップダウンリストにデータを挿入しているとします。 ドロップダウンリストの内容が間違っている場合は、データソースへのコントロールや接続の設定が適切かどうかを判断する必要があります。

次の画像では、ドロップダウンリストの都市のリストに州が含まれています。

Drop down choices wrong city

TracerツールとClipboardツール

アプリケーションの実行に伴って、Pega Platformでは、実行結果として発生するすべてのプロセスイベントがログに記録されます。 Tracerは、メモリー内にあるプロパティの現在の値を提供するClipboardツールとは異なり、ケースの処理中に発生するイベントの完全なログを提供します。 このログを使って、実行エラーの原因(Java例外や不正なプロパティ値など)を特定できます。

次の図の中央付近にある垂直線を左右に動かして、ClipboardツールとTracerツールの違いを確認してください。

注: Tracerを実行すると、ルールの実行のために収集されるデータ量が増えるため、アプリケーションのパフォーマンスに大きな影響が及びます。 ベストプラクティスとしては、Tracerをパフォーマンス分析ツールとしては使用しないでください。 Tracerの詳細については、「Tracer best practices」を参照してください。

ケース処理時のエラーの特定

ケース処理のエラーの特定に役立つよう、Tracerは、エラーが発生した処理ステップを特定します。 Tracerログの「Status」列はエラーの原因となった処理ステップの特定に役立ちます。 Tracerログでは、ほとんどのステップで、ステップが正常に完了したことを示すGoodステータスが返されます。 ステップでFailステータスが返された場合は、エラーが発生しており、そのステップは正常に完了していないことを示しています。

次の図は、Tracerツールが失敗したステップを表示する様子を示しています。

Tracer log with error detail

 

アプリケーションのエラーは、失敗したシーケンスの原因ではなく、失敗した一連のステップの最後のステップのみを示すことがあります。 Tracerでイベントのシーケンスを確認すると、ユーザーに対して表示されたエラーの根本原因を特定するのに役立ちます。

Tracerツールで、失敗したステップをクリックすると、そのイベントのプロパティが表示されます。 次の図では、失敗したステップのプロパティを示しています。

Tracer log with error detail

 

補足: エラーの根本原因の特定について詳しくは、「Tracing and capturing events」を参照してください。

 

以下のインタラクションで理解度をチェックしてください。


このトピックは、下記のモジュールにも含まれています。

If you are having problems with your training, please review the Pega Academy Support FAQs.

このコンテンツは役に立ちましたか?

改善できるところはありますか?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice