> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill Monitor のトランザクション

> Skill Monitor で詳細なトランザクション情報を確認できます。グラフのフィルタリング、イベントログの確認、トランザクションのキャンセル、ABBYY Vantage で失敗したトランザクションの再開を行えます。

Skill Monitor サービスの**トランザクション**セクションでは、システムのパフォーマンス、アクティブ/完了したトランザクション、特定の Skill におけるトランザクションの各ステージに関する詳細情報が表示されます。

テナント管理者および処理監督者は、この情報を分析して各 Skill のドキュメント処理を管理できます。たとえば、エラーのあるトランザクションを検出し、詳細なイベントログを用いて原因を特定し、トランザクションをキャンセルしたり、手動確認用にトランザクションを送ったりできます。

<div id="filters">
  ## フィルター
</div>

**トランザクション** セクションの情報は、グラフとトランザクション一覧で表示されます。表示するデータを指定するには、ページ上部のフィルターを使用します。次の条件で絞り込めます。

* トランザクションを表示したい Skill
* トランザクションの種類 — **すべて**、**処理中**、または **処理完了**
* トランザクションを集計する期間 — 1 時間、3 時間、3 日など。トランザクション一覧には作成日で絞り込まれたデータが表示され、**スループット** グラフには完了日で絞り込まれたデータが表示されます。
* 統計を表示したいステージ — **すべて**、**手動確認**、または **自動**
* ステージ名
* トランザクションのステータス — **すべて**、**新規**、**処理中**、**処理完了**、**失敗**、または **キャンセル済み**

<Note>
  フィルター条件に一致しない場合でも、アクティブなトランザクションはすべて表示されます。
</Note>

<div id="graphs">
  ## グラフ
</div>

グラフに表示されるデータは、設定したフィルターによって異なります。

* **スループット** — 各時点までに完了したトランザクション数。
* **キュー** — 各時点までにまだ完了していないトランザクション数。
* **所要時間** — 各時点までに作成されたトランザクションの処理にかかった平均時間。

グラフの特定の箇所の情報を表示するには、その上にカーソルを合わせます。たとえば、**キュー** グラフのピークを見ると、未完了のトランザクション数が最も多かった時点を確認できます。グラフの情報は数分ごとに更新されるほか、ページを更新したときや選択したフィルターを変更したときにも更新されます。

<div id="transaction-list">
  ## トランザクション一覧
</div>

グラフに加えて、ページには選択した Skill と期間のトランザクション一覧が表示されます。各トランザクションについて、ファイル名、識別子、現在のステージ、ステージの担当者、処理済みドキュメント数、作成時刻、所要時間が表示されます。

<div id="customizing-columns">
  ### 列のカスタマイズ
</div>

追加のトランザクションパラメーターおよびドキュメントパラメーター (ファイル名、ファイルパス、ソースの種類) を含む列を表示するかどうかを指定できます。テーブルヘッダーのその他のオプションアイコンをクリックし、リストからパラメーターを選択します。同じリストを使用して、他のトランザクションパラメーターの列を管理することもできます。

トランザクションテーブルにカスタムパラメーターを追加するには、その他のオプションアイコンをクリックし、**Add column** を選択します。表示されるダイアログで、パラメーターの型 (**Transaction** または **Document**) を選択し、名前を指定します。

<Tip>
  追加パラメーターを使用すると、システムパフォーマンスを詳しく分析できます。たとえば、特定のソース (モバイルデバイスなど) からのドキュメントの処理に、他のソースからのドキュメントより常に時間がかかる場合は、そのソースを処理する Skill の改善が必要な可能性があります。
</Tip>

<div id="transaction-retention">
  ## トランザクションの保持
</div>

トランザクションは、保持ポリシーで指定された期間後にステータスに関係なく削除され、関連するすべてのドキュメントおよび認識・抽出データも併せて削除されます。デフォルトの保存期間は 2 週間です。

自動削除は、Skill の設定および公開時にアップロードされたドキュメント (トレーニングおよびデモのドキュメントセット) には影響しません。これらはユーザーデータと見なされるためです。保存期間が終了する前でも、Vantage API を使用して手動でトランザクションを削除できます。

<div id="transaction-actions">
  ## トランザクションの操作
</div>

テナント管理者と処理監督者は、一覧内の各トランザクションに対して次の操作を実行できます。

* **トランザクションを手動確認用に取得し、[手動確認クライアント](/ja/vantage/documentation/runtime/manual-review/manual-review)で処理する。** 一覧からトランザクションを開きます。別のユーザーがそのタスクを開いている場合は、警告ダイアログが表示されます。このダイアログで、タスクを拒否するか取得するかを選択します。拒否した場合、タスクはキューに戻ります。別のユーザーが開いているタスクを取得すると、そのタスクは自分に引き継がれ、他のユーザーが行った変更はすべて保存されます。
* **トランザクションを手動確認ステージに送り、別のオペレーターに渡す。** これを行うには、次の手順に従います。
  1. 一覧からトランザクションを開きます。手動確認クライアントが開きます。
  2. トランザクションを次のステージまたはオペレーターに送るには、[ドキュメントを手動確認する](/ja/vantage/documentation/runtime/manual-review/verification)の手順に従ってください。
