AutoGineer
Generated banner for Logs Nodejs
Generated logo for Logs Nodejs

Logs Nodejs

PostHogOfficialCreated by PostHog

  • Skill
  • Tool integration
  • Data and AI
  • MIT
  • No issues found
Download ZIP

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

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/posthog/logs-nodejs/download

  2. 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

references/start-here.md

Getting started with logs - Docs

New to logging? Read Why you need logs first for a primer on what logs show you that nothing else does.

Install and configure logging

PostHog logs is a powerful logging solution that works with the OpenTelemetry Protocol (OTLP). You don't need any vendor specific SDKs – just use standard OpenTelemetry libraries.

Install and configure your logging client to send logs to PostHog:

  • Use the HTTP endpoint: https://us.i.posthog.com/i/v1/logs

  • Authenticate with your project token (the same token used for events/exceptions)

  • Include the token in the Authorization header or as a ?token= query parameter

  • Use the standard OTLP log format

Configure your logging client

Search and analyze your logs

Once your logs are flowing into PostHog, you can:

  • Search through logs using multiple search tokens, negative filters, and exact phrase matching

  • Filter by time ranges to find specific events

  • Correlate logs with events from your PostHog analytics

Navigate to the Logs section in your PostHog dashboard to start exploring your log data.

Learn how to search logs

Troubleshooting

Common issues you might encounter when setting up logging:

  • Authentication errors - Make sure you're using your correct project token

  • Connection issues - Verify the HTTP endpoint is accessible

  • Log format problems - Ensure you're using the standard OTLP log format

Troubleshoot common issues

Logging best practices

Learn what to log, how to structure your logs, and the patterns that make logs actually useful in production – including wide events, strategic sampling, and adding business context.

Read the best practices guide

1/4

Install and configure logging RequiredSearch and analyze your logs RequiredTroubleshooting RecommendedLogging best practices Recommended

Install and configure logging

Required

Community questions

Ask a question

Was this page useful?

HelpfulCould be better

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.

Attribution and licence

Created by
PostHog
Publisher
PostHog (Official)
Source
PostHog/skills · skills/posthog/logs/skills/nodejs · commit a5d30e7
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Also distributed in
PostHog/skills

AutoGineer is not affiliated with or endorsed by PostHog or PostHog.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download logs-nodejs.zip