개발일지

🛠 [3편] 소규모 프로젝트에서 꼭 필요한 로그 시스템 구성법

makeviibe 2025. 7. 30. 16:34

안녕하세요, makeviibe입니다.

지난 포스트에서 “사용자 로그가 기능 판단에 중요하다”는 이야기를 드렸습니다.

그렇다면 이제는 실제 로그 시스템을 어떻게 구성할 수 있을지에 대해 이야기해볼게요.

대기업이나 중대형 서비스는 ELK, Datadog, New Relic 같은 강력한 툴을 사용합니다.

하지만 소규모 프로젝트나 MVP 서비스에서는 그 정도까지 필요하지 않은 경우가 많습니다.

그래서 makeviibe는 아래와 같은 “가볍고 실용적인 로그 시스템”을 추천합니다.


✅ 로그 시스템, 2가지 관점에서 나눠보면?

  1. 시스템 로그 (오류 감지, 서버 상태 확인)
  2. 사용자 행동 로그 (기능 활용도 분석, UI 개선용)

이 둘은 성격도, 저장 방식도 다릅니다.

하지만 프로젝트 초기에는 이 둘을 구분하지 않고 “로그는 그냥 콘솔에 찍는 거 아닌가요?”라는 오해가 많습니다.


🧱 makeviibe가 추천하는 최소 로그 시스템 구성

1. Sentry – 예외와 오류 알림을 자동으로

  • 백엔드(Spring), 프론트(React, Flutter) 모두 연동 가능
  • 예외 발생 시 스택트레이스, 유저 정보, 디바이스 정보 자동 수집
  • Slack으로 알림 연동 가능

💡 오류가 생겼는데도 아무도 모른다면? 사용자 이탈로 이어집니다.

Sentry는 MVP 시점부터 무조건 설정하는 걸 추천합니다.


2. Slack 알림 – 실시간 이슈 대응

  • 로그인 실패, 결제 실패, 푸시 실패 등의 주요 이벤트를 Slack으로 전송
  • 메시지 포맷을 통일해두면 누구나 빠르게 파악 가능

예시:

💡 알림은 많을수록 좋은 게 아니라, ‘중요한 이벤트만 정확히’ 전송하는 게 핵심입니다.


3. DB 로그 – 사용자 행동 기록

  • 어떤 기능을 사용했는지 기록
  • 어떤 버튼을 클릭했는지, 어떤 경로로 이탈했는지 파악 가능

예시 테이블 구조:

이 로그를 기반으로:

  • 어떤 페이지에서 이탈이 많은지
  • 어떤 기능은 아예 안 쓰이는지
  • 특정 시점에 폭발적인 사용이 있었는지

를 분석할 수 있습니다.


📌 실무에서는 이렇게 활용합니다


🤝 makeviibe는 이렇게 도입하고 있습니다

  • 클라이언트가 운영할 수 있도록 Slack 알림 포맷을 문서화
  • 백엔드 예외 로그는 Sentry 자동 알림 + 콘솔 출력 병행
  • 사용자 행동 로그는 분석 쿼리 예시까지 함께 전달

💬 인수인계 이후에도, 클라이언트가 직접 운영을 이어갈 수 있도록 로그 중심의 가이드 제공까지 포함하고 있습니다.


✍️ 마무리

로그 시스템은 ‘서비스가 커진 다음에’ 고민해야 하는 게 아닙니다.

작은 프로젝트일수록, 적은 리소스로 정확한 로그를 남기면

빠르게 개선하고 방향을 조정할 수 있습니다.

makeviibe 팀은

✔️ 최소 설정으로 시작할 수 있는 로그 시스템,

✔️ 클라이언트 운영을 위한 문서화,

✔️ 사용자 로그 기반의 기능 판단

까지 함께 설계하고 있습니다.

다음 프로젝트에서 로그 시스템이 필요하시다면, 저희가 함께하겠습니다.