mcpField
L
logs-nextjs

logs-nextjs

github.com/posthog开发76119 次安装今天更新
代码仓库

关于 logs-nextjs

logs-nextjs 是一项技能，用于将 Next.js 应用的日志接入 PostHog。它介绍通过 OpenTelemetry 配置，并涵盖结构化日志、故障排查等相关文档。

主要功能

  1. 01Next.js 日志接入配置指南
  2. 02PostHog 的 OTLP 导出器配置
  3. 03结构化日志建议
  4. 04故障排查与会话回放参考

适用场景

  1. 01在现有日志系统旁添加 PostHog 导出
  2. 02为 Next.js 应用配置 OTLP 导出器
  3. 03排查日志接入问题

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/logs-nextjs确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

Next.js 的 PostHog 日志

此技能可帮助你为 Next.js 应用添加 PostHog 日志接入功能。

参考文件

  • references/nextjs.md - Next.js 日志安装文档
  • references/start-here.md - 日志入门文档
  • references/search.md - 搜索日志文档
  • references/best-practices.md - 日志最佳实践文档
  • references/troubleshooting.md - 日志故障排查文档
  • references/link-session-replay.md - 关联会话回放文档
  • references/debug-logs-mcp.md - 使用 MCP 调试日志的文档

请参阅文档，了解 API 详情和特定框架的模式。

关键原则

  • 环境变量：始终使用环境变量配置 PostHog 密钥和 OpenTelemetry 端点。切勿将其硬编码。
  • 最小改动：在现有日志记录功能旁添加日志导出。不要替换或重构现有日志记录代码。
  • OpenTelemetry：PostHog 日志使用 OpenTelemetry 协议。请配置指向 PostHog 接入端点的 OTLP 导出器。
  • 结构化日志：优先使用带键值属性的结构化日志格式，而不是纯文本消息。

框架指南

  • 对于 Next.js 15.3+，在 instrumentation-client.ts 中初始化 PostHog，即可采用最简单的配置方式

评论

支持 Markdown