Configurar NLog

Agregar extensiones NLog

Orchestrator carga las siguientes extensiones de forma predeterminada, por lo que no es necesario incluirlas en la carpeta o en la configuración de NLog:

• NLog.Targets.ElasticSearch
• UiPath.Orchestrator.Logs.Elasticsearch
• Microsoft.ApplicationInsights.NLogTarget
• NLog.Extensions.AzureEventHub

Solo se pueden usar extensiones compatibles con Linux en esta configuración, así que asegúrate de que la extensión NLog elegida cumple esta regla.

Para que la extensión esté disponible para su uso, debe cargarse en el almacenamiento del clúster. La herramienta de línea de comandos uipathctl puede hacerlo mediante el comando uipathctl config orchestrator upload :

uipathctl config orchestrator upload --nlog-extensions-directory /path/to/extensions/directory

Si utilizas una configuración de almacenamiento externo en el nivel del clúster, debes indicarlo incluyendo el parámetro --is-external-storage.

Configuración avanzada de NLog

Crear la configuración avanzada de NLog

1. Cree el archivo nlog.config.json que contiene las secciones las extensiones, los objetivos y las reglas estándar.
   La sección de extensiones es una matriz de elementos que especifica los ensamblados de extensión, a través de assemblyFile, y la ruta del ensamblado.

   Si se cargaron complementos personalizados de nlog (como se describe en la sección Añadir extensiones NLog), se hará referencia a ellos en la sección extensions.
2. Configura el destino y la regla en el archivo nlog.config.json.
3. Aplica el archivo nlog.config.json utilizando la herramienta de línea de comandos uipathctl :

   uipathctl config orchestrator update-config --nlog-config nlog.custom.json

   Importante: Esta acción sobrescribe la configuración de NLog personalizada existente. Puedes comprobar cuál es la configuración existente utilizando este comando:

   uipathctl config orchestrator get-config --nlog-config

   Archivo nlog.config.json de ejemplo que escribe registros en Azure Blob:

   {   "NLog": {
           "extensions": [
               { "assemblyFile": "NLog.Extensions.AzureBlobStorage.dll" }
           ],
           "targets": {
               "azureBlob": {
                   "type": "AzureBlobStorage",
                   "connectionString": "DefaultEndpointsProtocol=https;AccountName=test;AccountKey=key;EndpointSuffix=core.windows.net",
                   "container": "orchestratorlogs",
                   "blobName": "${date:format=yyyy-MM-dd hh.mm}",
                   "layout": {
                     "type": "JsonLayout",
                     "includeAllProperties": true,
                     "Attributes": [
                       {"name": "ts","layout": "${longdate}"},
                       {"name": "level","layout": "${level:upperCase=true}"},
                       {"name": "logger","layout": "${logger}"},
                       {"name": "message","layout": "${message}"},
                       {"name": "exception","layout": "${onexception:${ui-pretty-exception}}"}
                     ]
                   }
               }
           },
           "rules": { "70_Final": { "writeTo": "stdout,azureBlob" } }
       }
   }

   Archivo nlog.config.json de ejemplo que escribe registros de UiPath Robots en Splunk:

   {
       "Nlog": {
           "extensions": [
               { "assemblyFile": "NLog.Targets.Splunk.dll" },
               { "assembly": "UiPath.Orchestrator.Logs.DatabaseBulk.NLogTarget" }
           ],
           "targets": {
               "Splunk": {
                   "type": "BufferingWrapper",
                   "flushTimeout": 5000,
                   "target": {
                       "type": "SplunkHttpEventCollector",
                       "serverUrl": "http://splunk.example.com",
                       "token": "splunk-token",
                       "channel": "",
                       "source": "${logger}",
                       "sourceType": "_json",
                       "index": "uipath",
                       "retriesOnError": "0",
                       "batchSizeBytes": "0",
                       "batchSizeCount": "0",
                       "includeEventProperties": "true",
                       "includePositionalParameters": "true",
                       "includeMdlc": "true",
                       "maxConnectionsPerServer": "10",
                       "ignoreSslErrors": "false",
                       "useProxy": "false",
                       "proxyUrl": "",
                       "proxyUser": "",
                       "proxyPassword": ""
                   }
               }
           },
           "rules": {
               "20_Robot_Primary": { "writeTo": "Splunk,database,insightsRobotLogs" }
           }
       }
   }

Actualizar la configuración avanzada de NLog

Los comandos uipathctl necesarios para actualizar la configuración de NLog son:

• uipathctl config orchestrator get-config --nlog-config : esto exporta la configuración actual en un archivo json de par clave-valor, listo para editar.

  Puedes obtener más información al respecto.

• uipathctl config orchestrator update-config --nlog-config nlog.config.json : esto actualiza la configuración con tus cambios.

  Puedes obtener más información al respecto.

1. Exporta la configuración de NLog personalizada actual a un archivo json utilizando este comando:

   uipathctl config orchestrator get-config --nlog-config > nlog.config.json

2. Edita el archivo nlog.config.json exportado según sea necesario. Puedes añadir, eliminar o cambiar cualquiera de sus ajustes.
   Nota: Debes volver a exportar el archivo cada vez que necesites realizar un cambio, ya que la actualización sobrescribe todos los ajustes de NLog.
3. Actualiza la configuración de NLog utilizando este comando:

   uipathctl config orchestrator update-config --nlog-config nlog.config.json
   orchestrator config updated