Configuring Trace Source Categories

Trace source categories associate log entries with their target listener(s). You can configure the following two category types:

• Categories that specify the logging categories you want to use. When you create a log entry, you can assign it to one or more categories. Each category can filter the log entry based on its severity (such as Critical, Error, Warning, or Information), and route it to one or more trace listeners (logging targets).
• Special Categories that automatically receive all log entries, unprocessed log entries, or log entries where an error occurred during logging. Each of these special categories can filter the log entry based on its severity (such as Critical, Error, Warning, or Information), and route it to one or more trace listeners (logging targets).

Configuring Trace Source Categories

The next procedure describes how to assign log entries to categories by using the configuration tool.

To configure Categories

1. Add a category by clicking the plus sign icon in the Categories pane and clicking Add Category. A new category is added to the configuration with its properties displayed. If a category's properties are not visible, click the expander arrow for the category you want to configure.
2. (Optional) In the properties pane, edit the name of the category.
3. Click the Minimum Severity property and select the severity level of the events that will be assigned to this category. For information about the source level values, see the tables that follow this procedure.
4. Click the Auto Flush property and select True if you want the listener to flush its data to the target after each new entry is written to this source. Select False if you want to flush the entries in your code only when required.
5. To add a logging target listener, click the Listeners property's plus icon and select a listener from the drop-down list.
6. To remove a listener from the list, click the cross icon. You can also make a new selection from the drop-down list for an existing listener to change the contents of the list.
7. Repeat the procedure for each category you require.

Configuring Trace Sources Special Category

The next procedure describes how to configure the special categories. The Logging Errors & Warnings special category receives log entries for errors and warnings that occur during the logging process. The Unprocessed Category special category receives all log entries that are not processed by a source category (such as entries that specify a category that is not configured). The All Events special category receives all log entries.

To configure Special Categories

1. In the Special Categories section, click the special source category you want to configure.
2. (Optional) In the properties pane, type the name of the category.
3. (Optional) Set the Minimum Severity property. For information about the SourceLevels property values, see tables that follow this procedure.
4. Click the Auto Flush property and select True if you want the listener to flush its data to the target after each new entry is written to this source. Select False if you want to flush the entries in your code only when required.
5. To add a logging target listener, click the Listeners property's plus icon and select a listener from the drop-down list.
6. To remove a listener from the list, click the delete(x) icon. You can also make a new selection from the drop-down list for an existing listener to change the contents of the list.
7. Repeat the procedure for each special category source you wish to configure.

Source Category Properties

The following table lists the Category Source properties.

Severity (SourceLevels) Values

The following table lists the possible values for the severity property of a category or a trace listener.