diff --git a/.changeset/adhoc-filter-finishing-touches.md b/.changeset/adhoc-filter-finishing-touches.md deleted file mode 100644 index 40a34fe57..000000000 --- a/.changeset/adhoc-filter-finishing-touches.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -'@hyperdx/common-utils': patch -'@hyperdx/app': patch -'@hyperdx/api': patch ---- - -feat: Ad hoc dashboard filter finishing touches - -- Add an `IN` operator. `IN` conditions on the same key are OR'd into one - `IN (...)` condition for SQL, or one `=~"a|b"` matcher for PromQL. -- Ad hoc filters always broadcast (`isBroadcastEnabled: true`), and their - variable name is only a unique identifier. It is no longer declared as a - `$variable`. -- Warn when another ad hoc filter already applies to the same sources. -- Collapse the filter input to three conditions behind a "+N more" toggle. diff --git a/.changeset/adhoc-filters-external-api.md b/.changeset/adhoc-filters-external-api.md deleted file mode 100644 index 9edb98ee5..000000000 --- a/.changeset/adhoc-filters-external-api.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -'@hyperdx/api': minor ---- - -feat: Create, read, and update ad hoc dashboard filters through the external API - -`/api/v2/dashboards` now accepts and returns `ADHOC` filters, with SQL and -PromQL source types, and their `adhoc` entries in `savedFilterValues`. Each -filter's sources must exist and be a kind its `sourceType` supports. MCP still -hides ad hoc filters. diff --git a/.changeset/adhoc-filters-mcp.md b/.changeset/adhoc-filters-mcp.md deleted file mode 100644 index ef20b14cb..000000000 --- a/.changeset/adhoc-filters-mcp.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -'@hyperdx/api': minor ---- - -feat(mcp): Create, read, and update ad hoc dashboard filters through the MCP dashboard tools - -`clickstack_save_dashboard`, `clickstack_get_dashboard`, and -`clickstack_patch_dashboard` now handle `ADHOC` filters and their `adhoc` -saved conditions. PromQL ad hoc filters are offered only while PromQL is -enabled, and are hidden and kept on update otherwise. Saved conditions that -name no ad hoc filter, or use an operator their filter can't apply, produce a -warning. diff --git a/.changeset/alert-history-map-per-alert.md b/.changeset/alert-history-map-per-alert.md deleted file mode 100644 index e6f6e424d..000000000 --- a/.changeset/alert-history-map-per-alert.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -perf: check-alerts gives each alert only its own previous history, so a tick -no longer scans every alert's group history once per alert diff --git a/.changeset/api-uuid-11.md b/.changeset/api-uuid-11.md deleted file mode 100644 index e03e55d76..000000000 --- a/.changeset/api-uuid-11.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -chore: bump `uuid` to 11.1.1 (fixes GHSA-w5hq-g745-h8pq) and drop `@types/uuid` diff --git a/.changeset/compact-pattern-predicate.md b/.changeset/compact-pattern-predicate.md deleted file mode 100644 index f5ded73f6..000000000 --- a/.changeset/compact-pattern-predicate.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@hyperdx/common-utils': minor ---- - -feat: add `buildCompactPatternPredicate` - -It builds the same match as `buildPatternPredicate` in much shorter SQL, for -pattern filters that are kept in a URL. `parsePatternPredicate` reads both -forms. diff --git a/.changeset/log-body-search-fallback.md b/.changeset/log-body-search-fallback.md deleted file mode 100644 index 10397cf1b..000000000 --- a/.changeset/log-body-search-fallback.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -Use the log source body expression for bare-text MCP searches, pattern filters, -event deltas, and alert alias queries when no implicit search column is set. diff --git a/.changeset/mcp-install-name.md b/.changeset/mcp-install-name.md deleted file mode 100644 index 97c11c4be..000000000 --- a/.changeset/mcp-install-name.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -'@hyperdx/cli': patch ---- - -feat(cli): `hdx mcp install` can keep several ClickStack servers side by side - -`--name ` adds the MCP server under a name you choose, so a second -ClickStack instance no longer overwrites the first. When the key belongs to more -than one team, the installer asks which teams to add a server for and adds one -entry per team. When it finds more than one agent it asks which to set up. diff --git a/.changeset/mcp-save-alert-note-windows.md b/.changeset/mcp-save-alert-note-windows.md deleted file mode 100644 index 0888a1fd7..000000000 --- a/.changeset/mcp-save-alert-note-windows.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@hyperdx/common-utils': patch -'@hyperdx/api': patch ---- - -feat: `clickstack_save_alert` accepts `note` and `numConsecutiveWindows` - -Updates that omit either field now keep the stored value instead of clearing it; -send `null` to clear. diff --git a/.changeset/mcp-shared-pattern-predicate.md b/.changeset/mcp-shared-pattern-predicate.md deleted file mode 100644 index 4905bd3ff..000000000 --- a/.changeset/mcp-shared-pattern-predicate.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -refactor: the MCP `clickstack_event_patterns` tool builds its drill-down -`whereSnippet` with the shared pattern predicate from `@hyperdx/common-utils` -instead of its own copy. The snippet is unchanged. diff --git a/.changeset/mcp-shorten-trace-ops-tool-name.md b/.changeset/mcp-shorten-trace-ops-tool-name.md deleted file mode 100644 index 12153bc44..000000000 --- a/.changeset/mcp-shorten-trace-ops-tool-name.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -fix(mcp): Rename `clickstack_trace_top_time_consuming_operations` to `clickstack_trace_top_time_consuming_ops` - -The old name was the longest MCP tool name and exceeded the tool-name length -limit some MCP clients enforce. Clients that call the tool by its old name -need to switch to the new one. diff --git a/.changeset/mobile-nav-small-viewport.md b/.changeset/mobile-nav-small-viewport.md deleted file mode 100644 index 1a87e039b..000000000 --- a/.changeset/mobile-nav-small-viewport.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -fix: keep the team switcher and user preferences reachable in the mobile app -nav. The app shell and nav were sized with `100vh`, which on mobile browsers -includes the area behind the retractable toolbar, so the bottom of the nav sat -off screen with no way to scroll to it. They now size to the small viewport. diff --git a/.changeset/org-api-keys-empty-state-width.md b/.changeset/org-api-keys-empty-state-width.md deleted file mode 100644 index 32f533961..000000000 --- a/.changeset/org-api-keys-empty-state-width.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -fix: make the "No organization API keys yet" empty state span the full width of -the team settings section. diff --git a/.changeset/pattern-filter-actions.md b/.changeset/pattern-filter-actions.md deleted file mode 100644 index d2a5e3a51..000000000 --- a/.changeset/pattern-filter-actions.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -'@hyperdx/app': minor ---- - -feat: filter for or exclude a pattern from Event Patterns - -Each row in Event Patterns now has "Filter for this pattern" and "Exclude this -pattern" buttons on hover. Each adds a filter for every event that fits the -pattern in the time range, not only the sampled rows, so the results table, -histogram and counts all update. Exclusions stack, show as pills next to the -other filters, survive sidebar filter changes, and are kept in the URL and in -saved searches. A new include replaces the previous one, and switching source -removes pattern filters. diff --git a/.changeset/shared-pattern-predicate.md b/.changeset/shared-pattern-predicate.md deleted file mode 100644 index 99784c662..000000000 --- a/.changeset/shared-pattern-predicate.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -'@hyperdx/common-utils': minor ---- - -feat: share the Event Patterns drill-down predicate - -`templateToRegex` and `buildPatternPredicate`, which the MCP server uses to -build the `clickstack_event_patterns` drill-down filter, are now in -`@hyperdx/common-utils/dist/drain`. New options match templates mined with extra -delimiters (`extraDelimiters`) or by Python Drain3 (`whitespace: 'python'`), and -`parsePatternPredicate` reads a predicate back into its value expression and -template. Without options the output is the same as the MCP server's. diff --git a/.changeset/source-row-key-expression.md b/.changeset/source-row-key-expression.md deleted file mode 100644 index 66c39403d..000000000 --- a/.changeset/source-row-key-expression.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@hyperdx/common-utils': minor -'@hyperdx/api': minor -'@hyperdx/app': minor ---- - -feat: add an optional "Row key expression" to log and trace sources. When set, -the side panel's row lookup selects and filters on only those columns instead of -detecting keys from table metadata. diff --git a/.changeset/source-select-select-all-on-focus.md b/.changeset/source-select-select-all-on-focus.md deleted file mode 100644 index ef5c4aca4..000000000 --- a/.changeset/source-select-select-all-on-focus.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -fix: clicking the source selector selects its current label so typing replaces -it instead of inserting into the middle of the old name diff --git a/.changeset/source-vars-1.md b/.changeset/source-vars-1.md deleted file mode 100644 index eeacef4d1..000000000 --- a/.changeset/source-vars-1.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -'@hyperdx/common-utils': minor -'@hyperdx/api': minor -'@hyperdx/app': patch ---- - -feat: add data source and connection variable types to dashboards diff --git a/.changeset/source-vars-2.md b/.changeset/source-vars-2.md deleted file mode 100644 index 32fd79c38..000000000 --- a/.changeset/source-vars-2.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/api': minor ---- - -feat: support data source and connection variables in the external API and MCP diff --git a/.changeset/source-vars-3.md b/.changeset/source-vars-3.md deleted file mode 100644 index 743757dbd..000000000 --- a/.changeset/source-vars-3.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/app': minor ---- - -feat: add data source variables to dashboard filters and tiles diff --git a/.changeset/source-vars-4.md b/.changeset/source-vars-4.md deleted file mode 100644 index 312539ba4..000000000 --- a/.changeset/source-vars-4.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/app': minor ---- - -feat: let tiles and filters use a data source variable as their source diff --git a/.changeset/source-vars-5.md b/.changeset/source-vars-5.md deleted file mode 100644 index 49079c548..000000000 --- a/.changeset/source-vars-5.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -'@hyperdx/app': minor -'@hyperdx/api': minor -'@hyperdx/common-utils': minor ---- - -feat: add connection variables for raw SQL tiles, SQL query filters, and -connection-scoped data source variables diff --git a/.changeset/spotlight-settings-entries.md b/.changeset/spotlight-settings-entries.md deleted file mode 100644 index 3e0db66e1..000000000 --- a/.changeset/spotlight-settings-entries.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -feat: Find settings and preferences from the Cmd+K menu - -- Team settings sections (sources, connections, team members, API keys, MCP - server, webhooks, query settings, and more) open the right tab and scroll to - the section. -- "Preferences" opens the preferences modal, and "Use light mode", "Use dark - mode", and "Use system color mode" switch the theme directly. diff --git a/.changeset/sql-query-dashboard-filter-api.md b/.changeset/sql-query-dashboard-filter-api.md deleted file mode 100644 index 62fa1a727..000000000 --- a/.changeset/sql-query-dashboard-filter-api.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -'@hyperdx/api': patch ---- - -feat: accept SQL query dashboard filters in the API, external API, and MCP - -Saving a dashboard now rejects a `SQL_QUERY` filter whose connection doesn't belong to the team. The external API and MCP read and write the filter with a `connectionId`, and MCP warns about unknown variables and source-only macros in its SQL. diff --git a/.changeset/sql-query-dashboard-filter-schema.md b/.changeset/sql-query-dashboard-filter-schema.md deleted file mode 100644 index affca36ff..000000000 --- a/.changeset/sql-query-dashboard-filter-schema.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@hyperdx/common-utils': patch -'@hyperdx/api': patch -'@hyperdx/app': patch ---- - -feat: add the SQL query dashboard filter type to the dashboard schema - -A `SQL_QUERY` filter stores a ClickHouse connection and a SQL template whose first column fills the filter's dropdown. It is variable-only. Validation flags templates that use `$__sourceTable` or `$__filters`, or whose macros and variable references can't expand. The filter is not yet exposed through the external API or MCP, and has no editor or values lookup yet. diff --git a/.changeset/stable-series-colors.md b/.changeset/stable-series-colors.md deleted file mode 100644 index cc21ce485..000000000 --- a/.changeset/stable-series-colors.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -fix: time chart series keep the same color across refreshes; series are now -ordered by name instead of by the order ClickHouse returned them diff --git a/.changeset/stacked-chart-distinct-y-ticks.md b/.changeset/stacked-chart-distinct-y-ticks.md deleted file mode 100644 index 3a9437cdf..000000000 --- a/.changeset/stacked-chart-distinct-y-ticks.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -fix: stacked bar and stacked line charts no longer show duplicate Y-axis labels -(e.g. "0, 500, 1k, 2k, 2k" when 1.5k rounds to 2k) diff --git a/.changeset/tile-alerts-1m-interval.md b/.changeset/tile-alerts-1m-interval.md deleted file mode 100644 index 2c5a76130..000000000 --- a/.changeset/tile-alerts-1m-interval.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -feat: dashboard tile alerts can use a 1 minute interval outside development diff --git a/.changeset/user-preferences-addition.md b/.changeset/user-preferences-addition.md deleted file mode 100644 index 0711891c7..000000000 --- a/.changeset/user-preferences-addition.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@hyperdx/app': patch ---- - -feat: small addition to user preferences diff --git a/.env b/.env index 0f31ad49a..680b86ccd 100644 --- a/.env +++ b/.env @@ -9,8 +9,8 @@ NEXT_ALL_IN_ONE_IMAGE_NAME_DOCKERHUB=clickhouse/clickstack-all-in-one ALL_IN_ONE_IMAGE_NAME_DOCKERHUB=hyperdx/hyperdx-all-in-one NEXT_OTEL_COLLECTOR_IMAGE_NAME_DOCKERHUB=clickhouse/clickstack-otel-collector OTEL_COLLECTOR_IMAGE_NAME_DOCKERHUB=hyperdx/hyperdx-otel-collector -CODE_VERSION=2.45.0 -IMAGE_VERSION_SUB_TAG=.45.0 +CODE_VERSION=2.46.0 +IMAGE_VERSION_SUB_TAG=.46.0 IMAGE_VERSION=2 IMAGE_NIGHTLY_TAG=2-nightly IMAGE_LATEST_TAG=latest diff --git a/CHANGELOG.md b/CHANGELOG.md index 8298c188c..0f05a501b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,176 @@ PR — keep the `hyperdx-release-notes` comment marker intact when editing so yo edits survive regeneration. Per-package detail lives in each `packages/*/CHANGELOG.md`. +## v2.46.0 — 2026-11-18 + + + +**Data source variables and pattern filters** + +Dashboards can now take data source and connection variables, so a single +dashboard can be pointed at a different source or ClickHouse connection — raw +SQL tiles and SQL query filters included — instead of being duplicated once per +source. Event Patterns gains "Filter for this pattern" and "Exclude this +pattern" buttons, so you can narrow a search to a pattern — or hide it — across +every event in the time range rather than the sampled rows alone. Ad hoc +dashboard filters gain an `IN` operator and can now be created, read and updated +through the external API and the MCP dashboard tools; note before upgrading that +every ad hoc filter now broadcasts and its name is only an identifier, so a +query that referred to it as a `$variable` no longer picks up its value. Log and +trace sources can now carry an optional "Row key expression", so the side panel +looks a row up using exactly the columns you nominate instead of guessing keys +from table metadata, and one MCP tool is renamed: +`clickstack_trace_top_time_consuming_operations` is now +`clickstack_trace_top_time_consuming_ops`. + +### 💥 Breaking Changes + +- **Ad hoc filters always broadcast, and are no longer `$variable`s**: + broadcasting is now always on for an ad hoc filter (`isBroadcastEnabled: + true`), so one that had it switched off now applies wherever its sources are + used, and the filter's name is only a unique identifier — it is no longer + declared as a `$variable`. Check whether a tile query or another filter on + your dashboards refers to an ad hoc filter by its `$name` before you upgrade, + because that reference no longer resolves to it. +- **The MCP trace operations tool has a shorter name**: + `clickstack_trace_top_time_consuming_operations` is now + `clickstack_trace_top_time_consuming_ops`. The old name was the longest tool + name the server offered and exceeded the tool-name length limit some MCP + clients enforce, so anything calling the tool by its old name needs to switch + to the new one. + +### ✨ New Features + +- **Data source variables on dashboards**: dashboards take a new data source + variable type that you can use in dashboard filters and tiles, and a tile or + filter can draw its source from that variable rather than a fixed one — so you + can repoint a whole dashboard at another source from its filter bar instead of + keeping a copy per source. Data source variables are supported through the + external API and MCP as well. +- **Connection variables for raw SQL tiles and SQL query filters**: a connection + variable supplies the ClickHouse connection a raw SQL tile or SQL query filter + runs against, and can scope a data source variable to the sources belonging to + the chosen connection, so one dashboard can be run against a different + connection without editing every tile. +- **Filter for or exclude a pattern from Event Patterns**: each row in Event + Patterns now has "Filter for this pattern" and "Exclude this pattern" buttons + on hover, and each adds a filter matching every event that fits the pattern in + the time range, not only the sampled rows, so the results table, histogram and + counts all update together. Exclusions stack and show as pills next to your + other filters, survive sidebar filter changes, and are kept in the URL and in + saved searches; a new include replaces the previous one, and switching source + removes pattern filters. +- **Ad hoc dashboard filters through the API and MCP**: `/api/v2/dashboards` now + accepts and returns `ADHOC` filters — with SQL and PromQL source types, and + their `adhoc` entries in `savedFilterValues` — and + `clickstack_save_dashboard`, `clickstack_get_dashboard` and + `clickstack_patch_dashboard` handle the same filters and their saved + conditions, so an assistant can hand you a dashboard with its ad hoc filters + already in place. Each filter's sources must exist and be a kind its + `sourceType` supports. Over MCP, PromQL ad hoc filters are offered only while + PromQL is enabled and are otherwise hidden and kept as they are on update, and + a saved condition that names no ad hoc filter, or uses an operator its filter + can't apply, comes back as a warning. +- **Row key expression on log and trace sources**: set an optional row key + expression on a source and the side panel's row lookup selects and filters on + only those columns, instead of detecting keys from table metadata. Leave it + empty and nothing changes — detection behaves exactly as it does today. +- **Find settings and preferences from the Cmd+K menu**: the command menu now + lists team settings sections — sources, connections, team members, API keys, + MCP server, webhooks, query settings and more — and jumps straight to the + right tab and section. "Preferences" opens the preferences modal, and "Use + light mode", "Use dark mode" and "Use system color mode" switch the theme on + the spot. +- **Keep several ClickStack MCP servers side by side**: `hdx mcp install + --name ` adds the MCP server under a name you choose, so + installing a second ClickStack instance no longer overwrites the first. When + your key belongs to more than one team, the installer asks which teams to add + a server for and adds one entry per team, and when it finds more than one + agent it asks which to set up. +- **SQL query dashboard filters**: a dashboard filter can now be defined as a + ClickHouse connection plus a SQL template, with the first column of the + result filling the filter's dropdown. The filter is variable-only, and a + template that uses `$__sourceTable` or `$__filters`, or whose macros and + variable references can't expand, is rejected when you save the dashboard — + as is a filter pointing at a connection that doesn't belong to your team. You + can read and write it through the API, external API and MCP today, where MCP + also warns about unknown variables and source-only macros in the SQL; there + is no in-app editor or values lookup yet. + +### 🔧 Improvements + +- **An `IN` operator for ad hoc filters, and a shorter filter input**: ad hoc + filters take an `IN` operator, and `IN` conditions on the same key are OR'd + into a single `IN (...)` condition for SQL, or one `=~"a|b"` matcher for + PromQL, so picking several values for one key reads as one condition rather + than a stack of them. The filter input collapses to three conditions behind a + "+N more" toggle, and you are warned when another ad hoc filter already + applies to the same sources. +- **Alert checks scale better with the number of alerts**: each alert is now + evaluated against only its own previous history, so a single check-alerts tick + no longer re-scans every alert's group history once per alert. Deployments + with many alerts should see noticeably lighter alert-checking work each tick. +- **Dashboard tile alerts can check every minute**: the 1 minute interval is no + longer limited to development, so an alert on a dashboard tile can run at the + shortest interval in your own deployment. +- **`clickstack_save_alert` handles notes and consecutive windows**: the MCP + tool now accepts `note` and `numConsecutiveWindows`, and an update that leaves + either field out keeps the stored value instead of clearing it. Send `null` + when you actually want to clear one. +- **Bare-text search falls back to a log source's body expression**: when a log + source has no implicit search column set, bare-text MCP searches, pattern + filters, event deltas and alert alias queries now search the source's body + expression instead, so those features have something sensible to match on + without one configured. +- **One pattern predicate behind the app and MCP**: `templateToRegex`, + `buildPatternPredicate` and a new, much shorter `buildCompactPatternPredicate` + now live in `@hyperdx/common-utils/dist/drain`, so the app's new pattern + filters and the MCP `clickstack_event_patterns` drill-down build their match + from one implementation — the compact form being short enough to carry in a + URL. `parsePatternPredicate` reads either form back into its value expression + and template, and new options match templates mined with extra delimiters or + by Python Drain3. The MCP drill-down snippet itself is unchanged. + +### 🐛 Bug Fixes + +- **Time chart series keep their colour across refreshes**: a series no longer + changes colour when a chart reloads, because series are now ordered by name + instead of by the order ClickHouse returned them. A chart you are watching + stays readable from one refresh to the next. +- **Stacked charts no longer repeat Y-axis labels**: stacked bar and stacked + line charts showed the same label twice when rounding collapsed two ticks onto + one value — an axis reading "0, 500, 1k, 2k, 2k" where 1.5k rounded up to 2k. + The ticks are now distinct. +- **Typing in the source selector replaces the name you picked**: clicking the + source selector now selects its current label, so what you type replaces the + old name instead of landing in the middle of it. +- **The team switcher and user preferences are reachable on a phone**: the app + shell and nav were sized with `100vh`, which on mobile browsers counts the + area behind the retractable toolbar, so the bottom of the nav sat off screen + with no way to scroll to it. Both now size to the small viewport, putting + those items back within reach. +- **The organisation API keys empty state fills its section**: the "No + organization API keys yet" message now spans the full width of the team + settings section instead of sitting in a narrow column. + +### 📦 Build / Packaging + +- **`uuid` updated to 11.1.1 in the API**: the API now depends on `uuid` 11.1.1, + which carries the fix for GHSA-w5hq-g745-h8pq. No action is needed beyond + upgrading. + + + +### 📦 Package changelogs + +- `@hyperdx/api` 2.45.0 → 2.46.0 — [changelog](https://github.com/ClickHouse/ClickStack/blob/main/packages/api/CHANGELOG.md#2460) +- `@hyperdx/app` 2.45.0 → 2.46.0 — [changelog](https://github.com/ClickHouse/ClickStack/blob/main/packages/app/CHANGELOG.md#2460) +- `@hyperdx/cli` 0.9.0 → 0.9.1 — [changelog](https://github.com/ClickHouse/ClickStack/blob/main/packages/cli/CHANGELOG.md#091) +- `@hyperdx/common-utils` 0.35.0 → 0.36.0 — [changelog](https://github.com/ClickHouse/ClickStack/blob/main/packages/common-utils/CHANGELOG.md#0360) +- `@hyperdx/otel-collector` 2.45.0 → 2.46.0 — [changelog](https://github.com/ClickHouse/ClickStack/blob/main/packages/otel-collector/CHANGELOG.md#2460) + + + ## v2.45.0 — 2026-11-13 diff --git a/packages/api/CHANGELOG.md b/packages/api/CHANGELOG.md index e7a69fca6..d8d8d82e7 100644 --- a/packages/api/CHANGELOG.md +++ b/packages/api/CHANGELOG.md @@ -1,5 +1,82 @@ # @hyperdx/api +## 2.46.0 + +### Minor Changes + +- 6705e505d: feat: Create, read, and update ad hoc dashboard filters through the external API + + `/api/v2/dashboards` now accepts and returns `ADHOC` filters, with SQL and + PromQL source types, and their `adhoc` entries in `savedFilterValues`. Each + filter's sources must exist and be a kind its `sourceType` supports. MCP still + hides ad hoc filters. + +- b681cec85: feat(mcp): Create, read, and update ad hoc dashboard filters through the MCP dashboard tools + + `clickstack_save_dashboard`, `clickstack_get_dashboard`, and + `clickstack_patch_dashboard` now handle `ADHOC` filters and their `adhoc` + saved conditions. PromQL ad hoc filters are offered only while PromQL is + enabled, and are hidden and kept on update otherwise. Saved conditions that + name no ad hoc filter, or use an operator their filter can't apply, produce a + warning. + +- 743c3c1a6: feat: add an optional "Row key expression" to log and trace sources. When set, + the side panel's row lookup selects and filters on only those columns instead of + detecting keys from table metadata. +- a7744e82a: feat: add data source and connection variable types to dashboards +- a7744e82a: feat: support data source and connection variables in the external API and MCP +- a7744e82a: feat: add connection variables for raw SQL tiles, SQL query filters, and + connection-scoped data source variables + +### Patch Changes + +- f15b849da: feat: Ad hoc dashboard filter finishing touches + + - Add an `IN` operator. `IN` conditions on the same key are OR'd into one + `IN (...)` condition for SQL, or one `=~"a|b"` matcher for PromQL. + - Ad hoc filters always broadcast (`isBroadcastEnabled: true`), and their + variable name is only a unique identifier. It is no longer declared as a + `$variable`. + - Warn when another ad hoc filter already applies to the same sources. + - Collapse the filter input to three conditions behind a "+N more" toggle. + +- 8952972c9: perf: check-alerts gives each alert only its own previous history, so a tick + no longer scans every alert's group history once per alert +- f42c68a9c: chore: bump `uuid` to 11.1.1 (fixes GHSA-w5hq-g745-h8pq) and drop `@types/uuid` +- bfb5c834f: Use the log source body expression for bare-text MCP searches, pattern filters, + event deltas, and alert alias queries when no implicit search column is set. +- 02a40929d: feat: `clickstack_save_alert` accepts `note` and `numConsecutiveWindows` + + Updates that omit either field now keep the stored value instead of clearing it; + send `null` to clear. + +- 8dc1aa791: refactor: the MCP `clickstack_event_patterns` tool builds its drill-down + `whereSnippet` with the shared pattern predicate from `@hyperdx/common-utils` + instead of its own copy. The snippet is unchanged. +- 6256667e1: fix(mcp): Rename `clickstack_trace_top_time_consuming_operations` to `clickstack_trace_top_time_consuming_ops` + + The old name was the longest MCP tool name and exceeded the tool-name length + limit some MCP clients enforce. Clients that call the tool by its old name + need to switch to the new one. + +- fa3a5649e: feat: accept SQL query dashboard filters in the API, external API, and MCP + + Saving a dashboard now rejects a `SQL_QUERY` filter whose connection doesn't belong to the team. The external API and MCP read and write the filter with a `connectionId`, and MCP warns about unknown variables and source-only macros in its SQL. + +- 5b50c31c9: feat: add the SQL query dashboard filter type to the dashboard schema + + A `SQL_QUERY` filter stores a ClickHouse connection and a SQL template whose first column fills the filter's dropdown. It is variable-only. Validation flags templates that use `$__sourceTable` or `$__filters`, or whose macros and variable references can't expand. The filter is not yet exposed through the external API or MCP, and has no editor or values lookup yet. + +- Updated dependencies [f15b849da] +- Updated dependencies [fe96b722b] +- Updated dependencies [02a40929d] +- Updated dependencies [d311d82e2] +- Updated dependencies [743c3c1a6] +- Updated dependencies [a7744e82a] +- Updated dependencies [a7744e82a] +- Updated dependencies [5b50c31c9] + - @hyperdx/common-utils@0.36.0 + ## 2.45.0 ### Minor Changes diff --git a/packages/api/package.json b/packages/api/package.json index 25631f8ad..74c55981c 100644 --- a/packages/api/package.json +++ b/packages/api/package.json @@ -1,6 +1,6 @@ { "name": "@hyperdx/api", - "version": "2.45.0", + "version": "2.46.0", "license": "MIT", "private": true, "engines": { @@ -23,7 +23,7 @@ "@clickhouse/clickstack-node": "^1.0.2", "@clickhouse/client-common": "1.23.0-head.fae5998.1", "@esm2cjs/p-queue": "^7.3.0", - "@hyperdx/common-utils": "^0.35.0", + "@hyperdx/common-utils": "^0.36.0", "@hyperdx/passport-local-mongoose": "^9.0.1", "@modelcontextprotocol/sdk": "^1.27.1", "@opentelemetry/api": "~1.9.1", diff --git a/packages/app/CHANGELOG.md b/packages/app/CHANGELOG.md index b6d5cf463..c9a09163e 100644 --- a/packages/app/CHANGELOG.md +++ b/packages/app/CHANGELOG.md @@ -1,5 +1,86 @@ # @hyperdx/app +## 2.46.0 + +### Minor Changes + +- ca4855d97: feat: filter for or exclude a pattern from Event Patterns + + Each row in Event Patterns now has "Filter for this pattern" and "Exclude this + pattern" buttons on hover. Each adds a filter for every event that fits the + pattern in the time range, not only the sampled rows, so the results table, + histogram and counts all update. Exclusions stack, show as pills next to the + other filters, survive sidebar filter changes, and are kept in the URL and in + saved searches. A new include replaces the previous one, and switching source + removes pattern filters. + +- 743c3c1a6: feat: add an optional "Row key expression" to log and trace sources. When set, + the side panel's row lookup selects and filters on only those columns instead of + detecting keys from table metadata. +- a7744e82a: feat: add data source variables to dashboard filters and tiles +- a7744e82a: feat: let tiles and filters use a data source variable as their source +- a7744e82a: feat: add connection variables for raw SQL tiles, SQL query filters, and + connection-scoped data source variables + +### Patch Changes + +- f15b849da: feat: Ad hoc dashboard filter finishing touches + + - Add an `IN` operator. `IN` conditions on the same key are OR'd into one + `IN (...)` condition for SQL, or one `=~"a|b"` matcher for PromQL. + - Ad hoc filters always broadcast (`isBroadcastEnabled: true`), and their + variable name is only a unique identifier. It is no longer declared as a + `$variable`. + - Warn when another ad hoc filter already applies to the same sources. + - Collapse the filter input to three conditions behind a "+N more" toggle. + +- 3419ab0ae: fix: keep the team switcher and user preferences reachable in the mobile app + nav. The app shell and nav were sized with `100vh`, which on mobile browsers + includes the area behind the retractable toolbar, so the bottom of the nav sat + off screen with no way to scroll to it. They now size to the small viewport. +- ca4ceae90: fix: make the "No organization API keys yet" empty state span the full width of + the team settings section. +- 3a10f625f: fix: clicking the source selector selects its current label so typing replaces + it instead of inserting into the middle of the old name +- a7744e82a: feat: add data source and connection variable types to dashboards +- 0e9fb1bf1: feat: Find settings and preferences from the Cmd+K menu + + - Team settings sections (sources, connections, team members, API keys, MCP + server, webhooks, query settings, and more) open the right tab and scroll to + the section. + - "Preferences" opens the preferences modal, and "Use light mode", "Use dark + mode", and "Use system color mode" switch the theme directly. + +- 5b50c31c9: feat: add the SQL query dashboard filter type to the dashboard schema + + A `SQL_QUERY` filter stores a ClickHouse connection and a SQL template whose first column fills the filter's dropdown. It is variable-only. Validation flags templates that use `$__sourceTable` or `$__filters`, or whose macros and variable references can't expand. The filter is not yet exposed through the external API or MCP, and has no editor or values lookup yet. + +- 50129d13d: fix: time chart series keep the same color across refreshes; series are now + ordered by name instead of by the order ClickHouse returned them +- 3c8794f2c: fix: stacked bar and stacked line charts no longer show duplicate Y-axis labels + (e.g. "0, 500, 1k, 2k, 2k" when 1.5k rounds to 2k) +- a4f68568e: feat: dashboard tile alerts can use a 1 minute interval outside development +- 1556317ea: feat: small addition to user preferences +- Updated dependencies [f15b849da] +- Updated dependencies [6705e505d] +- Updated dependencies [b681cec85] +- Updated dependencies [8952972c9] +- Updated dependencies [f42c68a9c] +- Updated dependencies [fe96b722b] +- Updated dependencies [bfb5c834f] +- Updated dependencies [02a40929d] +- Updated dependencies [8dc1aa791] +- Updated dependencies [6256667e1] +- Updated dependencies [d311d82e2] +- Updated dependencies [743c3c1a6] +- Updated dependencies [a7744e82a] +- Updated dependencies [a7744e82a] +- Updated dependencies [a7744e82a] +- Updated dependencies [fa3a5649e] +- Updated dependencies [5b50c31c9] + - @hyperdx/common-utils@0.36.0 + - @hyperdx/api@2.46.0 + ## 2.45.0 ### Minor Changes diff --git a/packages/app/package.json b/packages/app/package.json index d31c12cd1..390df01b9 100644 --- a/packages/app/package.json +++ b/packages/app/package.json @@ -1,6 +1,6 @@ { "name": "@hyperdx/app", - "version": "2.45.0", + "version": "2.46.0", "private": true, "license": "MIT", "engines": { @@ -40,7 +40,7 @@ "@dnd-kit/utilities": "^3.2.2", "@hookform/resolvers": "^3.9.0", "@hyperdx/api": "workspace:*", - "@hyperdx/common-utils": "^0.35.0", + "@hyperdx/common-utils": "^0.36.0", "@mantine/core": "^9.0.0", "@mantine/dates": "^9.0.0", "@mantine/dropzone": "^9.0.0", diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md index aaa4ffabf..1b46fa44b 100644 --- a/packages/cli/CHANGELOG.md +++ b/packages/cli/CHANGELOG.md @@ -1,5 +1,16 @@ # @hyperdx/cli +## 0.9.1 + +### Patch Changes + +- a25e945e7: feat(cli): `hdx mcp install` can keep several ClickStack servers side by side + + `--name ` adds the MCP server under a name you choose, so a second + ClickStack instance no longer overwrites the first. When the key belongs to more + than one team, the installer asks which teams to add a server for and adds one + entry per team. When it finds more than one agent it asks which to set up. + ## 0.9.0 ### Minor Changes diff --git a/packages/cli/package.json b/packages/cli/package.json index eb29ee616..cae563b6b 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@hyperdx/cli", - "version": "0.9.0", + "version": "0.9.1", "license": "MIT", "type": "module", "repository": { @@ -41,7 +41,7 @@ }, "devDependencies": { "@clickhouse/client": "1.23.0-head.fae5998.1", - "@hyperdx/common-utils": "^0.35.0", + "@hyperdx/common-utils": "^0.36.0", "@jest/globals": "^30.2.0", "@types/crypto-js": "^4.2.2", "@types/jest": "^29.5.14", diff --git a/packages/common-utils/CHANGELOG.md b/packages/common-utils/CHANGELOG.md index 433f36567..6f6089033 100644 --- a/packages/common-utils/CHANGELOG.md +++ b/packages/common-utils/CHANGELOG.md @@ -1,5 +1,52 @@ # @hyperdx/common-utils +## 0.36.0 + +### Minor Changes + +- fe96b722b: feat: add `buildCompactPatternPredicate` + + It builds the same match as `buildPatternPredicate` in much shorter SQL, for + pattern filters that are kept in a URL. `parsePatternPredicate` reads both + forms. + +- d311d82e2: feat: share the Event Patterns drill-down predicate + + `templateToRegex` and `buildPatternPredicate`, which the MCP server uses to + build the `clickstack_event_patterns` drill-down filter, are now in + `@hyperdx/common-utils/dist/drain`. New options match templates mined with extra + delimiters (`extraDelimiters`) or by Python Drain3 (`whitespace: 'python'`), and + `parsePatternPredicate` reads a predicate back into its value expression and + template. Without options the output is the same as the MCP server's. + +- 743c3c1a6: feat: add an optional "Row key expression" to log and trace sources. When set, + the side panel's row lookup selects and filters on only those columns instead of + detecting keys from table metadata. +- a7744e82a: feat: add data source and connection variable types to dashboards +- a7744e82a: feat: add connection variables for raw SQL tiles, SQL query filters, and + connection-scoped data source variables + +### Patch Changes + +- f15b849da: feat: Ad hoc dashboard filter finishing touches + + - Add an `IN` operator. `IN` conditions on the same key are OR'd into one + `IN (...)` condition for SQL, or one `=~"a|b"` matcher for PromQL. + - Ad hoc filters always broadcast (`isBroadcastEnabled: true`), and their + variable name is only a unique identifier. It is no longer declared as a + `$variable`. + - Warn when another ad hoc filter already applies to the same sources. + - Collapse the filter input to three conditions behind a "+N more" toggle. + +- 02a40929d: feat: `clickstack_save_alert` accepts `note` and `numConsecutiveWindows` + + Updates that omit either field now keep the stored value instead of clearing it; + send `null` to clear. + +- 5b50c31c9: feat: add the SQL query dashboard filter type to the dashboard schema + + A `SQL_QUERY` filter stores a ClickHouse connection and a SQL template whose first column fills the filter's dropdown. It is variable-only. Validation flags templates that use `$__sourceTable` or `$__filters`, or whose macros and variable references can't expand. The filter is not yet exposed through the external API or MCP, and has no editor or values lookup yet. + ## 0.35.0 ### Minor Changes diff --git a/packages/common-utils/package.json b/packages/common-utils/package.json index 099f84914..282beaf3c 100644 --- a/packages/common-utils/package.json +++ b/packages/common-utils/package.json @@ -1,7 +1,7 @@ { "name": "@hyperdx/common-utils", "description": "Common utilities for HyperDX application", - "version": "0.35.0", + "version": "0.36.0", "license": "MIT", "private": true, "files": [ diff --git a/packages/otel-collector/CHANGELOG.md b/packages/otel-collector/CHANGELOG.md index 65087ce7b..9cd31d83d 100644 --- a/packages/otel-collector/CHANGELOG.md +++ b/packages/otel-collector/CHANGELOG.md @@ -1,5 +1,7 @@ # @hyperdx/otel-collector +## 2.46.0 + ## 2.45.0 ## 2.44.0 diff --git a/packages/otel-collector/package.json b/packages/otel-collector/package.json index 5c6387e5c..95b788815 100644 --- a/packages/otel-collector/package.json +++ b/packages/otel-collector/package.json @@ -1,7 +1,7 @@ { "name": "@hyperdx/otel-collector", "description": "HyperDX OpenTelemetry Collector configuration and Docker image", - "version": "2.45.0", + "version": "2.46.0", "license": "MIT", "private": true } diff --git a/yarn.lock b/yarn.lock index 0811a437d..4c654b6c6 100644 --- a/yarn.lock +++ b/yarn.lock @@ -4772,7 +4772,7 @@ __metadata: "@clickhouse/clickstack-node": "npm:^1.0.2" "@clickhouse/client-common": "npm:1.23.0-head.fae5998.1" "@esm2cjs/p-queue": "npm:^7.3.0" - "@hyperdx/common-utils": "npm:^0.35.0" + "@hyperdx/common-utils": "npm:^0.36.0" "@hyperdx/passport-local-mongoose": "npm:^9.0.1" "@modelcontextprotocol/sdk": "npm:^1.27.1" "@opentelemetry/api": "npm:~1.9.1" @@ -4869,7 +4869,7 @@ __metadata: "@eslint/compat": "npm:^2.0.0" "@hookform/resolvers": "npm:^3.9.0" "@hyperdx/api": "workspace:*" - "@hyperdx/common-utils": "npm:^0.35.0" + "@hyperdx/common-utils": "npm:^0.36.0" "@mantine/core": "npm:^9.0.0" "@mantine/dates": "npm:^9.0.0" "@mantine/dropzone": "npm:^9.0.0" @@ -4987,7 +4987,7 @@ __metadata: resolution: "@hyperdx/cli@workspace:packages/cli" dependencies: "@clickhouse/client": "npm:1.23.0-head.fae5998.1" - "@hyperdx/common-utils": "npm:^0.35.0" + "@hyperdx/common-utils": "npm:^0.36.0" "@jest/globals": "npm:^30.2.0" "@types/crypto-js": "npm:^4.2.2" "@types/jest": "npm:^29.5.14" @@ -5014,7 +5014,7 @@ __metadata: languageName: unknown linkType: soft -"@hyperdx/common-utils@npm:^0.35.0, @hyperdx/common-utils@workspace:packages/common-utils": +"@hyperdx/common-utils@npm:^0.36.0, @hyperdx/common-utils@workspace:packages/common-utils": version: 0.0.0-use.local resolution: "@hyperdx/common-utils@workspace:packages/common-utils" dependencies: