Dynamic JVM Configuration for Data Processor

Beginning in v7.2.1, the Data Processor supports dynamic JVM configuration. Administrators can tune JVM settings at runtime through the Metric Insights UI without manually editing configuration files. Changes are detected automatically and applied through an automatic service restart.

NOTE: Modify these variables at your own risk. Invalid JVM options can prevent the Data Processor from starting. Always validate JVM flags before applying them in production.

1. Configure Data Processor System Variables

Access Admin > System > System Variables

NOTE: Values for these System Variables are automatically picked up by the Data Processor on each refresh cycle. Clicking [Commit Changes] is not required.

  1. Enter DP_OPTION in the search field.
  2. Use the following System Variables for JVM configuration. To edit a variable value, click the gear icon, enter a new value, then [Save]:
    • DP_OPTION_XMX: Override the default Java heap size (-Xmx).
      • Specify without the -Xmx prefix; e.g., 8g or 4096m.
    • DP_OPTION_GC: Override the default Garbage Collector.
      • Example: -XX:+UseG1GC
    • DP_OPTION_EXTRA_OPTS: Enter any additional JVM options to append to the startup command. Separate multiple options with spaces.
    • DP_OPTION_COMMAND_REFRESH_TIMEOUT: Interval in seconds at which the service checks for configuration changes.
      • Default: 300

2. Behavior & Defaults

  • If DP_OPTION_XMX, DP_OPTION_GC, or DP_OPTION_EXTRA_OPTS are left empty, the built-in Data Processor defaults are used:
    • Heap: derived from the system memory allocation setting.
    • GC: -XX:+UseParallelGC
    • Extra opts: a preconfigured set of GC logging flags writing to logs/gc.log
  • DP_OPTION_COMMAND_REFRESH_TIMEOUT defaults to 300 seconds (5 minutes) and controls how often the service polls for changes to the three System Variables above.

3. Examples

Increase heap memory to 12 GB:

DP_OPTION_XMX = 12g

Switch to G1 Garbage Collector:

DP_OPTION_GC = -XX:+UseG1GC

Add extra JVM flags:

DP_OPTION_EXTRA_OPTS = -Dtest.flag=extra_opts_test -XX:+HeapDumpOnOutOfMemoryError

Check for configuration changes every 60 seconds:

DP_OPTION_COMMAND_REFRESH_TIMEOUT = 60