{"id":13469120,"url":"https://github.com/hyperdxio/hyperdx","last_synced_at":"2026-04-10T13:04:46.151Z","repository":{"id":194445268,"uuid":"690825026","full_name":"hyperdxio/hyperdx","owner":"hyperdxio","description":"Resolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors powered by Clickhouse and OpenTelemetry.","archived":false,"fork":false,"pushed_at":"2025-05-12T22:04:56.000Z","size":18052,"stargazers_count":7829,"open_issues_count":63,"forks_count":250,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-05-13T00:13:27.854Z","etag":null,"topics":["alerting","analytics","apm","application-monitoring","clickhouse","dashboard","frontend-monitoring","kubernetes","log-management","logs","metrics","monitoring","observability","opentelemetry","react","self-hosted","session-replay","traces","typescript"],"latest_commit_sha":null,"homepage":"https://hyperdx.io/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperdxio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-09-13T00:46:19.000Z","updated_at":"2025-05-12T22:45:34.000Z","dependencies_parsed_at":"2023-09-28T11:41:08.853Z","dependency_job_id":"2d9cf8d9-d22d-4af8-8fde-841af32f5fb1","html_url":"https://github.com/hyperdxio/hyperdx","commit_stats":{"total_commits":380,"total_committers":19,"mean_commits":20.0,"dds":0.6657894736842105,"last_synced_commit":"c5efb84c060095ef314febf3ace4c5830c705f35"},"previous_names":["hyperdxio/hyperdx"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperdxio%2Fhyperdx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperdxio%2Fhyperdx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperdxio%2Fhyperdx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperdxio%2Fhyperdx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperdxio","download_url":"https://codeload.github.com/hyperdxio/hyperdx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253843225,"owners_count":21972874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alerting","analytics","apm","application-monitoring","clickhouse","dashboard","frontend-monitoring","kubernetes","log-management","logs","metrics","monitoring","observability","opentelemetry","react","self-hosted","session-replay","traces","typescript"],"created_at":"2024-07-31T15:01:27.157Z","updated_at":"2026-01-24T01:21:21.992Z","avatar_url":"https://github.com/hyperdxio.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hyperdx.io\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./.github/images/logo_dark.png#gh-dark-mode-only\"\u003e\n      \u003cimg alt=\"hyperdx logo\" src=\"./.github/images/logo_light.png#gh-light-mode-only\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n# HyperDX\n\n[HyperDX](https://hyperdx.io), a core component of\n[ClickStack](https://clickhouse.com/use-cases/observability), helps engineers\nquickly figure out why production is broken by making it easy to search \u0026\nvisualize logs and traces on top of any ClickHouse cluster (imagine Kibana, for\nClickHouse).\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://clickhouse.com/docs/use-cases/observability/clickstack/overview\"\u003eDocumentation\u003c/a\u003e • \u003ca href=\"https://hyperdx.io/discord\"\u003eChat on Discord\u003c/a\u003e  • \u003ca href=\"https://play.hyperdx.io/search\"\u003eLive Demo\u003c/a\u003e  • \u003ca href=\"https://github.com/hyperdxio/hyperdx/issues/new\"\u003eBug Reports\u003c/a\u003e • \u003ca href=\"./CONTRIBUTING.md\"\u003eContributing\u003c/a\u003e • \u003ca href=\"https://clickhouse.com/use-cases/observability\"\u003eWebsite\u003c/a\u003e\n\u003c/p\u003e\n\n- 🕵️ Correlate/search logs, metrics, session replays and traces all in one place\n- 📝 Schema agnostic, works on top of your existing ClickHouse schema\n- 🔥 Blazing fast searches \u0026 visualizations optimized for ClickHouse\n- 🔍 Intuitive full-text search and property search syntax (ex. `level:err`),\n  SQL optional!\n- 📊 Analyze trends in anomalies with event deltas\n- 🔔 Set up alerts in just a few clicks\n- 📈 Dashboard high cardinality events without a complex query language\n- `{` Native JSON string querying\n- ⚡ Live tail logs and traces to always get the freshest events\n- 🔭 OpenTelemetry supported out of the box\n- ⏱️ Monitor health and performance from HTTP requests to DB queries (APM)\n\n\u003cbr/\u003e\n\u003cimg alt=\"Search logs and traces all in one place\" src=\"./.github/images/search_splash.png\" title=\"Search logs and traces all in one place\"\u003e\n\n## Spinning Up HyperDX\n\nHyperDX can be deployed as part of ClickStack, which includes ClickHouse,\nHyperDX, OpenTelemetry Collector and MongoDB.\n\n```bash\ndocker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one\n```\n\nAfterwards, you can visit http://localhost:8080 to access the HyperDX UI.\n\nIf you already have an existing ClickHouse instance, want to use a single\ncontainer locally, or are looking for production deployment instructions, you\ncan view the different deployment options in our\n[deployment docs](https://clickhouse.com/docs/use-cases/observability/clickstack/deployment).\n\n\u003e If your server is behind a firewall, you'll need to open/forward port 8080,\n\u003e 8000 and 4318 on your firewall for the UI, API and OTel collector\n\u003e respectively.\n\n\u003e We recommend at least 4GB of RAM and 2 cores for testing.\n\n### Hosted ClickHouse Cloud\n\nYou can also deploy HyperDX with ClickHouse Cloud, you can\n[sign up for free](https://console.clickhouse.cloud/signUp) and get started in\njust minutes.\n\n## Instrumenting Your App\n\nTo get logs, metrics, traces, session replay, etc into HyperDX, you'll need to\ninstrument your app to collect and send telemetry data over to your HyperDX\ninstance.\n\nWe provide a set of SDKs and integration options to make it easier to get\nstarted with HyperDX, such as\n[Browser](https://clickhouse.com/docs/use-cases/observability/clickstack/sdks/browser),\n[Node.js](https://clickhouse.com/docs/use-cases/observability/clickstack/sdks/nodejs),\nand\n[Python](https://clickhouse.com/docs/use-cases/observability/clickstack/sdks/python)\n\nYou can find the full list in\n[our docs](https://clickhouse.com/docs/use-cases/observability/clickstack).\n\n**OpenTelemetry**\n\nAdditionally, HyperDX is compatible with\n[OpenTelemetry](https://opentelemetry.io/), a vendor-neutral standard for\ninstrumenting your application backed by CNCF. Supported languages/platforms\ninclude:\n\n- Kubernetes\n- Javascript\n- Python\n- Java\n- Go\n- Ruby\n- PHP\n- .NET\n- Elixir\n- Rust\n\n(Full list [here](https://opentelemetry.io/docs/instrumentation/))\n\nOnce HyperDX is running, you can point your OpenTelemetry SDK to the\nOpenTelemetry collector spun up at `http://localhost:4318`.\n\n## Contributing\n\nWe welcome all contributions! There's many ways to contribute to the project,\nincluding but not limited to:\n\n- Opening a PR ([Contribution Guide](./CONTRIBUTING.md))\n- [Submitting feature requests or bugs](https://github.com/hyperdxio/hyperdx/issues/new)\n- Improving our product or contribution documentation\n- Voting on [open issues](https://github.com/hyperdxio/hyperdx/issues) or\n  contributing use cases to a feature request\n\n## Motivation\n\nOur mission is to help engineers ship reliable software. To enable that, we\nbelieve every engineer needs to be able to easily leverage production telemetry\nto quickly solve burning production issues.\n\nHowever, in our experience, the existing tools we've used tend to fall short in\na few ways:\n\n1. They're expensive, and the pricing has failed to scale with TBs of telemetry\n   becoming the norm, leading to teams aggressively cutting the amount of data\n   they can collect.\n2. They're hard to use, requiring full-time SREs to set up, and domain experts\n   to use confidently.\n3. They requiring hopping from tool to tool (logs, session replay, APM,\n   exceptions, etc.) to stitch together the clues yourself.\n\nWe hope you give HyperDX in ClickStack a try and let us know how we're doing!\n\n## Contact\n\n- [Open an Issue](https://github.com/hyperdxio/hyperdx/issues/new)\n- [Discord](https://discord.gg/FErRRKU78j)\n- [Email](mailto:support@hyperdx.io)\n\n## HyperDX Usage Data\n\nHyperDX collects anonymized usage data for open source deployments. This data\nsupports our mission for observability to be available to any team and helps\nsupport our open source product run in a variety of different environments.\nWhile we hope you will continue to support our mission in this way, you may opt\nout of usage data collection by setting the `USAGE_STATS_ENABLED` environment\nvariable to `false`. Thank you for supporting the development of HyperDX!\n\n## License\n\n[MIT](/LICENSE)\n","funding_links":[],"categories":["TypeScript","analytics","Monitor","Error Monitoring","📈 Monitoramento e Observabilidade","Platforms services and devops","Integrations"],"sub_categories":["Ferramentas Open Source de Monitoramento","Monitoring/Observability (Datadog alternatives)","Metrics and Monitoring"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperdxio%2Fhyperdx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperdxio%2Fhyperdx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperdxio%2Fhyperdx/lists"}