servo v. : WATCH OVER, OBSERVE
Latin.
Servo provides a simple interface for exposing and publishing application metrics in Java. The primary goals are:
- Leverage JMX: JMX is the standard monitoring interface for Java and can be queried by many existing tools.
- Keep It Simple: It should be trivial to expose metrics and publish metrics without having to write lots of code such as MBean interfaces.
- Flexible Publishing: Once metrics are exposed, it should be easy to regularly poll the metrics and make them available for internal reporting systems, logs, and services like Amazon CloudWatch.
This has already been implemented inside of Netflix and most of our applications currently use it.
| Branch | Status |
|---|---|
| snapshot | |
| release | |
| pull-requests |
Servo is released with a 0.X.Y version because it has not yet reached full API stability.
Given a version number MAJOR.MINOR.PATCH, increment the:
- MINOR version when there are binary incompatible changes, and
- PATCH version when new functionality or bug fixes are backwards compatible.
- Google Group: Netflix Atlas
- For bugs, feedback, questions and discussion please use GitHub Issues.
- If you want to help contribute to the project, see CONTRIBUTING.md for details.
To build the Servo project:
$ git clone https://github.com/Netflix/servo.git
$ cd servo
$ ./gradlew build
More details can be found on the Getting Started page of the wiki.
Binaries and dependency information can be found at Maven Central.
Maven Example:
<dependency>
<groupId>com.netflix.servo</groupId>
<artifactId>servo-core</artifactId>
<version>0.8.0</version>
</dependency>
Ivy Example:
<dependency org="com.netflix.servo" name="servo-core" rev="0.8.0" />
Copyright 2014 Netflix, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.