Configuring Docker Visibility

containerProcessSelectorRegex

The Machine Agent can monitor up to 150 running containers (depending on the pool size configuration, described below) and does not prioritize. The agent collects metrics from containers that run with a configurable regex. By default, this regex matches processes that are are running with the -Dappdynamics prefix option. 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

Docker Metric Collector Pool Size

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), and
• 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 will consume more resources 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

cgroup Enabled

(New in 4.4.3) The Standalone Machine Agent can collect Memory and CPU metrics for Docker containers using cgroup data. This method is much faster than using the Docker API (the default metric-collection method). You can enable cgroup metric collection on all platforms except Amazon Linux OS.

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

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

sim.docker.enabled

sim.docker.machine.container.limit

Global limit for the number of containers 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), and
• 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.

sim.machines.reuse.enabled

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

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

sim.docker.apmNode.markHistorical.enabled