自動インストゥルメンテーションの設定

分析エージェントのホスト名。

このパラメータは、Node.js エージェントまたは .NET Core エージェントでデフォルトのトランザクションデータを Analytics エージェントに送信する必要がある場合に必須となります。

デフォルト値は、instrumentationRules 設定によって上書きされない限り、すべてのインストゥルメント化されたリソースに適用されます。

分析エージェントのリスニングポート。

たとえば、分析エージェントがポート 9090 でリッスンしている場合、このパラメータの値は 9090 です。

デフォルト値は、instrumentationRules 設定によって上書きされない限り、すべてのインストゥルメント化されたリソースに適用されます。

このパラメータは、デフォルトのトランザクションデータを分析エージェントに送信するために Node.js または .NET Core エージェントを必須とする場合に、defaultAnalyticsHost とともに必要となります。

この値は、Analytics エージェントポートが SSL 対応かどうかに基づいています。ポートが SSL 対応の場合は値を true として指定し、非対応の場合は false として指定します。

このパラメータは、デフォルトのトランザクションデータを Analytics エージェントに送信するために Node.js または .NET Core エージェントを必須とする場合に、defaultAnalyticsPort および defaultAnalyticsHost とともに必要となります。

デフォルト値 は instrumentationRules 設定によって上書きされない限り、すべてのインストゥルメント化されたリソースに適用されます。

defaultAppName

このパラメータは、Java アプリケーションに固有です。

アプリケーション フレームワークでインストゥルメンテーションに特定の設定が必要な場合は、カスタムシステムプロパティを追加できます。

この値は、他の Java エージェントプロパティとともに設定された env or defaultEnv 変数に追加されます。

これは、インストゥルメント化するコンテナを選択するための正規表現値です。このパラメータを使用するには、インストゥルメンテーション ルールで指定された instrumentContainer 内で select オプションを使用する必要があります。

このパラメータとともに select オプションを使用すると、クラスタエージェントは正規表現値に一致するコンテナをインストゥルメント化します。

defaultEnv

このパラメータは、Java アプリケーションに固有です。

javaagent 引数とアプリケーション エージェントのシステムプロパティが追加される環境変数。

この変数を上書きして、展開に最適な他の環境変数を使用できます。

defaultInstrumentationLabelMatch

[ ]

インストゥルメンテーションのためのマークが付けられた特定の展開ラベル。

このパラメータは、インストゥルメント化する key-value ペアのリストを受け入れます。

インストゥルメンテーションには、少なくとも 1 つのラベルを一致させる必要があります。

次に例を示します。

defaultInstrumentationLabelMatch:
- label1: value1

- label1: value2

- label2: value2

たとえば、label1: value2 のみが一致する場合、インストゥルメンテーションは期待どおりに機能します。

defaultInstrumentMatchString

インストゥルメンテーションの対象になる展開の名前。

このパラメータは、instrumentationRules 内で指定された matchstring パラメータのデフォルト値として使用されます。matchstring が指定されていない場合、クラスタエージェントはこのパラメータ値を使用します。

このパラメータは、正規表現として展開名を受け入れます。

インストゥルメント化する展開が複数ある場合は、スペースを使用せずに名前を "|" で区切ることができます。

デフォルトでは、このパラメータは nsToInstrumentRegex によって構成されたすべての展開をインストゥルメント化します。したがって、インストゥルメンテーション ルールの matchString に値が指定されておらず、このパラメータに値を指定しない場合、クラスタエージェントはすべての展開をインストゥルメント化します。

imageInfo

Node.js エージェント、.NET Core for Linux、および Java エージェントがプルされた Docker リポジトリ。

次の値をサポートしています。

• image：エージェントイメージの場所、およびその tag/version。
• agentMountPath：イメージファイルシステム内のイメージアーティファクトの場所。デフォルトは [/opt/appdynamics] です。
  パスが異なる場合は、この構成を変更する必要があります。
  imagePullPolicy：エージェントの Docker イメージに必要なプルポリシー。要件に基づいて、次のプルポリシーのいずれかを選択できます。

  • • Always

    • IfNotPresent

    • Never

  このパラメータは、自動インストゥルメンテーション中に追加される init コンテナで使用されます。

