Skip to content

Adding chrome extension documentation#6340

Closed
kyreddie wants to merge 3 commits into
mainfrom
kyreddie-docs
Closed

Adding chrome extension documentation#6340
kyreddie wants to merge 3 commits into
mainfrom
kyreddie-docs

Conversation

@kyreddie
Copy link
Copy Markdown
Contributor

@kyreddie kyreddie commented Jun 3, 2026

Summary


Note

Low Risk
Documentation-only addition with no runtime or product code changes.

Overview
Adds a new ClickStack example-datasets guide at chrome-extension.md that documents using the HyperDX Chrome extension to inject the Browser SDK into arbitrary sites for session replay and RUM without changing application source code.

The page walks through cloning and loading the unpacked extension, optional local ClickStack collector setup, extension settings (service name, collector URL, API key, trace propagation, URL filters), browsing to generate telemetry, and viewing replays in Client Sessions. It also covers URL pattern filtering, DevTools verification logs, troubleshooting (missing sessions, CSP/injection failures, chrome-extension://invalid/), and a short privacy note, with links to related Session Replay and SDK docs.

The guide uses the same VerticalStepper / IdealImage patterns as other example-dataset pages and sets sidebar_position: 5 with standalone pagination.

Reviewed by Cursor Bugbot for commit 874f1dc. Bugbot is set up for automated code reviews on this repo. Configure here.

@kyreddie kyreddie requested a review from a team as a code owner June 3, 2026 21:23
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Error Error Jun 3, 2026 9:34pm
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jun 3, 2026 9:34pm
clickhouse-docs-ko Ignored Ignored Preview Jun 3, 2026 9:34pm
clickhouse-docs-ru Ignored Ignored Preview Jun 3, 2026 9:34pm
clickhouse-docs-zh Ignored Ignored Preview Jun 3, 2026 9:34pm

Request Review

@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Jun 3, 2026

CLA assistant check
All committers have signed the CLA.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new ClickStack “example datasets” guide documenting how to use the HyperDX Chrome extension to inject the Browser SDK for session replay/RUM on arbitrary sites without modifying application source.

Changes:

  • Introduces a new chrome-extension.md guide with prerequisites, setup flow, configuration options, verification steps, troubleshooting, and related links.
  • Adds an IdealImage screenshot reference for extension configuration.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +12 to +14
import Image from '@theme/IdealImage';
import extension_config from '@site/static/images/clickstack/chrome-extension/extension-config.png';

Comment thread docs/use-cases/observability/clickstack/example-datasets/chrome-extension.md Outdated
Comment thread docs/use-cases/observability/clickstack/example-datasets/chrome-extension.md Outdated
Comment on lines +61 to +73
For a local ClickStack stack, start the OpenTelemetry collector:

```shell
docker run \
-p 8080:8080 \
-p 4317:4317 \
-p 4318:4318 \
clickhouse/clickstack-otel-collector:latest
```

Open HyperDX at [http://localhost:8080](http://localhost:8080) to confirm the UI is running.

For a full local deployment with ClickHouse and HyperDX UI, see [Getting started with ClickStack](/use-cases/observability/clickstack/getting-started/oss).
Comment on lines +172 to +176
## Learn more {#learn-more}

- [Session Replay](/use-cases/observability/clickstack/session-replay) — feature overview, SDK options, and privacy controls
- [Browser SDK Reference](/use-cases/observability/clickstack/sdks/browser) — full SDK options and advanced configuration
- [Session Replay Demo](session-replay.md) — instrument a demo application from source code
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@mintlify
Copy link
Copy Markdown

mintlify Bot commented Jun 3, 2026

Docs PR opened: ClickHouse/mintlify-docs-dev#117

Added a ClickStack example-datasets guide for instrumenting any website with the HyperDX Chrome extension for session replay.

Once this PR is merged, we'll do a second pass to capture any additional changes and update the docs PR.

@Blargian Blargian requested a review from dhtclk June 4, 2026 08:34
@kyreddie kyreddie closed this Jun 4, 2026
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.

4 participants