Copy the dist directory into your grafana plugins directory. The default location is /var/lib/grafana/plugins/signalfx-datasource.

After installing the SignalFx plugin on the Grafana server, click the Grafana icon on the desktop. In the side menu, click Configuration > Data Sources > Add Data Source. From the Type selection dropdown, click SignalFx.

The Settings tab in the Data Sources dialog box is shown below. Enter the settings in the table below to setup the plugin.

Click Save and Test.

All requests will be made from the browser directly to the SignalFx API. The SignalFx Access Token will transmitted from the Grafana backend/server to the browser and then from the browser to the SignalFx API in an unencrypted form and can be easily extracted by users who can access Grafana.

All requests will be made from the browser to the Grafana backend/server which in turn will forward the requests to the SignalFx API. Once saved and encrypted by Grafana, the SignalFx Access Token will not be transmitted to the browser in any form. Because the requests are proxied through the Grafana backend/server, using Server Access Mode will incur additional centralized processing burden for every active chart.

apiVersion: 1
datasources:
- name: SignalFX
  type: signalfx-datasource
  access: direct
  jsonData:
     accessToken: XXX
  url: https://stream.signalfx.com

Configure the query editor by entering the variables described below.

• $label = The label used in the SignalFlow program.
• $metric = The metric name.
• $somename = The value of the somename property or dimension.
• You can also use [[somename]] pattern replacement syntax.

Example:

$label $application_name [[port]]

Use template variables rather than hard-coding server, application, and sensor names in your metric queries. Variables are shown as dropdown selection boxes at the top of the dashboard. These dropdowns makes it easy to change the data being displayed in your dashboard.

Check out the Templating documentation for an introduction to the templating feature and the different types of template variables.

Query variables let you query SignalFx for a list of metrics, tags, property keys, or property values. The SignalFx Datasource Plugin provides the following functions you can use in the Query input field of the Variable edit view.

A variable will be interpolated as a single value as long as neither the "Multi-value" nor the "Include All option" switch is turned on.

You can use single-value variables in queries as shown in the examples below.

A = data('[[var_consul_metric]]', filter=filter('[[var_consul_property]]', '[[var_consul_prop_value]]')).publish(label='A')

A = data('Latency', filter=filter('stat', 'mean'), rollup='latest').$aggregation().publish(label='A')

You can use multi-value variables in queries as shown in the examples below.

A = data('metric_name', filter=filter('property_name', [[var_consul_prop_multi_value]])).publish(label='A')

Values will be automatically formatted as 'host1', 'host2' i.e. each value will ba surrounded with apostrophes and separated with commas.

SignalFx sets the Max Delay parameter based on estimates of how ‘on time’ the time series are. By default, SignalFx detects and applies a reasonable value automatically, based on how your data is coming in.

If you know that some of your data is being delayed, and you don’t want to wait for that data to arrive before your charts are updated, then you can set max delay accordingly.

To specify your own values, enter the number in milliseconds; e.g. enter 2000 to specify a max delay of 2 seconds. The upper limit is 15 minutes (900000 ms) but values over 5 minutes are generally not recommended.

Specifies the minimum interval for which SignalFx should roll up values to display a datapoint on the chart.

To specify your own values, enter the number in milliseconds; e.g. enter 900000 to specify a min resolution of 15 minutes.

Run make clean dist to build the plugin from scratch.