docs/clickstack.md: point HyperDX at a smolquery table — the recipe, what works, what does not (T-500) - #356
Merged
Conversation
chasers
added this pull request to stack #354
September 20, 2026 01:21
…what works, what does not (T-500) Scoped to HyperDX. ClickStack's collector is out for now: it speaks the Native format and runs ClickHouse DDL, and rows reach smolquery through its own ingest instead. The page gives the otel_logs-shaped table to create through the API, with its clustering key (what system.tables answers as the sorting key HyperDX orders by), an NDJSON insert, and a compose file with DEFAULT_CONNECTIONS and DEFAULT_SOURCES. It says why the host must be a name and not a private IP literal, and why the select list must be plain: a select with "x as y" makes HyperDX send WITH (expr) AS alias, which the edge does not take yet. It says at the top how this was checked: from HyperDX's source, as a fixture corpus, and not yet against a live HyperDX. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
chasers
force-pushed
the
t-500-hyperdx-doc
branch
from
September 20, 2026 03:11
a10da36 to
5d10702
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
TL;DR: A new doc,
docs/clickstack.md: how to point HyperDX at a smolquery table, what works, and what does not.Tracker: T-500. Plan PL-66. Stacked on #355 (T-495).
Scope
Nativeformat and runs ClickHouse DDL.What the doc gives
otel_logs-shaped table to create through the API, with its clustering key.DEFAULT_CONNECTIONSandDEFAULT_SOURCES.Watch out
hostmust be a name. HyperDX's connection test refuses a private IP literal.x as ymakes HyperDX sendWITH (expr) AS alias, which the edge does not take yet.Checks
🤖 Generated with Claude Code