로깅과 오류 추적의 차이: 무엇을 남기고 어떻게 함께 쓸까

로깅과 오류 추적을 수집 범위, 이슈 그룹화, 컨텍스트, 알림, 비용으로 비교합니다. 크래시 분석과 영향 사용자 수의 조건, Guance의 요청·로그 연결도 설명합니다.

모범 사례
애플리케이션 오류 분석과 연관 데이터 조사를 표현한 일러스트

결제 요청이 실패하면 예외에서 실행이 멈춘 위치를 찾을 수 있습니다. 하지만 그 전에 재고가 예약됐는지, 하위 서비스가 어떤 응답을 보냈는지까지 알 수 있는 것은 아닙니다. 그 내용을 조사하려면 해당 정보도 기록돼 있어야 합니다.

로그는 애플리케이션이 남긴 이벤트를 보존하고, 오류 추적은 수집한 오류를 조사하고 처리할 이슈로 정리합니다. 로그는 수동 검색이고 오류 추적은 자동 진단이라고 단순히 나눌 수는 없습니다. 둘 다 쿼리와 알림을 제공할 수 있으며, 수집하지 않은 정보를 복원하지는 못합니다. 영향받은 사용자 수도 실제 이벤트와 식별 정보에 달려 있습니다.

먼저 알아둘 차이

  • 로그에는 정상 동작, 디버깅 정보, 경고, 오류를 담을 수 있지만 실제 범위는 기록·수집·보존 정책이 결정합니다. 오류 추적은 주로 오류를 다루며 명시적으로 보고한 메시지도 받을 수 있습니다.
  • 오류 추적은 fingerprint 등의 규칙으로 이벤트를 그룹화합니다. 로그 플랫폼도 구조화 필드, 쿼리, 클러스터링, 알림으로 오류를 정리할 수 있습니다.
  • 스택, 기기, 릴리스, 브레드크럼 정보는 SDK와 통합 설정에 따라 달라집니다. 모든 필드가 자동으로 완성되는 것은 아니며 로그에도 구조화된 컨텍스트를 남길 수 있습니다.
  • 오류 추적으로 문제 발견·분류·담당자 배정을 진행하고, 로그로 기록된 업무 단계와 하위 응답을 보완할 수 있습니다.

로그는 무엇을 기록할까?

개발자, 프레임워크, 미들웨어는 요청 처리, 상태 변경, 디버깅 등 선택한 이벤트를 로그로 남깁니다. 시스템에서 일어나는 모든 일을 기록하는 것은 아닙니다. 자유 형식 텍스트일 수도 있고, service, status, 요청 식별자를 갖춘 구조화 레코드일 수도 있습니다. 어떤 내용을 기록하고 수집·보존했는지에 따라 유용성이 달라집니다. OpenTelemetry 로그 데이터 모델(영문)은 본문과 구조화 속성을 함께 다룹니다.

조사를 시작하는 방법도 텍스트 검색만 있는 것은 아닙니다. 구조화 쿼리, 모니터링 이벤트, 연관 요청에서 시작할 수 있습니다. 로그는 업무 상태와 처리 순서를 확인하는 근거가 되지만, error 한 줄이 완전한 근본 원인을 증명하지는 않습니다.

오류 추적이 더하는 것

Sentry 같은 제품의 오류 추적 기능은 SDK나 통합 기능을 통해 오류 이벤트를 수집합니다. 자동 수집 범위는 런타임, SDK 초기화와 설정에 따라 다르며, 대표적인 예는 처리되지 않은 예외와 Promise rejection입니다. 애플리케이션에서 잡아 처리한 예외는 captureException 같은 API로 직접 보고해야 할 수 있습니다. 모든 크래시나 잘못된 업무 결과를 자동으로 발견한다고 가정해서는 안 됩니다. Sentry 오류 수집(영문)

