“SIS 日志”页面显示所有学生信息系统 (SIS) 集成的所有用户界面 (UI) 流程日志。日志文件在排除系统故障及监控系统交易进度方面发挥着重要作用。在创建集成的过程中设置日志详细程度将指示对于选定的集成在系统中保存的日志类型和深度。这些日志为实时日志,可以从“SIS 日志”屏幕中进行筛选、查看以及清除。
日志级别
我们提供四种类型的日志级别,根据集成的配置,每种 SIS 集成均报告不同的日志记录级别。以下列表介绍了每种集成应发布至处于不同级别的日志的消息类型。
- 错误: 任何严重的问题、任何防止创建、更新、禁用或清除操作的问题。
- 警告及以上:任何不严重的问题、单条记录的任何问题或需更改记录的任何成功操作。
- 消息及以上:任何成功的活动,包括记录类型、计数、时间以及数据。
- 调试及以上:所有单条记录以及数据转换尝试。
如果您在创建或编辑 SIS 集成时将日志详细程度设置为所有诊断消息或所有诊断和调试消息,请在活动诊断日志记录列表中选择一个时间。诊断日志记录最好用于短期测试,如果该功能一直处于启用状态,则可能会导致性能问题。在您选定的时长结束后,日志将会记录错误和警告。我们建议您在完成测试后清除日志。
查看和筛选日志条目
可使用高级搜索方法 (包括错误类型、集成以及日期范围) 筛选日志。新日志条目很容易看到,计数已附加到日志条目类型。可刷新日志以检索最新计数以及每种日志类型的详细信息。清除日志计数仅清除与此日志类型关联的数量,不清除这些日志。清除日志无法撤销,永久清除日志之前会显示验证提示。“清除日志”按钮仅适用于选定的集成。
- 在集成下的管理员面板上,选择数据集成。
- 选择学生信息系统集成。
- 选择查看所有错误。
- 在搜索字段中,键入搜索单词。系统将返回准确的结果。
- 从第一个菜单中选择集成。
- 从第二个菜单中选择详细程度级别。
- 选中开始日期和时间复选框,以便设置开始日期和时间范围。在框中键入日期和时间,或使用弹出日期选择日程表和选择时间菜单选择日期和时间。
- 选中结束日期和时间复选框,以便设置结束日期和时间范围。在框中键入日期和时间,或使用弹出日期选择日程表和选择时间菜单选择日期和时间。
您无法搜索超过七天的日志。
- 选择执行。
- 系统将列出日志条目以及集成、日期、日志级别和描述。
- 选择日志条目以查看日志详细内容。
管理日志条目
您可以管理自己的日志条目,便于轻松发现数据问题。例如,如果您遇到特定错误,则可以轻松地查看较少的信息。管理日志条目也有助于将所用的空间量保持在最少范围内。您应该定期清除日志,使信息保持最新状态。
- 在集成下的管理员面板上,选择数据集成。
- 选择学生信息系统集成。
- 选择查看所有错误。
- 选择刷新以检索新日志。
- 选择清除日志以删除特定集成的日志信息。
日志位置
为了便于日志文件管理或历史数据分析,您可以在以下 ~blackboard 日志目录下找到数据集成日志文件:
~blackboard/logs/data-integration/<integration_type>/<integration_name>
其中:
<integration_type> 是以下项之一:Bb-flatfile(快照平面文件)、bb-lis (LIS 2.0)、bb-ss-xml(快照 XML)、bb-ims-vista-xml (IMS Enterprise Vista) 或 bb-ims-xml (IMS Enterprise)
并且
<integration_name> 是集成配置中指定的集成名称。
通过 REST Web 服务访问日志
在新框架中,您可以通过 REST Web 服务访问此报告。要访问日志,请将 /learn/api/v1/logs/sis/{dataSetUid} 附加到您的 Blackboard Learn 域中。系统在每次处理一个馈送文件时,都提供 dataSetUid 参考代码。必须提供此参数才能返回结果。错误和成功消息会记录到表格 DATA_INTGR_LOG 中。
以下其他参数可用于细分数据:
- logLevel 参数: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).
- 标准分页参数:/learn/api/v1/logs/sis/{dataSetUid}?limit=25&&offset=10。默认情况下,标准请求的限制为 20 页,除非您更改此值。
在 Web 服务中排除记录错误的过程与排除错误日志的过程相比,没有发生变化。如果您遇到“未找到”错误消息,则可能是系统中不存在 dataSetUid 或馈送文件仍在处理中。