posthog-error-tracking-diagnosis

Diagnose PostHog error tracking issues by analyzing exception events and documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mongo-ai/posthog-triage-agent --skill posthog-error-tracking-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: posthog-error-tracking-diagnosis
Source: https://github.com/mongo-ai/posthog-triage-agent/tree/main/.claude/skills/posthog-error-tracking-diagnosis
Command: npx skills add https://github.com/mongo-ai/posthog-triage-agent --skill posthog-error-tracking-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams pinpoint why PostHog error tracking data is missing, malformed, or incorrectly grouped, covering missing exceptions, bad stack traces, source‑map mismatches, and release or environment inconsistencies.

Core Features & Use Cases

  • Live documentation lookup to guide setup and troubleshooting steps.
  • SQL queries to fetch recent exception events from PostHog.
  • Source‑map verification ensuring uploaded maps match deployed bundles.
  • Release and environment context checks to detect version mismatches.
  • GitHub issue search for known SDK bugs related to the symptom.
  • Used by support engineers, DevOps, and developers when error tracking data appears unreliable or unreadable.

Quick Start

Ask the agent to diagnose my PostHog error tracking problem using the provided symptom description.

Frequently Asked Questions about posthog-error-tracking-diagnosis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my PostHog exception events missing or not showing up in error tracking?

Missing PostHog exception events usually stem from SDK initialization errors, release environment mismatches, or incorrect event filtering. Diagnosing the problem requires querying recent exception events via SQL and verifying your release and environment contexts to detect version inconsistencies causing data ingestion failures.

How do I fix minified stack traces in PostHog error tracking?

Minified stack traces in PostHog error tracking occur when source maps are missing, mismatched, or incorrectly uploaded. Resolving this involves verifying that uploaded source maps exactly match your deployed bundles and checking release version configurations to ensure proper symbolication.

What causes PostHog error tracking to incorrectly group exceptions together?

Incorrect exception grouping in PostHog error tracking is frequently caused by release version mismatches or inconsistent environment contexts. Identifying the root issue requires analyzing exception events and checking release configurations to ensure proper fingerprinting and grouping logic.

How do I verify if a PostHog source map matches my deployed bundle?

Verifying PostHog source map matches involves checking that the uploaded map corresponds exactly to the deployed JavaScript bundle. The diagnosis process applies source-map verification steps and cross-references release versions to ensure stack trace symbolication works correctly.

Can I check known GitHub issues for PostHog SDK bugs affecting error tracking?

Searching GitHub issue repositories for known PostHog SDK bugs related to your specific symptoms is a core diagnostic step. This helps identify if missing exceptions or malformed stack traces are caused by documented bugs in the SDK version you are using.

What do I need to diagnose unreliable PostHog error tracking data?

Diagnosing unreliable PostHog error tracking data requires access to PostHog event data for SQL queries, documentation search for setup guidance, and GitHub issue repositories to check for known SDK bugs. This combination provides concrete remediation steps for missing or malformed exceptions.