cloudalchemy.pushgateway

Ansible Role: Pushgateway

Description

This Ansible role installs and configures the Prometheus pushgateway.

Requirements

Ansible version 2.7 or higher (Older versions may work, but we can't guarantee it).

Role Variables

You can change the default variables defined in defaults/main.yml or in the table below.

Name	Default Value	Description
`pushgateway_version`	1.3.1	Version of the Pushgateway package
`pushgateway_web_listen_address`	"0.0.0.0:9091"	Address where Pushgateway will listen
`pushgateway_web_external_url`	""	External URL for accessing Pushgateway, useful behind proxies (e.g., http://example.org/pushgateway)
`pushgateway_persistence`	true	Enable saving of data
`pushgateway_config_flags_extra`	{}	Extra configuration options for the Pushgateway startup

Example

Playbook

You can add the Pushgateway role to your playbook like this:

- hosts: all
  roles:
    - cloudalchemy.pushgateway

Demo Site

We offer a demo site that shows a complete monitoring solution with Prometheus and Grafana. The code repository and links to live examples can be found on GitHub, and the site is hosted on DigitalOcean.

Local Testing

For local testing of this role, it's best to use Docker and molecule (version 3.x). Make sure you have Docker installed. Follow the "Get started" guide for a suitable Docker package for your system. Running tests is easy; just type molecule test.

Continuous Integration

By using Molecule and CircleCI, we can test new pull requests across different Ansible versions and operating systems. This also helps us create various test scenarios for the role configurations. This may take longer than local testing, so please be patient.