feat(sdk): add SDK aliases and separate AI usage metrics by marandaneto · Pull Request #93911 · PostHog/posthog

marandaneto · 2026-09-03T06:32:33Z

Problem

SDK maintainers cannot distinguish several SDKs, aliases, and language-specific PostHog AI integrations in usage reports.

Feature flag analytics also classified newer package-specific SDK identifiers as unknown.

Changes

Usage reports now expose separate KMP, Node MCP, and Python MCP event counts.
OpenCode events now have a separate sub-SDK count and no longer inflate the general Node count.
Python and .NET PostHog AI events now use language-specific metrics instead of the Node PostHog AI metric.
posthog-rails contributes to the existing Ruby metric.
posthog-aspnetcore contributes to the existing .NET and .NET PostHog AI metrics.
The sub-SDK query groups by $lib and $ai_lib, then subtracts each sub-SDK from its correct parent SDK.
Both the Celery and Temporal report paths expose the new metrics.
Feature flag analytics now recognize KMP, Unity, Node MCP, Python MCP, Edge, Convex, Rails, and ASP.NET Core request identities.
The Rust and Python feature flag registries now contain the same identifiers, including posthog-server.

How did you test this code?

Extended usage classification and sub-SDK coverage for every new metric and alias.
Ran TestQueryUsageReportSQL and the Temporal usage-report query registry tests.
Ran the targeted feature flag Rust parser, library, runtime, and client-label tests.
Ran Rust formatting and Clippy for the feature flags crate.
Ran Ruff lint, Ruff formatting, hogli ci:preflight --fix, and the repository-wide mypy check.
A static parity check matched all 24 Python SDK names against Rust Library::as_str() values.
Database-backed coverage could not run because the local Postgres hostname was unavailable.
Updated the affected query snapshots mechanically.

Automatic notifications

Publish to changelog?

Docs update

None. This adds internal usage-report and feature flag analytics classification.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Skills: writing-tests, writing-dataclasses, writing-code-comments, writing-pr-descriptions, writing-ui-components, debugging-ci-failures, fixing-flaky-tests, and running-ci-preflight.

Pi implemented and validated the change under human direction. No customer or private source material was used.

trunk-io · 2026-09-03T06:32:36Z

😎 Merged successfully - details.

github-actions · 2026-09-03T06:34:43Z

🤖 CI report

⚠️

Trunk lane — backend Python lane

This PR is assigned to the backend Python lane. It runs backend Python tests and may merge in parallel with PRs in other lanes.

✅ Complexity (TypeScript) — clean

Cyclomatic complexity above the limit in changed typescript files (10 for production files, 15 for test files). Warn only: worth simplifying when you next touch these functions.

⚠️

Bundle size — 🔺 +19 B (+0.0%)

Uncompressed size of every built .js bundle, compared against the base branch.

Total: 68.38 MiB · 🔺 +19 B (+0.0%)

No file changed by more than 1000 B.

_{Posted automatically by build-bundle-size-report · uncompressed bytes from dist-report}

✅ Eager graph — within budget

How much code each root ships on the eager path — downloaded and parsed before the surface is interactive. Measured from the esbuild output chunks (post-tree-shake, static imports only); lazy import() / React.lazy chunks are not counted.

Root	Eager (shipped)	Δ vs base	Budget
entry (logged-out pages, app bootstrap) `src/index.tsx`	1.45 MiB · 22 files	no change	`███░░░░░░░` 32.3% of 4.51 MiB
authenticated shell (every logged-in page) `src/scenes/AuthenticatedShell.tsx`	8.88 MiB · 3,265 files	no change	`█████████░` 91.4% of 9.71 MiB

🟢 node_modules/monaco-editor/ stays out of src/index.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/index.tsx
🟢 [object Object] stays out of src/index.tsx
🟢 [object Object] stays out of src/index.tsx
🟢 node_modules/monaco-editor/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/scenes/AuthenticatedShell.tsx
🟢 [object Object] stays out of src/scenes/AuthenticatedShell.tsx
🟢 [object Object] stays out of src/scenes/AuthenticatedShell.tsx

Largest files eagerly shipped from src/index.tsx

Size	File
126.8 KiB	`../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js`
24.6 KiB	`../node_modules/.pnpm/buffer@6.0.3/node_modules/buffer/index.js`
6.3 KiB	`../node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react.production.min.js`
4.5 KiB	`../node_modules/.pnpm/@jspm+core@2.1.0/node_modules/@jspm/core/nodelibs/browser/process.js`
3.9 KiB	`../node_modules/.pnpm/scheduler@0.23.2/node_modules/scheduler/cjs/scheduler.production.min.js`
1.4 KiB	`../node_modules/.pnpm/base64-js@1.5.1/node_modules/base64-js/index.js`
1.3 KiB	`src/RootErrorBoundary.tsx`
912 B	`../node_modules/.pnpm/ieee754@1.2.1/node_modules/ieee754/index.js`
789 B	`src/scenes/ChunkLoadErrorBoundary.tsx`
762 B	`src/index.tsx`

Largest files eagerly shipped from src/scenes/AuthenticatedShell.tsx

Size	File
307.0 KiB	`../node_modules/.pnpm/posthog-js@1.422.5_@types+react@18.3.27_react@18.3.1/node_modules/posthog-js/dist/rrweb.js`
267.7 KiB	`../node_modules/.pnpm/@posthog+icons@0.38.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js`
263.5 KiB	`../node_modules/.pnpm/posthog-js@1.422.5_@types+react@18.3.27_react@18.3.1/node_modules/posthog-js/dist/module.js`
255.1 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
154.2 KiB	`../node_modules/.pnpm/re2js@0.4.1/node_modules/re2js/build/index.esm.js`
126.8 KiB	`../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.production.min.js`
104.5 KiB	`src/lib/api.ts`
95.8 KiB	`../packages/quill/packages/quill/dist/index.js`
93.3 KiB	`../node_modules/.pnpm/prosemirror-view@1.40.1/node_modules/prosemirror-view/dist/index.js`
90.6 KiB	`../node_modules/.pnpm/@tiptap+core@3.20.6_@tiptap+pm@3.20.6/node_modules/@tiptap/core/dist/index.js`

