Skip to content

[Metrics] Expose per-rank FT health - #55915

Open
Etelis wants to merge 4 commits into
vllm-project:mainfrom
Etelis:feat/ft-rank-serving-metric
Open

Etelis wants to merge 4 commits into
vllm-project:mainfrom
Etelis:feat/ft-rank-serving-metric

Conversation

@Etelis

@Etelis Etelis commented Sep 8, 2026 •

Copy link
Copy Markdown
Member

Related to #54963.

Expose vllm:engine_healthy{engine="<rank>"} so routers can exclude unhealthy FT ranks while their API ports remain alive. Each scrape uses the existing cached get_status() result and reports zero if the client has failed.

The implementation stays in the metrics module. A separate registry keeps rank health out of shared Prometheus files. The remaining changes are documentation and tests.

Tests

Python source 0baf5b966d, 2× NVIDIA H200, DeepSeek-V2-Lite, DP/EP=2, TP=1, NIXL 1.3.2, PyTorch 2.13.0+cu130. Compiled/package assets came from the pinned 0.28.1rc1.dev472+gd9105ea80 image.

  • MODEL_NAME=deepseek-ai/DeepSeek-V2-Lite pytest tests/v1/fault_tolerance/test_fault_tolerance_e2e.py -v -s: 2 passed. Exception/retry produced 1 → 0 → 1 and serving resumed. Worker SIGKILL produced zero for the dead rank and its unhealthy peer.
  • pytest tests/entrypoints/serve/instrumentator/test_fault_tolerance_metrics.py -q: 6 passed, covering client failure, missing status, per-port isolation and metric filtering. Baseline metrics module: 4 failed, 2 passed in the same container.
  • Pre-commit hooks and mypy for Python 3.12 passed.

Signed-off-by: Itay Etelis <92247226+Etelis@users.noreply.github.com>
@mergify

mergify Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Documentation preview: https://vllm--55915.org.readthedocs.build/en/55915/

@mergify mergify Bot added documentation Improvements or additions to documentation frontend labels Sep 8, 2026
Signed-off-by: Itay Etelis <92247226+Etelis@users.noreply.github.com>

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This pull request is from a fork — automated review is disabled. A repository maintainer can comment @claude review to run a one-time review.

@almogtavor almogtavor left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

besides that one comment, lgtm

Comment thread vllm/entrypoints/serve/instrumentator/metrics.py Outdated
Co-authored-by: Almog Tavor <70065337+almogtavor@users.noreply.github.com>
Signed-off-by: Itay Etelis <92247226+Etelis@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation frontend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants