Container Monitoring: Customizing Agent

This page outlines configurations available for the Atatus Container Agent, which automatically discovers all available containers. Learn how to manage included or excluded containers from data collection and configure specific parameters.

Configurations

Use the following configuration options to customize the agent.

Option	Description
ATATUS_LICENSE_KEY	Obtain your license key.
ATATUS_CONTAINER_INCLUDE	Allow list of containers.
ATATUS_CONTAINER_EXCLUDE	Exclude list of containers.
ATATUS_CONTAINER_INCLUDE_LOGS	Allow list of containers with logs.
ATATUS_CONTAINER_EXCLUDE_LOGS	Exclude list of containers with logs.
ATATUS_CONTAINER_INCLUDE_METRICS	Allow list of containers with metrics.
ATATUS_CONTAINER_EXCLUDE_METRICS	Exclude list of containers with metrics.
ATATUS_NOTIFY_HOST, ATATUS_LOG_NOTIFY_HOST	On-premise only. Infra URL `YOUR_ON_PREMISE_URL/track/infra` and logs URL `YOUR_ON_PREMISE_URL/track/logs`.

Include & Exclude Options:

Atatus supports the following environment variables for logging and metric inclusion or exclusion based on container and image names. Let’s proceed with configuring them as environment variables. Use the image flag for specifying the image name and the name flag for the container name. Examples:

To monitor containers with the name api-server and frontend-server:

ATATUS_CONTAINER_INCLUDE="name:api-server name:frontend-server"

To exclude containers with the name nginx and auth-service:

ATATUS_CONTAINER_EXCLUDE="name:nginx* name:auth-service"

To exclude containers with their image names apache and mysql:
ATATUS_CONTAINER_EXCLUDE="image:apache image:mysql"

To include logs and metrics for containers by their name or image:

ATATUS_CONTAINER_INCLUDE_LOGS="image:redis name:payment-service"
ATATUS_CONTAINER_INCLUDE_METRIC="image:kafka name:ad-service"

To exclude logs and metrics for containers by their name or image:

ATATUS_CONTAINER_EXCLUDE_LOGS="image:mongodb name:cart-service"
ATATUS_CONTAINER_EXCLUDE_METRICS="image:sqlite name:cart-service"

Setting Up with Docker Compose/Docker Swarm:

Add a service named atatus-infra-agent using the docker image atatus-infra-agent:4.3.0 with the following environment variables:

services:

  atatus-infra-agent:
    image: atatus/atatus-infra-agent:4.3.0
    environment:
      ATATUS_LICENSE_KEY: "lic_infra_*****"
      ATATUS_NOTIFY_HOST: "YOUR_ON_PREMISE_URL/track/infra"
      ATATUS_LOG_NOTIFY_HOST: "YOUR_ON_PREMISE_URL/track/logs"
      # Container include/exclude are optional.
      ATATUS_CONTAINER_INCLUDE: "name:api-server name:frontend-server"
    volumes:
      - "/var/lib/docker/containers:/var/lib/docker/containers:ro"
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
      - "/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro"
      - "/proc:/hostfs/proc:ro"
      - "/:/hostfs:ro"
    command: ["-c", "/etc/atatus-infra-agent/", "--system.hostfs=/hostfs"]
    user: root

Running with Docker Command:

Run this container in the background with detached Mode -d:

sudo docker run -d \
  -e ATATUS_LICENSE_KEY="lic_infra_*****" \
  -e ATATUS_NOTIFY_HOST="YOUR_ON_PREMISE_URL/track/infra" \
  -e ATATUS_LOG_NOTIFY_HOST="YOUR_ON_PREMISE_URL/track/logs" \
  -e ATATUS_CONTAINER_EXCLUDE="image:apache image:mysql" \
  --user=root \
  --volume="/var/lib/docker/containers:/var/lib/docker/containers:ro" \
  --volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
  --volume="/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro" \
  --volume="/proc:/hostfs/proc:ro" \
  --volume="/:/hostfs:ro" \
  -it atatus/atatus-infra-agent:4.3.0 -- -c /etc/atatus-infra-agent/ --system.hostfs=/hostfs

​Configurations

​Include & Exclude Options:

​Setting Up with Docker Compose/Docker Swarm:

​Running with Docker Command:

Configurations

Include & Exclude Options:

Setting Up with Docker Compose/Docker Swarm:

Running with Docker Command: