Anodot Grafana Integration

 

The Anodot Grafana integration enables you to view Anodot information in your Grafana dashboards. In order to use it, you first need to add the Anodot Grafana Plugins in your Grafana installation. Notice that there are two plugins:

  1. Anodot Grafana Data Source - Enables the secure connection between Grafana and your Anodot account.  
  2. Anodot Grafana Panel - Enables the visualisation of the the Anodot data in Grafana. 

You need both of these plugins in order to consume Anodot data in Grafana.

 

Installation and Configuration

  1. The fastest way is to get the plugins from the official Grafana plugin directory:
    1. Data Source - https://grafana.com/grafana/plugins/anodot-datasource/ 
    2. Panel - https://grafana.com/grafana/plugins/anodot-panel/ 
  2. Alternatively, You can build the plugins on your own from github:
    1. Data Source - https://github.com/anodot/grafana-datasource 
    2. Panel - https://github.com/anodot/grafana-panel 

Once the plugins are installed in your grafana setup you need to configure the data plugin to point to your Anodot account. From the "Data Sources" menu in Grafana, choose the Anodot data source and in the settings enter your Anodot URL and API Token. For more information on how to obtain these, see here

 

Screen_Shot_2021-04-18_at_15.04.35.png

After entering the API and the token, please make sure to click on "Save & Test" to verify that you've entered the correct token for your account. 

 

Using the Panel

Once you've configured the data source you can start creating Anodot based panels. Choosing the data source you've just defined in the query panel, you will that there are several scenarios supported:

Screen_Shot_2021-04-18_at_15.15.16.png

The scenarios which are supported by the plugins are:

  1. Alerts - Shows List of Alerts from Anodot 
  2. Metrics - Shows list of metrics from Anodot
  3. Anomalies - Shows list of Anomalies from Anodot
  4. Topology Map - Show a topological map of alerts for metrics which support this display 

After choosing a scenario the below panel will change to reflect the possible parameters for each scenario. Configuring the parameters for each panel will enable getting the relevant data (See detailed explanations in the next section). Notice that setting the time frame for the panel is done on top right corner of the panel like any Grafana panel. 

 

Screen_Shot_2021-04-18_at_17.03.47.png

Specific Scenarios Configuration

Alerts

The Alerts scenario enables you to build a panel based on alerts which Anodot has detected. You can filter these alerts based on the following parameters:

  1. Recipients / Channels
  2. Alert Type - Anomaly / Static / No Data 
  3. Severity - Critical / High / Medium / Low.

Once you've defined the panel the different columns are sortable (Started, Duration, Score, Name). Clicking on an entry in the alerts list will open the alert in Anodot.

 

Metrics

The metrics scenario enables you to the view metrics as they come from Anodot. After choosing this scenario, you must first choose a measure - which Anodot measure would you like to view in Grafana. Choosing the measure will populate the list fo possible dimensions this measure has so you can filter according to specific dimension value. 

Screen_Shot_2021-04-18_at_17.44.31.png

Two additional parameters which you can set:

  1. Include baseline - enables you to view the Anodot baseline as the background to the metric (Highly recommended!)
  2. Multiline Mode - Will combine all the metrics which meet the condition into one panel. 

Coming soon - we will enable choosing a function on top of the 'raw' metric. 

 

Anomalies

The anomalies scenario enables you to view anomalies detected by Anodot (similar to the "Anomalies" page in the app). Similar to the metrics scenario, you first need to choose a measure for which you would like to get anomalies. As there are many different types of anomalies you can filter according to the following parameters:

  1. Anomaly Duration
  2. Anomaly Score
  3. Delta Type 
  4. Delta Value
  5. Time Scale
  6. Sort order
  7. Direction
  8. Open Anomalies Only

Screen_Shot_2021-04-18_at_18.02.53.png

The resulting panel will show the list of filtered anomalies according to the Anodot color coding (Light blue for the baseline, dark blue for the actual data and orange for the anomaly)

Screen_Shot_2021-04-18_at_18.05.10.png

 

Topology Map

The topology map scenario enables showing anomalies which are part of a specific topology - e.g. network topology, kubernetes cluster, etc. The main requirement for measures to be displayed using this scenarios is that there is a dimension which can serve as the 'source' vertex and a dimension which can serve as the 'destination' vertex. Anodot will draw edges between these vertices. When Anodot identifies anomalies on these metrics - the relevant edges will be colored accordingly.