From 746f1a892274193c1a8d8396cb72a099e8e6836f Mon Sep 17 00:00:00 2001 From: jokob-sk Date: Wed, 5 Nov 2025 15:26:57 +1100 Subject: [PATCH] DOCS: decription fix and --exclude-broadcast documentation Signed-off-by: jokob-sk --- docs/NOTIFICATIONS.md | 11 +++++++++-- front/plugins/notification_processing/config.json | 2 +- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/NOTIFICATIONS.md b/docs/NOTIFICATIONS.md index a8b6a8eab..58d50418e 100755 --- a/docs/NOTIFICATIONS.md +++ b/docs/NOTIFICATIONS.md @@ -47,11 +47,18 @@ In Notification Processing settings, you can specify blanket rules. These allow 3. A filter to allow you to set device-specific exceptions to New devices being added to the app. 4. A filter to allow you to set device-specific exceptions to generated Events. -## Ignoring devices 🔕 +## Ignoring devices 💻 ![Ignoring new devices](./img/NOTIFICATIONS/NEWDEV_ignores.png) You can completely ignore detected devices globally. This could be because your instance detects docker containers, you want to ignore devices from a specific manufacturer via MAC rules or you want to ignore devices on a specific IP range. 1. Ignored MACs (`NEWDEV_ignored_MACs`) - List of MACs to ignore. -2. Ignored IPs (`NEWDEV_ignored_IPs`) - List of IPs to ignore. \ No newline at end of file +2. Ignored IPs (`NEWDEV_ignored_IPs`) - List of IPs to ignore. + +## Ignoring notifications 🔕 + +You can filter out unwanted notifications globally. This could be because of a misbehaving device (GoogleNest/GoogleHub (See also [ARPSAN docs and the `--exclude-broadcast` flag](https://github.com/jokob-sk/NetAlertX/tree/main/front/plugins/arp_scan#ip-flipping-on-google-nest-devices))) which flips between IP addresses, or because you want to ignore new device notifications of a certian pattern. + +1. Events Filter (`NTFPRCS_event_condition`) - filter out Events from notifications. +2. New Devices Filter (`NTFPRCS_new_dev_condition`) - filter out New Devices from notifications, but log and keep a new device in the system. \ No newline at end of file diff --git a/front/plugins/notification_processing/config.json b/front/plugins/notification_processing/config.json index 5c2f60b3e..acb4fbbff 100755 --- a/front/plugins/notification_processing/config.json +++ b/front/plugins/notification_processing/config.json @@ -149,7 +149,7 @@ "description": [ { "language_code": "en_us", - "string": "You can specify a SQL where condition to filter out Events from notifications. For example AND devLastIP NOT LIKE '192.168.3.%' will always exclude New Device notifications for all devices with the IP starting with 192.168.3.%." + "string": "You can specify a SQL where condition to filter out Events from notifications. For example AND devLastIP NOT LIKE '192.168.3.%' will always exclude any Event notifications for all devices with the IP starting with 192.168.3.%." } ] }