Introduction to Tiles

A Tile is used to configure and visualize different metrics using the basic or advanced PromQL or OpsQL query builder. A collection of tiles is called a Dashboard.

The following steps let you create a Tile visualization from a query:

1. Create the dashboard.

2. Select from the following tiles:

   • Metric
   • Text & Image
   • Resource
   • Alert
   • Service Tile

3. Build a PromQL or OpsQL query using the basic or advanced query building to populate your visualization. In the basic query option, the metrics, filters, operations, attributes, and values are displayed and you can build the query by clicking +QUERY field and selecting each value from the drop down list. For example, consider the following:
   

   • Metric = system_cpu_load
   • Filter = avg
     

     

     
     

   In the advanced query option, build a query by clicking the </> to use the advanced query builder and start typing the query and complete the query. For example, consider the following:
   

   • Attribute = status
   • Operator = =
   • Value = Open
     

     

     
     

4. Select from the available chart types:

   • Line/Bar - displays multiple time series as a graph or bar graphic.
   • Single Value - displays a single value.
   • List - displays values in a list format.
   • Gauge - displays multiple time series using a gauge graphic.
   • Honeycomb - displays multiple time series in a hexbin or hexagonal graphic.
   • Pie - displays values in a pie graph.

5. Customize the visualization.

6. View the dashboard on the main dashboard page.

Tiles

The following are the available Tiles in Dashboard 2.0 version:

Create a Metric Tile

1. From Dashboard > Dashboard 2.0, create a new dashboard or select from an existing dashboard collection.

   See Create Dashboards to learn about creating dashboards.

2. Click CREATE TILE or + from the toolbar.

3. In the ADD TILE screen that appears, select METRIC.
   The following screen is displayed:

4. Click the + QUERY and select the options from the following drop-down lists as you build the query:

   • Metrics - Select any metric that is being sent to OpsRamp or an OpsRamp-generated metric.

   • Filters - Select to filter the metrics based on the tags or labels that are present on those metrics.

     • You can filter a metric based on a resource group.

       While building the query:

     • Select the metric and then click +Filters.

• Select groups from the list of tags.
  Note: You can also search using the search box.

• Select the operator and the value. The metric tile shows the metric details based on the resource group.
  Note: You can also use a dashboard variable as a value.

Note: A resource can be a part of one group or multiple groups. These groups appear as a comma-separated list in the metric series.

• You can filter a metric based on a Site.
  While building the query:
  

• Select the metric and then click +Filters.



• Select sites from the list of tags. You can also search using the search box. Select the operator and the value. The metric tile shows the metric details based on the site.
  You can also use a dashboard variable as a value.



• You can use custom attributes when querying metrics.
  Define custom attributes on the resources. Use these custom attributes to graph metric data.
  Example: View the CPU, memory, disk metrics for a specific group of resources that are tagged with specific custom attributes. While building the query:

• Select the metric and then click +Filters.

  

• Select the custom attribute, the operator and the value from the list of tags.

  Note: You can also search using the search box_.

• The metric tile shows the metric series for all the resources that are tagged with the custom attributes for the specific metric.

  Note: When creating a custom attribute value (in the Setup > Custom Attributes page), select the Metric Label checkbox. Only then the custom attribute will be considered as a label for the resource metrics.



• It takes 24 hours for the custom attribute labels to be displayed on the metric series.

• If you do not select the Metric Label checkbox while creating a custom attribute value, it will not be visible when you edit the custom attribute value.

• Metric label enabled custom attributes have limits. A maximum of 5 metric labels can be enabled per device.

• The metric label enabled custom attributes are displayed in the resource details page, in the Attributes section. This will allow you to decide which of the custom attributes you can consider as a label for the metrics.
  Click here for more information on Custom Attributes.

• Operations - You can select a maximum of two operations ranging from aggregations such as average or summation to mathematical functions like logarithms or absolute values. You can use min, max, avg, topk for the series generated.
  The preview graph is displayed as you build the query.

5. Alternatively, click </> to use the advanced query builder. Click </> again to close the advanced query field and switch to the basic query builder format.
   Note: If you make changes in the advanced query builder, you cannot switch back to the basic query builder.
6. Start typing a query and choose either a function or metric from the dropdown that appears, if you are using the advanced query option.
   See QUERYING PROMETHEUS to learn about PromQL queries.
