Carregar mapas de origem via API

Cada vez que o agente captura um erro no seu código, ele é associado à URL do JavaScript em que ocorreu. Este é o atributo src da tag de script no seu HTML. Este URL JavaScript completo é necessário ao enviar mapas de origem ao browser.

Você pode encontrar o URL do arquivo JavaScript de um erro no browser, na página JS errors . Consulte os mapas de origem do monitoramento do browser para obter mais informações sobre como encontrar esses erros na interface.

Muitas organizações incluem um número de versão ou aplicam hash no URL JavaScript. Isso geralmente é adicionado aos caches "bust" para garantir que seu usuário obtenha a versão mais recente do seu código. Este tipo de URL pode ser semelhante a:

• 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

  Se os URLs do seu aplicativo tiverem automaticamente as informações da versão anexadas, o agente browser terá tudo o que precisa para corresponder os erros ao seu código. Você pode avançar para a geração de mapas de origem.

  Se este doesn't se aplicar a você e os URLs JS não tiverem informações de versão anexadas, você terá que ajudar o agente especificando um nome de versão e um ID com a API.

Se você estiver interessado em monitorar o desempenho do seu código do seu IDE usando New Relic CodeStream, é necessária a URL do repositório. Se você também quiser investigar erros do seu IDE, o build commit aplicar hash é recomendado, mas não obrigatório.

Saiba mais sobre monitoramento de desempenho trazendo observabilidade para o IDE.

Não há limite para o número total de mapas de origem que você pode carregar. No entanto, a API tem taxa limitada por conta:

• Você pode carregar no máximo 1.000 mapas de origem por minuto.

• Você pode carregar no máximo 15.000 mapas de origem por dia.

• Apenas um mapa de origem pode ser carregado ou publicado por solicitação de API.

  Os arquivos de mapa de origem podem ter no máximo 50 MB.

Ambos YOUR_NEW_RELIC_APP_ID e YOUR_APP_ID são valores válidos para applicationId.

Aqui está um exemplo de upload de mapas de origem usando o módulo npm por meio da linha de comando. Observe que o mapa de origem pode vir de um arquivo local ou de uma URL remota.

$
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

Aqui está um exemplo de listagem de mapas de origem publicados:

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

Aqui está um exemplo de exclusão de um mapa de origem:

$
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

Aqui está um exemplo de publicação de um mapa de origem por meio de um script 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'); });

Aqui está um exemplo de listagem de todos os mapas de origem publicados:

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); });

Aqui está um exemplo de exclusão de um arquivo de mapa de origem por meio de um script 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'); });

Um exemplo de uso de API via curl para publicar mapas no browser:

$
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

Abaixo está um exemplo de como obter uma lista de mapas de origem previamente carregados no New Relic via curl. New Relic retorna o SOURCEMAP_ID exclusivo do mapa de origem e seus componentes:

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

Para excluir um mapa de origem:

1. Use o endpoint GET para listar os mapas de origem existentes e localizar o SOURCEMAP_ID.

2. Execute o seguinte comando via curl:

   bash

   Copiar

   $
   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