トランザクション追跡の新しいモードおよびレガシー モード

 
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 agent
on 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.artonly
    introscope.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
  • 手動によるレガシー モードの設定
以下の手順に従います。
  1. 監視対象のアプリケーションを停止します。
  2. ログ ファイルを新たに作成するために、
    /logs ディレク
    トリにある既存のログ ファイルをアーカイブして削除します。
  3. <
    Agent_Home
    >/core/config ディレクトリ内の既存の
    .pbl
    および
    .pbd
    ファイルをバックアップします。
  4. 既存の
    /core/conf
    ig/IntroscopeAgent.profile をバックアップします。
  5. レガシーの .pbl ファイルと .pbd ファイルを <
    Agent_Home
    >/examples/legacy ディレクトリから <
    Agent_Home
    >/core/config ディレクトリにコピーします。
  6. /
    core/confi
    g/IntroscopeAgent.profile を開き、以下の変更を行います。
    • プロパティ introscope.agent.configuration.old=true を追加します。
    • コピーされた適切なレガシーの
      .pbl
      ファイルおよび
      .pbd
      ファイルをポイントするようにエージェント プロパティ
      introscope.autoprobe.directivesFile
      を更新します。
  7. 動的インスツルメンテーションが有効でない場合は、監視対象のアプリケーションを再起動します。
特定の 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