Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.6

    ...

    On this page:

     

    appdsv-tocbox
    Table of Contents
    maxLevel2
    minLevel2

    translation
    languageen
    Appd tocbox

    Related pages:

    Standalone
    Standalone
    Property Reference
  • Monitoring Containers
  •  

    Table of Content Zone
    Table of Content Zone
    maxLevel2
    minLevel2

     

    locationtop

    Machine Agent Settings for Docker Visibility

    You can configure the Docker Visibility settings in the

    following

    file: <machine-agent-home>/extensions/DockerMonitoring/conf/DockerMonitoring.yml  

     


    Info

    Before you edit this file, please review "Editing YML Files: Important Notes" in Machine Agent Settings for Server Visibility.

    Setting
    Description

    Property

    Description

    Default
    cgroupEnabled

    The Machine Agent can collect Memory and CPU metrics for Docker containers using cgroupdata. This method is much faster than using the Docker API (the default metric-collection method). You can enable cgroupmetriccollection on all platforms except Amazon Linux OS. With the cgroupEnabled flag set to true, the Machine Agent can monitor up to 600 containers per host. When cgroup is enabled, you do not have to update the Docker Metric Collector Pool Size. The max container limit is independent of this.

    This mode is disabled by default. To enable cgroupmetriccollection, run the agent with the following command-line option set to true:

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

    true

    containerProcessSelectorRegex

    The Machine Agent can monitor up to 150 running containers (depending on the pool size configuration, described below). The agent collects metrics from containers with one or more running processes whose command line matches a configurable regex. By default, the value of this regex is ".*" and matches all containers irrespective of the processes running in them. If you cannot restart the APM agents, or if you to want to filter APM agents based on another command-line argument, you can override this behavior by editing this regex.

    Default = ".*"

    ".*"

    Anchor
    container_max_agent
    container_max_agent

    Docker Metric Collector Pool SizeSpecifies

    docker.metric.collector.pool.size

    Specify the local limit for the number of containers the agent can monitor. The effective limit for each agent is the minimum

    of

    amount for:

    • The sim.docker.machine.container.limit on the Controller (default limit = 15 containers), or
    • The Docker Metric Collector Pool Size on the agent (default pool size = 3, or 90 containers).

    You can change this setting to monitor up to 120 containers (pool size = 4) or 150 containers (pool size = 5). The trade-off is that increasing the pool size might lead to higher resource consumption on the agent host.

    To change the pool size, set

    the following.

    these properties:

    • System Property: -
    appdynamics
    • Dappdynamics.docker.metric.collector.pool.size
    • Environment Variable
    -
    • : APPDYNAMICS_DOCKER_METRIC_COLLECTOR_POOL_SIZE

    default limit = 15 containers

    default pool size = 3, or 90 containers

    dockerTagsEnabledEnable (
    the
    default) or disable the collection of Docker tags from containers monitored by
    this agent
    the Machine Agent.

    cgroupEnabled

    The Standalone Machine Agent can collect Memory and CPU metrics for Docker containers using cgroupdata. This method is much faster than using the Docker API (the default metric-collection method). You can enable cgroupmetriccollection on all platforms except Amazon Linux OS. With the cgroup enabled flag set to true, the Standalone Machine Agent can monitor up to 600 containers per host.

    This mode is disabled by default. To enable cgroupmetriccollection, run the agent with the following command-line option set to true:

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


    docker.use.container.name.selector

    Use the Machine Agent to identify containers by container names only.

    By default, the Machine Agent obtains a list of containers for Docker monitoring. For each container, the Machine Agent retrieves all the running processes inside the container. Then, the Machine Agent matches the container to be monitored by the process full command line. Because there are many containers, the selection process lasts longer than a minute, causing gaps in reporting container metrics.

    The Docker Use Container Name Selector configuration option provides an alternative way to select containers to be monitored by using the container's name.  This option allows the Machine Agent to run significantly faster since the Machine Agent does not have to gather all the processes for each container.

    To enable matching with the container name, you can either use an environment variable or a JVM property. If both are defined, the environment variable is used.

    • System Property: -Dappdynamics.docker.use.container.name.selector=true

    • Environment Variable: APPDYNAMICS_DOCKER_USE_CONTAINER_NAME_SELECTOR=true

    You can select which containers to be monitored by providing the regular expression, containerNameSelectorRegex, to match the container names. By default, the Machine Agent matches all container names. Regular expressions are part of the extensions/DockerMonitoring/conf/DockerMonitoring.yml file.

    To exclude containers from monitoring, use an environment variable or the JVM property. If both are defined, the environment variable is used.

    Code Block
    languageyml
    # default value
    ".*(machine-agent|machineagent).*"
    
    # environment variable
    export APPDYNAMICS_DOCKER_CONTAINER_NAME_SELECTOR_BLACKLIST_REGEX=".*(machine-agent|machineagent).*"
    
    # JVM property
    -Dappdynamics.docker.container.name.selector.blacklist.regex=".*(machine-agent|machineagent).*"
    # default value
    ".*(machine-agent|machineagent).*"

    Controller Settings for Docker Visibility

    For information about how to configure these settings, see Controller Settings for Standalone Machine Agents.

    Property

    Description

    Default

    sim.docker.apmNode.markHistorical.enabledEnable or disable the import of Docker tags to the Controller.true

    sim.docker.enabled

    Enable the Docker Monitoring feature.true

    Anchor
    container_max_controller
    container_max_controller
    sim.docker.machine.container.limit

    Global limit for the number of containers that each

    agent

    Machine Agent can monitor. The effective limit for each agent is the minimum of

    • The sim.docker.machine.container.limit on the Controller (default limit = 15 containers), or
    • The Docker Metric Collector Pool Size on the agent (default pool size = 3, or 90 containers).

    You can specify this in the Administration Console as a Controller setting (all accounts) or as an Account setting for individual accounts. 150 is the maximum limit you can specify.

    15

    sim.machines.reuse.enabled

    Reuse SIM Machine entities to handle

    the

    an ephemeral environment. Support is currently limited to Docker container machines

    for now

    .

    If set to false,

    every

    each new container

    will be

    is considered a new machine.

    true

    sim.

    docker

    machines.

    apmNode

    tags.

    markHistorical.

    sim.machines.tags.enabled

    Enable or disable the import of Docker tags to the Controller.true

    enabled

    Mark the APM nodes as historical when a container running an app agent is stopped.true
    Enable or disable the import of Docker tags to the Controller.true
    Sv translation
    languageja
    Appd tocbox

    On this page:

     

    Table of Contents
    maxLevel2
    minLevel2

    Related pages:

     

     

    Table of Content Zone
    maxLevel2
    minLevel2
    locationtop

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

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

     

    Info

    このファイルを編集する前に、「Machine Agent Settings for Server Visibility」の「YML ファイルの編集:重要な注意事項」を参照してください。

    設定
    説明

    containerProcessSelectorRegex

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

    デフォルト:".*"

    Anchor
    container_max_agent
    container_max_agent
    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

    Anchor
    container_max_controller
    container_max_controller
    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 タグのインポートを有効または無効にします。正しい