Configuration schema for the out-of-process model

When used out-of-process, you must configure the Semantic Logging Application Block by using an XML configuration file in the runtime folder of the Out-Of-Process Host application or service. Figure 1 shows a high-level schematic view of the schema of this configuration file.

Figure 1 - A schematic view of the schema for the out-of-process configuration file

The following sections describe the elements shown in Figure 1 and the attributes for each one:

• configuration element
• traceEventService element
• sinks element
• consoleSink element
• customSink element
• flatFileSink element
• rollingFlatFileSink element
• sqlDatabaseSink element
• windowsAzureTableSink element
• sources element
• eventSource element
• arguments element
• filter element
• Formatter elements
• customEventTextFormatter element
• jsonEventTextFormatter element
• textEventTextFormatter element
• xmlEventTextFormatter element

configuration element

This is the top-level element in the configuration file. This is a required element. This element has two child elements and no attributes. The following table lists the child elements of the configuration element.

traceEventService element

The traceEventService element enables you to override the default settings for the trace event service. This element is optional. This element has no child elements. The following table lists the attributes for the traceEventService element.

sinks element

The elements in the top-level sinks element define the sinks used by the trace event service. The sinks element must contain at least one child element that is the name of a sink. The available sink elements are:

• consoleSink element
• customSink element
• flatFileSink element
• rollingFlatFileSink element
• sqlDatabaseSink element
• windowsAzureTableSink element

consoleSink element

This element specifies an instance of the Console event sink. It has a single sources child element. The following table lists the attributes of the consoleSink element.

customSink element

This element specifies an instance of a custom event sink. It has a single parameters child element that contains a list of parameters for this sink. The following table lists the attributes of the customSink element.

For more information about using the customSink element, see the topic Creating a custom event sink.

parameters and parameter elements

The parameters element contains one or more parameter elements. Each parameter element has name, type, and value attributes, and optionally contains a nested parameters element.

flatFileSink element

This element specifies an instance of the Flat File event sink. It has a single sources child element. The following table lists the attributes of the flatFileSink element.

rollingFlatFileSink element

This element specifies an instance of the Rolling Flat File****sink. It has a single sources child element. The following table lists the attributes of the rollingFlatFileSink element.

sqlDatabaseSink element

This element specifies an instance of the SQL Database sink. It has a single sources child element. The following table lists the attributes of the sqlDatabaseSink element. See the notes in the topic SQL Database event sink for more details about using this sink.

windowsAzureTableSink element

This element specifies an instance of the Azure Table Storage sink. It has a single sources child element. The following table lists the attributes of the windowsAzureTableSink element. See the notes in the topic Azure Table Storage event sink for more details about using this sink.

sources element

Each sink element contains a sources element that lists all of the event sources from which the sink receives trace messages. The event sources are defined in one or more eventSource child elements.

eventSource element

Each eventSource element specifies an event source from which the sink can receive trace messages. The following table lists the child elements of the eventSource element.

The following table lists the attributes of the eventSource element.

Notes

You should provide either the name or the id attribute but not both.

Given the following keyword definitions in an EventSource implementation:

[EventSource(Name = "MyCompany")]
  public class MyCompanyEventSource : EventSource
  {
    public class Keywords
    {
      public const EventKeywords Page = (EventKeywords)1;
      public const EventKeywords DataBase = (EventKeywords)2;
      public const EventKeywords Diagnostic = (EventKeywords)4;
      public const EventKeywords Perf = (EventKeywords)8;
    }
    ...
}

If you set the value of the matchAnyKeyword attribute to four, the event listener will capture log messages with the Diagnostic keyword. If you set the value of the matchAnyKeyword attribute to five, the event listener will capture log messages with the Page or Diagnostic keyword.

arguments element

This element can be used in conjunction with the filter element to sample and filter events received by the Out-of-Process Host. The arguments element contains a list of arguments in the form of one or more add elements, each containing key/value pairs that represent one argument key/value pair that will be passed to the EventSource implementation. This element is optional, and can occur only once.

The EventSource class accepts a range of arguments that control its behavior. For more information about the supported arguments, see Sampling and filtering events.

filter element

This element can be used in conjunction with the arguments element to sample and filter events received by the Out-of-Process Host. The filter element is optional, and can occur only once.

The filter element contains one or more process child elements that specify the processes from which events will be collected. Each process element contains only a name attribute that specifies the name of the process to filter.

For more information about using the filter element, see Sampling and filtering events.

Formatter elements

The sink elements flatFileSink, rollingFlatFileSink, consoleSink, and customSink can contain a single nested formatter element. The available formatter elements are:

• customEventTextFormatter element
• jsonEventTextFormatter element
• textEventTextFormatter element
• xmlEventTextFormatter element

customEventTextFormatter element

This element specifies an instance of a custom event text formatter. It has a single parameters child element that contains a list of parameters for this formatter. The following table lists the attributes of the customEventTextFormatter element.

For information about creating custom event text formatters, see Creating a custom event formatter.

jsonEventTextFormatter element

This element specifies an instance of the JSON event text formatter. It has no child elements. The following table lists the attributes of the jsonEventTextFormatter element.

textEventTextFormatter element

This element specifies an instance of the standard event text formatter. It has no child elements. The following table lists the attributes of the textEventTextFormatter element.

xmlEventTextFormatter element

This element specifies an instance of the XML event text formatter. It has no child elements. The following table lists the attributes of the xmlEventTextFormatter element.

This formatter generates XML that complies with the ETW Event Schema.

Next Topic | Previous Topic | Home | Community