Skip to content

docs(session-replay): Document diagnostic button and new diagnostic properties#17864

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-23T18-48-21-158Z-gzbzm2
Open

docs(session-replay): Document diagnostic button and new diagnostic properties#17864
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-06-23T18-48-21-158Z-gzbzm2

Conversation

@inkeep

@inkeep inkeep Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Changes

This PR updates the Session Replay troubleshooting documentation to reflect changes from PostHog/posthog#65490.

What's documented

  1. New UI feature: "Check session recording status" button - Users can now diagnose session recording issues directly from the event details view:

    • Available in the Debug properties tab of event rows in the Activity view
    • Opens a modal showing why the session was or wasn't recorded
    • Only appears when the event contains replay diagnostic signals
    • Provides a quicker alternative to running SQL queries
  2. New diagnostic properties - Added documentation for 10 new properties:

    • $sdk_debug_rrweb_start_attempted - Whether the SDK attempted to start the rrweb recorder
    • $sdk_debug_rrweb_attached - Whether rrweb is currently attached and capturing
    • $sdk_debug_replay_rrweb_error - Error message if rrweb failed to start
    • $session_recording_event_trigger_activated_session - Event trigger activation config
    • $sdk_debug_replay_trigger_groups_count - Number of V2 recording trigger groups configured
    • $sdk_debug_replay_matched_recording_trigger_groups - Which trigger groups matched
    • $replay_override_sampling - Recording was force-started, overriding sampling
    • $replay_override_linked_flag - Recording was force-started, ignoring linked flag
    • $replay_override_url_trigger - Recording was force-started, ignoring URL trigger
    • $replay_override_event_trigger - Recording was force-started, ignoring event trigger
  3. Fixed in-app links - Updated us.posthog.com to app.posthog.com per style guide


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

…and fix app URLs

- Add "Use the diagnostic button in event details" subsection documenting the
  new Check session recording status button in the Debug properties tab (PR #65490)
- Add new diagnostic properties to the "Other useful diagnostic properties" table:
  rrweb signals, event triggers, trigger groups, and override flags
- Fix us.posthog.com links to app.posthog.com per style guide
@inkeep inkeep Bot requested a review from pauldambra June 23, 2026 18:51
@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 3 errors, 13 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/session-replay/troubleshooting.mdx — 3 errors, 13 warnings, 0 suggestions
Line Severity Message Rule
7:4 warning 'Have a question? Ask PostHog AI' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
124:190 warning 'rrweb' is a possible misspelling. PostHogBase.Spelling
125:163 warning 'rrweb' is a possible misspelling. PostHogBase.Spelling
126:170 warning 'rrweb' is a possible misspelling. PostHogBase.Spelling
174:5 warning 'Ensure your website permits PostHog CORS' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
176:379 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
237:132 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
241:15 warning 'rrweb' is a possible misspelling. PostHogBase.Spelling
241:34 warning 'rrweb' is a possible misspelling. PostHogBase.Spelling
246:31 warning 'seekbar' is a possible misspelling. PostHogBase.Spelling
247:50 warning 'renderable' is a possible misspelling. PostHogBase.Spelling
247:69 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
257:215 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
287:110 warning 'Silverlight' is a possible misspelling. PostHogBase.Spelling
289:172 warning 'Calendly' is a possible misspelling. PostHogBase.Spelling
289:367 warning 'allowlist' is a possible misspelling. PostHogBase.Spelling

@github-actions

github-actions Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jun 23, 2026 07:04PM

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.21 MiB (no change)

Eager graph (static-import closure per entrypoint)

Entrypoint Eager size Budget Modules
app 24.13 MiB (no change) report-only 5505
Largest modules in the app closure
Module Size
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 710.3 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules 531.3 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/@codemirror+view@6.38.2/node_modules/@codemirror/view/dist/index.js 458.1 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js 364.8 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./src/hooks/useCustomers.tsx + 54 modules 353.9 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./node_modules/.pnpm/@codesandbox+sandpack-react@2.20.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@codesandbox/sandpack-react/dist/index.mjs 266.6 KiB
./src/components/ProductComparisonTable/index.tsx + 114 modules 264.0 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 239.9 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes.

@github-actions

Copy link
Copy Markdown
Contributor

Hey @pauldambra! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants