error-tracking-python

Python 向け PostHog エラートラッキング

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

参照ファイル

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

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

重要な原則

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

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

• 仮想環境の venv/site-packages ディレクトリでソースコードを確認できることを覚えておいてください。
• posthog は Python SDK のパッケージ名です。
• pip install posthog または pip install -r requirements.txt で依存関係をインストールしてください。また、シェルコマンドで >= のような引用符で囲まれていないバージョン指定子を使用しないでください。
• CLI やスクリプトでは、終了前に必ず posthog.shutdown() を呼び出してください。呼び出さないと、すべてのイベントが失われます。
• モジュールレベルの posthog.api_key 設定ではなく、必ず Posthog() クラスコンストラクターを使用してください（インスタンスベースの API）。
• 例外を自動的に追跡するため、必ず Posthog() コンストラクターに enable_exception_autocapture=True を含めてください。
• capture() のイベントプロパティに個人を特定できる情報（PII）を絶対に含めないでください。メールアドレス、氏名、電話番号、住所、IP アドレス、ユーザー生成コンテンツは含めないでください。
• PII は capture() のイベントプロパティではなく、identify() の人物プロパティに設定してください。安全なイベントプロパティは、message_length、form_type、ブール値のフラグなどのメタデータです。
• 終了時にすべてのイベントが送信されるよう、atexit.register() に posthog_client.shutdown を登録してください。
• Python SDK には identify() メソッドがありません。人物プロパティを設定するには posthog_client.set(distinct_id=user_id, properties={...}) を使用するか、コンテキスト内で identify_context(user_id) を使用してください。