将机器人日志保存到 Elasticsearch

可以通过两种类型的配置将机器人日志保存到 Elasticsearch 服务器：基本配置和高级配置。

基本配置提供默认功能，用于激活预配置的 Elasticsearch NLog 目标，该目标由包装在缓冲目标中的 Elasticsearch 目标组成。 在大多数情况下，这种类型的配置就足够了。

但是，如果您需要进一步自定义规则，可以使用高级配置方法。

注意：将机器人日志保存到 Elasticsearch 服务器的选项仅在配置后生效，并且不会追溯性应用。这意味着您将无法再访问在配置选项时数据库中已有的任何日志，因为只能从单个目标检索和显示日志。

基本配置

1. 在 ArgoCD 界面中找到UiPath应用程序。
2. 单击左上角的“ 应用程序详细信息 ” 按钮，然后导航到“ 参数 ” 选项卡。
3. 单击“ 编辑”，然后使用右侧列中指定的值更新以下参数，并将示例替换为您自己的值：

   参数	值
   global.userInputs.orchestratorRobotLogsElasticUri	示例：https://elastic.example.com:9200。 确保不包含尾部斜杠。
   global.userInputs.orchestratorRobotLogsElasticAuthUsername	示例：elastic-user。
   global.userInputs.orchestratorRobotLogsElasticAuthPassword	示例：elastic-password。

4. 保存更改。
5. 同步 UiPath 应用程序，等待该过程完成并返回 healthy 状态响应。

您还可以 通过编辑 cluster_config.json 文件，将机器人日志配置为保存到 Elasticsearch 服务器。

基本配置支持 Elasticsearch 版本 7.x。 对于 Elasticsearch 8.x，您需要使用高级配置。

高级配置

重要提示： 您按照以下步骤进行的任何更改都可能对整个系统的功能和稳定性产生负面影响。 建议仅在了解更改的后果后进行更改。

高级配置允许您完全自定义NLog.config目标。

1. 请遵循上述 基本配置 步骤。
2. 在 ConfigMap 的orchestrator-customconfig中编辑nlog.json参数。
   1. 根据以下示例创建 /tmp/nlog.custom.json 文件。
   2. 使用 ./orchestrator_configurator.sh -l /tmp/nlog.custom.json 更新 Orchestrator 配置程序工具中的配置映射。

备注：

高级配置还支持 Elasticsearch 版本 8.x。

Elasticsearch 7.x 示例

{
  "Nlog": {
    "targets": {
      "robotElasticBuffer": {
        "flushTimeout": 1000,
        "bufferSize": 1000,
        "slidingTimeout": false,
        "target": {
          "uri": "https://elastic.example.com:9200",
          "requireAuth": true,
          "username": "elastic-user",
          "password": "elastic-password",
          "index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
          "documentType": "logEvent",
          "includeAllProperties": true,
          "layout": "${message}",
          "excludedProperties": "agentSessionId,tenantId,indexName"
        }
      }
    }
  }
}

Elasticsearch 8.x 示例

{
  "Nlog": {
    "targets": {
      "robotElasticBuffer": {
        "flushTimeout": 1000,
        "bufferSize": 1000,
        "slidingTimeout": false,
        "target": {
          "uri": "https://elastic.example.com:9200",
          "requireAuth": true,
          "username": "elastic-user",
          "password": "elastic-password",
          "index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
          "documentType": "",
          "includeAllProperties": true,
          "layout": "${message}",
          "excludedProperties": "agentSessionId,tenantId,indexName"
        }
      }
    }
  }
}