Installing the Grafana Data Source Plugin

Introduction

Important: As of 10/2022, please install the latest 3.x version of our Grafana Data Source plugin, as v2.x releases are no longer supported.

The Grafana Data Source Plugin can be found on the Grafana Marketplace or our GitHub repository (https://github.com/scalyr/scalyr-grafana-datasource-plugin).

Please review the README.md file on our GitHub repository for installation / configuration instructions.

Marketplace Install 

Install directly from Grafana Plugins page: https://grafana.com/grafana/plugins/sentinelone-dataset-datasource

CLI Install

1. To install the stable version of the plugin using grafana-cli, access our GitHub repository for the most current version, then run the following command (update the GitHub URL as needed):

   grafana-cli --pluginUrl \
   https://github.com/scalyr/scalyr-grafana-datasource-plugin/releases/download/<version>/sentinelone-dataset-datasource-<version>.zip \
   plugins install scalyr-datasource

2. Restart your Grafana server.

   • For init.d based services you can use the command:

     sudo service grafana-server restart

   • For systemd based services you can use the following:

     systemctl restart grafana-server

Docker Install

A Docker container can be used to quickly preview or test out the plugin.

1. From the console, run docker pull grafana/grafanato fetch the latest version of Grafana

2. I install the DataSet plugin with a Dockerfile

   from grafana/grafana
   RUN /bin/bash -c 'grafana-cli plugins install sentinelone-dataset-datasource'

3. Build the updated container from the directory where the Dockerfile is located: docker build -t grafana:latest .

4. Start the Grafana container with the following command. Note that we're using the grafana:latest image we built in step 3

   docker run -d -p 3000:3000 --name=grafana -e "GF_SERVER_ROOT_URL=http://grafana.server.name" -e "GF_SECURITY_ADMIN_PASSWORD=secret" grafana:latest

5. From your (host) system, access the following address:

   http://127.0.0.1:3000

   Username: admin Password: secret

6. Follow the steps outlined on the scalyr-grafana-datasource-plugin GitHub repository to set up DataSet as a Grafana data source.

Create a Test Dashboard

Once you have installed the scalyr-grafana-datasource-plugin, you can establish a test dashboard.

1. Click the "Dashboards" -> "New Dashboard" menu
   
2. Click "Add a new panel"
   
3. Be sure that:
   
   
   1. The "DataSet" data source is selected,
   2. Choose "Standard" Query Type and "Time series" graph type
   3. Enter a valid DataSet graph query as the Expression. For example: mean(value where tag='logVolume' metric='logBytes')
   4. Click "Apply." A graph of your present log volume will be displayed.