通知を受け取る

UiPath Robot

UiPath Robot ガイド

ロボット ログ

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

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

📘

注:

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

ジョブのステータスは UiPath Robot サービスのメモリ内に保存されます。Orchestrator が利用可能になると、ジョブ ステータスに関連する情報は両者の間で同期されます。ただし、Orchestrator が利用できない状態で UiPath Robot サービスを再起動しても、これらの情報は失われます。つまり、Orchestrator が利用可能になったときに、ジョブは再実行されます。

ロボット診断ログ

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

ロボット診断ログを有効化

既定では、ロボット診断ログが有効になっていて、Error または Warning レベルのメッセージのログが記録されます。

他のレベルのログ情報も必要な場合、ロー レベルのトレースを有効化すれば、すべてのログ情報を有効にできます。既定ではこの機能は無効になっています。

ロー レベル トレースを有効化するには、コマンド UiRobot.exe --enableLowLevel をコマンド プロンプトで実行します。
ロー レベル トレースを無効化するには、コマンド UiRobot.exe --disableLowLevel をコマンド プロンプトで実行します。

ロー レベル トレースを管理者、ローカル ユーザー、またはドメイン ユーザーとして有効化すると、.etl ファイルのロー レベル トレースが開始されます。これによって、Robot Executor およびサービスの詳細トレースがイベント ビューアー 内で有効になります。

最初に cd 引数 (cd C:\Program Files\UiPath\Studio など) を使用してインストール ディレクトリに移動するのを忘れないでください。

📘

注:

ロー レベル トレースは、問題の調査時には有効化し、調査セッション終了時には無効化することをお勧めします。
また、トレース情報を含む .etl ファイルはこの機能を無効化した後にのみ生成されます。
変更を有効にするために Robot を再起動する必要はありません。

ロボット診断ログのターゲット

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

既定では、内部ログは NLog.config の以下の行に指定するように、イベント ビューアーに送信されます。

<target xsi:type="EventLog" name="eventLog" layout="${callsite:className=false:includeSourcePath=true:methodName=false} ${message}" source="UiPath" log="Application" />

<logger name="Internal" minLevel="Trace" writeTo="eventLog" />

📘

注:

NLog.config ファイルを編集するには管理者権限が必要です。内部ターゲットが NLog.config ファイルで変更されている場合は、変更を反映するために UiRobot.exe サービスを再起動する必要があります。

.etl ログ ファイルを開く

この種類のファイルは、イベント ビューアーから開くことができます。

  1. イベント ビューアーの [アクション] パネルで、[保存されたログを開く] をクリックします。[保存されたログを開く] ウィンドウが表示されます。
  2. 生成されたトレース ログ ファイルを参照し、[開く] をクリックします。左パネルの [保存されたログ] にファイルが表示されます。
  3. ファイルを選択します。ログの内容が表示されます。

ロボット実行ログ

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

実行ログはいくつかの方法で生成できます。

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

実行ログのログ レベル

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

[Orchestrator の設定] ウィンドウで既定のログ レベルを変更する:

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

📘

注:

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

実行ログのターゲット

By default, Execution Logs are stored in a file in the %LocalAppData%\UiPath\Logs folder. The messages are collected by the WorkflowLogging logger and can be forwarded by using NLog targets, as specified by the following parameters in the NLog.config file:

<target xsi:type="File" name="executionFile" fileName="${LogDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" concurrentWrites="true" />

<logger name="WorkflowLogging" minLevel="Trace" writeTo="executionFile" final="true" />

ロボットOrchestrator に接続されている場合は、すべての実行ログが Orchestrator に送信されて [ログ] ページで見ることができます。
さらに、ログ ターゲットとログ内容は <Installation Folder>\NLog.config ファイルを編集することで構成できます。

📘

注:

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>

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

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

📘

注:

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

3 か月前に更新


ロボット ログ


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。