记录到服务器 操作为 API 任务 和 任务机器人 添加原生日志记录功能。 此操作使您能够创建自定义日志,并将其与自动化运行时日志一起转发到任何日志服务器,例如安全信息和事件管理 (SIEM) 服务器、Syslog 服务器或 Control Room。
概览
记录到服务器 操作将日志转发到已配置的服务器(Control Room、SIEM 服务器或 Syslog 服务器),提供一个集中位置用于验证运行时数据并调试任何执行错误。 在自动化中使用此操作之前,请在自动化日志设置中配置相应的日志记录服务器。
您可以根据 Control Room 管理员配置的存储位置查看自动化运行时日志。 例如,如果管理员启用到 Control Room 的日志转发,自定义日志消息将被记录并存储在 Control Room 存储库中。
对于 SIEM 服务器,您可以利用 SIEM 服务器上可用工具的报告和分析功能来分析和管理日志。 您还可以将日志保留在服务器中,以满足组织对合规性和监管审计的要求。 有关配置 SIEM 集成设置的详细信息,请参阅 配置与 SIEM 的集成。
记录到服务器操作适用于 任务机器人 和 API 任务。
有关如何配置用于存储自动化日志的默认服务器位置的更多信息,请参见 管理用于存储自动化日志的 Cloud 服务器位置 和 管理用于存储自动化日志的 On-Premises 服务器位置。
转发的自定义日志包含以下参数:
| 参数 | 描述 |
|---|---|
| logMessage | 您在要记录的文本字段中输入的日志标题。 |
| executionId | 自动化的执行 ID。 当您打开自动化的活动页面时,执行 ID 会出现在 URL 中。 |
| logLevel | 配置操作时设置的日志级别。 |
| sysLogSource | 配置操作时设置的数据源标签。 此标签用作日志的标识符。 |
| botName | 创建自动化时输入的名称。 |
| botId | 自动化的机器人 ID。 当您在机器人编辑器工作区中打开机器人时,机器人 ID 会出现在 URL 中。 |
| logCreatedTime | 日志创建时的 ISO8601 格式时间戳。 |
设置
以下设置可在 记录到服务器 操作中使用:
- 要记录的文本: 输入日志头的名称。 logMessage 参数显示日志头。 允许的最大文本长度为 1024 个字符。
-
要记录的变量: 配置必须导出到已配置日志服务器的变量。 记录到服务器 操作支持字符串、数字、日期时间和布尔值变量。 变量及其各自的默认值也会出现在 logMessage 参数中。
请选择以下一项:
-
按类型: 使用此选项根据类型记录变量。 可以单独记录变量,也可以一起记录。 可用选项包括所有字符串变量、所有数字变量、所有日期时间变量和所有布尔值变量。注: 选择此选项后,您可以记录在将此操作添加到自动化后创建的变量。
-
自定义选择: 使用此选项可单独或一起选择和记录变量。注: 选择此选项时,在将此操作添加到自动化后创建的变量不会包含在日志中。
-
按类型: 使用此选项根据类型记录变量。 可以单独记录变量,也可以一起记录。 可用选项包括所有字符串变量、所有数字变量、所有日期时间变量和所有布尔值变量。
- 数据源标签(可选): 添加标签以识别日志条目。 标签允许在日志服务器中轻松筛选日志。 数据源标签出现在 sysLogSource 参数中。
-
日志级别: 根据要求选择适当的日志信息级别。 日志级别显示在 logLevel 参数中。 可以使用以下日志级别:
- 紧急 (0)
- 错误 (3)
- 警告 (4)
- 信息 (6)
- 调试 (7)
这些数字表示与日志级别相关联的严重性值。
在 API 任务 中排除 记录到服务器 故障
要测试包含 记录到服务器 的 API 任务,如果您在 API 任务 编辑器页面使用调试选项,将看到以下错误: 部署机器人时发生意外错误。在调试期间,API 任务 在本地机器人运行程序上运行,这需要 Windows 或 macOS 机器人坐席。 记录到服务器 操作的坐席目标为无界面,这与本地机器人运行程序不兼容。
要测试您的自动化,请保存自动化,并在私有存储库页面的省略号菜单中,使用运行 API 任务选项运行自动化。