Windows Exporter

This is an Ansible role for installing, setting up, and updating the Windows Exporter.

Upgrading to Version 2.x

With version 2.0.0 of this role, some variable names have changed. You need to update these in your playbooks:

• Change windows_exporter_listen_address to windows_exporter_web_listen_address
• Change windows_exporter_listen_port to windows_exporter_web_listen_port
• Change windows_exporter_metrics_path to windows_exporter_telemetry_path
• Change windows_exporter_timeout_margin to windows_exporter_scrape_timeout_margin
• Change windows_exporter_max_requests to windows_exporter_telemetry_max_requests

Upgrading to Version 3.x

In version 3.0.0, the variable windows_exporter_collector has been renamed to windows_exporter_collectors.

Requirements

• Ansible version: 2.12 or higher.
• You need pywinrm, a Python library that connects Ansible to Windows hosts using WinRM.
• Install passlib on the deploying host if you are using basic authentication (python3 -m pip install passlib[bcrypt]).
• You will also need cryptography or pyOpenSSL on the deploying host if using TLS.
• Supported platforms:
  • Windows: all versions

Role Variables

You can find all customizable variables in the defaults/main.yml file. For a description of available variables, check the meta/argument_specs.yml file. Detailed descriptions and defaults for preset variables are in the vars/main.yml file.

Dependencies

There are no dependencies.

Example Playbook

To install and configure the Windows Exporter, and to set a custom query for the service collector, use the following example:

---
- name: 'Setup the Windows Exporter'
  hosts: windows_exporter

  roles:
    - role: antmelekhin.windows_exporter
      windows_exporter_collectors_enabled: '[defaults],memory'
      windows_exporter_collectors:
        - name: service
          flags:
            services-where: Name='windows_exporter'

License

MIT

Author Information

Melekhin Anton.