Compatibility Matrix for Java
Supported JVM versions, frameworks and environments for the Hud Java agent.
Latest version: java-sdk v0.3.2.
Supported Frameworks
These frameworks are instrumented automatically, with no code changes.
Web frameworks for providing API endpoints data:
| Framework | Framework Versions |
|---|---|
Spring MVC / Spring Boot (spring-boot-starter-web) | 2.3+ — tested on 2.3.9, 2.7.18, 3.5.14 |
Servlet API — javax.servlet and jakarta.servlet | Both namespaces |
| http4k | 6.x — tested on 6.47.1.0 |
Annotated controllers and functional routing (RouterFunctions.route()) are both covered.
The dividing line for Spring is Servlet versus reactive: spring-boot-starter-web is
covered, spring-boot-starter-webflux is not.
Message queue frameworks:
| Framework | Framework Versions |
|---|---|
| Spring Kafka | 2.x, 3.x |
Outbound call instrumentation:
| Client | Supported Versions | Notes |
|---|---|---|
| JDBC | All JDBC drivers | Statement and batch capture with SQL length cap |
| Apache HTTP Client 4.x/5.x | 4.x, 5.x (Classic, Fluent) |
Runtime Environment
These are the environments the agent runs in. The requirement is simply that you can add
-javaagent to the JVM's start command.
| Runtime | Supported |
|---|---|
| K8S / Openshift | Yes |
| AWS EKS / App Runner / Beanstalk / EC2 / Fargate / ECS | Yes |
| GCP GKE / Cloud Run / App Engine / Compute Engine | Yes |
| Azure AKS / Container Apps / App Service / Virtual Machines / Container Instances | Yes |
| DigitalOcean Droplets / Kubernetes | Yes |
| External servlet container (Tomcat, Jetty, Undertow) as a WAR | Yes — attach via CATALINA_OPTS / setenv.sh |
| AWS Lambda / GCP Cloud Functions / Azure Functions | Contact us |
| GraalVM native image | No — there is no JVM to attach an agent to |
Supported Runtimes
| Runtime | Runtime Versions |
|---|---|
| Java | 8, 11, 17, 21, 25 |
Supported Servers
| OS | CPU's |
|---|---|
| Linux | x64, arm64 |
| MacOS | Apple Silicon, Intel |
| Windows | Not supported — blocked by default; the agent will not start |
A Linux container running on a Windows host is fine — it is the JVM's operating system that
is checked, not the machine's.
Supported IDEs
| IDE | IDE Version | Supported OS |
|---|---|---|
| JetBrains Suite | 2023.2+ | MacOS |
| Visual Studio Code | 1.1.1+ | MacOS |
| Cursor | 1.1.1+ | MacOS |
Updated 15 days ago
What’s Next
You're now familiar with the technical stack required for working with the Hud agent on the JVM. For any issues or compatibility questions, contact us at [email protected].

