Skip to content

Add Application metrics changelog and tool listing for alpha product - #20012

Open
DanielVisca wants to merge 2 commits into
masterfrom
posthog/app-metrics-changelog-and-tool
Open

DanielVisca wants to merge 2 commits into
masterfrom
posthog/app-metrics-changelog-and-tool

Conversation

@DanielVisca

@DanielVisca DanielVisca commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Changes

Application metrics is in public alpha with self-serve signup. The docs existed but still described it as a private, gated alpha, and the product was not reflected anywhere people browse products or follow updates. This wires up the in-repo pieces and corrects the alpha wording:

  • Alpha wording — update 11 docs pages from "private alpha… only turned on for selected teams" to "public alpha and available to everyone"
  • Changelog page — add contents/docs/metrics/changelog.mdx rendering <ProductChangelog product="Metrics" />
  • Changelog filter — add a metrics entry to productConfigMap (topic metrics, team apm) so the page filters the changelog feed instead of rendering the whole company changelog
  • Docs nav — link the changelog from the metrics docs section
  • Tool listing — add a metrics entry in src/data/tools.ts with an alpha status badge so it surfaces in product/tool listings

Why: the docs for application metrics existed but mislabeled the release as a private, invite-only alpha, and the product had no changelog surface or presence in product/tool listings — so people could not tell it is open to everyone or follow its updates.

Tests pin all of the above (red-green), including a wording test that fails if any metrics doc reintroduces "private alpha" / "selected teams". check-product-changelogs now covers 16 pages and all nav tests pass.

Note: the public roadmap item lives in Strapi and is created on the site, not in this repo, so it is out of scope here.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json (no pages moved)

Created with PostHog Desktop

Application metrics is in private alpha with docs and alpha callouts already in place, but it was not reflected anywhere people browse products or follow product updates. This wires up the pieces that live in the repo:

- Add contents/docs/metrics/changelog.mdx rendering ProductChangelog for "Metrics"
- Add a `metrics` entry to productConfigMap (topic `metrics`, team `apm`) so the page filters the changelog feed instead of rendering the whole company changelog
- Link the changelog from the metrics docs nav
- Add a `metrics` tool entry in src/data/tools.ts with an `alpha` status badge so it surfaces in product/tool listings

Tests pin all of the above (red-green); check-product-changelogs now covers 16 pages. The roadmap item itself lives in Strapi and is created on the site, not in this repo.

Generated-By: PostHog Desktop
Task-Id: 958aa28e-0734-48d8-bb19-92b20afd667f
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Sep 08, 2026 07:02PM

…eams

Metrics is in public alpha with self-serve signup, but the docs still said "private alpha" and "the viewer is only turned on for selected teams" across 11 pages. Update both callout styles to say metrics is in public alpha and available to everyone, and add a test that pins the wording so it does not regress.

