Highlight.io
The open-source, full-stack monitoring platform: error monitoring, session replay, and logging.
Why consider Highlight.io?
Highlight.io is an open-source web application monitoring platform. It combines full-stack error tracking, session replays, and backend log streaming into a single developer suite.
Learn Highlight.io by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
In this guide11 sections
What is Highlight.io?
Highlight.io is an open-source, full-stack application monitoring platform built with Go, React, OpenTelemetry, and ClickHouse. It operates as a modern open-source alternative to commercial developer tooling suites like Sentry, LogRocket, and Datadog.
Highlight.io bridges the gap between frontend user sessions and backend infrastructure: it connects frontend session replays directly to backend error stack traces and distributed server logs, allowing developers to see exactly what a user experienced in the browser right alongside the corresponding backend exceptions and database query logs.
Who Is It For?
- Full-Stack Engineering Teams: Investigating end-to-end user issues spanning React/Next.js frontends and Python/Node/Go backends.
- QA & Reliability Engineers: Triaging uncaught JavaScript exceptions with exact user reproduction recordings and sourcemap stack traces.
- Security-Conscious Organizations: Deploying complete session replay and error monitoring entirely on self-hosted infrastructure.
Key Features
- Full-stack correlation: Link frontend session replays directly with backend server errors and OpenTelemetry traces.
- Real-time error monitoring: Group errors by root cause, inspect demangled stack traces via sourcemaps, and track regression states.
- High-performance log management: Search, filter, and stream backend logs powered by ClickHouse storage.
- Native SDK support for Next.js, React, Vue, Python, Node.js, Go, Ruby, and Java.
- Automated PII masking: Redact sensitive customer fields, credit card inputs, and custom CSS classes.
Deploying Highlight.io with Docker Compose
# 1. Clone the official self-hosted repositorygit clone --recurse-submodules https://github.com/highlight/highlight.gitcd highlight/docker# 2. Run the deployment setup script./run.shAccess the dashboard at http://localhost:3000 to register an account and generate your project tracking tokens.
Integrating Highlight in Next.js
npm install @highlight-run/nextConfigure Highlight in your app/layout.tsx or pages/_app.tsx:
import { HighlightInit } from '@highlight-run/next/client';export default function RootLayout({ children }: { children: React.ReactNode }) { return ( <html lang="en"> <HighlightInit projectId={'YOUR_PROJECT_ID'} serviceName={'my-nextjs-app'} tracingOrigins={['localhost', 'api.example.com']} networkRecording={{ enabled: true, recordHeadersAndBody: true, }} /> <body>{children}</body> </html> );}Practical Use Cases
1. Unified Frontend-to-Backend Debugging
A customer encounters an error during checkout; the developer watches the recorded user click, clicks "View Error", and immediately sees the exact Python exception and database error logged in the backend.
2. Sourcemap-Decoded Stack Traces
A minified production JavaScript crash occurs; Highlight automatically matches uploaded sourcemaps, pinpointing the exact line in TypeScript source files.
3. High-Volume Serverless Log Ingestion
A cloud backend emits millions of structured JSON log lines; Highlight indexes them into ClickHouse for rapid full-text filtering.
Troubleshooting and Limitations
- Sourcemap Upload Security: Automate sourcemap uploads during CI/CD using the official Highlight CLI (
npx @highlight-run/sourcemap-uploader) with private API keys. - ClickHouse Storage Disk Capacity: For high-volume log streams, configure data retention policies under Settings -> Retention to purge telemetry older than 30–60 days.
Official Resources
- Official Website: https://www.highlight.io
- GitHub Repository: https://github.com/highlight/highlight
- Documentation: https://www.highlight.io/docs
Related tools
More options with a similar category or technology profile.
diskus
Minimal, fast alternative to du -sh written in Rust using multi-threaded directory traversal.
peco
Simplistic interactive filtering tool for Unix pipelines, process lists, and file trees.
Dapr CLI
Command-line tool for managing Dapr distributed application runtime environments and sidecars.
Freeze
Generate beautiful image screenshots and SVGs of code snippets and terminal outputs.