Ansible role prometheus-msteams

ansible-prometheus-msteams

To install and configure prometheus-msteams for sending notifications from alertmanager to microsoft teams

Synopsis

This role was created to install and configure prometheus-msteams when I figured out there is no direct way we can use microsoft teams as receiver in alertmanager config. I didn't find any existing ansible role for this thats how this role was created. This role is inspired from ansible-node-exporter.

Requirements

Ansible >= 2.9 (Earlier versions may work, but I haven't tested)

Role Variables

All variables in default/main.yml can be overrided

Name	Default Value	Description
`prometheus_msteams_version`	latest	prometheus-msteams version to install
`prometheus_msteams_binary_local_dir`	""	To allow to use local packages from controller machine instead of github packages
`prometheus_msteams_template_local_dir`	""	To allow to use local teams card template on controller machine than from github
`prometheus_msteams_config_dir`	"/etc/prometheus_msteams"	Location to store server configs
`prometheus_msteams_web_listen_address`	"0.0.0.0:2000"	prometheus_msteams listen addrress
`prometheus_msteams_request_uri`	"alertmanager"	teams-request-uri
`prometheus_msteams_channels`	[]	Channels to which alerts to send from alert manager

Dependencies

Nil

Usage

From galaxy

ansible-galaxy install slashpai.ansible_prometheus_msteams

git submodule

To add as submodule to your project instead of pulling from galaxy

git submodule add -b main https://github.com/slashpai/ansible-prometheus-msteams.git roles/prometheus-msteams

To get role updates

git submodule update --remote

Example Playbook

- hosts: all
  roles:
    - slashpai.ansible_prometheus_msteams

Example playbook using git submodule

Contributing

Fork the project on GitHub
Clone the project
Add changes (and tests)
Commit and push
Create a pull request

TODO

Add tests for ubuntu and figure out which inspec version to use due to licencing difference

License

MIT