Chart settings tab

The Chart settings tab is displayed when you set Section type to Chart for the section you are editing.

Use the Chart settings tab to make chart-specific report section settings.

Accessing the Chart settings table

  1. Edit a report.
    Options:
    • Create a new report (NAM Server ► Tools ► DMI ► New report)
    • Open an existing report (NAM Server ► Reports ► ...) and select Edit report.

  2. Edit a report section.
    Options:
    • Create a new section. See Sections and layout tab.
      Set the section type to Chart.
    • Edit an existing chart section. Select the chart section and select Define Section.
  3. Select the Chart settings tab.

If you are editing an existing report that already has a chart:

  1. Display the report.

  2. In the report section that displays a chart, select the context menu

    chart context menu

    and select Chart settings. This opens the Chart settings tab as a standalone pop-up window, which is handy for iterative development of a chart section.

If you can't see the Chart settings tab:

  • You won't see a Chart settings tab in the DMI editor unless you set the Section type to Chart.

  • When you create a new report, the Chart settings tab will be displayed but empty until you select some data on the Data tab. Start your report definition with the Data tab.


General tab

Title

In the General view of the Chart settings tab, set Title to the string to display as the title of the selected chart.

Type

In the General view of the Chart settings tab, set Type to any of the offered chart types. For details, see Choosing a chart type.

Display mode

In the General view of the Chart settings tab, set Display mode to one of the following:

  • User default
  • Static
  • Dynamic

By default, dynamic charts are turned on for all NAM Server reports. To change this setting, use one of these options (depending on the scope of the change you want):

System settings

To choose static charts as a default chart type for all NAM Server reports:

  1. Open the Diagnostic Console.
    In your web browser address field, enter:
    http://[NAM Server_ADDRESS]/diagconsole
  2. Set the DMI_REPORT_CHARTS_MODE property value to Static.
    Default value: Dynamic

User settings

  1. On the NAM Server, select Settings ► Security ► User profile.
  2. In the Display section, set Charts display mode to Static.
    Default value: System Default.

Advantages of dynamic charts:

  • Zoom
    Select and drag a rectangle over the region of the chart you want to examine, then release the mouse button. You can do this repeatedly to zoom closer and closer on a specific area of you chart.
  • Shared tooltips
    To see the exact value of the series, position the cursor over the series. If there is more than one series, the tooltip shows values for all series in a specific point on the X-axis. The values are sorted in the descending order.
  • Hiding series
    If you want to show only certain series on a chart (for example, data for only two sites out of four), you can hide the unnecessary series.

Limitations of dynamic charts:

  • Dynamic charts do not support all chart types.
  • Dynamic charts may reveal system performance limitations, depending on client machine parameters, the client browser, and the number of elements to be displayed. If a performance problem occur, try using a static chart instead.

Legend position

In the General view of the Chart settings tab, set Legend position to one of the following:

  • Auto – this is a default setting, which, depending on the chart width, positions the legend to the right of the chart or below it.
  • Always to the right – choose this setting if you want the legend to always appear to the right of the chart.
  • Always below – choose this setting if you want the legend to always appear below the chart.
  • Always hide – choose this setting to hide the legend. By default, the chart legend on DMI reports is positioned to the right of the chart or below it if there is not enough space on the screen. If the default configuration does not suit your report layout, you can change the legend position using the Chart Settings panel.

Chart dimensions

In the General view of the Chart settings tab, set Width and Height to specify the size of the chart in pixels.

The minimum size of the chart is 300 pixels wide and 170 pixels high. If you enter lower values, they will be replaced with the minimums.

Grouping options

In the General view of the Chart settings tab, set Grouping options to specify whether you want to display:

  • one chart
    A single chart showing everything.
  • single chart per
    Multiple charts, with a separate chart per
    • Series
    • Metric
    • Metric unit
    • Metric group If the expected number of charts is high, there may be more than one chart per row.

