Blueprint Graphs

Last updated
Save as PDF

Overview

Available with Events & Monitoring, use FireScope's Graphs to plot and chart Attribute values over time, or relative to each other.

Create a Blueprint Graph to compare a set of 1-5 Blueprint Attributes to each other, and propagate a Graph to all Configuration Items (CIs) linked to the Blueprint.

Use regular Graphs with 1-5 Attributes from up to 5 different CIs to compare across CIs with parallel bar, stacked bar, pie, donut, gauge, and multi-axis line styles.

Add Annotation Markers at specific values for individual Attributes on Bar and Line Graphs, and automatically see Maintenance Windows added to the line Graphs as well. Then get a preview of the Graph with current Attribute values anywhere the Graph is seen in the application.

List View

A FireScope Configuration Administrator or higher can find the Blueprint Graphs List Configuration > Blueprint Graphs > List. Each Blueprint Graph is associated to a Blueprint, meaning the Blueprint Graph List can be filtered down by selecting the Blueprint Group and Blueprint from the Omnibar at the top of the page. All Blueprint Graphs containing Blueprint Attributes from the resulting Blueprint or group of Blueprints will be listed.

List Context Menu Items

In the far-right column of the List view, there is a context menu for each Blueprint Graph with the following items:

Edit Blueprint Graph - Navigates to the Blueprint Graph Edit Form.
Delete Blueprint Graph - Prompts with a modal confirmation to delete the Blueprint Graph

If a Blueprint Graph cannot be modified, a context menu may not be offered

Edit Form

When creating a Blueprint Graph, only Blueprint Attributes that return numeric values (Value Types: Numeric or Float) can be used. Additionally, only 5 Blueprint Attributes can be added to a single Blueprint Graph due to performance and presentation considerations.

Details Section

Form Field	Description	Required?
Name	Enter a name for the Blueprint Graph. It must be unique in the Blueprint.	Yes

Options Section

Form Field

Description

Required?

Graph Type

Choose the type of Blueprint Graph to display:

Bar - (a horizontal bar for each Blueprint Attribute, sharing a value-based X-Axis). Supports annotation markers.
Bar (Stacked) - A single horizontal bar along a value-based X-Axis for summing all Blueprint Attribute values together, comparing their contribution to the total. Supports annotation markers.
Donut - A circular chart showing each Blueprint Attribute value as a contribution to the total.
Gauge - A half-circle chart for percentage values showing their value relative to 100%.
Line - An XY time series chart with support for Blueprint Attributes to share the same Y-Axis or be split into individual Axes. Offers various line styles for display and supports annotation markers.
Pie - A radial chart showing each Blueprint Attribute value as a contribution to the total.

Yes

Use Automatic Colors

Let the application choose the best color for each data series? Default On for new graphs, Off for editing existing graphs.

This will be automatically turned off after initial creation to store and persist colors through edits and changes to Blueprint Attribute selection/order. It can be turned back on to reassign colors during these subsequent edits to the Blueprint Graph.

Turn Off to manually select each Blueprint Attribute's color with a color picker in the Attribute Panel:

Use Separate Y-Axis

Only for Line Graph Types. Default Off.

Turn On to add a separate Y-Axis for each Blueprint Attribute in the Blueprint Graph.

Preview (Mock Data) Section

Blueprint Attributes do not collect data themselves. In order to give a sense of what the resulting graph would look like, "mock data" is used to fill up the same number of collected values for the same period based on collection interval for each Blueprint Attribute.

The mock data used bears a resemblance to the corresponding Blueprint Attribute in "collection interval" only. It does not take into account likely values, nor min/max potential values. View actual Attributes generated by the Blueprint Attribute to get a better sense of the range an Attribute Value may have when plotted, and use this information for setting Annotation Markers, sort order, and color/line style.

Attributes Panel

Only Attributes that have a numerical value type assigned (integer or float data) can be used in Graphs.

To add Blueprint Attributes to the Graph:

Click the Edit button on the Blueprint field to reveal the Blueprint Picker Drawer.
Mark the Blueprint to pull Blueprint Attributes from.
Click the Add Attribute button to reveal the Blueprint Attribute Picker Drawer.
Mark the Blueprint Attributes to use in the Blueprint Graph.

A maximum of 5 Blueprint Attributes can be on the same Blueprint Graph.

Use to select several Blueprint Attributes in a series, mark the first checkbox, and hold the SHIFT key when clicking the last checkbox.

Customizing Blueprint Graph Attributes

Below is an example of a single Blueprint Attribute, with a single Annotation Marker used to mark a value of 40 as a Warning threshold (visible with the Bar & Line Graph Types), and the Line Style customization options (visible with only Line Graph Types).

Form Content / Field	Description	Applicable Graph Types
Attribute Color Picker	If not using Automatic Colors, choose the color to represent the Blueprint Attribute in the Blueprint Graph. Be sure to choose colors that are visually distinct from the other colors used in the Graph for readability.	All
Blueprint & Blueprint Attribute Information	The name of the Blueprint is placed on top of the name of the Blueprint Attribute.	All
Line Style	Choose the type of line to represent this Blueprint Attribute in the Blueprint Graph: Normal Line - A solid line of default thickness. Shaded Area - A "Normal Line" where the area between the line and the 0-value is shaded with the Blueprint Attribute's color. Thick Line - A solid line of increased thickness. Dotted Line - A line composed of dots with default thickness. Dashed Line - A line composed of dashes with default thickness.	Line
Add Marker Button	Click the Add Marker button to put an Annotation Marker on the Blueprint Graph for this Blueprint Attribute. See Adding Annotation Markers below.	Bar Bar (Stacked) Line
Remove Blueprint Attribute Button	Click the Remove Blueprint Attribute button to remove this Blueprint Attribute and associated Annotation Markers from this Blueprint Graph.	All

Adding Annotation Markers

For Bar, Bar (Stacked), and Line Graph Types Annotation Markers can be added to the chart at specific values.

Annotation Markers are assigned to specific Blueprint Attributes due to multi-axis support.

For Line Graph Type, if using multiple Y-Axes, the annotation will be added on the specific Blueprint Attribute's Y-Axis value position.
For both Bar Graph Types, the annotation will be placed on the X-Axis value position, which is visually shared by all Blueprint Attributes.

Form Content/Field	Description
Annotation Color Picker	Choose the color for the Annotation Marker line & flag outline
Label	Set the text of the Annotation Marker. Make it short and concise.
Value	Enter a number where the annotation should be drawn.
Remove Annotation Button	Click the Remove Annotation button to remove it from the Graph

Tags Panel

Add Tags to the Blueprint Graph to easily filter to it in the Blueprint Graphs List and to describe similar Blueprint Graphs in a metadata fashion. Enter the Tag name and select it from the list, or use the comma (,) or tab keys to add a new one to the list.

Deleting

Removing a Blueprint Graph can be done from the List view, the Edit Form of existing Blueprint Graphs, and in the context menu by FireScope Configuration Administrators or higher.

Deleting a Blueprint Graph will remove all Graphs that it created from every Configuration Item linked to the Blueprint.

From the List view, there are 2 methods for deletion: individually, or in bulk.

To individually delete Blueprint Graphs:

Locate the row in the list with the Blueprint Graph to be deleted
In the far-right column click the 3-dot button to reveal its context menu.
Click Delete Blueprint Graph from the context menu items.
Follow the modal confirmation to click Delete.

To bulk-delete Blueprint Graphs:

Select the checkboxes on the rows to be deleted.
In the top-right of the List table, some Change Action buttons will appear (or 1 Action button if more than 3 change actions are available).
Click the Delete Blueprint Graphs button or dropdown menu item.
Follow the modal confirmation to click Delete.