This repo is no longer actively maintained. While it should continue to work and there are no major known bugs, we will not be improving ffwd or releasing new versions.
ffwd is a flexible metric forwarding agent. It is intended to run locally on the system and receive metrics through a wide set of protocols and then forward them to your TSDB.
By running locally, it is easily available to receive pushed data from any application or service that is running on the same system.
ffwd decorates the received metrics with system-wide tags or attributes. By doing this, the application generating the data becomes simpler to build, maintain, and configure since it doesn't have to know where it is running. Only that ffwd is available on the loopback interface.
Head over to https://spotify.github.io/ffwd/ for documentation.
ffwd can be started quickly with docker. This can be useful to run locally when troubleshooting metrics with your service.
docker run -it -p 19091:19091/udp -p 19000:19000 -p 8080:8080 spotify/ffwd:latest
If the debug port is enabled, metrics can be emited to a shell with netcat:
nc localhost 19001
This project is built using Maven. The package phase will also build a debian package.
mvn package
You can run the client using tools/ffwd
.
$> tools/ffwd agent/ffwd.yaml
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 the CI system.
This project adheres to the Open Code of Conduct. By participating, you are expected to honor this code.
Releasing is done via the maven-release-plugin
.
To release, run:
mvn release:clean release:prepare -D autoVersionSubmodules=true
You will be prompted for the release version and the next development version.
Add a Github release based on the tag that was created from the above command with notes on what changed.