エージェントを展開したら、アプリケーションのインストルメンテーションをカスタマイズできます。

次の情報を使用して AppDynamicsConfig.json ファイルを編集できます。

{
  "controller": {
    "host": "controller.saas.appdynamics.com",
    "port": 443,
    "account": "account-name",
    "password": "access-key",
    "ssl": true
    "proxy" : {
        "host": "proxy-host",
        "port": 9090,
           "authentication": {
              "username": "proxy-user",
              "password": "proxy-password"
         }
      }
  },
  "application": {
    "name": "My Application",
    "tier": "Sample tier",
    "node": "Instance1",
	"reusenodename": "true",
	"nodenameprefix": "prefix"
  },
  "analytics": {
	"host": "localhost",
	"port": 9090
}

Docker なしで動作するようにエージェントを設定できます。ただし、現在のエージェントで OS がサポートされている必要があります。

1. 次のファイルをアプリケーションで使用できるようにします。アプリケーションファイルの横または個別のフォルダに配置できます。

   • AppDynamics.Agent.netstandard.dll
   • libappdprofiler.so
   • libappdprofiler_musl.so
   • libappdprofiler_glibc.so

2. 次の環境変数をアプリケーションに追加して、作成します。

   環境変数名	値
   CORECLR_PROFILER	{57e1aa68-2229-41aa-9931-a6e93bbc64d8}
   CORECLR_ENABLE_PROFILING	1
   CORECLR_PROFILER_PATH	libappdprofilerdynamic ライブラリへのパス。例：<application_folder_path> /libappdprofiler.so。libappdprofiler.so ライブラリの場所を確認するには、「.NET Agent for Linux」を参照してください。

   複数のレベルで環境変数を作成できるため、モニタリング対象アプリケーションのコンテキストでこれらを設定することが重要です。

   • 環境変数はグローバルホストレベルから継承されます。
   • 環境変数は親プロセスまたはサービスです。
   • 環境変数は、シェルスクリプトなどを使用してアプリケーションを起動する前に設定されます。

3. エージェント構成ファイルを適切なバイナリの横に配置します。次の 2 つのオプションがサポートされています。

   • グローバルエージェント構成ファイル：AppDynamicsConfig.json ファイルをエージェントバイナリとともに配置できます。これにより、構成済みの各アプリケーションをモニタするためのデフォルトオプションがエージェントで使用されます。

     警告: .NET Agent for Linuxでは、エージェント構成でのノード名のオーバーライドがサポートされていません。したがって、グローバル構成を使用して同じホスト上で複数のアプリケーションをモニタリングすることはサポートされていません。最初のアプリケーションでのみレポートが行われます。

   • ローカルエージェント構成：[appname].AppDynamicsConfig.json ファイルをアプリケーションバイナリとともに配置できます。[appname] がアプリケーションの DLL/EXE 名と一致する必要があります。このオプションを使用して、Splunk AppDynamics 構成をアプリケーションパッケージにアタッチし、バンドルとして展開できます。適切な環境変数が設定され、エージェントバイナリが存在する場合にアクティブになります。

     注: ローカルエージェント構成は、グローバル構成よりも優先されます。

デフォルトでは、プロファイラと .NET エージェントの両方に Boost Log を使用できます。ログファイルが存在しない場合でも、ロギングが実行されます。デフォルトでは、次の 3 つのログファイルが作成されます。

• エージェントログ：ファイル名は Agent_%N.log で、デフォルトのログレベルは INFO です。
• プロファイラログ：ファイル名は Profiler_%N.log で、デフォルトのログレベルは INFO です。
• 警告ログ：ファイル名は Warn_%N.log で、デフォルトのログレベルは WARN です。

ログ構成は、プロファイラの初期化中に読み取られます。ログ構成が読み取られる前に、一部のログがコンソールに出力されます。

次の表に、ログ構成ファイルで設定できるプロパティを示します。

ログの内容の例

以下のログ例は Agent_0.log のファイルコンテンツを示します。

Agent_0.log

2021-05-24 15:26:03.741862 2056 11672 3 INFO [com.appdynamics.LifetimeManager] Initializing via agent bootstrap

ここで、

• 2021-05-24 15:26:03.741862 はタイムスタンプです。
• 2056 はプロセス ID です。
• 11672 はネイティブスレッド ID です。
• 3 は管理対象スレッド ID です。
• INFO はログレベルです。
• com.appdynamics.LifetimeManager はチャネル名です。
• Initializing via agent bootstrap はログコンテンツです。

ログの構造

このログの例には、11120 と 76890 の 2 つのプロセスが含まれています。ログ設定に基づいて、各プロセスには独自のログファイルのセットがあります。

• プロセス 11120 の初回起動時には Agent_0.log（エージェントログ）および Profiler_0.log（プロファイラログ）が作成されます。
• プロセス 76890 の起動時には Agent_1.log（エージェントログ）および Profiler_1.log（プロファイラログ）が作成されます。

• いずれかのログファイルが最初に最大サイズに達すると、ファイル名に増分番号を追加して次のログファイルが作成されます。ログの順序付けは維持されず、プロセスごとに異なります。

  ログ

  Profiler_0.log 
  Profiler_1.log 
  Warn_0.log 
  BusinessTransactionsLog_0.log 
  ....
  .... 
  .... 
  Agent_0.log 
  Agent_1.log 
  Profiler_2.log 
  .... 
  .... 
  .... 
  Agent_2.log 

サポートされる機能

次の表に、サポートされている Boost Log 機能を示します。

ログ順序ルールの例

このログ順序ルールの例では、logger1、logger2 ... loggerN の N 個のロガーがあります。

ここで、loggerN は logger(N-1) ... logger1 に依存し、logger(N-1) は logger(N-2) ...logger1 に依存します。これ以降も同様です。

1. 例 A：「ByteCode」ログは「AgentLog」の一部です。そのため、ByteCode ロガーによるロギングは行われません。これは、AppDynamicsConfig.json ファイル内のロギング設定の順序に基づきます。

     {"filename" : "RESTHearbeat", "level" : "Info", "channel" : "com.appdynamics.REST.HeartBeatLog" },
     {"filename" : "AgentLog", "level" : "Info", "channel" : "*" },
     {"filename" : "ByteCode","level" : "Info","channel" : "com.appdynamics.bci.*" }

   例 B：「RESTHeartbeat」ログは「REST」の一部です。そのため、「RESTHeartbeat」ログは無視されます。

     {"filename" : "REST", "level" : "Info", "channel" : "com.appdynamics.REST.*" },
     {"filename" : "RESTHeartbeat", "level" : "Info", "channel" : "com.appdynamics.REST.HeartBeatLog" }

2. 「RESTHeartbeat」と「REST」のログはまったく同じチャネル名を持っていますが、最初のロガーの minLogLevel のみが考慮されます。この場合は「Info」です。

     {"filename" : "REST", "level" : "Info", "channel" : "com.appdynamics.REST.HeartBeatLog" },
     {"filename" : "RESTHeartbeat", "level" : "Trace", "channel" : "com.appdynamics.REST.HeartBeatLog" }

3. ロガー「RESTHearbeat」および「ByteCode」を介して書き込まれないチャネルは、「AgentLog」ロガーを介して書き込まれます。

   警告: AgentLog には、 RESTHeartbeat または ByteCodeからのエントリはありません。

     {"filename" : "RESTHearbeat", "level" : "Info", "channel" : "com.appdynamics.REST.HeartBeatLog" },
     {"filename" : "ByteCode", "level" : "Info", "channel" : "com.appdynamics.bci.*" }, 
     {"filename" : "AgentLog","level" : "Info","channel" : "*" }

ログ設定の例

次に、ロギング設定の例を示します。各ログファイルには、独自の設定セットを含めることができます。

{
  "controller": {
    "host": "......"
  },
  "application": {
    "name": "..."
  },
  "log": [
    {
      "filename": "Profiler",
      "level": "INFO",
      "directory": "/tmp/appd/logs",
      "channel": "appd.agent.profiler"
    },
    {
      "filename": "BusinessTransactionsLog",
      "level": "INFO",
      "channel": "com.appdynamics.BusinessTransactions"
    },
    {
      "filename": "RESTHearbeat",
      "level": "INFO",
      "channel": "com.appdynamics.REST.HeartBeatLog"
    },
    {
      "filename": "ByteCode",
      "level": "INFO",
      "channel": "com.appdynamics.bci.*"
    },
    {
      "filename": "RESTCommunications",
      "level": "INFO",
      "channel": "com.appdynamics.REST.*"
    },
    {
      "filename": "RESTCommunications",
      "level": "INFO",
      "channel": "com.appdynamics.METRICS.MetricSender"
    },
    {
      "filename": "SamplingTrace",
      "level": "TRACE",
      "channel": "com.appdynamics.ManagedAgentAPI.DumpStats"
    },
    {
      "filename": "Analytics",
      "level": "INFO",
      "channel": "com.appdynamics.ee.service.analytics.Analytics",
      "max_size": 31457280,
      "max_files": 2,
      "directory": "./logs",
      "exclude_tid": false
    },
    {
      "filename": "Agent",
      "level": "INFO",
      "channel": "*"
    },
    {
      "filename": "Warn",
      "level": "WARN",
      "channel": "*"
    }
  ]
}

この例では、同じファイルの複数のログエントリを示します（ディレクトリとファイル名の両方が同じ値を持ちます）。ファイルログの設定では最初のエントリを使用し、max_size、max_files、exclude_tid のそれ以降の設定はすべて無視されます。

{
     "filename": "agent",
     "level": "TRACE",
     "max_size":1000000,
     "max_files":2,
     "channel": "com.appdynamics.METRICS.MetricSender"
    },
    {
     "filename": "agent",
     "level": "DEBUG",
     "max_size":2000000,
     "max_files":2,
     "channel": "com.appdynamics.METRICS.*"
    },
    {
     "filename": "agent",
     "level": "INFO",
     "max_size":3000000,
     "max_files":1,
     "channel": "com.appdynamics.*"
    }
}