OpenReplay

🚀 Features

• (Segments) Added Segments, to define and reuse events and filters across sessions search and analytics
• (Replay) Introducing Features, tag any UI element directly from a replay and use it to search sessions and build analytics
• (Analytics) New Breakdown option in cards, for grouping results by any set of filters

💪 Improvements

• (Tracker) Better handling of iFrame children, ordering and cross-domain communications
• (Tracker) Added default data sanitization on URLs using a predefined set of keys
• (OmniSearch) Exposed a select list of filters (userId, metadata) as URL params
• (OmniSearch) New filters for screen_width and screen_height
• (API) Migrated the public API from python to golang for better performance and maintainability
• (Backend) Major msg protocol (mob) and pipeline overhaul for reduced memory consumption, faster file sync and higher overall throughput
• (Backend) Reworked canvas and mobile pipelines with a custom binary container and decoupled services/endpoints for better scalability and lower IOPS
• (Frontend) Ability to rotate the Org API Key in Preferences
• (Frontend) Tenant ownership can now be transferred in Preferences
• (DevOps) Added health check endpoints to all backend services
• (DevOps)(EE) Support for air-gapped environments
• Minor UI/UX tweaks
• Security enhancements

🐞 Bugs

• Fixed dead tokens in analytics SDK to prevent sending on hidden pages
• Various in tracker for libraries that use emotion-js
• Fixed autocomplete for filters where properties are duplicated
• Fixed shortcuts overlapping in replayer on windows
• Fixed click listener in iOS SDK
• Fixed tap animation for mobile touch events
• Fixed role deletion in Preferences
• Fixed react-router transitions in Frontend
• Fixed search for co-browsing sessions
• Fixed role deletion in Preferences
• Fixed reset of event properties on project change
• Fixed iOS click listener in tracker connector
• Fixed co-browsing disconnection on page reload
• Fixed webanimation logic in tracker
• Stripped cookies at nginx before proxying to prevent HTTP 431 with large cookies
• Fixed ClickHouse port semantics for webPort and dataPort
• Fixed minio fsgroup permission check
• Getting iOS Critical crashes on production (#4502)
• Page number increments by itself after viewing sessions (#4478)
• Uncaught TypeError: Failed to execute 'getComputedStyle' on 'Window' in webAnimations module (#4476)
• Nginx 404 file not found error (#4462)
• New React-Native architecture TurboModules support (#4447)
• Issue with accepting the invite or reset password (#4381)
• Filtering fails (#4371)

🙏 Special thanks

• [@ssimmons806](https://github.com/ssimmons806): Add health check to default nginx server ([#4477](https://github.com/openreplay/openreplay/pull/4477))
• [@michaelorr](https://github.com/michaelorr): Add 7-day TTL to ClickHouse system log tables ([#4471](https://github.com/openreplay/openreplay/pull/4471))
• [@sooth](https://github.com/sooth): Add PostgreSQL healthcheck and startup ordering for Go services in docker-compose ([#4439](https://github.com/openreplay/openreplay/pull/4439))
• [@michaelorr](https://github.com/michaelorr): Finish correction of ClickHouse port semantics ([#4430](https://github.com/openreplay/openreplay/pull/4430))

<p align="center">

<a href="/README_FR.md">Français</a>

&nbsp;|&nbsp;

<a href="/README_ESP.md">Español</a>

&nbsp;|&nbsp;

<a href="/README_RU.md">Русский</a>

&nbsp;|&nbsp;

<a href="/README_AR.md">العربية</a>

</p>

<p align="center">

<a href="https://openreplay.com/#gh-light-mode-only">

<img src="static/openreplay-git-banner-light.png" width="100%">

</a>

<a href="https://openreplay.com/#gh-dark-mode-only">

<img src="static/openreplay-git-banner-dark.png" width="100%">

</a>

</p>

<h3 align="center">Session replay for developers</h3>

<p align="center">The most advanced session replay for building delightful web apps.</p>

<p align="center">

<a href="https://docs.openreplay.com/deployment/deploy-aws">

<img src="static/btn-deploy-aws.svg" height="40"/>

</a>

<a href="https://docs.openreplay.com/deployment/deploy-gcp">

<img src="static/btn-deploy-google-cloud.svg" height="40" />

</a>

<a href="https://docs.openreplay.com/deployment/deploy-azure">

<img src="static/btn-deploy-azure.svg" height="40" />

</a>

<a href="https://docs.openreplay.com/deployment/deploy-digitalocean">

<img src="static/btn-deploy-digital-ocean.svg" height="40" />

</a>

</p>

<p align="center">

<a href="https://github.com/openreplay/openreplay">

<img src="static/openreplay-git-hero.svg">

</a>

</p>

OpenReplay is an open-source session replay suite you can host yourself, that lets you see what users do on your web app, helping you troubleshoot issues faster.

• Session replay. OpenReplay replays what users do, but not only. It also shows you what went under the hood, how your website or app behaves by capturing network activity, console logs, JS errors, store actions/state, page speed metrics, cpu/memory usage and much more.
• Low footprint. With a ~26KB (.br) tracker that asynchronously sends minimal data for a very limited impact on performance.
• Self-hosted. No more security compliance checks, 3rd-parties processing user data. Everything OpenReplay captures stays in your cloud for a complete control over your data.
• Privacy controls. Fine-grained security features for sanitizing user data.
• Easy deploy. With support of major public cloud providers (AWS, GCP, Azure, DigitalOcean).

Features

• Session replay: Lets you relive your users' experience, see where they struggle and how it affects their behavior. Each session replay is automatically analyzed based on heuristics, for easy triage.
• Spot: A Chrome extension that lets record bugs directly from your browser — each recording includes all the technical details developers need to fix them.
• DevTools: It's like debugging in your own browser. OpenReplay provides you with the full context (network activity, JS errors, store actions/state and 40+ metrics) so you can instantly reproduce bugs and understand performance issues.
• Assist: Helps you support your users by seeing their live screen and instantly hopping on call (WebRTC) with them without requiring any 3rd-party screen sharing software.
• Omni-search: Search and filter by almost any user action/criteria, session attribute or technical event, so you can answer any question. No instrumentation required.
• Analytics: For surfacing the most impactful issues causing conversion and revenue loss.
• Fine-grained privacy controls: Choose what to capture, what to obscure or what to ignore so user data doesn't even reach your servers.
• Plugins oriented: Get to the root cause even faster by tracking application state (Redux, VueX, MobX, NgRx, Pinia and Zustand) and logging GraphQL queries (Apollo, Relay) and Fetch/Axios requests.
• Integrations: Sync your backend logs with your session replays and see what happened front-to-back. OpenReplay supports Sentry, Datadog, CloudWatch, Stackdriver, Elastic and more.

Deployment Options

OpenReplay can be deployed anywhere. Follow our step-by-step guides for deploying it on major public clouds:

• AWS
• Google Cloud
• Azure
• Digital Ocean
• Scaleway
• OVHcloud
• Kubernetes

OpenReplay Cloud

For those who want to simply use OpenReplay as a service, sign up for a free account on our cloud offering.

Community Support

Please refer to the official OpenReplay documentation. That should help you troubleshoot common issues. For additional help, you can reach out to us on one of these channels:

• Slack (Connect with our engineers and community)
• GitHub (Bug and issue reports)
• Twitter (Product updates, Great content)
• YouTube (How-to tutorials, past Community Calls)
• Website chat (Talk to us)

Contributing

We're always on the lookout for contributions to OpenReplay, and we're glad you're considering it! Not sure where to start? Look for open issues, preferably those marked as good first issues.

See our Contributing Guide for more details.

Also, feel free to join our Slack to ask questions, discuss ideas or connect with our contributors.

License

This monorepo uses several licenses. See LICENSE for more details.