posthog-pipeline-diagnosis

Diagnose PostHog CDP pipeline and function failures blocking event delivery.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify why PostHog CDP functions or pipelines fail to deliver events to destinations, produce transformation errors, or exhibit unexpected routing behavior so engineers can quickly prioritize fixes and communicate accurate root causes.

Core Features & Use Cases

  • Function discovery: Locate the relevant CDP function by name, destination type, and project association.
  • Execution and error analysis: Inspect enabled/disabled state, recent invocations, error rates, and log messages to surface authentication failures, payload validation errors, timeouts, or transformation bugs.
  • Trigger and filter validation: Verify event triggers, filter conditions, and project attachment to explain why events may not be routed or processed.
  • Destination investigation: Check destination credentials, endpoints, payload formats, and rate limiting or ingestion rejections when the function executes but downstream systems show no data.
  • Operational use case: Triage a customer report where a CDP function appears to run but the third-party destination receives no records and produce a prioritized remediation checklist.

Quick Start

Diagnose a CDP function for project "acme" that is executing but not delivering events to the Segment destination and produce a prioritized list of probable causes, evidence to gather, and remediation steps.

Frequently Asked Questions about posthog-pipeline-diagnosis

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

FAQPage Schema
Why does my PostHog CDP function execute but events never reach the downstream destination?

PostHog CDP function execution failures occur when destination credentials are invalid, payload formats are rejected, or rate limits are exceeded. Diagnosing these pipeline issues requires inspecting recent execution logs, destination error responses, and authentication configurations to identify the exact rejection cause.

How do I diagnose a PostHog pipeline transformation error where events are modified incorrectly?

To diagnose PostHog pipeline transformation errors, you must analyze the CDP function's transformation logic against recent execution logs. This surfaces payload validation errors and transformation bugs by comparing the expected output with the actual processed event data and log messages.

What is the best way to troubleshoot missing events in a PostHog CDP pipeline integration?

Troubleshooting missing events in a PostHog CDP pipeline requires validating event triggers, filter conditions, and project attachments. Checking whether the CDP function is enabled and reviewing invocation logs confirms if events are correctly routed or silently dropped before reaching the destination.

Can I check if a PostHog function is disabled or failing by only looking at execution logs?

Checking PostHog function execution logs reveals error rates, timeouts, and authentication failures, but does not show the enabled or disabled state. You must also inspect the function configuration and project attachment settings to fully understand why events are not being processed.

How do I fix payload validation errors when sending transformed events from PostHog to a third-party destination?

Fixing payload validation errors involves checking the destination endpoint requirements against the PostHog function's transformation logic. Inspecting destination error responses and execution logs identifies which payload fields are rejected, allowing you to adjust the formatting or mapping accordingly.

What credentials and configuration access do I need to diagnose a PostHog pipeline issue?

Diagnosing a PostHog pipeline issue requires access to the CDP function configuration, recent execution logs, and destination error responses. You also need repository issue search access to analyze authentication failures, payload validation errors, and rate limiting behaviors effectively.