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

Error Tracking Explorer

원문 보기 위키 갱신

Error Tracking Explorer에 대해 알아봐요. 이슈를 보고, 필터링하고, 조사할 수 있게 해 주는 기능이에요. 이슈는 같은 버그와 관련된 유사한 오류의 그룹이에요.

출처: 문서

본문

개요 (Overview)

{% image source="https://docs.dd-static.net/images/error_tracking/error-tracking-overview-3.4013c1c8ca758117de78cbb65cbea016.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/error_tracking/error-tracking-overview-3.4013c1c8ca758117de78cbb65cbea016.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The details of an issue in the Error Tracking Explorer" /%}

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

이슈 탐색하기 (Explore your issues)

Error Tracking Explorer에 나열된 각 항목은 오류에 대한 높은 수준의 정보를 포함하는 이슈이며, 다음을 포함해요:

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

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

시간 범위 (Time range)

{% image source="https://docs.dd-static.net/images/real_user_monitoring/error_tracking/time_range.f4fd26f0076aefc5cfb1f0baf31e1bcb.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/error_tracking/time_range.f4fd26f0076aefc5cfb1f0baf31e1bcb.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Error Tracking Time Range" /%}

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

정렬 (Sorting)

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

  • Relevance: 코드 관련, 최근, 스파이킹(spiking) 이슈를 우선순위화하기 위해 여러 이슈 특징을 결합해요. Error Tracking은 이슈가 얼마나 오래되었는지, 지난 하루 발생 횟수, 지난 한 시간의 눈에 띄는 증가, 애플리케이션 크래시를 트리거했는지 여부를 분석해요.
  • Count: 선택한 시간 범위의 총 발생 횟수를 기준으로 이슈를 정렬해요.
  • Newest: 이슈를 처음 본 시점 순으로 정렬해요.
  • Impacted Sessions: 영향받은 RUM 세션 수로 이슈를 정렬해요.

패싯 (Facets)

{% image source="https://docs.dd-static.net/images/error_tracking/facets-panel-2.8b916f4f8679cb16e2e96e868c3ecc0f.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/error_tracking/facets-panel-2.8b916f4f8679cb16e2e96e868c3ecc0f.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Error Tracking Facets" /%}

Error Tracking은 이슈의 미리 정의된 속성 목록을 자동으로 인덱싱해 패싯을 만들어요. 패싯은 선택한 기간 동안 속성의 고유한 멤버를 모두 표시하고, 대표되는 이슈 수 같은 기본 분석을 제공해요. 패싯을 사용하면 주어진 속성을 기준으로 이슈를 피벗하거나 필터링할 수 있어요.

흔히 사용되는 오류 속성은 다음과 같아요:

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

Edit 아이콘을 클릭하면 보고 숨길 수 있는 사용 가능한 패싯 목록을 볼 수 있어요.

{% image source="https://docs.dd-static.net/images/error_tracking/error-tracking-facets.795e793715c6f18a031d70c3782dfb1e.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/error_tracking/error-tracking-facets.795e793715c6f18a031d70c3782dfb1e.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Click the pencil icon to hide or show available Error Tracking facets from view." /%}

이슈 수준 필터 (Issue level filters)

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

{% image source="https://docs.dd-static.net/images/error_tracking/issue-level-filters-2.5933b8dfc91e0ca80bdf0d541deda8d5.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/error_tracking/issue-level-filters-2.5933b8dfc91e0ca80bdf0d541deda8d5.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Issue level filters in Error Tracking" /%}

소스 (Sources)

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

더 세분화된 필터링을 위해 특정 로그 소스 또는 SDK로 이슈를 좁히고 프로그래밍 언어로 범위를 한정할 수 있어요.

사용 가능한 수정 (Fix available)

문제를 빠르게 해결하기 위해 AI 생성 수정이 가능한 이슈만 표시해요.

팀 필터 (Teams filters)

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

담당자 (Assigned to)

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

의심 원인 (Suspected Cause)

의심 원인 (Suspected Cause)은 오류의 더 빠른 필터링과 우선순위화를 가능하게 해, 팀이 잠재적 근본 원인을 더 효과적으로 해결하도록 지원해요.

이슈 검사하기 (Inspect an issue)

아무 이슈나 클릭하면 이슈 패널이 열리고 이슈에 대한 더 많은 정보를 볼 수 있어요.

{% image source="https://docs.dd-static.net/images/real_user_monitoring/error_tracking/issue_summary_2.a74af6a949c220f9a03a27202d1cd6c9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/error_tracking/issue_summary_2.a74af6a949c220f9a03a27202d1cd6c9.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Upper part of the Error Tracking issue panel offering a summarized view of the issue" /%}

이슈를 해결할 때 필요한 높은 수준의 세부 정보는 패널 상단에서 찾을 수 있어요. 여기에서 이슈의 수명 주기를 이해할 수 있어요: 처음·마지막 발생 날짜, 총 횟수, 특정 이슈의 시간에 따른 횟수 등이요.

{% image source="https://docs.dd-static.net/images/real_user_monitoring/error_tracking/error_sample_2.9088561c866991379e002790e2a14e7d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/real_user_monitoring/error_tracking/error_sample_2.9088561c866991379e002790e2a14e7d.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Lower part of the Error Tracking issue panel offering error samples" /%}

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

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

새롭거나 영향력 있는 오류에 대한 알림 받기 (Get alerted on new or impactful errors)

새 이슈를 발생 즉시 보면 이슈가 심각해지기 전에 사전에 식별하고 수정할 기회를 얻어요. Error Tracking 모니터를 사용하면 시스템이나 사용자에게 영향이 큰 새 이슈나 이슈를 추적할 수 있어요 (Error Tracking Monitors 참고).

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

{% video url="https://docs.dd-static.net/images//error_tracking/create-monitor.mp4" /%}

더 알아보기 (Learn more)

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