ボットのトラブルシューティング

ボットの状況が ​[OK]​ であっても適切に動作していないようであれば、ログファイルをダウンロードするか、ボットを再起動してください。

ボットの状況が ​[サスペンド]​ の場合は、実行プランを確認してください。

ボットの状況が ​[停止]​、​[期限切れ]​、または ​[不明]​ である場合、IT 管理者は、ボットがインストールされているコンピューターにログオンしてボットをトラブルシューティングする必要があります。

ボットが正常に動作しているときにプロセスの実行に失敗した場合は、デバッグログをオンにして原因を突き止めます。

スケジュールされているプロセス実行を表示する

ボットが処理をしていない理由が不明な場合は、実行プランを確認してください。

  1. Bot Management​ モジュールで、​[ボット実行プラン]​ ビューを開きます。

  2. テーブルで、確認するボットの行にある ​[実行タイムテーブル]​ (​カレンダーの記号​) をクリックします。

実行タイムテーブルには、ボットに割り当てられたすべての設定の有効な実行時間が表示されます。

  1. [実行タイムテーブルを設定]​ (​レンチの記号​) をクリックして、テーブルの期間を変更し、表示される設定を選択します。

  2. [OK]​ をクリックします。

  3. [実行タイムテーブル]​ で、確認する設定の行にある色付きのバーをクリックして、有効な実行時間の構成を表示します。

ボットのサービス時間が設定のスケジュールと重複する場合、設定は実行されます。プロセスでアプリケーションを使用する場合、アプリケーションのダウンタイム中は実行されません。

すべての時間はローカル時間で表示されます。他のタイムゾーンにあるボットとアプリケーションの時間はローカル時間に変換されます。バーのにマウスポインターを置くと、実行時間に含まれているサービス時間、ダウンタイム、スケジュールが表示されます。

有効な実行時間の組み合わせの例

スケジュール、サービス時間、ダウンタイムから有効な実行時間がどのように構成されるかを示す概要

この例では、ローマ (GMT+01:00) に住んでいるユーザーの観点からスケジュールされているプロセス実行を示しています。表示されるすべての時間はユーザーのタイムゾーンに変換されます。

本番設定では、タイムゾーンに関係なく毎日午後 12:30 から午後 20:30 まで繰り返されるスケジュールを使用します。

ボットは UTC タイムゾーンを使用しているコンピューターにインストールされています。日本時間 (GMT+09:00) で定義されたサービス時間が割り当てられています。

プロセスでは、ブエノスアイレス (GMT-03:00) のコンピューターにインストールされているアプリケーションを使用します。停電が発生し、その間、午前 10:00 から午前 10:30 までアプリケーションはダウンしていました。

スケジュールとサービス時間が重複していて、使用されているアプリケーションがダウンしていなければ、ボットはプロセスを実行します。

この例では、スケジュールされている期間中にダウンタイムが発生しています。その期間中、実行は中断されます。サービス時間はスケジュールされている実行時間より前に終了するため、有効な実行時間が短くなります。

[スケジュールチャート]​ で確認できるように、サービス時間とダウンタイムはボットのタイムゾーンに変換されます。これらはすべてのタイムゾーンで同時に観察されます。ボットは自分のタイムゾーンでスケジュールが有効であると解釈します。これはすべてのタイムゾーンで異なる時間に観察されます。

サービス時間を管理​する方法について確認してください。

アプリケーションを管理​する方法について確認してください。

本番​設定と​呼び出し可能​な設定を作成する方法について確認してください。

ボットのログメッセージを表示する

ボットのログメッセージには、プロセス実行に関する詳細な情報が含まれます。RPA Manager では、各ボットのアクティビティが実行結果に関する情報と共にリストされ、アクティビティに含まれるボットメッセージが ​[Additional Customer Info (追加の顧客情報)]​ に表示されます。

ボットのログメッセージを表示する手順は、次のとおりです。

  1. [ボットの管理]​ で ​[プロセス実行統計]​ ビューを開きます。

    または、​Process Automation​ モジュールで次の手順を実行します。

    • テストまたは本番フェーズのプロジェクト内で、​[実行結果]​ パネルの実行結果番号をクリックします。

  2. メッセージを読み取るボットのテーブル行で ​[ボットメッセージログ]​ (​リスト記号​) をクリックします。

