본문 바로가기
WIKI 기술 지식 베이스

Error Tracking 탐색기(Error Tracking Explorer)

원문 보기 위키 갱신

이슈를 보거나 필터링하고 조사해요. 이슈는 같은 버그와 관련된 유사한 오류의 그룹이에요.

출처: 문서

본문

개요

Error Tracking 탐색기를 사용하면 이슈를 보고, 필터링하고, 조사할 수 있어요. 이슈는 같은 버그와 관련된 유사한 오류의 그룹이에요. Datadog는 오류 유형, 오류 메시지, 스택 트레이스 같은 일부 속성을 사용해 각 오류에 대해 핑거프린트를 계산해 이슈를 만들어요. 같은 핑거프린트를 가진 오류는 같은 이슈로 그룹화돼요.

이슈 탐색

Error Tracking 탐색기에 나열된 각 항목은 오류에 대한 상위 수준 정보를 포함하는 이슈예요.

  • 오류 유형과 오류 메시지
  • 기본 오류가 발생한 파일의 경로
  • 이슈 수명에 대한 중요한 정보:
    • 처음과 마지막으로 본 시점
    • 시간에 따른 발생 횟수 그래프
    • 선택한 기간의 발생 횟수

이슈는 또한 다음과 같이 태그 지정돼요.

  • 이슈가 2일 이내에 처음 보였고 FOR REVIEW 상태라면 New(자세한 내용은 이슈 상태 참고)
  • 이슈가 RESOLVED되었다가 새 버전에서 다시 발생했다면 Regression(자세한 내용은 회귀 감지 참고)
  • 애플리케이션이 크래시했다면 Crash
  • 의심 원인(Suspected Cause)이 있는 경우

시간 범위

시간 범위는 탐색기 오른쪽 상단에 타임라인으로 나타나요. 이 기능을 사용하면 선택한 기간 내에 오류 발생이 있는 이슈를 표시할 수 있어요. 드롭다운에서 사전 설정된 범위를 선택해 시간 범위를 변경하세요.

정렬

다음 옵션 중 하나로 목록의 이슈를 정렬하세요.

  • Relevance는 여러 이슈 기능을 결합해 코드 관련, 최근 또는 급증 이슈를 우선해요. Error Tracking은 이슈가 얼마나 오래됐는지, 지난 하루의 발생 횟수, 지난 시간 동안의 주목할 만한 증가, 애플리케이션 크래시를 유발했는지 여부를 분석해요.
  • Count는 선택한 시간 범위의 총 발생 횟수를 기준으로 이슈를 정렬해요.
  • Newest는 처음 본 시점을 기준으로 이슈를 정렬해요.
  • Impacted Sessions는 영향을 받은 RUM 세션 수를 기준으로 이슈를 정렬해요.

페이셋

Error Tracking은 이슈에서 미리 정의된 속성 목록을 자동으로 인덱싱하고 그로부터 페이셋을 만들어요. 페이셋은 선택한 기간 동안 속성의 모든 고유 멤버를 표시하고 표시된 이슈 수 같은 기본 애널리틱스를 제공해요. 페이셋을 사용하면 주어진 속성을 기준으로 이슈를 피벗하거나 필터링할 수 있어요.

자주 사용되는 오류 속성은 다음과 같아요.

속성 설명
error.message 오류와 연결된 메시지.
error.type 오류의 유형 또는 클래스.
error.stack 오류와 연결된 스택 트레이스.
error.handling 오류가 처리(handled)되었는지 여부. 부모 스팬이 성공적인 작업(HTTP 200, gRPC OK) 또는 성공적인 오류 처리(HTTP 400, gRPC NOT_FOUND)를 보고하면 APM 오류는 handled로 간주돼요. 코드에서 수동으로 캡처되지 않으면 RUM 오류는 unhandled예요.

Edit 아이콘을 클릭해 보거나 숨길 수 있는 사용 가능한 페이셋 목록을 확인하세요.

이슈 수준 필터

오류 이벤트 외에도 Error Tracking은 표시된 이슈 목록을 정제하는 이슈 수준 필터를 제공해요.

소스

Error Tracking은 여러 Datadog 제품(RUM, Logs, APM)의 오류를 통합된 보기로 통합해 전체 스택에 걸친 오류를 보고 트러블슈팅할 수 있게 해 줘요. 탐색기에서 All, Browser, Mobile 또는 Backend 이슈를 표시하도록 선택할 수 있어요.

더 세밀한 필터링을 위해 특정 로그 소스나 SDK 및 프로그래밍 언어 범위로 이슈를 좁힐 수 있어요.

수정 가능(Fix available)

신속한 문제 해결을 위해 사용 가능한 AI 생성 수정이 있는 이슈만 표시하세요.

팀 필터

이슈 팀 소유권(Issue Team Ownership)은 Git CODEOWNERS와 서비스 소유자를 사용해 팀과 관련된 이슈를 빠르게 식별하는 데 도움을 줘요.

담당자(Assigned to)

이슈를 자신이나 가장 잘 아는 팀원에게 추적·할당하고, 담당자별로 이슈 목록을 쉽게 정제하세요.

의심 원인(Suspected Cause)

의심 원인은 오류의 더 빠른 필터링과 우선순위 지정을 가능하게 해 팀이 잠재적 근본 원인을 더 효과적으로 해결할 수 있게 해 줘요.

이슈 조사

아무 이슈나 클릭해 이슈 패널을 열고 그에 대한 더 많은 정보를 확인하세요.

이슈를 트러블슈팅할 때 필요한 상위 수준 세부 정보는 패널 상단에서 찾을 수 있어요. 여기에서 수명 주기(첫 발생과 마지막 발생 날짜, 총 횟수, 주어진 이슈의 시간 경과 횟수)를 이해할 수 있어요.

이슈 패널에 표시되는 정보는 오류 소스에 따라 달라져요. 예를 들어 APM 오류에서 만든 이슈는 리소스나 작업 이름 같은 오류 스팬 태그를 보여 주며, 관련 트레이스나 이에 연결된 로그에 직접 접근할 수 있어요.

이슈 패널 하단에서 관련 이슈의 오류 샘플을 탐색할 수 있어요. 각 오류 샘플은 오류의 스택 트레이스와 영향을 받은 사용자의 특성 같은 트러블슈팅 정보를 제공해요.

새롭거나 영향력 있는 오류에 대한 알림 받기

새 이슈가 발생하자마자 보면 중요해지기 전에 사전에 식별하고 해결할 기회를 얻을 수 있어요. Error Tracking 모니터를 사용하면 시스템이나 사용자에게 높은 영향을 주는 새 이슈나 이슈를 추적할 수 있어요(Error Tracking 모니터 참고).

탐색기에서 검색 쿼리를 직접 내보내 관련 범위에 Error Tracking 모니터를 만들 수 있어요.

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 아티클: