Universal diagram section type - details

This section type enhances your report with interactive diagrams, images, and bitmaps.

With a universal diagram, you can import a graphic (for example, a map) and overlay it with points representing the status of an element of your infrastructure, such as a tier or server IP address. You can use it to construct reports showing business impact at subsidiaries across the world or performance across the delivery chain of the application.

  • Render points with values of one dimension
  • Color and scale points on the graphic based on a metric value
  • Enable a drilldown from each point to a different report
  • Filter by a selected point
  • Add section buttons
  • Autoscale the universal diagram to a desired size or to fill a certain space in the report

Requirements

  • Set Display name to the name of the section.
  • Set Section type to Universal diagram.
  • Select only one dimension to map out on the diagram.
  • Select a metric for that dimension.

Getting started

This is a quick run-through to show you how to create a report from scratch that uses a universal diagram.

  1. On the NAM Server, select DMI > New report to create a sample report.
    DMI opens to the Data tab of the first (and only) section definition for our example report.
  2. On the Data tab
    • Set Section type to Universal diagram.
    • In the Edit column, expand the Subject row and specify some data we can map to the diagram. For example, we will map total bytes and total bandwidth usage for software services:
      • In Dimensions, select Software service and set Show as to Point.
      • In Metrics, select Total bytes and Total bandwidth usage.
  3. On the Result display tab
    • Set Metric used for determining the size of a point to Total bandwidth usage.
    • Set Metric shown in a point's label to Total bytes.
    • In the Software service row
      • Set Color rendering to Custom and select Total bytes
      • Set Thresholds to some values (for example, red = 1000 and yellow = 1000000)
  4. On the Universal diagram tab
    • Click File name and select DefaultGrid.png for this example.

      In practice, you would want to find or create a graphic a background graphic to represent your problem space, such as a geography, process diagram, or concept map. Then you would click Upload image at this stage and select your graphic to upload it to the NAM Server. But for now, we will use a standard empty grid.

    • Click Settings and select Show labels

    • For each software service you want to display on our example map, select the software service in the list, then click a point on the graphic. Just do two or three for now to see how it works. After you place them on the diagram, you can drag and drop points to more precise locations.

  5. Click Display report to see the results.

That's it. If you have followed the above procedure, you should see the grid graphic with your selected software services represented by points that are scaled to Total bandwidth usage and labeled with Total bytes.

For details on certain parts of this feature, see below.

Managing images

Uploading an image

  1. Switch to the Universal diagram tab.
  2. Click Upload image.
  3. Select a file.
  4. Click Open.

Limitations

  • Only System Administrators and Reporting Administrators can upload images.
  • The image type must be .png or .jpg.
  • The total size of all uploaded images cannot exceed 1 GB.

Selecting an uploaded image

  1. Switch to the Universal diagram tab.
  2. In the File name field, click the currently selected file name to list all available files.
  3. Select a file name.

Limitations

  • There is no image preview available. You see the image after selecting it from the list.
  • You cannot zoom or resize the image. The image is displayed as uploaded to the server. If it is too big to fit the screen, scroll bars appear on two sides of the viewing area to facilitate navigation.

Deleting an image

  1. Switch to the Universal diagram tab.
  2. In the File name field, click the currently selected file name to list all available files.
  3. Click the delete for the image file you want to delete from the NAM Server.

Limitations

  • Only System Administrators and Reporting Administrators can delete images.

Filtering the dimension values used as data points

You can choose between two list views:

Filtered

If you define any filters on the Data tab, the list of available dimension values (data points) is limited by your filtering criteria.

All

This view lists all available values of the selected dimension.

Note that if you add a custom point in the Filtered view, but this dimension value already exists in a dictionary, and you switch to the All view, your custom point becomes a common point; the The custom point icon icon disappears and you cannot remove that point from the list. This also happens when your custom point does not exist in a dictionary initially, but it appears in the next monitored intervals and belongs to the set of chosen dimension values.

The opposite takes place when you switch from the All to the Filtered view. If you are in the All view and use a point that is not defined as a filter, and then you switch to the Filtered view, that point becomes a custom point.

Defining color rendering for data points

To visualize the status (represented by a comparison of the chosen metric value to its threshold) of your monitored components (represented by a selected dimension such as the Client site), you must define color rendering for the dimension selected as a Point.

Defining point size and labels for data points

On the Result display tab, use the Point options settings to determine point characteristics.

  • Set Metric used for determining the size of a point to scale the size of the point to the value of the selected metric. If not selected, all points are rendered the same size.
  • Set Metric shown in a point's label to show an additional metric name and value in the label. If not selected, the label shows only the name of the dimension you used to define points. If selected, the name and value of the selected metric are displayed in the label under the name of the dimension.
Tip
  • Select the same metric for both settings to show the metric graphically and as a metric value.
  • Select different metrics to show complementary values, one represented as the point size and the other displayed as a metric name and value in the label.

Placing data points on the image

Note:

  • On the Data tab, you select exactly one dimension to be displayed as a data point.
  • On the Universal diagram tab, to the left of the image, you see the values of the selected dimension. They are ordered alphabetically and can be used as data points on the image.

So, to place a data point on the image:

  1. On the Universal diagram tab, select a dimension value in the list.

  2. Hover the mouse pointer over the image.
    When you do this, the pointer changes to crosshairs to help you precisely place the data point on the image.

  3. Click the place where you want to put the data point for the selected dimension value.

    • You cannot put two data points in the same place. Every time you try to put a point in a place that is already taken by another data point, the point color changes to red.
    • The maximum number of points that you can place on the image is 200.
    Note

    Optionally, you can enter the point coordinates manually:

    1. Click Show point coordinates for the selected list item.
    2. Enter the X and Y values of the point coordinates.
    3. Enter the X and Y values of the label offset, which determines where the label will be displayed in relation to the point location.
      • Set X to 0 to place the label directly under or over the point, depending on how you set the Y offset.
      • Set Y to a negative number to place the label above the point or to a positive number to place the label below the point.
  • If you define data points and decide to change the image, all point positions will be scaled to fit the size of a new image.
  • If a dimension value that is used as a data point is not available in a particular time range, it will not be displayed on the report.
  • You can drag and drop points and labels to new locations on the Universal diagram tab.

Adding custom data points

Custom points are values that do not exist in a dictionary and are defined by a user.

You can define a custom data point by adding a new dimension value to the list. To do this, click the Add custom data point icon and type the dimension value. Click OK to save your changes.

Managing custom data points

All custom points are marked with A custom point icon to distinguish them from the basic dimension values. You place these points on the image the same way as you place all other data points.

To list only the custom points, click Show custom points.

To delete the custom point from the list, click Delete custom point next to the point name. The point is also deleted from the image.

Note: Data points that are not available for the selected time range are always marked as custom points.

Common options for all data points

  • To list only those dimension values that are already in use, click Show active points.
  • To remove a point from the image, click Remove point from the diagram.
  • To remove all points from the image, click Remove all points.
  • To change the point size, click Settings and choose a new size. Default size: Medium.
  • To show data point labels, click Settings and click Show labels.