ボットメッセージは連結され、切り捨てられている場合があります。完全なボットログを表示するには、ログファイルをダウンロードしてください。

ボットのログファイルをダウンロードする

ZIP 形式のボットのログファイルをダウンロードして、エラーメッセージや警告メッセージを確認したり、スクリーンショットを表示したりします。

パッケージには、​BotTrace​ と ​RpaBotLogfiles​ というフォルダーが入っています。トレースフォルダーには、セキュアセッションのログファイルが保存されています。ログファイルフォルダーには、インストールと設定のデータ、さらにはボットの実行ログが保存されています。

このオプションは、ボットの状況が [OK] の場合にのみ使用できます。

IT 管理者は、RPA Bot Configurator を使用して、ボットがインストールされているコンピューターでパッケージのコンテンツを設定できます。

  1. Bot Management​ モジュールの ​[ボット]​ ビューを開きます。

  2. ログファイルを読み取るボットの行で ​[ログファイルをダウンロード]​ (​ディスクと下向き矢印の記号​) をクリックします。

  3. コンテンツを抽出して関連するファイルを参照します。

デバッグログを有効化する

デバッグログは、RPA ボットバージョン 1.3.4 以降で使用できます。

ボットが正常に動作しているときにプロセスの実行に失敗した場合は、少なくとも次回のプロセス実行期間はデバッグログをオンにして原因を突き止めます。

その後、ボットのログファイルをダウンロードして、失敗の原因を分析する必要がある場合はログファイルをサポートチームに送信してください。

デバッグログを有効化する手順は、次のとおりです。

  1. Bot Management​ モジュールの ​[ボット]​ ビューを開きます。

  2. デバッグするボットのパネルで ​[デバッグログを有効化]​ (​バグの記号​) をクリックします。

  3. [時間限定のデバッグログを有効化]​ ウィンドウに期間を分数で入力し、​[デバッグログを開始]​ をクリックします。

指定した期間が経過すると、ログレベルがデフォルトに戻ります。

ボットがまだデバッグモードである間に新しいデバッグ間隔を設定すると、新しい値で間隔が再スタートします。ボットがデバッグモードになっている間隔や、デバッグモードになっているかどうかを確認することはできません。

ボットを再起動する

この機能を使用してボットを再起動し、ボットが現在実行しているすべてのプロセスがボットの停止前に適切に完了することを確認します。

プロセスを始める前に、ボットはいろいろな条件を確認する必要があります。たとえば、ボットが割り当てられているサービス時間内にあるかどうか、プロセスの実行に必要なすべてのアプリケーションが利用できるかどうかなどです。

ボットは、相互に依存しないタスクを、同時に (非同期に) 実行できるスレッドに分割します。そしてボットは、すべてのタスクが完了するのを待ってから、プロセスを引き続き開始するか、または条件を再び確認します。

稀なケースですが、予期しない状況によって個別のスレッドがエラーとなったものの、ボットに報告できないことがあります。 この場合には、ボットは待機を続け、後続のプロセスを実行できなくなります。

このようなケースでは、ボットの状況が [OK] で、デプロイされたプロセスも有効な実行期間内にあるものの、数分間に渡ってプロセスが 1 つも開始されなくなります。

ボットを再起動すると、保留中のタスクが完了した後に、ボットとそのスレッドがすべて停止状態になります。その後、クリーンな環境で再起動を実行することで、問題が発生しなくなります。

ボットの再起動は、ボットの状況が [OK] である場合にのみ実行できます。そうでない場合は RPA Manager によって再起動がタスクリストに配置され、ボットの状況が [OK] になるとすぐに実行されます。

  1. Bot Management​ モジュールの ​[ボット]​ ビューで、再起動するボットの行にある ​[再起動]​ アイコンをクリックします。

  2. 数秒待ってからブラウザーを更新して、結果を確認します。