error-tracking-web

Web（JavaScript）向け PostHog エラートラッキング

このスキルでは、Web（JavaScript）アプリケーションに PostHog のエラートラッキングを追加する方法を説明します。

参考ファイル

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

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

主な原則

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

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

• ソースコードは node_modules ディレクトリにあります。
• 変更を検証するために、型チェックやビルドのスクリプトがあるか package.json を確認してください。
• posthog-js は JavaScript SDK のパッケージ名です。
• 他の PostHog メソッド（capture、identify など）を呼び出す前に、必ず posthog.init() を呼び出してください。
• posthog-js はブラウザー専用です。Node.js やサーバーサイドのコンテキストではインポートしないでください（代わりに posthog-node を使用してください）。
• posthog-js では自動キャプチャがデフォルトで有効です（クリック、フォーム送信、ページビューを追跡します）。ユーザーから明示的に求められない限り、自動キャプチャを無効にしないでください。
• posthog.capture() のイベントプロパティに個人を特定できる情報（PII）を絶対に送信しないでください。メールアドレス、フルネーム、電話番号、住所、IP アドレス、ユーザー生成コンテンツは含めないでください。
• PII は posthog.identify() のユーザープロパティ（email、name、role）に設定し、capture() のイベントプロパティには設定しないでください。
• ログイン時と、すでにログイン済みのユーザーがページを更新したときに、posthog.identify(userId, { email, name, role }) を呼び出してください。
• ログアウト時に posthog.reset() を呼び出し、以降のイベントが現在のユーザーに関連付けられないようにしてください。
• フレームワークのルーターを使わない SPA では、posthog.capture($pageview) でページビューをキャプチャするか、History API のルーティングに init の capture_pageview history_change オプションを使用してください。