Sourcemaps API

Sourcemaps worden gebruikt om het oorspronkelijke regel- en kolomnummer op te halen uit een backtrace die naar een geminimaliseerd of getranspileerd bestand verwijst. Wij raden aan om waar mogelijk publieke sourcemaps te gebruiken. Builds die veel sourcemaps produceren, kunnen lang duren om te uploaden via ons private sourcemap-endpoint. Deze API biedt een eenvoudige manier om private sourcemaps te uploaden voor gebruik met frontend errors.

Private sourcemaps worden niet gebruikt om Node.js-backtraces op te lossen.Volg de Node.js-installatie-instructies om uw applicatie zo te configureren dat sourcemap-backtraces worden gegenereerd.

Sourcemap aanmaken

Met dit endpoint kunt u private sourcemaps aanmaken.


Endpoint	`/api/sourcemaps`
Request-methode	`POST`
Content-Type	`multipart/form-data`
Vereist authenticatie?	Ja (Push API key)
Responseformaten	JSON

Sourcemaps matchen

Wij matchen de waarden voor de name[]-velden tegen de volledige backtrace-URL. Bijvoorbeeld, de volgende backtrace-regel:

Shell

  at https://test.local/main.abc123.js:1:92623

Zal matchen met de name: https://test.local/main.abc123.js. U kunt meerdere name’s toevoegen in één curl-request:

curl -k -X POST -H 'Content-Type: multipart/form-data' \
  -F 'name[]=https://test.local/main.abc123.js' \
  -F 'name[]=https://cdn.local/main.abc123.js' \
  -F 'revision=abcdef' \
  -F 'file=@/~project/main.js.map' \
  'https://appsignal.com/api/sourcemaps?push_api_key=xxx&app_name=AppSignal&environment=development'

Let op: u kunt slechts één sourcemap-bestand tegelijk uploaden. Als u meerdere sourcemap-bestanden heeft, moet u voor elk bestand een aparte uploadrequest sturen. De maximale uploadgrootte voor een sourcemap-bestand is 100 MB.

Parameters

Alle parameters, behalve file, kunnen ofwel in de POST-body ofwel als GET-parameters worden verzonden. Alle parameters zijn verplicht.

Parameter	Type	Beschrijving
`push_api_key`	String	De Push API key van uw organisatie.
`app_name`	String	Naam van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.
`environment`	String	Omgeving van de applicatie in AppSignal waarin de sourcemap moet worden gebruikt.
`revision`	String	Deploy marker revisiereferentie.
`name`	Array of Strings	Lijst van bestandsnamen die de sourcemap dekt. Dit moet een volledige URL zijn naar het geminimaliseerde JavaScript-bestand, zoals u dat ziet in de backtrace, inclusief eventuele URL-parameters.
`file`	File	Te uploaden sourcemap.

Responses

De API geeft een HTTP-statuscode 201 terug als het succesvol is.
De API geeft een HTTP-statuscode 400 terug met een JSON-response wanneer er een validatie-error is opgetreden.
De API geeft een HTTP-statuscode 404 terug als er geen app bestaat voor de gegeven combinatie van app-naam, omgeving en Push API key.

Voorbeeld van een 400-responsebody:

{ "errors": ["The following errors were found: Name can't be empty"] }

Voorbeeld

curl -k -X POST -H 'Content-Type: multipart/form-data' \
  -F 'name[]=https://localhost:3000/application.min.js?vsn=d ' \
  -F 'revision=abcdef' \
  -F 'file=@/~project/application.js.map' \
  'https://appsignal.com/api/sourcemaps?push_api_key=xxx&app_name=MyApp&environment=development'

AppSignal for Ruby

AppSignal for Elixir

AppSignal for Node.js

AppSignal for Front-end

AppSignal for Python

AppSignal for Go

AppSignal for Java

AppSignal for PHP

OpenTelemetry

Wrap

Collector

Standalone agent

Sourcemap aanmaken

Sourcemaps matchen

Parameters

Responses

Voorbeeld

​Sourcemap aanmaken

​Sourcemaps matchen

​Parameters

​Responses

​Voorbeeld

Sourcemap aanmaken

Sourcemaps matchen

Parameters

Responses

Voorbeeld