X-axis tab

Title

The title for the X-axis series.

Values distribution

The X-axis values can be shown in a proportional or fixed distribution:

  • Proportional
    The values of the category series are distributed on the X-axis with the scale of the axis preserved. This can cause adjacent values in the category series to be separated by different physical distances along the axis: depending on to the numerical differences between the values.
  • Fixed
    Only the category series values are shown on the X-axis, without the scale of the axis being preserved. This will cause adjacent values in the category series to always be separated by the same physical distances along the axis.

Example:
If a category contains values 1, 2, 4, and 6, there may be 4 or 6 values on the chart:

  • With the Proportional setting, the category would be extended to 1, 2, 3, 4, 5, 6, and there would be no values for 3 and 5.
  • With the Fixed setting, the category would remain 1, 2, 4, and 6 with no gaps between 2 and 4 or between 4 and 6.

Note: Time on the X-axis would usually be depicted according to the proportional distribution. A list of discrete objects (for example, TCP protocols) always uses a fixed distribution.

Use time range from DMI

This setting enables you to force the time range on the X-axis as specified in the DMI query. If this box is not selected, the time range is determined on the basis of time stamps in report data. This is particularly useful when comparing data from a number of data views. However, in such cases, one and only one time-based dimension—such as Time or Hit begin time —must be assigned to the X-axis.

Limit axis labels to ... characters

If values on the X-axis have labels, you can define the maximum length of the labels by specifying it in this field. By default, labels are truncated to 20 characters.

Note: When you set the chart type to static and the number of labels is to large to fit within the defined width of the charts, the labels are not displayed.


Y-axis tab

If there are two Y-axes involved, settings are performed for each one separately.

Title

The title for the Y-axis series.

Scale

Determines the type of scale to be used:

  • Linear
    A linear Y-axis.
  • Logarithmic
    A logarithmic Y-axis.
    Note: The value of zero cannot be displayed on a logarithmic scale. Such points are eliminated from chart data for display when a logarithmic scale has been selected.
  • Percentage
    A scale where values are represented as a percentage of the graph's maximum value.
  • Percentage (100%)
    A scale for stacked graphs, where the contents of each stack is separately scaled as a percentage of the whole stack.

Range

Determines the maximum value for the axis:

  • auto
    Set maximum to the maximum value in the displayed data.
  • smart
    Set maximum to a value not greater than 3 times the average (this setting eliminates spikes, leaving meaningful values).
  • max at
    Set the maximum value manually. If same range for multiple charts below the Range settings is selected, all charts are given the same Y-axis range settings.

Series tab

Series in

This specifies whether rows or columns of the DMI report table should be taken as input for the chart.

Color settings

This specifies whether colors representing different metrics should be defined manually or automatically.

Automatic selection attempts to group similar metrics together based on their grouping as specified in the Grouping control.

A list of series names is provided, with the following controls for each series:

  • Display - controls the display of the series.
  • Color - sets the color of the series.
  • Pattern - sets the line/bar pattern: solid, dashed, dotted, transparent, semi-transparent or marks only (for lines).
  • Y-axis - sets the position of the Y-axis.
  • Trend line - shows a trend line on the chart for this metric. Note: Trends are available for the following chart types:
    • Areas
    • Stacked areas
    • Columns
    • Stacked columns
    • Lines
    • Stacked lines The only dimension assigned to the X-axis must be Time .

The list is reloaded when the series orientation changes.

Assigning metrics to Y-axes on DMI charts

A DMI chart can have two Y-axes, one on the left side of the chart and one on the right, with the possibility to assign a different metric to each of them.

On the Chart settings tab, Series view, set the Y-axis per metric.

Y-axis: one metric, one unit

If there is only one metric selected and displayed on the chart, its values and unit are assigned to the left Y-axis by default. You can change this assignment some chart types: Columns, Stacked columns, Lines, Stacked lines, Areas, Stacked areas.

Y-axis: two or more metrics, one unit

If a chart has more than one series to display and all series have the same unit, it is assumed that one common Y-axis is sufficient. This allows for stacking (plotting one series on top of another). A series represents metric values on a chart. One series corresponds to one metric.

You can change the default settings and assign your metrics to both left and right Y-axes. All combinations of assignments are allowed.

Y-axis: two metrics, two units

If there are two metrics with different units, the first metric is assigned to the left Y-axis and the second one to the right. You can swap the radio buttons (Left /Right) automatically between the series, which means that when Right is selected for the first metric, the second radio button will be automatically swapped to Left for the second metric.

Note that series are searched from left to right, in the order they appear in the data table below the chart.

Y-axis: three or more metrics, three or more units

Since there are only two Y-axes, DMI can render only two types of units. As a result, all metrics that introduce a third unit or more are not rendered and a warning message is displayed. The Show button will be inactive until you fix your selection.

Note:

  • If data is displayed on more than one chart, the choice between left and right Y-axis is possible only for the Metric unit grouping.
  • Chart type selection applies to the primary (left) Y-axis series. Secondary (right) Y-axis series always have line type.
  • If a stacked chart has been selected for the left Y-axis, the right Y-axis series would also be plotted as stacked.

Advanced tab

Use the Advanced tab to modify selected dynamic chart options.

This is a simple properties editor designed for advanced users. Be careful with these settings, especially if you are not an experienced NAM Server reports designer.


Summary tab

Select Display summary to show a data summary on your chart.

If you choose to display a summary, you also need to say what you want to display in the summary:

  • Display recent
  • Display min
  • Display max
  • Display average
  • Display 90 percentile
  • Treat no data as zero (0)
  • To the right
    Data is displayed above the chart unless you select To the right, in which case the data is displayed to the right of the chart (and the chart is rendered that much smaller). Compare these examples, where the same chart is shown (1) without a summary, (2) with a summary above the chart, and (3) with a summary to the right of the chart:
Sample summary settings
Sample summary settings

Note how the chart is pushed down to make room for a summary above the chart, and how the chart is reduced to make room for a summary to the right of the chart. Displaying additional labels and numeric values on your report requires additional display space that would otherwise have been available to your chart.

Try different combinations to see what works best for you.


Histograms

To create histograms (breakdowns by threshold values), use the following DMI settings:

  1. In DMI, in the section editor, open the Data tab.
  2. In the Subject row, select in the Edit column to display the editing controls.
  3. Select Histogram.
  4. Select the dimensions for which you want to generate histograms.
    Example:
    histogram dimension selection
  5. For each selected metric, specific the thresholds to use for the histogram.
    Example:
    histogram thresholds
    Where 0;80;90 (with a semicolon between each two values) specifies a histogram that looks like this:
    histogram example
    with a histogram bar for the following ranges:
    • 0 percent to 80 percent availability
    • 80 percent to 90 percent availability
    • > 90 percent availability

Limitations for histograms:

  • A maximum of 20 thresholds can be specified.
  • Histograms are available only for these data views:
    • Software service, operation, and site data
    • NAM Probe Statistics data views
    • Alert log

Rules for histograms:

  • Suffixes are permitted to express units of time (s, m, h, d), “%” for percentage metrics, and suffixes expressing quantities (k, M, G).
  • Additional characters are allowed at the start of the range specifiers:
    • + A plus indicates that the threshold is to be treated as an upper boundary.
    • * An asterisk indicates that the threshold is to be treated as a lower boundary.
  • If zero is specified as a threshold, the first range will contain only zero values. If a value greater than zero is specified as the first threshold, everything lower than or equal to the first threshold will be in the first range. The subsequent ranges contain values greater than the lower threshold and less or equal to the upper threshold (if any).
  • In DMI, a histogram applies to input data values, not to result values. A histogram is calculated before data aggregation is done. This is similar to setting a metric filter with the mode Data.
  • Since data is monitored at a defined monitoring interval, only average data is assigned to ranges in histograms. For example, a histogram will not display a single measured value of operation time, but an average operation time, so that all the data from one monitoring interval is assigned to the same range. If the average value does not exceed a particular threshold, it does not mean that no single value exceeded it. This may result in some ranges on the histogram being empty.
  • If you choose a “unique” type of metric such as Unique users, the histogram will show the number of elements whose value has ever been in a defined range. For example, if a histogram shows the operation time for unique users, with three defined thresholds, each of the four ranges will contain the number of users who have ever had an operation time in each of these ranges. This means that a particular user can be assigned to more than one range.

Drilldown charts

A drilldown report of a particular event within a chart can be viewed by selecting that element. This feature applies to all chart types, except Ribbons.

The drilldown reports obtained from charts contain the same definition logic as in table drilldown reports. This means that they can be filtered, linked, and viewed in the same manner as drilldown reports derived from a table.

Similarly to the table drilldown reports, under the Drilldown Links tab in a report definition screen, a [+] button opens a filter selection panel where a metric linking the chart data to the drilldown report can be selected. Note that drilldown links originated from charts apply only to metrics.

While viewing a pie chart, the pie labeled as “Other” acts as a filter for a single dimension for generating a drilldown report. When more than one dimension is used in a pie chart, the link to the drilldown reports on the pie titled “Other” is unavailable.

Similarly, if a chart contains a series with breakdown dimensions, and if a breakdown contains one dimension, the drilldown report is available.


Corridors on DMI charts

This option is set through the Result display tab, in the Corridor type and Corridor levels columns.

DMI charts can present metric baseline values in the form of a corridor.

Corridors enable you to control whether metric values are typical (for example, by comparing them to baseline values) or whether they fit into the defined thresholds. By using corridors on charts, you can quickly and easily determine the deviation of metric values from the norm.

Possible corridor types include:

  • None - Displays the chart without a corridor.
  • Fixed - Displays a corridor bounded by the constant values typed in the Corridor levels fields.
  • Percentage - Displays a corridor bounded by the baseline or metric values plus or minus a percentage of the value typed in the Corridor levels fields. For example, you can display a corridor for the Client bytes metric, where the corridor is bounded by the Client bytes benchmark values plus or minus 10% of these values.
  • Absolute - Displays a corridor bounded by the baseline or metric values plus or minus the constant values typed in the Corridor levels fields. For example, you can display a corridor for the Client bytes metric, where the corridor is bounded by the Client bytes benchmark values plus or minus some constant value.
  • Standard deviation - Displays a corridor for metrics that use standard deviations. To use this option:
  1. On the Data tab, select the base metric.
    For example, select the Server loss rate metric.
  2. On the Benchmark Data tab, select a standard deviation metric for the metric selected in step 1.
    For example, select the Server loss rate stdv metric from the Software service, operation, and site data baselines data view.
  3. On the Result Display tab, select Standard deviation as a corridor type for your base metric.
    Note that the baseline metric is set automatically based on your choice on the Benchmark Data tab.
  4. In the Corridor levels fields, provide the values by which the standard deviation should be multiplied.

Limitations of using corridors

  • Chart types
    Corridors are available for the following chart types:

    • Areas
    • Stacked areas
    • Bars
    • Stacked bars
    • Columns
    • Stacked columns
    • Lines
    • Stacked lines
  • One metric per chart
    The corridor can be displayed for charts that show values for one metric only.

  • Multiple series for metric
    The corridor cannot be displayed for charts that show multiple series for one metric. In such cases, a warning is displayed.

  • Dynamic charts
    For dynamic charts, the corridor will start and end in the middle of the edge columns of the chart. The point is represented by the middle of the column and the corridor limited by the same points will not be stretched beyond that limits.