_{Posted automatically by check-eager-graph · sizes are eager output bytes (shipped, post-tree-shake) from the esbuild metafile · part of #32479}

✅ Toolbar bundle — eager 2.27 MiB within budget

What the toolbar ships to customer pages, measured from the esbuild output (minified, post-tree-shake). The eager set is the entry plus everything statically imported from it — fetched before any feature runs; deferred chunks load lazily. The eager guardrail is 5.72 MiB. Each output file must also stay below 10 MB, where CloudFront stops compressing it. The module boundary is enforced separately by check-toolbar-graph.

Metric	Size	Δ vs base	Budget
Eager (shipped) entry + static imports	2.27 MiB · 18 files	no change	`████░░░░░░` 39.6% of 5.72 MiB
Deferred (lazy)	2.11 MiB · 45 files	no change	n/a — loads on demand
Loader `dist/toolbar.js`	1.1 KiB	no change	`█░░░░░░░░░` 5.8% of 19.5 KiB

Largest eagerly-shipped chunks

Size	File
754.1 KiB	`dist/toolbar/toolbar-app-YBL7L6MV.css`
590.5 KiB	`dist/toolbar/chunk-chunk-CQHMOG33.js`
484.7 KiB	`dist/toolbar/chunk-chunk-RFL5H2T4.js`
135.6 KiB	`dist/toolbar/chunk-chunk-XEL6EY25.js`
131.8 KiB	`dist/toolbar/chunk-chunk-FDH2IBXT.js`
71.3 KiB	`dist/toolbar/toolbar-app-BFD7RWNC.js`
69.0 KiB	`dist/toolbar/chunk-chunk-TSAL54PB.js`
35.6 KiB	`dist/toolbar/chunk-chunk-SGFE3VEH.js`
21.0 KiB	`dist/toolbar/chunk-chunk-7WCJ3CHT.js`
6.8 KiB	`dist/toolbar/chunk-chunk-DV7IWQNF.js`

_{Posted automatically by check-toolbar-size · sizes are toolbar output bytes (shipped, post-tree-shake) from the esbuild metafile}

✅ Dist folder size — 🔺 +205 B (+0.0%)

Total size of the built frontend/dist folder (all assets), compared against the base branch.

Total: 1459.57 MiB · 🔺 +205 B (+0.0%)

⚠️

Playwright — 1 flaky

🎭 Playwright report · View test results →

⚠️ 1 flaky test:

Can create a new dashboard with an insight (chromium)

These issues are not necessarily caused by your changes.
Annoyed by this section? Help fix flakies and failures and it will go green!

greptile-apps · 2026-09-03T06:36:26Z

_{Reviews (1): Last reviewed commit: "feat(sdk): add KMP usage reporting" | Re-trigger Greptile}

trunk-io · 2026-09-03T06:51:19Z

Failed Test	Failure Summary	Logs
`edits and deletes a check from Data Ops`	The test failed because an expected element was not visible or could not be found within the timeout period.	Logs ↗︎

_{View Full Report ↗︎ ⋅ Docs}

marandaneto · 2026-09-03T07:14:17Z

needs PostHog/posthog-python#917 but not a blocker, metrics will be zeroed until merged and thats fine

pawel-cebula

Usage report side looks good - haven't reviewed the flags part.

github-actions · 2026-09-03T12:20:07Z

🦔 Hogbox preview · ❌ build failed

The preview didn't come up for commit ba1e5aa. See the build log for the failing step. It'll retry on the next push.

_{Previews are optional and never block merging. A failure here is often a hogland or tailnet hiccup rather than anything in your PR, so the check stays green and this comment is the status.}

marandaneto · 2026-09-03T13:12:54Z

+        jest.useFakeTimers()
+        try {
+            jest.setSystemTime(new Date('2026-08-28T12:00:00Z'))
+            logic.actions.loadScoutRunsSuccess([
+                makeRun({ skill_name: 'signals-scout-busy', emitted_report_ids: ['r-1'] }),
+            ])
+        } finally {
+            jest.useRealTimers()
+        }


not related but its flaky in this pr

dustinbyrne

seems likely that SDK health (formerly SDK doctor) would need updating as well

arnohillen · 2026-09-03T23:28:11Z

posthog/tasks/usage_report.py:958 adds posthog-node-mcp but has no posthog-python-mcp entry, while PostHog/posthog-python#917 sends exactly that $lib from posthog/mcp/constants.py:36, so once both land MCP-instrumented Python events drop out of the per-SDK breakdown instead of counting as python_events.

# Conflicts: # products/product_analytics/frontend/insights/trends/shared/magnitudeAxisIds.ts # products/signals/frontend/inbox/logics/scoutFleetLogic.test.ts

marandaneto · 2026-09-04T07:10:36Z

seems likely that SDK health (formerly SDK doctor) would need updating as well

can do a follow up

marandaneto · 2026-09-04T07:38:40Z

Fixed in 0e60ae2. Python MCP now has a dedicated usage metric in both report paths and stays separate from Python SDK usage.

marandaneto · 2026-09-04T07:45:37Z

Updated in 33418fe. Both posthog-dotnet and posthog-aspnetcore with $ai_lib = posthog-ai now sum into posthog_dotnet_ai_events_count_in_period.

deployment-status-posthog · 2026-09-04T14:39:14Z

Deploy status

Environment	Status	Deployed At	Workflow
dev	✅ Deployed	2026-09-04 14:39 UTC	Run
prod-us	✅ Deployed	2026-09-04 14:57 UTC	Run
prod-eu	✅ Deployed	2026-09-04 14:57 UTC	Run

feat(sdk): add KMP usage reporting

52012c5

marandaneto self-assigned this Sep 3, 2026

marandaneto marked this pull request as ready for review September 3, 2026 06:33

marandaneto requested review from a team September 3, 2026 06:33

feat(sdk): track Node MCP usage separately

5772a32

marandaneto changed the title ~~feat(sdk): add KMP usage reporting~~ feat(sdk): add KMP and Node MCP usage reporting Sep 3, 2026

feat(sdk): add OpenCode usage reporting

c7d0d5c

marandaneto changed the title ~~feat(sdk): add KMP and Node MCP usage reporting~~ feat(sdk): add KMP, Node MCP, and OpenCode usage reporting Sep 3, 2026

marandaneto added 2 commits September 3, 2026 09:09

feat(sdk): separate Python AI usage reporting

e105ea1

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

ed45279

marandaneto mentioned this pull request Sep 3, 2026

feat: identify MCP and AI analytics events by library PostHog/posthog-python#917

Merged

5 tasks

marandaneto changed the title ~~feat(sdk): add KMP, Node MCP, and OpenCode usage reporting~~ feat(sdk): add KMP, Node MCP, OpenCode, and Python AI reporting Sep 3, 2026

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

af6a172

marandaneto mentioned this pull request Sep 3, 2026

fix(rails): attribute events and requests to posthog-rails PostHog/posthog-ruby#265

Merged

5 tasks

ioannisj approved these changes Sep 3, 2026

View reviewed changes

feat(sdk): expand .NET and Ruby usage reporting

aed6e8e

marandaneto changed the title ~~feat(sdk): add KMP, Node MCP, OpenCode, and Python AI reporting~~ feat(sdk): add SDK aliases and separate AI usage metrics Sep 3, 2026

marandaneto added 6 commits September 3, 2026 11:11

fix(sdk): align MCP usage test with deduplication

bbac022

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

6029932

fix(flags): classify all SDK library identifiers

2e76adb

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

c9837bd

fix(flags): limit SDK classification to request identities

bd7dc1f

fix(flags): retain Rails request classification

d4508e9

pawel-cebula approved these changes Sep 3, 2026

View reviewed changes

marandaneto added 3 commits September 3, 2026 14:07

fix(flags): restore Python MCP request classification

cbe20b2

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

86eda53

fix(insights): satisfy strict axis ID indexing

b6d54c7

github-actions Bot had a problem deploying to preview-pr-93911 September 3, 2026 12:20 Failure

marandaneto requested a review from a team September 3, 2026 12:23

posthog-project-board-bot Bot added this to Feature Flags Sep 3, 2026

posthog-project-board-bot Bot moved this to In Review in Feature Flags Sep 3, 2026

github-project-automation Bot moved this from In Review to Approved in Feature Flags Sep 3, 2026

fix(signals): freeze scout roster test time

ba1e5aa

github-actions Bot had a problem deploying to preview-pr-93911 September 3, 2026 12:39 Failure

marandaneto commented Sep 3, 2026

View reviewed changes

turnipdabeets approved these changes Sep 3, 2026

View reviewed changes

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

13c6458

dustinbyrne reviewed Sep 3, 2026

View reviewed changes

Merge remote-tracking branch 'origin/master' into sdk/kmp-usage-report

0d3f812

# Conflicts: # products/product_analytics/frontend/insights/trends/shared/magnitudeAxisIds.ts # products/signals/frontend/inbox/logics/scoutFleetLogic.test.ts

feat(sdk): add Python MCP usage metric

0e60ae2

fix(sdk): count ASP.NET Core AI usage as .NET

33418fe

trunk-io Bot merged commit b36fc48 into master Sep 4, 2026
263 of 267 checks passed

trunk-io Bot deleted the sdk/kmp-usage-report branch September 4, 2026 14:09

github-project-automation Bot moved this from Approved to Done in Feature Flags Sep 4, 2026

webjunkie mentioned this pull request Sep 4, 2026

chore(devex): route queue triage at Trunk's own reasons #95249

Merged

1 task

This was referenced Sep 5, 2026

fix(mcp): report the Python package version PostHog/posthog-python#921

Open

feat(sdk-health): support missing SDK identities #95562

Open

Uh oh!

Conversation

marandaneto commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Changes

How did you test this code?

Automatic notifications

Docs update

🤖 Agent context

Uh oh!

trunk-io Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 CI report

Uh oh!

greptile-apps Bot commented Sep 3, 2026

Uh oh!

trunk-io Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

marandaneto commented Sep 3, 2026

Uh oh!

pawel-cebula left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦔 Hogbox preview · ❌ build failed

Uh oh!

marandaneto Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

dustinbyrne left a comment

Choose a reason for hiding this comment

Uh oh!

arnohillen commented Sep 3, 2026

Uh oh!

marandaneto commented Sep 4, 2026

Uh oh!

marandaneto commented Sep 4, 2026

Uh oh!

marandaneto commented Sep 4, 2026

Uh oh!

Uh oh!

deployment-status-posthog Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy status

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

marandaneto commented Sep 3, 2026 •

edited

Loading

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

trunk-io Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

deployment-status-posthog Bot commented Sep 4, 2026 •

edited

Loading