This is the Visual Studio Code extension that adds Camel Debugger power by attaching to a running Camel route written in Java, Yaml or XML DSL.
Features
Camel Main mode for XML only (It implies that it is not working with Camel context specified in Camel XML file.)
Support use of Camel debugger by attaching to a running Camel route written in Java, Yaml or XML using the JMX Url
Support local use of Camel debugger by attaching to a running Camel route written in Java, Yaml or XML using the PID
Support remote debug through http (when using Jolokia on server-side)
Support a single Camel context
Add/Remove breakpoints
Support conditional breakpoints with simple language. See How to write condition with simple language for details.
Inspect variable values on suspended breakpoints
Resume a single route instance and resume all route instances
Pause/resume route definition. Technically, it suspend/stop and resume/start Camel routes depending on the kind of consumer.
Stepping when the route definition is in the same file
Allow to update variables:
in scope Debugger
the message body
a message header of type String
an exchange property of type String
Commands Run with JBang and Debug Opened Camel Integration, Run with JBang and Debug All Camel Integrations from workspace root and Run with JBang and Debug All Camel Integrations from containing folder. It allows a one-click start and Camel debug in simple cases. This command is available through:
Command Palette. It requires a valid Camel file opened in current editor.
Contextual menu in File explorer. It is visible to all *.xml, *.java, *.yaml and *.yml.
Codelens at the top of a Camel file (the heuristic for the codelens is checking that there is a from and a to or a log on java, xml and yaml files).
Run or debug... quick action editor
Commands Run with JBang and Debug Opened Camel Integration, Run with JBang Opened Camel Integration and Run with JBang All Camel Integrations from workspace root
Support automatic reload mode --dev by default
It requires a valid Camel file defined in Yaml DSL (.yaml|.yml) opened in editor.
Contextual menu in File explorer. It is visible to all *.yaml and *.yml.
Codelens at the top of a Camel file.
Run or debug... quick action editor
Supports adding extra parameters provided by the Run with JBang * commands. (For both running and debugging the application)
Configuration snippets for Camel debugger launch configuration
Configuration snippets to launch Camel application ready to accept a Camel debugger connection using JBang, Maven with Camel maven plugin or Quarkus Devs
Java Runtime Environment 17+ with com.sun.tools.attach.VirtualMachine (available in most JVMs such as Hotspot and OpenJDK). The java.home VS Code preferences can be used to use a different version of JDK than the default one installed on the machine.
The Camel instance to debug must follow these requirements:
Camel 3.16+
Have camel-debug on the classpath
Have JMX enabled
⚠️ For some features, The JBang must be available on a system command-line.
How To Debug - example
Ensure jbang is available on system command-line
Open a Camel route which can be started with JBang
Call command Palette (Ctrl + Shift + P), and pick command Run with JBang and Debug Opened Camel Integration or click on codelens Camel Debug with JBang which appears on top of the file or use the quick editor action
Wait until the route is started and debugger is connected
Put a breakpoint on the Camel route
Debug! 🔥
Documentation
Our full documentation is located in GitHub pages. Included are details about all of DAP Client for Visual Studio Code capabilities with examples and detailed information.
If you'd like to help us get better, we appreciate it! Check out our Contribution Guide on how to do that.
Data and Telemetry
The DAP Client for Visual Studio Code extension collects anonymous usage data and sends it to Red Hat servers to help improve our products and services. Read our privacy statement to learn more. This extension respects the redhat.telemetry.enabled setting which you can learn more about at How to disable telemetry reporting.
