error-tracking-nuxt について
Nuxt アプリケーションに PostHog のエラー追跡を追加するスキルです。既存のエラー処理を維持しながら、自動捕捉、ソースマップ、境界での手動捕捉を導入する方法を示します。
主な機能
- 01Nuxt のエラー追跡設定
- 02例外の自動捕捉ガイド
- 03ソースマップのアップロード案内
- 04例外の手動捕捉
- 05環境変数による設定
活用シーン
- 01Nuxt アプリへの PostHog 追跡追加
- 02ソースマップによるスタックトレース改善
- 03グローバルハンドラーを通らないエラーの捕捉
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ posthog/ skills --skill error-tracking-nuxtインストール後、Claude Code で/error-tracking-nuxtを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/alerts.mdassigning-issues.mdfingerprints.mdmonitoring.mdnuxt.mdupload-source-maps.md詳細
Nuxt 向け PostHog エラートラッキング
このスキルは、Nuxt アプリケーションに PostHog エラートラッキングを追加する際に役立ちます。
参考ファイル
references/nuxt.md- Nuxt エラートラッキングのインストール(v3.7 以降)- ドキュメントreferences/fingerprints.md- フィンガープリント - ドキュメントreferences/alerts.md- エラートラッキングのアラートを送信する - ドキュメントreferences/monitoring.md- 問題を監視、検索する - ドキュメントreferences/assigning-issues.md- チームメイトに問題を割り当てる - ドキュメントreferences/upload-source-maps.md- ソースマップをアップロードする - ドキュメント
API の詳細とフレームワーク固有のパターンについては、ドキュメントを参照してください。
主な原則
- 環境変数:PostHog のキーとホスト URL には、必ず環境変数を使用してください。ハードコードしないでください。
- 最小限の変更:既存のエラー処理に加えて、エラートラッキングを追加してください。既存のエラー処理コードを置き換えたり、再構成したりしないでください。
- まずは自動キャプチャ:手動キャプチャを追加する前に、SDK の初期化で例外の自動キャプチャを有効にしてください。
- ソースマップ:スタックトレースが縮小されたバンドルではなく、元のソースコードに対応するよう、ソースマップをアップロードしてください。
- 境界では手動キャプチャ:グローバルハンドラーに伝播しないエラーについては、エラー境界と catch ブロックで
captureException()を使用してください。
フレームワークのガイドライン
特定のフレームワーク向けガイドラインはありません。
コメント
Markdown 対応