# Dashboards

<mark style="color:blue;">Published: July 20, 2023</mark>

The Dashboard section of the Spyderbat UI is located at the top of the left hand navigation panel, as shown below. If there is at least one source configured in the Spyderbat UI for your organization, you will be directed to the Dashboard homepage upon successful login into the console. If you have not yet set up any Sources (data collection) within your monitoring scope, please refer to our Documentation portal to access one of our [How-To Guides for Spyderbat Nano Agent Installation](https://docs.spyderbat.com/installation/spyderbat-nano-agent).

Dashboard section provides a consolidated at-a-glance overview of a variety of operational and security data points captured as a result of asset monitoring with active Spyderbat Nano Agents.

### **Dashboard Card Overview**

The Dashboard section comprises several default groups of dashboard cards. Each individual dashboard card represents a structured output of a Athena search query crafted using a set of criteria set forth by Spyderbat security analysts.

![Click to enlarge](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-9bc6790f2004feecedfc8dd96737a3918199ce3b%2F0.png?alt=media)

As you can see, all dashboard cards are of the same default height, which means that there are only so many rows that can be displayed within the card even with the scroll bar. Spyderbat dashboard cards surface the top 100 rows, and indicate the total number of rows that meet the dashboard card criteria in the dashboard card header.

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-86f1e7b22bcc1607027f6105e3783ac6c277d7df%2F1.png?alt=media)

If you need to view or export all the data, you could do it through Search, by clicking “view all \[total number]” or “view first 10K”, if there are more than 10K of rows being returned. In the latter case, it is highly advisable to apply additional search or filtering criteria to reduce the volume of data, which we will cover here shortly.

### **Adjusting Card Display**

Within a session you can resize cards, reorder or hide columns, and filter or sort data. These changes reset on page refresh — they do not persist across sessions.

Each card also has a time range selector (default: 24 hours, options from 1 hour to 30 days).

For persistent customization, hover over a card and click **Run in Search** to open the underlying query in Search, where you can modify it and save it as a [custom dashboard card](https://docs.spyderbat.com/tutorials/how-to-create-custom-dashboards).

### **Data Grouping**

In addition to filtering and sorting the data within the card, some dashboard cards allow grouping the data into summary rows by column values. By default, several cards have been selected by Spyderbat analysts to have Grouping feature enabled and all data grouped based on the specific criteria called out in the first column:

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-1f894b9b75886657b1254c07281f40e7c8b922d6%2F11.png?alt=media)

You can expand a select grouping by clicking on the accordion symbol:

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2FCTfqtOAkEsU81J2WMXiD%2F12.png?alt=media)

If you turn off grouping by moving the slider on the right from “Grouping Enabled” to “Grouping Disabled”, all rows will be displayed in an unsorted order.

When “Grouping Enabled” is on, you can also apply nested grouping options based on the values within other columns, by clicking the ellipsis (three vertical dots), on the column which values you wish to use for the nested rows grouping, and select “Group by \[column name]”:

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-3905d4b7199c432a358291e18cb6ffdc19a498dd%2F13.png?alt=media)

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-adcd9904b5e383f1ea658d7f2ffebf28d7785e38%2F14.png?alt=media)

To remove nested grouping, you will have to follow the same steps and choose “Stop Grouping by \[column name]” from the drop down. To remove all grouping, just flip the “Grouping Enabled” slider to “Grouping Disabled”:

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-2e1a5540194e305b99ab07e4cc182938aac2b621%2F15.png?alt=media)

### **From Dashboards to Investigation**

Besides offering you extensive observability options and holistic view of your security posture, Dashboard cards allow you to easily segway into investigating any suspicious or simply interesting activity in your monitored environment. All you need to do to start an investigation is select one or more rows in one or multiple dashboard cards and click “Start Investigation”.

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-6fc83d1c265072908ca99981975dbb11231bd124%2F16.png?alt=media)

Clicking the X in the “Start Investigation” pop-up, will automatically deselect all rows.

{% hint style="info" %}
For an overview of the Investigation view, see [Investigations](https://docs.spyderbat.com/concepts/flashback/investigations). For a hands-on guide, see the [Investigations Tutorial](https://docs.spyderbat.com/tutorials/flashback/how-to-investigate-in-spyderbat).
{% endhint %}

At any time during your investigation you can go back to the dashboards section to add more items to your existing investigation or start a brand new investigation:

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2FAX4N6hvH5mYcnTtQNoLg%2F17.png?alt=media)

If you choose to start a new investigation, the existing open investigation will get overwritten, unless you save an Investigation Link.

If you are focusing your investigation on K8s assets and inventory, rather than processes, the system will prompt you to run a K8s investigation.

![](https://4237643999-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBmf9RZ2wNSc4znG5gBc1%2Fuploads%2Fgit-blob-918a8b4eb495cae8e2f0135b4023bd9dbf7b4966%2F18.png?alt=media)

{% hint style="info" %}
To learn more about Spyderbat Investigation section and how to navigate it, please refer to our [Investigations Tutorial](https://docs.spyderbat.com/tutorials/flashback/how-to-investigate-in-spyderbat).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spyderbat.com/concepts/dashboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
