tsa-plugin-grafana

Grafana plugin for tsa.

Installation

npm i -g @tsa-tools/cli tsa-plugin-grafana

Obtain your authentication value.

Usage

With no configuration

tsa --plugin tsa-plugin-grafana --host my.grafana.host.com --auth abc123 --instance [east,west]-web-node[0{1-9},{10-20}] --domain .my.site.com --since 1d

Set some defaults to make repeat calls easier

tsa config --default plugin=tsa-plugin-grafana
tsa config --alias production=my.grafana.host.com
tsa config --default host=production
tsa config --default domain=.my.site.com
tsa config --default auth=abc123

Ah, that is easier

tsa --instance awesome-web-node --since 1d

Query multiple instances using template expansion

tsa --instance [east,west]-web-node[0{1-9},{10-20}]

Output looks like

web-node05: Min: 5 Max: 80 Mean: 36.60696517412935
web-node03: Min: 7 Max: 90 Mean: 39.6407960199005
web-node04: Min: 8 Max: 99 Mean: 40.99800995024876

Template Expansion

• [] indicates a group to expand.
• Within a group, separate expansions by ,
• Within an expansion, use {num-num} to expand an integer range.

Examples

Input

[one,two,three]-thing[0{1-2},-special]

Produces

one-thing01
one-thing02
one-thing-special
two-thing01
two-thing02
two-thing-special
three-thing01
three-thing02
three-thing-special

Auth

• Open Dev Tools in a browser and capture network traffic while expanding/changing metrics.
• Look at the Cookie header on a request to query_range. One of the entries should set grafana_session.
• Copy this value and pass it via --auth, or, run tsa config --default auth=value