Skip to main content

replication (instance statistics)

Selecting the replication resource will display a list of available downstream replication instances used by this instance of AMPS.

Selecting an individual replication instance will display the following statistics:

MetricDescriptionType
authenticated_idThe ID used to authenticate the connection to this instance of AMPS.fixed
bytes_outNumber of bytes sent to this destination.cumulative
bytes_out_per_secRate of bytes sent.interval average
client_nameThe client name used for this destination.fixed
client_typeSpecifies whether client is a replication source or destination.fixed
connect_timeUTC timestamp of the last connection to this destination, in ISO-8601 format. Updated when the connection is reestablished.snapshot
destination_admin_addrThe admin address of the destination.fixed
destination_group_nameThe group name of the destination.fixed
destination_nameThe name of the destination.fixed
disconnect_countNumber of times replication destination has been disconnected.cumulative
disconnect_timeTimestamp of the last time the replication destination disconnected.snapshot
is_connectedBoolean telling whether replication destination is currently connected.snapshot
messages_outNumber of messages sent to this destination.cumulative
messages_out_per_secRate of messages sent to this destination.interval average
nameName of replication configuration.fixed
pass_throughBoolean stating whether messages received via replication can be forwarded on this connection.fixed
replication_typeOne of either sync or async.snapshot
seconds_behind

The current point in the transaction log that has been acknowledged by this destination.

This is calculated as the difference in seconds between the time that the last message acknowledged by the destination was written to the transaction log and the time that the most recent transaction was processed.

That is, if the last message that the destination has acknowledged was written to the local transaction log at 12:00:01.100 (one second and 100 ms after 12:00) and the current time is 12:00:03.212, the seconds behind shown in the current statistics would be approximately 2.112. Acknowledgments are transmitted at a specific interval (1s by default) from the destination instance to the source instance.

This value does not directly measure how far the destination is behind in receiving messages. The destination may have received the messages but still be waiting for acknowledgements from its own destinations configured for sync acknowledgement.

AMPS rounds any value less than or equal to 1 to 0.

snapshot

Statistics Database Tables: IREPLICATIONS_STATIC, IREPLICATIONS_DYNAMIC

Admin Path: /amps/instance/replication/<identifier>/<metric>

To manage a replication connection, use the replication resource under administrator. The following actions are available:

Admin Action Path: /amps/administrator/replication/<identifier>/<action>

Only destinations configured for sync acknowledgement can be successfully upgraded or downgraded. A destination configured for async acknowledgement always uses async acknowledgement.

ElementDescription
downgradeChange the current acknowledgement type of a destination configured for sync from sync to async.
upgradeRestore sync acknowledgement for a destination configured for sync that has been downgraded to async.
reconnectClose and reopen the connection to the remote instance.