horizon-cmp

command
v0.0.0-...-3a1fdf7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 7, 2022 License: Apache-2.0, Apache-2.0 Imports: 18 Imported by: 0

README

Horizon cmp

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

Install

Compile the horizon-cmp binary:

go install ./tools/horizon-cmp

Usage

horizon-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 Horizon and test is the version you want to test.

horizon-cmp -t https://new-horizon.host.org -b https://horizon.stellar.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.

horizon-cmp -t https://new-horizon.host.org -b https://horizon.stellar.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.

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

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

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

or

horizon-cmp history -t https://new-horizon.domain.org -b https://base-horizon.domain.org --from 10 --to 20
Request per second

By default horizon-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.

horizon-cmp -t https://new-horizon.host.org -b https://horizon.stellar.org --rps 10

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL