rollercoaster

Roller Coaster

Roller Coaster is a standalone web application for visualization of performance trends.

It provides the following features:

• Built-in chart plotter (based on Google Chart)
• Embedded data storage (Bolt)
• Simple RESTful API for data manipulation
• No external dependencies

API

Currently, the application supports these endpoints:

The following status codes are used in API:

"benchmark" object can be described using this JSON schema:

{
  "type": "object",
  "properties": {
    "group": {
      "type": "string"
    },
    "id": {
      "type": "integer"
    },
    "metric": {
      "type": "string"
    },
    "timestamp": {
      "type": "integer"
    },
    "value": {
      "type": "number"
    }
  },
  "required": [
    "group",
    "metric",
    "value"
  ]
}

"id" object can be described using this schema:

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    }
  },
  "required": [
    "id""
  ]
}

Please notice that Unix timestamps and incremental IDs are automatically added to the documents upon successful POST request.

Examples:

> curl -XPOST -d '{"group":"ForestDB, Write-heavy workload","metric":"Read throughput, ops/sec","value":25000}' http://127.0.0.1:8080/api/v1/benchmarks
{
    "message": "ok"
}

> curl -XGET http://127.0.0.1:8080/api/v1/benchmarks
[
    {
        "group": "ForestDB, Write-heavy workload",
        "id": 1,
        "metric": "Read throughput, ops/sec",
        "timestamp": 1470851518959247351,
        "value": 25000
    }
]

> curl -XDELETE -d '{"id":1}' http://127.0.0.1:8080/api/v1/benchmarks
{
    "message": "ok"
}

Docker image

A small Docker image is available for this project:

> docker pull perflab/rollercoaster

> docker run -t -d -p 8080:8080 perflab/rollercoaster

Building from the source

First, install Go vendor tool:

> go get -u github.com/kardianos/govendor

Pull third-party packages into vendor folder:

> govendor sync

Build the project:

> go build

Now you should be able to run it from the command line:

> ./rollercoaster 

	.:: Please navigate to http://127.0.0.1:8080/ ::.