Applies to DC RUM 2017
To take a quick tour of the DMI report editor, start with an existing report.
The example here is specific to DC RUM 2017. For a similar walkthrough in NAM 2018, see DMI tour.
On the NAM Server, select Reports ► Applications ► Overview.
This displays the Applications dashboard report, which we will use in this example.
- In the upper right corner of the report, open the report menu and select Edit report.
This opens the Applications dashboard report for editing.
- The editor opens to the Sections and layout tab, which lists all report sections on the left.
To edit a section, you would select it in this list and select Edit section.
- On the right, the same sections are shown as they appear in the general report layout.
For this report, we have eight chart sections followed by two sections of dimension tiles.
- The icons along the top are for creating and deleting section placeholders...
- ...and for creating various types of sections to put in those placeholders.
- The Report tabs & links tab shows the six tabs on this report, where each tab is a link to another report that you want to display as a tab within this report.
Select an Edit link to see details for a tab.
- The Breadcrumbs tab
lets you edit the appearance and behavior of the breadcrumbs row at the top of the report.
- The Time tab
lets you control the appearance and behavior of the time control at the top of each report.
It also lets you specify report time ranges per report section (start and end times, rounding, etc.).
- The Annotation tab
lets you add free-form text that appears in a collapsible control at the top of your report.
- To see how a section is constructed in DMI, let's go back to the Sections and layout tab and select Edit section for the first section in the list, Health vs operation time.
Let's look at how DMI generates the Health vs operation time section of the Applications dashboard report.
On the NAM Server, select Reports ► Applications ► Overview to display the Applications dashboard report.
Open the Health vs operation time section in the DMI section editor.
There are two ways to get there.
Open the report for editing and then, on the Sections and layout tab, select that section and select Edit section to open the section for editing.
Display a report in NAM and then select Edit section for that section.
The section editor opens to the Data tab, where you specify the data DMI will use to generate this section of the report.
The breadcrumbs row at the top of the Data tab shows you where you are (report path, then Report editing, then section name):
Then Display name and Section type describe the section, and Show section offers a way to switch to another section as needed.
The table below describes the data on which this section is based.
In the Subject row, select in the Edit column to expand the row and display editing controls.
The Data views selection shows where you want to get data.
Select Dimensions to display Selected dimensions, a list of all dimensions selected for this report section ("Health vs operation time").
Select Metrics to display Selected metrics, a list of all metrics selected for this report section.
Switch to the Result display tab to see how the selected data will be displayed.
Remember, we are generating a chart that looks like this:
To see how we get from this list:
- Health index
- Fast operations/transactions
- Slow operations/transactions
- Failures (total)
- Operation/Transaction time
to those nice, short chart aliases, select in the Dimension/Metric name column header
and switch to the Chart Aliases tab.
To finish this brief tour of how this chart section was made, switch to the Chart settings tab, General view.
The Chart settings tab is displayed only when you set Section type to Chart.
The chart Type is set to Stacked columns.
Switch down to the Chart settings tab, X-axis view, to see that we specify the time range as the X-axis.
Switch down to the Chart settings tab, Series view, to see that we specify Series in : columns, and have four metrics selected for display as columns, with colors specified, etc.
Other tabs to explore in the section editor:
Drilldown links is where you specify links to other reports. There were no drilldowns in this example.
Applying filters is where you specify filters.
Section list and buttons is where you define tabs specific to this section. Your report can have tabs (as specified on Report tabs & links in the report editor), and each section within your report can have its own tabs (as specified on Section list and buttons).
Annotation is where you can define two types of text to display within your tab. You can define text that is displayed or hidden at the top of the section using a collapse/expand control (like a report-level annotation) and you can define section-specific text that is displayed only when a section is hidden.
For details on chart configuration, see Chart settings.