Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Appd tocbox

    On this page:

     

    Table of Contents
    maxLevel2
    minLevel2

    Related pages:

     

     

    Table of Content Zone
    maxLevel2
    minLevel2
    locationtop
    Standalone

    Machine Agent Settings for Docker Visibility

    You can configure the following Docker Visibility settings on the Standalone Machine Agent.

     

    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.

    cgroup data cgroup metric collection cgroup metric collection
    Setting
    Description

    containerProcessSelectorRegex

    The Machine Agent can monitor up to 120 150 running containers (depending on the pool size configuration, described below) and does not prioritize. The  The agent collects metrics from containers that run with with one or more running processes whose command line matches a configurable regex. By default, the value of this regex is ".*"and matches processes that are are running with the -Dappdynamics prefix optionall 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 = ".*[ ]-Dappdynamics.*"

    You can configure this option 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.

    "

    Anchor
    container_max_agent
    container_max_agent
    Docker Metric Collector Pool Size

    The Standalone Machine Agent can monitor up to 15 containers by default. You can configure the agent Specifies the local limit for the number of containers the 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 change this setting to monitor up to 120 containers at the same time: set the pool size to 5 (the default setting is 3(pool size = 4) or 150 containers (pool size = 5). The trade-off is that increasing the pool size will consume more resources might lead to higher resource consumption on the agent host. 

    To change the pool size, set the following. You cannot change this setting in the DockerMonitoring.yml file.

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

    (New in 4.4.3) cgroup Enabled

    dockerTagsEnabled

    Enable (the default) or disable the collection of Docker tags from containers monitored by this 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. When cgroup is enabled, there's no need 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

    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.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

    to monitor per machine.

    that each 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.

    120

    150 is the maximum limit you can specify.

    15

    sim.machines.reuse.enabled

    Reuse SIM Machine entities to handle the ephemeral environment. Support is limited to docker Docker container machines for now.

    If set to false, every new container will be considered a new machine.

    true

    sim.docker.apmNode.markHistorical.enabled

    Mark the APM nodes as historical when a container running an app agent is stopped.true

     

     

    sim.machines.tags.enabled

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