Using the Apica Panels Dashboards
The Panel Widgets allow you to populate your Grafana dashboards with data visualizations from your Synthetic Monitoring according to your needs.
Add Dashboard
You can create new dashboards directly from the Dashboard Search menu.
To add a new dashboard:
Click the Dashboard Search
Click New Dashboard
A new empty dashboard called New Dashboard is added:
You can now go on to add Panel Widgets and/or Configure Dashboard the dashboard settings.
Configure Dashboards
All configurations for dashboards are available from the dashboard configuration menu.
Edit Panel Widget
To edit a panel widget:
Click configuration to open the menu
Select the configuration option you want to work with.
Annotations
With Annotations, you can add events to your graphs, either in Grafana itself, or through queries from supporting Data Source.
Add Annotation
Annotations can be added directly in the graph.
Display Annotation Events
Annotation events are displayed as icons and vertical lines and icons on graph panels.
Hovering over annotations will display details about the event. The dashboard configuration allows you to filter which annotations to display.
Item | Description |
|
|---|---|---|
Name | Display name for the filter. |
|
Data Source | Source for the annotations. |
|
Enabled | Show annotations. |
|
Hidden | Hide the filter from the dashboard. |
|
Color | Display color for the indicator lines. |
|
Query
Item | Description |
|
|---|---|---|
Filter By | Filter method. |
|
Max Limit | Maximum number of annotations to display. |
|
Filter Method
Filtering by Tags will display only the annotations that match any of the tags in the list.
With Dashboard filtering, all annotations are displayed on their originating panel widget.
Configure Dash History
In the Version History, you can see a list of all saved versions of the dashboard.
Compare Dashboards
With the Compare feature, you can see the differences between two versions of a dashboard.
The view shows all differences in the JSON between the selected versions.
Restore
You can Restore previous versions of the dashboard. This will replace the latest version with the selected version. The restore button is available from two places:
on the right-hand side in the History:
At the top of the Compare:
Dialog
View JSON
The View JSON menu option opens a panel displaying the JSON for the current dashboard.
Menu
Dialog
You can select and copy the JSON code from the panel, but not edit and save it in place.
Save As
The Save As menu option allows you to save a complete copy of the current dashboard under a different name.
Menu
Dialog
Configure Dash Settings
The Dashboard Settings allow you to configure options and parameters for the dashboard.
Edit Settings
Edit
All settings for a panel widget are available from the panel widget settings dialog.
Edit Settings
To edit Dashboard Settings:
Click configuration to open the menu
Click Settings
You can now select the appropriate settings tab to work with.
“General” Settings Tab
General
The General tab covers settings relating to the dashboard display.
View
Item | Description |
|
|---|---|---|
Name | Identifier/title for the dashboard. |
|
Description | Longer description of the dashboard. |
|
Tags | Dashboard tags for filering, search and organization. |
|
Timezone | Timezone to use for display. |
|
Toggles
In the Toggles section you can set parameters relating to
Item | Description |
|
|---|---|---|
Editable | Turn dashboard editing on or off. | Dahsboard must be saved to apply changes. |
Hide Controls | Show or hide the dashboard controls. |
|
Panel Options
The Panel Options governs the default Graph Tooltips behavior for the panel widgets in the dashboard.
Item | Description |
|
|---|---|---|
Graph Tooltip |
|
|
The default behavior is single mode.
You can also toogle between behaviors by pressing ctrl-o/command-o while working in the dashboard.
Hide Controls
The dashboard controls - the row menu and the add row button, can be hidden from the display.
Controls on:
Controls off:
Links Tab
In the Links tab you can create links to web pages or other dashboards.
View
Add Link
To add more than one link:
Click the Add Link button
Dashboard
In the Links tab you can create links to web pages or other dashboards. optionally based on a tag filter.
View
Item |
| Description | Comment |
|
|---|---|---|---|---|
Type |
| Type of link. |
|
|
Wit Tags |
| Filter for dashboard Settings General. |
|
|
As Dropdown |
| Show the filtered list as dropdown menu to select individual dashboards. |
|
|
Title |
| Title for the link. |
|
|
Include |
|
|
|
|
| Time Range | Apply the current Time Range to the linked dashboard view. |
|
|
| Variable Values | Apply any current Templates to the linked dashboard view. |
|
|
Open In New Tab |
| Link will open in separate browser tab. |
|
|
Dashboard Display
Creating Links to Web Pages
In the Links tab you can create links to web pages or other dashboards. optionally based on a tag filter.
View
Item |
| Description | Comment |
|
|---|---|---|---|---|
Type | Type of link. |
|
| |
Url | External link to access. |
|
| |
Title | Title for the link. |
|
| |
Tooltip | Tooltip to display when hovering over the link. |
|
| |
Icon | Icon to display before the link. | |
| |
Include |
|
|
| |
| Time Range | n/a |
| |
| Variable Values | n/a |
| |
Open In New Tab | Link will open in separate browser tab. |
| ||
Dashboard Display
Metadata
The *Metadata tab shows administrative information about the dashboard.
View
Item | Description | Commment |
|---|---|---|
Last Updated At | Timestamp for last change. |
|
Last Updated By | User that did the last change. |
|
Created At | Dashboard creation timestamp. |
|
Created By | User who created the dashboard. |
|
Current Version | Version of dashboard. | Corresponds to number of times saved. |
Rows
In the Rows tab, you can configure individual settings for the rows in the dashboard.
View
This feature is useful if you want provide the row with a title, when multiple panel widgets are related to the same theme.
The
Icon | Item | Description |
|
|---|---|---|---|
| Title | Title to display for the row. |
|
| Show Title | Turn title display on or off. |
|
| Move Up | Change display order in the dashboard. |
|
| Move Down | Changes display order in the dashboard. |
|
| Delete | Remove the row and all panel widgets it contains. |
|
Dashboard Display
Time Picker
With the Time Picker tab, you can configure how often the dashboard should be refreshed and define now for relative time calculations.
View
The Timepicker settings apply per Dashboard.
| Item | Description | Comment |
|---|---|---|---|
Auto-Refresh | Interval between automatic reloads and data refresh in the dashboard. |
|
|
Now Delay | Add delay to | Gives extra time for data aggregation. |
|
Can't find what you're looking for? Send an E-mail to support@apica.io