Include DeviceGroups in Alert Data (librenms#18443)

* Add device group information to alert object

* Implode device group IDs into a comma-separated string

Change device_group to implode device group IDs into a string.

* Rename 'device_group' to 'device_groups'

* Update RunAlerts.php

* Tweak

* StyleCI

* Add device groups information to alert templates

* Update device groups description in Templates.md

Clarified the format for device groups in the alert template.

Author: electrocret

LibreNMS/Alert/RunAlerts.php

@@ -104,6 +104,7 @@ public function describeAlert($alert)
         $obj['os'] = $device->os;
         $obj['type'] = $device->type;
         $obj['ip'] = $device->ip;
+        $obj['device_groups'] = $device->groups->pluck('name', 'id')->all();
         $obj['hardware'] = $device->hardware;
         $obj['version'] = $device->version;
         $obj['serial'] = $device->serial;

doc/Alerting/Templates.md

@@ -54,6 +54,7 @@ been up for 30344 seconds`.
 - Features of the Device: `$alert->features`
 - Serial number of the Device: `$alert->serial`
 - Location of the Device: `$alert->location`
+- Device Groups of the Device (group_id->group_name Array): `$alert->device_groups`
 - uptime of the Device (in seconds): `$alert->uptime`
 - Short uptime of the Device (28d 22h 30m 7s): `$alert->uptime_short`
 - Long uptime of the Device (28 days, 22h 30m 7s): `$alert->uptime_long`