Request Tracing in Payara Micro

Since Payara Micro 4.1.1.164

The Request Tracing service works the same on Payara Micro and will trace the same events described in its documentation.

Usage

Payara Micro exposes 3 command line options to configure request tracing. To be explicit about the desired configuration, all three arguments can be used, but this is not necessary since the command to enable tracing can also accept explicit configuration options.

Since all three options can be specified with an extra parameter following the --enableRequestTracing argument as a shorthand, a detailed summary of this shorthand usage is given below.

Configuration Options

Parameter Summary

enableRequestTracing

Enables the service when present.

A supplementary parameter can be provided with this option to encapsulate the value and unit options, for example, the following will enable the service with a threshold of 4ms:

java -jar payara-micro.jar --enableRequestTracing 4ms

requestTracingThresholdUnit

Accepts a String value determining the time unit, defaulting to seconds if no value is given. The accepted strings are (case insensitive):

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

requestTracingThresholdValue

Accepts a long value to determine the threshold value before a request is traced, defaulting to 30 if no value is entered.

Shorthand Notation

To enable and configure request tracing with a single command, the --enableRequestTracing option allows you to provide one string following it to set the threshold unit and/or value.

In other words, the value and unit need to be a single string with no spaces, so 500ms would be allowed, but 500 ms would not. In the second case, the unit is ignored and the default SECONDS is kept.

Notation for units is as follows:

Unit Acceptable notation

NANOSECONDS

  • Nanoseconds (case-insensitive)

  • Nanosecond (case-insensitive)

  • ns

MICROSECONDS

  • Microseconds (case-insensitive)

  • Microsecond (case-insensitive)

  • us

  • μs

MILLISECONDS

  • Milliseconds (case-insensitive)

  • Millisecond (case-insensitive)

  • ms

SECONDS

  • Seconds (case-insensitive)

  • Second (case-insensitive)

  • s

MINUTES

  • Minutes (case-insensitive)

  • Minute (case-insensitive)

  • Mins (case-insensitive)

  • Min (case-insensitive)

  • m

HOURS

  • Hours (case-insensitive)

  • Hour (case-insensitive)

  • h

DAYS

  • Days (case-insensitive)

  • Day (case-insensitive)

  • d

Example usages

java -jar payara-micro.jar --enableRequestTracing

Enable request tracing

java -jar payara-micro.jar --enableRequestTracing ns

Enable request tracing and set threshold unit to nanoseconds (value defaults to 30)

java -jar payara-micro.jar --enableRequestTracing 2

Enable request tracing and set threshold value to 2 (unit defaults to SECONDS)

java -jar payara-micro.jar --enableRequestTracing 4ms

Enable request tracing and set threshold to 4 microseconds

Exercise caution when using the shorthand notation together with other parameters. Due to the way the parser works, the last parameter entered will override the previous. For example:

java -jar payara-micro.jar --requestTracingThresholdUnit DAYS --enableRequestTracing 1ns

Will enable request tracing, and set the threshold to 1 NANOSECOND, while

java -jar payara-micro.jar --enableRequestTracing 1ns --requestTracingThresholdUnit DAYS

Will enable request tracing, and set the threshold to 1 Day