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. 02Next.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 対応