Guardar los registros del robot en Elasticsearch

Los registros de UiPath Robot pueden almacenarse en un servidor Elasticsearch mediante dos tipos de configuración: básica y avanzada.

La configuración básica proporciona una funcionalidad predeterminada que activa el objetivo NLog de Elasticsearch preconfigurado, formado por un objetivo de Elasticsearch envuelto en un objetivo de almacenamiento intermedio. Este tipo de configuración es suficiente en la mayoría de escenarios.

Sin embargo, si necesitas personalizar aún más las reglas, puedes utilizar el método de configuración avanzado.

Nota:

La opción de guardar los registros del robot en un servidor de Elasticsearch solo se hace efectiva una vez que lo configuras y no se aplica de forma retroactiva. Esto significa que ya no tendrás acceso a ningún registro que ya estuviera en la base de datos en el momento en que configuraste la opción, porque los registros solo se pueden recuperar y mostrar desde un único destino.

Configuración básica

1. Locate the uipath application in the ArgoCD interface.

2. Haz clic en el botón DETALLES DE LA APLICACIÓN en la esquina superior izquierda, y luego navega hasta la pestaña PARÁMETROS.

3. Haz clic en EDITAR y actualiza los siguientes parámetros con los valores especificados en la columna de la derecha, sustituyendo los ejemplos por tus propios valores:

   Parámetro	Valor
   global.userInputs.orchestratorRobotLogsElasticUri	Ejemplo: https://elastic.example.com:9200 Asegúrate de no incluir una barra al final.
   global.userInputs.orchestratorRobotLogsElasticAuthUsername	Ejemplo: elastic-user
   global.userInputs.orchestratorRobotLogsElasticAuthPassword	Ejemplo: elastic-password

4. Guarda los cambios.

5. Sincroniza la aplicación uipath y espera a que el proceso termine con una respuesta de estado healthy.

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

La configuración básica admite la versión 7.x de Elasticsearch. Para Elasticsearch 8.x, debes usar la configuración avanzada.

Configuración avanzada

Importante:

Cualquier cambio realizado según los pasos siguientes puede afectar negativamente a la funcionalidad y estabilidad de todo el sistema. Es aconsejable que solo hagas cambios si entiendes sus consecuencias.

La configuración avanzada te permite personalizar completamente tu objetivo NLog.config.

1. Follow the basic configuration steps described above.
2. Edita los parámetros nlog.json en orchestrator-customconfig en ConfigMap.
   1. Crea un archivo /tmp/nlog.custom.json según lo mostrado a continuación.
   2. Use ./orchestrator_configurator.sh -l /tmp/nlog.custom.json to update ConfigMap in the Orchestrator Configurator Tool.

Nota:

La configuración avanzada también es compatible con la versión 8.x de Elasticsearch.

Muestra para 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"
        }
      }
    }
  }
}

Muestra para 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"
        }
      }
    }
  }
}