Documentation
Release
Set release once in init. Every error from that build gets the same label. Take the value from your package metadata — not a hardcoded string.
Product overview (Releases view): Features → Release.
Optional. init works with only an API key. Set release when you want version
grouping and the release incident rule.
JavaScript
Browser and Node: read the version from package.json.
import pkg from '../../package.json';
import { init } from '@retrace-kit/sdk';
init({
apiKey: 'your-project-api-key',
release: pkg.version,
});
Adjust the relative path to your package.json. TypeScript needs
resolveJsonModule (on by default in most bundlers).
Python
import os
from importlib.metadata import version
from retrace_kit import init
init(
api_key=os.environ["RETRACE_KIT_API_KEY"],
release=version("your-package"),
) your-package is the name in pyproject.toml / on PyPI. For an unpublished
app, read the version from pyproject.toml instead.
Java
String release = App.class.getPackage().getImplementationVersion();
RetraceKit.init(
Config.builder()
.apiKey(System.getenv("RETRACE_KIT_API_KEY"))
.release(release)
.build()
); Implementation-Version comes from the JAR manifest (Maven/Gradle set it from the project
version). Kotlin: App::class.java.getPackage()?.implementationVersion.
Optional environment (e.g. production, staging) keeps envs separate
when the version string matches.