inference/research
verifiedhigh · 0.90updated 2026-10-05

Xinference worker GPU memory used

xinference · gauge

Fields

id
metric-exposures/w5e-xinference-xinference-worker-gpu-memory-used-bytes
Metric name
xinference:worker_gpu_memory_used_bytes
Metric type
gauge
Unit
bytes
Exposure
prometheus
Endpoint
:9090/metrics (only when a metrics exporter host/port is set)
Enabled by default
no
notes
Host-level aggregate of GPU memory across the worker (NOT per device, NOT per model). There is also xinference:model_gpu_memory_used_bytes and xinference:model_gpu_binding for per-model attribution - the three are different levels and mixing them is the easy mistake. Xinference main (xorbitsai/inference), read 2026-10-05. NOT ON BY DEFAULT on the worker: the /metrics endpoint is only mounted when XINFERENCE_DISABLE_METRICS is unset AND a metrics exporter host or port is supplied; otherwise launch_metrics_export_server() is never called and the endpoint does not exist. Supervisor-side metrics are deregistered from the worker's registry on purpose (launch_metrics_export_server removes _SUPERVISOR_ONLY_METRICS), so the worker endpoint carries only worker metrics and the supervisor endpoint only supervisor metrics. aioprometheus, not prometheus_client: counters do not auto-suffix _total the way prometheus_client does, so two of these names end in _counter and three do not - match on the literal name.

Notes

Host-level aggregate of GPU memory across the worker (NOT per device, NOT per model). There is also xinference:model_gpu_memory_used_bytes and xinference:model_gpu_binding for per-model attribution - the three are different levels and mixing them is the easy mistake. Xinference main (xorbitsai/inference), read 2026-10-05. NOT ON BY DEFAULT on the worker: the /metrics endpoint is only mounted when XINFERENCE_DISABLE_METRICS is unset AND a metrics exporter host or port is supplied; otherwise launch_metrics_export_server() is never called and the endpoint does not exist. Supervisor-side metrics are deregistered from the worker's registry on purpose (launch_metrics_export_server removes _SUPERVISOR_ONLY_METRICS), so the worker endpoint carries only worker metrics and the supervisor endpoint only supervisor metrics. aioprometheus, not prometheus_client: counters do not auto-suffix _total the way prometheus_client does, so two of these names end in _counter and three do not - match on the literal name.

Cross-references