diff --git a/docs/md/trace.md b/docs/md/trace.md index 0b3e0f0367..d8e3eb363d 100644 --- a/docs/md/trace.md +++ b/docs/md/trace.md @@ -19,4 +19,13 @@ In order to customize when tracing is enabled and disabled, a trace specification file can be passed to \vt via a command-line flag: `--vt_trace_spec --vt_trace_spec_file=filename.spec`. -For details about vt's Specification File see \ref spec-file \ No newline at end of file +For details about vt's Specification File see \ref spec-file + +\section incremental-tracing Incremental Trace Output + +The trace events can be configured to be saved to the file in the incremental matter. +To configure the interval of the flushes use the `--vt_trace_flush_size=X` parameter. +The `X` stands for the number of trace events before the next flush. + +\note The incremental flushing will be blocked in the case of an incomplete user notes. +In that scenario there will be no output to the files. All trace events will be kept in memory and will be tried to be flushed on the next interval if the incomplete notes where closed. diff --git a/src/vt/trace/trace_lite.h b/src/vt/trace/trace_lite.h index 7952d3f835..748a30a2a5 100644 --- a/src/vt/trace/trace_lite.h +++ b/src/vt/trace/trace_lite.h @@ -236,6 +236,9 @@ struct TraceLite { /** * \brief Flush traces to file * + * \note The flush will be blocked when having an incomplete user notes. + * In that case method will not flush any traces. + * * \param[in] useGlobalSync whether a global sync should be invoked before * flushing output */