Telemetry Service Configuration (Client)

Configuration of Telemetry Service is not required, but it can be useful in gathering statistical information on the processing of Responder data. Follow the steps below to configure the Telemetry Service.

Any client machine will need the following configuration for Telemetry:

  1. Open Miner.Responder.Explorer.exe.config. By default, this file is installed here: \Program Files (x86)\Miner and Miner\Responder\Client\.
  2. In Miner.Responder.Explorer.exe.config find and edit the following XML:

    <appSettings>
        <add key="TelemetryService.Address" value="localhost:36745" />
        <add key="TelemetryService.Enabled" value="false" />

  3. Change the Address value of localhost to the server location for the database.
  4. Change the Enabled value to true.
  5. Save and close the config file.

Optional Configurations

Logging Events: To apply this optional configuration, locate the following XML and remove the comment code at the beginning (!--) and end (--) of the statement for in each of the Miner.Responder.DataServices.exe.config, Miner.Responder.ArchiveServices.exe.config, Miner.Responder.PredictionServices.exe.config, and Miner.Responder.QueryWindowsService.exe.config files. This makes all events that are normally logged through Log4Net (the ones that default to appearing in the Event Log) are instead logged to telemetry.

<log4net>
...
    <appender name="TelemetryAppender" type="Miner.Responder.TelemetryCore.TelemetryLogger, Miner.Responder.TelemetryCore, Version=10.1.0.0, Culture=neutral,PublicKeyToken=196beceb052ed5dc">
      <layout type="log4net.Layout.PatternLayout">
        <param name="ConversionPattern" value="[%t] %c - %m" />
      </layout>
    </appender>
...
<root>
<appender-ref ref="TelemetryAppender" />

SQLite Users Only: The <add key="TelemetryService.RotateSQLiteStorageOnStartup" value="false"/> appends the Telemetry.db file each time Telemetry runs and is not renamed. If this value is set to true, you then generate a new Telemetry.db file each time Telemetry runs. The previous file is renamed with a date and time stamp in the same database location.

QR code for this page

Was this helpful?