Provision alert notification channels using config file (cloudalchemy#227)

[minor] release

Author: hyzth

README.md

@@ -58,6 +58,7 @@ All variables which can be overridden are stored in [defaults/main.yml](defaults
 | `grafana_datasources` | [] | List of datasources which should be configured |
 | `grafana_environment` | {} | Optional Environment param for Grafana installation, useful ie for setting http_proxy |
 | `grafana_plugins` | [] |  List of Grafana plugins which should be installed |
+| `grafana_alert_notifications` | [] | List of alert notification channels to be created, updated, or deleted |
 
 Datasource example:
 
@@ -78,6 +79,30 @@ grafana_dashboards:
     revision_id: 1
     datasource: prometheus
 ```
+
+Alert notification channel example:
+
+**NOTE**: setting the variable `grafana_alert_notifications` will only come into
+effect when `grafana_use_provisioning` is `true`. That means the new
+provisioning system using config files, which is available starting from Grafana
+v5.0, needs to be in use.
+
+```yaml
+grafana_alert_notifications:
+  notifiers:
+    - name: Channel 1
+      type: email
+      uid: channel1
+      is_default: false
+      send_reminder: false
+      settings:
+        addresses: "[email protected]"
+        autoResolve: true
+  delete_notifiers:
+    - name: Channel 2
+      uid: channel2
+```
+
 Use a custom Grafana Yum repo template example:
 
 - Put your template next to your playbook under `templates` folder

defaults/main.yml

@@ -211,11 +211,12 @@ grafana_dashboards_dir: "dashboards"
 
 # Alert notification channels to configure
 grafana_alert_notifications: []
-#   - name: "Email Alert"
-#     type: "email"
-#     isDefault: true
-#     settings:
-#       addresses: "[email protected]"
+#  - name: "Email Alert"
+#    type: "email"
+#    uid: channel1
+#    is_default: true
+#    settings:
+#      addresses: "[email protected]"
 
 # Datasources to configure
 grafana_datasources: []

molecule/alternative/playbook.yml

@@ -73,11 +73,13 @@
     grafana_plugins:
       - raintank-worldping-app
     grafana_alert_notifications:
-      - name: "Email Alert"
-        type: "email"
-        isDefault: true
-        settings:
-          addresses: "[email protected]"
+      notifiers:
+        - name: "Email Alert"
+          type: "email"
+          uid: notifier1
+          is_default: true
+          settings:
+            addresses: "[email protected]"
     grafana_dashboards:
       - dashboard_id: '1860'
         revision_id: '4'

tasks/notifications.yml

@@ -1,23 +1,13 @@
 ---
-- name: Check alert notifications list
-  uri:
-    url: "{{ grafana_api_url }}/api/alert-notifications"
-    user: "{{ grafana_security.admin_user }}"
-    password: "{{ grafana_security.admin_password }}"
-    force_basic_auth: true
-    return_content: true
-  no_log: true
-  register: alert_notifications
-
-- name: Create grafana alert notification channels
-  uri:
-    url: "{{ grafana_api_url }}/api/alert-notifications"
-    user: "{{ grafana_security.admin_user }}"
-    password: "{{ grafana_security.admin_password }}"
-    force_basic_auth: true
-    method: POST
-    body_format: json
-    body: "{{ item | to_json }}"
-  with_items: "{{ grafana_alert_notifications }}"
-  no_log: true
-  when: ((alert_notifications['json'] | selectattr("name", "equalto", item['name'])) | list) | length == 0
+- name: Create/Delete/Update alert notifications channels (provisioning)
+  become: true
+  copy:
+    content: |
+      apiVersion: 1
+      {{ grafana_alert_notifications | to_nice_yaml }}
+    dest: /etc/grafana/provisioning/notifiers/ansible.yml
+    owner: root
+    group: grafana
+    mode: 0640
+  notify: restart grafana
+  when: grafana_use_provisioning