Insights

JupiterOne's Insights dashboards enable you to visualize your data in a variety of meaningful ways. JupiterOne offers both a comprehensive set of managed dashboards that provide immediate value. With the ability to customize and curate your own dashboards and widgets, you are able to parse your data and visualize it as you see fit.

All dashboards are powered by JupiterOne's query language, J1QL. By leveraging queries, you can visualize the query results in a variety of ways–allowing you to make powerful representations of your data quickly.

Accessing Insights

By navigating to the Insights section of your JupiterOne workspace, you will find a list of JupiterOne's managed dashboards. These dashboards come pre-configured to provide a baseline of useful visualizations that can be built upon.

info

You can find a comprehensive list of all of JupiterOne's managed insights dashboards in this GitHub repo.

Creating dashboards

When creating Insights dashboards, there are two main options: Creating a Team dashboard or creating a Personal dashboard. Team dashboards are accessible to all members of your workspace, while a Personal dashboard is only visible to you.

The layout of each dashboard, however, is individually saved per user, including the layout for team boards. This means that you can configure layouts according to your own preference without impacting others' view of the same dashboard. Workspace Admin can save a team board layout as a default view for other users.

To create a new dashboard:

1. At the top of the left navigation pane, click Add (+) and choose whether you want to add a personal or team board.
2. In the New Dashboard window, choose one of the following as the basis for your new dashboard:
   • Start with custom charts
   • Select a J1 Managed Dashboard to customize
   • Upload a dashboard JSON schema
3. Select the type of visual chart (see widget options below) that you want to create.
4. Enter the chart query or queries and click Run.
5. Edit the chart colors and other formatting under Advanced settings as needed.
6. Add the chart title and optional description.
7. Click Save to publish your dashboard.

Widget options:

When creating a dashboard, there are several options for widgets to choose from. This allows you to utilize the most impactful visual representation for your data. Below are the following supported dashboard widgets:

• Number: A metric chart visualization that shows one large stat value. You are able to configure color coded thresholds that will help you tell a story of good vs bad results.
• Pie Chart: The pie chart displays values from one or more queries, as they relate to each other, in the form of slices of a pie. The arc length, area and central angle of a slice are all proportional to the slices value, as it relates to the sum of all values.
• Line Chart: The line chart is created by plotting a series of several points and connecting them with a straight line.
• Bar Chart: The bar chart visualization allows you to view categorical data to analyze your queries with a specified x and y axis. You are able to run multiple queries and visualize the bar chart in stacked format.
• Matrix Chart: The matrix chart is used for analyzing and displaying the relationship between data sets. The matrix diagram shows the relationship between two, three, or four groups of information.
• Table: The tables chart present data in as close to raw form as possible. Tables are meant to be read, so they are ideal when you have data that cannot easily be presented visually, or when the data requires more specific attention.
• Graph: The graph chart displays a tree graph of query results. This chart is best used to visualize specific relationships between entities.
• Status: The status chart displays a visual summary of correlating queries. This chart is best used to show positive or negative results based on if relationships are present in query results.
• Area Chart: The area chart is a graph that combines a line chart and a bar chart to show changes in quantities over time. This is currently best operated from a Question that is being evaluated daily.

Trend Widgets:

Insights, in addition to its point in time widget options, provides several options to visualize trends through widgeting. These widget types can be found in the widget selection process under Trend Widgets. The trend widgets collect the query result on a daily interval. As J1 collects the data for your query over time you are able to track and visualize the data trend between a (1W | 1M | 3M | 1Y) interval.

• Number: The metric chart visualization shows one large stat value. In the trend version of this chart you are able to track the value through a spark line to see if the result is getting larger or smaller over time.
• Pie Chart: The pie chart displays values from one or more queries, as they relate to each other, in the form of slices of a pie. The arc length, area and central angle of a slice are all proportional to the slices value, as it relates to the sum of all values. This type of chart is best used when you want a quick comparison of a small set of values in an aesthetically pleasing form. In the trend version of this chart you are able to track the value change of each slice value as well as the total value through a a spark line to see if the data set is getting larger or smaller over time.
• Line Chart: The line chart is created by plotting a series of several points and connecting them with a straight line.
• Bar Chart: The bar chart visualization allows you to view categorical data to analyze your queries with a specified x and y axis. You are able to run multiple queries and visualize the bar chart in stacked format. This chart is best suited for categorizing your results. In the trend version of the chart you are able to visualize the value change of each categorical result through a %Change indicator and a reference category bar of the result value from the previous time period selected.
• Area Chart is coming soon! Today the best way to bring an Area Chart Trend to Insights is through a Question.

Currently, widget previews are not enabled for Trend Widgets due to the need to collect data on the query.

Adding charts widgets to an existing dashboard

Aside from creating completely new dashboards within Insights, you are also able to add charts to an existing dashboard. To do so:

1. Navigate to Insights in JupiterOne.
2. Select the dashboard you'd like to add a chart to
3. Choose New Chart and proceed to add the chart widget. You will need to provide a J1QL query, the widget type, and any desired advanced setting configurations (optional).

note

Not all dashboards can have additional widgets added to them. Depending on your user permissions, you may or may not be able to add widgets to existing team dashboards. JupiterOne managed dashboards do not support additional widgets. You can duplicate or clone a managed dashboard to edit it.

Adding Markdown blocks

You can also add markdown-based widget blocks within a dashboard. This can be useful in bringing in external information, such as text, images, or links to additional resources. Anything supported by markdown can be embedded within this widget and added within a dashboard.

To add a markdown widget, select New Markdown (the box icon with a 'T' in it) from within the dashboard. It will open a markdown editor for you to input your content.