ログファイル

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

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 （PLA）は、デベロッパーやシステム管理者がシステムログデータの統合サマリーを表示するために使用できるスタンドアロンのウェブアプリケーションです。

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

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

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

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

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