Logs Nodejs — Agent Skill by PostHog

From the author

PostHog logs for Node.js

— the description by PostHog

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides guidance and best practices for configuring Node.js applications to export logs to PostHog. It emphasizes the use of the OpenTelemetry protocol (OTLP) to send structured logs, ensuring that system telemetry is centralized and actionable. The skill focuses on maintaining clean, high-signal logging by advocating for wide events over granular, repetitive log lines, and provides instructions on how to leverage PostHog's ecosystem for debugging and analysis.

What it does

Guides the setup of OpenTelemetry log exporters for Node.js.
Promotes structured logging patterns for better queryability.
Provides best practices for creating wide, context-rich log events.
Explains how to integrate logs with other PostHog features like session replay.
Offers troubleshooting and search strategies for production logs.
Supports AI-assisted debugging via the PostHog MCP server.

When to use it

When you need to centralize logs from Node.js services into PostHog.
When transitioning from verbose, low-value logs to structured, wide events.
When you want to correlate system logs with user sessions and product analytics.
When setting up observability for new or existing Node.js backend services.

Advantages

Centralizes logs alongside product analytics and session replays.
Reduces noise by encouraging high-signal, structured log events.
Uses industry-standard OpenTelemetry protocols.
Enables deep correlation between system behavior and user activity.

Usage examples

“How do I configure my Node.js app to send logs to PostHog using OpenTelemetry?”: The agent provides the necessary configuration steps for the OTLP exporter and explains how to point it to the PostHog ingest endpoint.
“Help me refactor my repetitive logger.info calls into a single wide event.”: The agent analyzes your current logging code and suggests a structured JSON object that captures the request context, duration, and relevant metadata in one line.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/posthog/logs-nodejs/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip logs-nodejs.zip -d .agents/skills

Documentation by PostHog

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.

Files

ATTRIBUTION.mdAdded by AutoGineer933 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md1.3 KiB
references/best-practices.md19.6 KiB
references/debug-logs-mcp.md2.2 KiB
references/link-session-replay.md4.9 KiB
references/nodejs.md3.6 KiB
references/search.md2.5 KiB
references/start-here.md2.4 KiB
references/troubleshooting.md3.5 KiB

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Anndata
K-Dense· Community
A Python framework for managing annotated data matrices in single-cell genomics and general research workflows.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k
Liteparse
K-Dense· Community
Local document and PDF parsing with spatial text extraction and bounding box support.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskHas scriptsGitHub stars of the source repository56.4k
Usfiscaldata
K-Dense· Community
Access U.S. Treasury federal financial data via the Fiscal Data REST API.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k
Geopandas
K-Dense· Community
Guidance and local audit tools for Python workflows using GeoPandas 1.2.0 for spatial data analysis.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository56.4k
Markitdown
K-Dense· Community
A lightweight utility for converting diverse document formats into structured Markdown for analysis, search, and LLM ingestion.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository56.4k
Zarr Python
K-Dense· Community
A guide for storing and querying chunked N-D scientific arrays using Zarr-Python 3.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k