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.