使用复本日志

在 Standard 或 Advanced 许可等级下可用。

ArcGIS Pro 中使用地理数据库复制时,无论在线或离线,以下类型的日志将用于追踪有关创建和同步复本时发生的详细过程的信息:

  • 复本活动日志
    • 记录创建或删除复本的时间。
    • 记录有关复本之间的同步过程的详细信息。
    • 可使用已记录信息对错误进行故障排除或检查复本创建和同步性能。
  • 复本日志
    • 记录复本同步事件,例如发送和接收更改的时间。
    • 如果在复本同步期间发生错误或冲突,则将提供错误说明和解决方案。

要了解有关这些日志类型的详细信息,请参阅以下复本活动日志复本日志

复本活动日志

在 ArcGIS 中执行复本创建或同步过程时,有关过程的详细信息将在 ArcGIS Pro 复本活动日志中记录。

单个复制进程可能涉及不止一台计算机;因此,关于该进程的信息可以分开位于两台或更多计算机上的复本活动日志中。 例如,在离线环境中,通过将变更从数据发送方导入至数据接收方来实现同步。 在这种情况下,导出变更消息记录在发生导出进程的计算机上,而导入变更消息记录在执行导入进程的计算机上。 随着每个新复本过程的信息不断追加到复本活动日志中,此文件也会逐渐增大。 可使用此信息对错误进行故障排除或检查复本创建和同步性能。

ArcGIS Pro 复本活动日志比复本日志更详细,并且包括已执行的每个操作以及与该操作相关联的信息,例如可能已发生的任何错误。 要控制复本活动日志中记录的位置和细节层次,您将需要访问日志记录属性,这将在下一节中讨论。

访问复本日志记录属性

可以从几个要记录的详细信息级别中进行选择,还可以在计算机上选择 ArcGIS Pro 复本活动日志的创建和更新位置。 要访问并设置复本日志记录属性,可通过 ArcGIS Pro 工程选项对话框的地理数据库复制选项卡,或通过管理复本窗格中的管理复本菜单。 以下部分提供了每种访问方法的步骤:

地理数据库复制选项卡

使用以下步骤从地理数据库复制选项卡访问和设置复本日志记录属性:

  1. ArcGIS Pro 工程选项卡中,选择选项
  2. 选择地理数据库复制选项卡。 在此选项卡中,您可以设置默认日志文件路径日志级别
    已从“选项”对话框访问的“地理数据库复制”选项卡

    注:

    ArcGIS Pro 内使用离线工作流(例如通过要素服务同步功能离线使用地图)也会写入 ProReplicaActivityLog。 在这种情况下,您将使用 ArcGIS Pro 工程选项上的地理数据库复制选项卡来配置创建和更新此日志文件以及要记录的细节层次的位置。 有关更多详细信息,请参阅离线使用要素图层

“管理复本”菜单

使用以下步骤从管理复本菜单访问和设置复本日志记录属性::

  1. 目录窗格中,右键单击现有地理数据库连接,指向分布式地理数据库,然后单击管理复本 管理复本
    “分布式地理数据库”快捷菜单上的“管理复本”命令
  2. 单击管理复本菜单 菜单,然后单击日志记录属性

    “管理复本”菜单命令

有关管理复本窗格中可用工具的详细信息,请参阅复本管理快速浏览

设置复本日志记录属性

您可以选择存储 ArcGIS Pro 复本活动日志文件和通过在日志记录属性对话框中设置以下值来记录的细节层次的位置:

“日志记录属性”对话框用于设置 ProReplicaActivityLog.dat 文件的位置和日志级别。

  • 日志文件路径 - ArcGIS Pro 复本活动日志文件的默认位置为 C:\Users\<user_profile>\AppData\Local\ESRI\ProReplicaActivityLog.dat。 可通过输入您希望用于保存复本活动日志文件的另一个路径来更改该位置,该路径还可以包含共享文件位置。
  • 日志级别 - 选择要在 ArcGIS Pro 复本活动日志中记录的详细信息级别。 信息:简单是默认日志级别,并且在大多数情况下,足以了解复本创建或同步过程中发生的情况。 如果需要其他信息,则可以选择另一个日志级别选项。 为了进行故障排除,Esri 技术支持人员可能会要求您将日志级别设置为调试,以分析 ArcGIS Pro 复本活动日志文件。

