• /
  • EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

소스 맵을 업로드하여 JS 오류 최소화

는 소스 맵 업로드를 지원합니다.

소스 맵 지원은 주로 축소된 JavaScript를 "디코딩"하는 데 유용합니다. 축소된 JavaScript로 인해 브라우저의 Errors 페이지에 대부분 쓸모없는 오류 스택 추적이 발생합니다. 소스 맵을 업로드하면 이러한 오류가 코드 줄에 대한 유용한 참조와 함께 이해하기 쉬운 스택 추적으로 변환됩니다. 이 기능은 번들 또는 트랜스파일된 JavaScript 코드에도 유용할 수 있습니다.

브라우저는 소스 맵을 사용하기 위한 두 가지 옵션을 제공합니다.

  1. 브라우저 UI를 통해 소스 맵 업로드
  2. API를 통해 브라우저에 소스 맵 게시

이 문서에서는 첫 번째 방법인 일반적인 문제 해결 도움말 과 함께 UI를 통해 소스 맵을 업로드하는 방법을 설명합니다. API 메서드 사용에 대한 지침은 API를 통해 소스 맵 푸시를 참조하세요.

New Relic UI를 통해 소스 맵 가져오기

소스 맵 파일을 브라우저 UI로 끌어 놓거나 업로드하여 특정 JavaScript 파일과 연결할 수 있습니다. 그런 다음 New Relic은 축소된 스택 추적을 축소되지 않은 추적 및 오류 페이지에 표시되는 소스 코드로 변환합니다.

  1. 로컬 컴퓨터에 소스 맵을 다운로드하세요.

  2. one.newrelic.com > All capabilities > Browser > (select an app) > Errors

    으로 이동한 다음 오류 그룹을 클릭하세요. (

    Errors without a stack trace

    라벨이 붙은 그룹을 선택하지 마십시오.)

  3. Stack trace

    섹션에서

    Upload source map

    을 클릭합니다.

  4. 파일 찾기 팝업에서 소스 파일을 선택하세요. 왼쪽에 회색 줄이 있는 오류 프레임은 축소된 JS를 나타냅니다. 파란색 줄은 소스 맵이 적용되었음을 나타냅니다.

기타 JS 오류 프레임 기능은 다음과 같습니다.

If you want to...

Do this...

주변 코드 더 보기

스택 추적에서 코드 앞이나 뒤에 있는 코드를 보려면 Show 10 more lines above/below 을 선택합니다.

축소된 원본 파일 정보 보기

  • 개별 프레임 정보의 경우: 프레임의 소스 라인 및 열 옆에 있는

    생략.

  • 전체 스택 추적의 원시 데이터: 오류 탭 상단에서

    </> Raw

    선택합니다.

소스 맵 제거

확장된 스택 추적 프레임에서 Remove file 선택합니다.

문제점 해결

스택 추적은 여전히 축소됩니다.

소스 맵을 New Relic에 업로드했지만 여전히 축소된 스택 추적이 표시되는 경우 몇 가지 확인해야 할 사항이 있습니다. API를 사용하는 것은 게시된 소스 지도를 나열하거나 삭제 하여 잠재적인 문제를 조사하는 가장 좋은 방법입니다.

Typical problems

Troubleshooting tips

URL 불일치

스택 추적의 각 프레임은 특정 JavaScript URL과 연결됩니다. 해당 URL은 소스 맵을 게시할 때 사용한 JavaScript URL과 일치해야 합니다. 이 URL이 정확히 일치하는지 확인하십시오.

릴리스 이름/ID 불일치

프런트엔드 자산을 배포할 때 JavaScript URL의 버전이 지정되지 않은 경우 newrelic.addRelease API 메서드를사용하고 소스 맵을 게시할 때 릴리스 이름과 릴리스 ID를 지정해야 합니다. 이러한 문자열이 정확히 일치하는지 확인하십시오.

409 오류: Combination of javascriptUrl, releaseName, and releaseId must be unique

특정 JavaScript URL에 대한 소스 맵 파일이 릴리스 이름이나 ID를 지정하지 않고 업로드되면 New Relic은 URL을 고유 식별자로 취급합니다.

이 문제를 해결하려면 릴리스 이름과 ID 값이 NULL인 소스 맵을 삭제하고 해당 매개변수를 포함하여 해당 URL에 대한 모든 버전을 다시 업로드하세요. 이렇게 하면 특정 JS URL에 대해 여러 버전의 소스 맵이 허용됩니다.

누락된 SourcesContent 구성요소

스택 추적을 축소 해제하려면 매핑 파일에 New Relic의 SourcesContent 구성요소가 포함되어야 합니다. 맵을 성공적으로 업로드했지만 여전히 축소되지 않은 코드가 표시되지 않으면 이 구성요소의 원본 소스 맵을 확인하세요. 찾을 수 없으면 구성 요소가 포함되도록 소스 맵을 재생성하고 맵을 New Relic에 업로드하십시오.

SourcesContent 구성 요소가 추가되지 않으면 Whoops, that was the wrong file. Please try again. 과 유사한 오류가 나타납니다.

소스 맵을 생성할 수 없음

소스 맵을 생성하는 데 문제가 있습니까? 모든 빌드 시스템에는 소스 맵을 생성하기 위한 고유한 지침이 있습니다. 자세한 내용은 특정 도구에 대한 설명서를 참조하십시오. 다음은 널리 사용되는 두 가지 빌드 시스템에 대한 소스 맵 생성 지침입니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.