Alert configuration

Control which alerts appear in the Dashboard and which trigger outbound notifications

Workspace alert configuration lets you reduce noise without losing data. Each workspace has its own settings for visibility, severity filters, and per-integration (OEM) overrides.

For how alerts are stored and classified, see Alerts.

Where to configure#

  1. Open the Texture Dashboard.
  2. Go to Settings → Alerts (/settings/alerts).
  3. Adjust the controls below.
  4. Click Save to apply changes to the workspace.

Only workspace admins and owners can edit alert settings. Other members can view the current configuration in read-only mode.

Before you save for the first time#

Alert configuration is opt-in per workspace:

StateDashboardNotificationsDatabase
No saved configAll alerts visibleAll alerts fan out to DestinationsEverything captured
After first SaveFiltered per your settingsFiltered per your settingsEverything captured

Until you save at least once, the platform does not apply any visibility filters—even if the form shows recommended defaults (Critical and Warning on, Info off). Those defaults are what you see in the UI before the first save; they become enforced only after you click Save.

This keeps existing workspaces backward-compatible: behavior changes only when an admin explicitly configures the workspace.

Capture vs visibility#

Configuration affects what you see and what gets notified, not what Texture stores.

LayerAffected by config?
Ingestion and database storageNo — every alert is captured
Dashboard lists (alerts query, Site/Device alerts)Yes — after first save
Destination fanout (ALERT_CREATED, etc.)Yes — after first save

Hidden alerts remain available for audit, compliance, and internal operations. They are excluded from operator-facing views and external notification pipelines only.

If the platform cannot read your saved configuration (for example, a transient database error), it fails open: alerts stay visible and notifications continue until the config can be read again.

Controls#

Alert visibility (master switch)#

The Alert visibility toggle is the workspace-level on/off switch.

SettingDashboardNotificationsCapture
Enabled (default)Alerts shown subject to severity and OEM rulesFanout subject to severity and OEM rulesAlways on
DisabledNo alerts shownNo alert fanout to destinationsAlways on

When disabled, a warning explains that alerts are hidden and notifications are paused, but capture continues in the background.

Severity and OEM sections are visually dimmed when the master switch is off; they remain editable so you can prepare settings before re-enabling.

Severity filters#

Choose which severity levels are included in the Dashboard and notification pipeline. Each level is an independent toggle:

LevelTypical use
CriticalSafety, outages, and conditions requiring immediate action
WarningDegraded performance or elevated risk
InfoInformational events and lower-urgency notices

Only alerts whose severity matches an enabled level are shown and notified. For example, with Critical and Warning enabled and Info disabled, INFO alerts are captured but hidden from the UI and destinations.

Recommended starting point (pre-filled before first save):

  • Critical — on
  • Warning — on
  • Info — off

If you disable all three levels while visibility is enabled, no alerts appear in the Dashboard and none trigger notifications. Alerts are still captured.

UI labels vs behavior

The Dashboard may describe severity cards with phrases like "Critical + Warning." Backend filtering treats each level independently — you enable the specific severities you want, not a cumulative minimum threshold.

OEM overrides#

OEM overrides control visibility per connected integration (manufacturer). The section lists only OEMs with active system connections in the workspace.

SwitchBehavior
On (default)Alerts from that integration are included (subject to master switch and severity)
OffAlerts from that integration are hidden from the Dashboard and excluded from notification fanout

Overrides are keyed by manufacturer slug (for example, solaredge-web, enphase, sma) — the same identifier used when alerts are ingested. You do not need to turn integrations on explicitly; only off overrides are stored.

If no OEM connections exist, the OEM overrides section is not shown.

For provider slugs, ingestion paths, and volume quirks, see OEM alert reference. When the connection slug and stored Alert.provider differ (for example SolarEdge), confirm which key your alerts use before relying on OEM overrides.

What changes after you save#

Once configuration is saved, the same rules apply everywhere visibility is enforced:

  1. Dashboard — Alert lists, site/device alert panels, and counts respect the saved config.
  2. REST APIGET /v1/alerts returns only visible alerts after configuration is saved. See Alerts API.
  3. Destinations — Webhooks, email, SMS, and Kafka forwarders do not receive ALERT_CREATED / ALERT_UPDATED for filtered alerts. Events are still archived internally. See Management API: Destinations.

Workspace alert configuration (visibility, severity, OEM overrides) is configured in the Dashboard only — there is no REST endpoint for it today.

Common scenarios#

Reduce INFO noise from OEM integrations#

  1. Open Settings → Alerts.
  2. Leave Alert visibility enabled.
  3. Under severity, enable Critical and Warning; disable Info.
  4. Save.

INFO alerts continue to be stored but no longer appear in the Dashboard or trigger destinations.

Pause all alert notifications temporarily#

  1. Disable Alert visibility.
  2. Save.

All alerts are hidden and destination fanout stops. Re-enable when ready—severity and OEM settings are preserved.

Hide alerts from one noisy integration#

  1. Leave Alert visibility enabled.
  2. Under OEM overrides, turn Off for the integration you want to suppress.
  3. Save.

Other integrations and severities are unaffected.

Return to showing everything#

Delete filtering by saving a permissive config (all severities on, no OEM overrides off, visibility enabled), or contact Texture support if you need the stored configuration row reset for the workspace.

Permissions and workspaces#

  • Settings apply to the current workspace only. Switch workspaces in the Dashboard to configure each one separately.
  • Non-admin members see the same page in read-only mode without Save/Discard actions.
  • Alerts — Overview, data model, and capture principle
  • Alerts API — List and lifecycle endpoints (GET, POST, PATCH)
  • OEM alert reference — Provider slugs and ingestion quirks
  • Destinations — Delivering alert events to external systems