Filter key and value limits are unordered and not configurable — fields and values silently disappear
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 68/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- clickhouse, react, typescript
調査の方向性
packages/common-utils/src/core/metadata.ts から始め、getAllFields、getMapKeys、getAllKeyValues、getKeyValues、および getMetricNames の切り詰めパターンを追跡します。次に、設定のフローとフィルターのレンダリングを確認するため、packages/app/src/hooks/useMetadata.tsx、TeamQueryConfigSection.tsx、DBSearchPageFilters/hooks.ts を調べます。設定可能な上限が discovery と値に反映され、切り詰められた結果が決定的で UI に表示されれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Field discovery and value autocomplete both truncate to a fixed number of results with no ORDER BY. On a high-cardinality source the survivors are an arbitrary subset, the UI gives no sign anything was dropped, and the one team setting that looks like it controls this doesn't reach either path.
We hit this on a source with ~6,150 distinct LogAttributes keys. Roughly 5,150 of them are invisible in the filter sidebar and there is no way to raise the ceiling.
Keys: capped at 1000, and Filter Keys Fetch Limit doesn't apply
getAllFields calls getMapKeys without maxKeys, so DEFAULT_MAX_KEYS = 1000 always wins:
metadata.ts:1536— the call, nomaxKeysargumentmetadata.ts:57—const DEFAULT_MAX_KEYS = 1000;metadata.ts:693—maxKeys = DEFAULT_MAX_KEYS
The team setting exists (TeamQueryConfigSection.tsx:320, "Filter Keys Fetch Limit") but is only read in useMultipleGetKeyValues, where it slices the already-truncated key array: useMetadata.tsx:372-373, applied at useMetadata.tsx:411. Raising it above 1000 changes nothing; lowering it below 1000 only trims what discovery already returned. Confirmed on the wire — discovery queries carry LIMIT 1000 regardless of the setting.
Keys: the text-index path has no ORDER BY
getMapKeys returns from the first non-empty path of four. On ClickHouse 26.4 with a text index on mapKeys(LogAttributes), the text-index path wins and the KV rollup is never consulted:
metadata.ts:754-759—SELECT token AS key … GROUP BY key HAVING key != '' LIMIT maxKeys, noORDER BYmetadata.ts:788-793— same for the kv-token index
Compare the rollup path, which does order by frequency: metadata.ts:846-853 — ORDER BY sum(count) DESC. Adding a text index therefore makes field discovery worse: you trade a frequency-ranked list for an arbitrary one.
Values: capped at a hardcoded 20, also unordered
metadata.ts:2267—getAllKeyValues({ maxValuesPerKey = 20 })metadata.ts:2494—getKeyValues({ limit = 20 })metadata.ts:2779—getKeyValuesWithMVs({ limit = 20 })useMetadata.tsx:412—maxValuesPerKey: 20, hardcodedDBSearchPageFilters/hooks.ts:33—INITIAL_LOAD_LIMIT = 20, passed at line 197
The SQL is groupUniqArray(limit)(…) throughout, with no ordering: 2570-2571, 2605, 1428, 1257, 1334.
"Load More" raises one key to 10,000 (hooks.ts:36), but it's a manual per-key click. The initial 20 that decides whether the value you're looking for is on screen at all has no setting behind it.
This is already documented in the codebase
metadata.ts:2652-2669 explains why getMetricNames avoids getKeyValues:
groupUniqArray(limit)(MetricName)"keeps an arbitrary subset once a table has more thanlimitdistinct names — the survivors follow hash order, not name order, and shift as the data and part layout change. On a high-cardinality source (a full Prometheus scrape) that silently hid metrics such asup, with no way to search for what had been dropped."
And useMetadata.tsx:526 tells callers to "Prefer this over useGetKeyValues({ keys: ['MetricName'] }), which samples an arbitrary subset via groupUniqArray".
The fix applied there is exactly what's missing everywhere else: a deterministic ORDER BY, LIMIT limit + 1, and a truncated flag so the caller knows the list was cut. A truncated field already exists in the shared type at metadata.ts:77.
What we'd like
A cap is reasonable. Being unable to raise it, and not being told it applied, is not.
- Pass
maxKeysfromfilterKeysFetchLimitthroughgetAllFieldsintogetMapKeys, so the existing setting actually controls key discovery. - Add a team setting for max values per key, replacing the hardcoded
20inuseMetadata.tsx:412andINITIAL_LOAD_LIMIT. - Add
ORDER BYto the truncating queries — frequency for keys (as the rollup path already does), something deterministic for values — so the subset is at least stable and useful. - Surface truncation in the UI, reusing the
limit + 1/truncatedpattern fromgetMetricNames.
Environment
- HyperDX 2.37.0, ClickHouse Cloud 26.4
otel_logswithtextindexes onmapKeys(LogAttributes),mapKeys(ResourceAttributes),mapKeys(ScopeAttributes)- ~6,150 distinct
LogAttributeskeys per 15-minute window
- 主要言語
- TypeScript
- スター
- 10.1k
- フォーク
- 527
- 平均マージ
- 1日 20時間
- マージ済み PR(30日)
- 186
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
ClickHouse/ClickStack のほかの issue
-
external
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
ClickHouse/ClickStack#3761 ·
メンテナーはふだん 1 日以内に返信
-
Metric chart with aggFn increase and a multi-column group-by fails: toString() gets several arguments対応中かも @CG-5228 が 26 日前に担当しました。 オープンexternal
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
ClickHouse/ClickStack#3477 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
Slack notifications for inline alerts fail when the chart-explorer link passes Slack's 3000-character block limit対応中かも @Tyagiquamar が 28 日前に担当しました。 オープンalerting bug external
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
ClickHouse/ClickStack#3452 ·
メンテナーはふだん 1 日以内に返信
-
check-alerts worker: 13 error spans (mongodb.create, NamespaceExists) every minute because mongoose autoCreate is still on再び着手できるかも このイシューのプルリクエストはマージされずにクローズされました。 オープンbug external Needs Feedback
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
ClickHouse/ClickStack#3308 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
count_distinct aggFn on metric tiles ignores valueExpression, always counts distinct metric Values対応中かも @Harshul1484 が 54 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
ClickHouse/ClickStack#2311 ·
メンテナーはふだん 1 日以内に返信
ClickHouse/ClickStack の issue をすべて見る
似ている issue
-
Add: GTrekkerオープンcheck:passed streams:add
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
area: ui Bug Payload OSS
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
payloadcms/payload#19839 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
-
fix(auth): add the email OTP verification step to Pollar login対応中かも @akansnoro が今日担当しました。 オープンStellar Wave
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
safetrustcr/dApp-SafeTrust#584 · コメント 10 件 ·
メンテナーはふだん 1 日以内に返信
-
The manager preset saves launch definitions without the required file and digest pair対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 80/100
メンテナーはふだん 1 日以内に返信