Updates to Alerta transport (librenms#18202)

Add 'Origin' field to the Alerta Transport to be able to filter for LibreNMS alerts in Alerta.

Also tidied up the alert data to reduce the volume of repeated info which makes the alert hard to read:

- Remove duplicate 'title' values in the data to clean up
- Remove duplicate 'type' values
- Remove 'moreInfo' value that doesn't work

Co-authored-by: Justin Lentz <[email protected]>

Author: domleb

LibreNMS/Alert/Transport/Alerta.php

@@ -21,7 +21,6 @@
 use LibreNMS\Enum\AlertState;
 use LibreNMS\Exceptions\AlertTransportDeliveryException;
 use LibreNMS\Util\Http;
-use LibreNMS\Util\Url;
 
 class Alerta extends Transport
 {
@@ -30,25 +29,21 @@ public function deliverAlert(array $alert_data): bool
         $severity = ($alert_data['state'] == AlertState::RECOVERED ? $this->config['recoverstate'] : $this->config['alertstate']);
         $data = [
             'resource' => $alert_data['display'],
-            'event' => $alert_data['name'],
+            'event' => $alert_data['title'],
             'environment' => $this->config['environment'],
             'severity' => $severity,
-            'service' => [$alert_data['title']],
+            'service' => [$alert_data['type']],
             'group' => $alert_data['name'],
             'value' => $alert_data['state'],
-            'text' => strip_tags($alert_data['msg']),
-            'tags' => [$alert_data['title']],
+            'text' => $alert_data['msg'],
             'attributes' => [
                 'sysName' => $alert_data['sysName'],
                 'sysDescr' => $alert_data['sysDescr'],
                 'os' => $alert_data['os'],
-                'type' => $alert_data['type'],
                 'ip' => $alert_data['ip'],
                 'uptime' => $alert_data['uptime_long'],
-                'moreInfo' => '<a href=' . Url::deviceUrl($alert_data['device_id']) . '>' . $alert_data['display'] . '</a>',
             ],
-            'origin' => $alert_data['rule'],
-            'type' => $alert_data['title'],
+            'origin' => $this->config['origin'],
         ];
 
         $res = Http::client()
@@ -74,18 +69,24 @@ public static function configTemplate(): array
                     'descr' => 'Alerta API URL',
                     'type' => 'text',
                 ],
-                [
-                    'title' => 'Environment',
-                    'name' => 'environment',
-                    'descr' => 'An allowed environment from your alertad.conf.',
-                    'type' => 'text',
-                ],
                 [
                     'title' => 'Api Key',
                     'name' => 'apikey',
                     'descr' => 'Your alerta api key with minimally write:alert permissions.',
                     'type' => 'password',
                 ],
+                [
+                    'title' => 'Origin',
+                    'name' => 'origin',
+                    'descr' => 'Name of this monitoring source e.g. LibreNMS.',
+                    'type' => 'text',
+                ],
+                [
+                    'title' => 'Environment',
+                    'name' => 'environment',
+                    'descr' => 'An allowed environment from your alertad.conf.',
+                    'type' => 'text',
+                ],
                 [
                     'title' => 'Alert State',
                     'name' => 'alertstate',

doc/Alerting/Transports/Alerta.md

@@ -10,7 +10,8 @@ alerts from many other monitoring tools on a single screen.
 | Config | Example |
 | ------ | ------- |
 | API Endpoint   | http://alerta.example.com/api/alert |
-| Environment | Production |
 | Apy key | api key with write permission |
+| Origin | LibreNMS |
+| Environment | Production |
 | Alert state | critical |
 | Recover state | cleared |