error-tracking-node

Node.js 向け PostHog エラートラッキング

このスキルを使うと、Node.js アプリケーションに PostHog エラートラッキングを追加できます。

参考ファイル

• references/node.md - Node.js のエラートラッキングのインストール - ドキュメント
• references/fingerprints.md - フィンガープリント - ドキュメント
• references/alerts.md - エラートラッキングのアラートを送信する - ドキュメント
• references/monitoring.md - イシューを監視、検索する - ドキュメント
• references/assigning-issues.md - イシューをチームメイトに割り当てる - ドキュメント
• references/upload-source-maps.md - ソースマップをアップロードする - ドキュメント

API の詳細やフレームワーク固有のパターンについては、ドキュメントを参照してください。

主な原則

• 環境変数：PostHog のキーとホスト URL には必ず環境変数を使用してください。ハードコードしないでください。
• 変更は最小限に：既存のエラー処理と並行してエラートラッキングを追加してください。既存のエラー処理コードを置き換えたり、構成し直したりしないでください。
• まずは自動キャプチャ：手動キャプチャを追加する前に、SDK の初期化時に例外の自動キャプチャを有効にしてください。
• ソースマップ：スタックトレースが圧縮されたバンドルではなく、元のソースコードを参照できるよう、ソースマップをアップロードしてください。
• 境界では手動キャプチャ：グローバルハンドラーに伝播しないエラーについては、エラー境界や catch ブロックで captureException() を使用してください。

フレームワークのガイドライン

• posthog-node は Node.js サーバーサイド SDK のパッケージ名です。サーバーでは posthog-js を使用しないでください。
• PostHog のコンストラクターオプションに enableExceptionAutocapture: true を含めてください。
• 重要なユーザー操作について、ルートハンドラーに posthog.capture() の呼び出しを追加してください。データを作成、更新、削除するすべてのルートで、コンテキストプロパティを含むイベントを記録してください。
• アプリケーションのエラーハンドラー（Express のエラーミドルウェア、Fastify の setErrorHandler、Koa の app.on('error') など）に posthog.captureException(err, distinctId) を追加してください。
• 長時間実行するサーバーでは、SDK がイベントを自動でバッチ処理します。特別な理由がない限り、flushAt や flushInterval を設定しないでください。
• 短時間で終了するプロセス（スクリプト、CLI、サーバーレス）では、イベントをすぐに送信するため、flushAt を 1、flushInterval を 0 に設定してください。
• Node.js のサーバーサイドではリバースプロキシは不要です。広告ブロッカーを回避するためにプロキシが必要なのは、クライアントサイドの JavaScript のみです。
• ソースコードは node_modules ディレクトリにあることに注意してください。
• package.json を確認し、型チェックやビルド用のスクリプトで変更を検証してください。