ロボットログ

ログは、アプリケーションに関連する情報イベント、エラー、警告メッセージを含む、タイムスタンプ付きのファイルです。

ログの種類は、以下のとおりです。

ロボット実行ログ

ロボット実行ログは、プロセスの実行によって生成されるメッセージです。ワークフロー内でのその動作に関連する情報とユーザー定義メッセージを含みます。

実行ログは以下によって生成されます。

[1 行を書き込み] アクティビティ。この場合、Trace レベルのログが作成されます。
[メッセージをログ] アクティビティ。この場合、アクティビティの [レベル] プロパティフィールドで指定されたレベルでログが作成されます。
オートメーションプロジェクトの実行。この場合、各アクティビティの動作を含むログが生成されます。Assistant の [Orchestrator の設定] ウィンドウの [レベル ] が Verbose に設定されていると、Trace レベルのログが記録されます。

実行ログのログレベル

既定のログレベルは、[Orchestrator の設定] ウィンドウの [レベル] 設定で制御します。既定では、Information に設定されています。

注: ロボットに対して Orchestrator で設定されたログレベルが UiPath Assistant で設定されたログレベルよりも優先されます。

Assistant から既定のログレベルを変更する

UiPath Assistant から [設定] メニューに移動し、[Orchestrator の設定] にアクセスします。
[ログ] セクションの [ログレベル] ドロップダウンメニューから、適切なログレベルを選択します。

注: Robot がサービスモードでインストールされている場合、この設定を編集するには管理者権限が必要です。

Orchestrator ターゲット

ロボットが Orchestrator に接続されている場合は、すべての実行ログが Orchestrator に送信されて [ログ] ページで見ることができます。

Orchestrator が利用できない場合は、接続が復元するまで、ローカルデータベース形式 (C:\Windows\SysWOW64\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data) で、利用可能なディスクスペース内に保存されます。接続が復元すると、ログは生成された順番に分割して送信されます。

注: データベースは、ログが Orchestrator に正常に送信された後も削除されません。

NLog ターゲット

さらに、ログターゲットとログ内容は <Installation Folder>\NLog.config ファイルを編集することで構成できます。

ログの記録先は <Installation Folder>\NLog.config ファイルで制御されます。診断ログは内部のロガーで収集され、NLog ターゲットを使用して転送されます。

既定では、実行ログは %LocalAppData%\UiPath\Logs フォルダー内のファイルに保存されます。メッセージは WorkflowLogging ロガーで収集され、NLog.config ファイル内の以下のパラメーターの設定に従って、NLog ターゲットを使用して転送できます。

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog><?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog>

古いワークフローログファイルを削除する

マシン上のディスク領域を消費する大量のログファイルが作成されないように、ログファイルが特定の数に達したらファイルをアーカイブするよう選択できます。

それには、NLog.config の <target> タグに以下のパラメーターを追加します。

archiveNumbering="Date"
archiveEvery="Day"
archiveDateFormat="yyyy-MM-dd"
archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"

maxArchiveFiles="10"

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File"
      name="WorkflowLogFiles"
      fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
      layout="${time} ${level} ${message}"
      keepFileOpen="true"
      openFileCacheTimeout="5"
      concurrentWrites="true"
      encoding="utf-8"
      writeBom="true"
      archiveNumbering="Date"
      archiveEvery="Day"
      archiveDateFormat="yyyy-MM-dd"
      archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
      maxArchiveFiles="10"
    />
  </targets>
</nlog><?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File"
      name="WorkflowLogFiles"
      fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
      layout="${time} ${level} ${message}"
      keepFileOpen="true"
      openFileCacheTimeout="5"
      concurrentWrites="true"
      encoding="utf-8"
      writeBom="true"
      archiveNumbering="Date"
      archiveEvery="Day"
      archiveDateFormat="yyyy-MM-dd"
      archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
      maxArchiveFiles="10"
    />
  </targets>
