About logs-nextjs
logs-nextjs is a skill for adding PostHog log ingestion to Next.js applications. It guides setup through OpenTelemetry and covers structured logging, troubleshooting, and related documentation.
Key features
- 01Next.js log ingestion setup guidance
- 02OTLP exporter configuration for PostHog
- 03Structured logging recommendations
- 04Troubleshooting and session replay references
Use cases
- 01Adding PostHog export alongside existing logs
- 02Configuring an OTLP exporter for a Next.js app
- 03Investigating log ingestion issues
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ posthog/ skills --skill logs-nextjsAfter installing, type/logs-nextjsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/best-practices.mddebug-logs-mcp.mdlink-session-replay.mdnextjs.mdsearch.mdstart-here.mdtroubleshooting.mdDetails
From the project READMEPostHog logs for Next.js
This skill helps you add PostHog log ingestion to Next.js applications.
Reference files
references/nextjs.md- Next.js logs installation - docsreferences/start-here.md- Getting started with logs - docsreferences/search.md- Search logs - docsreferences/best-practices.md- Logging best practices - docsreferences/troubleshooting.md- Logs troubleshooting - docsreferences/link-session-replay.md- Link session replay - docsreferences/debug-logs-mcp.md- Debug logs with mcp - docs
Consult the documentation for API details and framework-specific patterns.
Key principles
- Environment variables: Always use environment variables for PostHog keys and OpenTelemetry endpoints. Never hardcode them.
- Minimal changes: Add log export alongside existing logging. Don't replace or restructure existing logging code.
- OpenTelemetry: PostHog logs use the OpenTelemetry protocol. Configure an OTLP exporter pointed at PostHog's ingest endpoint.
- Structured logging: Prefer structured log formats with key-value properties over plain text messages.
Framework guidelines
- For Next.js 15.3+, initialize PostHog in instrumentation-client.ts for the simplest setup
Comments
Markdown supported