デフォルトの自動インストゥルメンテーション プロパティ
次の表に、cluster-agent.yaml 仕様で定義されている自動インストルメンテーションの設定に使用できるデフォルトプロパティを示します。
| パラメータ | デフォルト | 説明 |
|---|---|---|
appNameLabel | N/A | このラベルの値は、Splunk AppDynamics アプリケーション名になります。 |
appNameStrategy | 手動 | Splunk AppDynamics アプリケーションの名前を指定するオプション。このパラメータには、次のいずれかの値を指定できます。
「アプリケーションの命名方法」を参照してください。 |
defaultAnalyticsHost | N/A | 分析エージェントのホスト名。 このパラメータは、Node.js エージェントでデフォルトのトランザクションデータを分析エージェントに送信する必要がある場合に必要となります。 デフォルト値は、instrumentationRules 設定によって上書きされない限り、すべてのインストルメント化されたリソースに適用されます。 |
defaultAnalyticsPort | N/A | 分析エージェントのリスニングポート。 たとえば、分析エージェントがポート 9090 でリッスンしている場合、このパラメータの値は 9090 です。 デフォルト値は、instrumentationRules 設定によって上書きされない限り、すべてのインストルメント化されたリソースに適用されます。 このパラメータは、Node.js エージェントでデフォルトのトランザクションデータを分析エージェントに送信する必要がある場合に、 |
defaultAnalyticsSslEnabled | N/A | この値は、Analytics エージェントポートが SSL 対応かどうかに基づいています。ポートで SSL が有効になっている場合は、値を このパラメータは、Node.js エージェントでデフォルトのトランザクションデータを分析エージェントに送信する必要がある場合に、 デフォルト値は、 |
defaultAppName | "" | (必須)コントローラに報告するためにエージェントによって使用されるアプリケーション名。 |
defaultCustomConfig | N/A | このパラメータは、Java アプリケーションに固有です。 アプリケーション フレームワークでインストゥルメンテーションに特定の設定が必要な場合は、カスタムシステムプロパティを追加できます。 この値は、他の Java エージェントプロパティとともに設定された Helm を使用して展開をアップグレードする場合、defaultEnv の代わりにこのパラメータを使用すると、再インストゥルメンテーションの問題を回避できます。「自動インストゥルメンテーションの検証」の「アップグレードされた展開の再インストゥルメンテーションの問題のトラブルシューティング」を参照してください。 |
defaultContainerMatchString | N/A | これは、インストゥルメント化するコンテナを選択するための正規表現値です。このパラメータを使用するには、インストゥルメンテーション ルールで指定された このパラメータとともに |
defaultEnv | JAVA_TOOL_OPTIONS | このパラメータは、Java アプリケーションに固有です。 - この変数を上書きして、展開に最適な他の環境変数を使用できます。 ただし、展開をアップグレードするためにこの値をオーバーライドすると、クラスタエージェントは再インストゥルメントしません。これは、Java エージェントと展開の両方で トラブルシューティングの詳細については、「自動インストゥルメンテーションの検証」の「アップグレードされた展開の再インストゥルメンテーションの問題のトラブルシューティング」を参照してください。 |
defaultInstrumentationLabelMatch | [ ] | インストゥルメンテーションのためのマークが付けられた特定の展開ラベル。 このパラメータは、インストゥルメント化する key-value ペアのリストを受け入れます。 インストゥルメンテーションには、少なくとも 1 つのラベルを一致させる必要があります。 例:
たとえば、 |
defaultInstrumentMatchString | .* | インストゥルメンテーションの対象になる展開の名前。 このパラメータは、instrumentationRules 内で指定された このパラメータは、正規表現として展開名を受け入れます。 インストゥルメント化する展開が複数ある場合は、スペースを使用せずに名前を " デフォルトでは、このパラメータは |
enableForceReInstrumentation | false | 新しく展開されたインストゥルメンテーション プロパティで、正常にインストゥルメント化されたポッドの古い設定を上書きする必要がある場合は、このプロパティを true に設定する必要があります。 デフォルトでは、このプロパティは false に設定されています。 クラスタエージェントのアップグレード中に、インストルメンテーション構成を正常にインストルメント化された展開に更新する必要がある場合は、値を true に設定します。 正常にインストゥルメント化された展開にインストゥルメンテーション構成を保持する必要がある場合は、値を false に設定します。ただし、既存の展開のインストゥルメンテーション状態が失敗または新規の場合は、更新された構成が適用されます。 注: クラスタエージェントをアップグレードする場合、正常にインストゥルメント化された展開に更新された構成を適用するには、この値を true に設定する必要があります。 |
enableInstallationReport | "false" | インストール情報の収集を有効または無効にします。次の詳細を含む要約レポートが生成されます。
インストールレポートを表示するには、「インストールレポートの表示」を参照してください。 |
imageInfo | | Node.js エージェント、.NET Core for Linux、および Java エージェントがプルされた Docker リポジトリ。 サポートされる値は以下の通りです:
このパラメータは、自動インストゥルメンテーション中に追加される init コンテナで使用されます。 |
instrumentationMethod | なし(None) | アプリケーションのインストゥルメント化に使用されるインストゥルメンテーション方式。 サポートされる値は以下の通りです:
|
| v1 | これは、複数コンテナ環境でアプリケーションを自動インストゥルメント化するために必要です。1 つまたは複数のアプリケーションタイプを含めることができます。 値を v2 として指定すると、異なる構成の単一言語または複数言語のいずれかを使用するマルチコンテナポッドでアプリケーションを自動インストゥルメント化できます。ただし、v2 では構成ファイルを使用したカスタムエージェント構成はサポートされていません。 |
instrumentationRules | [ ] | 必須です。このパラメータは、自動インストゥルメンテーションを有効にするために使用されます。これには、特定のインストゥルメンテーション ルールのリストが含まれます。ルールは 1 つまたは複数の名前空間に適用できます。また、展開名とラベルに基づいてフィルタ処理できます。インストゥルメンテーション ルールは細かく設定でき、特定の展開を対象にすることをサポートできます。 「インストルメンテーション ルールのためのクラスタエージェントの構成」を参照してください。 |
javaAgentCustomSSLKeystore | N/A | Java エージェント SSL キーストアファイルのシークレット名。詳細については、「Java エージェント自動インストルメンテーションのカスタム SSL の使用」を参照してください。 |
javaAgentCustomSSLKeystorePasswordSecret | N/A | Java エージェント SSL キーストアパスワードのシークレット名。詳細については、「Java エージェント自動インストルメンテーションのカスタム SSL の使用」を参照してください。 |
nsToInstrumentRegex | "" | 必須です。値を指定しない場合、自動インストゥルメンテーションは機能しません。 正規表現としてインストゥルメント化される名前空間を指定します。 インストゥルメント化する名前空間が複数ある場合は、スペースを使用せずに "|" を使用して名前空間を区切ります。 デフォルトでは、名前空間はインストゥルメント化されません。 |
numberOfTaskWorkers | 2 | 同時に自動インストゥルメント化される展開数のレート制限を設定します。 注: この値を大きくすると、クラスタ内でのポッドの同時再起動数が増加する可能性があります。 |
netvizInfo | bciEnabled;true ポート:3892 | ネットワークの可視性アプリケーション エージェントの netviz を設定するには、「Kubernetes CLI を使用したインフラストラクチャの可視性のインストール 」のネットワークエージェントのインストール方法を参照してください。 デフォルトでは、 サポートされる値は以下の通りです:
|
runAsGroup | 0 | アプリケーションコンテナを非ルートユーザとして構成した場合は、対応するグループのグループ ID(GID)を提供します。 デフォルトの |
runAsUser | 0 | アプリケーションコンテナを非ルートユーザーとして構成した場合は、対応するユーザーのユーザー ID(UID)を指定します。 デフォルトの |
resourcesToInstrument | 導入 | クラスタエージェントは、このパラメータにリストされているリソースをインストゥルメント化します。サポートされる値は、次のとおりです。
たとえば、 resourcesToInstrument:
|
tierNameLabel | N/A | このラベルの値は、Splunk AppDynamics 階層名になります。 |
tierNameStrategy | 手動 | 階層の名前を指定するオプション。このパラメータには、次のいずれかの値を指定できます。
|
インストールレポートの表示
cluster-agent.yaml ファイルで enableInstallationReport パラメータを有効にしている場合は、要約されたインストールレポートを表示できます。「デフォルトの自動インストゥルメンテーション プロパティ」を参照してください。インストールレポートを表示するには、次の手順を実行します。
kubectl exec の実行
kubectl exec -it <cluster-agent-pod-name> -n <namespace> sh- ログのディレクトリに移動します。
InstallationReport.csvファイルを開き、レポートを確認します。
Java エージェント自動インストゥルメンテーションのカスタム SSL の使用
デフォルトの cluster-agent.yaml ファイルで次のプロパティを使用して、キーストアファイルのシークレットとパスワードを指定できます。これにより、カスタム SSL を使用した Java エージェントの自動インストゥルメンテーションが有効になります。
- javaAgentCustomSSLKeystore
- javaAgentCustomSSLKeystorePasswordSecret
custom-ssl.jks という名前を付ける必要があります。証明書の作成については、次を参照してください。 .次のコマンドを実行して、カスタム SSL を使用した Java エージェントの自動インストゥルメンテーションに使用されるシークレットを作成します。
- キーストアファイルのシークレットを作成します。
kubectl -n appdynamics create secret generic <secret name> --from-file=<path to custom-ssl.jks file> - キーストアパスワードのシークレットを作成します。
kubectl -n appdynamics create secret generic <secret name> --from-literal=keystore-password=‘<keystorePassword>’
証明書更新後のシークレットの更新
カスタム SSL キーストアファイルまたはキーストアパスワードを変更する場合は、次の手順を実行する必要があります。
- Java アプリケーションのインストゥルメント化を解除します。
- キーストアファイルとキーストアパスワードの新しいシークレットを作成します。「Java エージェント自動インストルメンテーションのカスタム SSL の使用」を参照してください。
- Java アプリケーションを再インストゥルメント化します。