* **詳細なイベントログを表示** して、エラーの原因となったイベントを特定する。詳細については、以下の[ワークフローイベント](#workflow-events)を参照してください。
* **トランザクションをキャンセルする。** これは、不適切なドキュメントのアップロードが原因で重大なエラーが発生した場合に必要になることがあります。完了したトランザクションはキャンセルできません。

<Note>
  上記の操作を実行できるのは、テナント管理者と処理監督者のみです。Skill Designer は、すべての Skill のトランザクションを表示できます。
</Note>

<div id="workflow-events">
  ## ワークフローイベント
</div>

各トランザクションのワークフローについて、詳細なイベントログを確認できます。ワークフローが特定のステップで停止している場合やエラーが発生している場合は、イベントログが原因の特定に役立ちます。

イベントログを表示するには、一覧でトランザクション名をクリックします。**Transaction Event Log** ウィンドウが開き、選択したトランザクションのすべてのイベントの一覧が表示されます。イベントログの検索バーを使用してイベント名で検索するか、**Errors** フィルターを使用してエラーのあるイベントのみを表示します。

<div id="list-of-possible-workflow-events">
  ### 可能なワークフローイベントの一覧
</div>

| Event                  | Description                                                                                                                                                                                                                                  |
| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Workflow Created`     | トランザクションを開始するための処理フローが作成されました。                                                                                                                                                                                                               |
| `Workflow Started`     | 処理が開始されました。                                                                                                                                                                                                                                  |
| `Job Created`          | トランザクションの一部としてタスクが作成されました。                                                                                                                                                                                                                   |
| `Job Started`          | タスクが開始されました。                                                                                                                                                                                                                                 |
| `Job Completed`        | タスクが完了しました。                                                                                                                                                                                                                                  |
| `Workflow Completed`   | 処理が完了しました。                                                                                                                                                                                                                                   |
| `Reprocessing started` | 所定の時間内に完了しなかったため、処理が再開されました。                                                                                                                                                                                                                 |
| `Log Message`          | カスタム アクティビティおよび External system (Output アクティビティ) のスクリプト内で、それぞれ Context.LogMessage メソッドまたは Context.ErrorMessage メソッドによって生成されたログメッセージまたはエラーメッセージ。Context.LogMessage メソッドで出力されたメッセージは警告記号で示され、Context.ErrorMessage メソッドで出力されたメッセージはエラーとして示されます。 |

<div id="exporting-the-event-log">
  ### イベントログのエクスポート
</div>

技術サポートやシステム管理者に詳細なトランザクションイベント情報を送付しやすくするため、**Transaction Event Log** ウィンドウ上部の **Export to CSV** をクリックして、イベントログを CSV ファイルにエクスポートしてください。

<div id="restarting-failed-transactions">
  ## 失敗したトランザクションの再処理
</div>

ネットワークのタイムアウト、サードパーティの API 呼び出しの失敗、Vantage プラットフォームの問題などの外部要因が発生した場合は、失敗したトランザクションを再処理できます。ドキュメントを再処理しても、ページ数にはカウントされません。

「Job execution」エラーが発生したトランザクションは再処理できます。

<Steps>
  <Step title="Skill Monitor を開く">
    Skill Monitor に移動し、失敗したトランザクションを見つけます。
  </Step>

  <Step title="トランザクションを再開する">
    失敗したトランザクションを選択し、次に **Restart** をクリックします。

    <Frame caption="Restart ボタンが表示された失敗したトランザクション">
      <img src="https://mintcdn.com/abbyy/H5E8La7RstaIlBWx/images/vantage/runtime/restarttransaction.png?fit=max&auto=format&n=H5E8La7RstaIlBWx&q=85&s=7c010b334d0492f213eb78cfa61cb320" alt="Restart ボタンが強調表示された失敗したトランザクションの一覧" width="1134" height="260" data-path="images/vantage/runtime/restarttransaction.png" />
    </Frame>
  </Step>

  <Step title="再開を確認する（任意）">
    **Show Log** をクリックして、トランザクションが再開されたことを確認し、ログの詳細を表示します。

    <Frame caption="再開後に詳細なトランザクションログを表示する Show Log オプション">
      <img src="https://mintcdn.com/abbyy/H5E8La7RstaIlBWx/images/vantage/runtime/show_log.png?fit=max&auto=format&n=H5E8La7RstaIlBWx&q=85&s=eefc2d819737a6de9a0e11b56590ae0f" alt="再開後に詳細なトランザクションログを表示する Show Log オプション" width="1122" height="732" data-path="images/vantage/runtime/show_log.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  再処理に成功すると、そのトランザクションは再度再開できなくなります。
</Note>

<Warning>
  Process skill を編集して問題を修正し、変更を加えて再公開すると、新しいバージョンが作成されます。ただし、その後で失敗したトランザクションを再開すると、新しいバージョンではなく古い Process skill のバージョンが使用されるため、トランザクションは再び失敗する可能性が高くなります。
</Warning>

<div id="related-topics">
  ## 関連トピック
</div>

* [Skill Monitor](/ja/vantage/documentation/runtime/skill-monitor/skill-monitor)
* [Skill Monitor の概要](/ja/vantage/documentation/runtime/skill-monitor/overview)
* [Skill Monitor のエラーログ](/ja/vantage/documentation/runtime/skill-monitor/error-log)
* [手動確認クライアント](/ja/vantage/documentation/runtime/manual-review/manual-review)
* [ドキュメントを手動確認する](/ja/vantage/documentation/runtime/manual-review/verification)