# elastic/rally

Macrobenchmarking framework for Elasticsearch

Repository: https://github.com/elastic/rally
Canonical: https://ross.abutalabs.com/products/rally
Language: Python
License: Apache-2.0
License Family: permissive
Topics: elasticsearch
Last push: 2026-08-21T03:46:07+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 55, longevity 100
- inputs: {"age_days": 3929, "days_push": 12, "days_rel": 91, "gap_med": 285.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2029, forks 346 (observed 2026-08-28T04:06:07.068179+00:00)

## What it is
Rally is a macrobenchmarking framework for Elasticsearch, developed in Python by Elastic. It automates cluster setup and teardown, benchmark data and track management, running benchmarks, recording and comparing results, and attaching telemetry devices to find performance problems.

## Use cases
- benchmark elasticsearch cluster performance
- measure indexing and query throughput across elasticsearch versions
- set up and tear down elasticsearch clusters for load tests
- compare performance results between elasticsearch releases
- find elasticsearch performance problems with telemetry devices
- run reproducible search benchmarks with standard tracks like geonames

## When to choose
- you need reproducible, standardized macrobenchmarks of Elasticsearch clusters
- you want to compare Elasticsearch performance across versions or configurations
- you need automated cluster provisioning and teardown for benchmark runs
- you want to profile Elasticsearch internals with telemetry devices

## When to avoid
- you benchmark something other than Elasticsearch
- your benchmarking host runs Windows (Rally itself requires Unix)
- you need microbenchmarks of individual functions rather than whole-cluster benchmarks

## Facets
- artifact type: cli-tool
- maturity: active
- function: benchmarking, testing, developer-tools, cli
- domain: databases, developer-tools, performance
- platform: cli, python
- tags: elasticsearch, macrobenchmark, load-testing, performance-analysis, search, linux, macos

## Member repositories
- elastic/rally (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:07.068179+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:37.674295+00:00, confidence not recorded.
  - readme: https://github.com/elastic/rally (fetched 2026-08-28T04:06:07.068179+00:00, sha c60864bdc359)
- Data as of 2026-08-30T08:39:29.467469+00:00.