</nlog>

注: maxArchiveFiles は、アーカイブファイルの数を制御するパラメーターです。

注: NLog.config ファイルを編集するには管理者権限が必要です。変更を反映するために Robot サービスの再起動は必要ありません。

ログの詳細編集

ログレベルが Verbose に設定されている場合は、メッセージには実行時に行われたアクティビティに関するすべての詳細が含まれます。このログ出力はC:\Program Files\UiPath\Studio フォルダーにある UiPath.Executor.exe.config ファイルを編集することでカスタマイズできます。

それには、以下の XML コードを <system.serviceModel> タグの下に追加する必要があります。

<tracking>
    <profiles>
        <trackingProfile name="StandardProfile">
         <workflow>
          <activityStateQueries>  
            <activityStateQuery activityName="*">
                <states>  
                    <state name="Faulted"/>  
                </states>
                <arguments>  
                    <argument name="*"/>  
                </arguments> 
                 <variables>  
                    <variable name="*"/>  
                </variables>             
            </activityStateQuery>
          </activityStateQueries>    
         </workflow>
        </trackingProfile>       
    </profiles>
</tracking><tracking>
    <profiles>
        <trackingProfile name="StandardProfile">
         <workflow>
          <activityStateQueries>  
            <activityStateQuery activityName="*">
                <states>  
                    <state name="Faulted"/>  
                </states>
                <arguments>  
                    <argument name="*"/>  
                </arguments> 
                 <variables>  
                    <variable name="*"/>  
                </variables>             
            </activityStateQuery>
          </activityStateQueries>    
         </workflow>
        </trackingProfile>       
    </profiles>
</tracking>

<states> タグに <state name="Faulted"/> のみが含まれているため、上記のコードを挿入すると、エラー ステートのアクティビティのみがログに記録されます。<states> タグに他のパラメーター (<state name="Executing"/> など) を追加すると、他のステートのアクティビティもログに記録されます。

アクティビティのステートだけでなく、変数や引数も変更できます。カスタマイズについての詳細情報はこちらをご覧ください。

注: UiPath.Executor.exe.config ファイルを変更する場合、変更を反映するため Robot サービスの再起動が必要です。

ロボット診断ログ

ロボット診断ログではロボット自体およびそのコンテキストに関連する情報が提供されます。これらの情報は特定のエラーの原因を識別するのに役立ちます。

ロボット診断ログは、以下の場所に保存されます。

Windows では、エラーに関連する診断ログはイベントビューアーに記録されます。
Windows を含むすべてのプラットフォームでは、診断の詳細ログは以下のファイルに書き込まれます。
- %LocalAppData%\UiPath\Logs\internal\Robot.log (Windows で Robot がユーザーモードでインストールされている場合)
- %PROGRAMDATA%\UiPath\Logs\internal\Robot.log (Windows で Robot がサービスモードでインストールされている場合)
- ~/.local/share/UiPath/Logs/internal/Robot.log (他のプラットフォームの場合)

ドライバー診断ログ

ドライバートレースは .etl ファイルに書き込まれます。

ドライバートレースを有効化するには、コマンドプロンプトを管理者権限で開き、cd 引数を使用してインストールディレクトリにアクセスし (例: cd C:\Program Files\UiPath\Studio)、UiRobot.exe --enableLowLevel コマンドを実行します。

ドライバートレースを無効化するには、コマンドプロンプトを管理者権限で開き、cd 引数を使用してインストールディレクトリにアクセスし (例: cd C:\Program Files\UiPath\Studio)、UiRobot.exe --disableLowLevel コマンドを実行します。

注:

低レベルのトレースは、問題の調査時にのみ有効にして、調査セッションが終了したら無効にすることをお勧めします。

さらに、トレース情報を含む .etl ファイルは、機能を無効化して初めて生成されます。

Robot を再起動しなくても変更が反映されます。