@financial-times/grafana-tools

2.0.1 • Public • Published

Grafana Tools MIT licensed

Automate your project Grafana dashboards.

grafana pull <slug> <file>
grafana push <slug> <file>

Table Of Contents

Requirements

Running Grafana tools requires Node.js 10.x and npm.

Install

npm install -g @financial-times/grafana-tools

Usage

Pull a JSON representation of a dashboard and save it locally:

Usage: grafana pull <name> <file> [options]

Options:

  -h, --help             output usage information
  -V, --version          output the version number
  -a, --api-key <key>    the API key to use when accessing the Grafana API
  -H, --hostname <host>  the hostname Grafana runs on

Push a local JSON representation of a dashboard to the server:

Usage: grafana-push <name> <file> [options]

Options:

  -h, --help             output usage information
  -V, --version          output the version number
  -a, --api-key <key>    the API key to use when accessing the Grafana API
  -H, --hostname <host>  the hostname Grafana runs on
  -o, --overwrite        whether to overwrite any changes on the server

Note: the --api-key option can also be set with a GRAFANA_API_KEY environment variable.

Testing

To run tests on your machine you'll need to install Node.js and run make install. Then you can run the following commands:

make test              # run all the tests
make test-unit         # run the unit tests

You can run the unit tests with coverage reporting, which expects 90% coverage or more:

make test-unit-coverage verify-coverage

The code will also need to pass linting on CI, you can run the linter locally with:

make verify

We run the tests and linter on CI, you can view ci. make test and make lint must pass before we merge a pull request.

Deployment

New versions of the module are published automatically by CI when a new tag is created matching the pattern /v.*/.

Migration guide

State Major Version Last Minor Release Migration guide
active 2 N/A migrate to v2
maintained 1 1.0 N/A

License

The Financial Times has published this software under the MIT license.

Readme

Keywords

none

Package Sidebar

Install

npm i @financial-times/grafana-tools

Weekly Downloads

16

Version

2.0.1

License

MIT

Unpacked Size

33.1 kB

Total Files

27

Last publish

Collaborators

  • robertboulton
  • seraph2000
  • hamza.samih
  • notlee
  • emmalewis
  • aendra
  • the-ft
  • rowanmanning
  • chee
  • alexwilson