Trigger Action Types

## Trigger Action Types |

The following trigger action types are available in the trigger wizard for configuring triggers:

- Start recording

  Symbol:

  Starts recording any of

  - CPU data

    With the "Reset" check box, you can choose whether the previously recorded CPU data should be cleared or not.

  - Allocation data

    With the "Reset" check box, you can choose whether the previously recorded allocation data should be cleared or not.

  - Thread data
  - VM telemetry data

  With the "Reset" check boxes for CPU data and allocation data, you can choose whether the previously recorded data should be cleared or not.

- Stop recording

  Symbol:

  Stops recording any of

  - CPU data
  - Allocation data
  - Thread data
  - VM telemetry data
- Trigger heap dump

  Symbol:

  With this action you can trigger a heap dump as in the heap walker. Accordingly, you can select whether to

  - Remove unreferenced and weakly referenced objects.
    This is effectively like a full GC before taking the snapshots, just that the GC is performed in the internal data structures of the profiling agent.
  - Select recorded objects only
    Note that if you select this option and have not recorded any allocations, the heap walker will show the empty object set.
  - Record primitive data
    This has no effect with Java 1.5 and JVMTI where primitive data cannot be recorded. Java 1.2-1.4 and Java 1.6+ fully support this option.
- Save snapshot

  Symbol:

  With this action you can save a JProfiler snapshot of all profiling data to disk.

  In addition to the name of the snapshot file you can specify whether a number should be appended to the file name to prevent old snapshot files from being overwritten. Note that the path is relative to the working directory of the profiled JVM and that the snapshot is saved on the remote machine if you profile remotely.

- Create an HPROF heap dump

  Symbol:

  Requirements: Java 1.6+

  With this action you can save an HPROF heap snapshot of all profiling data to disk. For the "Out of memory exception" event type, this is the only supported action.

  In addition to the name of the snapshot file you can specify whether a number should be appended to the file name to prevent old snapshot files from being overwritten. Note that the path is relative to the working directory of the profiled JVM and that the snapshot is saved on the remote machine if you profile remotely.

  HPROF heap dumps also offer the option to only save referenced objects.

- Wait for the event to finish

  Symbol:

  For event types that have a duration, such as the method invocation event or the threshold events, you can use this action to execute some actions not at the start of the event but rather after the event is finished.

- Override thread status for current method

  Symbol:

  This action is only available for the method invocation event type and allows you to change the thread status for the duration of the methods that are associated the the trigger. The thread status is configurable.

- Print method invocation

  Symbol:

  This action is only available for the method invocation event type and allows you print details about the current method invocation including parameters and return value to the output stream configured in the trigger output options.

- Invoke interceptor

  Symbol:

  This action is only available for the method invocation event type and allows you to invoke an interceptor when the methods associated the the trigger are invoked. Interceptors can be developed with the JProfiler API and can also be added with VM parameters. Please see the `api` directory for documentation and samples. The advantage of adding the interceptor with a trigger is that you do not have to specify the methods and signatures in the interceptor class.

  You can enter the interceptor class manually or use the [...] button to scan the class path configured in the application settings for all classes extending `com.jprofiler.api.agent.interceptor.Interceptor`.

- Add bookmark

  Symbol:

  With this action you can add a boookmark to the time-resolved views. You have to enter a description for the bookmark.

- Sleep

  Symbol:

  With this action, you can sleep a specified amount of time until the next action in the list is executed. Please note that this does not block the current thread in the JVM. For example, you can use this action to start CPU recording, record 10 minutes, stop CPU recording and save a snapshot.

- Print message

  Symbol:

  With his action you can print an arbitrary message to the output stream configured in the trigger output options.