.NET Agent for Linux のアップグレード

このページでは、Docker などの VM や Linux を実行しているハードウェアで、.NET Agent for Linux をアップグレードする方法について説明します。

.NET Agent for Linux をアップグレードすると、エージェントファイルが更新され、レガシー設定が維持されます。

.NET Agent for Linux 21.5

.NET Agent for Linux 21.5 では、アーキテクチャが大幅に変更され、.NET Agent for Windows に比べ Linux エージェントで欠落している機能の開発が加速されています。

注: これらのアーキテクチャの変更は、.NET Agent for Windows（MSI およびマイクロサービス）には影響しません。

通常、.NET Agent for Linux 21.5 は、.NET Agent for Linux 21.5 より前の既存の機能との間でパリティが維持されています。ただし、アーキテクチャの更新により、.NET Agent for Linux 21.5 以降とそれより前のバージョンとの間に違いが発生します。詳細な説明については、.NET エージェント 21.5 リリースノートを参照してください。

.NET Agent for Linux 21.5 にアップグレードする前に、次の表の差異を確認してください。

差異 .NET Agent for Linux 21.5 以降 .NET Agent for Linux 21.5 より前
ビルド済みの Docker イメージ

バージョン 21.5 以降の .NET エージェント Docker イメージには OS レイヤがありません。

そのため、Kubernetes の initContainer の共有ボリュームからエージェントバイナリをコピーできます。Kubernetes の initContainer にはベース OS は必要ありません。

 バージョン 21.5 より前の .NET エージェント Docker イメージには、OS レイヤがあります。
HTTP URL バックエンド（デフォルトの命名）

.NET エージェントでは、命名に http://host:port を含んだ完全な URL が使用されます。

完全な URL アドレスが使用されます。

たとえば、次のアドレスへの 2 つのコールを実行するとします。

  • http://service.cisco.com/api/add/12
  • http://service.cisco.com/api/add/32

2 つのバックエンド名は次のようになります。

  • http://service.cisco.com/api/add/12
  • http://service.cisco.com/api/add/32

.NET エージェントでは、命名に URL の URI パスが使用されます。http://host:port は除外されますが、名前として「/」プレフィックスが使用されます。

「/」が前に付いた URI パスを使用します。

たとえば、次のアドレスへの 2 つのコールを実行するとします。

  • http://service.cisco.com/api/add/12
  • http://service.cisco.com/api/add/32

2 つのバックエンド名は次のようになります。

  • /api/add/12
  • /api/add/32

HTTP URL バックエンド（カスタム命名）

.NET エージェントでは、命名に http://host:port を含んだ完全な URL が使用されます。

URL アドレスを「/」で分割すると、http://host:port は以下の最初の 3 つのセグメントになります。

  • "http:"
  • ""
  • "host:port"

たとえば、「/」を分割と結合デリミタとして使用して、最初の 5 つの URL セグメントで次のアドレスへの 2 つのコールを実行するとします。

  • http://service.cisco.com/api/add/12
  • http://service.cisco.com/api/add/32

結果は次のように 1 つのバックエンド名になります。

  • http://service.cisco.com/api/add

.NET エージェントでは、命名に URL の URI パスが使用されます。http://host:port は除外されますが、名前として「/」プレフィックスが使用されます。

「/」で分割された URL アドレスでは、セグメント数は URI パスのプレフィックス「/」からカウントします。

たとえば、「/」を分割と結合デリミタとして使用して、最初の 3 つの URL セグメントで次のアドレスへの 2 つのコールを実行するとします。

  • http://service.cisco.com/api/add/12
  • http://service.cisco.com/api/add/32

結果は次のように 1 つのバックエンド名になります。

  • /api/add
環境変数の機密データフィルタリング

環境変数の機密データをフィルタ処理するには、次の手順を実行します。

  1. この機密データフィルタを AppDynamicsConfig.json に追加します。

    JSON 
    {
"applies-to": "environment-variables",
"match-type": "CONTAINS",
"match-pattern": ""
}
  2. このフィルタをエージェント構成ファイルと統合する場合は、「.NET エージェントを使用した機密データのフィルタ処理」を参照してください。
 Linux エージェントで APPDYNAMICS_AGENT_MASK_ENV_VARS 環境変数を使用すると、利用可能です。
プロセスアイデンティティ 使用不可 利用可能
インプロセス非同期コールチェーンセグメント数の制限 ノードあたり 5（デフォルト） ノードあたり 10（デフォルト）

汎用形式の POCO 定義は、既存の汎用メソッド POCO 定義を変更するため、新しい形式を使用して再定義する必要があります。

注: POCO 定義と同様に、新しい形式は、カスタム出口、カスタムデータコレクタなどの同様の定義に適用されます。これは、.NET Agent for Linux でそのサポートが有効になっているためです。

次に、すべての .NET エージェントの 汎用 POCO ルールを定義するために使用される一般的な形式を示します。

フォーマット

クラス：GenericClass`2 メソッド：GenericMethod<T1,T2>(T1,T2,T1,T2)

次に、すべての .NET エージェントの 汎用 POCO ルールを定義するために使用される一般的な形式を示します。

フォーマット

クラス：GenericClass`2メソッド：GenericMethod<T1,T2>(T1,T2,T1,T2)
Alpine 3.9 および 3.10 未対応 対応
AppDynamicsConfig.json 構成ファイルまたは APPDYNAMICS_ANALYTICS_* 環境変数による分析エージェント接続設定。 サポート対象外単一の環境変数 appdynamics.analytics.agent.url を使用して、http://localhost:9090/v2/sinks/bt などの完全な分析エージェント URL を指定します。 対応
JSON 内の分析エージェント SSL 信頼設定またはエージェント固有の環境変数。

未対応

分析サーバが使用する証明書がオペレーティングシステムによって信頼されている場合、SSL 接続は機能します。回避策として、SSL_CERT_FILE/SSL_CERT_DIR を使用して証明書を設定できます。

注: これは、すべての接続の SSL 構成を上書きするグローバル設定です。
次の環境変数がサポートされます。
  • APPDYNAMICS_CONTROLLER_SSL_CERTFILE
  • APPDYNAMICS_CONTROLLER_SSL_CERTDIR
APPDYNAMICS_CONTROLLER_SSL_CERTFILE を含む単一ファイルでの複数の Base-64 エンコード証明書（PEM）の使用。

次の制限事項が適用されます。

  • 複数証明書（PEM）ファイルは 1 MB を超えることはできません。
  • 各証明書ファイルは、修飾ヘッダーとフッターでフォーマットする必要があります。ファイルの最初の行は、最初の証明書のヘッダーです。
  • 証明書のロードに失敗すると、ファイル全体が無視され、機能が無効になります。
 対応