주로 다음 세 가지 작업을 정리합니다. 로그 플랫폼에서는 절대 할 수 없다는 뜻은 아닙니다.

  1. 이슈 그룹화. 스택, 예외 유형, 메시지, 사용자 지정 fingerprint 등이 그룹에 영향을 줍니다. Sentry의 기본 알고리즘에는 버전이 있고 규칙도 바꿀 수 있습니다. 비슷한 메시지가 같은 문제라는 보장은 없으며, 같은 원인도 여러 그룹으로 나타날 수 있습니다. 그룹화 알고리즘과 규칙(영문)
  2. 컨텍스트 추가. 스택, 환경, 릴리스, 기기, 사용자, 브레드크럼을 담을 수 있지만 SDK와 활성화한 통합 기능에 따라 달라집니다. 사용자 정보는 목적에 맞게 설정하고 개인정보 수집을 제어해야 합니다. SDK를 넣었다고 모든 방문자를 식별하는 것은 아닙니다. SDK 수집 데이터(영문)
  3. 알림과 회귀 처리. 새 이슈나 해결한 이슈의 재발을 규칙의 트리거로 사용할 수 있습니다. 필터링, 샘플링, 할당량, 알림 조건과 빈도 제한에 따라 실제 통지가 달라집니다. 새 예외마다 즉시 알림이 온다는 보장은 없습니다. 알림 트리거와 필터(영문)

크래시 분석(crash analytics)은 크래시와 그 릴리스·기기·관측된 영향 범위에 초점을 맞춥니다. 예외가 발생했다고 반드시 프로세스가 비정상 종료되는 것은 아닙니다. 크래시나 네이티브 오류의 지원 범위는 플랫폼마다 다르므로 해당 SDK와 심볼 파일 요건을 확인해야 합니다. ‘영향받은 사용자 수’는 수신한 이벤트의 식별 정보를 기준으로 하며, 영향을 받은 모든 방문자 수나 업무 손실을 그대로 나타내지는 않습니다.

실제 작업 방식 비교

기준 로깅 오류 추적
범위 실제 기록·보존한 이벤트로, 정상 동작과 오류 포함 가능 수집한 예외, 지원하는 크래시, 명시적으로 보고한 메시지
수집 프레임워크 출력, 애플리케이션 로깅, 수집기 SDK·통합 기능의 자동 수집과 직접 보고
집계 플랫폼에 따라 구조화 쿼리, 통계, 클러스터링 이슈 그룹과 건수, fingerprint 등 규칙 조정
알림 수집 데이터에 대한 탐지·통지 규칙 새 이슈·재발 등의 조건과 알림 빈도 설정
컨텍스트 기록 내용, 가공 과정에서 남은 필드, 보존 범위 SDK, 플랫폼, 통합 기능, 식별자, 개인정보 설정
비용 제품·플랜별 수집, 저장, 쿼리, 기능 요금 제품·플랜별 이벤트 한도, 보존, 기능, 초과 요금

그룹화는 사람이 개별적으로 처리할 이슈 수를 줄입니다. 수집한 오류 이벤트 수가 반드시 줄어드는 것은 아닙니다. 어느 쪽이 저렴한지는 실제 제품과 플랜을 비교해야 합니다. ‘로그 양’과 ‘이벤트 양’을 모든 제품에 통하는 동일한 과금 단위로 보면 안 됩니다.

조사 단계에 맞춰 함께 사용하기

시작점에 따라 순서는 달라지지만 다음 세 단계가 유용합니다.

  • 발견: 오류 추적 규칙이나 로그 모니터링으로 새 문제와 오류 수의 변화를 찾습니다. 영향 범위는 실제 수집한 이벤트와 식별 정보에서 판단합니다.
  • 범위 확인: 릴리스와 환경 필드로 대상을 좁히고 담당 팀에 배정합니다. 해당 필드가 올바르게 기록돼 있어야 합니다.
  • 원인 조사: 발생 시각과 요청 컨텍스트로 보존된 로그를 조회하고, 스택·업무 상태·하위 응답을 함께 보며 원인에 대한 설명을 검증합니다.

