horizon-cmp

README

Aurora cmp

Tool that compares the responses of two Aurora servers and shows the diffs. Useful for checking for regressions.

Install

Compile the aurora-cmp binary:

go install ./tools/aurora-cmp

Usage

aurora-cmp can be run in two modes:

• Crawling: start with a set of paths (defined in init_paths.go) and then uses _links to find new paths.
• ELB access log: send requests found in a provided ELB access log.

Crawling mode

To run in crawling mode specify a base and test URL, where base is the current version of Aurora and test is the version you want to test.

aurora-cmp -t https://new-aurora.host.org -b https://aurora.hcnet.org

The paths to be tested can be found in init_paths.go.

ELB access log

To run using an ELB access log, use the flag -a.

aurora-cmp -t https://new-aurora.host.org -b https://aurora.hcnet.org -a ./elb_access.log

Additionally you can specify which line to start in by using the flag -s.

History

You can use the history command to compare the history endpoints for a given range of ledgers.

aurora-cmp history -t https://new-aurora.domain.org -b https://base-aurora.domain.org

By default this command will check the last 120 ledgers (~10 minutes), but you can specify --from and --to.

aurora-cmp history -t https://new-aurora.domain.org -b https://base-aurora.domain.org --count 20

or

aurora-cmp history -t https://new-aurora.domain.org -b https://base-aurora.domain.org --from 10 --to 20

Request per second

By default aurora-cmp will send 1 request per second, however, you can change this value using the --rps flag. The following will run 10 request per second. Please note that sending too many requests to a production server can result in rate limiting of requests.

aurora-cmp -t https://new-aurora.host.org -b https://aurora.hcnet.org --rps 10