Client Sessions list shows "Set up session replays" wizard despite valid Session source and data — only metadata queries fire, never the session-list query

[vishaalhere]

Summary

On HyperDX OSS hyperdx:2 (app v2.24.1), the Client Sessions page renders the "Set up session replays" onboarding wizard even when session data is being recorded correctly and the Session source exists in MongoDB. Individual replays open fine from a trace; only the list view is broken.

Environment

• Image: docker.hyperdx.io/hyperdx/hyperdx:2 (app v2.24.1)
• Self-hosted via official docker compose up flow
• ClickHouse hyperdx_sessions table healthy (~1,160 rows / 10 min)
• Browser SDK: @hyperdx/browser@0.21.2

What's happening

On Client Sessions page load, inspecting system.query_log shows the UI:

1. Runs metadata queries to check the table exists and sample attribute keys ✅
2. Then renders the wizard — never fires the actual session-list query

So the data is fine; the UI's gating logic decides the source is "incomplete" and shows onboarding instead.

Workaround

Wiping the MongoDB volume and letting the onboarding wizard auto-create the Sources fixes it immediately. Manually creating/editing Session sources through Team Settings does NOT fix it — even when the resulting doc looks valid.

Steps:

1. docker compose stop app db && docker compose rm -f app db
2. Delete the Mongo bind-mount dir (leave ClickHouse data alone)
3. docker compose up -d
4. Run the onboarding wizard, accept all auto-detected source defaults
5. Client Sessions list populates immediately

Likely cause

Some condition the auto-wizard sets on Session source documents that user-edited or auto-regenerated sources don't have. I didn't pin down the exact predicate, but the metadata-only query pattern in system.query_log should make the failing branch easy to find in the UI code.

Impact

• Replay viewing: unaffected (works via Traces)
• Session browsing by user/time: broken (entry point unusable)

Happy to share the broken vs. fixed Mongo source docs if useful.

[pulpdrew]

Hey @vishaalhere, if you could share the broken and fixed Mongo source docs, that would be useful. Both the Session and Trace source docs would be helpful if you have them.