将机器人日志保存到 Elasticsearch

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

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

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

备注：

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

基本配置

1. Locate the uipath application in the ArgoCD interface.

2. 单击左上角的“应用程序详细信息” 按钮，然后导航到“参数” 选项卡。

3. 单击“编辑”，然后使用右侧列中指定的值更新以下参数，并将示例替换为您自己的值：

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

4. 保存更改。

5. 同步uipath应用程序，并等待流程完成并返回healthy状态响应。

You can also configure robot logs to be saved to an Elasticsearch server by editing the cluster_config.json file.

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

高级配置

重要提示：

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

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

1. Follow the basic configuration steps described above.
2. 在 ConfigMap 的orchestrator-customconfig中编辑nlog.json参数。
   1. 根据以下示例创建 /tmp/nlog.custom.json 文件。
   2. Use ./orchestrator_configurator.sh -l /tmp/nlog.custom.json to update ConfigMap in the Orchestrator Configurator Tool.

备注：

高级配置还支持 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"
        }
      }
    }
  }
}