A set of scripts I use on a server with a Docker instance. All monitoring scripts are used with [Zabbix](http://www.zabbix.org).

Very simple shell script to count the number of containers on the docker instance.

containerCount.sh (all|running|crashed)

Print the number of containers on the Docker instance.

A script inspired from [a nice article](http://blog.docker.com/2013/10/gathering-lxc-docker-containers-metrics/) about metric. It enables you to get several metrics from a running container:

- the user or system cpu used by the container

- the memory used by the container

- the ip address of the container

- the container status: running, stopped, crashed or paused

- the container's network activity

containerHelper.py [-h] container {cpu,ip,memory,network,status} ...

positional arguments:

container Container name

optional arguments:

-h, --help show this help message and exit

Counters:

Available counters

{cpu,ip,memory,network,status}

cpu Display CPU usage

ip Display IP Address

memory Display memory usage

network Display network usage

status Display the container status

Additional information may be required depending on the counter prameter.

A daemon to update a dynamic DNS when Docker starts containers. Designed to be used with bind9. Have a look at [this page](https://www.erianna.com/nsupdate-dynamic-dns-updates-with-bind9) to setup correctly your DNS before using it.

dockerDDNS.py [-h] --key KEY [--server SERVER] --domain DOMAIN

[--zone ZONE] [--log-level LOG_LEVEL]

[--log-file LOG_FILE]

optional arguments:

-h, --help show this help message and exit

--key KEY Path to the dynamic dns key

--server SERVER IP/Hostname of the server to update

--domain DOMAIN The domain to be updated

--zone ZONE The zone to be updated (default to the domain)

--log-level LOG_LEVEL

Log level to display

--log-file LOG_FILE Where to put the logs

This script is designed to run as a daemon after Docker's startup. You'll find in the `upstart` directory a configuration file to have it launched on boot.

function countContainers() {

docker ps -q $1 | wc -l

}

function countCrashedContainers() {

docker ps -a | grep -v -F 'Exited (0)' | grep -c -F 'Exited ('

}

TYPE=${1-all}

case $TYPE in

running) COUNT_FUNCTION="countContainers"; shift;;

crashed) COUNT_FUNCTION="countCrashedContainers"; shift;;

all) COUNT_FUNCTION="countContainers -a"; shift;;

__author__ = 'Christophe Labouisse'

import argparse

import re

import os

from docker import Client

from docker.utils import kwargs_from_env

def display_cpu(args):

detail = c.inspect_container(args.container)

if bool(detail["State"]["Running"]):

container_id = detail['Id']

cpu_usage = {}

with open('/sys/fs/cgroup/cpuacct/docker/' + container_id + '/cpuacct.stat', 'r') as f:

for line in f:

m = re.search(r"(system|user)\s+(\d+)", line)

if m:

cpu_usage[m.group(1)] = int(m.group(2))

if args.type == "all":

cpu = cpu_usage["system"] + cpu_usage["user"]

else:

cpu = cpu_usage[args.type]

user_ticks = os.sysconf(os.sysconf_names['SC_CLK_TCK'])

print(float(cpu) / user_ticks)

else:

print(0)

def display_ip(args):

detail = c.inspect_container(args.container)

print(detail['NetworkSettings']['IPAddress'])

def display_memory(args):

detail = c.inspect_container(args.container)

if bool(detail["State"]["Running"]):

container_id = detail['Id']

with open('/sys/fs/cgroup/memory/docker/' + container_id + '/memory.stat', 'r') as f:

for line in f:

m = re.search(r"total_rss\s+(\d+)", line)

if m:

print(m.group(1))

return

print(0)

def display_network(args):

detail = c.inspect_container(args.container)

if bool(detail["State"]["Running"]):

ifconfig = c.execute(args.container, "ifconfig eth0")

m = re.search(("RX" if args.direction == "in" else "TX") + r" bytes:(\d+)", str(ifconfig))

if m:

print(m.group(1))

else:

b = c.execute(args.container, "cat /sys/devices/virtual/net/eth0/statistics/"+("rx" if args.direction == "in" else "tx")+"_bytes")

