Merge pull request #501 from stackhpc/feature/yoga/redfish-exporter

Adds seed_redfish_exporter_container

Author: markgoddard

doc/source/configuration/monitoring.rst

@@ -247,3 +247,37 @@ customer. The following are key considerations for that conversation:
   e.g. bond0 on a controller has eth0 and eth1 as members. bond1 on a compute
   uses eth0 and eth1 as members. This is not problematic as it is only
   the bond itself that is relabelled.
+
+Redfish exporter
+================
+
+Redfish exporter will query the overcloud BMCs via their redfish interfaces
+to produce various metrics relating to the hardware, and system health.
+
+To configure the exporter, adjust the variables in
+``$KAYOBE_CONFIG_PATH/stackhpc-monitoring.yml`` to use appropriate values:
+
+.. code-block:: yaml
+
+    # Whether the redfish exporter is enabled.
+    stackhpc_enable_redfish_exporter: true
+
+    # Redfish exporter credentials
+    redfish_exporter_default_username: "{{ ipmi_username }}"
+    redfish_exporter_default_password: "{{ ipmi_password }}"
+
+    # The address of the BMC that is queried by redfish exporter for metrics.
+    redfish_exporter_target_address: "{{ ipmi_address }}"
+
+Deploy the exporter on the seed:
+
+.. code-block:: console
+
+    kayobe seed service deploy -t seed-deploy-containers -kt none
+
+It is required that you re-configure the Prometheus, Grafana
+services following deployment, to do this run the following Kayobe command.
+
+.. code-block:: console
+
+    kayobe overcloud service reconfigure -kt grafana,prometheus

etc/kayobe/containers/redfish_exporter/post.yml

@@ -0,0 +1,6 @@
+---
+- name: Restart redfish exporter container if config changed
+  become: true
+  command: docker kill -s SIGHUP redfish_exporter
+  when:
+    - redfish_exporter_config is changed

etc/kayobe/containers/redfish_exporter/pre.yml

@@ -0,0 +1,16 @@
+---
+
+- name: Ensure /opt/kayobe/containers/redfish_exporter exists
+  file:
+    path: "/opt/kayobe/containers/redfish_exporter"
+    state: directory
+    mode: 0770
+  become: true
+
+- name: Template redfish exporter configuration file
+  template:
+    src: "{{ kayobe_config_path }}/containers/redfish_exporter/redfish_exporter.yml"
+    dest: /opt/kayobe/containers/redfish_exporter/
+    mode: 0660
+  become: true
+  register: redfish_exporter_config

etc/kayobe/containers/redfish_exporter/redfish_exporter.yml

@@ -0,0 +1,5 @@
+---
+hosts:
+  default:
+    username: "{{ redfish_exporter_default_username }}"
+    password: "{{ redfish_exporter_default_password }}"

etc/kayobe/inventory/groups

@@ -131,3 +131,9 @@ rgws
 
 [cis-hardening:children]
 overcloud
+
+###############################################################################
+# Monitoring groups.
+
+[redfish_exporter_targets:children]
+overcloud