Configure the tracker submit queue

Abstract

How to disable or configure the Sitecore submit queue's storage facility and re-submit interval.

When the tracker submits a session to xConnect, but xConnect is temporarily unavailable, the tracker classifies this as a transient error (meaning it assumes xConnect becomes available later). The tracker adds the session to a submit queue that, by default, serializes the session to disk. The submit queue service later re-submits the session to xConnect at configurable intervals.

Disable or enable the submit queue

The submit queue is enabled by default. You can disable the submit queue, but this means you might lose data if xConnect is unavailable.

To disable the submit queue:

  1. Go to the \App_Config\Sitecore\Marketing.Tracking\Sitecore.Analytics.Tracking.config file.

  2. Configure the Analytics.UseSubmitQueue setting to false.

    <setting name="Analytics.UseSubmitQueue" value="false" />

Choose the submit queue implementation

The submit queue is stored on disk by default. You can choose where on the disk the queue is stored, or you can choose another type of storage.

To choose the submit queue implementation:

  1. Go to the \App_Config\Sitecore\Marketing.Tracking\Sitecore.Analytics.Tracking.config file.

  2. Locate the submitQueue ,queue setting.

  3. Configure the type attribute to Sitecore.Analytics.Data.DataAccess.SubmitQueue.FileSubmitQueue to have the submit queue stored on disk. Configure the param child setting to a disk location.

    <submitQueue>
        <queue type="Sitecore.Analytics.Data.DataAccess.SubmitQueue.FileSubmitQueue, Sitecore.Analytics"
                singleInstance="true">
            <param desc="folderPath">$(dataFolder)/Submit Queue</param>
        </queue>
    </submitQueue>

Note

Sitecore only offers the FileSubmitQueue option for storing the submit queue, but you can create your own storage options and configure them here.

Configure the re-submit interval

You can choose how often you want the submit queue service to re-submit queued data to xConnect:

  1. Go to the \App_Config\Sitecore\Marketing.Tracking\Sitecore.Analytics.Tracking.Database.config file.

  2. Locate the submitQueue ,backgroundService, Interval setting.

  3. Enter the number of seconds between each time the submit queue service must re-submit queued data to xConnect.

    <submitQueue>
      <backgroundService type="Sitecore.Analytics.SubmitQueueService, Sitecore.Analytics">
        <!-- Service wakeup interval in seconds. -->
        <Interval>60</Interval>
      </backgroundService>
    </submitQueue>