Skip to content

docs(error-tracking): document rate limit bypass rules and MCP tools#18168

Open
inkeep[bot] wants to merge 4 commits into
masterfrom
docs-writer-ai-update-2026-07-03T13-58-25-997Z-ck1zve
Open

docs(error-tracking): document rate limit bypass rules and MCP tools#18168
inkeep[bot] wants to merge 4 commits into
masterfrom
docs-writer-ai-update-2026-07-03T13-58-25-997Z-ck1zve

Conversation

@inkeep

@inkeep inkeep Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Changes

This PR documents the rate limit bypass rules feature for error tracking, which was added in PostHog/posthog#67667.

Updates

  1. contents/docs/error-tracking/debug-errors-mcp.mdx

    • Added "Manage bypass rules" to the list of MCP capabilities
    • Added example prompts for creating and listing bypass rules
  2. contents/docs/error-tracking/rate-limiting.mdx

    • Added new "Bypass rules" section explaining how bypass rules exempt specific exceptions from rate limiting
    • Included a caution callout about billing impact from broad bypass rules
    • Added links to the configuration page and MCP docs
  3. contents/docs/data-warehouse/sources/posthog.mdx

    • Added documentation for the new system.error_tracking_bypass_rules HogQL system table

Context

Rate limit bypass rules allow users to exempt specific exceptions from both project-wide and per-issue rate limits. Matching exceptions are always ingested, even during error spikes. This is useful for critical errors that must never be dropped.

The feature can be managed via:

  • The Error Tracking configuration page in the PostHog app
  • The PostHog MCP server (for AI agents like Claude, Cursor, etc.)
  • SQL queries against the system.error_tracking_bypass_rules table

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.

inkeep Bot added 4 commits July 3, 2026 13:59
Documents the rate limit bypass rules feature from PR #67667.
Adds a new section explaining what bypass rules do, a caution
callout about billing impact, the requirement for at least one
filter condition, and where to configure them.
Reflects the new bypass rule MCP tools enabled in PR #67667.
PR #67667 added a new HogQL system table for querying rate limit
bypass rules via SQL. This documents the table columns and their
descriptions, placed alphabetically among the other system tables.
@inkeep inkeep Bot requested a review from ablaszkiewicz July 3, 2026 14:02
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jul 03, 2026 02:16PM

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Vale prose linter → found 5 errors, 37 warnings, 2 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/data-warehouse/sources/posthog.mdx — 4 errors, 36 warnings, 2 suggestions
Line Severity Message Rule
2:29 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
5:47 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
9:4 warning 'PostHog data warehouse tables' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
9:12 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
35:4 warning Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. PostHogBase.ProductNames
76:104 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
94:102 warning Capitalize 'Marketing Analytics' for PostHog's product. Use 'marketing analytics' for the general industry concept. PostHogBase.ProductNames
105:61 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
110:49 warning 'keypress' is a possible misspelling. PostHogBase.Spelling
181:129 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
181:166 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
195:39 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
195:76 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
296:66 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
302:43 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
313:85 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
330:27 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
330:72 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
330:105 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
362:51 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
383:60 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
384:77 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
457:56 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
522:280 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
522:292 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
540:44 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
563:65 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
563:72 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
564:69 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
565:69 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
569:68 warning 'traversers' is a possible misspelling. PostHogBase.Spelling
618:62 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
619:35 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
619:58 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
640:66 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
641:65 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
641:72 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
642:69 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
643:69 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
653:68 warning 'traversers' is a possible misspelling. PostHogBase.Spelling
660:67 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
662:75 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
contents/docs/error-tracking/debug-errors-mcp.mdx — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
19:41 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
contents/docs/error-tracking/rate-limiting.mdx — 1 errors, 0 warnings, 0 suggestions
Line Severity Message Rule
60:62 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

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.29 MiB (+0.0 KiB / +0.0%)

Eager graph (static-import closure per entrypoint)

Entrypoint Eager size Budget Modules
app 24.22 MiB (+1.9 KiB / +0.0%) report-only 5516
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 708.0 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules 583.6 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
./src/components/ProductComparisonTable/index.tsx + 116 modules 267.6 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
./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

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Hey @ablaszkiewicz! 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