From bc02c123e63abca4c5006ab50444344f8067374b Mon Sep 17 00:00:00 2001
From: Dan Helfman <witten@torsion.org>
Date: Mon, 27 Jan 2020 15:32:09 -0800
Subject: [PATCH] Monitor backups with PagerDuty hook integration (#245).

---
 NEWS                                |   2 +
 README.md                           |   1 +
 borgmatic/config/schema.yaml        |   9 ++++
 borgmatic/hooks/dispatch.py         |   3 +-
 borgmatic/hooks/monitor.py          |   2 +-
 borgmatic/hooks/pagerduty.py        |  62 ++++++++++++++++++++++++++++
 docs/how-to/monitor-your-backups.md |  41 ++++++++++++++----
 docs/static/pagerduty.png           | Bin 0 -> 20107 bytes
 tests/unit/hooks/test_pagerduty.py  |  35 ++++++++++++++++
 9 files changed, 146 insertions(+), 9 deletions(-)
 create mode 100644 borgmatic/hooks/pagerduty.py
 create mode 100644 docs/static/pagerduty.png
 create mode 100644 tests/unit/hooks/test_pagerduty.py

diff --git a/NEWS b/NEWS
index 151e0d6..1be3d09 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,6 @@
 1.5.0
+ * #245: Monitor backups with PagerDuty hook integration. See the documentation for more
+   information: https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#pagerduty-hook
  * #255: Add per-action hooks: "before_prune", "after_prune", "before_check", and "after_check".
  * #274: Add ~/.config/borgmatic.d as another configuration directory default.
  * #277: Customize Healthchecks log level via borgmatic "--monitoring-verbosity" flag.
diff --git a/README.md b/README.md
index 16dc0ea..b2ba6e0 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,7 @@ borgmatic is powered by [Borg Backup](https://www.borgbackup.org/).
 <a href="https://healthchecks.io/"><img src="docs/static/healthchecks.png" alt="Healthchecks" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 <a href="https://cronitor.io/"><img src="docs/static/cronitor.png" alt="Cronitor" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 <a href="https://cronhub.io/"><img src="docs/static/cronhub.png" alt="Cronhub" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="https://www.pagerduty.com/"><img src="docs/static/pagerduty.png" alt="PagerDuty" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 <a href="https://www.rsync.net/cgi-bin/borg.cgi?campaign=borg&adgroup=borgmatic"><img src="docs/static/rsyncnet.png" alt="rsync.net" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 <a href="https://www.borgbase.com/?utm_source=borgmatic"><img src="docs/static/borgbase.png" alt="BorgBase" height="60px" style="margin-bottom:20px;"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
diff --git a/borgmatic/config/schema.yaml b/borgmatic/config/schema.yaml
index 3a09fdf..a228e7a 100644
--- a/borgmatic/config/schema.yaml
+++ b/borgmatic/config/schema.yaml
@@ -567,6 +567,15 @@ map:
                     for details.
                 example:
                     https://cronitor.link/d3x0c1
+            pagerduty:
+                type: str
+                desc: |
+                    PagerDuty integration key used to notify PagerDuty when a backup errors. Create
+                    an account at https://www.pagerduty.com/ if you'd like to use this service. See
+                    https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#pagerduty-hook
+                    for details.
+                example:
+                    a177cad45bd374409f78906a810a3074
             cronhub:
                 type: str
                 desc: |
diff --git a/borgmatic/hooks/dispatch.py b/borgmatic/hooks/dispatch.py
index 206b0d1..6c05cad 100644
--- a/borgmatic/hooks/dispatch.py
+++ b/borgmatic/hooks/dispatch.py
@@ -1,6 +1,6 @@
 import logging
 
-from borgmatic.hooks import cronhub, cronitor, healthchecks, mysql, postgresql
+from borgmatic.hooks import cronhub, cronitor, healthchecks, mysql, pagerduty, postgresql
 
 logger = logging.getLogger(__name__)
 
@@ -8,6 +8,7 @@ HOOK_NAME_TO_MODULE = {
     'healthchecks': healthchecks,
     'cronitor': cronitor,
     'cronhub': cronhub,
+    'pagerduty': pagerduty,
     'postgresql_databases': postgresql,
     'mysql_databases': mysql,
 }
diff --git a/borgmatic/hooks/monitor.py b/borgmatic/hooks/monitor.py
index aee2b8f..c4cf576 100644
--- a/borgmatic/hooks/monitor.py
+++ b/borgmatic/hooks/monitor.py
@@ -1,6 +1,6 @@
 from enum import Enum
 
-MONITOR_HOOK_NAMES = ('healthchecks', 'cronitor', 'cronhub')
+MONITOR_HOOK_NAMES = ('healthchecks', 'cronitor', 'cronhub', 'pagerduty')
 
 
 class State(Enum):
diff --git a/borgmatic/hooks/pagerduty.py b/borgmatic/hooks/pagerduty.py
new file mode 100644
index 0000000..0e613cc
--- /dev/null
+++ b/borgmatic/hooks/pagerduty.py
@@ -0,0 +1,62 @@
+import datetime
+import json
+import logging
+import platform
+
+import requests
+
+from borgmatic.hooks import monitor
+
+logger = logging.getLogger(__name__)
+
+EVENTS_API_URL = 'https://events.pagerduty.com/v2/enqueue'
+
+
+def ping_monitor(integration_key, config_filename, state, monitoring_log_level, dry_run):
+    '''
+    If this is an error state, create a PagerDuty event with the given integration key. Use the
+    given configuration filename in any log entries. If this is a dry run, then don't actually
+    create an event.
+    '''
+    if state != monitor.State.FAIL:
+        logger.debug(
+            '{}: Ignoring unsupported monitoring {} in PagerDuty hook'.format(
+                config_filename, state.name.lower()
+            )
+        )
+        return
+
+    dry_run_label = ' (dry run; not actually sending)' if dry_run else ''
+    logger.info('{}: Sending failure event to PagerDuty {}'.format(config_filename, dry_run_label))
+
+    if dry_run:
+        return
+
+    hostname = platform.node()
+    local_timestamp = (
+        datetime.datetime.utcnow().replace(tzinfo=datetime.timezone.utc).astimezone().isoformat()
+    )
+    payload = json.dumps(
+        {
+            'routing_key': integration_key,
+            'event_action': 'trigger',
+            'payload': {
+                'summary': 'backup failed on {}'.format(hostname),
+                'severity': 'error',
+                'source': hostname,
+                'timestamp': local_timestamp,
+                'component': 'borgmatic',
+                'group': 'backups',
+                'class': 'backup failure',
+                'custom_details': {
+                    'hostname': hostname,
+                    'configuration filename': config_filename,
+                    'server time': local_timestamp,
+                },
+            },
+        }
+    )
+    logger.debug('{}: Using PagerDuty payload: {}'.format(config_filename, payload))
+
+    logging.getLogger('urllib3').setLevel(logging.ERROR)
+    requests.post(EVENTS_API_URL, data=payload.encode('utf-8'))
diff --git a/docs/how-to/monitor-your-backups.md b/docs/how-to/monitor-your-backups.md
index c56a151..064c408 100644
--- a/docs/how-to/monitor-your-backups.md
+++ b/docs/how-to/monitor-your-backups.md
@@ -28,14 +28,15 @@ hooks](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#error-hoo
 below for how to configure this.
 4. **borgmatic monitoring hooks**: This feature integrates with monitoring
    services like [Healthchecks](https://healthchecks.io/),
-[Cronitor](https://cronitor.io), and [Cronhub](https://cronhub.io), and pings
-these services whenever borgmatic runs. That way, you'll receive an alert when
-something goes wrong or the service doesn't hear from borgmatic for a
-configured interval. See
-[Healthchecks
+[Cronitor](https://cronitor.io), [Cronhub](https://cronhub.io), and
+[PagerDuty](https://www.pagerduty.com/) and pings these services whenever
+borgmatic runs. That way, you'll receive an alert when something goes wrong or
+(for certain hooks) the service doesn't hear from borgmatic for a configured
+interval. See [Healthchecks
 hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#healthchecks-hook), [Cronitor
-hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronitor-hook), and [Cronhub
-hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronhub-hook)
+hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronitor-hook), [Cronhub
+hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronhub-hook), and
+[PagerDuty hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#pagerduty-hook)
 below for how to configure this.
 3. **Third-party monitoring software**: You can use traditional monitoring
 software to consume borgmatic JSON output and track when the last
@@ -200,6 +201,32 @@ mechanisms](https://docs.cronhub.io/integrations.html) when backups fail
 or it doesn't hear from borgmatic for a certain period of time.
 
 
+## PagerDuty hook
+
+[PagerDuty](https://cronhub.io/) provides incident monitoring and alerting,
+and borgmatic has built-in integration with it. Once you create a PagerDuty
+account and <a
+href="https://support.pagerduty.com/docs/services-and-integrations">service</a>
+on their site, all you need to do is configure borgmatic with the unique
+"Integration Key" for your service. Here's an example:
+
+
+```yaml
+hooks:
+    pagerduty: a177cad45bd374409f78906a810a3074
+```
+
+With this hook in place, borgmatic creates a PagerDuty event for your service
+whenever backups fail. Specifically, if an error occurs during a `create`,
+`prune`, or `check` action, borgmatic sends an event to PagerDuty after the
+`on_error` hooks run. Note that borgmatic does not contact PagerDuty when a
+backup starts or ends without error.
+
+You can configure PagerDuty to notify you by a [variety of
+mechanisms](https://support.pagerduty.com/docs/notifications) when backups
+fail.
+
+
 ## Scripting borgmatic
 
 To consume the output of borgmatic in other software, you can include an
diff --git a/docs/static/pagerduty.png b/docs/static/pagerduty.png
new file mode 100644
index 0000000000000000000000000000000000000000..c60c63ece018c1c7164c5311be42dd3dd60f4b67
GIT binary patch
literal 20107
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
LS3j3^P6<r_B|>*v

literal 0
HcmV?d00001

diff --git a/tests/unit/hooks/test_pagerduty.py b/tests/unit/hooks/test_pagerduty.py
new file mode 100644
index 0000000..76c5451
--- /dev/null
+++ b/tests/unit/hooks/test_pagerduty.py
@@ -0,0 +1,35 @@
+from flexmock import flexmock
+
+from borgmatic.hooks import pagerduty as module
+
+
+def test_ping_monitor_ignores_start_state():
+    flexmock(module.requests).should_receive('post').never()
+
+    module.ping_monitor(
+        'abc123', 'config.yaml', module.monitor.State.START, monitoring_log_level=1, dry_run=False
+    )
+
+
+def test_ping_monitor_ignores_finish_state():
+    flexmock(module.requests).should_receive('post').never()
+
+    module.ping_monitor(
+        'abc123', 'config.yaml', module.monitor.State.FINISH, monitoring_log_level=1, dry_run=False
+    )
+
+
+def test_ping_monitor_calls_api_for_fail_state():
+    flexmock(module.requests).should_receive('post')
+
+    module.ping_monitor(
+        'abc123', 'config.yaml', module.monitor.State.FAIL, monitoring_log_level=1, dry_run=False
+    )
+
+
+def test_ping_monitor_dry_run_does_not_call_api():
+    flexmock(module.requests).should_receive('post').never()
+
+    module.ping_monitor(
+        'abc123', 'config.yaml', module.monitor.State.FAIL, monitoring_log_level=1, dry_run=True
+    )