Request Tracing in Payara Micro

In a previous blog post, we explored the benefits of using Request Tracing in Payara Server. Payara Micro streamlines the configuration process, allowing you to tailor request tracing directly through command-line options. Let's have a look at how you can customize this tool for your Payara Micro applications.

The Core Options

• enableRequestTracing: This is the main switch for activating the Request Tracing Service. You can optionally include a time threshold value and unit with this flag. For example, --enableRequestTracing 500ms will enable tracing on requests taking longer than 500 milliseconds.
  
  
• requestTracingThresholdUnit and requestTracingThresholdValue: Use these to explicitly define your desired time unit (e.g., SECONDS, MINUTES, NANOSECONDS) and the numerical threshold value that triggers tracing.
  
  
• enable/requesttracingadaptivesampling...: Adaptive sampling offers a dynamic way to manage tracing. When enabled, Payara Micro will automatically adjust how many requests get traced, aiming to maintain a target count of traces over a period of time. You can further customize this behavior with the accompanying options.
  
  

Quick Tip: Shorthand Configuration For faster adjustments, combine the --enableRequestTracing flag with your desired threshold value and unit in a single string. Example: java -jar payara-micro.jar --enableRequestTracing 2s

Need More Control?

For the most granular configuration, you can use post-boot command files. These files allow you to execute the same set of asadmin commands used to manage the Request Tracing Service in Payara Server, giving you full access to all available settings.

Reference the Docs

Download Payara Micro Community and head over to the Payara Micro Request Tracing documentation, for a detailed breakdown of configuration options, and examples to guide your setup. Happy Tracing!