クラスタエージェントのコンフィギュレーション ファイル
このページでは、クラスタエージェントによって使用される 3 つの内部構成ファイルについて説明します。
-
agent-monitoring.yml -
bootstrap-config.yml -
logger-config.yml
エージェントモニタリングの設定の参照
ファイルには、クラスタエージェントによって変更可能な設定情報が含まれています。この表には、 ファイルで予期されるフィールドを一覧表示しています。これらのフィールドを使用して、クラスタエージェントによってモニタされるポッドとコンテナを設定します。
| フィールド名 | 説明 | デフォルト |
|---|---|---|
blocklisted-label | （オプション）Kubernetes ラベル（ ペア）を指定するために使用されるフィールド。このラベルが存在する場合、コンテナまたはポッドはモニタされません。この例では、ラベル appdynamics.exclude |
appdynamics.exclude: true |
blocklisted-names | （オプション）モニタ対象外のポッドおよびコンテナを指定するために使用されるフィールド。この例では、関連付けられているコンテナ container3 および container4 を持つ ポッドが無視されます 。 | 空 |
cluster-metric-collection-interval-seconds |
エージェントがメトリックを収集する頻度（秒単位）この値は 30 秒未満に設定しないでください | 60 |
container-filter | （オプション）コンテナ名に基づいてポッドおよびコンテナをブロックリストまたは許可リストに登録します | 空 |
container-registration-batch-size | 1 回の登録サイクルでのバッチあたりのコンテナの最大数 | 25 |
container-registration-max-parallel-requests | 1 回の登録サイクルでのバッチの最大数 | 3 |
metadata-collection-interval-seconds |
コンテナとポッドのメタデータが収集される頻度 | 60 |
metric-collection-interval-seconds |
メトリックが定期的に収集するサンプリング間隔。 この値は 15 秒未満に設定しないでください。 |
|
metric-upload-retry-count |
最初に失敗した場合に試行されるメトリック アップロード アクションの回数 | 3 |
metric-upload-retry-interval-milliseconds |
連続するメトリックアップロードの再試行間隔（ミリ秒単位） | 5 |
pod-registration-batch-size |
1 回の登録サイクルでのバッチあたりのポッドの最大数 | 30 |
allowlisted-names | （オプション）モニタ対象のポッドおよびコンテナを指定するために使用されるフィールド。この例では、ポッド monitored-pod とそのコンテナ container1 および container2 がモニターされます。 | 空 |
agent-monitoring.yml の例：
metric-collection-interval-seconds: 30
container-filter:
blocklisted-label:
appdynamics.exclude:
true
# allowlisted-names:
# pod-name1:
# container-name1
# container-name2
# pod-name2:
# container-name1
# container-name2
# pod-name3:
# container-name1
# container-name2
# blocklisted-names:
# pod-name:
# container-name1
# container-name2
# pod-name2:
# container-name1
# container-name2ブートストラップ設定参照
ファイルには、起動時にクラスタエージェントによって読み取られる設定情報が含まれています。この表には、 ファイルで予期されるフィールドを一覧表示しています。
| フィールド名 | 説明 | デフォルト |
|---|---|---|
account | コントローラのアカウント名 | 空 |
account-access-key | アカウントアクセスキー | 空 |
cluster-name | モニタリングクラスタに割り当てられた一意の名前 | 空 |
container-registration-interval-seconds |
クラスタエージェントがコントローラにコンテナ情報を送信する頻度。クラスタエージェントが実行中のコンテナをチェックする間隔。 実行中のコンテナをより頻繁に検出する場合にのみ、デフォルト値を変更します。ほとんどの環境では、デフォルト値を使用します。 | 120 |
controller-host | コントローラホスト名 | 空 |
controller-port | コントローラポート | 空 |
controller-ssl-enabled | コントローラが SSL 対応であるかどうかを示します。 | false |
event-upload-interval-seconds | イベントがコントローラにアップロードされる頻度（秒単位） | 10 |
http-client-timeout-seconds | コントローラから応答を受信しなかった場合にサーバーコールが終了するまでの秒数。 | 30 |
log-output-directory | ログを書き込む必要があるディレクトリ。 | ログ |
monitored-namespaces | クラスタ内でモニタされる名前空間（カンマ区切り文字列） | default |
bootstrap-config.yml の例：
account: <account-name>
account-access-key:<account-access-key>
controller-host: localhost
controller-port: 8090
cluster-name: <cluster-name>
monitored-namespaces: default
event-upload-interval-seconds: 10
container-registration-interval-seconds: 120
http-client-timeout-seconds: 30
log-output-directory: logs
# SSL configuration
controller-ssl-enabled: falseログ設定参照
デフォルトでは、クラスタエージェントはログファイルを <cluster_agent_home>/logs/<node_name> directory に書き込みます。
log-level パラメータの値を変更することによって、クラスタエージェントのログレベルを制御できます。デバッグ情報を最大にするには、ログレベルを logger-config.ymlDEBUG に設定します。
logger-config.yml ファイルを変更し、次の属性の値を設定することができます。
| 属性 | 説明 | デフォルト | タイプ |
|---|---|---|---|
log-level | ログの詳細の数： INFO、WARNING、DEBUG、または TRACE。 | INFO | 文字列 |
max-filesize-mb | ログの最大ファイルサイズ（MB 単位） | 5 | 整数 |
max-backups | ログに保存するバックアップの最大数。最大バックアップ数に達すると、最初のログファイルの次に最も古いログファイルが削除されます。 | 3 | 整数 |
write-to-stdout | ロギング情報を に書き込みます。オプション：true、false。 | true | 文字列 |
logger-config.yml の 例：
log-level: INFO
max-filesize-mb: 5
max-backups: 3
write-to-stdout: true