Dashboards are visual representations of data. Squirro supports extensive dashboarding functions, allowing you to have real-time visual representations of data as you search.
To create a dashboard,
Dashboard
in the top menu.To enter editing mode,
Edit Dashboard
.You are now in editing mode.
To change your dashboard's main query or title,
Enter the new title in the title field (1) and the new query in the search field (2).
Once done, press
to save your changes or to abandon them (3).
Widgets are the building blocks of a dashboard. Each widget represents data in a particular form. Currently, Squirro offers a number of built-in widgets, such as pie charts, time frequency graphs (line charts) and word clouds.
Widget | Example | Requires | Best for |
---|---|---|---|
Cloud | Facet | Displaying the relative salience of terms, such as stock indices, where an accurate proportion is less important and a more intuitive, visual representation is desired. | |
Frequency graph | Visualising frequency/volume of messages that meet the search criteria over time Facilitating time selection | ||
Keywords | Facet | Displaying the top keywords for any given facet. The Widget displays the name, count & percentage of the each values. The widgets reacts to the width of the widgets and well display the bar chart if not enough space is available. | |
Line chart | Facet | Displaying time series values (frequency or volume versus time) of particular values for a facet. | |
Pie chart |
| Facet | Visualising relative proportions of values among facets (the percentages relate to all documents that have a value for the particular facet, i.e. 100% might be smaller than the size of all documents, since some might be untagged for that facet). |
Result list | Displaying results for individual examination. | ||
Search Query | Adds a search form to the dashboard, allowing the user to refine the results using full text search and the full Squirro Query language capabilities. Note: The search can only refine the existing query of the dashboard. | ||
Significant Terms | Facet | Looks and behaves like the cloud widget, but applies the SignificantTerms analyser to display the uncommonly common values. Read more on Significant Terms Aggregation in this blog post by Elasticsearch. For this to work the data behind the dashboard must be segmented into a background and a foreground set. The widget will show significant values of the foreground set. The background set is defined by the Squirro query stored in the dashboard or via the &query url parameter. The foreground set is defined by another Squirro query using the &selection url parameter. |
To add a widget,
Add widget
from the dropdown.To move a widget,
To edit a widget,
Edit
from the dropdown menu.Save
to retain them or Cancel
to revert to the widget's original settings.To delete a widget,
Remove
from the dropdown menu.To share or embed the current dashboard,
This API allows for easy integration into any web enabled 3rd party application.
Once you've collected the URL for your dashboard, the following URL parameters can be used to change the behavior of the dashboard.
Parameter | Description | Example Value |
---|---|---|
query | Override the Dashboards search query | &query=(blue OR green OR red) |
selection | Set the Foreground query for all Significant Terms widgets | &selection=blue |
created_before | Only display results with a created_at value lower than this | &created_after=2012-12-31 |
created_after | Only display results wit ha created_at value higher than this | &created_before=2014-12-31 &created_before=2014-12-31T18:30:00 |
relative_start | Only display results with a created_at value higher than this, in relative terms to today | &relative_start=2y |
relative_end | Only display results with a created_at value lower than this, in relative terms to today | &relative_end=1y &relative_end=4w |