Skip to main content

Incoming Alerts

The Incoming Alerts tab in XeroLite displays all alerts received from TradingView and other sources. This is your primary monitoring tool for tracking alert activity, debugging issues, and verifying that alerts are being received correctly.

Overview​

The Incoming Alerts tab shows:

  • All alerts received by XeroLite
  • Alert processing status
  • Alert message details
  • Timestamp and source information
  • Error messages if alerts fail

Accessing Incoming Alerts​

  1. Log in to XeroLite
  2. Click on the "Incoming Alerts" tab (first tab with bell icon)
  3. The alerts list will display automatically

Understanding the Alerts List​

Alert Information Displayed​

Each alert shows:

  • ID: Unique alert identifier
  • Received: Timestamp when alert was received
  • Name: Alert name/strategy name (clickable to filter)
  • Symbol: Trading symbol with currency
  • Order Type: Type of order (MARKET, LIMIT, TRAIL)
  • Price: Limit price or trailing stop price
  • Quantity: Order quantity
  • Action: BUY or SELL
  • Stop Loss / Take Profit: SL and TP values if configured
  • Routing Status: Success, Error, Pending, Routed, etc.
  • Alert Message: Full JSON message (click to view)

Alert Status Indicators​

  • ✅ Success/Routed: Alert processed successfully and order was sent to IB
  • ⚠️ Pending: Alert is being processed
  • ❌ Error: Alert had validation or processing errors
  • 🔒 Unauthorized: IP address not whitelisted
  • ⏰ License Expired: License key has expired

Filtering Alerts​

Date Range Filter​

Filter alerts by date range:

  • Today: Alerts from today only
  • 7D: Last 7 days
  • 15D: Last 15 days
  • 30D: Last 30 days

How to use:

  1. Click on the date range buttons at the top of the alerts list
  2. The list will automatically refresh with filtered results

Strategy Name Filter​

Filter alerts by alert name/strategy name:

  1. Click on any alert name in the list
  2. The list will filter to show only alerts with that name
  3. Use the Strategy Selector dropdown to clear filter or select different strategy

Pagination​

The alerts list uses pagination to handle large numbers of alerts:

  • Page Size: Choose how many alerts to display per page (default: 20)
  • Navigation: Use page controls to navigate through alerts
  • Total Count: See total number of alerts matching your filters

Auto-Refresh​

The Incoming Alerts tab automatically refreshes every 10 seconds to show new alerts in real-time.

  • ✅ Enabled by default: No action needed
  • The refresh happens automatically in the background
  • New alerts will appear without manual refresh

Manual Refresh​

To manually refresh the alerts list:

  1. Click the Refresh button (circular arrow icon)
  2. The list will reload with the latest alerts

Viewing Alert Details​

To view full alert message details:

  1. Click on the alert message badge in the Name column
  2. A popup will show the complete JSON message
  3. Review the message to verify all fields are correct

Clearing Alert Logs​

You can delete all alerts from the log:

  1. Click the Delete button (trash icon)
  2. Confirm deletion in the modal dialog
  3. Important: Deleting logs does NOT cancel any open orders with your broker
  4. All order management must be handled manually in your broker's client

⚠️ Warning: This action cannot be undone. Only delete logs if you're sure you don't need the historical data.

Data Retention​

  • Maximum Retention: XeroLite keeps a maximum of 30 days of alert records
  • Automatic Cleanup: Older records are automatically removed
  • No Manual Cleanup Needed: The system manages retention automatically

Understanding Alert Errors​

If an alert shows an error status, check the error message:

  • "Invalid JSON format": Alert message has syntax errors
  • "Missing required field": Required field is missing from alert
  • "Unauthorized access": IP address not whitelisted
  • "License expired": License key needs to be renewed
  • "TWS disconnected": XeroLite is not connected to TWS
  • "Validation error": Alert message failed validation

Best Practices​

  1. Monitor Regularly: Check Incoming Alerts regularly to ensure alerts are being received
  2. Filter by Strategy: Use strategy name filtering to focus on specific alerts
  3. Review Errors: Pay attention to error statuses and fix issues promptly
  4. Use Date Filters: Use date range filters to focus on recent activity
  5. Check After Testing: After using Alert Message Validator & Sender, check Incoming Alerts to see the result

Need Help?​

If you're not seeing alerts in the Incoming Alerts tab: