Sentry

핵심 개념

Event

애플리케이션에서 발생한 에러나 예외 하나를 의미합니다. 스택 트레이스, 요청 정보, 사용자 데이터 등을 포함합니다.

Issue

유사한 Event들을 하나로 묶은 단위입니다. 같은 원인으로 발생한 에러들을 그룹화하여 중복을 제거하고 우선순위를 파악할 수 있습니다.

Breadcrumbs

에러가 발생하기 전까지 사용자가 수행한 행동이나 애플리케이션 이벤트를 시간순으로 기록한 흔적입니다. 에러 재현 과정을 이해하는 데 도움을 줍니다.

Release

배포 버전을 식별하는 태그입니다. 특정 릴리스에서 발생한 에러를 추적하고, 새 배포 후 에러 증가 여부를 모니터링할 수 있습니다.

DSN

Data Source Name의 약자로, 애플리케이션에서 Sentry 서버로 에러를 전송하기 위한 고유 URL입니다. SDK 초기화 시 필수로 설정합니다.

Node.js Express 앱에 Sentry 연동

Sentry SDK를 초기화하고 에러 핸들러를 등록하면, 이후 발생하는 모든 예외가 자동으로 Sentry 대시보드로 전송됩니다.

const Sentry = require('@sentry/node');
const express = require('express');

// Sentry 초기화 (앱 시작 시 가장 먼저)
Sentry.init({
  dsn: 'https://examplePublicKey@o0.ingest.sentry.io/0',
  environment: 'production',
  tracesSampleRate: 1.0,
});

const app = express();

// 요청 핸들러 (라우팅 전)
app.use(Sentry.Handlers.requestHandler());

app.get('/', (req, res) => {
  throw new Error('의도적 에러 발생'); // 이 에러가 Sentry로 전송됨
});

// 에러 핸들러 (모든 라우팅 후)
app.use(Sentry.Handlers.errorHandler());

app.listen(3000);