Poplar is a set of tools for running and recording results for performance tests suites and benchmarks. It provides easy integration with a number of loosely related tools:
- ftdc is a compression format for structured and semi-structured timeseries data. Poplar provides service integration for generating these data payloads.
- cedar is a service for collecting and processing data from builds. Poplar provides a client for uploading test results to cedar from static YAML or JSON data. There are no compile-time dependencies on Cedar.
Additionally, poplar provides a complete benchmark test harness with integration for collecting ftdc data and sending that data to cedar, or reporting it externally.
Poplar is useful for building and capturing benchmarks independently of the inter-run analysis provided by cedar.
Some popular functionality is included as a CLI in the curator tool, as curator poplar.
See the godoc for complete documentation.
If you encounter a problem or have a feature that you'd like to see added to mrpc, please feel free to create an issue or file a pull request.
poplar is available for use under the terms of the Apache License (v2).
This version of popular (deciduosity) provides compatibility with more recent versions of Go and its module system.
All project automation is managed by a makefile, with all output captured in the build directory. Consider the following operations: :
make build # runs a test compile
make test # tests all packages
make lint # lints all packages
make test-<package> # runs the tests only for a specific packages
make lint-<package> # lints a specific package
make html-coverage-<package> # generates the coverage report for a specific package
make coverage-html # generates the coverage report for all packagesThe buildsystem also has a number of flags, which may be useful for more iterative development workflows: :
RUN_TEST=<TestName> # specify a test name or regex to run a subset of tests
RUN_COUNT=<num> # run a test more than once to isolate an intermittent failure
RACE_DETECTOR=true # run specified tests with the race detector enabled.