개요
It is critical for your system’s health to consistently monitor the errors collected by Datadog. When there are many individual error events, it becomes hard to prioritize errors for troubleshooting.
Error Tracking simplifies debugging by grouping thousands of similar errors into a single issue. An issue is an aggregation of error data that provides insights such as
- How many users have been impacted
- When the error first occurred
- Which commit probably caused the error
Error Tracking enables you to:
- Track, triage, and debug fatal errors
- Group similar errors into issues, so that you can more easily identify important errors and reduce noise
- Set monitors on error tracking events, such as high error volume or new issues
- Follow issues over time to know when they first started, if they are still ongoing, and how often they occur
설정
Error Tracking은 APM에서 지원하는 모든 언어에서 사용할 수 있습니다. 추가 SDK나 구성 변경이 필요하지 않습니다.
(선택 사항) 스택 트레이스에서 코드 스니펫을 확인하려면 GitHub 통합을 설정하세요.
리포지토리 설정을 시작하려면 소스 코드 통합 설명서를 참조하세요.
스팬 속성을 사용한 오류 스팬 추적
Datadog SDKs는 통합 및 백엔드 서비스 소스 코드의 수동 계측을 통해 오류를 수집합니다. 오류 스팬이 추적되려면 error.stack, error.message, error.type 스팬 속성을 포함하고 전체 트레이스에 속해야 합니다. 서비스 내에서 오류가 여러 번 보고되면 최상위 오류만 유지됩니다.
Go 트레이서는 v2.7.0 버전에서 스택 트레이스를 보고하는 데 사용되는 속성을 변경했습니다.
이전 Go 트레이서 버전(v2.7.0 이전)의 경우 스택 트레이스는
error.stack 스팬 속성으로 보고됩니다.
v2.7.0부터 Go 트레이서는 처리 스택 트레이스를
error.handling_stack 스팬 속성으로 보고합니다(
error.stack 이제 사용 가능한 경우 예외 발생 스택을 포함함).
자세한 내용은
Error Tracking의 스택 트레이스를 참조하세요.
Error Tracking은 처리하는 각 오류 스팬에 대한 핑거프린트를 계산합니다. 핑거프린트는 오류 유형, 오류 메시지, 스택 트레이스를 구성하는 프레임을 사용합니다. 동일한 핑거프린트를 가진 오류는 함께 그룹화되며 동일한 문제에 속합니다. 자세한 내용은 Trace Explorer 설명서를 참조하세요.
추적할 오류 제어
Error Tracking은 모든 오류 스팬을 자동으로 처리하지만, 수집할 오류와 관리 방법을 제어할 수 있습니다.
- 포함 및 제외 규칙으로 오류 필터링: 서비스, 환경 또는 오류 유형과 같은 속성을 기반으로 오류를 포함하거나 제외하는 규칙을 정의하세요. 데이터 수집 관리를 참조하세요.
- 속도 제한 설정: 하루에 수집되는 오류 양을 제어하여 비용을 관리하세요. 데이터 수집 관리를 참조하세요.
- 특정 문제 제외: 반복되는 조치가 필요 없는 문제를
EXCLUDED로 표시하여 수집을 중단하세요. 문제 상태를 참조하세요. - 전체 트레이스 필터링: 오류를 필터링하는 대신 트레이스가 Datadog으로 전송되지 않도록 방지하세요. APM에서 원치 않는 리소스 무시를 참조하세요.
문제 검토를 통한 문제 해결 또는 디버깅 시작
Error Tracking은 백엔드 서비스에서 수집된 오류를 Error Tracking Explorer의 문제로 자동 분류합니다. 주요 기능에 대한 안내는 Error Tracking Explorer 설명서를 참조하세요.
애플리케이션 성능 모니터링(APM) 분포에서 생성된 이슈에는 영향을 받은 스팬, 가장 관련된 최신 스택 트레이스, 스팬 속성, 호스트 태그, 컨테이너 태그 및 메트릭이 있습니다.
추가 자료