> 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.3.0_release_notes.md).

# 2.3.0

**Release date:** September 22, 2026

## Overview

**Facephi IAD Service 2.3.0** is a minor release and is backward compatible with `2.2.0`. It lets you adjust how `GET /api/v1/iad/metrics` classifies the service status, updates the internal analysis engine, and fixes container shutdown so it releases the license in use.

## What's New

### Configurable operational metric thresholds

* New parameters `metrics_saturation_queue_p95_ms`, `metrics_saturation_min_inflight_ratio`, `metrics_error_rate_warning`, `metrics_idle_rps_threshold` and `metrics_quality_alert_window_seconds`, which determine `state.classification` and the alerts from `GET /api/v1/iad/metrics`.
* They are configured in `config.json` or with the environment variables `FACEPHI_IAD_REST_METRICS_*`, and they are the only parameters that `POST /api/v1/iad/config` applies at runtime.
* They only change how the service status is summarized; they do not change how captures are evaluated.

### More precise alerts and classification

* The alert `LOW_QUALITY` is no longer permanent: it is deactivated when no low-quality samples are observed for `metrics_quality_alert_window_seconds` (900 seconds by default), and `quality.summary.lowQualitySince` indicates the start of the current episode.
* The `saturated` and `saturation.backlogSuspected` classifications require the number of in-flight requests to strictly exceed the configured threads, so the request reading `/metrics` no longer counts as pending work.

### Analysis engine

* Updated the internal analysis engine.

## Fixes

* When stopping the container (`docker stop`, `docker compose down`), the service receives the shutdown signal and exits gracefully, releasing the license it was using. Previously, Docker forcibly stopped it, and with [offline licensing with a local server](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/installation/offline_licensing.md), the floating license remained reserved until its lease expired.

## Compatibility

* Backward compatible with `2.2.0` for existing `POST /api/v1/iad/liveness/evaluate` and `POST /api/v1/iad/extract`.
* The new `metrics_*` parameters are optional: if they are not configured, the service classifies its status using the default values.

## Upgrade guide

1. Update the Docker image tag to `2.3.0`.
2. If your dashboards or alert rules relied on `LOW_QUALITY` remaining active indefinitely, adjust `metrics_quality_alert_window_seconds` to the window you need.
3. Check the running version using `GET /api/v1/iad/version`.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:2.3.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.3.0
```

## Requirements

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

## Known issues

* `POST /api/v1/iad/extract` does not normalize analysis engine errors; it returns them as `Engine communication error:` followed by the details. Version 3.0.0 fixes this: `/extract` normalizes engine errors just like `/evaluate` (see its [release notes](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/release_notes/3.0.0_release_notes.md)).

## Support

For Technical Support, contact your Facephi representative.

## Documentation

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