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

# Guide de performance

> Guide de performance et de scalabilité pour ABBYY Vantage auto-hébergé : configurations de référence, besoins en ressources et recommandations selon le volume de documents.

<div id="introduction">
  ## Introduction
</div>

Lors de l’installation d’ABBYY Vantage, le nombre de services et de workers dépend de la charge. ABBYY Vantage adapte automatiquement le nombre de services et de workers afin d’optimiser le traitement des documents. Ce guide fournit des informations sur les ressources dont ABBYY Vantage aura besoin en fonction de la charge, ainsi que des recommandations à l’intention de l’administrateur système sur la manière appropriée de fournir ces ressources à ABBYY Vantage.

<div id="reference-configurations">
  ## Configurations de référence
</div>

La consommation des ressources dépend de votre scénario de traitement des documents : du type de documents traités, de la compétence utilisée et de la charge en pages (c’est-à-dire du nombre de pages traitées sur une période donnée).

La configuration de référence **haute disponibilité** a été testée pour le traitement de factures de 3 et 50 pages à l’aide de la Compétence de processus par défaut, avec les charges suivantes :

* 50 000 pages par 8 heures
* 100 000 pages par 8 heures
* 150 000 pages par 8 heures
* 200 000 pages par 8 heures

La configuration de référence **sans haute disponibilité** a été testée pour le traitement de factures de 3 pages à l’aide de la Compétence de processus par défaut, avec les charges suivantes :

* 10 000 pages par 8 heures
* 30 000 pages par 8 heures
* 50 000 pages par 8 heures

<Note>
  La configuration sans haute disponibilité ne prend pas en charge l’entraînement des compétences avec l’activité Deep Learning.
</Note>

Lors des tests des configurations de référence, les fichiers ont été envoyés au système via la REST API. La Compétence de processus par défaut avec le workflow suivant a été utilisée :

1. Importer les fichiers.
2. Reconnaître les documents.
3. Classify et déterminer les types de documents.
4. Extract les données des documents.
5. Exporter les données au format JSON.

<div id="node-types">
  ### Types de nœuds
</div>

| Type de nœud     | Cœurs CPU (pour chaque nœud) | RAM, Go (pour chaque nœud) | Taille du disque, Go |
| ---------------- | ---------------------------- | -------------------------- | -------------------- |
| Nœuds de service | 12                           | 48                         | 120\*                |
| Nœuds de travail | 12                           | 48                         | 120                  |

\*Les tailles de disque indiquées ci-dessus correspondent aux exigences minimales ; un espace disque supplémentaire peut donc être nécessaire. Par défaut, Vantage installe le stockage de fichiers NFS sur des machines virtuelles. Dans ce cas, les machines virtuelles utilisées comme premier nœud de service nécessiteront un espace disque supplémentaire en fonction de la charge.

<div id="storage-requirements">
  ### Exigences de stockage
</div>

| Configuration            | Stockage                | Emplacement de stockage                           | Taille du disque, Go                                         |
| ------------------------ | ----------------------- | ------------------------------------------------- | ------------------------------------------------------------ |
| sans haute disponibilité | NFS interne             | Nœud de service                                   | 500 (pour le traitement de 10 000 pages toutes les 8 heures) |
| sans haute disponibilité | NFS externe             | Machine serveur NFS                               | 500 (pour le traitement de 10 000 pages toutes les 8 heures) |
| haute disponibilité      | NFS externe             | Machine serveur NFS                               | 50 (pour le traitement de 10 000 pages toutes les 8 heures)  |
| haute disponibilité      | volume persistant local | Premier nœud de service (du fichier d’inventaire) | 500 (pour le traitement de 10 000 pages toutes les 8 heures) |

Vous pouvez avoir besoin d’un espace de stockage supplémentaire si vous utilisez de grands catalogues de données, des compétences comportant un grand nombre d’activités ou si vous exportez des données vers des dossiers partagés.

<Note>
  Nous recommandons d’utiliser un stockage externe si le volume à traiter dépasse 10 000 pages toutes les 8 heures.
</Note>

<div id="performance-results">
  ### Résultats de performance
</div>

Selon la charge en pages, ABBYY Vantage nécessitait la quantité de ressources suivante pour traiter efficacement les documents dans chaque configuration :

<div id="highly-available-configuration">
  #### Configuration en haute disponibilité
</div>

| Charge (pages/8 heures) | Nœuds pour les services (factures de 3 pages) | Nœuds pour les services (factures de 50 pages) | Nœuds pour les workers (factures de 3 pages) | Nœuds pour les workers (factures de 50 pages) |
| ----------------------- | --------------------------------------------- | ---------------------------------------------- | -------------------------------------------- | --------------------------------------------- |
| 50,000                  | 4                                             | 4                                              | 4                                            | 4                                             |
| 100,000                 | 4                                             | 4                                              | 5                                            | 7                                             |
| 150,000                 | 4                                             | 4                                              | 7                                            | 9                                             |
| 200,000                 | 4                                             | 4                                              | 8                                            | 11                                            |

Pendant les tests, des statistiques sur les opérations d’entrée/sortie du disque utilisé pour le stockage des blobs ont également été recueillies. Vous pouvez vous attendre à ce que, dans votre cas, les chiffres ne dépassent pas les suivants :

<div id="disk-io-operations">
  #### Opérations d’E/S disque
</div>

| Charge (pages/8 heures) | Opérations d’E/S disque/seconde (factures de 3 pages) | Opérations d’E/S disque/seconde (factures de 50 pages) |
| ----------------------- | ----------------------------------------------------- | ------------------------------------------------------ |
| 50,000                  | 100                                                   | 50                                                     |
| 100,000                 | 250                                                   | 100                                                    |
| 150,000                 | 400                                                   | 170                                                    |
| 200,000                 | 600                                                   | 230                                                    |

<div id="without-high-availability-configuration">
  #### Configuration sans haute disponibilité
</div>

| Charge (pages/8 heures) | Nœuds pour les services | Nœuds worker |
| ----------------------- | ----------------------- | ------------ |
| 10,000                  | 1                       | 1\*          |
| 30,000                  | 1                       | 3            |
| 50,000                  | 1                       | 3            |

\*La configuration avec un seul nœud worker est prévue uniquement à des fins de test et ne prend pas en charge l’entraînement de compétences, quelle que soit l’activité utilisée.

<Note>
  Lors de la mise à l’échelle d’ABBYY Vantage, aucune augmentation du temps de traitement des documents n’a été observée.
</Note>

<div id="managing-nodes">
  ## Gestion des nœuds
</div>

L’Administrateur système peut ajouter des nœuds de travail supplémentaires au cluster afin de prendre en charge la charge requise. Pour plus d’informations sur la préparation d’un nœud, consultez [Exigences système](/fr/vantage/self-hosted/v2.7/system-requirements).

<div id="adding-a-worker-node">
  ### Ajout d’un nœud worker
</div>

Pour ajouter un nœud worker, suivez les étapes ci-dessous :

1. Ouvrez un fichier d’inventaire dans le répertoire d’installation.
2. Dans la section `[abbyy_workers]`, ajoutez un nœud supplémentaire en indiquant son nom et son adresse IP.
3. Exécutez le programme d’installation :

```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. Exécutez le playbook suivant :

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