---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Alerting

# Stream Connect alerting {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Stream Connect alerting

Stream Connect alerting enables ServiceNow customers to receive real-time and threshold-based alerts and notifications for Stream Connect integrations.
It monitors multiple Stream Connect components actively and on a schedule to detect and report issues, helping you proactively manage integration health and performance.
Show full answer Show less  

## Alert Types and Monitoring

* **Event-type (real-time) alerts:** Triggered immediately upon detecting errors in Stream Connect components, such as failures in producers or consumers. These use active monitoring and predefined alerting properties to determine severity and notifications.
* **Threshold alerts:** Triggered when performance metrics exceed configured thresholds, like message lag or processing time. These use scheduled monitoring and generate alerts when thresholds are crossed, deactivating when values return below thresholds.

## Alert Management

Alerts are stored in the **Stream Connect Alerts \[sysscalerts\]** table, tracking active status, severity, type, and timestamps. Repeated alerts update the existing active record, while new alerts create new records. Alerts automatically deactivate after a configurable inactivity period. Alert logs with detailed messages are captured in the **Stream Connect Log \[sysconsumerlog\]** and retained for 30 days.

## Notifications

Users receive alert notifications via email, SMS, or the ServiceNow mobile app with detailed alert information. Notifications are controlled to avoid duplicates using configurable time intervals and severity escalation criteria. Administrators can tailor notification settings by alert type, severity (INFO, WARNING, CRITICAL), and user preferences. Notifications are sent to members of the **Stream Connect Alert Notifications** group, who have read access to alert records.

## Roles and Access Control

* **Kafka Admin role:** Full access to view, configure, and manage Stream Connect alerts, alerting properties, and notifications.
* **Stream Connect Alert Viewer role:** Read-only access to alert records and logs.

Access control rules restrict alert table operations and configuration to authorized roles. Domain separation is supported, allowing alert properties and records to be scoped by domain related to the affected consumer or topic.

## Plugin and Configuration

The Stream Connect Alerting functionality requires the **Stream Connect Alerting \[com.glide.hub.streamconnect.alerting\]** plugin, which activates automatically with the Stream Connect Installer plugin. Alerting properties define how alerts behave and are managed, configurable through the Stream Connect Alerting properties UI by Kafka Admins.  
Receive alerts and alert notifications for Stream Connect integrations.

Stream Connect uses both active and scheduled monitoring to detect events across multiple Stream Connect components. If an issue is detected, the system creates an alert, logs a message to the Stream Connect Log, and sends out an alert notification.

## Alerts {#stream-connect-alert.xml__section_fdb_vsw_jdc}

Stream Connect uses both event-type alerts and threshold alerts. Each type of alert has a set of alerting properties that specify how to handle the alert.

* Event-type alerts (or real-time alerts) are created when there's an error in a Stream Connect component. For example, when a producer is unable to write to a topic, or a consumer is unable to read from a topic. These alerts are built into to the code and use the alerting properties to
  determine the severity level and when to send a notification. Event-type alerts are detected through active monitoring which uses various mechanisms to detect events across multiple Stream Connect components. The system caches the configuration and detects the events when they occur.

* Threshold alerts are created when a value transitions from below the threshold to at or above the threshold. For example, when the lag on a topic goes beyond a certain number of messages, or the processing time
  of the messages in a topic is above a specified value. When a threshold alert decreases from at or above a threshold to below it, the active flag on the alert is set to false. Threshold alerts are detected through scheduled
  monitoring, where a scheduled job runs scripted checks on Stream Connect integrations. An alert is generated for thresholds that meet the alert configuration specified by the alerting properties.

{#stream-connect-alert.xml__ul_kkd_wsw_jdc}

For a list and description of the alerts, or to configure alerting properties, see [Stream Connect Alerting properties](https://www.servicenow.com/docs/hii5ORX0Pk3fdyd1CQ~unw "Specify alert properties and how alerts are managed in Stream Connect."). You must have the Kafka Admin role to view or modify alerting properties.

## Alert table {#stream-connect-alert.xml__section_qzt_xgs_tdc}

When an alert is triggered for the first time, an Alert \[sys_sc_alert\] record is added to the Stream Connect Alerts \[sys_sc_alerts\] table. If the same alert is triggered again, and the original alert record is still active, the record's Last Detections \[last_detection\] field is
updated. If the original alert record is not active, a new record is added to the alerts table. An alert record is deactivated when the alert has not been triggered for a specified amount of time. This time interval varies depending
on the type of alert and can be modified in the [Stream Connect Alerting properties](https://www.servicenow.com/docs/hii5ORX0Pk3fdyd1CQ~unw "Specify alert properties and how alerts are managed in Stream Connect.") UI.  
The Stream Connect alerts table shows if an alert is active and the alert's severity level, type, and updated date. It also displays:

* An alert's Number, which references the alert record. Each alert record contains detailed information about the alert, including the name of the affected component, the severity level, and the timestamp.
* An alert's Affected Entity, which references the target for an alert, for example, a Kafka Stream or a Kafka Flow Trigger.

{#stream-connect-alert.xml__ul_phz_c1b_ndc} You can view the Stream Connect Alerts table by navigating to Integration HubStream ConnectAlerts.

Alerts are available for 30 days. A table cleaner job handles the retention period for the Stream Connect alerts table. Active alerts are deactivated if they don't reoccur within a specified duration. The duration is configured per alert type in the Stream Connect Alerting properties.

## Alert logs {#stream-connect-alert.xml__section_uts_pxw_jdc}

Log messages for Stream Connect alerts are written to the Stream Connect Log \[sys_consumer_log\]. This log has an Alert \[sc_alert\] field that references the associated Stream Connect Alert record.

Logs are available for 30 days. The log retention period is determined by the table rotation schedule for the Stream Connect Log.

## Notifications {#stream-connect-alert.xml__section_kj1_jvw_jdc}

Receive alert notifications via email, SMS, or the ServiceNow® mobile app. Notifications contain detailed alert information, including the alert number, level, and a description.

When an alert is triggered, a notification is also triggered, unless a notification for that same alert was recently triggered. Each alert has a time interval property that specifies the amount of time, in seconds, required between
alert detections to have the detections count as two separate alerts. A notification is only triggered if the time since the last notification is greater than that time interval or, in the case of threshold-based alerts, if the
severity for the alert has increased since the last detection. This helps ensure that you don't receive multiple rapid notifications for the same alert. The time interval property for each alert can be modified from the Stream Connect Alerting properties UI.  
Administrators can configure notification settings based on alert types, user preferences, and alert severity levels. There are three alert severity levels in the Notifications \[sysevent_email_action\] table.

* Stream Connect Alert - INFO
* Stream Connect Alert - WARNING
* Stream Connect Alert - CRITICAL

{#stream-connect-alert.xml__ul_edm_221_ldc}You can opt in to different levels using the standard system notification capabilities on the platform. Administrators can also configure notification debounce settings, including the time interval and criteria for consolidating alerts. For notification details, see [Notifications](https://www.servicenow.com/docs/access?context=notifications&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

Notifications are sent to users who are members of the Stream Connect Alert Notifications group. The Stream Connect Alert Notifications group members inherit the Stream Connect Alert Viewer role so that everyone who receives notifications can use the link in the notification to see the alert record.

## Roles {#stream-connect-alert.xml__section_mcd_dtw_jdc}

To view Stream Connect Alerts, you must have the Kafka Admin role or the Stream Connect Alert Viewer role.

* The Kafka Admin \[kafka_admin\] role can view Stream Connect alert records and logs, configure Stream Connect Alerting properties, and configure alert notification settings.
* The Stream Connect Alert Viewer \[stream_connect_alert_viewer\] role has read-only access to Stream Connect alert records and logs.
{#stream-connect-alert.xml__ul_kvq_ktw_jdc}

## ACLs and domain separation {#stream-connect-alert.xml__section_xlw_jbx_jdc}

ACLs on the Stream Connect Alerts table enable a user with the Stream Connect Alert Viewer role to view the alerts table and the reports on that table. Users without that role can't read or report on that table. Only users with the Kafka Admin role can insert and update records
on that table. ACLs make the Stream Connect Alerting properties page available only to Kafka Admins.

On a domain-separated instance, the properties that govern alerts can be overridden on a per-domain basis. See [Domain separation application properties](https://www.servicenow.com/docs/access?context=ds-application-properties&version=australia&pubname=australia-platform-security&ft:locale=en-US) for details.

The domain used to look up properties is the domain of the topic or consumer. The Stream Connect Alerting properties UI for setting properties sets the global properties, not domain-specific overrides. There's no UI for setting domain-specific overrides. The sys_domain of the Stream Connect Alerts table should be the same as the domain of the consumer that triggered it, for consumer alerts, or the domain for the sys_kafka_topic record for producer alerts. For alerts where a consumer or
topic isn't known, the sys_sc_alert domain is set to global.

## Plugin {#stream-connect-alert.xml__section_bwv_hyw_jdc}

Stream Connect alerting requires the ServiceNow
Stream Connect Alerting \[com.glide.hub.stream_connect.alerting\] plugin. This plugin is automatically activated when the ServiceNow
Stream Connect Installer\[com.glide.hub.stream_connect.installer\] plugin is activated.
* **[Stream Connect Alerting properties](https://www.servicenow.com/docs/hii5ORX0Pk3fdyd1CQ~unw)**   
  Specify alert properties and how alerts are managed in Stream Connect.

*[\>]: and then


