librato-cli - Overview

librato-cli is a command-line tool for interacting with the Librato API (https://www.librato.com/docs/api).

Features

• Listing of sources, metrics, spaces and charts
• Changing attributes on individual metrics
• Import/export of individual charts
• Import/export of entire spaces

Getting Started

npm install github:plmwong/librato-cli -g
librato-cli help

Configuration

librato-cli requires a token and API key to access the API. You can generate these through your Librato account.

{
  "libratoToken" : "<your_token>",
  "libratoApiKey" : "<your_api_key>",
  "baseUrl" : "https://metrics-api.librato.com/"
}

Usage

#set the token / apikey for librato-cli
librato-cli config settoken foo_token
librato-cli config setapikey bar_api_key

#list all charts on the space with id 12345
librato-cli chart list 12345

#list all metric sources in librato
librato-cli source list

#list all spaces in librato
librato-cli space list

#get definition for space 65408
librato-cli space get 65408

#list all metrics
librato-cli metric list

#list metrics that match the 'foo.bar' filter pattern
librato-cli metric list foo.bar

#get measures from 4 hours ago for a metric
librato-cli metric get foo.bar 14400

#update metric named 'foo.bar', setting its summarize function to use summation
librato-cli attr foo.bar summarize_function=sum

#export the definition of an existing chart to a file
librato-cli chart export 65408 591000 > test.json

#import that chart definition to a different space
librato-cli chart import 65409 "$(cat test.json)"

#export the definition of an entire space (including all of its charts) to a file
librato-cli space export 65408 > test.json

#import that space definition as a brand new space
librato-cli space import "$(cat test.json)"
librato-cli space import --file test.json

#migrate a space definition from using legacy metrics to using tagged metrics
librato-cli space migrate --file legacy.json > tagged.json

Legal

librato-cli is made available as-is under The MIT License. See the LICENSE file for full license details.