# Ray 2.31.0 — Ray-2.31.0

- Product: Ray (https://whatsnew.fyi/product/ray)
- Vendor: Anyscale
- Date: 2024-06-26
- Version: 2.31.0
- Original notes: https://github.com/ray-project/ray/releases/tag/ray-2.31.0
- Permalink: https://whatsnew.fyi/product/ray/releases/2.31.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **fixed** — Fixed bug where preserve_order doesn't work with file reads
- **added** — Added documentation for dataset.Schema
- **added** — Add API for Ray Train run stats
- **changed** — Missing stopping criterion should not error, just warn
- **changed** — Optimize DeploymentStateManager.get_deployment_statuses
- **fixed** — Fix logging error on passing traceback object into exc_info
- **fixed** — Run __del__ even if constructor is still in-progress
- **added** — IMPALA runs on the new API stack with EnvRunners and ConnectorV2s
- **added** — SAC/DQN: Prioritized multi-agent episode replay buffer
- **changed** — Automatically infer worker path when starting worker in container
- **fixed** — On GCS restart, destroy not forget the unused workers, fixing PG leaks
- **fixed** — Cancel lease requests before returning a PG bundle
- **fixed** — Fix boost fiber stack overflow

#### Ray Libraries<a id="ray-libraries"></a>

##### Ray Data<a id="ray-data"></a>

🔨 Fixes:
- Fixed bug where `preserve_order` doesn’t work with file reads ([#46135](https://github.com/ray-project/ray/pull/46135))

📖 Documentation:
- Added documentation for `dataset.Schema` ([#46170](https://github.com/ray-project/ray/pull/46170))

##### Ray Train<a id="ray-train"></a>

💫 Enhancements:
- Add API for Ray Train run stats (#45711)

##### Ray Tune<a id="ray-tune"></a>

💫 Enhancements:
- Missing stopping criterion should not error (just warn). (#45613)

📖 Documentation:
- Fix broken references in Ray Tune documentation (#45233)

##### Ray Serve<a id="ray-serve"></a>

**WARNING**: the following default values will change in Ray 2.32:
  - Default for `max_ongoing_requests` will change from 100 to 5.
  - Default for `target_ongoing_requests` will change from 1 to 2.

💫 Enhancements:
- Optimize DeploymentStateManager.get_deployment_statuses ([#45872](https://github.com/ray-project/ray/pull/45872))

🔨 Fixes:
- Fix logging error on passing traceback object into exc_info ([#46105](https://github.com/ray-project/ray/pull/46105))
- Run __del__ even if constructor is still in-progress ([#45882](https://github.com/ray-project/ray/pull/45882))
- Spread replicas with custom resources in torch tune serve release test ([#46093](https://github.com/ray-project/ray/pull/46093))
- [1k release test] don't run replicas on head node ([#46130](https://github.com/ray-project/ray/pull/46130))

📖 Documentation:
- Remove todo since issue is fixed ([#45941](https://github.com/ray-project/ray/pull/45941))

##### RLlib<a id="rllib"></a>

🎉 New Features:
- IMPALA runs on the new API stack (with EnvRunners and ConnectorV2s). ([#42085](https://github.com/ray-project/ray/pull/42085))
- SAC/DQN: Prioritized multi-agent episode replay buffer. ([#45576](https://github.com/ray-project/ray/pull/45576)[)](https://github.com/ray-project/ray/commit/a7aa5e4c7bc4654b5ce710bf3551e3775470b57b)

💫 Enhancements:
- New API stack stability: Add systematic CI learning tests for all possible combinations of: [PPO|IMPALA] + [1CPU|2CPU|1GPU|2GPU] + [single-agent|multi-agent]. ([#46162](https://github.com/ray-project/ray/pull/46162), [#46161](https://github.com/ray-project/ray/pull/46161))

📖 Documentation:
- New API stack: Example script for action masking [(](https://github.com/ray-project/ray/commit/9d661677f942ccd7dfbbf2c2838e5dad9f50d12e)[#46146](https://github.com/ray-project/ray/pull/46146))
- New API stack: PyFlight example script cleanup ([#45956](https://github.com/ray-project/ray/pull/45956)[)](https://github.com/ray-project/ray/commit/af45a8999b5d9ca09054de29c2bdd0b5b02184b5)
- Old API stack: Enhanced ONNX example (+LSTM). ([#43592](https://github.com/ray-project/ray/pull/43592)[)](https://github.com/ray-project/ray/commit/d15204f5a0d5f2fa70935efa4935a7a61d8aafd1)

#### Ray Core and Ray Clusters<a id="ray-core-and-ray-clusters"></a>

##### Ray Core<a id="ray-core"></a>

💫 Enhancements:
- [runtime-env] automatically infer worker path when starting worker in container ([#42304](https://github.com/ray-project/ray/pull/42304))

🔨 Fixes:
- On GCS restart, destroy not forget the unused workers. Fixing PG leaks. (#45854)
- Cancel lease requests before returning a PG bundle ([#45919](https://github.com/ray-project/ray/pull/45919))
- Fix boost fiber stack overflow (#46133)


#### Thanks

Many thanks to all those who contributed to this release!

@jjyao, @kevin85421, @vincent-pli, @khluu, @simonsays1980, @sven1977, @rynewang, @can-anyscale, @richardsliu, @jackhumphries, @alexeykudinkin, @bveeramani, @ruisearch42, @shrekris-anyscale, @stephanie-wang, @matthewdeng, @zcin, @hongchaodeng, @ryanaoleary, @liuxsh9, @GeneDer, @aslonnie, @peytondmurray, @Bye-legumes, @woshiyyya, @scottjlee, @JoshKarpel