command
module
Version:
v0.0.5
Opens a new window with list of versions in this module.
Published: Apr 1, 2018
License: MIT
Opens a new window with license information.
Imports: 14
Opens a new window with list of imports.
Imported by: 0
Opens a new window with list of known importers.
README
¶
Grafana RRD Server
A simple HTTP server that reads RRD files and responds to requests from Grafana with Grafana Simple JSON Datasource plugin.
![GitHub release](https://img.shields.io/github/release/doublemarket/grafana-rrd-server.svg)
This server supports all endpoints (urls) defined in the Grafana Simple JSON Datasource plugin documentation but:
- You can use
*
as a wildcard in the target
values (but not for ds
) for the /query
endpoint.
Requirement
- librrd-dev (rrdtool)
- Go
- Grafana 3.0 and newer + Simple JSON Datasource plugin 1.0.0 and newer
Usage
-
Install librrd-dev (rrdtool).
On Ubuntu/Debian:
sudo apt install librrd-dev
On CentOS:
sudo yum install rrdtool-devel
On openSUSE
sudo zypper in rrdtool-devel
On Mac:
brew install rrdtool
-
Get the package.
go get github.com/doublemarket/grafana-rrd-server
Otherwise, download the latest release, gunzip it, and put the file in a directory included in $PATH
:
gunzip grafana-rrd-server_linux_amd64.gz
-
Run the server.
grafana-rrd-server
You can use the following options:
-h
: Shows help messages.
-p
: Specifies server port. (default: 9000)
-i
: Specifies server listen address. (default: any)
-r
: Specifies a directory path keeping RRD files. (default: "./sample/")
- The server recursively searches RRD files under the directory and returns a list of them for the
/search
endpoint.
-a
: Specifies the annotations file. It should be a CSV file which has a title line at the top like the sample file.
-s
: Default graph step in second. (default: 10)
-
Setup Grafana and Simple JSON Datastore plugin.
See Grafana documentation
-
Create datasource.
Contributing
-
Install librrd-dev (rrdtool).
See the Usage section.
-
Clone the repository.
-
Commit your code on a separate branch.
-
Create a pull request.
License
MIT
Documentation
¶
There is no documentation for this package.
Source Files
¶
Click to show internal directories.
Click to hide internal directories.