Skip to content

API server for github.com/dgryski/carbonzipper

License

Notifications You must be signed in to change notification settings

kerrick-lyft/carbonapi

 
 

Repository files navigation

carbonapi: replacement graphite API server

Build Status GoDoc

CarbonAPI supports a limited subset of graphite functions, but in our testing has shown to be 5x-10x faster than requesting data from graphite-web.

To use this, you must have a carbonzipper install, which in turn requires that your carbon stores are running carbonserver

The only required parameter is the address of the zipper to connect to.

$ ./carbonapi -z=http://zipper:8080

Request metrics will be dumped to graphite if the -graphite flag is provided, or if the GRAPHITEHOST/GRAPHITEPORT environment variables are found.

Request data will be stored in memory (default) or in memcache.

Known issues

  • aliasSub() implements different from original graphite's implementation regexp syntax. For example:

    original graphite syntax: aliasSub(ip.TCP,"^.*TCP(\d+)","\1")

    carbonapi syntax: aliasSub(ip.TCP,"^.*TCP(\d+)","$1")

for other details of regexp syntax reffer to the documentation of regexp package.

Acknowledgement

This program was originally developed for Booking.com. With approval from Booking.com, the code was generalised and published as Open Source on github, for which the author would like to express his gratitude.

License

This code is licensed under the MIT license.

About

API server for github.com/dgryski/carbonzipper

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 100.0%