Part III Configure Events and Flight Recorder

This section describes how to configure events and Flight Recorder to optimize their performance and control their behavior.

Each event has the following predefined settings:

  • @Enabled: Specifies whether the event is recorded. The default value is true. See Enable and Disable Events.
  • @Threshold: Specifies the duration below which an event is not recorded. The default is 0 (no limit). See Event Threshold.
  • @Period: Specifies the interval at which the event is emitted, if it is periodic. The default value is everyChunk, which means that the periodic event will be emitted at least once in the recording. See Periodic Events
  • @StackTrace: Specifies whether the stack trace from the Event::commit() method is recorded. The default value is true. See Printing Event Stack Trace.

Flight Recorder provides various options to filter events; see Filter Events with SettingDefinition.

It's recommended that you specify a preconfigured configuration, which contains a collection of settings that control how much information Flight Recorder generates; see Flight Recorder Configurations. If you don't specify a preconfigured configuration, then Flight Recorder records information about all events; it monitors the running system at an extremely high level of detail and produces enormous amounts of data.