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 --use-external-storage.

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

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