rapidloop/statsd-vis

Standalone StatsD server with built-in visualization

statsd-vis

statsd-vis is a standalone, zero-dependency single-binary StatsD server with built-in web UI with which you can visualize graphs.

It holds time series data for a configurable time in-memory, and does not persist or forward it.

build

statsd-vis is written entirely in Go. To build it, you can go get it:

go get github.com/rapidloop/statsd-vis

You should find the binary statsd-vis under $GOPATH/bin when the command completes. There are no runtime dependencies or configuration needed.

command-line

You can set parameters like the flush interval, percentiles etc. on the command-line:

statsd-vis 0.1 - (c) 2017 RapidLoop - MIT Licensed - https://statsd-vis.info/
statd-vis is a standalone statsd server with built-in visualization

  -flush interval
    	flush interval (default 10s)
  -percentiles string
    	percentiles for timer metrics (default "90,95,99")
  -retention duration
    	duration to retain the metrics for (default 30m0s)
  -statsdtcp address
    	statsd TCP listen address (default "127.0.0.1:8125")
  -statsdudp address
    	statsd UDP listen address (default "127.0.0.1:8125")
  -webui address
    	web UI listen address (default "0.0.0.0:8080")

releases

You can get pre-built binaries for releases from the releases page.

There is also a statsd-vis Docker image on Docker Hub, built from source on each commit. You can run the Docker image with:

docker run --rm -it -p 8080:8080 -p 8125:8125/udp -p 8125:8125/tcp rapidloop/statsd-vis -statsdudp 0.0.0.0:8125 -statsdtcp 0.0.0.0:8125

Notice that for Docker usage, you have to listen on 0.0.0.0, since the default 127.0.0.1 won't be reachable from outside the container, even from the Docker host.

changelog

• v0.1, 13-May-2017: first public release

statsd-vis's Issues

Saving stats to fs

Hello,

Great library, thanks for your hard work! This is exactly what I was looking for. Was wondering if you had any plans for saving metrics to someplace other than memory? Thanks!

go get instruction typo

should be go get github.com/rapidloop/statsd-vis (missing s in statsd

Create Automated Build on Docker Hub

Docker Hub allows you to create Automated Builds from source: https://docs.docker.com/docker-hub/builds/
It would add another packaging/distribution/installation method, whose buildings would be triggered automatically on each commit. It also allows to create different image tags automatically from git tags & branches.
Also, documentation could include an example docker run command which would become the canonical, no-install-needed way to run latest statsd-vis.

By making the image build via an AB, you give the resulting image verifiability and auditability. Also, the build is fully automatic. You can have the latest image tag build from HEAD and individual image tags from git's release tags. Some people avoid non-verifiable (manually uploaded) images due to security & traceability reasons.

After #4 is in, just a free Docker Hub account and a quick setup would do. Ping me if you need help.