> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sourcemaps

Sourcemaps sind eine Möglichkeit, Backtraces aus minifizierten oder transpilierten JavaScript-Dateien in ihre ursprüngliche Darstellung im Quellcode umzuwandeln. Eine Sourcemap enthält Daten über Ihren Front-end-Quellcode, mit denen wir den Funktionsnamen, die Zeilen- und Spaltennummer sowie den umgebenden Quellcode aus der im Backtrace angegebenen Position ableiten können.

## Anforderungen

Damit Backtraces mit Sourcemaps angereichert werden können, muss jedes Sample mit einer `revision` Ihrer Anwendung versehen sein. Diese wird verwendet, um zu bestimmen, wann neue Sourcemaps abgerufen werden müssen, nachdem ein Deploy Ihren (Front-end-)Code geändert hat. Sie können die Revision in den Optionen angeben, die beim Erstellen einer neuen AppSignal-Instanz übergeben werden.

<CodeGroup>
  ```js JavaScript theme={null}
  const appsignal = new Appsignal({
    key: "<your frontend API key>",
    revision: "<your current revision>",
  });
  ```
</CodeGroup>

## Öffentliche Sourcemaps

Bei öffentlichen Sourcemaps wird die Sourcemap neben der JavaScript-Datei gehostet. Am Ende des minifizierten JavaScripts muss ein spezieller Kommentar stehen, der anzeigt, dass für den Code eine Sourcemap verfügbar ist.

<CodeGroup>
  ```js JavaScript theme={null}
  //# sourceMappingURL=file.js.map
  ```
</CodeGroup>

Die URL in diesem Kommentar kann eine vollständige URL zur Sourcemap oder ein relativer Pfad von der JavaScript-Datei zur Sourcemap sein.

Wenn das minifizierte JS beispielsweise unter `https://your.app/assets/application.min.js` gehostet wird und der Sourcemap-Kommentar wie `//# sourceMappingURL=application.min.js.map` aussieht, versuchen wir, die Sourcemap unter der folgenden URL abzurufen: `https://your.app/assets/application.min.js.map`.

Wir versuchen, öffentliche Sourcemaps zu cachen, können die minifizierte Version und die Sourcemap-Datei dennoch mehr als einmal anfordern.

## Private Sourcemaps

Wir empfehlen in der Regel die Verwendung öffentlicher Sourcemaps, wann immer dies möglich ist, da Builds, die viele Sourcemaps erzeugen, lange dauern können, um über unseren privaten Sourcemap-Endpunkt hochgeladen zu werden.

Falls dies jedoch nicht möglich ist, können Sie Ihre Sourcemaps auch über unseren [Sourcemaps-API-Endpunkt](/api/sourcemaps) hochladen.

### Aufbewahrung

Sourcemaps werden über den `revision`-String zu einem „Release" gruppiert, und wir behalten das letzte „Release" bei, bis eine neue `revision` hochgeladen wird. Ältere „Releases" werden bis zu sechzig Tage lang aufbewahrt.