Report Components: The Dashboard

Last updated: November 24, 2022

The Report Components dashboard is the key to building your own custom page within your reports. With it, you can add new components, and then drag and resize them to customize your layout. You can either build your own components, or import ones that someone else has built. You can even export or import the entire dashboard at once.

View Mode

The dashboard starts in view mode. In this mode, you cannot make any changes, but you can still interact with each component in the dashboard, such as hovering over data to view tooltips. The dashboard title is displayed in the header bar of the tile.

Filters

The dashboard responds to all the usual report page filtering. For example, you can select an actor to filter to events just involving that actor.

You can select a phase to filter to only events within that phase.

You can click and drag to select a range on the summary chart to filter to that range only.

You can enter a death cutoff to ignore events after a certain number of deaths.

You can choose to ignore events after a wipe was called (based on when the Call a Wipe hotkey was pressed if the log uploader was using the FF Logs Companion).

Actions

In the top-right of the tile's header bar are several actions.

Edit: Only visible when in view mode. Flips the dashboard into edit mode.
Cancel: Only visible when in edit mode. Flips the dashboard into view mode.
Import All: Starts the import process so you can replace your dashboard with another one. See Sharing Report Components for more information.
Export All: Copies the dashboard's import string to your clipboard, which can be used to import it later. See Sharing Report Components for more information.

Edit Mode

Once in edit mode, you can start to make changes to your dashboard.

Title

You can change the title of your dashboard to better describe what analysis it is trying to do. Note that the title has minimum and maximum lengths to adhere to.

Controls

Edit mode adds a row of controls to your dashboard.

New: Create a new component and add it to the dashboard. This component will have a very basic script that can be edited.
Import: Starts the import process so you can add a shared component to your dashboard. See Sharing Report Components for more information. Note that you can also paste component import strings directly onto the page!
Generate Example: Create a new example component and add it to the dashboard. Keep using it for more examples. These components aim to help you get off the ground quickly when learning some of the different techniques for building components.
Component Counter: There is a maximum number of components you can include on a dashboard, and this counter lets you know how close you are to the maximum.
Save Dashboard: If you haven't made any changes yet, this will be disabled. Once you have made changes, this will be enabled and will glow. Make sure to use this to save your changes! If you click Cancel instead, the dashboard will revert to the state it was in before you starting editing it.

Layout

When in edit mode, all components in your dashboard can be re-arranged using drag-and-drop and the resize handlers in the bottom-right of each component.

Components

In edit mode, hovering over each component displays the component controls in the top-right.

Export: Copies the component's import string to your clipboard, which can be used to import it later. See Sharing Report Components for more information.
Edit: Opens the component sandbox to allow you to start making changes to the component's script.
Remove: Removes the component from the dashboard. Note that you will have to use this button twice to remove the component. If you remove a component by accident, make sure not to hit Save Changes and to use Cancel instead to go back to view mode and revert the dashboard to its original state.

Execution Time

The bottom-left corner of the component shows the execution time in milliseconds for the last script execution. This is color-coded based on the amount of execution time your user is allowed per component. Learn more about improving the performance of your dashboard.