InstrumentalD role for Ansible

Install and configure InstrumentalD on RHEL/CentOS-based and Ubuntu systems

Quick start

Installation

ansible-galaxy install ayltai.instrumentald

Usage

---
- hosts: all
  roles:
    - ayltai.instrumentald
  vars:
    instrumental_api_key: replace_me

Variables

Name	Default	Description
instrumental_api_key	replace_me	Your Instrumental account API key.
instrumentald_docker_sockets	[]	The socket address of the Docker instances to be monitored.
instrumentald_memcached_urls	[]	The URL of the Memcached instances to be monitored.
instrumentald_mongodb_urls	[]	The URL of the MongoDB instances to be monitored.
instrumentald_mysql_urls	[]	The URL of the MySQL instances to be monitored.
instrumentald_nginx_urls	[]	The URL of the Nginx instances to be monitored.
instrumentald_postgresql_urls	[]	The URL of the PostgreSQL instances to be monitored.
instrumentald_redis_urls	[]	The URL of the Redis instances to be monitored.
instrumentald_package_name	instrumentald_1.1.1_linux-x86_64	The package name of InstrumentalD to be installed.

Development

This project uses Docker to create an unified environment for development.

Install Docker

Download and install Docker from here.

Build Docker image

docker build --tag instrumentald:latest .

Run Docker container

docker run \
--privileged \
-v $(pwd):/ansible-instrumentald \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /sys/fs/cgroup:/sys/fs/cgroup:ro \
-it --rm \
instrumentald:latest

Now you have a shell running on a system with all the necessary tools installed.

Install dependencies

In the Docker container, run:

pip3 install -r requirements.txt

Unit testing

In the Docker container, run:

molecule test

License

MIT

References

• Instrumental
• Ansible
• Ansible Galaxy