spectator

Spectator

Simple library for instrumenting code to record dimensional time series.

Requirements

• Java 8 or higher at runtime, Java 17 or higher for building.
• Java 8 or higher for spectator 1.8.x or earlier.
• Java 7 or higher for spectator 0.27.x or earlier.

Documentation

• Wiki
• Javadoc

Dependencies

To instrument your code you need to depend on the api library. This provides the minimal interfaces for you to code against and build test cases. The only dependency is slf4j.

com.netflix.spectator:spectator-api:${version}

If running at Netflix with the standard platform, see the Netflix Integration page on the wiki.

Instrumenting Code

Suppose we have a server and we want to keep track of:

• Number of requests received with dimensions for breaking down by status code, country, and the exception type if the request fails in an unexpected way.
• Latency for handling requests.
• Summary of the response sizes.
• Current number of active connections on the server.

Here is some sample code that does that:

…