Skip to content

migration-guide.md

Latest commit

 

History

History
65 lines (43 loc) · 1.44 KB

migration-guide.md

File metadata and controls

65 lines (43 loc) · 1.44 KB
Raw

Migration Guide

Current Compatibility

Component Current baseline
BugDNA core Java 8+
BugDNA starter Java 17+, Spring Boot 4.x
Auto-configuration discovery AutoConfiguration.imports

Spring Boot 3 and Newer

Auto-configuration candidates are located in:

META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

The legacy EnableAutoConfiguration key in META-INF/spring.factories is not used.

Adopting @EnableBugDna

The starter participates in automatic discovery, so existing applications do not need the annotation. Add @EnableBugDna when explicit configuration imports are preferred.

Adopting Failure Tracking

Core:

FailureTracker tracker = new FailureTracker();
tracker.capture(exception);

Starter:

FailureTracker tracker;

Inject the managed bean. Automatic MVC and service captures feed it.

Adopting Compact Logs

Automatic logs use:

[BUGDNA-*] Unhandled exception fingerprinted by bugdna

Use bugdna.include-stack-trace=true when the previous behavior requires a stack trace.

Compatibility Checklist

Before upgrading:

  1. Run mvn clean test.
  2. Confirm the Java runtime baseline.
  3. Review Spring property names and defaults.
  4. Confirm management endpoints are explicitly exposed.
  5. Treat all in-memory counts as reset during deployment.

See CHANGELOG.md for release-specific changes.