InstrumentalD Role for Ansible

This role installs and sets up InstrumentalD on systems using RHEL/CentOS and Ubuntu.

Quick Start

Installation

Use this command to install the role:

ansible-galaxy install ayltai.instrumentald

Usage

To use the role, create a playbook like this:

---
- 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	[]	Docker instance socket addresses to monitor.
instrumentald_memcached_urls	[]	Memcached instance URLs to monitor.
instrumentald_mongodb_urls	[]	MongoDB instance URLs to monitor.
instrumentald_mysql_urls	[]	MySQL instance URLs to monitor.
instrumentald_nginx_urls	[]	Nginx instance URLs to monitor.
instrumentald_postgresql_urls	[]	PostgreSQL instance URLs to monitor.
instrumentald_redis_urls	[]	Redis instance URLs to monitor.
instrumentald_package_name	instrumentald_1.1.1_linux-x86_64	The name of the InstrumentalD package to install.

Development

This project uses Docker to create a consistent development environment.

Install Docker

Download and install Docker from here.

Build Docker Image

Build the Docker image with this command:

docker build --tag instrumentald:latest .

Run Docker Container

To run the container, use:

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

You will have a shell open on a system with all necessary tools installed.

Install Dependencies

Inside the Docker container, run:

pip3 install -r requirements.txt

Unit Testing

To perform unit testing, run this in the Docker container:

molecule test

License

This project is licensed under the MIT License.

References

• Instrumental
• Ansible
• Ansible Galaxy