Skip to main content Accueil Créateurs jeremylongshore tons-of-skills-marketplace posthog-prod-checklist
posthog-prod-checklist Production readiness checklist for PostHog integrations: SDK configuration,
graceful degradation, health checks, shutdown hooks, and rollback procedures.
Trigger: "posthog production", "deploy posthog", "posthog go-live",
"posthog launch checklist", "posthog production ready".
Aller à l'installation Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill posthog-prod-checklistLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Plus depuis ce dépôt langchain-deploy-integration Deploy a LangChain 1.0 / LangGraph 1.0 app to Cloud Run, Vercel, or LangServe correctly — with timeouts sized for chain length, cold-start mitigation, SSE anti-buffering headers, and Secret Manager over .env. Use when prepping a first production deploy, debugging a stream that hangs behind a proxy, or diagnosing p99 latency spikes. Trigger with "langchain deploy", "langchain cloud run", "langchain vercel python", "langchain langserve", or "langchain docker".
langchain-langgraph-agents Build a correct LangGraph 1.0 ReAct agent with create_react_agent — typed tools, error propagation, recursion caps, and stop conditions that actually stop. Use when writing a first tool-calling agent, migrating from AgentExecutor or initialize_agent, or diagnosing an agent that loops on vague prompts. Trigger with "langgraph agent", "create_react_agent", "langgraph tool calling", "AgentExecutor migration", or "agent loop cost".
langchain-langgraph-human-in-loop Build LangGraph 1.0 human-in-the-loop approval flows with interrupt_before /
interrupt_after and Command(resume=...) — JSON-serializable state, clean
resume semantics, and UI wiring for approval decisions. Use when adding an
approval gate before an expensive tool call, wiring a Slack/web UI for agent
approvals, or debugging a graph that crashes on interrupt.
Trigger with "langgraph human in loop", "langgraph interrupt_before",
"langgraph approval flow", "Command resume", "langgraph HITL".
name posthog-prod-checklist description Production readiness checklist for PostHog integrations: SDK configuration,
graceful degradation, health checks, shutdown hooks, and rollback procedures.
Trigger: "posthog production", "deploy posthog", "posthog go-live",
"posthog launch checklist", "posthog production ready".
allowed-tools Read, Bash(kubectl:*), Bash(curl:*), Grep version 1.12.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","posthog","deployment"] compatibility Designed for Claude Code
PostHog Production Checklist
Overview
Production readiness verification for PostHog integrations. Covers SDK configuration hardening, graceful degradation when PostHog is unavailable, health check endpoints, proper shutdown hooks for serverless, and rollback procedures.
Prerequisites
PostHog integration tested in staging
Production PostHog project with phc_ key
Personal API key (phx_) for server-side features
Deployment pipeline configured
Instructions
Pre-Deployment Checklist
SDK Configuration:
Server-Side:
Security:
Step 1: Production SDK Configuration
import { PostHog } from 'posthog-node' ;
const posthog = new PostHog (process.env .NEXT_PUBLIC_POSTHOG_KEY !, {
host : process.env .POSTHOG_HOST || 'https://us.i.posthog.com' ,
personalApiKey : process.env .POSTHOG_PERSONAL_API_KEY ,
flushAt : 20 ,
flushInterval : 10000 ,
requestTimeout : 10000 ,
maxRetries : 3 ,
});
async function shutdown (await posthog.shutdown ();
process.exit (0 );
}
process.on ('SIGTERM' , shutdown);
process.on ('SIGINT' , shutdown);
Step 2: Graceful Degradation
function safeCapture (distinctId : string , event : string , properties ?: Record <string , any >try {
posthog.capture ({ distinctId, event, properties });
} catch (error) {
console .error ('[PostHog] Capture failed:' , (error as Error ).message );
}
}
async function safeGetFlag (flagKey : string , userId : string , defaultValue : boolean = false Promise <boolean > {
try {
const result = await posthog.isFeatureEnabled (flagKey, userId);
return result ?? defaultValue;
} catch (error) {
console .error ('[PostHog] Flag evaluation failed:' , (error as Error ).message );
return defaultValue;
}
}
Step 3: Health Check Endpoint
export async function GET (const checks : Record <string , { status : string ; latencyMs ?: number }> = {};
const captureStart = performance.now ();
try {
posthog.capture ({
distinctId : 'healthcheck' ,
event : '$healthcheck' ,
properties : { test : true },
});
await posthog.flush ();
checks.posthog_capture = {
status : 'ok' ,
latencyMs : Math .round (performance.now () - captureStart),
};
} catch {
checks.posthog_capture = { status : 'degraded' };
}
const flagStart = performance.now ();
try {
await posthog.getAllFlags ('healthcheck' );
checks.posthog_flags = {
status : 'ok' ,
latencyMs : Math .round (performance.now () - flagStart),
};
} catch {
checks.posthog_flags = { status : 'degraded' };
}
const overall = Object .values (checks).every (c =>status === 'ok' ) ? 'healthy' : 'degraded' ;
return Response .json ({ status : overall, checks }, { status : overall === 'healthy' ? 200 : 503 });
}
Step 4: Serverless Function Pattern
import { PostHog } from 'posthog-node' ;
export async function handler (request : Request const posthog = new PostHog (process.env .NEXT_PUBLIC_POSTHOG_KEY !, {
host : 'https://us.i.posthog.com' ,
flushAt : 1 ,
flushInterval : 0 ,
});
try {
posthog.capture ({
distinctId : getUserId (request),
event : 'api_called' ,
properties : { endpoint : new URL (request.url ).pathname },
});
const result = await doWork (request);
return Response .json (result);
} finally {
await posthog.shutdown ();
}
}
Step 5: Pre-Flight Verification set -euo pipefail
curl -sf "https://us.i.posthog.com/healthz" && echo "PostHog: OK" || echo "PostHog: UNREACHABLE"
curl -s -X POST 'https://us.i.posthog.com/capture/' \
-H 'Content-Type: application/json' \
-d "{\"api_key\":\"$NEXT_PUBLIC_POSTHOG_KEY \",\"event\":\"deploy_preflight\",\"distinct_id\":\"deploy\"}" | jq .
curl -s -X POST 'https://us.i.posthog.com/decide/?v=3' \
-H 'Content-Type: application/json' \
-d "{\"api_key\":\"$NEXT_PUBLIC_POSTHOG_KEY \",\"distinct_id\":\"deploy-check\"}" | \
jq '{flags_count: (.featureFlags | length), session_recording: (.sessionRecording != false)}'
curl -sf "https://app.posthog.com/api/projects/$POSTHOG_PROJECT_ID /" \
-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY " | jq '.name' && echo "Admin API: OK"
Error Handling Alert Trigger Severity Action PostHog capture failing Error rate > 1% P3 Check API host, verify key Flag evaluation slow p95 > 500ms P2 Enable local evaluation with personalApiKey Events not appearing Zero events for 30min P2 Check shutdown() is called, verify flush Admin API 401 Personal key rejected P1 Rotate key in PostHog settings
Rollback Procedure set -euo pipefail
kubectl set env deployment/app POSTHOG_ENABLED=false
kubectl rollout restart deployment/app
kubectl rollout undo deployment/app
kubectl rollout status deployment/app
Output
Production-hardened PostHog SDK configuration
Graceful degradation wrappers (never crash on analytics failure)
Health check endpoint verifying capture and flag evaluation
Serverless shutdown pattern
Pre-flight verification commands
Resources
Next Steps For version upgrades, see posthog-upgrade-migration.
