A java client to FastForward
A java client for the native protobuf protocol of ffwd.
Usage
<dependency>
<groupId>com.spotify.ffwd</groupId>
<artifactId>ffwd-client</artifactId>
<version>LATEST-VERSION</version>
</dependency>
public class Foo {
private static final FastForward ffwd = FastForward.setup();
private static final Metric metric = FastForward.metric("foo.metric").attribute("class", Foo.class.getCanonicalName());
public void run() throws IOException {
ffwd.send(metric.value(42));
}
}
OpenCensus Exporter
All registered OpenCensus Stats views will be exported to FFWD.
At this time histograms/distributions are not supported in Heroic until #476 is resolved.
<dependency>
<groupId>com.spotify.ffwd</groupId>
<artifactId>opencensus-exporter</artifactId>
<version>LATEST-VERSION</version>
</dependency>
com.spotify.ffwd.FfwdStatsExporter.createAndRegister(
com.spotify.ffwd.FfwdStatsConfiguration.builder().setExporterIntervalSeconds(30).build()
);
Contributing
- Fork ffwd-java-client from GitHub and clone your fork.
- Hack.
- Push the branch back to GitHub.
- Send a pull request to our upstream repo.
Releasing
Releasing is done via the maven-release-plugin
and nexus-staging-plugin
which are configured via the release
profile. Deploys are staged in oss.sonatype.org before being deployed to Maven Central. Check out the maven-release-plugin docs and the nexus-staging-plugin docs for more information.
To release, first run:
mvn -P release release:prepare
You will be prompted for the release version and the next development version. On success, follow with:
mvn -P release release:perform