Monitoring Docker with docker-scout

March 16 Bullet_white By Derek Bullet_white Posted in Features Bullet_white Comments Comments

docker monitoring

When it comes to agent-based monitoring and Docker, you're typically choosing between two bad options: (1) install the agent and its dependencies directly on the host or (2) running an agent in every container.

  • Installing the agent on the host is bad: Docker is best when everything is containerized. It means your services will run as expected, anywhere, without dependencies. Why does monitoring get to break that rule?
  • Running an agent in every container is bad: lets say you have 30 containers on a host that need to be monitored. Do you really want 30 agents running (one in each container)? That's a considerable amount of overhead.

Enter docker-scout. docker-scout is the Scout monitoring agent distributed via a Docker image. It's zero-dependency Docker monitoring: just run our image and your host is monitored.

Quick Start

1. Create a configuration file

Create a file called scoutd.yml (or copy our template). Your account_key is required, all other values are optional. For a list of options, see our scoutd help page.

account_key: YOUR_SCOUT_ACCOUNT_KEY

2. Run the docker image

Run the scout image, mounting the scoutd.yml file. Running the image will first download the image, if it is not already locally available. Run the following command in the directory containing your scoutd.yml file:

docker run -d --name scout-agent \
    -v /proc:/host/proc:ro \
    -v /etc/mtab:/host/etc/mtab:ro \
    -v /var/run/docker.sock:/host/var/run/docker.sock:ro \
    -v `pwd`/scoutd.yml:/etc/scout/scoutd.yml \
    --net=host --privileged scoutapp/docker-scout

Full docker-scout docs are on our help site.

Monitoring Docker Containers

Monitor the resource usage of your running containers with our Docker Monitoring Plugin.

Questions? Using Docker?

Shoot us an email at support@scoutapp.com or open an issue. Full help documentation is available on our help site.

Comments

comments powered by Disqus