DTrace commands

comment

Lets you type a comment to add to the trace output.

display

Displays the selected trace entries. You can specify the start entries and end entries in a range, and choose whether to apply a filter to those entries.

filter

Lets you filter the contents of the trace by specifying the text strings that the entries either must contain (includes) or cannot contain (excludes). You can type the following commands at the DT Filter> prompt:

+ string [;string ] or Include string [;string ]

Adds the nominated strings to the filter include list. These strings are case-sensitive.

- string [;string ] or exclude string [;string ]

Adds the nominated strings to the filter exclude list. These strings are case-sensitive.

clear [Includes|Excludes|Both]

Deletes all the include strings from the filter, all the exclude strings, or both.

delete string

Deletes the nominated string from the filter.

exit or quit

Exits filter management.

reset

Resets the filter to the default settings.

view

Displays the current filter settings.

log

Specifies the name (and optionally the full path) of the file to which DTrace logs the trace. The default file is C:\Program Files\Enterprise Vault\DTrace.log.

monitor

Displays the trace live in the console but does not write it to disk. Press Ctrl+C to stop the console output.

open

Lists the available log files and lets you open them in a text editor.

registry

Displays the entries under the following key in the Windows registry:

HKEY_LOCAL_MACHINE\SOFTWARE\KVS\Enterprise Vault

reset

Resets the trace options.

save

Specifies the name (and optionally the full path) of the file to which DTrace saves the selected trace entries. You can specify the start entries and end entries in a range, and choose whether to apply a filter to those entries.

set

Sets the monitoring level for a service or component. The available levels are Off (o), Brief (b), Medium (m), and Verbose (v). Specify the monitoring level as follows:

set servicename_or_ID level

For example:

set ArchiveTask v

set 59 m

All lines of code have a minimum monitoring level, and these are viewable within the DTrace log files. For example, if you set the logging level to Medium, only code lines that are marked for Brief and Medium logging show in the log file.

trigger

Starts logging after a particular string appears in the trace. You set up triggers using the same syntax as for filters.

version

Displays version information on the executable files in the Enterprise Vault program folder (normally C:\Program Files\Enterprise Vault).

view

Lists all the available processes and services against which you can run DTrace.

This list may change slightly depending on what is loaded or installed. It is always a good idea to use view first to see a current list of processes and their IDs. This is particularly important if you want to set a monitoring level with an ID rather than using the name of the process.

watch

Records the specified number of trace entries in the log after a trigger filter that you have defined with the trigger command has taken effect.