Alert Troubleshooting Guide
This page provides troubleshooting guidance for EMQX Cloud alerts. Use it to review an alert's trigger conditions, identify likely causes, and take the recommended corrective actions.
Serverless Deployments
Resources and Quotas
| Alert | Description |
|---|---|
| Session Limit Reached | Triggered when the number of client connections reaches the deployment limit. |
| Serverless TPS Limit Reached | Triggered when the deployment reaches its transactions per second (TPS) limit. |
| Free Traffic Quota Exhausted | Triggered when the deployment's free traffic usage reaches a specified threshold. |
| Free Connection Minutes Limit Reached | Triggered when the deployment's free connection minutes reach a specified threshold. |
| Free Rule Actions Limit Reached | Triggered when the deployment's free rule action executions reach a specified threshold. |
Data Integration
| Alert | Description |
|---|---|
| Connector Status Abnormal | Triggered when a data integration connector enters an abnormal state. |
| Action Status Abnormal | Triggered when a data integration action enters an abnormal state. |
Dedicated Deployments
Authentication and Access Control
| Alert | Description |
|---|---|
| High Volume of Authentication Failures | Triggered when a large number of client authentication attempts fail. |
| High Volume of ACL Denials | Triggered when a large number of client authorization (ACL) checks fail. |
| External Auth/ACL Module Status Abnormal | Triggered when an external EMQX authentication or authorization (ACL) module enters an abnormal state. |
| Client Banned for Connection Flapping | Triggered when a client is temporarily banned after repeated connection flapping. |
Resources and Quotas
| Alert | Description |
|---|---|
| Session Limit Reached | Triggered when the number of client connections reaches the deployment limit. |
| TPS Limit Reached | Triggered when the deployment reaches its transactions per second (TPS) limit. |
| Free Traffic Quota Exhausted | Triggered when the deployment's free traffic usage reaches a specified threshold. |
Clients and Messages
| Alert | Description |
|---|---|
| Message Drops | Triggered when messages are dropped because a session message queue is full. |
| Mass Client Unsubscription | Triggered when many clients unsubscribe within a short period. |
| Mass Client Disconnection | Triggered when many clients disconnect within a short period. |
Network and Security
| Alert | Description |
|---|---|
| TLS Certificate Expiring or Expired | Sent 1 to 30 days before a deployment's TLS certificate expires and after it has expired. |
| VPC Peering Connection Status Abnormal | Triggered when a VPC peering connection enters an abnormal state. |
| PrivateLink Status Abnormal | Triggered when a PrivateLink endpoint connection enters an abnormal state. |
Data Integration
| Alert | Description |
|---|---|
| Connector Status Abnormal | Triggered when a data integration connector enters an abnormal state. |
| SQL Matching Failed | Triggered when SQL matching fails for a data integration rule. |
| Action Execution Failed | Triggered when a data integration action fails to execute. |
| Action Status Abnormal | Triggered when a data integration action enters an abnormal state. |