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

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

• Installation Guide

• API reference

• Changelog