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.

Registro de robot básico Configuración de Elasticsearch

Para aplicar la configuración básica, sigue los siguientes pasos. Para obtener más información, consulta Configurar los parámetros de Orchestrator.

1. En el archivo de configuración, añade una nueva sección llamada orchestrator_robot_logs_elastic a la configuración de Orchestrator, como se muestra en el siguiente ejemplo:

   "orchestrator": {
       "enabled": true,
       "orchestrator_robot_logs_elastic": {
           "elastic_uri": "https://elastic.example.com:9200",
           "elastic_auth_username": "elastic-user",
           "elastic_auth_password": "elastic-password"
       }
   }

2. Actualiza los siguientes parámetros con tus propios valores:

   Parámetro	Descripción
   elastic_uri	La dirección de la instancia de Elasticsearch que debe utilizarse. Debe proporcionar la dirección como URI, junto con un nombre de usuario y una contraseña. Ejemplo: https://elastic.example.com:9200 Asegúrate de no incluir una barra al final.
   elastic_auth_username	Ejemplo: elastic-user
   elastic_auth_password	Ejemplo: elastic-password

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

Registro de UiPath Robot avanzado Configuración de Elasticsearch

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. Sigue los pasos de configuración de NLog avanzada y, a continuación, actualiza el destino robotElasticBuffer con las propiedades que deben cambiarse.

Nota:

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

nlog.config.json de 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"
        }
      }
    }
  }
}

nlog.config.json de 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"
        }
      }
    }
  }
}