Skip to content

Instantly share code, notes, and snippets.

@bennythejudge

bennythejudge/readme.MD

Forked from davideschiera/readme.MD
Created March 7, 2018 20:56
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save bennythejudge/47cc57a864bbc0c61dc76caeee1e5434 to your computer and use it in GitHub Desktop.
Save bennythejudge/47cc57a864bbc0c61dc76caeee1e5434 to your computer and use it in GitHub Desktop.
Download ZIP
Grafana Sysdig datasource
Raw
readme.MD

Sysdig Datasource Plugin for Grafana

Plugin to connect Grafana with Sysdig.

grafana-create-sysdig-panel

Getting started!

1. Installation

At this time, the Sysdig datasource is not included in the Official & community built plugin page. You will need to install the plugin manually.

Open a shell on the host where Grafana is installed, then run the following commands:

curl https://download.sysdig.com/dev/grafana-sysdig-datasource/grafana-sysdig-datasource-v0.0.1.zip -o sysdig.zip
unzip sysdig.zip
sudo cp -R sysdig /var/lib/grafana/plugins
sudo service grafana-server restart

2. Add datasource

In Grafana, select Add Data Sources:

  1. Name: Any name of your choice
  2. Type: Choose Sysdig
  3. Plan: Pick Basic/Pro Cloud if you use Sysdig SaaS or Pro Software if you use on premises
  4. API Token: In your Sysdig UI go to Settings -> User Profile -> Sysdig Monitor API token. Copy the token and paste it.

datasource-settings grafana-create-sysdig-ds

3. Import Sysdig dashboards

After creating the datasource you will have the ability to import your Sysdig Monitor dashboards into Grafana. Click Import to get all your dashboards from Sysdig. Go to Dashboards Home page and pull down your dashboard selection to see all your dashboards here.

grafana-import-sysdig-dashboards

Current limitations

The Sysdig datasource is in beta version. We'll iterate quickly to make it more complete and robust, in the meanwhile you might encounter some issues. Here is a list of known limitations:

  1. First off, we'll try to support a wider range of Grafana versions, for now we tested the datasource with Grafana 4.6 and 5.0. If you're using other versions of Grafana, we'll be happy to make it working for you!
  2. Templating is not supported yet, but will come soon
  3. We'll leverage annotations to show Sysdig events, but we don't support it just yet
  4. With Grafana you can enter any arbitrary time range, but data will be fetched according to retention and granularity restrictions as explained in this Sysdig Support page
  5. Singlestat is available, but Grafana will apply an additional aggregation on top of the time and group aggregation Sysdig applies. For this reason, numbers might not match what you see in Sysdig
  6. Grafana supports tables, but they are very different from Sysdig tables. For this reason, importing Sysdig dashboards will not create table panels
  7. Topology panels are not supported in Grafana, so importing Sysdig dashboards will ignore these panels
  8. Sysdig doesn't support exponential y-axis scale

Changelog

v0.0.1

  • The beginning...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment