posthog-prod-checklist

Original：🇺🇸 English

Translated

Execute PostHog production deployment checklist and rollback procedures. Use when deploying PostHog integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "posthog production", "deploy posthog", "posthog go-live", "posthog launch checklist".

2installs

Sourcejeremylongshore/claude-code-plugins-plus-skills

Added on2026-03-06

NPX Install

npx skill4agent add jeremylongshore/claude-code-plugins-plus-skills posthog-prod-checklist

SKILL.md Content

View Translation Comparison →

PostHog Production Checklist

Overview

Complete checklist for deploying PostHog integrations to production.

Prerequisites

Staging environment tested and verified
Production API keys available
Deployment pipeline configured
Monitoring and alerting ready

Instructions

Step 1: Pre-Deployment Configuration

Production API keys in secure vault
Environment variables set in deployment platform
API key scopes are minimal (least privilege)
Webhook endpoints configured with HTTPS
Webhook secrets stored securely

Step 2: Code Quality Verification

All tests passing (
```
npm test
```
)
No hardcoded credentials
Error handling covers all PostHog error types
Rate limiting/backoff implemented
Logging is production-appropriate

Step 3: Infrastructure Setup

Health check endpoint includes PostHog connectivity
Monitoring/alerting configured
Circuit breaker pattern implemented
Graceful degradation configured

Step 4: Documentation Requirements

Incident runbook created
Key rotation procedure documented
Rollback procedure documented
On-call escalation path defined

Step 5: Deploy with Gradual Rollout

bash

# Pre-flight checks
curl -f https://staging.example.com/health
curl -s https://status.posthog.com

# Gradual rollout - start with canary (10%)
kubectl apply -f k8s/production.yaml
kubectl set image deployment/posthog-integration app=image:new --record
kubectl rollout pause deployment/posthog-integration

# Monitor canary traffic for 10 minutes
sleep 600
# Check error rates and latency before continuing

# If healthy, continue rollout to 50%
kubectl rollout resume deployment/posthog-integration
kubectl rollout pause deployment/posthog-integration
sleep 300

# Complete rollout to 100%
kubectl rollout resume deployment/posthog-integration
kubectl rollout status deployment/posthog-integration

Output

Deployed PostHog integration
Health checks passing
Monitoring active
Rollback procedure documented

Error Handling

Alert	Condition	Severity
API Down	5xx errors > 10/min	P1
High Latency	p99 > 5000ms	P2
Rate Limited	429 errors > 5/min	P2
Auth Failures	401/403 errors > 0	P1

Examples

Health Check Implementation

typescript

async function healthCheck(): Promise<{ status: string; posthog: any }> {
  const start = Date.now();
  try {
    await posthogClient.ping();
    return { status: 'healthy', posthog: { connected: true, latencyMs: Date.now() - start } };
  } catch (error) {
    return { status: 'degraded', posthog: { connected: false, latencyMs: Date.now() - start } };
  }
}

Immediate Rollback