ログについて

[ログ] ページには、ユーザーがアクセス権を持つすべてのフォルダー内のロボットが生成したログが表示されます。リモートデバッグセッションによって開始されたジョブで生成されたログも含まれます。

Elasticsearch にアクセスするには、フォルダーコンテキストから Orchestrator の [オートメーション] タブに移動し、表示されるオプションから [ログ] を選択します。

以下の表に、[ログ] ページのフィールドの説明を示します。

フィールド	説明
Time	ログが登録された時刻のタイムスタンプです。注: ログリストは時刻による並べ替えやフィルター処理ができます。
レベル	ログ記録されたメッセージの重要度レベルです。使用できるオプションは、Trace、Debug、Info、Warn、Error、Fatal です。注: ログリストはレベルによる並べ替えやフィルター処理ができます。
プロセス	対象のログメッセージを生成したプロセスの名前です。
ホスト名	プロセスの実行に使用されたワークステーションの名前です。
ホスト ID	実行に使用される ID です。以下の値が表示されます。 `<Domain\Username>` - その特定のアカウントで実行されたジョブです。次のようなジョブに対して表示されます。フォアグラウンドジョブ (Robot のバージョンは関係なし) 2021.10 より前のロボットで実行された、すべてのジョブマシンキーを使用してユーザーのサインインなしで接続されたロボットで実行された Attended ジョブ注: 2021.10 より前のロボットの場合、ホスト ID の値は Orchestrator で行ったアカウント設定に従い動的に設定されます。ジョブの実行に使用するアカウントの `domain\username` を変更すると、ホスト ID も変更されます。 `ROOT` - Linux ロボットで実行されたバックグラウンドジョブです。 `NT AUTHORITY\LOCAL SERVICE` - Robot サービス ID で実行されたジョブです。資格情報なしで v2021.10 以降の Robot で実行されたバックグラウンドジョブに対して表示されます。サービスモードの Robot は `NT AUTHORITY\LOCAL SERVICE` で実行されます。ユーザーモードの Robot は、いずれかのユーザー ID で実行されます。 `N/A` - 対話型サインインで接続したユーザーにより Assistant から開始されたジョブです。ユーザーのサインインなしで、マシンキーを使用してて接続されたロボットの場合は <ドメイン\ユーザー名> が表示されます。
メッセージ	ログに記録されたメッセージです。Studio の [メッセージをログ] アクティビティを通じて記録されたメッセージも含まれる場合があります。この列の内容は、Orchestrator で選択された言語にかかわらず、ロボットの言語で表示されます。

注: フォルダーのコンテキスト外で生成されたログは、Orchestrator データベースと Elasticsearch でのみ表示できます。

フィルター処理

指定されたジョブについてロボットで生成されたログをすべて表示するには、[ジョブ] ページに移動します。

ログが生成されたホストマシンの名前でログをフィルター処理するには、[ログ] ページの [マシン] フィルターを使用します。

新しいフィルターは Elasticsearch に格納されているログに対しては機能しますが、データベースに格納されているログについては新規のログエントリに対してのみ機能します。

ログストレージ

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

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

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

Elasticsearch、ローカル SQL データベース、または UiPath Insights にログを送信できるので、否認不可のログを保持することができます。それぞれのログは相互に独立しているので、1 つのログに問題が発生しても、他のログに影響を及ぼしません。

ログの格納場所を UiPath.Orchestrator.dll.config に設定します。それには、writeTo パラメーターの値を変更します。

ログページには、ログが Elasticsearch または SQL データベースに送信されるときにロボットが Orchestrator に送信するエントリが表示されます。ログが Elasticsearch と SQL の両方に送信される場合、ログページには Elasticsearch に送信されるエントリのみが表示されます。

注:

SQL データベースのパフォーマンスはロボットのログが 200 万に達すると低下し始め、600 万のしきい値に達すると大幅に低下します。パフォーマンスが低下するとログの検索が遅くなり、オートメーションのパフォーマンスに影響が出ます。

これらのしきい値は、UiPath で観察された平均を示しています。データベースサーバーのハードウェアによっては、この値は増減する場合があります (最大 2 倍から 3 倍)。

データベースを定期的にクリーンアップして、制限内に収まるようにする必要があります。

ただし、業務上これらのしきい値を超える必要がある場合は、パフォーマンスを維持するために Elasticsearch を使用する必要があります。

Elasticsearch を使用してロボットのログを保存する場合、状況によってはクエリできるのは 1 万項目のみとなります。

Elasticsearch の制限により、Cloud Platform の Orchestrator テナントは、50 KB を超えるロボットログを無視するように構成されています。ログの大部分は平均して約 2 KB です。

ログレベル

メッセージは、Trace、Debug、Info、Warn、Error、および Fatal というレベルでログに記録されます。

[メッセージをログ] アクティビティを使用して、独自のメッセージを Studio からこのページに送信することもできます。メッセージは上述したいずれかのレベルで記録され、診断用に使用します。

たとえば、次のスクリーンショットでは、独自のメッセージが Fatal の重要度レベルで記録されたことがわかります。

ログをエクスポートする

[Export] ボタンとクリックすると、すべてのログを .csv ファイルにエクスポートすることができます。このファイルの生成時には、このページに適用されているフィルターが考慮されます。たとえば、Info の重要度レベルを持つ直前の 30 日のログのみを表示するように設定している場合は、その条件を満たすエントリのみがダウンロードされます。

最高のパフォーマンスを得るためにエクスポートされたエントリは日付の新しい順に並んでいないため、注意が必要です。

次の場合にのみ、ログが正しい順序で記録されない可能性があります。

ほぼ等しいタイムスタンプを持つロボットログエントリが 2 つ以上あります - それらはミリ秒まで等しく (yyyy-MM-dd HH\:mm\:ss.fff として表現される時間は同じ)、ミリ秒の下のサブユニットは一致していません (yyyy-MM-dd HH\:mm\:ss.fffffff の最後の 4 つの値が異なります)。
ログは、Orchestrator で既定の順序のグリッド形式で表示されます (時間の降順)。

ただし、データベースとエクスポートされる .csv ファイルに対する影響はありません。

注: Orchestrator とスタックトレースからのサーバー例外は両方とも、[ジョブの詳細] ウィンドウに英語で表示されます。ユーザーが選択した言語には関係ありません。