caapm/dockermonitor repository overview

(This solution is deprecated. It is recommended to use UMA for docker).

⁠DX APM Docker Monitor

CA APM Docker Monitor extension monitors the health and performance of your Docker containers and the services that are running on them. It can also correlate the Docker container performance metrics with other CA Application Performance Management (CA APM) performance metrics. This correlation helps you determine whether poor container performance is the source of application performance issues.

⁠Minimum Supported Version

Docker Remote API v1.23 Docker Server version 1.11.x

⁠Supported Tags

⁠Tag content

latest

• Pointing to 20141401 tag 20200114
• Support for s390x 2.0.2
• Fix 3rd party vulnerability and create a slim image
• Add volume in bind, read_only mode through YAML file

2.0.1

• Support for percentage utilisation for Memory RSS , Memory Cache and Memory Swap

2.0

• Support for Throttling Metrics of Docker Container
• Support for CPU Utilisation (mCore) and Memory Cache & RSS metrics
• Categorise metric in Swarm Services and Projects
• Address possible Metric Explosion
• Bug Fixes

1.0

• Initial version of DockerMonitor

⁠Installation

⁠Swarm/UCP

docker stack deploy -c install.yml dockermonitor --with-registry-auth

⁠Standalone

docker-compose -f install.yml up -d

⁠Content of install.yml

version: "3.2"
services:
  dockermonitor:
    image : caapm/dockermonitor:latest
    environment:
    - agentManager_url_1=[AGENT_MANAGER_URL]
    - agentManager_credential=[AGENTMANAGER_CREDENTIAL]
    - containerflow=enabled
    - interval=60
    - type=Docker
    - image=caapm/dockermonitor:latest
    pid: host
    command: ["bash","install.sh","--memory=700m","--cpus=0.7"]
    deploy:
      mode: global
      resources:
        limits:
          cpus: '0.5'
          memory: 600M
    volumes:
    - type: bind
      source: /var/run/docker.sock
      target: /var/run/docker.sock
      read_only: true
    - type: bind
      source: /proc
      target: /host/proc
      read_only: true
      bind:
        propagation: rslave

Replace the following variables with your setup details

[AGENTMANAGER_URL]  : Agent/EM Connection details - similar to what we provide on IntroscopeAgent.profile
[AGENTMANAGER_CREDENTIAL] : Agent Manager Credentials needed to connect any SaaS (DxI) instance . In case of on premise setup, remove this entry

⁠UnInstallation

⁠Swarm/UCP

docker stack deploy -c uninstall.yml uninstall-apm

⁠Standalone

docker-compose -f uninstall.yml up -d

⁠Content of uninstall.yml

version: "3"
services:
  dockermonitor:
    image : caapm/dockermonitor:latest
    command: ["bash","uninstall.sh"]
    deploy: 
      mode: global
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /proc:/host/proc:ro

##FAQ

⁠Agent fails to connect to 10.7 EM

If you are using the image from latest or 20200114 tag or rhel-20.1.0 tag onwards , you need to pass this additional ENV variable in both Deployment and DaemonSet Pods in order to establish the connection to 10.7 EM. This is not needed in case you are connecting to SaaS or 11.X EM

- name: apmenv_introscope_agent_connection_compatibility_version
  value: "10.7"