JEE 上の AEM Forms のトランザクションレポートの有効化と表示 transaction-reports-overview

トランザクションレポートを有効にする enable-transaction-reporting

デフォルトでは、トランザクションの記録は無効になっています。トランザクションレポートを有効にするには、次の手順を実行します。

トランザクションレポートを表示する view-transaction-report

トランザクションレポートを有効にすると、ダッシュボードを使用したトランザクションレポートとログファイルを使用した詳細なトランザクションレポートから、トランザクション数に関する情報にアクセスできるようになります。この両方について以下で説明します。

ダッシュボードを使用したトランザクションレポート transaction-report-dashboard

ダッシュボードを使用したトランザクションレポートでは、トランザクションタイプごとにトランザクションの合計数が表示されます。例えば、画像に示すように、レンダリングされたフォーム、変換されたフォームおよび送信されたフォームの合計数に関する情報が得られます。トランザクションレポートを取得するには：

ログファイルを使用したトランザクションレポート transaction-report-logfile

ログファイルを使用したトランザクションレポートには、各トランザクションに関する詳細な情報が表示されます。トランザクションログにアクセスするには、サーバー起動を基準とした相対コンテキストパスに従います。トランザクションは、デフォルトでは別個のログファイル transaction_log.log に取得されます。ファイルパス は、サーバー起動コンテキストを基準とした相対パスです。各種サーバーのデフォルトパスを以下に示します。

For Jboss Turnkey:
"<AEM_Forms_Installation>/jboss/bin/transaction_log.log"

For IBM Websphere:
"<IBM_WAS_Profile_path>/transaction_log.log"

For Oracle Weblogic:
"<Weblogic_Domain_path>/transaction_log.log"

For Jboss Cluster:
"<Jboss home>/transaction_log.log"

サンプルトランザクションレコードの例：
[2024-02-28 06:11:27] [INFO] TransactionRecord{service='GeneratePDFService', operation='HtmlFileToPDF', internalService='GeneratePDFService', internalOperation='HtmlFileToPDF', transactionOperationType='CONVERT', transactionCount=1, elapsedTime=1906, transactionDate=Wed Feb 28 06:11:25 UTC 2024}

トランザクションレコード transaction-record-structure-jee

トランザクションログ構造では、サービス、操作、トランザクションタイプなどの様々なパラメーターを使用して、各トランザクションの記録方法を定義します。それぞれの詳細について、以下で説明します。トランザクションレポートの構造は次のとおりです。

TransactionRecord
{
    service='...',
    operation='...',
    internalService='...',
    internalOperation='...',
    transactionOperationType='...',
    transactionCount=...,
    elapsedTime=...,
    transactionDate=...
}

サンプルトランザクションログ:

[2024-02-14 14:23:25] [INFO] TransactionRecord
{
    service='BarcodedFormsService',
    operation='decode',
    internalService='BarcodedFormsService',
    internalOperation='decode',
    transactionOperationType='CONVERT',
    transactionCount=1,
    elapsedTime=47405,
    transactionDate=Wed Feb 14 14:22:37 UTC 2024
}

トランザクションの記録頻度 transaction-recording-frequency

トランザクションの記録頻度は、正常に送信、レンダリング、変換されたフォームごとに、サーバー上の更新操作によって決まります。

関連記事 related-articles