HyperDX is an open source observability platform designed to help engineers quickly diagnose and resolve production issues by unifying logs, traces, metrics, and session replays into a single interface. Built on top of ClickHouse and OpenTelemetry, it eliminates the need to hop between multiple tools by providing a cohesive, schema-agnostic view of telemetry data. Unlike traditional APM solutions that are expensive and complex, HyperDX offers a self-hosted, cost-effective alternative optimized for high-cardinality data and real-time analysis. It’s ideal for DevOps teams, SREs, and full-stack developers who need deep visibility into their systems without relying on proprietary cloud services or complex query languages.
HyperDX integrates seamlessly with existing infrastructure, supporting any ClickHouse cluster and OpenTelemetry-compliant instrumentation. Its intuitive search syntax (e.g., level:err) and live tailing capabilities make it accessible to engineers without deep SQL expertise, while still enabling powerful analytics for advanced users. With native support for session replay and APM metrics from HTTP requests to database queries, HyperDX provides end-to-end visibility into application performance and user behavior.
What You Get
- Unified observability - Correlate logs, traces, metrics, and session replays in a single interface to reduce context switching and accelerate root cause analysis.
- Schema-agnostic logs & traces - Works with your existing ClickHouse schema without requiring data transformation or re-ingestion.
- Blazing-fast search - Optimized for ClickHouse to deliver sub-second results on high-cardinality datasets, even with TBs of telemetry data.
- Intuitive search syntax - Use simple property-based queries like
level:err or url:/api/users without writing SQL, while still supporting full SQL when needed.
- Live log and trace tailing - Stream real-time events as they occur to monitor active issues without refreshing.
- Session replay integration - View user interactions alongside correlated logs and traces to understand frontend issues from the end-user perspective.
- OpenTelemetry native support - Ingest telemetry data from any OpenTelemetry-compatible SDK (JavaScript, Python, Go, Java, .NET, etc.) via the built-in OTel collector on port 4318.
- Built-in alerting - Set up alerts in a few clicks based on log patterns, error rates, or performance thresholds without external tools.
- High-cardinality dashboards - Visualize trends and anomalies in event data without pre-aggregation or complex query engineering.
- Native JSON querying - Query nested JSON fields directly in logs without flattening or schema enforcement.
- Self-hosted and cost-effective - Run on your own infrastructure with minimal overhead, avoiding vendor lock-in or expensive SaaS pricing models.
Common Use Cases
- Building a multi-tenant SaaS dashboard with real-time analytics - Engineers use HyperDX to correlate user session replays with backend logs and traces across tenants, identifying performance bottlenecks in specific customer environments without costly data sampling.
- Creating a mobile-first e-commerce platform with 10k+ SKUs - Teams leverage HyperDX to monitor high-volume HTTP requests, track cart abandonment events via session replay, and trace slow database queries tied to product catalog loads.
- Problem → Solution flow: Slow API responses across microservices - Engineers notice increased latency in user reports. They use HyperDX to search for
latency:>500ms across logs and traces, then drill into specific trace IDs to find which service or DB query is causing the delay — all in one interface.
- DevOps teams managing microservices across multiple cloud providers - HyperDX’s OpenTelemetry integration allows consistent instrumentation across AWS, GCP, and Azure services. Teams deploy a single HyperDX instance to ingest logs and traces from all environments, reducing tool sprawl and standardizing incident response.
Under The Hood
HyperDX is a modern observability platform designed to unify logging, metrics, and tracing through OpenTelemetry integration, offering developers a comprehensive analytics backend. It is built as a monorepo with modular packages that support both frontend and backend functionality, emphasizing scalability and maintainability.
Architecture
HyperDX adopts a structured monorepo approach with well-defined workspaces and layered design principles.
- The system is organized into distinct packages such as @hyperdx/api, @hyperdx/app, and @hyperdx/common-utils, each with clearly defined responsibilities
- It implements layered architecture separating data models, controllers, middleware, and external integrations like ClickHouse and OpenTelemetry
- Component communication is standardized through API routes, authentication middleware, and shared utility libraries to ensure reuse and consistency
- The platform blends traditional RESTful APIs with modern observability practices, supporting OTLP ingestion and OpenTelemetry ecosystem integration
Tech Stack
Built with TypeScript, HyperDX leverages modern web and backend frameworks to deliver a robust full-stack experience.
- The frontend is powered by Next.js and Mantine UI components, while the backend utilizes Express.js for API services
- Key tools include Nx for monorepo management, Yarn for package handling, and Docker for containerization
- The stack integrates Mongoose for MongoDB operations, React Query for state management, and TanStack Table for data visualization
- Testing is supported through Jest, Playwright, and Supertest, complemented by ESLint and Prettier for code quality assurance
Code Quality
HyperDX demonstrates a balanced level of code quality with strong test coverage and consistent practices, although some variation exists across modules.
- A comprehensive testing strategy includes unit, integration, and end-to-end tests with extensive coverage across components and APIs
- Error handling follows standard patterns using try/catch blocks and centralized logging for improved debugging and resilience
- Code linting and formatting are enforced through tooling, ensuring a consistent style across the codebase
- While most modules follow established conventions, some variation in structure and naming persists across different workspaces
What Makes It Unique
HyperDX distinguishes itself through its agent-based architecture and seamless integration with OpenTelemetry, offering a unified observability solution.
- It uniquely combines OTLP ingestion with a powerful analytics backend, enabling developers to manage logs, metrics, and traces in one platform
- The system’s agent-based architecture allows for flexible deployment options and real-time telemetry collection from diverse environments
- Its integration with the OpenTelemetry ecosystem provides extensibility and alignment with industry standards for observability
- The platform’s modular design and component-driven UI make it highly adaptable for developers seeking scalable observability tools