Ansible role: Prometheus exporters

Install and configure Prometheus exporters

Requirements

• Ansible >= 2.21
• Debian
  • Trixie

Role variables

Name	Type	Required	Default	Comment
prometheus_exporters	dict	no		exporters with config

prometheus_exporters

Name	Type	Required	Default	Comment
key	str	yes		exporter name
env	dict	no		environment variables
files	list(dict)	no		config file
state	str	no	present	if absent, uninstall exporter

Example:

node:
  env:
    ARGS:
      - "--collector.filesystem.mount-points-exclude=/test"
      - "--collector.systemd.unit-exclude=prometheus"
mysql:
  files:
    - path: "/var/lib/prometheus/.my.cnf"
      content: |-
        [client]
        database=mysql
        user=username
        host=localhost
        password=secret

prometheus_exporters.env

Name	Type	Required	Default	Comment
key	str	yes		environment variable name
value	str or list	yes		value of environment variable

prometheus_exporters.files

Name	Type	Required	Default	Comment
path	str	yes		config file path
content	str	yes		content of config file

How to use

- hosts: server
  roles:
    - nishiki.prometheus_exports
  vars
    prometheus_exporters:
      node:
        env:
          ARGS:
            - "--collector.filesystem.mount-points-exclude=/test"
            - "--collector.systemd.unit-exclude=prometheus"
      mysql:
        files:
          - path: "/var/lib/prometheus/.my.cnf"
            content: |-
              [client]
              database=mysql
              user=username
              host=localhost
              password=secret

Development

Test with molecule and docker

• install docker
• install python3 and python3-pip
• install molecule and dependencies pip3 install molecule molecule-plugins ansible-lint pytest-testinfra yamllint
• run molecule test

License

Copyright (c) 2026 Adrien Waksberg

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.