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

# 2.2.0

**Release date:** August 12, 2026

## Overview

**Facephi IAD Service 2.2.0** is a minor and backward-compatible version with `2.1.0` focused on expanding the service's operational observability.

## What's new

### Public operational metrics

* New endpoints `GET /api/v1/iad/metrics` and `GET /api/v1/iad/metrics/prometheus`.
* `GET /api/v1/iad/metrics` exposes a snapshot with traffic, latency, saturation, usage, quality, and alerts.
* `GET /api/v1/iad/metrics/prometheus` publishes the same operational state in Prometheus format.
* `GET /api/v1/iad/health` keeps the active engine check, while `/metrics` exposes cached snapshots suitable for frequent scraping.

## Compatibility

* Backward-compatible with `2.1.0` for existing workflows of `POST /api/v1/iad/liveness/evaluate` and `POST /api/v1/iad/extract`.
* The new metrics endpoints are additive.
* Monitoring integrations that parse the payload of `GET /api/v1/iad/health` should validate the enriched snapshot documented in the API reference.

## Upgrade guide

1. Update the Docker image tag to `2.2.0`.
2. If you need inexpensive scraping for observability, migrate periodic scrapers to `GET /api/v1/iad/metrics` or `GET /api/v1/iad/metrics/prometheus` and reserve `/health` for active checks.
3. Verify the running version via `GET /api/v1/iad/version`.

## Deployment

```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
```

## Requirements

| Component        | Requirement                                 |
| ---------------- | ------------------------------------------- |
| Operating system | Linux x86\_64 (Ubuntu 24.04 is recommended) |
| License          | Valid Facephi License file                  |
| Docker           | For container deployment                    |

## Known issues

No specific public issues have been identified for this version.

## Support

For Technical Support, contact your Facephi representative.

## Documentation

* [Service overview](/docs.facephi-en/sdks/backend-sdk/iad.md)
* [Installation Guide](/docs.facephi-en/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [API reference](/docs.facephi-en/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Changelog](/docs.facephi-en/sdks/backend-sdk/iad/changelog.md)