Error(오류)¶
사용자가 애플리케이션을 사용하는 동안 브라우저에서 발생하는 프런트엔드 오류를 확인할 수 있으며, 오류 유형과 오류 내용 등을 포함합니다.
Error 탐색기에서 다음을 수행할 수 있습니다:
-
모든 오류 유형과 관련 오류 상세를 한곳에서 확인할 수 있습니다.
-
Sourcemap 변환을 통해 난독화된 코드를 복원하여 오류 조사 시 소스 코드를 쉽게 찾고, 사용자가 문제를 더 빠르게 해결할 수 있도록 지원합니다.
탐색기 목록¶
모든 오류¶
Error 탐색기에서 사용자 방문 시의 페이지 주소, 코드 오류 유형, 오류 내용 등을 빠르게 확인할 수 있습니다.
-
오류 내용 Load failed:
response가 없는 오류로, SDK가 기본적으로 Load failed를 추가합니다. -
오류 내용 Network request failed:
response가 오류를 반환한 경우입니다.
패턴¶
발생 빈도가 높은 오류를 확인하려면 Guance 워크스페이스의 RUM > 탐색기 > Error에서 패턴 목록을 선택할 수 있습니다.
패턴은 모든 오류의 트레이스 데이터를 클러스터링 필드를 기준으로 유사도 계산 및 분석하며, 오른쪽 상단에서 선택한 시간 범위에 따라 현재 시간 구간을 고정하고 해당 구간 내 10,000건의 데이터를 가져와 클러스터링합니다. 유사도가 높은 오류 트레이스를 집계하고 공통 Pattern 클러스터를 추출 및 통계하여 이상 트레이스를 빠르게 발견하고 문제를 파악하는 데 도움을 줍니다.
기본적으로 error_message 필드를 기준으로 집계하며, 클러스터링 필드를 사용자 지정으로 입력할 수 있고 최대 3개까지 입력할 수 있습니다.
-
패턴 목록에서 클러스터를 클릭하면 Pattern 클러스터 상세를 열고 연결된 오류 레코드를 확인할 수 있습니다. 오류 레코드를 클릭하면 해당 Error 상세 페이지로 이동합니다.
-
패턴 페이지에서 정렬 icon & 를 클릭하면 문서 수를 오름차순/내림차순으로 정렬할 수 있습니다(기본값 내림차순).
연결된 오류 표시 열¶
Pattern 클러스터 상세의 연결된 오류 목록에서 표시 열을 클릭하면 사용 가능한 필드를 검색하여 추가하고, 선택 가능한 열을 제거하거나 열 순서를 조정하거나 기본 열로 복원할 수 있습니다. 전체 작업은 클러스터 상세 표시 열을 참조하세요.
기본적으로 시간, 오류 유형, 페이지 주소, 오류 내용이 표시됩니다. 시간 열은 유지되어 첫 번째 열에 고정되며, 나머지 열은 조정할 수 있습니다. 동일한 필드는 중복 추가할 수 없습니다.
예를 들어 version 및 env를 추가하면 각 오류 레코드의 애플리케이션 버전과 환경을 직접 비교할 수 있습니다. 선택 가능한 필드는 현재 애플리케이션, 워크스페이스 및 데이터 권한에서 실제로 사용 가능한 필드를 기준으로 하며, 이미 보고되었고 표시 열 규칙을 충족하는 사용자 지정 필드도 포함합니다. 레코드에 선택한 필드가 없으면 “—”로 표시됩니다.
연결된 오류 목록은 최대 50건의 레코드를 표시합니다. 목록에 특정 버전의 레코드가 나타나지 않는다고 해서 해당 버전에서 오류가 발생하지 않았거나 오류가 수정되었다고 판단할 수는 없습니다.
상세 페이지¶
목록에서 확인하려는 데이터 상세 페이지를 클릭하면 오류 상세, 확장 필드, 연결된 트레이스 등 사용자 방문 오류 상세를 확인할 수 있습니다.
소스¶
소스에서 현재 Error의 Session / View / Action 상세를 확인할 수 있으며, 현재 Session ID / View ID / Action ID를 필터링하거나 복사하여 확인할 수 있습니다.
오류 분포 차트¶
오류 분포 차트는 유사도가 높은 오류를 집계 및 통계하고, 탐색기에서 선택한 시간 범위에 따라 해당 시간 간격을 자동으로 선택하여 오류 분포 추세를 표시합니다. 이를 통해 오류가 빈번하게 발생하는 시점이나 시간 범위를 직관적으로 확인하고 오류 문제를 빠르게 파악할 수 있습니다.
오류 상세¶
오류 상세에서 오류의 구체적인 내용을 확인할 수 있습니다.
Sourcemap 변환¶
애플리케이션을 프로덕션 환경에 배포할 때 코드 유출 등의 보안 문제를 방지하기 위해 일반적으로 패키징 과정에서 파일을 변환하거나 압축하는 등의 작업을 수행합니다. 이러한 조치는 코드 보안을 보장하는 동시에 수집된 오류 스택 정보를 난독화된 상태로 만들기 때문에 문제를 직접 파악할 수 없어 이후 버그 트러블슈팅에 불편을 초래합니다.
Guance는 애플리케이션에 Sourcemap 기능을 제공하여 난독화된 코드 복원을 지원하고, 오류 조사 시 소스 코드를 쉽게 찾아 사용자가 문제를 더 빠르게 해결할 수 있도록 돕습니다.
RUM Sourcemap 설정 또는 Datakit 수집기 Sourcemap 변환을 통해 설정할 수 있습니다. 설정을 완료하면 오류 상세에서 해석된 코드와 원본 코드를 확인할 수 있습니다.
참고: 현재 RUM에서 Sourcemap 설정을 지원하는 대상은 Web 유형 애플리케이션뿐입니다.
해석된 코드 예시¶
RUM에서 Sourcemap 변환을 설정한 경우의 해석된 코드 예시:
원본 코드 예시¶
Datakit 수집기로 Sourcemap 변환을 설정한 경우의 해석된 코드 예시:
참고: 사용자가 RUM과 Datakit 수집기 모두에서 Sourcemap을 설정한 경우 RUM 설정의 해석 형식이 표시됩니다.
확장 필드¶
검색창에 필드 이름이나 값을 입력하여 빠르게 검색하고 위치를 찾을 수 있습니다.
필드 별칭을 선택하면 필드 이름 뒤에 표시되며, 필요에 따라 선택할 수 있습니다.
트레이스 상세 페이지에서 확장 필드를 통해 현재 트레이스의 관련 필드 속성을 확인할 수 있습니다:
| 필드 | 속성 |
|---|---|
| 필드 값 필터링 | 이 필드를 탐색기에 추가하여 해당 필드와 관련된 모든 데이터를 확인할 수 있으며, 트레이스 탐색기에서 해당 필드와 관련된 트레이스 목록을 필터링하여 볼 수 있습니다. |
| 필드 값 역필터링 | 이 필드를 탐색기에 추가하여 해당 필드를 제외한 다른 데이터를 확인할 수 있습니다. |
| 표시 열에 추가 | 이 필드를 탐색기 목록에 추가하여 확인할 수 있습니다. |
| 복사 | 이 필드를 클립보드에 복사합니다. |
Obsy Copilot 오류 분석¶
Guance는 오류 데이터를 원클릭으로 분석하는 기능을 제공합니다. 대규모 언어 모델을 활용해 데이터에서 핵심 정보를 자동으로 추출하고, 온라인 검색 엔진과 운영 지식 베이스를 결합하여 가능한 장애 원인을 빠르게 분석하며 초기 해결 방안을 제공합니다.
- 단일 데이터를 클릭하여 상세 페이지를 펼칩니다.
- 오른쪽 상단의 “Obsy Copilot 오류 분석”을 클릭합니다.
- 오류 분석을 시작합니다.







