8.4 DSTrace Messages

You can filter the trace messages based on the thread ID, connection ID, and severity of the messages.

Once you specify a filter for the messages, only the messages that fit the filter are displayed on the screen. All the other messages for the enabled tags will get logged into the ndstrace.log if the file is set to ON.

Only one filter is applicable at a time. Filter has to be specified for each session of DSTrace.

By default, the severity level is set to INFO, this means that all the messages with severity level more that INFO would be displayed. You can see the severity level by enabling the svty tag.

You can use iMonitor also to filter the trace messages. For more information, refer to iMonitor Message Filtering.

8.4.1 Linux

Complete the following procedure to filter the trace messages:

  1. Enable filtering with the following command:

    ndstrace tag filter_value

    To disable filtering, enter the following command:

    ndstrace tag

    Examples for enabling filtering:

    • To enable filtering for thread ID 35, enter the following:

      ndstrace thrd 35
    • To enable filtering for severity level fatal, enter the following:

      ndstrace svty fatal

      Severity levels can be FATAL, WARN, ERR, INFO, and DEBUG.

    • To enable filtering for connection ID 21, enter the following:

      ndstrace conn 21

    Examples for disabling filtering:

    • To disable filtering based on thread ID, enter the following:

      ndstrace thrd 
    • To disable filtering based on connection ID, enter the following:

      ndstrace conn 
    • To disable filtering based on severity, enter the following:

      ndstrace svty

Figure 8-5 Sample Trace Message Screen With Filters

8.4.2 Windows

Complete the following procedure to filter the trace messages:

  1. Select Start > Control Panel > NetIQ eDirectory Services

  2. In the Services tab, select dstrace.dlm.

  3. Click Edit > Options in the Trace window.

    The NetIQ eDirectory Trace Options dialog box is displayed.

    Figure 8-6 Trace Options Screen on Windows

  4. Click on the Screen tab.

  5. Select the filter option from the Filters group and enter the filter value.

    You can filter the messages based on:

    • Thread ID

    • Connection ID

    • Severity

    Before selecting any of the filters, ensure that it is enabled under Trace Line Prefixes.

    You can also disable the filtering by selecting None or unselecting the filter option.

    NOTE:

    • If you've selected Thread ID or Connection ID as your filter option and enter a value that does not exist, then the messages won't be displayed on the screen. However, all the other messages will still get logged to the ndstrace.log file.

    • Trace level severity does not work on Windows.