> 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/iad/release_notes/2.2.0_release_notes.md).

# 2.2.0

**Data de lançamento:** 12 de agosto de 2026

## Resumo geral

**Facephi IAD Service 2.2.0** é uma versão menor e retrocompatível com `2.1.0` com foco em ampliar a observabilidade operacional do serviço.

## Novidades

### Métricas operacionais públicas

* Novos endpoints `GET /api/v1/iad/metrics` e `GET /api/v1/iad/metrics/prometheus`.
* `GET /api/v1/iad/metrics` expõe um snapshot com tráfego, latência, saturação, uso, qualidade e alertas.
* `GET /api/v1/iad/metrics/prometheus` publica o mesmo estado operacional no formato Prometheus.
* `GET /api/v1/iad/health` mantém a verificação ativa do engine, enquanto que `/metrics` expõe snapshots em cache adequados para scraping frequente.

## Compatibilidade

* Retrocompatível com `2.1.0` para os fluxos existentes de `POST /api/v1/iad/liveness/evaluate` e `POST /api/v1/iad/extract`.
* Os novos endpoints de métricas são aditivos.
* As integrações de monitoramento que analisem o payload de `GET /api/v1/iad/health` devem validar o snapshot enriquecido documentado na referência da API.

## Guia de atualização

1. Atualize a tag da imagem Docker para `2.2.0`.
2. Se você precisar de scraping barato para observabilidade, migre os scrapers periódicos para `GET /api/v1/iad/metrics` ou `GET /api/v1/iad/metrics/prometheus` e reserve `/health` para verificações ativas.
3. Verifique a versão em execução por meio de `GET /api/v1/iad/version`.

## Implantação

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:2.2.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:2.2.0
```

## Requisitos

| Componente          | Requisito                                |
| ------------------- | ---------------------------------------- |
| Sistema operacional | Linux x86\_64 (recomendado Ubuntu 24.04) |
| Licença             | Arquivo de licença válido da Facephi     |
| Docker              | Para implantação em contêineres          |

## Problemas conhecidos

Nenhum problema público específico desta versão foi identificado.

## Suporte

Para suporte técnico, entre em contato com seu representante da Facephi.

## Documentação

* [Visão geral do serviço](/docs.facephi-pt-br/sdks/backend-sdk/iad.md)
* [Guia de instalação](/docs.facephi-pt-br/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [Referência da API](/docs.facephi-pt-br/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de alterações](/docs.facephi-pt-br/sdks/backend-sdk/iad/changelog.md)