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 para guardar los registros de robots en un servidor de Elasticsearch solo se hace efectiva una vez que lo configuras y no se aplica retroactivamente. 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. Localiza la aplicación Uipath en la interfaz de ArgoCD.
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.

También puedes configurar los registros del UiPath robot para que se guarden en un servidor Elasticsearch editando el archivo cluster_config.json.

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 que hagas siguiendo los pasos que se indican a continuación 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. Sigue los pasos básicos de configuración descritos anteriormente.
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. Utiliza ./orchestrator_configurator.sh -l /tmp/nlog.custom.json para actualizar ConfigMap en la Herramienta de configuración de Orchestrator.

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