Monitor Docker Swarm with the InfluxData TICK Stack

docker-compose-tick.yml

version: '3'
services:
  # FRONT
  chronograf:
    # Full tag list: https://hub.docker.com/r/library/chronograf/tags/
    image: chronograf
    deploy:
      replicas: 1
      placement:
        constraints:
          - node.role == manager
      restart_policy:
        condition: on-failure
    volumes:
      # Mount for chronograf database
      - chronograf-data:/var/lib/chronograf
    ports:
      # The WebUI for Chronograf is served on port 8888
      - "8888:8888"
    networks:
      - influx
    depends_on:
      - kapacitor
      - influxdb
  # MIDDLE
  kapacitor:
    # Full tag list: https://hub.docker.com/r/library/kapacitor/tags/
    image: kapacitor
    deploy:
      replicas: 1
      placement:
        constraints:
          - node.role == manager
      restart_policy:
        condition: on-failure
    volumes:
      # Mount for kapacitor data directory
      - kapacitor-data:/var/lib/kapacitor
      # Mount for kapacitor configuration
      - /etc/kapacitor/config:/etc/kapacitor
    ports:
      # The API for Kapacitor is served on port 9092
      - "9092:9092"
    networks:
      - influx
    depends_on:
      - influxdb
  # BACK
  telegraf:
    # Full tag list: https://hub.docker.com/r/library/telegraf/tags/
    image: telegraf
    deploy:
      mode: global
      restart_policy:
        condition: on-failure
    volumes:
      # Mount for telegraf configuration
      - /etc/telegraf:/etc/telegraf
      # Mount for Docker API access
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      - influx
    depends_on:
      - influxdb
  # DATABASE
  influxdb:
    # Full tag list: https://hub.docker.com/r/library/influxdb/tags/
    image: influxdb
    deploy:
      replicas: 1
      placement:
        constraints:
          - node.role == manager
      restart_policy:
        condition: on-failure
    volumes:
      # Mount for influxdb data directory
      - influxdb-data:/var/lib/influxdb
      # Mount for influxdb configuration
      - /etc/influxdb/config:/etc/influxdb
    ports:
      # The API for InfluxDB is served on port 8086
      - "8086:8086"
    networks:
      - influx
networks:
  influx:

volumes:
  chronograf-data:
  kapacitor-data:
  influxdb-data:

Requirements

• a docker swarm with n managers, p workers

1/ Prepare configuration files

• on managers :
  • create /etc/kapacitor/config/kapacitor.conf from
    https://github.com/influxdata/sandbox/blob/master/kapacitor/config/kapacitor.conf
  • create /etc/influxdb/config/influxdb.conf from
    https://github.com/influxdata/sandbox/blob/master/influxdb/config/influxdb.conf
• on managers & workers :
  • create /etc/telegraf/telegraf.conf from
    https://github.com/influxdata/sandbox/blob/master/telegraf/telegraf.conf
  • In telegraf.conf replace $HOSTNAME with the name of the node (otherwise it will be <CONTAINER_ID>)

2/ Copy and Run the stack

• on a manager :
  • copy the above docker-compose-tick.yml file
  • run command :

docker stack deploy --compose-file docker-compose-tick.yml tick

Advises
If you have more than one manager (and you should), as distributed filesystem is not yet available within docker, to avoid data loss upon restart, I advise you to :

• In docker-compose-tick.yml set the constraint node to one manager by hostname :

constraints:
  - node.hostname == <ONE_MANAGER_NODE_HOSTNAME>

• At the end of telegraf.conf, only keep inputs.influxdb configuration on the manager node where influxdb is constrained :

[[inputs.influxdb]]
  urls = ["http://influxdb:8086/debug/vars"]

3/ Set up

• Go to Chronograf URL : http://<LAN_IP_OF_A_NODE>:8888
• Homepage > Set Connection String to http://influxdb:8086
• Menu ALERTING > Configure Kapacitor > set URL to http://kapacitor:9092

Caution

• influxdb and kapacitor components are not clustered

This looks awesome! I would definitely advise taking the sample documentation server out of there. Also we now ship an official chronograf image. If you ever have any issues pop over to community.influxdata.com!

Thanks, I've updated the stack with the new official chronograf image.

Hello, thanks for sharing this stack-file. I've just made a fork and updated things for docker stack - deployments.
I think this file should be updated with the fork - for it is linked in the official influx docs.
Here it is: https://gist.github.com/rdxmb/cfc9a6bec31b36048ba2cfd8a908e198

What I have changed:

• update the docker-compose-version to the actual 3.4 -> https://docs.docker.com/compose/compose-file/
• remove the depends_on keys, as they were ignored with using docker stack deploy -> https://docs.docker.com/compose/compose-file/#depends_on
• remove the definitions of the network - for docker stack creates the network itself
• remove the restart_policy , for it seems a good solution to work with always , which is the default -> https://docs.docker.com/compose/compose-file/#restart_policy

Kind regards!