トランザクション追跡の新しいモードおよびレガシー モード
apmdevops104jp
エージェントは、新しいモードまたはレガシー モードで実行できます。トランザクション追跡用の新しいモードを使うと、エージェントのパフォーマンスが向上します。引き続きレガシー モードを使用しながら、トランザクション Blame スタックでエージェントを実行できます。
注:
将来のリリースにおけるエージェントの拡張機能は、新しいモードにのみ実装されます。重要:
カスタム モード レガシー PBD と同時に新しいモードを使用する予定がある場合、レガシー モードのアップグレードを考慮に入れてください。エージェントをアップグレードする前に、APM 管理者またはプロフェッショナル サービスが作成したカスタム レガシー モード PBD を使用しているかどうか確認してください。新しいモードでエージェントを実行する前に、PBD がアップグレードされていることを確認します。レガシー モードのトレーサを実行している場合は、エージェントをレガシー モードで実行します。互換性のないレガシーのトレーサがあることをユーザに知らせるために、以下のメッセージがエージェント ログに書き込まれます。
“An agent tracer using legacy API’s has been detected. Running legacy tracers with the agent in new mode is not recommended. Please contact support who can refer you to documentation on how to upgrade your legacy tracers. In the interim, please configure the agent to use legacy mode or use the pre-configured version of the legacy agent package.For example, the legacy package for the Oracle WebLogic agenton UNIX is IntroscopeAgentFiles-Legacy-NoInstallerx.x.x.xweblogic.unix.tar”
新しいモードのトレーサを実行するまで、レガシー モードでエージェントを実行するように設定を戻してください。
以下の標準装備の拡張機能を使用している場合は、エージェントをレガシー モードで実行するように設定してください。
新しいモードおよびレガシー モード用のトレーサ タイプのマッピング
新しいモードおよびレガシー モード用のトレーサ タイプのマッピングは次のとおりです。
<レガシー トレーサ タイプ> | <レガシー トレーサ クラス名> | <新しいトレーサ タイプ> | <新しいトレーサ クラス名> |
BlamedMethodNanoTimerDifferentInstances | com.wily.introscope.agent.trace.nano.MethodNanoTimer | BlamedMethodNanoTimerDifferentInstancesHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
BlamedMethodNanoTimerDifferentMethods | com.wily.introscope.agent.trace.nano.MethodNanoTimer | BlamedMethodNanoTimerDifferentMethodsHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
BlamedMethodNanoTimer | com.wily.introscope.agent.trace.nano.MethodNanoTimer | BlamedMethodNanoTimerHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
BlamedMethodRateTracer | com.wily.introscope.agent.trace.nano.MethodRateTracer | BlamedMethodRateTracerHC | com.wily.introscope.agent.trace.nano.MethodRateTracer |
BlamedMethodTimerDifferentInstances | com.wily.introscope.agent.trace.nano.MethodTimer | BlamedMethodTimerDifferentInstancesHC | com.wily.introscope.agent.trace.nano.MethodTimer |
BlamedMethodTimerDifferentMethods | com.wily.introscope.agent.trace.nano.MethodTimer | BlamedMethodTimerDifferentMethodsHC | com.wily.introscope.agent.trace.nano.MethodTimer |
BlamedMethodTimer | com.wily.introscope.agent.trace.nano.MethodTimer | BlamedMethodTimerHC | com.wily.introscope.agent.trace.nano.MethodTimer |
BlamedMethodTraceDecrementor | com.wily.introscope.agent.trace.nano.MethodFinishCounter | BlamedMethodTraceDecrementorHC | com.wily.introscope.agent.trace.nano.MethodFinishCounter |
BlamedMethodTraceIncrementor | com.wily.introscope.agent.trace.nano.MethodFinishCounter | BlamedMethodTraceIncrementorHC | com.wily.introscope.agent.trace.nano.MethodFinishCounter |
BlamedPerIntervalCounterDifferentInstances | com.wily.introscope.agent.trace.nano.PerIntervalCounter | BlamedPerIntervalCounterDifferentInstancesHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
BlamedPerIntervalCounterDifferentMethods | com.wily.introscope.agent.trace.nano.PerIntervalCounter | BlamedPerIntervalCounterDifferentMethodsHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
BlamedPerIntervalCounter | com.wily.introscope.agent.trace.nano.PerIntervalCounter | BlamedPerIntervalCounterHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
EJB2ContextMapper | com.wily.introscope.agent.trace.nano.EjbContextTracer | EJB2ContextMapperHC | com.wily.introscope.agent.trace.nano.EjbDeferredContextTracer |
BlamePointTracerDifferentInstances | com.wily.introscope.agent.trace.nano.BlamePointTracer | Hc2BlamePointTracerDifferentInstances | com.wily.introscope.agent.trace.nano.BlamePointTracer |
PageInfoTracer[PageInfoTracer] | com.wily.introscope.agent.trace.nano.PageInfoTracer | Hc2PageInfoTracer | com.wily.introscope.agent.trace.nano.PageInfoTracer |
MethodNanoTimerDifferentInstances | com.wily.introscope.agent.trace.nano.MethodNanoTimer | MethodNanoTimerDifferentInstancesHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
MethodNanoTimerDifferentMethods | com.wily.introscope.agent.trace.nano.MethodNanoTimer | MethodNanoTimerDifferentMethodsHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
MethodNanoTimer | com.wily.introscope.agent.trace.nano.MethodNanoTimer | MethodNanoTimerHC | com.wily.introscope.agent.trace.nano.MethodNanoTimer |
MethodRateTracer | com.wily.introscope.agent.trace.nano.MethodRateTracer | MethodRateTracerHC | com.wily.introscope.agent.trace.nano.MethodRateTracer |
MethodTimerDifferentInstances | com.wily.introscope.agent.trace.nano.MethodTimer | MethodTimerDifferentInstancesHC | com.wily.introscope.agent.trace.nano.MethodTimer |
MethodTimerDifferentMethods | com.wily.introscope.agent.trace.nano.MethodTimer | MethodTimerDifferentMethodsHC | com.wily.introscope.agent.trace.nano.MethodTimer |
MethodTimer | com.wily.introscope.agent.trace.nano.MethodTimer | MethodTimerHC | com.wily.introscope.agent.trace.nano.MethodTimer |
MethodTraceIncrementor | com.wily.introscope.agent.trace.nano.MethodFinishCounter | MethodTraceIncrementorHC | com.wily.introscope.agent.trace.nano.MethodFinishCounter |
PerIntervalCounterDifferentInstances | com.wily.introscope.agent.trace.nano.PerIntervalCounter | PerIntervalCounterDifferentInstancesHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
PerIntervalCounterDifferentMethods | com.wily.introscope.agent.trace.nano.PerIntervalCounter | PerIntervalCounterDifferentMethodsHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
PerIntervalCounter | com.wily.introscope.agent.trace.nano.PerIntervalCounter | PerIntervalCounterHC | com.wily.introscope.agent.trace.nano.PerIntervalCounter |
SimpleDecrementor | com.wily.introscope.agent.trace.nano.MethodFinishCounter | SimpleDecrementorHC | com.wily.introscope.agent.trace.nano.MethodFinishCounter |
SimpleIncrementor | com.wily.introscope.agent.trace.nano.MethodFinishCounter | SimpleIncrementorHC | com.wily.introscope.agent.trace.nano.MethodFinishCounter |
エージェント レガシー モードの制限事項
レガシー モードでエージェントを実行した場合、以下の機能は使用できません。
- バージョン 9.1 でのエージェントの CPU 使用率と応答時間の最適化
- .NET エージェントの動的インスツルメンテーション
- SQL エージェントのプロパティintroscope.agent.sqlagent.sql.artonlyintroscope.agent.sqlagent.sql.turnoffmetrics
- スマート インスツルメンテーション
- SAP パスポートの継承
重要:
レガシーのトレーサと CA APM エージェントを新しいモードで実行する場合、この設定は「混合モード」と呼ばれます。混合モードではエージェントを実行しません。余分なメモリ ヒープを消費し、アプリケーションの停止をもたらす原因となります。レガシー モードのファイル場所
この製品は、<
Agent_Home
>/examples/legacy ディレクトリでレガシー モード PBD および PBL ファイルを提供します。このディレクトリ内の各ファイルには、default-full-legacy.pbl
のように、 -legacy
サフィックスが付いています。レガシー モードのトランザクション追跡を使用するためのエージェントの設定
レガシー モードのトランザクション追跡への切り替えは、新しいモードがある CA APM のバージョンにのみ適用されます。バージョン 9.1 より前の CA APM には新しいモードはありません。
エージェントがレガシー モードを使用するように設定するには、2 つのオプションがあります。
- 事前設定されたレガシー エージェント パッケージをデプロイします。これらのパッケージはファイルのみで構成されるエージェントのパッケージとして提供され、インストーラはありません。たとえば、UNIX 上の Oracle WebLogic エージェント用のレガシー パッケージは以下のとおりです。IntroscopeAgentFiles-Legacy-NoInstaller<version_number>weblogic.unix.tar
- 手動によるレガシー モードの設定
以下の手順に従います。
- 監視対象のアプリケーションを停止します。
- ログ ファイルを新たに作成するために、/logs ディレクトリにある既存のログ ファイルをアーカイブして削除します。
- <Agent_Home>/core/config ディレクトリ内の既存の.pblおよび.pbdファイルをバックアップします。
- 既存の/core/config/IntroscopeAgent.profile をバックアップします。
- レガシーの .pbl ファイルと .pbd ファイルを <Agent_Home>/examples/legacy ディレクトリから <Agent_Home>/core/config ディレクトリにコピーします。
- /core/config/IntroscopeAgent.profile を開き、以下の変更を行います。
- プロパティ introscope.agent.configuration.old=true を追加します。
- コピーされた適切なレガシーの.pblファイルおよび.pbdファイルをポイントするようにエージェント プロパティintroscope.autoprobe.directivesFileを更新します。
- 動的インスツルメンテーションが有効でない場合は、監視対象のアプリケーションを再起動します。
特定の CA APM 拡張機能を設定して標準インストールでレガシー モードを使用するには、以下の表に示す
.pbl
および .pbd
ファイルを参照します。拡張機能名 | レガシー標準 pbl または pbd ファイル |
CA APM for Oracle Service Bus | OSB-typical-legacy.pbl |
CA APM for IBM WebSphere MQ | webspheremq-legacy.pbl |
CA APM for TIBCO BusinessWorks | tibcobw-typical-legacy.pbl |
CA APM for Software AG webMethods Integration Server | webmethods-legacy.pbl |
CA APM for IBM CICS Transaction Gateway | PPCTGTranTrace.pbd PPCTGServer-typical.pbd PPCTGClient-typical.pbd |
CA APM for IBM z/OS | zos-full.pbl |
CA APM for SYSVIEW | CTG_ECI_Tracer_For_SYSVIEW-legacy.pbd HTTP_Tracer_For_SYSVIEW-legacy.pbd WS_Tracer_For_SYSVIEW-legacy.pbd |