mcpField
L
logs-nextjs

logs-nextjs

github.com/posthogDevelopment76119 installsUpdated today
Repository

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

  1. 01Next.js log ingestion setup guidance
  2. 02OTLP exporter configuration for PostHog
  3. 03Structured logging recommendations
  4. 04Troubleshooting and session replay references

Use cases

  1. 01Adding PostHog export alongside existing logs
  2. 02Configuring an OTLP exporter for a Next.js app
  3. 03Investigating log ingestion issues

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/posthog/skills --skill logs-nextjs

After installing, type/logs-nextjsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
best-practices.md
debug-logs-mcp.md
link-session-replay.md
nextjs.md
search.md
start-here.md
troubleshooting.md

Details

From the project README

PostHog 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 - docs
  • references/start-here.md - Getting started with logs - docs
  • references/search.md - Search logs - docs
  • references/best-practices.md - Logging best practices - docs
  • references/troubleshooting.md - Logs troubleshooting - docs
  • references/link-session-replay.md - Link session replay - docs
  • references/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