ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

The replica activity log

  • Viewing the log

Whenever a replica creation or synchronization process is performed with ArcGIS Desktop, whether it be connected or disconnected, detailed information about the process is recorded in a replica activity log. You can use this information to troubleshoot errors or to examine replica creation and synchronization performance.

The information in the replica activity log is roughly equivalent to the information that is shown in the progress dialog box when a replica process is running. This can include the following:

  • ERRORS—Errors that occurred while running a process
  • WARNINGS—How many warnings occurred while running a process
  • Operation Name—The name of the process that was run
  • Time Completed—The date and time when the process finished
  • Operation Info—General information about the process

You can choose between five levels of detail to record, as well as where to create and update the log on your machine. You make these settings within ArcMap:

  1. In the Distributed Geodatabase toolbar, click Distributed Geodatabase.
  2. Click Options.
  3. Click the General tab.
  4. Specify the path and name to the replica activity log. If you go with the default, the log file is called ReplicaLog.dat and resides in the Application Data folder.
  5. Specify the log level.
  6. Click OK.

A single replica process may involve more than one computer; therefore, information on the process could be divided between replica activity logs on two or more computers. For example, in a disconnected environment, changes are synchronized by exporting from a data sender and importing into a data receiver. In this case, the export changes information is logged on the computer where the export process took place, while the import changes information is logged on the computer where the import process was performed. The replica activity log grows over time as information from each new replica process is appended to the file.

If you perform replication through ArcGIS Server, the information is not recorded in the replica activity log. Instead, it is recorded in the server activity log and can be accessed through the ArcGIS Server Manager.

The replica activity log is different from the replica log that is provided for each replica from the replica manager in ArcCatalog and ArcMap. The replica log provided through the replica manager stores information in the geodatabase for synchronization events and includes error information if there are errors. It can be used to keep track of when changes have been sent and received and, like the activity log, can also be used to retrieve error information. The error information in the activity log is more detailed since it includes the operation that was executing when the error occurred.

Viewing the log

The contents of the ReplicaLog.dat file can be viewed directly in a text editor.

Optionally, the Replica Activity Log Viewer, an ArcMap custom add-in, provides a formatted view of the replica activity log file.

The following is an example of a formatted replica activity log:

Formatted view of the replica activity log viewer in ArcMap

In this case, the activity log contains information about a single replica creation process. The top of the report indicates that there are 0 errors and 0 warnings in the log. The table describes the operations that occurred during the replica creation process as follows:

  • CheckOutMessage—A replica creation process was started for a replica named MyCheckOut at 6:23:12 PM.
  • ExtractFullData—The first step was to extract the data and schema. Extraction involves creating a feature class on the target, then copying data from the source to the target.
  • ConvertFeatureClass—In this example, only a single feature class, US_States, was being replicated. This row indicates that the feature class was created in the target at 6:23:12 PM.
  • WriteFeatures—A total of 51 features were copied from the source to the target for the US_States feature class at 6:23:13 PM. By comparing with the previous step, we can see that it took one second to copy the features.
  • Register CheckOut—The last step was to register the replica on the source and target geodatabases. From the time completed, we can see that it took less than one second to register the replicas.

To access and install the ArcMap Replica Activity Log Viewer custom add-in to see a formatted view of the information in the replica activity log, see the technical article How To: Get a formatted view of the Replica Activity Log.

Related topics

  • A quick tour of replica management

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2020 Esri. | Privacy | Legal