Events and alerts in Automate Turboscale

Event Alerts provide real-time updates on the health of your self-hosted infrastructure. Use them to monitor for potential problems and quickly resolve issues that might disrupt your testing.

Event alerts provide real-time visibility into the health of your self-hosted grid. You can:

• View real-time events when you open the page.
• Review the last 7 days of event history for a cluster.
• See impact and fix suggestions for each error or warning.
• Surface cluster-level events in the build dashboard so teams notice issues while looking at tests.

By monitoring key infrastructure events, you can identify and resolve issues in a self-serve manner that might impact your test runs, often before they cause widespread failures.

This guide explains how to use Event Alerts to monitor your grid, understand event logs, and take corrective action.

Prerequisites

• Events are collected only from clusters where the BrowserStack Agent is installed and running.
• Install and configure the Agent on every cluster you want to monitor.
• If the Agent is not installed, the Grid Management → Events page will show setup steps and no events will appear for that cluster.
• You need access to Grid Management in the project.

Find events

Event alerts appear in two locations, giving you both a high-level overview and a build-specific view of your grid’s health.

Cluster-level alerts

Cluster-level alerts provide a centralized view of your entire grid’s health. You can find them in the Grid Management section. These events are captured continuously, even when no tests are running, helping you monitor the overall stability of your infrastructure.

• Use this view to monitor the overall health of nodes and pods across your entire cluster.

• This alert appears under Grid Management > Events.

Build-level alerts

Build-level alerts appear directly on the Automate Dashboard when an infrastructure event occurs that may have directly impacted a specific test build. This helps you quickly correlate a test failure with an underlying grid issue.

• Use this view to quickly diagnose if a test failure was caused by a problem with the grid infrastructure.
• This alert appears as a banner on the Build Details page.

View and filter events

To access and filter your cluster’s event logs:

1. From the left-hand navigation menu, select Grid Management.

2. Click the Events tab to open the event log view.

3. By default, you will see events from the last hour. To change the time range, use the filter buttons:

   • 15m, 30m, 1H, 1D: Select a predefined time range.
   • Custom: Click the date field to open a calendar and select a custom date range. You can view logs for up to the last 7 days.

After following these steps, you’ll see a list of all cluster events that occurred within your selected time frame.

Understanding event details

Each event log provides details to help you diagnose the issue. For critical errors, we also provide suggested actions.

Here are some common build events you might encounter:

Here are some common cluster events you might encounter: