> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/backend1n/technical_documentation/performance.md).

# Desempenho

## Introdução

Este documento reúne os resultados dos testes de desempenho do **Backend1N Service**. Os testes simulam usuários virtuais (VUs) simultâneos. A máquina de teste e a máquina onde o serviço é executado estão em locais geográficos diferentes (distantes), mas pertencem à mesma VPN, sem nenhum túnel ou proxy intermediário que possa distorcer as medições de latência.

Cada linha da tabela de desempenho corresponde a um **cenário independente**:

1. **Upload media**: faz upload do banco de imagens (`POST /assets/upload`), em uma mesma coleção (`collectionId`).
2. **Enroll**: registra um espécime (rosto) (`POST /faces`) para cada imagem enviada na etapa anterior, na mesma coleção (`collectionId`). Os identificadores gerados são reutilizados nos cenários seguintes.
3. **Search (image)**: busca por imagem (`POST /search/image/{collectionId}`) na coleção já preenchida. **Importante:** A busca por imagem inclui um processo de extração do padrão biométrico da própria imagem usada na busca.
4. **Search (template)**: busca por template biométrico (`POST /search/template/{collectionId}`), extraído previamente de cada imagem do banco (`POST /extract`). O tempo de extração não é incluído nas métricas do teste.
5. **Delete** (atualmente sem resultados — veja a observação abaixo da tabela): exclusão dos espécimes registrados (`DELETE /faces/{id}`).

Em cada cenário que trabalha com vários VUs, a carga é distribuída entre eles de forma **disjunta**: cada VU processa seu próprio subconjunto de espécimes/buscas, sem sobreposição entre eles.

## Máquina de referência

Os testes são executados em uma instância **AWS EC2 `c5a.8xlarge`**:

| Característica | Valor                                      |
| -------------- | ------------------------------------------ |
| Processador    | AMD EPYC (2ª geração, "Rome"), até 3,3 GHz |
| vCPUs          | 32                                         |
| Memória RAM    | 64 GiB                                     |

## Configuração dos testes

* **5000:** Número de espécimes no banco de dados.
* **20000:** Número de buscas no banco de dados.
* **PostgreSQL:** Banco de dados associado ao serviço. O serviço também oferece suporte a `MongoDB`, mas está fora do escopo deste teste.
* **FACEPHI\_SELPHID\_FACIALEXTRACTOR\_NUM\_THREADS:8** Número de threads atribuídas ao mecanismo de extração facial (variável de ambiente).
* **"number\_of\_threads": 4** Valor dentro de `config.json` que indica o número de solicitações simultâneas que o serviço pode atender. Se chegarem mais solicitações, elas serão colocadas em uma fila. **Importante:** é configurado como `4` porque a máquina tem `32 vCPUs`. No caso de instâncias com `16 vCPUs` este valor deverá ser `2`. No caso de instâncias com `8 vCPUs` este valor deverá ser `1`.

> Para obter o desempenho ideal, `FACEPHI_SELPHID_FACIALEXTRACTOR_NUM_THREADS * number_of_threads` deve ser igual ao número de `vCPUs` do nó.

## Desempenho

> **Importante:** O serviço não mantém estado próprio entre as solicitações (o estado fica no banco de dados PostgreSQL/MongoDB). Isso significa que cada operação de busca (imagem ou template) reconstrói uma galeria 1N na memória a partir do banco de dados. Esse processo sempre garante a integridade dos dados, mas afeta o desempenho.

> **Importante:** O acesso ao banco de dados é feito com exclusão mútua por todos os VUs dentro do mesmo nó. Por esse motivo, não observamos melhora nas buscas a partir de 2 VUs.

| Fase                                              | 1 VU                                                                                                     | 2 VUs                                                                                                     | 4 VUs                                                                                                    | 8 VUs                                                                                                     | 16 VUs                                                                                                     |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <p><strong>Upload de mídia</strong><br>(5000)</p> | <p>Total: 933.96 s<br>TPS: 5.35 req/s<br>mean: 0.19 s<br>max: 2.28 s<br>p50: 0.18 s<br>p95: 0.20 s</p>   | <p>Total: 452.96 s<br>TPS: 11.04 req/s<br>mean: 0.18 s<br>max: 1.15 s<br>p50: 0.17 s<br>p95: 0.19 s</p>   | <p>Total: 245.42 s<br>TPS: 20.37 req/s<br>mean: 0.19 s<br>max: 2.14 s<br>p50: 0.18 s<br>p95: 0.21 s</p>  | <p>Total: 121.66 s<br>TPS: 41.10 req/s<br>mean: 0.19 s<br>max: 1.86 s<br>p50: 0.18 s<br>p95: 0.22 s</p>   | <p>Total: 78.53 s<br>TPS: 63.67 req/s<br>mean: 0.23 s<br>max: 1.72 s<br>p50: 0.22 s<br>p95: 0.33 s</p>     |
| <p><strong>Cadastro</strong><br>(5000)</p>        | <p>Total: 1129.45 s<br>TPS: 4.43 req/s<br>mean: 0.23 s<br>max: 0.84 s<br>p50: 0.22 s<br>p95: 0.24 s</p>  | <p>Total: 601.71 s<br>TPS: 8.31 req/s<br>mean: 0.24 s<br>max: 0.66 s<br>p50: 0.23 s<br>p95: 0.28 s</p>    | <p>Total: 408.89 s<br>TPS: 12.23 req/s<br>mean: 0.33 s<br>max: 0.71 s<br>p50: 0.32 s<br>p95: 0.37 s</p>  | <p>Total: 454.16 s<br>TPS: 11.01 req/s<br>mean: 0.62 s<br>max: 1.66 s<br>p50: 0.59 s<br>p95: 1.24 s</p>   | <p>Total: 415.09 s<br>TPS: 12.05 req/s<br>mean: 1.04 s<br>max: 5.19 s<br>p50: 0.66 s<br>p95: 1.94 s</p>    |
| <p><strong>Busca (imagem)</strong><br>20000</p>   | <p>Total: 44366.13 s<br>TPS: 0.45 req/s<br>mean: 2.22 s<br>max: 2.93 s<br>p50: 2.20 s<br>p95: 2.51 s</p> | <p>Total: 22340.71 s<br>TPS: 0.90 req/s<br>mean: 2.23 s<br>max: 47.16 s<br>p50: 2.21 s<br>p95: 2.52 s</p> | <p>Total: 20072.42 s<br>TPS: 1.00 req/s<br>mean: 3.13 s<br>max: 6.17 s<br>p50: 2.74 s<br>p95: 4.29 s</p> | <p>Total: 19892.78 s<br>TPS: 1.01 req/s<br>mean: 6.41 s<br>max: 13.93 s<br>p50: 6.47 s<br>p95: 9.27 s</p> | <p>Total: 15662.86 s<br>TPS: 1.28 req/s<br>mean: 9.00 s<br>max: 22.94 s<br>p50: 8.43 s<br>p95: 15.40 s</p> |
| <p><strong>Busca (template)</strong><br>20000</p> | <p>Total: 41182.27 s<br>TPS: 0.49 req/s<br>mean: 2.06 s<br>max: 3.68 s<br>p50: 2.03 s<br>p95: 2.34 s</p> | <p>Total: 19870.45 s<br>TPS: 1.01 req/s<br>mean: 1.99 s<br>max: 4.19 s<br>p50: 1.96 s<br>p95: 2.25 s</p>  | <p>Total: 19220.16 s<br>TPS: 1.04 req/s<br>mean: 2.97 s<br>max: 4.59 s<br>p50: 2.77 s<br>p95: 4.10 s</p> | <p>Total: 19379.94 s<br>TPS: 1.03 req/s<br>mean: 5.35 s<br>max: 12.05 s<br>p50: 4.22 s<br>p95: 9.39 s</p> | <p>Total: 9553.79 s<br>TPS: 2.09 req/s<br>mean: 7.53 s<br>max: 12.17 s<br>p50: 7.56 s<br>p95: 9.76 s</p>   |
| <p><strong>Excluir</strong><br>5000</p>           | <p>Total: 635.79 s<br>TPS: 7.83 req/s<br>mean: 0.13 s<br>max: 0.38 s<br>p50: 0.13 s<br>p95: 0.14 s</p>   | <p>Total: 334.56 s<br>TPS: 14.89 req/s<br>mean: 0.13 s<br>max: 0.36 s<br>p50: 0.13 s<br>p95: 0.15 s</p>   | <p>Total: 163.46 s<br>TPS: 30.47 req/s<br>mean: 0.13 s<br>max: 0.36 s<br>p50: 0.13 s<br>p95: 0.14 s</p>  | <p>Total: 82.87 s<br>TPS: 60.09 req/s<br>mean: 0.13 s<br>max: 0.50 s<br>p50: 0.13 s<br>p95: 0.15 s</p>    | <p>Total: 42.74 s<br>TPS: 116.51 req/s<br>mean: 0.13 s<br>max: 1.14 s<br>p50: 0.13 s<br>p95: 0.15 s</p>    |

## Dimensionamento de bancos de dados

Após concluir o registro de imagens e espécimes (faces), o estado do banco de dados é o seguinte:

**PostgreSQL (db\_backend)**

| Tabela      | Elementos | Dados    | Índices  | Total    |
| ----------- | --------- | -------- | -------- | -------- |
| collections | 1         | 16.0 KB  | 16.0 KB  | 32.0 KB  |
| media       | 5000      | 683.6 MB | 336.0 KB | 683.9 MB |
| patterns    | 4980      | 94.0 MB  | 400.0 KB | 94.4 MB  |

## Escalabilidade

Os TPS registrados na tabela anterior são o limite de desempenho de **uma única instância** implantada na máquina de referência. Se for necessário um desempenho maior, a solução não é escalar verticalmente essa mesma máquina (adicionar mais vCPUs/memória a uma única instância), mas escalar horizontalmente: implantar um **cluster de várias instâncias** do serviço, gerenciado por uma tecnologia de orquestração em nuvem (Kubernetes ou outra equivalente), distribuindo a carga entre todas elas por meio de um balanceador.

O serviço não mantém estado próprio entre as requisições (o estado fica no banco de dados PostgreSQL/MongoDB), portanto, adicionar réplicas atrás de um balanceador é simples, desde que todas as réplicas apontem para o mesmo banco de dados compartilhado.
