Docker 可視性のマシンエージェント設定

<machine-agent-home>/extensions/DockerMonitoring/conf/DockerMonitoring.yml ファイルで Docker の可視性を設定できます。

 

このファイルを編集する前に、「サーバの可視性のためのマシンエージェントの設定」の「YML ファイルの編集:重要な注意事項」を参照してください。

設定
説明

containerProcessSelectorRegex

マシンエージェントは、最大 150 個の実行コンテナをモニタできます(以下で説明するプールサイズの設定によって異なります)。エージェントは、コマンドラインが設定可能な正規表現と一致する 1 つ以上の実行中のプロセスでコンテナからメトリックを収集します。デフォルトでは、この正規表現の値は ".*" であり、その中で実行されているプロセスに関係なく、すべてのコンテナに一致します。APM エージェントを再起動できない場合、または別のコマンドライン引数に基づいて APM エージェントをフィルタリングする場合は、この正規表現を編集してこの動作をオーバーライドできます。

デフォルト:".*"

Docker Metric Collector のプールサイズ

エージェントがモニタできるコンテナの数に対するローカル制限を指定します。各エージェントの有効な制限値の下限は、次のとおりです。

  • コントローラ上の sim.docker.machine.container.limit (デフォルトの制限 = 15 個のコンテナ)、または
  • エージェント上にある Docker Metric Collector のプールサイズ(デフォルトのプールサイズは 3、または 90 個のコンテナ)。

この設定を変更して、最大 120 個のコンテナ(プールサイズ = 4)または 150 個のコンテナ(プールサイズ = 5)をモニタすることができます。トレードオフとは、プールサイズを大きくすると、エージェントホストでのリソース消費が高くなることを意味します。

プールサイズを変更するには、次のように設定します。

  • システムプロパティ: appdynamics.docker.metric.collector.pool.size
  • 環境変数: APPDYNAMICS_DOCKER_METRIC_COLLECTOR_POOL_SIZE

dockerTagsEnabled

このエージェントによってモニタされるコンテナからの Docker タグの収集を有効(デフォルト)または無効にします。

cgroupEnabled

スタンドアロン マシン エージェントは、cgroupdata を使用して Docker コンテナのメモリおよび CPU メトリックを収集できます。このメソッドは、Docker API(デフォルトの metric-collection メソッド)を使用するよりもはるかに高速です。Amazon Linux OS を除くすべてのプラットフォームで cgroupmetriccollectionn を有効にすることができます。cgroup enabled フラグtrue に設定されている場合、スタンドアロン マシン エージェントはホストあたり最大 600 個のコンテナをモニタできます。cgroup が有効になっている場合は、Docker Metric Collector のプールサイズを更新する必要はありません。コンテナの最大数の制限は、これに依存しません。

このモードはデフォルトで無効になっています。cgroupmetriccollection を有効にするには、次のコマンドラインオプションを true に設定してエージェントを実行します。

java -Dappdynamics.docker.container.collection.cgroup.enabled=true  -jar machineagent.jar

Docker 可視性のコントローラ設定

これらの設定の構成方法については、「スタンドアロン マシン エージェント用コントローラの設定」を参照してください。

プロパティ
説明
デフォルト

sim.docker.enabled

Docker モニタリング機能を有効にします。true

sim.docker.machine.container.limit

各エージェントがモニタできるコンテナの数に対するグローバル制限。各エージェントの有効な制限値の下限は、次のとおりです。

  • コントローラ上の sim.docker.machine.container.limit(デフォルトの制限 = 15 個のコンテナ)、または
  • エージェント上にある Docker Metric Collector のプールサイズ(デフォルトのプールサイズは 3、または 90 個のコンテナ)。

これは、管理コンソールでコントローラの設定(すべてのアカウント)として指定することも、個々のアカウントのアカウント設定として指定することもできます。指定できる制限値の上限は、150 です。

15

sim.machines.reuse.enabled

一時的な環境を処理するために、SIM マシンエンティティを再利用します。現時点では、サポートは Docker コンテナマシンに限定されています。

false に設定すると、すべての新しいコンテナが新しいマシンと見なされます。

true

sim.docker.apmNode.markHistorical.enabled

アプリケーション エージェントを実行しているコンテナが停止したときに、APM ノードを履歴としてマークします。true

sim.machines.tags.enabled

コントローラへの Docker タグのインポートを有効または無効にします。正しい