API를 통해 소스 맵 업로드

에이전트가 코드에서 오류를 캡처할 때마다 오류가 발생한 JavaScript의 URL과 연결됩니다. 이것은 HTML에 있는 스크립트 태그의 src 속성입니다. 이 전체 JavaScript URL은 소스 맵을 브라우저로 보낼 때 필요합니다.

브라우저의 JS 오류 페이지에서 오류의 JavaScript 파일에 대한 URL을 찾을 수 있습니다. UI에서 이러한 오류를 찾는 방법에 대한 자세한 내용은 브라우저 모니터링 소스 맵 을 참조하세요.

많은 조직에서 JavaScript URL에 버전 번호 또는 해시를 포함합니다. 이것은 일반적으로 사용자가 최신 버전의 코드를 얻을 수 있도록 "버스트" 캐시에 추가됩니다. 이 유형의 URL은 다음과 같습니다.

• https://example.com/assets/application-59.min.js

• https://example.com/assets/bundle-d6d031.min.js

• https://cdnjs.cloudflare.com/ajax/libs/jquery/3.1.1/jquery.js

  앱의 URL에 버전 정보가 자동으로 추가되는 경우 브라우저 에이전트는 오류를 코드와 일치시키는 데 필요한 모든 것을 갖추고 있습니다. 소스 맵 생성 으로 이동할 수 있습니다.

  이것이 귀하에게 적용 되지 않고 JS URL에 버전 정보가 추가 되지 않은 경우 API로 릴리스 이름과 ID를 지정하여 에이전트를 지원해야 합니다.

New Relic CodeStream을 사용하여 IDE에서 코드 성능을 모니터링하는 데 관심이 있는 경우 저장소 URL이 필요합니다. IDE의 오류도 조사하려면 빌드 커밋 해시가 권장되지만 필수는 아닙니다.

IDE에 관찰 기능을 추가하여 성능을 모니터링하는 방법 에 대해 자세히 알아보세요.

업로드할 수 있는 전체 소스 맵 수에는 제한이 없습니다. 그러나 API는 계정당 비율이 제한됩니다.

• 분당 최대 1000개의 소스 맵을 업로드할 수 있습니다.

• 하루에 최대 15,000개의 소스 맵을 업로드할 수 있습니다.

• API 요청당 하나의 소스 맵만 업로드하거나 게시할 수 있습니다.

  소스 맵 파일의 크기는 최대 50Mb입니다.

YOUR_NEW_RELIC_APP_ID 및 YOUR_APP_ID 모두 applicationId 에 대해 유효한 값입니다.

다음은 명령줄을 통해 npm 모듈을 사용하여 소스 맵을 업로드하는 예입니다. 소스 맵은 로컬 파일이나 원격 URL에서 가져올 수 있습니다.

$
npm install -g @newrelic/publish-sourcemap
$
publish-sourcemap PATH_TO_SOURCE_MAP_FILE (local or remote) PATH_TO_ORIGINAL_FILE --apiKey=YOUR_NEW_RELIC_USER_KEY --applicationId=YOUR_NEW_RELIC_APP_ID --repoUrl=GITHUB_REPOSITORY_URL --buildCommit=GIT_BUILD_COMMIT_HASH

다음은 게시된 소스 맵을 나열하는 예입니다.

$
list-sourcemaps --applicationId=YOUR_APP_ID --apiKey=YOUR_NEW_RELIC_USER_KEY
Options:
  --applicationId  Browser application id
  --apiKey         New Relic user API key

다음은 소스 맵을 삭제하는 예입니다.

$
delete-sourcemap --applicationId=YOUR_APP_ID --apiKey=YOUR_NEW_RELIC_USER_API_KEY --sourcemapId=YOUR_SOURCE_MAP_ID
Options:
  --applicationId  Browser application id
  --apiKey         New Relic user API key
  --sourcemapId    Unique id generated for a source map

다음은 Node.js 스크립트를 통해 소스 맵을 게시하는 예입니다.

