X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=contents%2Fusing-lttng%2Fcontrolling-tracing%2Ftaking-a-snapshot.md;h=0a4ccf3cd1beb44a1140f9e0a94e03db18b9b550;hb=b2c331acfd2732cad1624f50f69a8fdce6f1cd41;hp=fd6ef22bcdc048b1e9ced662618bec7051c959d7;hpb=5e0cbfb01373c18e521217342fd8a9159cc186b1;p=lttng-docs.git diff --git a/contents/using-lttng/controlling-tracing/taking-a-snapshot.md b/contents/using-lttng/controlling-tracing/taking-a-snapshot.md index fd6ef22..0a4ccf3 100644 --- a/contents/using-lttng/controlling-tracing/taking-a-snapshot.md +++ b/contents/using-lttng/controlling-tracing/taking-a-snapshot.md @@ -17,7 +17,7 @@ events with the newest. At any time, either when the tracers are started or stopped, you may take a snapshot of those sub-buffers. There is no difference between the format of a normal trace file and the -format of a snapshot: viewers of LTTng traces will also support LTTng +format of a snapshot: viewers of LTTng traces also support LTTng snapshots. By default, snapshots are written to disk, but they may also be sent over the network. @@ -28,9 +28,11 @@ lttng create --snapshot my-snapshot-session Next, enable channels, events and add context to channels as usual. -Once a tracing session is created in snapshot mode, channels will be -forced to use the overwrite mode (`--overwrite` option of the -`enable-channel` command) and have an `mmap()` channel type +Once a tracing session is created in snapshot mode, channels are +forced to use the +[overwrite](#doc-channel-overwrite-mode-vs-discard-mode) mode +(`--overwrite` option of the `enable-channel` command; also called +_flight recorder mode_) and have an `mmap()` channel type (`--output mmap`). Start tracing. When you're ready to take a snapshot, do: @@ -39,7 +41,7 @@ Start tracing. When you're ready to take a snapshot, do: lttng snapshot record --name my-snapshot -This will record a snapshot named `my-snapshot` of all channels of +This records a snapshot named `my-snapshot` of all channels of all domains of the current tracing session. By default, snapshots files are recorded in the path returned by `lttng snapshot list-output`. You may change this path or decide to send snapshots over the network @@ -64,5 +66,5 @@ taking it with the `--max-size` option: lttng snapshot record --name my-snapshot --max-size 2M -Older recorded events will be discarded in order to respect this +Older recorded events are discarded in order to respect this maximum size.