> ## Documentation Index
> Fetch the complete documentation index at: https://tracevell.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Puppeteer observability

> Record Puppeteer browser sessions in JavaScript and read them synced to the surrounding agent trace in Tracevell.

[Puppeteer](https://pptr.dev/) is a framework for browser automation. It is natively supported in JavaScript and TypeScript.

> [!NOTE]
>
> Tracevell excels at tracing browser agents by providing unified visibility into both browser session recordings and agent execution steps.

## Puppeteer integration

Tracevell has a native integration with Puppeteer for JavaScript. You simply need to initialize Tracevell with your project API key and Puppeteer will be traced automatically.
We will hook into the API to create OpenTelemetry spans, but more importantly, we record browser session recordings.

```javascript {1, 4-9} theme={null}
import { Tracevell } from '@lmnr-ai/lmnr';
import puppeteer from 'puppeteer'; // or 'puppeteer-core'

Laminar.initialize({
  projectApiKey: process.env.LMNR_PROJECT_API_KEY,
  instrumentModules: {
    puppeteer: puppeteer
  }
});

// The rest of your puppeteer code
```

## Related integrations

> [card] [Playwright](https://tracevell.com/docs/integrations/playwright.md)
>
> Record Playwright browser sessions alongside your traces.

> [card] [Browser Use](https://tracevell.com/docs/integrations/browser-use.md)
>
> Trace Browser Use agents with synced session recordings.

> [card] [Stagehand](https://tracevell.com/docs/integrations/stagehand.md)
>
> Trace Stagehand runs with synced session recordings.

> [card] [Skyvern](https://tracevell.com/docs/integrations/skyvern.md)
>
> Trace Skyvern workflows with synced session recordings.

> [card] [Kernel](https://tracevell.com/docs/integrations/kernel.md)
>
> Trace computer-using agents running on Kernel browsers.

> [card] [All integrations](https://tracevell.com/docs/integrations.md)
>
> Browse every provider, framework, coding agent, and browser integration Tracevell supports.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.