Resolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors powered by ClickHouse and OpenTelemetry.
Find a file
dependabot[bot] 8682dbaabc
chore(deps): bump zod from 3.22.2 to 3.22.3 (#99)
Bumps [zod](https://github.com/colinhacks/zod) from 3.22.2 to 3.22.3.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a href="https://github.com/colinhacks/zod/releases">zod's releases</a>.</em></p>
<blockquote>
<h2>v3.22.3</h2>
<h2>Commits:</h2>
<ul>
<li>1e23990bcdd33d1e81b31e40e77a031fcfd87ce1 Commit</li>
<li>9bd3879b482f139fd03d5025813ee66a04195cdd docs: remove obsolete text about readonly types (<a href="https://redirect.github.com/colinhacks/zod/issues/2676">#2676</a>)</li>
<li>f59be093ec21430d9f32bbcb628d7e39116adf34 clarify datetime ISO 8601 (<a href="https://redirect.github.com/colinhacks/zod/issues/2673">#2673</a>)</li>
<li>64dcc8e2b16febe48fa8e3c82c47c92643e6c9e3 Update sponsors</li>
<li>18115a8f128680b4526df58ce96deab7dce93b93 Formatting</li>
<li>28c19273658b164c53c149785fa7a8187c428ad4 Update sponsors</li>
<li>ad2ee9ccf723c4388158ff6b8669c2a6cdc85643 2718 Updated Custom Schemas documentation example to use type narrowing (<a href="https://redirect.github.com/colinhacks/zod/issues/2778">#2778</a>)</li>
<li>ae0f7a2c15e7741ee1b23c03a3bfb9acebd86551 docs: update ref to discriminated-unions docs (<a href="https://redirect.github.com/colinhacks/zod/issues/2485">#2485</a>)</li>
<li>2ba00fe2377f4d53947a84b8cdb314a63bbd6dd4 [2609] fix ReDoS vulnerability in email regex (<a href="https://redirect.github.com/colinhacks/zod/issues/2824">#2824</a>)</li>
<li>1e61d76cdec05de9271fc0df58798ddf9ce94923 3.22.3</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a href="1e61d76cde"><code>1e61d76</code></a> 3.22.3</li>
<li><a href="2ba00fe237"><code>2ba00fe</code></a> [2609] fix ReDoS vulnerability in email regex (<a href="https://redirect.github.com/colinhacks/zod/issues/2824">#2824</a>)</li>
<li><a href="ae0f7a2c15"><code>ae0f7a2</code></a> docs: update ref to discriminated-unions docs (<a href="https://redirect.github.com/colinhacks/zod/issues/2485">#2485</a>)</li>
<li><a href="ad2ee9ccf7"><code>ad2ee9c</code></a> 2718 Updated Custom Schemas documentation example to use type narrowing (<a href="https://redirect.github.com/colinhacks/zod/issues/2778">#2778</a>)</li>
<li><a href="28c1927365"><code>28c1927</code></a> Update sponsors</li>
<li><a href="18115a8f12"><code>18115a8</code></a> Formatting</li>
<li><a href="64dcc8e2b1"><code>64dcc8e</code></a> Update sponsors</li>
<li><a href="f59be093ec"><code>f59be09</code></a> clarify datetime ISO 8601 (<a href="https://redirect.github.com/colinhacks/zod/issues/2673">#2673</a>)</li>
<li><a href="9bd3879b48"><code>9bd3879</code></a> docs: remove obsolete text about readonly types (<a href="https://redirect.github.com/colinhacks/zod/issues/2676">#2676</a>)</li>
<li><a href="1e23990bcd"><code>1e23990</code></a> Commit</li>
<li>See full diff in <a href="https://github.com/colinhacks/zod/compare/v3.22.2...v3.22.3">compare view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=zod&package-manager=npm_and_yarn&previous-version=3.22.2&new-version=3.22.3)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
You can disable automated security fix PRs for this repo from the [Security Alerts page](https://github.com/hyperdxio/hyperdx/network/alerts).

</details>
2023-11-13 23:35:45 +00:00
.changeset Refactor: Extract shared alert logic into a separate component (#97) 2023-11-12 06:20:08 +00:00
.github fix: vector installation script (#80) 2023-11-02 08:31:15 +00:00
.husky first commit 2023-09-12 20:08:05 -07:00
.vscode Chart alerts: add schemas and read path (#95) 2023-11-11 22:16:17 +00:00
.yarn/releases first commit 2023-09-12 20:08:05 -07:00
docker fix: control logs telemetry using HYPERDX_LOG_LEVEL (#78) 2023-11-01 06:37:14 +08:00
packages chore(deps): bump zod from 3.22.2 to 3.22.3 (#99) 2023-11-13 23:35:45 +00:00
.env chore: release v1.1.4 2023-11-01 07:02:22 +08:00
.gitattributes first commit 2023-09-12 20:08:05 -07:00
.gitignore feat: introduce usage-stats service 2023-09-15 17:22:53 -07:00
.kodiak.toml feat: support HYPERDX_LOG_LEVEL env var (#66) 2023-10-18 19:01:44 +00:00
.nvmrc first commit 2023-09-12 20:08:05 -07:00
.prettierignore first commit 2023-09-12 20:08:05 -07:00
.prettierrc first commit 2023-09-12 20:08:05 -07:00
.yarnrc first commit 2023-09-12 20:08:05 -07:00
CONTRIBUTING.md Contributing docs for Windows (#20) 2023-09-21 10:33:53 -07:00
docker-compose.ci.yml fix: boolean env var type issue (older compose version) (#72) 2023-10-21 00:36:56 +00:00
docker-compose.dev.yml fix: boolean env var type issue (older compose version) (#72) 2023-10-21 00:36:56 +00:00
docker-compose.yml fix: boolean env var type issue (older compose version) (#72) 2023-10-21 00:36:56 +00:00
LICENSE first commit 2023-09-12 20:08:05 -07:00
Makefile Release v1.1.2 (#46) 2023-09-25 21:45:10 -07:00
nx.json first commit 2023-09-12 20:08:05 -07:00
package.json chore: release v1.1.4 2023-11-01 07:02:22 +08:00
README.md feat: support HYPERDX_LOG_LEVEL env var (#66) 2023-10-18 19:01:44 +00:00
version.sh chore: release v1.1.4 2023-11-01 07:02:22 +08:00
yarn.lock chore(deps): bump zod from 3.22.2 to 3.22.3 (#99) 2023-11-13 23:35:45 +00:00

hyperdx logo


HyperDX

HyperDX helps engineers figure out why production is broken faster by centralizing and correlating logs, metrics, traces, exceptions and session replays in one place. An open source and developer-friendly alternative to Datadog and New Relic.

DocumentationChat on DiscordLive DemoBug ReportsContributing

  • 🕵️ Correlate end to end, go from browser session replay to logs and traces in just a few clicks
  • 🔥 Blazing fast performance powered by Clickhouse
  • 🔍 Intuitive full-text search and property search syntax (ex. level:err)
  • 🤖 Automatically cluster event patterns from billions of events
  • 📈 Dashboard high cardinality events without a complex query language
  • 🔔 Set up alerts in just a few clicks
  • { Automatic JSON/structured log parsing
  • 🔭 OpenTelemetry native

Search logs and traces all in one place

Additional Screenshots

📈 Dashboards Dashboard
🤖 Automatic Event Pattern Clustering Event Pattern Clustering
🖥️ Session Replay & RUM Event Pattern Clustering

Spinning Up HyperDX

The HyperDX stack ingests, stores, and searches/graphs your telemetry data. After standing up the Docker Compose stack, you'll want to instrument your app to send data over to HyperDX.

You can get started by deploying a complete stack via Docker Compose. After cloning this repository, simply start the stack with:

docker compose up -d

Afterwards, you can visit http://localhost:8080 to access the HyperDX UI.

If your server is behind a firewall, you'll need to open/forward port 8080, 8000 and 4318 on your firewall for the UI, API and OTel collector respectively.

We recommend at least 4GB of RAM and 2 cores for testing.

Enabling Self-instrumentation/Demo Logs

To get a quick preview of HyperDX, you can enable self-instrumentation and demo logs by setting the HYPERDX_API_KEY to your ingestion key (go to http://localhost:8080/team after creating your account) and then restart the stack.

This will redirect internal telemetry from the frontend app, API, host metrics and demo logs to your new HyperDX instance.

ex.

HYPERDX_API_KEY=<YOUR_INGESTION_KEY> docker compose up -d

If you need to use sudo for docker, make sure to forward the environment variable with the -E flag: HYPERDX_API_KEY=<YOUR_KEY> sudo -E docker compose up -d

Changing Hostname and Port

By default, HyperDX app/api will run on localhost with port 8080/8000. You can change this by updating HYPERDX_APP_** and HYPERDX_API_** variables in the .env file. After making your changes, rebuild images with make build-local.

Hosted Cloud

HyperDX is also available as a hosted cloud service at hyperdx.io. You can sign up for a free account and start sending data in minutes.

Instrumenting Your App

To get logs, metrics, traces, session replay, etc into HyperDX, you'll need to instrument your app to collect and send telemetry data over to your HyperDX instance.

We provide a set of SDKs and integration options to make it easier to get started with HyperDX, such as Browser, Node.js, and Python

You can find the full list in our docs.

OpenTelemetry

Additionally, HyperDX is compatible with OpenTelemetry, a vendor-neutral standard for instrumenting your application backed by CNCF. Supported languages/platforms include:

  • Kubernetes
  • Javascript
  • Python
  • Java
  • Go
  • Ruby
  • PHP
  • .NET
  • Elixir
  • Rust

(Full list here)

Once HyperDX is running, you can point your OpenTelemetry SDK to the OpenTelemetry collector spun up at http://localhost:4318.

Contributing

We welcome all contributions! There's many ways to contribute to the project, including but not limited to:

Motivation

Our mission is to help engineers ship reliable software. To enable that, we believe every engineer needs to be able to easily leverage production telemetry to quickly solve burning production issues.

However, in our experience, the existing tools we've used tend to fall short in a few ways:

  1. They're expensive, and the pricing has failed to scale with TBs of telemetry becoming the norm, leading to teams aggressively cutting the amount of data they can collect.
  2. They're hard to use, requiring full-time SREs to set up, and domain experts to use confidently.
  3. They requiring hopping from tool to tool (logs, session replay, APM, exceptions, etc.) to stitch together the clues yourself.

We're still early on in our journey, but are building in the open to solve these key issues in observability. We hope you give HyperDX a try and let us know how we're doing!

Open Source vs Hosted Cloud

HyperDX is open core, with most of our features available here under an MIT license. We have a cloud-hosted version available at hyperdx.io with a few additional features beyond what's offered in the open source version.

Our cloud hosted version exists so that we can build a sustainable business and continue building HyperDX as an open source platform. We hope to have more comprehensive documentation on how we balance between cloud-only and open source features in the future. In the meantime, we're highly aligned with Gitlab's stewardship model.

Frequently Asked Questions

How to suppress all logs from HyperDX itself ?

To suppress logs of a service, you can comment out the HYPERDX_API_KEY environment variable in the docker-compose.yml file. The alternative is to set the HYPERDX_LOG_LEVEL environment variable to 'error' to only log errors.

Contact

License

MIT