Generated-By: PostHog Desktop
Task-Id: 958aa28e-0734-48d8-bb19-92b20afd667f
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Vale prose linter → found 19 errors, 61 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/metrics/architecture.mdx — 0 errors, 7 warnings, 0 suggestions
Line Severity Message Rule
11:294 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
15:64 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
28:111 warning 'chartable' is a possible misspelling. PostHogBase.Spelling
28:325 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
30:21 warning 'temporality' is a possible misspelling. PostHogBase.Spelling
36:89 warning 'temporality' is a possible misspelling. PostHogBase.Spelling
37:164 warning 'quantile' is a possible misspelling. PostHogBase.Spelling
contents/docs/metrics/explore.mdx — 14 errors, 9 warnings, 0 suggestions
Line Severity Message Rule
9:16 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
10:14 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
10:64 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
11:11 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
27:29 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
33:20 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
34:22 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
35:20 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
39:348 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
41:82 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
43:16 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
45:39 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
47:24 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
48:15 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
49:15 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
49:47 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
53:30 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
53:65 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
53:101 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
53:141 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
71:68 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
75:172 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
88:32 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
contents/docs/metrics/index.mdx — 2 errors, 17 warnings, 0 suggestions
Line Severity Message Rule
11:180 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
13:113 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
19:206 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
21:4 warning 'Already have PostHog installed? Use posthog.metrics' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
21:40 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
23:5 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
23:190 warning Use 'project token' instead of 'project API key'. The project token (phc_) is not an API key. PostHogBase.ProjectToken
36:91 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
60:48 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
62:4 warning 'Set up metrics with OpenTelemetry' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
72:5 warning '2. Point your OTLP metrics exporter at PostHog' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
156:5 warning 'Already running an OpenTelemetry Collector?' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
176:47 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
176:300 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
195:30 warning 'quantiles' is a possible misspelling. PostHogBase.Spelling
214:120 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
214:259 warning Use the Oxford comma before 'and' or 'or' in a list of three or more items. PostHogBase.OxfordComma
214:359 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
229:6 warning Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. PostHogBase.ProductNames
contents/docs/metrics/installation/docker.mdx — 0 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
12:62 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
92:49 warning 'unsharded' is a possible misspelling. PostHogBase.Spelling
114:99 warning 'stdout' is a possible misspelling. PostHogBase.Spelling
contents/docs/metrics/installation/index.mdx — 0 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
11:76 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
19:89 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
20:89 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
21:89 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
contents/docs/metrics/installation/javascript.mdx — 0 errors, 5 warnings, 0 suggestions
Line Severity Message Rule
3:15 warning Use 'JavaScript' instead of 'javascript'. Vale.Terms
12:5 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
18:34 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
20:177 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
55:206 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
contents/docs/metrics/installation/kubernetes.mdx — 0 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
3:15 warning Use 'Kubernetes' instead of 'kubernetes'. Vale.Terms
12:74 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
117:38 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
182:74 warning 'tolerations' is a possible misspelling. PostHogBase.Spelling
contents/docs/metrics/installation/nodejs.mdx — 0 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
3:15 warning 'nodejs' is a possible misspelling. PostHogBase.Spelling
12:6 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
12:152 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
28:59 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
contents/docs/metrics/installation/other.mdx — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
47:64 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
contents/docs/metrics/installation/python.mdx — 0 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
12:6 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
12:156 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
28:59 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
contents/docs/metrics/start-here.mdx — 3 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
25:5 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
66:156 warning Avoid trivializing words. 'easy to' can sound dismissive to the reader. PostHogDocs.Trivializers
80:87 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
106:35 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
109:83 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
123:33 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
123:68 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames

@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

8.85 MiB (+0.2 KiB / +0.0%)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
app 18.44 MiB (+2.0 KiB / +0.0%) report-only 2052
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1097.0 KiB
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 757.9 KiB
./src/components/Stickers/Stickers.tsx 696.4 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/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/x-ray.mjs 480.8 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+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs 385.7 KiB
./src/hooks/useCustomers.tsx + 55 modules 370.0 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
./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
./src/components/ProductComparisonTable/index.tsx + 126 modules 302.5 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/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs 281.7 KiB
./node_modules/.pnpm/@posthog+brand@0.8.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/director.mjs 275.6 KiB
./src/components/SearchUI/index.tsx + 87 modules 273.0 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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@DanielVisca
DanielVisca marked this pull request as ready for review September 8, 2026 20:50
@github-actions

Copy link
Copy Markdown
Contributor

This PR hasn't seen activity in two weeks! Should it be merged, closed, or further worked on? If you want to keep it open, please remove the stale label – otherwise this will be closed in another week. If you want to permanently keep it open, use the waiting label.

@github-actions github-actions Bot added the stale This pull request has been marked as stale and will be closed soon automatically label Sep 23, 2026

This branch has not been deployed

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

Labels

stale This pull request has been marked as stale and will be closed soon automatically

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

1 participant