ログファイル

ログファイルには、日常的なシステムステータス情報からアプリケーションが予期せず終了するような深刻なエラーまで、さまざまなイベントの通知が記録されます。アペンダーは、各ログを管理し、ログファイルに書き込むイベントのタイプを決定します。利用できるログファイルは、システム設定で構成されたログファイルアペンダーによって異なります。

Pega Platformでは、以下の一般的なログファイルを使用します。

• PEGAログには、内部操作に関するワーニング、エラー、情報が含まれています。このログは、コンソールログやシステムログとしても知られ、アプリケーションのデバッグに使用できます。 
• ALERTログには、操作が指定されたパフォーマンス閾値を超えたときに発生するパフォーマンス関連のアラートが含まれます。
• ALERTSECURITYログには、Internet Application Composer ファシリティの不適切な構成や、urlの改ざんによりPega Platformノードのシステムセキュリティ機能をバイパスしようとする露骨な試みを示唆するアラート（プレフィックスSECUで識別）が含まれます。
• BIXログには、抽出処理中にBusiness Intelligence Exchange（BIX）が生成したエントリーが含まれます。 BIXはオプションのアドオン製品で、Pegaデータベースからトランザクションデータを抽出し、レポートデータウェアハウスやオペレーショナルデータストア（ODS）、その他のダウンストリームプロセスへのエクスポートに適したフォーマットに変換します。
• CLUSTERログには、クラスターのセットアップと実行時の動作に関する情報が含まれています。
• DATAFLOW ログには、実行中のスレッド数や新しく作成されたスレッドや停止したスレッドなど、システム内のデータフローイベントに関する情報が含まれています。 
• MOBILEログには、モバイルアプリケーションの実行に関する情報が含まれています。ユーザーのログを取得し、ファイルに含める情報の量を指定できます。
• PegaRULES-SecurityEventログには、ログインの失敗やパスワードの変更など、セキュリティ関連のイベントに関する情報が含まれています。

Pega Cloud®環境におけるログファイル 

以下のログファイルは、Pega Cloud®環境で利用できます。

• PegaRULESログには、システムエラー、例外、デバッグステートメント、アラートとして指定されていないメッセージに関するデバッグ情報が含まれています。
• PegaCLUSTERログには、Pega環境が実行されている基盤のインフラストラクチャのセットアップと実行時の動作に関する情報が含まれています。
• PegaRULES-ALERTログには、パフォーマンスのしきい値を超えた障害やシステムイベントの診断メッセージが含まれています。
• PegaRULES-ALERTSECURITYログには、Pegaウェブノードのセキュリティが危険にさらされている場合に生成されるアラートが含まれています。
• PegaRULES-SecurityEventログには、Pegaウェブノードで生成されたセキュリティイベントが含まれています。
• PegaDATAFLOWログには、データフローの実行と内部的なデータフローの実行を開始するキュープロセッサーに影響を与えるイベントが含まれています。 
• PegaUSAGEログには、Pega Platformが1時間に1回およびログオフ時に生成する各リクエスターのパフォーマンスの詳細が含まれています。 
• locahost_accessログには、HTTPリクエストのさまざまなパラメーターが含まれる、アプリケーションへの各リクエストのレコードが含まれています。 

Dev StudioのLogs タブのLog utilitiesセクション（「Configure」>「System」>「Operations」>「Logs」）からログファイルにアクセスし、「Log utilities」を開きます。Log utilitiesセクションには、ログファイルアペンダーのリストと外部ログビューアーが含まれています。「Log files」をクリックすると、システム上でアクティブになっているログファイルアペンダーのリストが表示されます。

次の図は、各アペンダーの例を示しています。ログファイルを表示したり、ログファイルをフォーマットされていないテキストファイルまたは圧縮されたZIPファイルとしてダウンロードしたりするためのリンクが付いていることがわかります。

次の画像で、「+」アイコンをクリックすると、PEGAログファイルの内容の表示の詳細を表示できます。

PegaRULES Log Analyzer

PegaRULES Log Analyzer （PLA）は、開発者やシステム管理者がシステムログデータの統合サマリーを表示するために使用できるスタンドアロンのウェブアプリケーションです。

PLAを使用して、ユーザー受け入れテスト（UAT）、パフォーマンステスト、ストレステスト、および本番環境へのデプロイメント直後に、新規または再構成されたPega Platformアプリケーションをテストします。パフォーマンス、安定性、およびスケーリングの問題は、これらのタイミングで最も発生しやすいため、再構成されたアプリケーションを、UAT中、パフォーマンステスト中、およびデプロイメントの直後にテストすることは重要です。

PLAは、ALERT、PEGA、およびGC（Garbage Collection）のログを統合し、要約します。このログデータから、開発者やシステム管理者がパフォーマンス上の問題を迅速に特定、診断、対処するために必要な、処理およびシステム健全性に関する重要な情報を得られます。

Pega-LogViewer 

Pega-LogViewerは、Pegaログファイルの理解とデバッグに役立つJava Swingベースのログ表示ツールです。 LogViewerは、RULES、ALERT、SecurityAlert、Computer Telephony Integration（CTI）など、Pegaが生成したログファイルのほとんどを読み取ることができます。 

システム管理者は、ログカテゴリーを作成することで、Admin Studioでログレベルの設定をオーバーライドし、Pegaログに表示されるログイベントを管理することができます。 

ログカテゴリーが存在しなかった以前のバージョンのPega Platformでは、ログのカスタマイズはprlogging.xmlファイルまたはprlog4j2.xmlファイルを更新することにより行われていました。各システムイベントについて、prlog4j2.xml構成ファイルでは、どのイベントをログに記録するかを判定するための閾値を定義しています。 イベントは選択されたログレベル以上についてのみ記録されます。たとえば、イベントにERRORログレベルが設定されている場合、FATALイベントやERRORイベントのみがログに記録され、システムはINFOイベントを無視します。 マルチノードのPega環境では、各ノードに別々のprlog4j2.xmlファイルを作成できます。

ConstellationアプリケーションはConstellation DX API v2を使用してインフィニティサーバーと通信しますが、これはステートレスインターフェイスです。 DX APIは、PegaのユーザーインターフェースルールとPegaのビジネスルールを併用して、JSONメッセージ構造で画面を記述し、レスポンスとして返されます。各UIアクションは、個別のConstellation DX API呼び出しを生成します。DX APIには、デフォルトの動作をオーバーライドするために使用できるいくつかの動的システム設定（DSS）とApplication Settingが付属しています。

API呼び出しのより詳細なデバッグを行うには、次の図に示すように、DebugPegaAPI動的システム設定の「Rule」を「true」に設定します。

このオプションは、 Pega API Rest Service Infoステートメントに追加フィールドを記録し、ページの指示とフィールドレベルのセキュリティのデバッグに役立ちます。 

 DebugPegaAPIルールが有効になると、次の情報がPegaのログファイルに保存されます。

• DX API呼び出しのリクエストボディで使用される入力値
• DX APIによって実行されるアクション
• DX APIでエラーや例外が発生するビュー内のフィールド
• エラーと例外の原因の説明
• エラーコードと例外番号

次の問題に答えて、理解度をチェックしましょう。