7. Click the optional Legend icon and enter {{ in the Query a Legend field to see a list of options.
   
8. Select the data type from the following options:

9. Click SAVE to view the results based on your selection. Hover over the results on the preview graph to view them individually.

10. Select the Value option to view the results as a single value. If there are more than one series, the single value does not display.

11. You can sort the queries in ascending or descending order. This option is available for the List visualization.

12. Select the Instant toggle to view the recent value for a given metric.

    Note: The Instant option is available only for List, Gauge, and Honeycomb chart types.

13. To customize the visualization further, click the Visualization tab.

14. Click the Last Hour to select the duration for which the data needs to be retrieved. The duration can be selected for:

    • Last Hour
    • Last 4 Hours
    • Last 8 Hours
    • Last 24 Hours
    • Last 7 Days
    • Last 30 Days
    • Month to Date.

15. Click Create.
    The Metric tile is created and displayed on the main dashboard page.

Examples

The following are example illustrations for each visualization:

LINE/BAR visualization

The following is the LINE/BAR visualization with the inputs:

• Metric = system_resource_availability_state
• Filter = state = up
• Legend = uuid

LINE/BAR dashboard view

The following is the LINE/BAR dashboard view:

VALUE (single value) visualization

The following is the VALUE (single value) visualization with the inputs:

• Metric = system_resource_availability_state
• Filter = make of the resource
• Operations = avg

VALUE (single value) dashboard view

The following is the VALUE (single value) dashboard view:

LIST visualization

The following is the LIST visualization with the inputs:

• Metric A = system_resource_availability_state
• Metric B = system_service_map_availability_state
• Filters for:
  • Metric A = state = up
  • Metric B = state = up
• Operations for:
  • Metric A = count
  • Metric B = avg
• Legend for Metric A and B = {{uuid}}
• Sort By = Descending

LIST dashboard view

The following is the LIST dashboard view:

GAUGE visualization

The following is the GAUGE visualization with the inputs:

• Metric = system_service_map_availability_state

GAUGE dashboard view

The following is the GAUGE dashboard view:

HONEYCOMB visualization

The following is the HONEYCOMB visualization with the inputs:

• Metric = system_os_uptime

HONEYCOMB dashboard view

The following is the HONEYCOMB dashboard view:

Text value display for resource and service availability

For the system_resource_availability_state and system_service_map_availability_state metrics, the status is displayed as both label (text) and numeric value. The following are the values:

• Up
• Down
• Unknown
• Degraded

By default, the status is shown as a text value. To view the status as a numeric value, clear the Show as label selection in the Visualization tab.

The text status display option is available for List, Gauge, and Honeycomb visualizations only.

system_resource_availability_state

The system_resource_availability_state metric monitors the availability of the resources and displays the status as a numeric or text value. The following are the available values:

• 1 - Unknown
• 3 - Down
• 4 - Up

Sample Illustrations
The following are the sample illustrations for each visualization and its respective dashboard view:

LIST visualization

The following is the LIST visualization:

LIST dashboard view
The following is the LIST dashboard view:

GAUGE visualization
The following is the GAUGE visualization:

GAUGE dashboard view
The following is the GAUGE dashboard view:

HONEYCOMB visualization

The following is the HONEYCOMB visualization:

HONEYCOMB dashboard view
The following is the HONEYCOMB dashboard view:

system_service_map_availability_state

The system_service_map_availability_state metric monitors the availability of the service maps and displays the status as a numeric or text value. The following are the available values:

• 2 - Degraded
• 3 - Down
• 4 - Up

Sample Illustrations
The following are the sample illustrations for each visualization and its respective dashboard view:

LIST visualization

The following is the LIST visualization:

LIST dashboard view
The following is the LIST dashboard view:

GAUGE visualization

The following is the GAUGE visualization:

GAUGE dashboard view

The following is the GAUGE dashboard view:

HONEYCOMB visualization

The following is the HONEYCOMB visualization:

HONEYCOMB dashboard view
The following is the HONEYCOMB dashboard view:

Create an Alert Tile

1. From Dashboard > Dashboard 2.0, create a new dashboard or select from an existing dashboard collection.

   See Create Dashboards to learn about creating dashboards.

2. Click CREATE TILE or + from the toolbar.

3. In the ADD TILE screen that appears, select ALERT.
   The following screen is displayed:

4. Click the + QUERY and select the attributes from the drop-down list as you build the query. Click the + button to add additional attributes.
   
   • You can combine multiple filters together to view only the required alerts.
     The query is completed and the results are displayed in the preview graph.
5. Alternatively, click </> to use the advanced query builder.
   Click </> again to close the advanced query field and switch back to the basic query builder format.
6. Enter a query or click inside the box to see a list of OpsQL attributes.
7. Click the optional Legend icon and enter {{ in the EDIT LEGEND field to see a list of options.
   
8. Select the visualization from the following options:
   • Pie - Displays a pie chart.
   • Single Value - Displays a single value.
   • List - Displays values in a list format.
   • Bar - Displays the bar representation of the values.
9. From the GROUP BY option, select an attribute. You can select up to two attributes.
   In the List visualization, the second attribute values are displayed in a multi-column colored list.
   The following is a sample illustration of a multi-column list:
   

   

10. Enable the Split subgroups toggle to view each grouping as a separate row.
    Notes:
    • The multi-column list and split subgroup options are available for List chart only.
    • The colors are displayed based on the default color categorization of alerts.
    • Click the count or any column in the multi-column list to drill down and see the contextual list of alerts in the alerts browser.
11. Select the time range from the Apply dashboard time range to option to view the alerts graphs based on:
    • Alert created time: Alerts are filtered based on the alert created time and the graph is displayed.
    • Alert updated time: Alerts are filtered based on the alert updated time and the graph is displayed.
      
12. You can also customize the visualization.
13. Click the Last Hour to select the duration for which the data needs to be retrieved. The duration can be selected for Last Hour, Last 4 Hours, Last 8 Hours, Last 24 Hours, Last 7 Days, Last 30 Days, and Month to Date.
14. Click Create.
    The Alert tile is created and displayed on the main dashboard page.

Examples

The following are example illustrations for each visualization:

PIE visualization

The following is the PIE chart visualization with the inputs:

• Attribute - currentState = OK
• Group By
  • Attribute 1 = status
  • Attribute 2 = resource.name
• Legend - {{make}}
• Dashboard time range = Alert created time
• Duration = Last 8 Hours

PIE dashboard view

The following is the PIE chart dashboard view:

SINGLE VALUE visualization

The following is the SINGLE VALUE visualization with the inputs:

• Attribute - currentState = OK
• Dashboard time range = Alert created time
• Duration = Last 8 Hours
  

  

SINGLE VALUE dashboard view

The following is the SINGLE VALUE dashboard view:

LIST visualization

The following is the LIST visualization with the inputs:

• Attribute - currentState = OK
• Group By
  • Attribute 1 = status
  • Attribute 2 = resource.name
• Dashboard time range = Alert created time
• Duration = Last 8 Hours
• Split subgroups = enabled
  

The Split subgroups option displays results with the attribute name. The following is a sample illustration:

LIST dashboard view

The following is the LIST dashboard view:

BAR visualization

The following is the BAR visualization with the inputs:

• Attribute - status = Open
• Group By
  • Attribute 1 = currentState
  • Attribute 2 = dnsName
• Duration = Last 24 Hours
• Alert created time is selected.

BAR dashboard view

The following is the BAR dashboard view when Alert created time is selected:

The following is the BAR dashboard view when Alert updated time is selected:

Notes:

• The Alert created Time option displays results when the alert was created.
• The Alert updated Time option displays the results when the alert was updated.
• Select Horizontal or Vertical representation of the data from the Orientation dropdown list box in the Visualization tab.
  Notes: By default the Horizontal axis is enabled.

Horizontal Axis view

Vertical Axis View

Notes:

• If the updatedTime or createdTime attribute is selected in the Group BY field and the time range is less than or equal to 24 hours, time and date is displayed below the bar visualization.

• If the time range is more than 24 hours, only the date is displayed below the bar visualization.

• Click the stacked bar to display the multiple group information.
• Per query, Time Series tile displays up to 30 series which are mapped to the order of this color chart. You may click a swatch to edit color or click + drag to reorder.
• You may enable and disable a legend by clicking the name/color of the specific legend.
• Click Go Back to return to the view all the legends.

Create a ServiceTile

1. From Dashboard > Dashboard 2.0, create a new dashboard or select from an existing dashboard collection.

   See Create Dashboards to learn about creating dashboards.

2. Click CREATE TILE or + from the toolbar.

3. In the ADD TILE screen that appears, select SERVICE.

The following screen is displayed:

4. In the SERVICE section, you have the below drop-downs:

5. (Optional), click the ALL CLIENTS drop-down and click the Selected Clients radio button.

   Note: At the dashboard level when you change All Clients to a specific client, and select the same client from Selected Clients, in the service tile that specific client data is populated.

6. (Optional) select the client from the drop-down list, and click APPLY.

7. Select the partner name from the SERVICE drop-down list.
   Note: By default the Group Services is enabled, click the Grouped Services icon to disable.

8. Click the Visualization tab to customize the visualization further:

   • HEADER: Set a name, color, size, and alignment for the header.

   • Grid Lines: Select the color of the grid lines, enable or disable the grid lines by clicking the toggle ON or OFF, Grid Lines option.

     Note: By default the Grid Lines is enabled.

   • Background Color: Select the background color, enable or disable the background color by clicking the toggle ON or OFF background color.

     Note: By default the Background Color is disabled.

   • Attribute: Select the color for the attribute, the size, bold or Italics.

9. Click CREATE. The Service tile is created and displayed on the main dashboard page.

Create a Resource Tile

1. From Dashboard > Dashboard 2.0, create a new dashboard or select from an existing dashboard collection.

   See Create Dashboards to learn about creating dashboards.

2. Click CREATE TILE or + from the toolbar.

3. In the ADD TILE screen that appears, select RESOURCE.

The following screen is displayed:

4. Click the + QUERY and select the attributes from the drop-down list as you build the query. Click the + button to add additional attributes.

   Note: You can combine multiple filters together to view only the required alerts. The query is completed and the results are displayed in the preview graph.

5. Alternatively, click </> to use the advanced query builder.
   Note: Click </> again to close the advanced query field and switch back to the basic query builder format.

6. Enter a query or click inside the box to see a list of OpsQL attributes.

7. Click the optional Legend icon and enter {{ in the EDIT LEGEND field to see a list of options.

8. Select the visualization from the following options:

   • Pie - Displays a pie chart.
   • Single Value - Displays a single value.
   • List - Displays values in a list format.
   • Bar - Displays the bar representation of the values

9. From the GROUP BY option, select an attribute. You can select up to two attributes.

   Note: In the List visualization, the second attribute values are displayed in a multi-column colored list.
   The following is a sample illustration of a multi-column list:

10. Enable the Split subgroups toggle to view each grouping as a separate row.
    Notes:
    • The multi-column list and split subgroup options are available for List chart only.
    • The colors are displayed based on the default color categorization of alerts.
    • Click the count or any column in the multi-column list to drill down and see the contextual list of alerts in the alerts browser.
11. Click the Visualization tab to customize the visualization further:
    • HEADER: Set a name, color, size, and alignment for the header.
    • Grid Lines: Select the color of the grid lines, enable or disable the grid lines by clicking the toggle ON or OFF, Grid Lines option.
      Note: By default the Grid Lines is enabled.
    • Background Color: Select the background color, enable or disable the background color by clicking the toggle ON or OFF background color.
      Note: By default the Background Color is disabled.
    • Attribute: Select the color for the attribute, the size, bold or Italics.

12. Click CREATE. The Resource tile is created and displayed on the main dashboard page.

Examples

The following are example illustrations for each visualization:

PIE visualization

The following is the PIE chart visualization with the inputs:

• Attribute - entityType = RESOURCE
• Group By
  • Attribute 1 = availabilityState
  • Attribute 2 = nativeType
• Legend - {{nativeType}}

PIE dashboard view

The following is the PIE chart dashboard view:

SINGLE VALUE visualization

The following is the SINGLE VALUE visualization with the inputs:

• Attribute - entityType = NON_MON_RESOURCE

SINGLE VALUE dashboard view

The following is the SINGLE VALUE dashboard view:

LIST visualization

The following is the LIST visualization with the inputs:

• Attribute - entityType = RESOURCE AND hasRelationship = true
• Group By
  • Attribute 1 = type
  • Attribute 2 = clientName
• Split subgroups = enabled

The Split subgroups toggle switch displays results with the attribute name. The following is a sample illustration:

LIST dashboard view

The following is the LIST dashboard view:

BAR visualization

The following is the BAR visualization with the inputs:

• Attribute - entityType CONTAINS NON_MON_RESOURCES
• Group By
  • Attribute 1 = type
  • Attribute 2 = clientName

Notes:

• Select Horizontal or Vertical representation of the data from the Orientation dropdown list box in the Visualization tab.
  Note: By default the Horizontal axis is enabled.
• Click the stacked bar to display the multiple group information.
• Per query, Time Series tile displays up to 30 series which are mapped to the order of this color chart. You may click a swatch to edit color or click + drag to reorder.
• You may enable and disable a legend by clicking the name/color of the specific legend.
• Click Go Back to return to the view all the legend.

BAR dashboard view

The following is the BAR dashboard view:

Horizontal Axis view

Vertical Axis View

Tile Options

The following Tile options are available in the More Tile Options menu (three horizontal dots) next to a tile view in the main dashboard.

Create Dashboard Variables

Dashboard variables are created to assign specific attributes. These are used to filter the data with different attributes, without creating a new tile every time a change is required.

To create a variable, do the following:

1. Select a dashboard or create a new dashboard.
2. Click Filter in the main dashboard page. The MANAGE option appears.
3. Click MANAGE. The MANAGE VARIABLE pop-up page appears. In this page following are the supported filter options:
   • Metric
   • Resource
   • Alert
4. Select one of the filter options and provide the values to create variables. The following is an example:
   
   • Variable Name - Vendor
   • Attribute Name - make
   • Default Value - select a value from the drop-down list
     

     

5. Click + to add the variable. The new variable is added and displayed on the main dashboard page.
   
6. You can perform the following actions on the variable:
   • Edit - click to edit the variable, and then click the tick mark to save the changes.
   • Remove - click to remove the variable.

Click X to close the MANAGE and RESET options menu and view the toolbar.

6. Now, you can use the newly created variable with the tile.
7. Create a Metric, Resource, or Alert tile by clicking + on the dashboard page. The new variable will be available for selection.