InstrumentationRule プロパティ
次の表に、InstrumentationRule で自動インストゥルメンテーションを設定するために使用できるプロパティを示します。
| パラメータ名 | デフォルト値 | 説明 |
|---|---|---|
analyticsHost | N/A | 分析エージェントのホスト名。 このパラメータは、Node.js エージェントまたは .NET Core エージェントでデフォルトのトランザクションデータを Analytics エージェントに送信する必要がある場合に必須となります。 |
analyticsPort | N/A | 分析エージェントのリスニングポート。 たとえば、分析エージェントがポート 9090 でリッスンしている場合、このパラメータの値は 9090 です。 このパラメータは、Node.js エージェントでデフォルトのトランザクションデータを分析エージェントに送信する必要がある場合に、defaultAnalyticsHost で必要となります。 |
analyticsSslEnabled | N/A | この値は、Analytics エージェントポートが SSL 対応かどうかに基づいています。ポートが SSL 対応でない場合は、値を false と指定します。 このパラメータは、Node.js エージェントでデフォルトのトランザクションデータを分析エージェントに送信する必要がある場合に、 |
containerMatchString | N/A | これは、値を満たす名前を持つコンテナを選択するための正規表現値です。このパラメータを使用するには、 このパラメータとともに このパラメータは、 |
customAgentConfigSource | N/A | このパラメータは、ConfigMaps を介してインストゥルメント化するエージェントのカスタム設定を使用するオプションを提供します。このパラメータでは、クラスタエージェントの名前空間に必要な ConfigMap を作成する必要があります。このパラメータは、クラスタエージェントの YAML ファイルから動的に設定できます。YAML ファイルに加えた変更は、アプリケーションを再起動することなく、インストゥルメント化されたすべてのエージェントに対して更新されます。同様に、ConfigMap の設定に加えた変更は、アプリケーションを再起動することなく、すべてのインストゥルメント化されたエージェントに対して更新されます。
注: 展開から ConfigMap ファイル(ルールで使用)を削除する必要がある場合は、最初にこのパラメータをクラスタエージェントの YAML ファイルから削除し、次にクラスタエージェントの名前空間から ConfigMap を削除する必要があります。 |
customSecretName | N/A | カスタムシークレット名。これは、ライセンスルールを定義するときに生成される名前と同じです。 |
customSecretKey | N/A | カスタムシークレットキー。これは、ライセンス ルールを定義するときに生成されるキーと同じです。 |
instrumentContainer | 第1 | このパラメータは、インストゥルメント化する必要があるコンテナを選択するオプションを提供します。次の値のいずれでも指定できます。
|
言語 | N/A | インストゥルメント化されるアプリケーションの言語。 サポート対象の言語は次のとおりです。
|
matchString | N/A | ルールが適用される展開名を照合するための正規表現。 このパラメータに値を指定しない場合、クラスタエージェントは defaultInstrumentMatchString で指定された値を使用し、その値を満たすすべての展開をインストゥルメント化します。 |
namespaceRegex | "" | このルールの一部としてインストゥルメント化される名前空間を指定する正規表現。名前空間は、パイプ記号(|)を使用してスペースを使用せずに区切ることができます。 |
labelMatch | {} | このルールに含めるラベルの key-value ペアのリスト。 いずれかのラベルと一致すれば満たされます。例:labelMatch:
たとえば、 |
appName | <defaultAppName> | コントローラに報告するために Java エージェントによって使用されるアプリケーション名。これは defaultAppName を上書きします。 値が指定されていない場合は、構成された defaultAppName が使用されます。 |
appNameLabel | N/A | Splunk AppDynamicsこのラベルの値は、 アプリケーション名になります。 |
customAgentConfig | N/A | このパラメータは、Java および Node.js アプリケーションに固有です。 アプリケーション フレームワークでインストゥルメンテーションに特定の設定が必要な場合は、カスタムシステムプロパティを追加できます。 Java アプリケーションの場合:この値は、他の Java エージェントプロパティとともに設定された または 変数に追加されます。 Node.js アプリケーションの場合:この値は NODE_OPTIONS に追加されます。 |
tierName | "" | コントローラに報告するために Java エージェントによって使用される階層名。 階層名が指定されていない場合は、階層の名前戦略が手動のとき、展開名がデフォルトとして使用されます。 |
tierNameLabel | N/A | このラベルの値は、AppDynamics 階層名になります。 |
nodeName | "" | このパラメータは、階層の下のノードに順番に名前を付けるために使用されます。ノード名が指定されていない場合は、展開名がデフォルトとして使用されます。たとえば、階層内で使用される 2 つのノードがあり、アプリケーション環境の展開名が abc であるとします。構成ファイルでノード名の値を指定しない場合、クラスタエージェントは次をノード名とします。
|
| reuseNodeName | true | このパラメータは、 Java エージェントにのみ適用されます。 ノード名を再利用する必要がない場合は、このプロパティを |
env | "" | このパラメータは、Java アプリケーションに固有です。 アプリケーション エージェントのシステムプロパティが追加される環境変数。指定すると、このインストゥルメンテーション ルールと一致する展開の defaultEnv を上書きします。 何も指定されていない場合、デフォルトは |
imageInfo | | 次のプロパティのいずれかを選択できます。
このルールで言及されている特定の言語について、このインストゥルメンテーション ルールと一致する展開の image-info を上書きします。 デフォルトのクラスタレベルの構成を上書きし、この特定の選択したルールにカスタムのエージェントバージョンを使用する場合は、これを構成する必要があります。 |
netvizInfo | bciEnabled;true ポート:3892 | ネットワーク可視性アプリケーション エージェントの netviz を設定するには、「Kubernetes CLI を使用したインフラストラクチャの可視性のインストール」に記載されているネットワークエージェントのインストール方法を参照してください。 デフォルトでは、netviz netviz です。 サポートされる値は以下の通りです:
|
runAsGroup | 0 | アプリケーションコンテナを非ルートユーザーとして構成した場合は、対応するグループの これにより、エージェント アーティファクトに適切なファイル権限が設定されます。 この値は、インストゥルメント化されたすべてのリソースに適用されます。 デフォルトのインストゥルメンテーション用に設定されている |
runAsUser | 0 | アプリケーションコンテナを非ルートユーザーとして構成した場合は、対応するユーザーの これにより、エージェント アーティファクトに適切なファイル権限が設定されます。 この値は、インストゥルメント化されたすべてのリソースに適用されます。 デフォルトのインストゥルメンテーション用に設定されている |
securityContext | 該当なし | 必要なセキュリティコンテキスト制約パラメータを指定します。securityContext 内で使用できるパラメータのリストについては、「securityContext パラメータ」を参照してください。 |
SecurityContext パラメータ
securityContext パラメータ内で次のパラメータを使用できます。
| パラメータ名 | デフォルト値 | 説明 |
|---|---|---|
runAsGroup | 0 | アプリケーションコンテナを非ルートユーザーとして構成した場合は、対応するグループの groupId を指定します。 これにより、エージェント アーティファクトに適切なファイル権限が設定されます。 この値は、インストゥルメント化されたすべてのリソースに適用されます。 デフォルトのインストゥルメンテーション用に設定されている runAsGroup のデフォルト値を上書きする必要がある場合、またはこのルールを満たすリソースに特定の値が必要な場合は、このパラメータを追加します。 |
runAsUser | 0 | アプリケーションコンテナを非ルートユーザーとして構成した場合は、対応するユーザーの userId を提供します。 これにより、エージェント アーティファクトに適切なファイル権限が設定されます。 この値は、インストゥルメント化されたすべてのリソースに適用されます。 デフォルトのインストゥルメンテーション用に設定されている runAsUser のデフォルト値を上書きする必要がある場合、またはこのルールを満たすリソースに特定の値が必要な場合は、このパラメータを追加します。 |
allowPrivilegeEscalation | 該当なし | プロセスが親プロセスよりも多くの権限を取得できるかどうかを制御します。次のコンテナとして実行されている場合、この値は true です。
注:
|
capabilities | 該当なし | 実行中のコンテナの POSIX 機能を追加または削除します。これは、コンテナランタイムにデフォルトの機能セットを使用します。 注:
|
privileged | いいえ | ホストでのルートに相当する特権モードでコンテナを実行します。 注:
|
procMount | DefaultProcMount | コンテナに使用する proc マウントのタイプ。 注: このパラメータは、現在、Deployment および DeploymentConfig モードで使用できます。 |
readOnlyRootFilesystem | いいえ | このコンテナに読み取り専用のルートファイルシステムがあるかどうかを指定します。 注:
|
runAsNonRoot | いいえ | コンテナを非ルートユーザーとして実行する必要があるかどうかを指定します。 この値が true の場合、Kubelet は実行時にイメージを検証して、ルートとして実行したときにコンテナの開始が失敗することを確認します。このパラメータが指定されていない場合、または値が false の場合、検証は行われません。 注: このパラメータは、現在、Deployment および DeploymentConfig モードで使用できます。 |
seLinuxOptions | 該当なし | SELinux コンテキストをコンテナに適用します。このパラメータが指定されていない場合、コンテナランタイムは各コンテナにランダムな SELinux コンテキストを割り当てます。 注:
|
seccompProfile | 該当なし | コンテナで使用される seccomp オプションを指定します。ポッドレベルとコンテナレベルの両方で seccomp オプションが指定されている場合、コンテナオプションはポッドオプションをオーバーライドします。 注:
|
windowsOptions | 該当なし | すべてのコンテナに Windows 固有のオプションを指定します。 注: このパラメータは、現在、Deployment および DeploymentConfig モードで使用できます。 |