Advanced features

This chapter details advanced configuration options for XRebel Hub. Please head over to for more information about XRebel Hub.

Microservices configuration

In order to profile distributed applications or microservices, add XRebel Hub Agents to all connected applications.


Keep in mind that there are two methods to collect microservices transactions:

  1. Configuring all applications to share the same name. All traces will be collected into one application view on the dashboard using that name.
  2. Using separate names for all connected applications. Transactions are separately collected and displayed under each separate application. The top level applications will still display all transactions from connected applications.


End-to-end transactions will be highlighted using the remote2icon icon.

Managing application versions

XRebel Hub automatically detects the default Implementation-Version and Specification-Version manifest entries where possible. In case of manifest conflicts, use the configurations provided below.


Use your pom.xml to specify the application versions for XRebel Hub. Add a JAR or WAR build plugin to your configuration:

                 <!--or <artifactId>maven-jar-plugin</artifactId>-->

For more information:


Include the following in your build.gradle file:

war { // or jar
  version = 'my-version-3.14'
    manifest {
      attributes("XRebel-Hub-App-Version": version)

For more information:


Add the following to your jar or war task in build.xml:

      <attribute name="XRebel-Hub-App-Version" value="${version}"/>

For more information:

JVM arguments

Add the version parameter to your application startup. The JVM argument overrides all other version settings.


Custom profiling

XRebel Hub Agents can be configured to use a customized profiling setup. This is useful for adding requests that would normally not be picked up by XRebel Hub (e.g. desktop applications, non-HTTP requests). To do this:

  1. Download the customized configuration file.
  2. Edit the file to set up customized entry points. Detailed instructions are contained within.
  3. Save the file in the same location as the XRebel Hub Agent JAR file.
  4. Restart your application.