Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

add doc for openlit

patcher91bc56acc2e4d
diff --git a/docs/development/monitoring/openlit.mdx b/docs/development/monitoring/openlit.mdx
new file mode 100644
index 000000000..27f015ec8
--- /dev/null
+++ b/docs/development/monitoring/openlit.mdx
@@ -0,0 +1,130 @@
+---
+title: "OpenLIT"
+description: "Complete observability for Browser Use with OpenLIT tracing"
+icon: "chart-line"
+mode: "wide"
+---
+
+## Overview
+
+Browser Use has native integration with [OpenLIT](https://github.com/openlit/openlit) - an open-source opentelemetry-native platform that provides complete, granular traces for every task your browser-use agent performs—from high-level agent invocations down to individual browser actions.
+
+Read more about OpenLIT in the [OpenLIT docs](https://docs.openlit.io).
+
+## Setup
+
+Install OpenLIT alongside Browser Use:
+
+```bash
+pip install openlit browser-use
+```
+
+## Usage
+
+OpenLIT provides automatic, comprehensive instrumentation with **zero code changes** beyond initialization:
+
+```python {5-6}
+from browser_use import Agent, Browser, ChatOpenAI
+import asyncio
+import openlit
+
+# Initialize OpenLIT - that's it!
+openlit.init()
+
+async def main():
+ browser = Browser()
+
+ llm = ChatOpenAI(
+ model="gpt-4o",
+ )
+
+ agent = Agent(
+ task="Find the number trending post on Hacker news",
+ llm=llm,
+ browser=browser,
+ )
+
+ history = await agent.run()
+ return history
+
+if __name__ == "__main__":
+ history = asyncio.run(main())
+```
+
+## Viewing Traces
+
+OpenLIT provides a powerful dashboard where you can:
+
+### Monitor Execution Flows
+See the complete execution tree with timing information for every span. Click on any `invoke_model` span to see the exact prompt sent to the LLM and the complete response with agent reasoning.
+
+### Track Costs and Token Usage
+- Cost breakdown by agent, task, and model
+- Token usage per LLM call with full input/output visibility
+- Compare costs across different LLM providers
+- Identify expensive prompts and optimize them
+
+### Debug Failures with Agent Thoughts
+When an automation fails, you can:
+- See exactly which step failed
+- Read the agent's thinking at the failure point
+- Check the browser state and available elements
+- Analyze whether the failure was due to bad reasoning or bad information
+- Fix the root cause with full context
+
+### Performance Optimization
+- Identify slow steps (LLM calls vs browser actions vs HTTP requests)
+- Compare execution times across runs
+- Optimize max_steps and max_actions_per_step
+- Track HTTP request latency for page navigations
+
+## Configuration
+
+### Custom OpenTelemetry Endpoint Configuration
+
+```python
+import openlit
+
+# Configure custom OTLP endpoints
+openlit.init(
+ otlp_endpoint="http://localhost:4318",
+ application_name="my-browser-automation",
+ environment="production"
+)
+```
+
+### Environment Variables
+
+You can also configure OpenLIT via environment variables:
+
+```bash
+export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"
+export OTEL_SERVICE_NAME="browser-automation"
+export OTEL_ENVIRONMENT="production"
+```
+
+### Self-Hosted OpenLIT
+
+If you prefer to keep your data on-premises:
+
+```bash
+# Using Docker
+docker run -d \
+ -p 4318:4318 \
+ -p 3000:3000 \
+ openlit/openlit:latest
+
+# Access dashboard at http://localhost:3000
+```
+
+## Integration with Existing Tools
+
+OpenLIT uses OpenTelemetry under the hood, so it integrates seamlessly with:
+- **Jaeger** - Distributed tracing visualization
+- **Prometheus** - Metrics collection and alerting
+- **Grafana** - Custom dashboards and analytics
+- **Datadog** - APM and log management
+- **New Relic** - Full-stack observability
+- **Elastic APM** - Application performance monitoring
+
+Simply configure OpenLIT to export to your existing OTLP-compatible endpoint.