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.
- Description: Explanation of the trigger condition.
Rules are organized by category.
Alert Integrations
The Alert Integrations tab provides options for sending alerts via external channels:
- 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:
- Enter an email address and click the
+
button to add it. - 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.
In PagerDuty, create a new service.
Add api v2 integration and copy the integration key.
In EMQX Platform, click + New to add PagerDuty integration and paste the key.
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.