次のエージェントをインストールして設定し、Splunk ログデータにリクエスト GUID、ビジネストランザクション ID、およびノード ID を追加します。これらのログを取り込む Splunk Universal Forwarder は、Cisco AppDynamics アプリケーション名と階層名を使用してログデータをさらに拡張するように設定されます。この結合されたデータにより、Cisco AppDynamics APM エンティティとそれらのエンティティの Splunk Cloud ログ間の相関が容易になります。

次のエージェントの 24.7.0 以降のバージョンを使用していることを確認します。

エージェント構成では、マッピングされた診断コンテキスト(MDC)を使用して、アプリケーションロギングを改善します。MDC を使用すると、ロギングメッセージにコンテキスト情報を保存できます。MDC は、ロギングイベント間で伝播されるキー値ストアです。これを使用して情報を保存し、単一のリクエストに含まれるすべてのログメッセージにその情報を含めることができます。

サポートされているログフレームワーク

Agent(エージェント)サポートされているフレームワーク
Javaエージェント
  • ログバック 1.x
  • Log4j2
  • Log4j
.Net エージェント
  • NLog 4.1 以降
  • Log4net 2.0 以降
Node.jsエージェント
  • Winston 3.13.1

ログメタデータの追加

デフォルトでは、ログエンリッチメントは無効になっています。管理者は、次のシステムプロパティを true に設定して、この機能を有効にすることができます。

System Property: appdynamics.enable.log.metadata.enrichment

Type: ブール

Default: なし

Required: なし

または、enable-log-metadata-enrichment  ノードプロパティを true に設定して、この機能を有効にすることができます。「アプリケーション エージェントのノードプロパティ」を参照してください。

このノードプロパティは、Java、Node.js、および .Net エージェントに適用されます。ノードプロパティはシステムプロパティよりも優先され、ノードプロパティはアプリケーション/ノード/階層レベルで設定できます。

エージェントのログメタデータの追加

アプリケーションログ設定ファイルのアペンダとターゲットを使用して、MDC キーを記録できます。ログメタデータを追加するには、アプリケーション ログ ファイルでこれらの属性を定義する必要があります。

設定は、構造化ログと非構造化ログのどちらを使用するかによって異なります。非構造化ログは、人間が判読できる文字列で構成される大きなテキストファイルです。構造化ログは、文字列の代わりにオブジェクトを使用します。これらのオブジェクトには、変数、データ構造、メソッド、および関数を含めることができます。たとえば、ログオブジェクトはアプリケーションまたはプラットフォームの詳細を示す場合があります。構造化ログは、マシンによる読み取りに適しています。