Integrating ASM Metrics into Grafana Using Apica Panels
The Panels menu can create customized display views to visualize metrics in real-time with a Grafana-powered solution.
Panel list:
Panel view:
The Panels give you the ability to analyze and share end-user experience data with all stakeholders for maximum visibility. This provides insights into all check results as they happen, and detailed information about all your KPI.
Data Source
Synthetic Monitoring is provided as a custom Data Source for use with Grafana.
View
Data Source
A Data Source is exactly that - a source of data. They provide the metrics you use to create your dashboards and panels.
Grafana Data Source
Apica provides data through the Synthetic Monitoring data source. It accesses the ASM API endpoint with the user Auth Ticket. The auth ticket can be obtained by logging into to your Apica Synthetic Monitoring portal account and selecting Tools > API from the top menu bar:
Â
 Note: The authorization is connected to a specific ASM user. Only checks accessible to that user will be accessible in Panels.
 Security Warning: Using a Synthetic Monitoring user with admin access is definitely not recommended, since the auth ticket is visible in Grafana.
Creation
When the Grafana integration is first set up for your account, an Synthetic Monitoring data source is created for you.
If you need additional data sources, please contact support@apica.io.
Overview
The Panels are a custom integration with Grafana, and by default work only with Synthetic Monitoring as a data source.
Installation
If you wish to use other data sources types together with Synthetic Monitoring, please contact support@apica.io.
Panel Widgets
The Panel Widgets allow you to populate your Grafana dashboards with data visualizations from your Synthetic Monitoring according to your needs.
Panel Widgets
A Grafana Panel is a widget used in dashboards to display metrics from a particular Data Source.
Creation
When the Grafana integration is first set up for your account, a default Grafana Dashboard is created for you, containing a default set of panel widgets:
The default dashboard contains these panel widgets:
Account level info:
Total number of checks running now in severity: I, E, F, W
The number of checks per check type
Group level info (if a monitor group was selected on dashboard creation):
Group summary (Avg values, avg values last 24 h, SLA % current mobnth)
Normal checks in group / total checks in group
Check level info (if a check was selected on dashboard creation):
Check summary (status, spark line)
A graph that shows response time as a line and standard deviation as a bar chart
Add Widget
Add Panel Widget
For newly created widgets, a searchable and scrollable list of widgets is shown at the top:
To show the list:
Click the row menu button
Choose Add Panel
The list is shown at the top:
You can now select a widget to add and configure:
Type (part of) the widget name in the search box
Click the widget
The widget is added to the row:
(For illustration, a random walk is added as data for graph widgets when a data source is not configured.)
Edit Widget
All settings for a panel widget are available from the panel widget settings dialog.
Edit Panel Widget
To edit a panel widget:
Click the widget name to open the menu
Click Share
The exact tabs available to edit for a panel widget varies with the panel widget type.
For details about each widget, see the Panels Types section.
Move Widget
Panel widgets can be moved between rows by dragging and dropping them.
Drag-and-drop
Click the panel widget and hold the mouse button
Drag the widget to the deisred location
Release the mouse button
If the target space is vacant, the widget is moved.
Dropping the widget on top of another widget will cause them to switch places.
Share Widget Links
With Panel links, you can share a panel through a direct link. The link will show the panel widget according to the settings you provide, so the view can be different from the current state.
Note: This requires access to Grafana for whomever is supposed to see the panel.
Create Panel widget link
To create a panel widget link:
Click the widget name to open the menu
Click Share
Select the Link tab
Select options as desired:
Item | Description | Comment |
---|---|---|
Current Time Range | Time Time Range. | Â |
Template Variables | Templating Templates. | Â |
Theme | Display UI Theme. | |
Direct Link Rendered Image | Creates a static image of the current status and provides a link and opens it in a separate window. | Â |
Note: Make sure that any changes you made to the panel widget has been saved before creating the link.
Click Copy
You can now paste the link wherever you need it.
Create Image
Using the share dialog, you can create a static image of the current panel widget status.
Create Panel Widget Image
To create a panel widget link:
Click the widget name to open the menu
Click Share
Select the Link tab
Select options as desired:
Time range
Variables
Theme
Click Direct Link Rendered Image
A separate browser window opens containing the the image.
You can now download the image or copy the URL for use elsewhere.
Time Override
If you want individual panel widgets to display metrics from different time periods in the same dashboard, you can override the relative time range for individual panel widgets
Item | Description |
---|---|
Override Relative Time | Start time period. |
Add Time Shift | End time period. |
Hide Time Override Info | Hides override info text shown in the upper right of a widget. |
Feature Notes
Note: Only relative time ranges can be used for panel widget time override.
Some considerations to keep in mind when using time overrides in panel widgets:
The panel relative time override is only active when the dashboard time is also relative.
The panel timeshift override is always active, even when the dashboard time is absolute.
If the dashboard time range is manually selected (zoomed), all panel widget overrides will be disabled.
Types of Widgets
Apica Specific Widgets
The Apica Panel Widgets provide specific visualizations related to Synthetic Monitoring data.
Worldmap
With the Apica Worldmap panel widget, you get a tile map of the world where information about results can be shown for each location.
Data can be shown on account or monitor group level. For each location details are available by hovering over the location point.
Status
The Apica Status panel widget allows you to display several status indicators values on the panel with status indication and spark line.
This plugin combines the ability of showing several values on the panel with status indication and spark line.
Limitations
Currently, only one metric in the 1 row table format can be used with this panel widget.
The Standard Grafana Panel Widgets can be used to cover a wide range of visualization needs.
Standard Widgets
The Standard Grafana Panel Widgets can be used to cover a wide range of visualization needs.
Dashboard List
The dashboard list panel allows you to display dynamic links to other dashboards. The list can be configured to use starred dashboards, recently viewed dashboards, a search query and/or dashboard tags.
On each dashboard load, the dashboard list panel will re-query the dashboard list, always providing the most up to date results.
Graph
The Graph panel widget provides a range of diagraming options.
Histogram
A histogram is a graphical representation of the distribution of numerical data.
You group values into buckets (some times also called bins) and then count how many values fall into each bucket. Instead of graphing the actual values you then graph the buckets. Each bar represents a bucket and the bar height represents the frequency (i.e. count) of values that fell into that bucket’s interval.
Heatmap
A Heatmap is like a histogram but over time where each time slice represents its own histogram.
View
Instead of using bar height as a representation of frequency you use cells and color the cell proportional to the number of values in the bucket.
Gauge
Gauges gives a clear picture of how high a value is in it’s context.
Gauges are a great way to see if a value is close to the thresholds. The gauge uses the colors set in the color options.
Sparklines
Sparklines are a great way of seeing the historical data related to the summary stat.
Sparklines provide valuable context at a glance. Sparklines act differently than traditional Graph - Standard Widgets panels and do not include x or y axis, coordinates, a legend, or ability to interact with the graph.
Widgets Table
The Table panel widget displays information as a table.
The table is very flexible, supporting both multiple modes for time series as well as for table, annotation and raw JSON data. It also provides date formatting and value formatting and coloring options.
Text
The text panel lets you make information and description panels etc. for your dashboards.
You can add text either in markdown or plain text.
Can't find what you're looking for? Send an E-mail to support@apica.io