“日志记录属性”对话框中的日志级别选项

查看复本活动日志

ArcGIS Pro 复本活动日志中存储的信息可以包括以下内容:

  • 错误 - 运行某个流程时出现的错误
  • 警告 - 运行流程时发生的警告数
  • 操作名称 - 运行的流程的名称
  • 完成时间 - 完成流程的日期和时间
  • 操作信息 - 关于流程的常规信息

在文本编辑器中查看复本活动日志文件

可以直接在文本编辑器中查看 ProReplicaActivityLog 文件的内容。

下面是在创建单向“父-子”级复本时使用调试日志级别在 ArcGIS Pro 复本活动日志文件中捕获的信息的示例。

在文本编辑器中查看 ProReplicaActivityLog 文件

使用格式化视图查看复本活动日志文件

(可选)可使用复本日志查看器(ArcGIS Pro 自定义加载项)查看复本活动日志的格式化视图。 复本日志查看器在查看 ArcGIS Pro 复本活动日志时提供以下附加命令:

  • 打开日志 - 浏览到 ArcGIS Pro 复本活动日志文件位置。
  • 按复本名称或日期范围过滤 - 根据在日志文件中找到的复本名称或按使用日期范围的复本活动进行过滤。
  • 仅显示错误和警告 - 仅显示在复本活动日志文件中捕获的错误和警告。

下面是同一 ArcGIS Pro 复本活动日志文件的格式化视图,该文件包含使用调试日志级别创建单向“父-子”复本时捕获的信息:

复本活动日志文件的格式化视图

要访问复本日志查看器自定义加载项和要安装的步骤,并查看 ArcGIS Pro 复本活动日志包含的信息的格式化视图,请参阅技术文章方法:获取复本活动日志的格式化视图

复本日志

复本属性对话框上的复本日志选项卡用于显示地理数据库中存储的同步事件信息,如果存在错误,还将包含错误信息。 它显示发送和接收更改的时间,以及可能发生的任何错误(如同复本活动日志一样)。

“复本日志”选项卡位于“复本属性”对话框上。

注:

复本日志选项卡仅对单向和双向复本可用。

查看复本日志

复本日志选项卡上,您可以选择要查看的日志记录天数,也可以通过选中显示所有消息选项来查看特定复本的所有日志。 如果选中显示所有消息列出指定时间之后的消息文本框不可用。

此外,还可以按结果类型过滤在复本日志选项卡上显示的结果。

按结果类型过滤复本日志中的结果。

复本日志显示每条消息的日志日期事件结果项目。

  • 日志日期 - 发送或接收消息的日期和时间
  • 事件 - 显示此复本是发送(发送更改)还是接收(接收更改)消息
  • 结果 - 显示是否已成功发送或接收消息,或者尝试事件时是否发生复本冲突或错误

如果“结果”列中显示冲突或系统错误,请右键单击该行以访问错误报告。

访问复本日志错误报告

如果“结果”列中显示冲突或系统错误,请右键单击该行以访问错误报告

若要查看错误报告中是否存在复本同步期间所发生的冲突,请使用“复本属性”对话框上的“复本日志”选项卡。

冲突的错误报告描述存在冲突的原因以及从冲突状态移除复本的解决方案(如果适用)。

错误报告提供了冲突的描述和解决方案。

错误报告还显示有关与复本关联的代编号的信息。 起始代编号和结束代编号指定了发送到接收复本的编辑范围,而目标代编号指定了将接收编辑的目标复本上的代编号。

其他信息

有关详细信息,请参阅以下资源: