> ## 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 são uma forma de converter backtraces de arquivos JavaScript minificados ou transpilados para sua representação original no código-fonte. Um sourcemap contém dados sobre o código-fonte do seu front-end, que podemos usar para derivar o nome da função, número da linha e da coluna, e o código-fonte ao redor da posição referenciada no backtrace.

## Requisitos

Aprimorar backtraces com sourcemaps exige que cada amostra seja marcada com uma `revision` da sua aplicação. Isso é usado para determinar quando buscar novos sourcemaps depois que um deploy alterou o código (do front-end). Você pode especificar a revision nas opções fornecidas ao criar uma nova instância do AppSignal.

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

## Sourcemaps públicos

Com sourcemaps públicos, o sourcemap fica hospedado ao lado do arquivo JavaScript. Na parte inferior do JavaScript minificado precisa haver um comentário especial para indicar que um sourcemap está disponível para o código.

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

A URL nesse comentário pode ser uma URL completa para o sourcemap, ou um caminho relativo do arquivo JavaScript até o sourcemap.

Por exemplo, se o JS minificado estiver hospedado em: `https://your.app/assets/application.min.js` e o comentário do sourcemap for `//# sourceMappingURL=application.min.js.map`, tentaremos recuperar o sourcemap da seguinte URL: `https://your.app/assets/application.min.js.map`.

Tentamos fazer cache dos sourcemaps públicos, mas mesmo assim podemos requisitar a versão minificada e o arquivo de sourcemap mais de uma vez.

## Sourcemaps privados

Geralmente recomendamos usar sourcemaps públicos sempre que possível, pois builds que produzem muitos sourcemaps podem demorar bastante para fazer upload via nosso endpoint de sourcemap privado.

No entanto, se isso não for possível, você também pode fazer upload dos seus sourcemaps para o nosso [endpoint da API de sourcemaps](/api/sourcemaps).

### Retenção

Os sourcemaps são agrupados em um "release" pela string `revision` e manteremos o último "release" até que uma nova `revision` seja enviada. "Releases" mais antigos serão mantidos por até sessenta dias.