bugdna

BugDNA converts exceptions across Java, Node.js / TypeScript, and Python into deterministic fingerprints for grouping, tracking, logging, and comparing recurring failures.

BUGDNA-7A3F21B9E4C018D2

Features

• Deterministic exception fingerprints (Java, TypeScript/Node.js, and Python)
• Shared language-neutral specification and cross-language compatibility test suite
• PII-safe normalization for emails and numeric identifiers
• Fingerprint knowledge base lookup for owners and runbooks
• Fluent fingerprint assertions for automated tests
• Root-cause, category, stability, and priority analysis
• Root-cause family clustering across different fingerprints
• Failure dependency graphs from causal chains
• Timestamped failure timelines and burst detection
• Deployment regression detection for new, resolved, and recurring fingerprints
• Fingerprint drift detection for recurring IDs whose signature shape changes
• In-memory concurrent failure aggregation
• Top failure reports for batch jobs
• Most-common skip reason analysis
• Topic-aware consumer failure tracking
• Log-file analysis CLI
• Log-to-log signature comparison
• Fingerprint similarity and regression diffs
• Build-time exception-handling validation for Maven and Gradle
• Spring MVC and WebFlux unhandled-exception capture
• SLF4J MDC integration
• OpenTelemetry span enrichment
• Actuator and Micrometer metrics

Requirements

Module	Runtime	Framework
Core library (bugdna-core)	Java 8+	None
Node.js / TypeScript (bugdna-js)	Node.js 18+	None
Python (bugdna-python)	Python 3.9+	None
Build scanner	Java 8+	Maven or Gradle
Spring Boot starter	Java 17+	Spring Boot 4.x
CLI	Java 8+	None

Installation

Java (Maven)

Core library:

<dependency>
    <groupId>io.github.arnabnandy7</groupId>
    <artifactId>bugdna</artifactId>
    <version>1.2.0</version>
</dependency>

Spring Boot starter:

<dependency>
    <groupId>io.github.arnabnandy7</groupId>
    <artifactId>bugdna-spring-boot-starter</artifactId>
    <version>1.2.0</version>
</dependency>

Maven build-time scanner plugin:

<plugin>
    <groupId>io.github.arnabnandy7</groupId>
    <artifactId>bugdna-maven-plugin</artifactId>
    <version>1.2.0</version>
</plugin>

Java (Gradle)

Core library:

implementation "io.github.arnabnandy7:bugdna:1.2.0"

Spring Boot starter:

implementation "io.github.arnabnandy7:bugdna-spring-boot-starter:1.2.0"

Gradle build-time scanner plugin:

plugins {
    id 'io.github.arnabnandy7.bugdna' version '1.2.0'
}

Node.js / TypeScript (npm)

npm install bugdna

Python (PyPI)

pip install bugdna

Documentation

• Documentation index
• Getting started
• Core vs Spring Boot starter
• Core library
• Failure tracking
• Spring Boot starter
• Build-time validation
• Command-line interface
• Configuration reference
• Observability
• API reference
• Architecture and data handling
• Language specification
• Node.js / TypeScript package
• Python package
• Troubleshooting
• Migration guide
• FAQ

Project

• Changelog
• Contributing
• License
• Core artifact
• Starter artifact

GitAds Sponsored