Monitor Pinot with Pulse Alerts
Pulse alerts help you monitor the health and availability of Pinot services by continuously checking key metrics and triggering notifications when issues are detected.
With Pulse, you can:
- Enable built-in stock alerts to automatically track when the Pinot Broker, Controller, and Server services become unreachable.
- Enable predefined alerts that run multiple queries to detect more complex issues.
- Create custom alerts in Pinot to monitor key metrics and trigger notifications when thresholds are breached. Common metrics include:
- Memory Usage – Detects high memory consumption.
- GC Time – Flags long garbage collection cycles.
- Segment Upload Failures – Alerts on data upload issues.
- Ingestion Delay – Tracks lag in real-time data flow.
- Query Failure Rate – Monitors frequent query errors.
- Thread Pool Saturation – Identifies processing bottlenecks.
These alerts allow you to detect failures early, respond faster to service degradation, and maintain system reliability.
Types of Alerts
Pulse provides different types of alerts to help you monitor Pinot effectively.
You can enable built-in stock alerts, customize and enable stock and predefined ones, or create your own to track specific metrics with conditions.
| Alert Type | Description |
|---|---|
| Stock Alerts | These are built-in alerts with preconfigured filters and actions. You can enable, disable, or modify them based on your monitoring needs. |
| Predefined Alerts | These are stock alerts with multiple queries for deeper customization. |
| Custom Alerts | These are user-created alerts with fully configurable filters, actions, and notifications. |
View and Create Pinot Alerts
In the Pulse UI, navigate to the Alerts page to monitor Pinot-specific alerts:
- Select Service: Pinot to view all available stock and any custom alerts you have created.
- Select Predefined to view and manage editable, multi-query alerts for Pinot.
- To create a custom alert, click Create Alerts, choose Category: Pinot, and select the metric. Set threshold conditions to trigger the alert. Once created, it gets added to the service Pinot alerts.
Pinot Stock Alerts
Pulse provides built-in (stock) alerts with preconfigured filters and conditions. You can enable, disable, or modify these alerts based on your monitoring needs. These are useful for detecting common failures such as service unavailability.
| Alert Name | Description |
|---|---|
Pinot Broker Endpoint Check | Triggers an alert when the Pinot Broker service is unreachable, indicating potential service downtime or network issues. |
Pinot Controller Endpoint Check | Triggers an alert when the Pinot Controller service is unreachable, affecting coordination and metadata operations. |
Pinot Server Endpoint Check | Triggers an alert when the Pinot Server service is unreachable, which may disrupt data queries and ingestion. |
Pinot Predefined Alerts
These are stock alerts with multiple queries for deeper customization.
| Alert Name | Description |
|---|---|
Pinot_Controller_Interactive_Heap_Usage | Triggers an alert when the Controller's heap usage exceeds the defined threshold. Ensure the 'JVM Heap Maximum' value is configured. |
Pinot_Controller_Interactive_Heap_Usage | Triggers an alert when the Broker's heap usage crosses the threshold. Confirm that the 'JVM Heap Maximum' value is set. |
Pinot Server Interactive_Heap_Usage | Triggers an alert when the Server's heap usage surpasses the set threshold. Make sure the 'JVM Heap Maximum' value is configured. |
Pinot Custom Alerts
Custom alerts let you define alert logic using Pinot-specific metrics and conditions.
You can configure filters, set thresholds, and choose notification channels to monitor what matters most in your environment.
For detailed information about creating alerts and sending notifications, see Creating Alerts.
For the complete list of Pulse stock and predefined alerts, see Stock and Predefined Alerts.