instrumentationMethod

アプリケーションのインストゥルメント化に使用されるインストゥルメンテーション方式。

次の値をサポートしています。

• None：インストゥルメンテーションは無効になります。
• Env：インストゥルメンテーション プロパティをコンテナ環境変数にアタッチします。値が設定されていない場合、インストゥルメンテーションは開始されません。

instrumentationRules

[ ]

必須です。このパラメータを使用して、自動インストゥルメンテーションを有効にします。
特定のインストゥルメンテーション ルールのリストが記述されています。ルールは 1 つまたは複数の名前空間に適用できます。また、展開名とラベルに基づいてフィルタ処理できます。インストゥルメンテーション ルールは細かく設定でき、特定の展開を対象にすることをサポートできます。

「インストゥルメンテーション ルールのためのクラスタエージェントの構成」を参照してください。

nsToInstrumentRegex

必須です。値を指定しない場合、自動インストゥルメンテーションは機能しません。

正規表現としてインストゥルメント化される名前空間を指定します。

インストゥルメント化する名前空間が複数ある場合は、スペースを使用せずに "|" を使用して名前空間を区切ります。

デフォルトでは、名前空間はインストゥルメント化されません。

netvizInfo

bciEnabled: true

port: 3892

ネットワークの可視性のアプリケーション エージェント（netviz,）を構成するには、ネットワークエージェントを個別に展開し、このパラメータを設定する必要があります。
ネットワークエージェントのインストール方法については、「Install Infrastructure Visibility with the Cluster Agent Operator」を参照してください。

デフォルトでは、netviz が有効になっています。ネットワークエージェントが存在しない場合、このプロパティは影響を与えません。
netviz エージェントを有効または無効にできます。

次の値をサポートしています。

1. bciEnabled：netviz が有効になっているかどうかを示すブール型のフラグ。
2. port：ネットワークエージェントがリッスンしているポート（デフォルトは 3892)）。デフォルトポート以外のポートでネットワークエージェントを実行している場合にのみ、この値を上書きします。

runAsGroup

runAsUser

クラスタエージェントは、このパラメータにリストされているリソースをインストゥルメント化します。サポートされる値は、次のとおりです。

• Deployment
• StatefulSet
• DeploymentConfig

たとえば、Deployments および StatefulSets をインストゥルメント化するには、次のように設定します。

resourcesToInstrument:

- Deployment
- StatefulSet

分析エージェントのホスト名。

このパラメータは、Node.js エージェントまたは .NET Core エージェントでデフォルトのトランザクションデータを Analytics エージェントに送信する必要がある場合に必須となります。

分析エージェントのリスニングポート。

たとえば、分析エージェントがポート 9090 でリッスンしている場合、このパラメータの値は 9090 です。

このパラメータは、デフォルトのトランザクションデータを分析エージェントに送信するために Node.js または .NET Core エージェントを必須とする場合に、defaultAnalyticsHost とともに必要となります。

この値は、Analytics エージェントポートが SSL 対応かどうかに基づいています。ポートが SSL 対応でない場合は、値を false と指定します。

このパラメータは、デフォルトのトランザクションデータを分析エージェントに送信するために Node.js または .NET Core エージェントを必須とする場合に、defaultAnalyticsPort および defaultAnalyticsHost とともに必要となります。

これは、値を満たす名前を持つコンテナを選択するための正規表現値です。このパラメータでは、defaultInstrumentContainer または instrumentContainer 内で select オプションを使用する必要があります。

このパラメータとともに select オプションを使用すると、クラスタエージェントは正規表現値に一致するコンテナをインストゥルメント化します。

このパラメータは、defaultContainerMatchString に指定されたデフォルト値を上書きします。

instrumentContainer

このパラメータは、インストゥルメント化する必要があるコンテナを選択するオプションを提供します。次の値のいずれでも指定できます。

