Skip to main content

SIS 集成日志

“SIS 日志”页面显示所有学生信息系统 (SIS) 集成的所有用户界面 (UI) 流程日志。日志文件在排除系统故障及监控系统交易进度方面发挥着重要作用。在创建集成的过程中设置日志详细程度将指示对于选定的集成在系统中保存的日志类型和深度。这些日志为实时日志，可以从“SIS 日志”屏幕中进行筛选、查看以及清除。

日志层级

我们提供四种类型的日志级别，根据集成的配置，每种 SIS 集成均报告不同的日志记录级别。以下列表介绍了每种集成应发布至处于不同级别的日志的消息类型。

  • 错误：任何致命问题，任何阻碍创建、更新、禁用或清除作的问题。

  • 警告及以上：任何非致命问题、个人记录问题，或任何需要更改记录的成功手术。

  • 消息及以上：任何成功的活动，包括记录类型和计数、时间和数据。

  • 调试及以上：所有单独记录和数据转换尝试。

如果你将日志冗长度设置为所有诊断消息或所有诊断和调试消息，当你创建或编辑学生信息系统集成时，请在活跃诊断日志列表中选择时间。诊断日志记录最好用于短期测试，如果该功能一直处于启用状态，则可能会导致性能问题。当你选择的时间过去后，日志会记录错误和警告。我们建议您在完成测试后清除日志。

查看和筛选日志条目

可使用高级搜索方法 (包括错误类型、集成以及日期范围) 筛选日志。新日志条目很容易看到，计数已附加到日志条目类型。可刷新日志以检索最新计数以及每种日志类型的详细信息。清除日志计数仅清除与此日志类型关联的数量，不清除这些日志。清除日志无法撤销，永久清除日志之前会显示验证提示。“清除日志”按钮仅适用于选定的集成。

  1. 在管理员面板，集成下方，选择数据集成。

  2. 选择学生信息系统集成。

  3. 选择查看所有错误。

  4. 在Search栏输入搜索词。系统将返回准确的结果。

  5. 从第一个菜单中选择集成。

  6. 从第二个菜单中选择详细程度级别。

  7. 选择From复选框以设置开始日期和时间范围。在框中输入日期和时间，或使用弹窗日期选择日历和选择时间菜单来选择日期和时间。

  8. 选择To复选框以设置结束日期和时间范围。在框中输入日期和时间，或使用弹窗日期选择日历和选择时间菜单来选择日期和时间。

    注意

    您无法搜索超过七天的日志。

  9. 选择开始。

  10. 系统将列出日志条目以及集成、日期、日志级别和描述。

  11. 选择日志条目以查看日志详细内容。

管理日志条目

您可以管理自己的日志条目，便于轻松发现数据问题。例如，如果您遇到特定错误，则可以轻松地查看较少的信息。管理日志条目也有助于将所用的空间量保持在最少范围内。您应该定期清除日志，使信息保持最新状态。

  1. 在管理员面板，集成下方，选择数据集成。

  2. 选择学生信息系统集成。

  3. 选择查看所有错误。

  4. 选择刷新以获取新的日志。

  5. 选择清除日志以移除特定集成的日志信息。

日志位置

为了便于日志文件管理或历史数据分析，您可以在以下 ~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_type>

并且

<integration_name> 是集成配置中指定的集成名称。

通过REST Web服务访问日志

在新框架中，您可以通过 REST Web 服务访问此报告。要访问日志，可以将 /learn/api/v1/logs/学生信息系统/{dataSetUid} 添加到你的 Blackboard Learn 域名中。系统在每次处理一个馈送文件时，都提供 dataSetUid 参考代码。必须提供此参数才能返回结果。错误和成功消息会记录到表格 DATA_INTGR_LOG 中。

以下其他参数可用于细分数据：

  • logLevel parameter: /learn/api/v1/logs/sis/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).

  • 标准分页参数：/learn/api/v1/logs/学生信息系统/{dataSetUid}？limit=25&&offset=10.默认情况下，标准请求的限制为 20 页，除非您更改此值。

在 Web 服务中排除记录错误的过程与排除错误日志的过程相比，没有发生变化。如果您遇到“未找到”错误消息，则可能是系统中不存在 dataSetUid 或馈送文件仍在处理中。