> ## 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.

# パフォーマンス ガイド

> ABBYY Vantage セルフホスト型のパフォーマンスとスケーリングに関するガイド: 参照構成、リソース要件、ドキュメント ワークロード別の推奨事項。

<div id="introduction">
  ## はじめに
</div>

ABBYY Vantage をインストールする際、サービスとワーカーの数は負荷によって異なります。ABBYY Vantage は、文書処理を最適化するために、サービスとワーカーを自動的にスケーリングします。このガイドでは、負荷に応じて ABBYY Vantage が必要とするリソースに関する情報と、それらのリソースを ABBYY Vantage に適切に提供する方法についてのシステム管理者向けの推奨事項を説明します。

<div id="reference-configurations">
  ## 参照構成
</div>

リソース消費量は、文書処理のシナリオ、つまり処理する文書の種類、使用するSkill、ページ負荷 (一定時間内に処理されるページ数) によって異なります。

**高可用性**の参照構成は、デフォルトのProcess skillを使用して3ページおよび50ページの請求書を処理する条件で、次の負荷でテストされました。

* 8時間あたり50,000ページ
* 8時間あたり100,000ページ
* 8時間あたり150,000ページ
* 8時間あたり200,000ページ

**高可用性なし**の参照構成は、デフォルトのProcess skillを使用して3ページの請求書を処理する条件で、次の負荷でテストされました。

* 8時間あたり10,000ページ
* 8時間あたり30,000ページ
* 8時間あたり50,000ページ

<Note>
  高可用性なし構成では、Deep Learning activityを使用したSkillのトレーニングはサポートされていません。
</Note>

参照構成のテストでは、REST API経由でファイルをシステムに投入しました。次のワークフローを持つデフォルトのProcess skillを使用しました。

1. ファイルをImportします。
2. 文書をRecognizeします。
3. Classifyして文書タイプを判定します。
4. 文書からデータをExtractします。
5. データをJSONにExportします。

<div id="node-types">
  ### ノードの種類
</div>

| ノードの種類   | CPU コア数 (各ノード) | RAM (GB、各ノード) | ディスク サイズ (GB) |
| -------- | -------------- | ------------- | ------------- |
| サービス ノード | 12             | 48            | 120\*         |
| ワーカー ノード | 12             | 48            | 120           |

\*上記のディスク サイズ要件は最小要件を示しており、追加のディスク領域が必要になる場合があります。既定では、Vantage は仮想マシン上に NFS ファイル ストレージをインストールします。この場合、最初のサービス ノードとして使用される仮想マシンでは、負荷に応じて追加のディスク領域が必要になります。

<div id="storage-requirements">
  ### ストレージ要件
</div>

| 構成     | ストレージ       | ストレージの場所                    | ディスク サイズ (GB)                   |
| ------ | ----------- | --------------------------- | ------------------------------- |
| 高可用性なし | 内部 NFS      | サービス ノード                    | 500 (8 時間あたり 10,000 ページを処理する場合) |
| 高可用性なし | 外部 NFS      | NFS サーバー マシン                | 500 (8 時間あたり 10,000 ページを処理する場合) |
| 高可用性   | 外部 NFS      | NFS サーバー マシン                | 50 (8 時間あたり 10,000 ページを処理する場合)  |
| 高可用性   | ローカル永続ボリューム | 最初のサービス ノード (インベントリ ファイルから) | 500 (8 時間あたり 10,000 ページを処理する場合) |

サイズの大きいデータ カタログ、多数のアクティビティを含む Skill を使用する場合、またはデータを共有フォルダーにエクスポートする場合は、追加のストレージ容量が必要になることがあります。

<Note>
  負荷が 8 時間あたり 10,000 ページを超える場合は、外部ストレージの使用を推奨します。
</Note>

<div id="performance-results">
  ### パフォーマンス結果
</div>

ページ負荷に応じて、各構成で文書を効率的に処理するために ABBYY Vantage に必要なリソース量は次のとおりです。

<div id="highly-available-configuration">
  #### 高可用性構成
</div>

| ロード (ページ数/8時間) | サービス用ノード数 (3ページの請求書) | サービス用ノード数 (50ページの請求書) | ワーカー用ノード数 (3ページの請求書) | ワーカー用ノード数 (50ページの請求書) |
| -------------- | -------------------- | --------------------- | -------------------- | --------------------- |
| 50,000         | 4                    | 4                     | 4                    | 4                     |
| 100,000        | 4                    | 4                     | 5                    | 7                     |
| 150,000        | 4                    | 4                     | 7                    | 9                     |
| 200,000        | 4                    | 4                     | 8                    | 11                    |

テスト時には、Blob ストレージに使用されるディスクの入出力操作に関する統計情報も収集されました。お客様の環境でも、これらの数値を超えることはないと見込まれます。

<div id="disk-io-operations">
  #### ディスク I/O 操作
</div>

| ロード (ページ数/8時間) | 1秒あたりのディスクI/O操作数 (3ページの請求書) | 1秒あたりのディスクI/O操作数 (50ページの請求書) |
| -------------- | --------------------------- | ---------------------------- |
| 50,000         | 100                         | 50                           |
| 100,000        | 250                         | 100                          |
| 150,000        | 400                         | 170                          |
| 200,000        | 600                         | 230                          |

<div id="without-high-availability-configuration">
  #### 高可用性なしの構成
</div>

| ロード (ページ/8時間) | サービス用ノード | ワーカー用ノード |
| ------------- | -------- | -------- |
| 10,000        | 1        | 1\*      |
| 30,000        | 1        | 3        |
| 50,000        | 1        | 3        |

\*ワーカーノードが1つの構成はテスト目的専用であり、どの Activity を使用する Skill の学習にも対応していません。

<Note>
  ABBYY Vantage をスケーリングしても、文書処理時間の増加は見られませんでした。
</Note>

<div id="managing-nodes">
  ## ノードの管理
</div>

システム管理者は、必要な処理量に対応するため、クラスターにワーカーノードを追加できます。ノードの準備方法の詳細については、[システム要件](/ja/vantage/self-hosted/v2.7/system-requirements)を参照してください。

<div id="adding-a-worker-node">
  ### ワーカーノードの追加
</div>

ワーカーノードを追加するには、次の手順を実行します。

1. インストールディレクトリにあるインベントリファイルを開きます。
2. `[abbyy_workers]` セクションで、名前と IP アドレスを指定してノードを 1 つ追加します。
3. インストーラーを実行します。

```bash theme={null}
docker run -it \
-v $PWD/kube:/root/.kube \
-v $PWD/ssh/ansible:/root/.ssh/ansible \
-v "//var/run/docker.sock:/var/run/docker.sock" \
-v $PWD/inventory:/ansible/inventories/k8s/inventory \
-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
--privileged \
registry.local/vantage/vantage-k8s:2.7.1
```

4. 次のプレイブックを実行します。

```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/4-Kubernetes-k8s.yml
```