Skip to content

Ansible Role linuxfabrik.lfops.monitoring_plugins_grafana_dashboards

This role deploys the Monitoring Plugins Grafana Dashboards for a Grafana Server using grizzly.

Available since LFOps 3.0.0.

How the Role Behaves

  • Dashboards stay in their folder on Grafana 13.1 and newer. From Grafana 13.1 on, grizzly files every dashboard it adds or updates in the root instead of in the folder named in the resource, and the dashboard loses the viewer permission it inherited from the folder, so viewers and the graphs embedded in IcingaWeb2 get "403". After applying, the role saves every dashboard that is not in its folder again, which puts it back and restores the permission. This also repairs dashboards that earlier runs left in the root. A dashboard whose resource names the folder general belongs into the root and is left there.

Dependent Roles

Any LFOps playbook that installs this role runs these for you. Optional ones can be disabled via the playbook's skip variables.

Tags

monitoring_plugins_grafana_dashboards

  • Deploys the Monitoring Plugins Grafana Dashboards.
  • Triggers: none.

Mandatory Role Variables

monitoring_plugins_grafana_dashboard__grafana_service_account_login

  • The login for a Grafana service account with a "Admin" token.
  • Type: Dictionary.

monitoring_plugins_grafana_dashboard__influxdb_login

  • The login for the InfluxDB database. Only needs to have read permissions.
  • Type: Dictionary.

monitoring_plugins_grafana_dashboards__repo_version

  • Which version of the monitoring plugins should be deployed? Possible options:

    • A specific release, for example 1.2.0.11. See the Releases.
    • dev: The development version (main branch). Use with care. Only works with monitoring_plugins__install_method: 'source'.

  • Defaults to lfops__monitoring_plugins_version for convenience.

  • Type: String.

Example:

# mandatory
monitoring_plugins_grafana_dashboard__grafana_service_account_login:
  username: 'grizzly'
  password: 'linuxfabrik'
monitoring_plugins_grafana_dashboard__influxdb_login:
  username: 'dashboard'
  password: 'linuxfabrik'
monitoring_plugins_grafana_dashboards__repo_version: '1.2.0.11'

Optional Role Variables

monitoring_plugins_grafana_dashboard__influxdb_database_name

  • The name of the InfluxDB database.
  • Type: String.
  • Default: '{{ icinga2_master__influxdb_database_name }}'

monitoring_plugins_grafana_dashboard__influxdb_host

  • The host of the InfluxDB database.
  • Type: String.
  • Default: '{{ icinga2_master__influxdb_host }}'

monitoring_plugins_grafana_dashboards__grafana_url

  • The URL under which Grafana is reachable.
  • Type: String.
  • Default: '{{ grafana__api_url }}'

Example:

# optional
monitoring_plugins_grafana_dashboard__influxdb_database_name: 'my-director-db'
monitoring_plugins_grafana_dashboard__influxdb_host: '127.0.0.1'
monitoring_plugins_grafana_dashboards__grafana_url: 'http://localhost:3000'

License

The Unlicense

Author Information

Linuxfabrik GmbH, Zurich