docs(error-tracking): add Go debug symbol upload guide by cat-ph · Pull Request #18778 · PostHog/posthog.com

cat-ph · 2026-07-21T23:38:38Z

Changes

Adds a debug symbol upload guide for Go (/docs/error-tracking/upload-source-maps/go), mirroring the Rust guide: linker flags per platform (Linux needs -ldflags=-B gobuildid for a GNU build ID; macOS needs -ldflags=-compressdwarf=false because Go compresses its embedded DWARF and never produces a dSYM), the symbol-sets upload flow, --include-source, CI usage, and end-to-end verification. Also:

Replaces the stale "symbol set uploads for Go are not currently available" callout on the Go installation page with a pointer to the new guide.
Adds Go to the upload platforms tiles and the docs nav.

Note

All the documented tooling has shipped: posthog-go 1.22.0 (PostHog/posthog-go#260, native frames + $debug_images), CLI 0.9.1 (PostHog/posthog#72776 Mach-O uploads and PostHog/posthog#72458 Go source bundling). Version requirements are pinned to those releases. This also incorporates the rust.mdx updates from #18820 with corrected version numbers (that PR cites CLI 0.8.2, which predates the feature), so #18820 can be closed.

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)

github-actions · 2026-07-21T23:39:08Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Jul 23, 2026 06:17PM

github-actions · 2026-07-21T23:40:26Z

Vale prose linter → found 8 errors, 22 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/error-tracking/installation/go.mdx — 1 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
2:11	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`
22:156	warning	'inlined' is a possible misspelling.	`PostHogBase.Spelling`
22:238	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`
22:325	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`
22:338	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
107:25	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	`PostHogBase.ProductNames`

contents/docs/error-tracking/upload-source-maps/go.mdx — 3 errors, 8 warnings, 0 suggestions

Line	Severity	Message	Rule
10:236	warning	'symbolicates' is a possible misspelling.	`PostHogBase.Spelling`
10:312	warning	'inlined' is a possible misspelling.	`PostHogBase.Spelling`
14:4	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
14:165	warning	'symbolication' is a possible misspelling.	`PostHogBase.Spelling`
37:30	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:186	warning	'symbolication' is a possible misspelling.	`PostHogBase.Spelling`
61:165	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:163	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`
94:47	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`
98:34	warning	'Dockerfile' is a possible misspelling.	`PostHogBase.Spelling`
119:33	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`

contents/docs/error-tracking/upload-source-maps/rust.mdx — 4 errors, 9 warnings, 0 suggestions

Line	Severity	Message	Rule
10:141	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:310	warning	'symbolicates' is a possible misspelling.	`PostHogBase.Spelling`
10:386	warning	'inlined' is a possible misspelling.	`PostHogBase.Spelling`
14:4	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
14:133	warning	'symbolication' is a possible misspelling.	`PostHogBase.Spelling`
42:71	warning	'inlined' is a possible misspelling.	`PostHogBase.Spelling`
46:86	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`
52:220	warning	'toolchains' is a possible misspelling.	`PostHogBase.Spelling`
52:262	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`
92:163	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`
111:47	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`
115:34	warning	'Dockerfile' is a possible misspelling.	`PostHogBase.Spelling`
130:33	warning	Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept.	`PostHogBase.ProductNames`

github-actions · 2026-07-21T23:49:41Z

Bundle report

Total JS (gzip)

6.75 MiB (+0.0 KiB / +0.0%)

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

Entrypoint	Eager size	Budget	Modules
✅ `app`	16.17 MiB (+0.2 KiB / +0.0%)	report-only	1981

Largest modules in the app closure

Module	Size
`./src/data/mcp-tools.json`	910.9 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`	739.2 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/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
`./src/hooks/useCustomers.tsx + 54 modules`	355.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.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
`./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js`	281.9 KiB
`./src/components/ProductComparisonTable/index.tsx + 120 modules`	278.6 KiB
`./src/components/SearchUI/index.tsx + 87 modules`	272.1 KiB
`./node_modules/.pnpm/framer-motion@10.18.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/dom/motion.mjs + 109 modules`	253.9 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 for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

…ust guide

cat-ph self-assigned this Jul 21, 2026

cat-ph added 2 commits July 23, 2026 21:01

docs(error-tracking): add Go debug symbol upload guide

50bdc02

docs(error-tracking): pin released versions, note Mach-O uploads in r…

3e11ff5

…ust guide

cat-ph force-pushed the cat/go-native-symbol-docs branch from ef94e5c to 3e11ff5 Compare July 23, 2026 18:02

cat-ph mentioned this pull request Jul 23, 2026

docs(error-tracking): Document Mach-O executable support for symbol uploads #18820

Closed

github-actions Bot added the docs Improvements or additions to product documentation, "Docs" label Jul 23, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(error-tracking): add Go debug symbol upload guide#18778

docs(error-tracking): add Go debug symbol upload guide#18778
cat-ph wants to merge 2 commits into
masterfrom
cat/go-native-symbol-docs

cat-ph commented Jul 21, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

cat-ph commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Checklist

Uh oh!

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

Uh oh!

Deploy preview

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Bundle report

Total JS (gzip)

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

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

cat-ph commented Jul 21, 2026 •

edited

Loading

github-actions Bot commented Jul 21, 2026 •

edited

Loading

github-actions Bot commented Jul 21, 2026 •

edited

Loading

github-actions Bot commented Jul 21, 2026 •

edited

Loading