Configuração do NLog

Adição de extensões do NLog

O Orchestrator carrega as extensões a seguir por padrão, portanto, você não precisa incluí-las na pasta ou na configuração do NLog:

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

Apenas extensões compatíveis com Linux podem ser usadas nesta configuração; portanto, certifique-se de que sua extensão de NLog escolhida obedeça a essa regra.

Para disponibilizar a extensão para uso, ela deve ser carregada no armazenamento do cluster. A ferramenta de linha de comando uipathctl pode fazer isso pelo comando uipathctl config orchestrator upload :

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

Se você usar uma configuração de armazenamento externo no nível do cluster, você deve indicar isso incluindo o parâmetro --is-external-storage.

Configuração avançada do NLog

Criação da configuração avançada do NLog

1. Crie o nlog.config.jsonarquivo que contém as seções padrão: extensões, destinos e regras.

   A seção de extensões é uma matriz de itens que especificam os conjuntos de extensão, por meio de assemblyFile, e o caminho da montagem.

   Se os plug-ins personalizados do Nlog tiverem sido carregados (conforme descrito na seção Adicionando extensões do NLog), serão referenciados na seção extensions.

2. Configure o destino e a regra no arquivo nlog.config.json.

3. Aplique o arquivo nlog.config.json usando a ferramenta de linha de comando uipathctl :

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

   Importante:

   Essa ação substitui a configuração personalizada existente do NLog. Você pode verificar qual é a configuração existente usando este comando:

   uipathctl config orchestrator get-config --nlog-config
   

Exemplo de arquivo nlog.config.json que grava logs no 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" } }
    }
}

Exemplo de arquivo nlog.config.json que grava logs de robôs no 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" }
        }
    }
}

Atualização da configuração avançada do NLog

Os comandos uipathctl necessários para atualizar a configuração do NLog são:

• uipathctl config orchestrator get-config --nlog-config- Isso exporta a configuração atual em um arquivo json de par chave-valor, pronto para edição. Você pode ler mais sobre isso.
• uipathctl config orchestrator update-config --nlog-config nlog.config.json - Isso atualiza a configuração com suas alterações. Você pode ler mais sobre isso.

1. Exporte a configuração personalizada atual do NLog para um arquivo json usando este comando:

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

2. Edite o arquivo nlog.config.json exportado conforme necessário. Você pode adicionar, remover ou alterar qualquer uma de suas configurações.
   Observação:

   Você deve exportar o arquivo novamente toda vez que precisar fazer uma alteração, pois a atualização substitui todas as configurações do NLog.

3. Atualize a configuração do NLog usando este comando:

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