Real-time monitoring and debugging tools for your browser sessions
The Session Inspector is accessible from the Dashboard by clicking a Session item.
This page provides all the tools to pinpoint possible problems like network issues, anti-bot mechanisms, or asynchronous events resulting in mismatches of selectors.
A replay of each Session is featured in the Sessions page. This replay is a capture of the webpage, not a video, and can be inspected with your Chrome DevTools.
Here are some key takeaways:
Note that the replay length may not match the total session duration. This is because session timing starts when the browser begins running, while the replay recording only begins when the first page loads. The replay is a reconstruction of the DOM using rrweb events.
The Live Debug URL is a URL that can be used to inspect the Session in real-time.
This allows for human-in-the-loop debugging, and can be used to debug the Session in real-time.
The Copy Debug URL
button is available in the Session Inspector only when the a live Session is running.
The Status Bar at the top of the Session Inspector displays the status of the Session, and the reason for termination if it has been terminated.
Here’s the information displayed in the Status Bar:
Property | Description |
---|---|
Session Id | The unique identifier of the Session |
Status | The status of the Session, and the reason for termination if it has been terminated |
Started | The date and time when the Session was started |
Region | The region where the Session was run |
Duration | The length of the Session |
Proxy Bandwidth | The amount of data transferred through the proxy on the network tab (in MB) |
Settings | The settings used for the Session (e.g. keepAlive or BrowserContext ) |
The Replay view makes it easy to inspect the actions performed (ex: select or click on an element) and network requests, page by page:
The replay controls allow you to:
The Events view displays the events and pages that occurred during the Session.
In the Events view, you’ll find:
Runtime.*
, Page.*
, Input.*
, and Log.*
events)The Stagehand tab is an inspection tool for sessions created with Stagehand.
To look deeper into each method call, you can click on a row to expand it.
This view allows you to evaluate:
On extract
calls, you can utilize the schema language dropdown to select the format you want to view the schema in. By default, the schema is displayed in JSON. However, you have the option to view the schema in Zod format. We’re working on adding more schema languages in the future.
The Logs tab features the raw Chrome DevTools Protocol logs. The raw logs are rich, spanning over 2 main families of events:
(DOM
), describing in detail any actions and updates performed during Session
Logs emitted by the Web Console API (ex: console.log()
), making debugging remote Sessions as easy as using your browser
Some example of console logs:
browser-solving-started
browser-solving-completed
browserbase-keeping-connection-alive
Starting recording
You’ll also be able to see other logs as expected from a browser, like [DOM] Updated style of [body]
or [Network] Request finished loading: GET "https://example.com/style.css"
Network events (Network
), describing in detail any network requests and responses performed during Session
The Timeline also features logs emitted by the Web Console API (ex: console.log()
),
making debugging remote Sessions as easy as using your browser.
Logs can also be retrieved using the Sessions API for automated processing.