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:
- Anodot Grafana Data Source - Enables the secure connection between Grafana and your Anodot account.
- 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
- The fastest way is to get the plugins from the official Grafana plugin directory:
- Alternatively, You can build the plugins on your own from github:
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
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:
The scenarios which are supported by the plugins are:
- Alerts - Shows List of Alerts from Anodot
- Metrics - Shows list of metrics from Anodot
- Anomalies - Shows list of Anomalies from Anodot
- 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.
Specific Scenarios Configuration
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:
- Recipients / Channels
- Alert Type - Anomaly / Static / No Data
- 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.
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.
Two additional parameters which you can set:
- Include baseline - enables you to view the Anodot baseline as the background to the metric (Highly recommended!)
- 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.
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:
- Anomaly Duration
- Anomaly Score
- Delta Type
- Delta Value
- Time Scale
- Sort order
- Open Anomalies Only
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)
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.