mcpField
A
adding-error-tracking

adding-error-tracking

github.com/spencerpauly開発868391 回インストール13 週間前に更新
リポジトリ

adding-error-tracking について

Sentry によるエラー追跡、クラッシュレポート、例外監視、パフォーマンストレースの導入を支援するスキルです。フレームワークの判別から SDK の設定、統合テストまでを扱います。

主な機能

  1. 01フレームワークの判別
  2. 02Sentry SDK のインストール
  3. 03初期化と環境設定
  4. 04エラーバウンダリーの設定
  5. 05ソースマップの設定
  6. 06統合テスト

活用シーン

  1. 01アプリケーションへのエラー追跡の追加
  2. 02クラッシュと例外レポートの設定
  3. 03パフォーマンストレースの設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/spencerpauly/awesome-cursor-skills --skill adding-error-tracking

インストール後、Claude Code で/adding-error-trackingを入力して読み込まれたか確認します。

詳細

エラートラッキング（Sentry）の追加

ユーザーからエラートラッキング、クラッシュレポート、例外監視、またはパフォーマンストレーシングの追加を求められた場合に、このスキルを使用します。

手順

  1. フレームワークを特定する — package.json、設定ファイル、ディレクトリ構造を確認し、スタック（Next.js、React、Node.js、Python/Django/Flask など）を特定します。

  2. SDK をインストールする

    • Next.js：npx @sentry/wizard@latest -i nextjs
    • React（Vite）：npm install @sentry/react
    • Node.js：npm install @sentry/node
    • Python：pip install sentry-sdk

  3. Sentry を初期化する

    • Next.js の場合、ウィザードによって sentry.client.config.ts、sentry.server.config.ts、sentry.edge.config.ts が作成されます。これらのファイルが存在し、DSN が含まれていることを確認します。

    • React（Vite）の場合、main.tsx で初期化します。

      import * as Sentry from "@sentry/react";

Sentry.init({
  dsn: import.meta.env.VITE_SENTRY_DSN,
  integrations: [Sentry.browserTracingIntegration()],
  tracesSampleRate: 1.0,
});

    • Node.js の場合、他のインポートより前にエントリーファイルの先頭で初期化します。

  4. 環境変数を追加する

    NEXT_PUBLIC_SENTRY_DSN=https://[email protected]/...
SENTRY_AUTH_TOKEN=sntrys_...
SENTRY_ORG=your-org
SENTRY_PROJECT=your-project

  5. エラーバウンダリーを追加する — アプリ（または重要なサブツリー）を Sentry.ErrorBoundary でラップし、フォールバック UI を設定します。

  6. ソースマップ — 本番ビルドでは、ソースマップをアップロードするよう Sentry の webpack/vite プラグインを設定します。Next.js の場合は、next.config.js の withSentryConfig で処理されます。

  7. 連携をテストする — エラーをスローする一時的なボタンを追加し、Sentry ダッシュボードにイベントが表示されることを確認します。

注意事項

  • 本番環境では、コストを抑えるために tracesSampleRate を低い値（例：0.1）に設定します。
  • sentry.properties と .sentryclirc を .gitignore に追加します。
  • SENTRY_AUTH_TOKEN は絶対にコミットしないでください。

コメント

Markdown 対応