mcpField
L
logs-nodejs

logs-nodejs

github.com/posthogCloud & DevOps76116 installsUpdated today
Repository

About logs-nodejs

A skill for adding PostHog log ingestion to Node.js applications. It guides developers through OTLP configuration and structured logging while preserving existing logging code.

Key features

  1. 01Configure an OTLP exporter for PostHog
  2. 02Use environment variables for keys and endpoints
  3. 03Add export without replacing existing logging
  4. 04Prefer structured key-value logs
  5. 05Consult installation, search, and troubleshooting docs

Use cases

  1. 01Add PostHog log ingestion to a Node.js app
  2. 02Configure OpenTelemetry log export
  3. 03Search or troubleshoot ingested logs

MCP support

The reference list includes documentation for debugging logs with MCP.

Install

Copy the command and run it in a terminal.

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

After installing, type/logs-nodejsin 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
nodejs.md
search.md
start-here.md
troubleshooting.md

Details

From the project README

PostHog logs for Node.js

This skill helps you add PostHog log ingestion to Node.js applications.

Reference files

  • references/nodejs.md - Node.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

No specific framework guidelines.

Comments

Markdown supported