Harvester

Documentation - Listeners

The listeners configuration section is used to define the set of message listeners used by Harvester. A valid message listener must be derived from MessageListener.

<listeners>
    <listener binding="Local\DBWIN" mutex="DBWinMutex" type="Harvester.Core.Messaging.Sources.DbWin.OutputDebugStringListener, Harvester.Core" />
    <listener binding="Local\HRVSTWIN" mutex="HrvstWinMutex" type="Harvester.Core.Messaging.Sources.DbWin.OutputDebugStringListener, Harvester.Core" />
    <listener binding="Global\DBWIN" mutex="DBWinMutex" elevatedOnly="true" type="Harvester.Core.Messaging.Sources.DbWin.OutputDebugStringListener, Harvester.Core" />
    <listener binding="\\.\pipe\Harvester" mutex="HarvesterMutex" type="Harvester.Core.Messaging.Sources.NamedPipe.PipeMessageListener, Harvester.Core"/>
</listeners>

binding

A binding name that identifies the message channel to be used by the listener.
Default Value: none.

elevatedOnly

A true/false value indicating if elevated access (i.e., Administrator role) is required for the message listener to start.
Default Value: false.

mutex

A unique mutex name used by applications to determine if a specific message listener is running.
Default Value: none.

type

An assembly qualified name for a message listener type.
Default Value: none.

OutputDebugStringListener

Uses shared memory mapped files (i.e., OutputDebugString buffer) to read trace messages from individual applications. Typically used to read messages from Microsoft .NET 3.5 or earlier applications or if NamedPipes cannot be created.
Note: Starting with Microsoft .NET 4.0, when debugging an application in Visual Studio 2010 or later messages will be captured by this listener.

<listener binding="Local\DBWIN" mutex="DBWinMutex" type="Harvester.Core.Messaging.Sources.DbWin.OutputDebugStringListener, Harvester.Core" />

A valid binding name must begin with either the local (i.e., Local\...) or global (i.e., Global\...) session.

PipeMessageListener

Uses local named pipes to read trace messages from individual applications. Typically used to read messages from Microsoft .NET 4.0 or later applications or if capturing output from applications running in IIS.

<listener binding="\\.\pipe\Harvester" mutex="HarvesterMutex" type="Harvester.Core.Messaging.Sources.NamedPipe.PipeMessageListener, Harvester.Core"/>

A valid binding name must begin with a local pipe name (i.e., \\.\pipe\...).