if re.match(r"\s*\d+\s*", b):

print(b)

else:

print(0)

else:

print(0)

def display_status(args):

detail = c.inspect_container(args.container)

state = detail["State"]

if bool(state["Paused"]):

print(1) # Paused

elif bool(state["Running"]):

print(0) # Running

elif int(state["ExitCode"]) == 0:

print(2) # Stopped

else:

print(3) # Crashed

parser = argparse.ArgumentParser()

parser.add_argument("container", help="Container name")

subparsers = parser.add_subparsers(title="Counters", description="Available counters", dest="dataType")

cpu_parser = subparsers.add_parser("cpu", help="Display CPU usage")

cpu_parser.add_argument("type", choices=["system", "user", "all"])

cpu_parser.set_defaults(func=display_cpu)

ip_parser = subparsers.add_parser("ip", help="Display IP Address")

ip_parser.set_defaults(func=display_ip)

memory_parser = subparsers.add_parser("memory", help="Display memory usage")

memory_parser.set_defaults(func=display_memory)

network_parser = subparsers.add_parser("network", help="Display network usage")

network_parser.add_argument("direction", choices=["in", "out"])

network_parser.set_defaults(func=display_network)

status_parser = subparsers.add_parser("status", help="Display the container status")

status_parser.set_defaults(func=display_status)

c = Client(**(kwargs_from_env()))

args = parser.parse_args()

args.func(args)

__author__ = 'xtof'

import argparse

import re

import logging

from subprocess import Popen, PIPE

from docker import Client

from docker.utils import kwargs_from_env

zone_update_template = """server {0}

zone_update_add_alias_template = """update delete {0}.{1}

parser = argparse.ArgumentParser()

parser.add_argument("--key", required=True, help="Path to the dynamic dns key")

parser.add_argument("--server", help="IP/Hostname of the server to update", default="127.0.0.1")

parser.add_argument("--domain", help="The domain to be updated", required=True)

parser.add_argument("--zone", help="The zone to be updated (default to the domain)")

parser.add_argument("--log-level", help="Log level to display", default="INFO")

parser.add_argument("--log-file", help="Where to put the logs", default="/var/log/docker-ddns.log")

args = parser.parse_args()

logging.basicConfig(level=getattr(logging,args.log_level.upper()),

format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',

filename=(args.log_file if args.log_file != '-' else None))

if args.zone is None:

args.zone = args.domain

logging.info("Starting with arguments %s", args)

c = Client(**(kwargs_from_env()))

p = Popen(['docker', 'events'], stdout=PIPE)

while True:

line = p.stdout.readline()

if line != '':

text_line = line.decode().rstrip()

logging.debug("Read line %s", text_line)

m = re.search(r"\s+([0-9a-f]{64}):.*\s+([a-z]+)\s*$", text_line)

if m:

event = m.group(2)

container_id = m.group(1)

logging.debug("Got event %s for container %s", event, container_id)

if event == "start":

detail = c.inspect_container(container_id)

container_hostname = detail["Config"]["Hostname"]

container_name = detail["Name"].split('/',1)[1]

container_ip = detail["NetworkSettings"]["IPAddress"]

logging.info("Updating %s to ip (%s|%s) -> %s", container_id, container_hostname, container_name, container_ip)

nsupdate = Popen(['nsupdate', '-k', args.key], stdin=PIPE)

nsupdate.stdin.write(bytes(zone_update_template.format(args.server, args.zone, container_hostname, args.domain, container_ip), "UTF-8"))

if container_name != container_hostname:

nsupdate.stdin.write(bytes(zone_update_add_alias_template.format(container_name, args.domain, container_hostname), "UTF-8"))

nsupdate.stdin.write(bytes("send\n", "UTF-8"))

nsupdate.stdin.close()

elif event == "destroy":

logging.info("Destroying %s", container_id)

else:

logging.warning("Couldn't match RE in line %s", text_line)

else:

print("Done return code: ", p.returncode)

break