NLog を構成する

NLog 拡張機能を追加する

以下の拡張機能が Orchestrator によって既定で読み込まれるため、フォルダーまたは NLog の構成にこれらの拡張機能を含める必要はありません。

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

この設定で使用できるのは Linux 対応の拡張機能のみであるため、選択した NLog 拡張機能がこのルールに準拠していることを確認してください。

拡張機能を使用できるようにするには、クラスター ストレージに拡張機能をアップロードする必要があります。 uipathctlコマンドラインツールは、uipathctl config orchestrator uploadコマンドを使用してこれを行うことができます。

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

外部ストレージ構成をクラスター レベルで使用する場合は、それを示すために --is-external-storage パラメーターを含める必要があります。

NLog の高度な設定

NLog の高度な構成を作成する

1. 拡張機能、ターゲット、ルールといった標準的なセクションを含む nlog.config.json ファイルを作成します。
   拡張機能セクションは、assemblyFile を使用して拡張機能アセンブリを指定する項目の配列と、アセンブリのパスです。

   カスタムの NLog プラグインが読み込まれた場合 (「NLog 拡張機能を追加する」のセクションを参照)、そのプラグインは extensions セクションで参照されます。
2. nlog.config.json ファイルでターゲットとルールを構成します。
3. uipathctl コマンド ライン ツールを使用して、nlog.config.json ファイルを適用します。

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

   大事な： この操作により、既存のカスタム NLog 構成が上書きされます。 既存の構成を確認するには、 このコマンドにより、次のことを行います。

   uipathctl config orchestrator get-config --nlog-config

   Azure BLOB にログを書き込む nlog.config.json ファイルの例

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

   Splunk にロボット ログを書き込む nlog.config.json ファイルの例を以下に示します。

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

NLog の高度な構成を更新する

NLog の構成を更新するために必要な uipathctl コマンドは、次のとおりです。

• uipathctl config orchestrator get-config --nlog-config- 現在の設定をキーと値のペアの JSON ファイルにエクスポートし、編集できるようにします。

  あなたはそれについてもっと読むことができます。

• uipathctl config orchestrator update-config --nlog-config nlog.config.json - 設定が更新され、変更内容が反映されます。

  あなたはそれについてもっと読むことができます。

1. 次のコマンドを使用して、現在のカスタム NLog 構成を json ファイルにエクスポートします。

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

2. エクスポートした nlog.config.json ファイルを必要に応じて編集します。 設定を追加、削除、または変更できます。
   手記： 更新によりすべての NLog 設定が上書きされるため、変更を加える必要がある場合そのたびにファイルを再度エクスポートする必要があります。
3. 次のコマンドを使用して NLog 構成を更新します。

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