cloudalchemy.smokeping_prober

Ansible Role: smokeping_prober

Description

This role helps you set up smokeping_prober using Ansible.

Requirements

Ansible version 2.7 or higher (it may work with older versions, but we can't promise that)

Role Variables

You can change the following variables, which are listed in the defaults/main.yml file and in the table below.

Name	Default Value	Description
`smokeping_prober_version`	"0.3.0"	Version of the smokeping prober package. You can also use `latest`.
`smokeping_prober_web_listen_address`	"0.0.0.0:9374"	The address where smokeping_prober will listen.
`smokeping_prober_web_telemetry_path`	"/metrics"	Path for metrics data.
`smokeping_prober_buckets`	''	Comma-separated list of buckets to use.
`smokeping_prober_ping_interval`	'1s'	Duration of the ping interval.
`smokeping_prober_privileged`	true	Run in privileged ICMP mode.
`smokeping_prober_hosts`	[]	List of hosts to ping.

Example

Playbook

You can use this role in a playbook like this:

- hosts: all
  roles:
    - cloudalchemy.smokeping_prober

Demo site

We offer a demo site for a complete monitoring solution using Prometheus and Grafana. You can find the code and links to running examples in this GitHub repository, and the site is hosted on DigitalOcean.

Local Testing

To test the role locally, the best way is to use Docker along with molecule (version 3.x). You will need to install Docker on your machine. For instructions on getting started, check out the appropriate Docker package for your system. You can run your tests easily by executing molecule test.

Continuous Integration

By combining Molecule and CircleCI, we can test how new pull requests perform with different versions of Ansible and various operating systems. This allows us to create test scenarios for different configurations of the role. As a result, we have a large test matrix which may take longer than local testing, so please be patient.