Plant Control Notifications widget

What this widget is for

The Plant Control Notifications widget is a live, scrollable list of recent plant-control events — errors, warnings, system alerts — pulled from the logger's event log. Each entry shows the severity, message, and time, and clicking opens the full event detail.

Use it as the dashboard's "what just went wrong (or right)" panel — the place where the system tells you what it has been doing. For a graphical time-line of all device events use the Event Timeline widget; for events overlaid on a power chart use the Device Historical Analytics chart's events option.

Companion guides

• Dashboard overview — how to add, move, resize, and remove widgets.
• Event Timeline widget — the scatter-chart sibling that shows the same events across all device models on a swimlane chart.
• Device Historical Analytics chart — for events plotted on top of a data chart.

Where to find it

Open the Dashboard, click the pencil icon to enter edit mode, then click Add New Widget. Search the picker for Plant Control Notifications and click Add Widget.

The widget at a glance

The widget shows:

• A title at the top, with a small count badge showing how many events are matched by the active filter (and how many of those are currently shown).
• A scrollable list of event rows, newest first. Each row has a coloured severity stripe, the severity name (e.g. ERROR, WARNING, INFO), the message text, and the time.
• Click any row to open a dialog with the full event detail.

The list updates as new events arrive — newer entries appear at the top.

Configuring what's shown

Open the gear icon. The settings dialog has:

• Title — the header text.
• Lookback days — how far back to fetch. Pick Today, Last 7 days, Last 30 days, etc. Longer lookbacks pull more data on first load.
• Limit — the maximum number of entries to display at once. Set this to fit the height of the widget — too high and the list is wasted space; too low and you'll miss events.
• Severity switches — one switch per severity level (INFO, WARNING, ERROR, etc.). Untick severities you don't want to see; the list re-renders without refetching.

Reading the list

• Severity drives colour. Each row's left stripe and severity label are colour-coded so the highest-priority entries stand out at a glance — red / orange for errors and warnings, neutral colours for informational.
• Time format follows your site's timezone. Two sites in different timezones running side-by-side widgets will each show times in their own time.
• Click a row for the full event detail dialog with all of the event's metadata.

Severity filter shortcuts

Severities live in this widget's gear so you can prune the list quickly without going to the device pages. Some patterns that work well:

• Operator on a quiet day — turn off INFO, leave WARNING + ERROR. Quiet most of the time, loud when something happens.
• Investigating a fault — turn everything on. You'll see context messages around the issue.
• Service handover — turn off DEBUG / TRACE level chatter, leave operational severities. The list reads as an executive summary.

Who can do what

• Any signed-in user can add the widget, change its filters, and read entries. The widget is read-only — clicking an entry shows its details but never changes the system.

Common issues

• The list is empty. Either nothing matched the filter for the lookback window, or you've narrowed the severity switches too far. Open the gear and widen the filter.
• The list is the same after I changed a filter. Some changes (severity toggles) re-render in place without a refetch; the displayed count should update immediately. If it doesn't, the underlying cache may not have refreshed — close and reopen the widget settings to force a re-read.
• An event I expected is missing. Check the lookback window — for an event from last month with a 7-day lookback, you won't see it. Increase the lookback and try again.

Tips and gotchas

• The count badge tells you when to widen the list. When the badge reads "5 of 47" you know there are 42 more events matching the filter that aren't currently shown. Either bump the limit higher or tighten the filter.
• The widget refreshes with the dashboard. When Auto Update is on in your View Settings, the widget re-fetches its data on every refresh, so new events come in automatically.
• Pair with the Event Timeline widget. Notifications gives you the text view; Timeline gives you the when and how often view. Both pulling from the same event source means a single source of truth.