오류 이벤트만 보존하면 실패 이전의 정상 처리 과정이 빠질 수 있습니다. 반대로 필드와 알림 없이 흩어진 텍스트만 저장해도 중요한 문제를 놓칠 수 있습니다. 데이터 이름보다 부족한 근거와 처리 기능이 무엇인지 보고 선택해야 합니다.

Guance에서 같은 요청의 로그로 이어가기

트레이스를 수집하고 업무 로그에 같은 형식의 현재 trace_id를 남기면, Guance의 트레이스 상세 화면(영문)에서 기록된 오류 스팬과 연관 로그를 조회할 수 있습니다. 시간 범위, 서비스·환경 필드, 로그 인덱스 매핑, 조회 권한도 맞아야 합니다. 수집하지 않았거나 샘플링으로 버렸거나 보존 기간이 지난 데이터는 같은 트레이스 ID로 되살릴 수 없습니다. APM을 연결했다고 모든 예외가 수집·그룹화됐다는 뜻은 아닙니다.

로그에도 오류를 모아 보는 화면이 있습니다. Guance의 로그 오류 추적(영문)은 error_stack 또는 error_message가 있는 수집된 로그를 보여 줍니다. error 심각도만 있다고 누락된 스택이 채워지지는 않습니다.

알림과 담당자 처리를 연결하려면 로그나 트레이스를 대상으로 모니터링 규칙(영문)을 설정하고 이벤트에 관련 쿼리 링크를 넣습니다. 인시던트 연결과 이벤트 심각도 매핑을 활성화하면 조건에 맞는 이상 이벤트에서 인시던트 레코드를 만들 수 있습니다. 통지는 설정한 알림 정책을 따릅니다. 오류 문장을 찾는 작업과 문제 처리를 관리하는 작업을 구분할 수 있습니다.

자주 묻는 질문

error 로그 레벨만으로는 부족한가요? 레벨은 하나의 필드입니다. 구조화 오류 로그도 집계·클러스터링·알림에 사용할 수 있습니다. 반복 문제를 추적하거나 릴리스·사용자 영향을 판단하려면 스택, 그룹 규칙, 식별자 등이 있어야 합니다.

오류 추적으로 로그를 대체할 수 있나요? 보통 그대로 대체할 수는 없습니다. 오류 이벤트는 이슈 관리에 적합하지만 감사와 정상 처리 과정에는 별도 기록이 필요합니다. 논리적 결함이 예외를 만들지 않고 탐지나 명시적 보고도 없다면, 두 도구 모두 업무 결과가 틀렸다는 사실을 자동으로 알지 못합니다.

오류 로그를 요청과 어떻게 연결하나요? 현재 trace_id를 기록하고 서비스·환경 필드를 일관되게 유지하며 시간, 인덱스, 권한을 확인합니다. 알려진 실패 요청에서 실제 레코드가 조회되는지 먼저 확인해야 합니다. 같은 시간에 발생했다는 사실만으로 인과관계가 성립하지는 않습니다.

프런트엔드 오류도 추적할 수 있나요? 해당 SDK가 지원하는 오류를 수집할 수 있지만 런타임, 통합 기능, 브라우저의 제약을 받습니다. 압축된 스택을 원본 소스와 연결하려면 실제 배포 산출물과 맞는 sourcemap이 필요하고, 업로드나 지원되는 접근 방식으로 매핑과 필요한 소스 내용을 확보해야 합니다. Sentry는 Debug ID로 산출물을 연결할 수 있으며 release·경로 매칭은 다른 방법입니다. 모든 방식에 release가 필요한 것은 아니고, 맵이나 심볼이 원래 없던 스택을 만들어 주지도 않습니다. sourcemap(영문) · Debug ID 매칭(영문)

함께 읽기

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소