var publishSourcemap = require('@newrelic/publish-sourcemap').publishSourcemap;

publishSourcemap({
  sourcemapPath: 'SOURCE_MAP_FULL_PATH',
  javascriptUrl: 'JS_URL',
  applicationId: YOUR_NEW_RELIC_APP_ID,
  apiKey: 'YOUR_NEW_RELIC_USER_API_KEY',
  repoUrl: 'GITHUB_REPOSITORY_URL',
  buildCommit: 'GIT_BUILD_COMMIT_HASH'
}, function(err) { console.log(err || 'Sourcemap upload done'); });

다음은 게시된 모든 소스 맵을 나열하는 예입니다.

var listSourcemaps = require('@newrelic/publish-sourcemap').listSourcemaps;;

listSourcemaps({
  applicationId: YOUR_NEW_RELIC_APP_ID,
  apiKey: 'YOUR_NEW_RELIC_USER_API_KEY',
  limit: MAX_NUMBER_OF_RESULTS_TO_RETURN || 20,
  offset: NUMBER_OF_RESULTS_TO_SKIP_BEFORE_RETURNING || 0,
}, function(err, res) { console.log(err || res.sourcemaps); });

다음은 Node.js 스크립트를 통해 소스 맵 파일을 삭제하는 예입니다.

var deleteSourcemap = require('@newrelic/publish-sourcemap').deleteSourcemap;

deleteSourcemap({
  sourcemapId: 'SOURCE_MAP_ID',
  applicationId: YOUR_NEW_RELIC_APP_ID,
  apiKey: 'YOUR_NEW_RELIC_USER_API_KEY',
}, function(err) { console.log(err || 'Deleted source map'); });

컬을 통해 API를 사용하여 브라우저에 지도를 게시하는 예:

$
curl -H "Api-Key: YOUR_NEW_RELIC_USER_API_KEY" \ 
>
    -F "sourcemap=@SOURCE_MAP_PATH" \ 
>
    -F "javascriptUrl=JS_URL" \ 
>
    -F "releaseId=YOUR_RELEASE_ID" \ 
>
    -F "releaseName=YOUR_UI_PAGE" \
>

$
https://sourcemaps.service.newrelic.com/v2/applications/YOUR_NEW_RELIC_APP_ID/sourcemaps

$
curl -H "Api-Key: YOUR_NEW_RELIC_USER_API_KEY" \ 
>
    -F "sourcemap=@SOURCE_MAP_PATH" \ 
>
    -F "javascriptUrl=JS_URL" \ 
>
    -F "releaseId=YOUR_RELEASE_ID" \ 
>
    -F "releaseName=YOUR_UI_PAGE" \
>
    -F "repoUrl=GITHUB_REPOSITORY_URL" \
>
    -F "buildCommit=GIT_BUILD_COMMIT_HASH" \
>

$
https://sourcemaps.service.newrelic.com/v2/applications/YOUR_NEW_RELIC_APP_ID/sourcemaps

아래는 이전에 curl을 통해 New Relic에 업로드된 소스 맵 목록을 가져오는 방법의 예입니다. New Relic은 소스 맵의 고유한 SOURCEMAP_ID 및 해당 구성요소를 반환합니다.

$
curl \ 
>
    -H "Api-Key: YOUR_NEW_RELIC_USER_API_KEY" \ 
>
https://sourcemaps.service.newrelic.com/v2/applications/YOUR_NEW_RELIC_APP_ID/sourcemaps

소스 맵을 삭제하려면:

1. GET 엔드포인트를 사용하여 기존 소스 맵을 나열하고 SOURCEMAP_ID 을 찾습니다.

2. curl을 통해 다음 명령을 실행합니다.

   bash

   카피

   $
   curl -X DELETE \
   >
       -H "Api-Key: YOUR_NEW_RELIC_USER_API_KEY" \
   >
   https://sourcemaps.service.newrelic.com/v2/applications/YOUR_NEW_RELIC_APP_ID/sourcemaps/SOURCEMAP_ID