A Java implementation of the FastForward metrics agent
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.cache
.idea Project-specific settings Nov 27, 2017
agent Merge pull request #88 from spotify/local_pubsub_debug_fix Oct 4, 2018
api prepare for next development cycle Sep 20, 2018
core prepare for next development cycle Sep 20, 2018
debian
docker [all] introduce kubernetes shim Oct 26, 2017
docs Extend filtering functionality Nov 13, 2017
modules
protobuf250 prepare for next development cycle Sep 20, 2018
tools Fix run script so that it always gets the latest version Sep 20, 2018
.gitignore
.travis.yml [all] update Travis to run verify target Jun 29, 2016
DEPLOYING.md [all] add deploy steps Aug 15, 2018
LICENSE
README.md [ffwd-http-client] split out into its own repo Aug 9, 2018
checkstyle.xml
pom.xml Upgrade jackson-databind Nov 2, 2018
settings.xml initial commit Mar 18, 2015
suppressions.xml

README.md

ffwd-java »

Build Status License

This is a Java implementation of ffwd

This project is currently: experimental, use at your own risk.

Building

This project is built using Maven.

$> mvn package

You can run the client using tools/ffwd.

$> tools/ffwd agent/ffwd.yaml

Building a Debian Package

This project does not provide a single Debian package, this is primarily because the current nature of the service (alpha state) does not mesh well with stable releases.

Instead, you are encouraged to build your own using the provided scripts in this project.

First run the prepare-sources script:

$ debian/bin/prepare-sources myrel 1

myrel will be the name of your release, it will be part of your package name ffwd-myrel.

For the next step you'll need a Debian environment:

$ dpkg-buildpackage -uc -us

If you encounter problems, you can troubleshoot the build with DH_VERBOSE:

$ env DH_VERBOSE=1 dpkg-buildpackage -uc -us

Testing

We run unit tests with Maven:

$ mvn test

A more comprehensive test suite is enabled with the environment=test property.

$ mvn -D environment=test verify

This adds:

It is strongly recommended that you run the full test suite before setting up a pull request, otherwise it will be rejected by Travis.

Local Debugging

Assuming you have Maven installed, you can run the following to setup a local debug agent:

$> tools/ffwd agent/ffwd-local-debug.yaml

This will setup a ffwd with a lot of input plugins that are printed to stdout.

Clients

Libraries

Code of Conduct

This project adheres to the Open Code of Conduct. By participating, you are expected to honor this code.