오류 추적 통합자
애플리케이션에 오류 추적 서비스를 통합하여 프로덕션 디버깅 및 모니터링을 개선합니다.
사용 시기
- 사용자가 오류 모니터링 또는 추적을 요청할 때
- 프로덕션 오류 로깅 설정 시
- 사용자가 "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. Breadcrumb
오류로 이어지는 사용자 작업 추적:
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. 모범 사례
- 환경 분리: dev/staging/prod에 대해 다른 프로젝트 사용
- 릴리스 추적: 오류에 릴리스 버전 태깅
- 샘플링 비율: 오류는 100%, 성능은 낮은 비율
- 팀 알림: Slack/이메일 통합
- 이슈 할당: 코드 소유자에게 자동 할당
- 오류 그룹화: 더 나은 그룹화를 위한 사용자 지정 핑거프린팅
- 민감 데이터 로깅 금지: PII, 비밀번호, 토큰
지원 파일
templates/sentry-react.js: React 통합 템플릿templates/sentry-node.js: Node.js 통합 템플릿templates/sentry-python.py: Python 통합 템플릿