• first：これはデフォルト値です。この値を指定すると、クラスタエージェントはポッド内の最初のコンテナをインストゥルメント化します。
• all：この値を指定すると、クラスタエージェントはポッド内のすべてのコンテナをインストゥルメント化します。
• select：この値を指定すると、クラスタエージェントは、defaultContainerMatchString パラメータまたは containerMatchString パラメータで指定された正規表現と一致する名前のコンテナのみをインストゥルメント化します。

インストゥルメント化されるアプリケーションの言語。

サポート対象の言語は次のとおりです。

• dotnetcore
• java
• nodejs

ルールが適用される展開名を照合するための正規表現。

このパラメータに値を指定しない場合、クラスタエージェントは defaultInstrumentMatchString, で指定された値を使用し、その値を満たすすべての展開をインストゥルメント化します。

例：
labelMatch:
-label1: value1
-label1: value2
-label2: value2
label1: value2 のみが一致する場合、インストゥルメンテーションは期待どおりに機能します。

コントローラに報告するために Java エージェントによって使用されるアプリケーション名。defaultAppName を上書きします。

値が指定されていない場合は、構成された defaultAppName が使用されます。

このパラメータは、Java アプリケーションに固有です。

アプリケーション フレームワークでインストゥルメンテーションに特定の設定が必要な場合は、カスタムシステムプロパティを追加できます。
この値は、defaultCustomConfig パラメータで指定されたデフォルト値よりも優先されます。

この値は、他の Java エージェントプロパティとともに設定された env または defaultEnv 変数に追加されます。

コントローラに報告するために Java エージェントによって使用される階層名。

階層名が指定されていない場合は、展開名がデフォルトとして使用されます。

このパラメータは、Java アプリケーションに固有です。

アプリケーション エージェントのシステムプロパティが追加される環境変数。指定すると、このインストゥルメンテーション ルールと一致する展開の defaultEnv を上書きします。

何も指定されていない場合、デフォルトは defaultEnv（構成されている場合）または env JAVA_TOOL_OPTIONS（デフォルトのクラスタレベルで構成されていない場合）になります。

エージェントイメージの場所。次のプロパティのいずれかを選択できます。

• image：エージェントイメージの場所、およびそのタグ/バージョン。
• agentMountPath：イメージファイルシステム内のイメージアーティファクトの場所。デフォルトは [/opt/appdynamics] です。この構成は、パスがデフォルトパスと異なる場合にのみ必要です。
• imagePullPolicy：エージェントの Docker イメージに必要なプルポリシー。デフォルトは IfNotPresent です。要件に基づいて、次のプルポリシーのいずれかを選択できます。
  
  • Always
  • IfNotPresent
  • Never
  このパラメータは、自動インストゥルメンテーション中に追加される init コンテナで使用されます。

デフォルト値は IfNotPresent です。

このルールで言及されている特定の言語について、このインストゥルメンテーション ルールと一致する展開の image-info を上書きします。

デフォルトのクラスタレベルの構成を上書きし、この特定の選択したルールにカスタムのエージェントバージョンを使用する場合は、これを構成する必要があります。

netvizInfo

bciEnabled: true

port: 3892

ネットワークの可視性のアプリケーション エージェント（netviz）を構成するには、ネットワークエージェントを個別に展開し、このパラメータを設定する必要があります。
ネットワークエージェントのインストール方法については、「Install Infrastructure Visibility with the Cluster Agent Operator」を参照してください。

デフォルトでは、netviz が有効になっています。このプロパティは、ネットワークエージェントがない場合は影響しません。
netviz エージェントを有効または無効にできます。

次の値をサポートしています。

1. bciEnabled：netviz が有効になっているか どうかを示すブール型のフラグ.
2. port：ネットワークエージェントがリッスンしているポート（デフォルトは 3892)）。デフォルトポート以外のポートでネットワークエージェントを実行している場合にのみ、この値を上書きします。

runAsGroup

runAsUser