# Rally 0.8.0 released

**URL:** <https://discuss.elastic.co/t/rally-0-8-0-released/108840>\
**Category:** Announcements\
**Created:** [November 23, 2017, 8:37am UTC](https://discuss.elastic.co/t/rally-0-8-0-released/108840 "2017-11-23T08:37:21Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![danielmitterdorfer](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/danielmitterdorfer/32/110510_2.png) [@danielmitterdorfer](https://discuss.elastic.co/u/danielmitterdorfer)\
**Post date:** [November 23, 2017, 8:37am UTC](https://discuss.elastic.co/t/rally-0-8-0-released/108840/1 "2017-11-23T08:37:21Z")

</div>

We have just released Rally 0.8.0. This is a fairly big release with several bug fixes and improvements.

### Highlights

#### Track parameters

You can now define parameters in your own tracks and use the new command line parameter `--track-params` to set them on the command line so you can vary certain parameters like bulk sizes, client counts, throughput rates or specific index settings without modifying the track file.

Rally's default tracks have been adapted to expose parameters such as the bulk size (see each track's README, e.g. [geonames README](https://github.com/elastic/rally-tracks/tree/master/geonames#parameters)) but you can use this feature in your own tracks too.

#### Simpler track syntax

We have also improved the track syntax so it is easier to define your own workloads:

- With [#326](https://github.com/elastic/rally/issues/326) you don't need a separate `operations` block anymore.
- We have made several properties in track files optional with [#353](https://github.com/elastic/rally/issues/353).
- In [#369](https://github.com/elastic/rally/issues/369) have renamed the bulk-indexing operation from "index" to "bulk" (backwards-compatible) because this has confused several users in the past.
- If you have only one challenge in your track file, you can now use the `challenge` element instead of a `challenges` array (see [#352](https://github.com/elastic/rally/issues/352)).
- We've introduced two new operations in Rally core: `cluster-health` (see [364](https://github.com/elastic/rally/issues/364)) and `put-pipeline` (see [#371](https://github.com/elastic/rally/issues/371)).

Here is the shortest possible track syntax as of Rally 0.8.0 for a benchmark that issues a match\_all query (assuming you have a pre-existing index with data):

```auto
{
  "challenge": {
    "name": "just-search",
    "schedule": [
      {
        "operation": {
          "operation-type": "search",
          "index": "_all",
          "body": {
            "query": {
              "match_all": {}
            }
          }
        },
        "warmup-iterations": 100,
        "iterations": 100,
        "target-throughput": 10
      }
    ]
  }
}

```

### Breaking changes

There are a few breaking changes but they mostly affect you if you have created your own tracks:

- Number of iterations are treated per client now: Rally will issue a warning on the command line if you are affected (see [#350](https://github.com/elastic/rally/issues/350) for details)
- Rally will check now whether your task names are unique: If not, then you just need to specify a name for the task now to make it unique (see [#351](https://github.com/elastic/rally/issues/351) for details)
- Rally's default socket timeout is now 60 seconds: If you need a longer timeout, e.g. 2 minutes, then you can specify this with. `--client-options="timeout:120"` (see [#356](https://github.com/elastic/rally/issues/356) for details).

See the [full list of changes on the 0.8.0 release page](https://github.com/elastic/rally/releases/tag/0.8.0).

## How to...?

- ... upgrade: `pip3 install --upgrade esrally`
- ... install: `pip3 install esrally`

Note: Depending on your system setup you probably need to prepend these commands with `sudo`.

Please follow the [quickstart](https://esrally.readthedocs.io/en/stable/quickstart.html) for a first time install.

## Questions and Feedback

If you have questions or feedback, please just post in the [Rally forum](https://discuss.elastic.co/c/elasticsearch/rally).

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [November 4, 2022, 5:04am UTC](https://discuss.elastic.co/t/rally-0-8-0-released/108840/2 "2022-11-04T05:04:49Z")

</div>