Publication Information, Tracer Tokens (SQL Server 2005 and Later)

Applies to: SQL Server Azure SQL Managed Instance

The Tracer Tokens tab allows you to validate connections and to measure the latency of a system that uses transactional replication. A token (a small amount of data) is written to the transaction log of the publication database, marked as though it were a typical replicated transaction, and sent through the system, allowing a calculation of:

  • How much time elapses between a transaction being committed at the Publisher and the corresponding command being inserted in the distribution database at the Distributor.

  • How much time elapses between a command being inserted in the distribution database and the corresponding transaction being committed at a Subscriber.

From these calculations, you can answer a number of questions, including:

  • Which Subscribers take the longest to receive a change from the Publisher?

  • Of the Subscribers expected to receive the tracer token, which, if any, have not received it?

Options

To change the way that the grid displays data, right-click the grid, and then click one of the following options:

  • Sort: Sort on one or more columns in the Sort Columns dialog box.

  • Choose Columns to Show: Select which columns to display and the order in which to display them in the Choose Columns dialog box.

  • Filter: Filter rows in the grid based on column values in the Filter Settings dialog box.

  • Clear Filter: Clear any filter settings for the grid.

Filter settings are specific to each grid. Column selection and sorting are applied to all grids of the same type, such as the publications grid for each Publisher.

Insert Tracer
Click to insert a tracer token in the transaction log at the Publisher.

Time inserted
Select a time at which a tracer token was inserted to display latency information from that time. By default, information from the most recent time is displayed.

Note

Tracer token information is retained for the same time period as other historical data, which is governed by the history retention period of the distribution database. For information about changing distribution database properties, see View and Modify Distributor and Publisher Properties.

Subscription
The name of each subscription to the publication.

Publisher to Distributor
The elapsed time between a transaction being committed at the Publisher and the corresponding command being inserted in the distribution database at the Distributor. A value of Pending indicates that the token has not yet reached the Distributor. If the pending state persists, ensure that the Log Reader Agent is running.

Distributor to Subscriber
The elapsed time between a command being inserted in the distribution database and the corresponding transaction being committed at a Subscriber. A value of Pending indicates that the token has not yet reached the Subscriber. If the pending state persists, ensure that the Distribution Agent is running.

Total Latency
The elapsed time between a transaction being committed at the Publisher and the corresponding transaction being committed at the Subscriber. This represents the end-to-end latency of the replication system for this Subscriber at this time. A value of Pending indicates that the token has not yet reached the Subscriber.

See Also

Start and Stop a Replication Agent (SQL Server Management Studio)
Start the Replication Monitor
Measure Latency and Validate Connections for Transactional Replication
Monitor Performance with Replication Monitor
Monitoring Replication
Replication Agents Overview