Documenting custom dashboards

Write relevant information for users of your dashboards within the dashboards themselves. For instance, write dashboard descriptions to explain how to:

• Interpret the dashboard content.

• Incorporate the dashboard into a business process.

• Configure Nexthink to get proper results in the dashboard.

Only dashboards of basic modules, that is, those which are built with widgets based on metrics, may have accompanying descriptions.

Reading descriptions

The description of a dashboard is found on the right-hand side of the dashboard itself as a retractable panel. When retracted, the panel is reduced to a small square, similar to a page marker, with the typical letter i (for info) inside.

Click the letter i to expand the panel and read the description of the dashboard. Once you are done reading, you can retract the panel back by clicking either the i letter again, or the cross sign in the top right of the description panel.

If the dashboard has no description yet, neither a panel nor the i letter are visible in the dashboard. Below is an explanation of how to edit dashboards to add descriptions.

Writing a description

To write a description of a dashboard:

1. Log in to the Nexthink web interface as a user with the right to create dashboards.

2. Open or create a dashboard based on metrics.

3. Click the menu icon on the right-hand side of the dark blue ribbon.

4. Under the DASHBOARD section, select Edit content.

5. Click the letter i on the top right-hand side of the dashboard to expand the dashboard description panel. Even if the i was not visible during reading mode (because of the absence of a description), it becomes visible when editing the dashboard.

6. Write a description of the dashboard inside the description panel. To format the output, see the section below.

7. Click the check mark that appears on the right-hand side of the blue ribbon (in place of the menu icon) to finish editing the dashboard.

A description can contain up to 10 000 characters.

Formatting your description

To make your dashboard descriptions more visually appealing, format them according to the following markup rules:

Text before
---
Text after

Blocks

To emphasize specific parts of your description, four types of predefined blocks are at your disposal: configuration, process, tip, and warning.

To define a block, enclose your text between two lines of a three-colon sequence (:::). The first sequence is followed by the name of the block which must be one of the four predefined block types. Below is an example of a block, where you have to substitute [block_name] for one name of the predefined block types:

::: [block_name]
Text within the block.
:::

The content of a block is highlighted from normal text, being displayed in the dashboard description panel inside a box with lighter background. The name of the block, preceded by an associated icon, appears as the title of the block:

Type in	Rendered
CODE ::: configuration :::
CODE ::: process :::
CODE ::: tip :::
CODE ::: warning :::