エラートラッキング統合ツール は何をしますか?
エラートラッキングサービスをアプリケーションに統合し、本番環境でのデバッグと監視を改善します。
使用するタイミング
- ユーザーがエラーモニタリングやトラッキングを要求した場合
- 本番環境のエラーログを設定する場合
- ユーザーが「Sentry」「エラートラッキング」「クラッシュレポート」「本番デバッグ」に言及した場合
手順
1. フレームワークの検出
アプリケーションフレームワークを特定します:
- React、Vue、Angular(フロントエンド)
- Express、Fastify(Node.js バックエンド)
- Django、Flask(Python)
- Rails(Ruby)
2. エラートラッキングサービスの選択
人気のサービス:
- Sentry: 最も人気があり、包括的
- Rollbar: バックエンドに最適
- Bugsnag: マルチプラットフォーム
- Airbrake: Ruby 特化
- LogRocket: セッションリプレイ + エラー
3. インストールと設定
Sentry(React の例):
npm install @sentry/react
import * as Sentry from "@sentry/react";
Sentry.init({
dsn: process.env.REACT_APP_SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
integrations: [
new Sentry.BrowserTracing(),
new Sentry.Replay()
],
});
Sentry(Node.js/Express):
const Sentry = require("@sentry/node");
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
});
// リクエストハンドラ(最初のミドルウェア)
app.use(Sentry.Handlers.requestHandler());
// エラーハンドラ(すべてのルートの後、エラーミドルウェアの前)
app.use(Sentry.Handlers.errorHandler());
4. エラーバウンダリの追加(React)
import { ErrorBoundary } from '@sentry/react';
function App() {
return (
<ErrorBoundary fallback={<ErrorFallback />}>
<YourApp />
</ErrorBoundary>
);
}
5. コンテキストの追加
ユーザーコンテキスト:
Sentry.setUser({
id: user.id,
email: user.email,
username: user.username
});
タグ:
Sentry.setTag("page_locale", "en-US");
Sentry.setTag("feature_flag", "new_ui");
コンテキスト:
Sentry.setContext("order", {
id: order.id,
total: order.total,
items: order.items.length
});
6. ブレッドクラム
エラーに至るまでのユーザー操作を追跡:
Sentry.addBreadcrumb({
category: "auth",
message: "User logged in",
level: "info"
});
Sentry.addBreadcrumb({
category: "ui",
message: "Button clicked",
data: { buttonId: "submit-form" }
});
7. 手動エラーキャプチャ
try {
riskyOperation();
} catch (error) {
Sentry.captureException(error, {
tags: { section: "payment" },
level: "error",
extra: { orderId: order.id }
});
}
8. 機密データのフィルタリング
PII のスクラブ:
Sentry.init({
beforeSend(event, hint) {
// 機密データを含む場合は送信しない
if (event.request?.data?.password) {
delete event.request.data.password;
}
return event;
},
ignoreErrors: [
// ブラウザ拡張機能のエラーを無視
/extensions\//i,
/^Non-Error promise rejection/,
]
});
9. ソースマップ(本番環境)
読みやすいスタックトレースのためのソースマップを有効化:
Webpack:
// webpack.config.js
module.exports = {
devtool: 'source-map',
plugins: [
new SentryWebpackPlugin({
org: "your-org",
project: "your-project",
authToken: process.env.SENTRY_AUTH_TOKEN,
include: "./dist",
}),
],
};
10. アラート設定
以下の項目に対してアラートを設定:
- 新しい問題
- 再発(解決済みの問題が再び発生)
- エラー率の急上昇
- 重大なエラー(支払い、認証の失敗)
11. パフォーマンスモニタリング
トランザクション追跡を追加:
const transaction = Sentry.startTransaction({
name: "processOrder",
op: "task"
});
try {
await processOrder();
} finally {
transaction.finish();
}
12. ベストプラクティス
- 環境の分離: 開発/ステージング/本番で異なるプロジェクトを使用
- リリース追跡: エラーにリリースバージョンをタグ付け
- サンプルレート: エラーは100%、パフォーマンスは低めに
- チーム通知: Slack/メール連携
- 課題割り当て: コードオーナーに自動割り当て
- エラーグループ化: カスタムフィンガープリントでグループ化を改善
- 機密データを記録しない: PII、パスワード、トークン
サポートファイル
templates/sentry-react.js: React 統合テンプレートtemplates/sentry-node.js: Node.js 統合テンプレートtemplates/sentry-python.py: Python 統合テンプレート