同步网络应用项目故障排除{ #capture_app_sync_troubleshooting_webapp }¶
概述{ #capture_app_sync_troubleshooting_webapp_overview }¶
本节重点介绍 同步故障排除 Web 应用项目 的实现。
同步故障排除 Web 应用项目](https://apps.dhis2.org/app/64e70334-be30-4f2e-8883-636beb74ae13) 为管理员提供了同步错误的实时可见性。这些错误记录会在默认的 24 小时后由后台自动删除。
此清理期在系统设置中定义，适用于所有单次运行作业（如数据导入）。可以通过 API 更改该值。延长该周期会延长错误的保留时间，但也会增加数据库存储空间。
检查当前清理期：
GET /api/systemSettings/jobsCleanupAfterMinutes
更新清理周期（以分钟为单位的值）：
POST /api/systemSettings/jobsCleanupAfterMinutes?value=
请注意，在此版本的网络应用项目中，只有拥有 "F_JOB_LOG_READ "权限的用户才能监控详细的错误信息。其他用户将无法访问网络应用项目。
安装{ #capture_app_sync_troubleshooting_webapp_installation }¶
用户登录 DHIS2 并进入 ** 应用项目管理**，即可轻松安装同步故障排除网络应用项目。
- 点击 ** 应用项目中心**
- 转到*同步故障排除应用项目*
- 点击 Install V1.X.X
同步故障排除{ #capture_app_sync_troubleshooting_monitoring }¶
同步故障排除为管理员用户提供了一个专用界面，以便有效监控和管理同步错误。
- 查看错误列表：管理员可以访问同步过程中发生的错误的详细列表。
- 排序错误：可按错误名称、最新、最旧或错误代码对列表进行排序，从而更容易识别和排除特定问题。
- 搜索错误：使用错误信息作为搜索过滤器，快速查找特定错误。
该功能可帮助管理员快速跟踪和解决同步问题，确保数据传输过程更加顺畅。
了解错误细节：识别安卓用户与网络用户
在错误详情卡中，还提供了其他信息，以帮助确定错误来源。主要细节包括
- 用户组和角色：这些信息显示了发生错误的用户的权限和访问级别。
- 错误起源：通过分析用户角色和组，管理员可以确定错误是由 Android 用户还是网络用户造成的。
这些信息有助于更有效地排除同步问题的故障，确定错误是否与特定平台或用户类型有关。
注：
要监控网络应用项目中的同步错误，用户必须拥有特定权限：
- "F_JOB_LOG_READ" 权限：访问和读取同步错误列表所需的权限。
- "F_USER_VIEW" 权限：读取用户列表所需的权限
- 错误详细信息的附加访问权限：要查看每个错误的更多详细信息，用户必须拥有访问以下列表的权限： 用户 事件 项目
如果没有这些权限，用户可能只能看到基本的错误信息，或被限制查看某些细节。这样可以确保只有授权用户才能访问敏感数据。
卸载应用项目{ #capture_app_sync_troubleshooting_webapp_uninstall }¶
如果需要卸载 APK Distribution App，建议同时删除数据存储命名空间中的所有数据。
- 转到 应用项目管理
- 点击**自定义应用项目**
- 转到*同步故障排除*
- 点击 * 卸载 V1.X.X*
