Alerts

The EMQX Platform provides a comprehensive alert system that helps users and operations teams monitor the health and status of deployments in real time. It supports alert generation, customizable alert rules, and multiple integration options to ensure timely notifications and rapid incident response.

To access the alert system, go to Monitor > Alerts in the left-side navigation menu.

The Alerts page consists of three tabs:

• Alert List: View all generated alerts.
• Alert Rules: Configure conditions that trigger alerts.
• Alert Integrations: Set up channels for receiving alerts (e.g., Email, PagerDuty, Webhook).

Alert List

The Alert List tab displays alerts that have been triggered by the current deployment. If no alerts have been triggered yet, the table will show "No Data."

Each alert entry includes the following fields:

• Time: Time when the alert occurred, displayed in the format 2025-07-30 11:22.
• Level: Severity level of the alert (e.g., Warning, Error).
• Information: Description of the issue.

Alert Rules

TIP

The Alert Rules module is not supported in Serverless deployments.

The Alert Rules tab allows you to define which types of events should trigger alerts. You can enable or disable rules individually or toggle all rules on/off using the switch in the top-right corner. Disabled rules will not send alerts to any configured integration channels.

Each rule includes:

• Enable: Toggle switch to activate or deactivate the rule.
• Name: Alert rule name, and explanation of the trigger condition.
• Threshold: Defines the condition under which an alert is triggered. Thresholds can be based on metrics such as usage rate, message count, or unsubscribe rate. Multiple severity levels may be configured (e.g., Warning, Error, Critical), and each level is associated with a specific threshold value. For example, an alert can be triggered when the usage rate reaches or exceeds 100%, or when more than 50% of clients unsubscribe.

Rules are organized by category.

Manage Alert Thresholds

You can set the alert thresholds by clicking the edit icon in the Threshold column.

Each alert rule supports one or more severity levels, such as Warning, Error, and Critical. Each level is associated with a specific trigger condition, which determines when the alert is triggered.

You can modify, delete, or add new thresholds using the dropdown and input fields in the Manage Alert Thresholds dialog. After making changes, click Confirm to apply them.

Alert Integrations

The Alert Integrations tab provides options for sending alerts via external channels:

• Email
• PagerDuty
• Webhook

You can test each integration using the Test button. If you need other alert integration methods, you can submit a ticket or email us.

Send Alerts to Email

You can configure alert notifications to be sent to one or more email addresses:

1. Enter an email address and click the + button to add it.
2. Click Test to verify email configuration.

Alerts will be sent immediately upon detection of any enabled events.

PagerDuty Incidents

The alert information is sent to the event of PagerDuty, and PagerDuty specifies the notification method.

1. In PagerDuty, create a new service.

   

2. Add api v2 integration and copy the integration key.

3. In EMQX Platform, click + New to add PagerDuty integration and paste the key.

4. You can use the test feature to check if the alert event is configured correctly. Click the Test button, then select an event to send a test message.

   

Alerts will be sent as incidents to your PagerDuty service.

Webhook Integration

EMQX Platform supports sending alerts to communication software or web services by integrating Webhook.

For more information, see Webhook Alerts.