Robot ガイド

最終更新日時 2025年11月22日

ログとログレベル

プロセスの実行中、ロボットは途中でステップごとにメッセージ (ログ) を生成します。これらは収集され、ログファイルに保存されます。このログを収集し保存する操作全体は、ログ記録と呼ばれています。

各ログには、生成されたメッセージの詳細度を示すログレベルがあります。

ログレベルは、ログファイルに書き込まれる重要度の種類を示します。

UiPath のログレベル

ログレベルとは、生成されるメッセージの詳細度のことです。ログレベルは次の場所で設定できます。

[Assistant] > [設定] > [全般] ページの [ログレベル] 設定。既定では、Information に設定されています。
Orchestrator > [アクセス権を管理] > [ユーザー] > [ユーザー] または [ロボットアカウント] > [ロボットの設定] ページの [ログレベル] 設定。既定では、Information に設定されています。
注: Orchestrator で設定されたログレベルが Assistant で設定されたログレベルよりも優先されます。

UiPath では、以下のログレベルを使用します。各レベルは優先度順に昇順で記載されています。

Off - ログは一切保存されません。このレベルは通常、ログをオフにする場合に使用します。
Verbose - よりきめ細かいレベルをレポートし、オートメーションの操作について記録可能な詳細をすべてログに記録します。記録される詳細には、変数の変更、関数呼び出し、さらには外部応答に関する情報などがあります。Trace レベルのログはすべて表示されます。既定では、Verbose レベルには次のログエントリが含まれます。
- Execution Starated - プロセスが開始されるたびに生成されます。
- Execution Ended - プロセスが終了するたびに生成されます。
- Transaction Started - ロボットが Orchestrator からトランザクションアイテムを取得するたびに生成されます。
- Transaction Ended - ロボットがトランザクションステータスを Success または Failed のいずれかに設定するたびに生成されます。
- Activity Information - エントリ - プロセス内で、アクティビティが開始、失敗または完了されるたびに生成されます。
Trace - 最も詳細な情報が含まれます。ほとんどの場合は、システム内の特定のタスク実行パスをデバッグまたは追跡する場合に使用します。Trace、Information、Warning、Error、Critical のレベルのログがすべて表示されます。
Information - 情報ログは、タスクの開始や終了など、オートメーションの実行に関する全般的な洞察を提供します。Information、Warning、Error、Critical のレベルのログがすべて表示されます。
Warning - 現在の操作に今すぐには影響しないものの、今後重大化する可能性がある軽微な問題や潜在的な問題が含まれます。Warning、Error、Critical のレベルのログがすべて表示されます。
Error - このレベルで生成されるログには、実行中に発生したエラーの詳細が含まれます。エラーが発生した場合、ワークフローの通常の操作を実行することはできませんが、システム全体が停止することはありません。Error および Critical のレベルのログがすべて表示されます。
Critical - 重大な問題またはエラーを示すログが記録されます。非常に深刻であり直ちに対応が必要な問題は通常、このレベルで記録されます。

ログの PII 情報について

`Information`、`Warning`、`Error`、`Critical`

Information、Warning、Error、Critical ログレベルの使用時には、入力/出力引数の値は追跡されません。つまり、Studio から明示的に追加しない限り、PII 情報は Orchestrator のログに送信されません。

`Verbose` および `Trace`

Trace および Verbose ログレベルの使用時には、入力/出力引数の値が追跡され Orchestrator のログに書き込まれます。これらの値に PII 情報が含まれていた場合、それらの情報は Orchestrator のログに追加されます。

`excludeLoggedData` を使用して機密情報を非表示にする

excludedLoggedData 変数を使用すると、Verbose レベルで変数や引数の値がログ出力されないようにするためのキーワードを追加できます。

また、アクティビティの [プライベート] チェックボックスをオンにしても同じ結果が得られます。機密情報の保護の詳細については、こちらをご覧ください。

"excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],"excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],

ログの種類

次に示すように、記録されるイベントに応じて、いくつかのログメッセージが出現する可能性があります。

既定 (Default)

既定では、プロセスの実行が開始されたとき、および終了したとき、システムエラーが発生して実行が停止したとき、またはログ設定がすべてのアクティビティの実行を記録するように構成されているときに生成されます。

注: これらのログは、[logType] フィールドに Default 値を持ちます。

このカテゴリで記録されるイベントは、次のとおりです。

Execution Start はプロセスが開始されるたびに生成されます。これは、Information のログレベルから記録されます。
Execution End はプロセスが終了するたびに生成されます。これは、Information ログレベルから記録されます。
Transaction Started はプロセス内のトランザクションが開始されるたびに生成されます。これは、Information のログレベルから記録されます。
Transaction Ended はプロセス内のトランザクションが終了するたびに生成されます。これは、Information のログレベルから記録されます。
Error Log は、実行がエラーを検出して停止するたびに生成されます。これは、Error のログレベルから記録されます。
Debugging Log は、ロボットのログ設定が Verbose に設定され、アクティビティ名や型、変数値、引数などが含まれている場合に生成されます。これは Trace のログレベルからログに記録されます。

ユーザー定義

[メッセージをログ] アクティビティまたは [1 行を書き込み] アクティビティを使用する場合、Studio でユーザーが設計したプロセスに従って生成されます。

注: これらのログは、[logType] フィールドに User 値を持ちます。

ログフィールド

上記のログメッセージの種類には、複数の種類のログフィールドがあります。これらは次のように分類できます。

既定のフィールド

Message - ログメッセージです。
Level - ログの重要度を定義します。
Timestamp - アクションが実行された正確な日付と時刻です。
FileName - 実行されている .xaml ファイルの名前です。
jobId * - プロセスを実行しているジョブのキーです。
processName * - ログの記録をトリガーしたプロセスの名前です。
processVersion * - プロセスのバージョン番号です。
windowsIdentity - ログに記録されたアクションを実行したユーザーの名前です。
robotName * - (Orchestrator で定義された) ロボットの名前です。
machineName - ロボット端末の名前です。
machineId * - ロボット端末の ID です。
organizationUnitId * - Orchestrator 組織の ID です。

* アスタリスクが付いているログフィールドは、[ログフィールドを追加] アクティビティで上書きできません。

注: プロセスが Orchestrator に接続されずにローカルで実行されている場合、processName フィールドと processVersion フィールドはログに表示されません。

種類固有のフィールド

これらのログは、ログの種類に応じて表示されます。

Execution End

totalExecutionTimeInSeconds
totalExecutionTime

Transaction Start

queueName
transactionID
transactionState
initiatedBy

Transaction End

queueName
transactionID
transactionState
transactionStatus
トランザクション実行時間
ProcessingExceptionType
processingExceptionReason
queueItemReviewStatus
queueItemPriority

Debugging Log

activityInfo は次のフィールドを持つ JSON メッセージです。

表示名
ステート (Faulted、Closed、Executing)
アクティビティ
引数

注: ログメッセージに常に表示されるのは、totalExecutionTimeInSeconds、totalExecutionTime、queueName のみです。通常、Variables および Arguments にはサブフィールドがあります。