logs-python

Python 向け PostHog ログ

このスキルは、Python アプリケーションに PostHog のログ取り込みを追加するのに役立ちます。

リファレンスファイル

• references/python.md - Python ログのインストール - ドキュメント
• 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 エクスポーターを設定してください。
• 構造化ログ：プレーンテキストのメッセージより、キーと値のプロパティを含む構造化ログ形式を優先してください。

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

• ソースコードは 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) を使用してください