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.