Default Widgets Reference


Get the latest docs

You are looking at documentation for an older release. Not what you want? Go to the current release documentation.

This section provides a description of all the widgets that are included by default in Cloudify Manager (out-of-the-box). You can select these widgets from the widgets catalog.

To view the widgets catalog, from the dropdown menu next to your user name, select Edit Mode, then click the Add Widget button to display the list of widgets. If you do not see Edit mode in the dropdown menu, you do not have permissions to edit configuration.

For information about adding widgets, placing them on a page, and so on, see Configuring the Web Interface Display.

Notes:

  • You might have to configure some of the widgets. In the event that configuration is mandatory, the mandatory requirements are included in the widget descriptions. Many widgets also have non-mandatory configuration that enables you to customize them to your requirements.

To open a widget’s configuration dialog after you have added it to a page, click the gear icon in the top right of the widget.

  • Some widgets are only available for admin users.

The widgets are listed according to their category.

Blueprint Widgets

Blueprint Sources

Displays all the sources in a blueprint package in tree view, adjacent to the code. When you click an item in the tree, its code is displayed in the code panel.

blueprint-sources

Blueprint deployments

Displays the list of a deployments in the current tenant, according to the logged-in user’s permissions. The data can be displayed as a table or list. In the case of a list view, the status of each deployment is also displayed. For information about deployment status, click here

blueprint-deployments

Blueprint info

Displays information about a specific blueprint.

Configuration

The blueprint ID must be passed to the widget. This can be done either in the page’s context, by placing the widget in a blueprint drill-down page, or by specifying the blueprint ID in the widget’s configuration.

blueprint-info

Blueprints

Displays all the local blueprints on the Cloudify Manager in the context of the current tenant as a table or tile view, according to the logged-in user’s permissions. In the catalog view, each blueprint entry includes the icon PNG file with which it was uploaded or the Cloudify default icon if no PNG file was attached.

Configuration

In the widget configuration dialog, you can toggle on the Click to drill down option so that, when the blueprint is clicked, the drill down page is displayed for that blueprint.

blueprints-list

Blueprints Catalog

Displays the details of a blueprint that exists in a repository under a Github user that has been specified in the widget’s settings, as a table or tile view. The widget provides an upload option for each of the blueprints, enabling them to be easily uploaded locally to the Manager.

You can create a filter query in the configuration to specify the blueprints that appear.

blueprints-catalog

Deployment Widgets

Deployment Inputs

Displays the blueprint input values. You can hover over the values, to display them in a separate window, which is useful if the values include multi-line code.

deployment-inputs

Deployment Outputs

Displays the blueprint output values. You can hover over the values, to display them in a separate window, which is useful if the values include multi-line code.

deployment-outputs

Deployment Metric Graph

Displays a chart or charts (up to 5) presenting metric data for the current deployment. After you have added the widget to a page, you can select the metrics to be displayed, and define their properties in the widget’s configuration dialog.

Configuration

You must supply at least one metric or database query in the widget configuration. You also need to supply the deployment’s ID, either in the page context, or by specifying it in the widget configuration.

The following list provides information regarding parameters that can be specified for this widget.

  • Refresh Time Interval - how frequently the data in the widget is refreshed (in secs).
  • Deployment ID - the ID of the deployment for which you want to display data. The ID can be passed in two ways:

    • as part of the page’s context. For example, if you add the graph widget to the deployment drill-down page, in order to access the graph widget you must first choose a deployment from the deployments page. In that case, the drilled-down page already contains the context of the deployment you chose, so the widget automatically retrieves the Deployment ID from it. You can also set Deployment ID in page’s context using Filter by blueprint, deployment widget
    • if a Deployment ID was not provided by the page’s context, the widget looks for a specific Deployment ID to be provided in its configuration Deployment ID field.
  • Charts Table - table containing definition of up to 5 charts. Charts Table configuration You can define the following parameters:

    • Metric - the specific Diamond metric you want the widget to display. This parameter is mandatory. For more information about these metrics, see the Diamond documentation. The available options are:
      • cpu_total_system
      • cpu_total_user
      • memory_MemFree
      • memory_SwapFree
      • loadavg_processes_running
    • Label - the label to be displayed for the specific chart (the label will be displayed at the bottom of the chart). Parameter is optional. When not specified, then metric name will be taken as chart label.
    • Unit - the unit to be displayed for the specific chart (the unit will follow label and will be displayed in the square brackets). Parameter is optional.
  • Time range and resolution - enables you to specify the timeframe of the metrics to be displayed. For details of the configuration see Time filter widget.

  • Custom Influx Query - by default, the query is based on deployment ID, metric name, time filter and resolution. It is possible to define your own query, which will then be used to fetch data. Charts Table configuration Query (select <SELECT column> from <FROM column> where <WHERE column>) consists of the following parameters:

    • SELECT - defines part of query added just after SELECT keyword. Example: mean(value)
    • FROM - defines table from which to fetch data, you can use ${deploymentId} token to inject dynamic deployment ID. Example: /${deploymentId}..*.((memory_MemFree))$/
    • WHERE - defines constraints for the query. You can use ${timeFilter} token to inject dynamic data/time ranges. Example: time > now()-1h and time <now() group by time(1m) order asc or just ${timeFilter}.
  • Charts Type - Select one of the following types: line, bar and are chart display.

Examples

  • multi-metric with line charts multi-metric example with line charts

  • multi-metric with bar charts multi-metric example with bar charts

  • single-metric with area chart single-metric example with area chart

Events and Logs Widgets

Events and Logs

Displays the logs and events of all the executions in the current tenant, according to the user’s permissions. You can configure the fields that are displayed and can use colors to indicate success and failure messages.

Configuration

The fields that can be displayed are:

  • Icon
  • Timestamp
  • Type
  • Blueprint
  • Deployment
  • Workflow
  • Operation
  • Node Name
  • Node ID
  • Message

events-logs

Event and Logs Filter

Displays a filter pane for events and logs.

events-logs-filter

Execution Widgets

Executions

Displays data for about the executions in the current tenant, according to the user’s permissions. Data includes the blueprint and deployment of the execution, the time that it was created, and its current status.

executions

Filter Widgets

Filter by Blueprint, Deployment or Execution

Displays a filter to enable searching by blueprint, deployment, or execution.

filter-by-action

Event and Logs Filter

See Event and Logs Filter

Time Filter

Displays a time filter for deployment metric graphs. It allows to define:

  • Time range - enables you to choose start (From) and end (To) dates

    • by defining custom range
      • using text input - Influx-compatible date/time is allowed. It is possible to define both absolute and relative date/time. For details, see the Influx documentation - Date time strings. Examples: now() - 15m or 2017-09-21 10:10
      • using calendar picker - you can choose date and time from the calendar/time pickers
    • by choosing predefined range - there are few predefined time ranges available. You can apply them with one click using the buttons on the left side of the filter
  • Time resolution - enables you to group the metrics according to time, to reduce the volume of displayed data. For example, although data might be collected every 10 msecs, you might specify that you only see points on the graph for every minute. Allowed time resolution units: microseconds, milliseconds, seconds, minutes, hours, days and weeks. Value ranges from 1 to 1000.

The filter provides also the following features:

  • Time resolution optimization - automatic time resolution is set when you specify predefined range. It optimizes number of points to fetch from database to maximum 200 per chart. You can also optimize time resolution for custom ranges by clicking Optimize button.

  • Time range and resolution reset - when you click Reset button, both time range and time resolution are reset to default values.

  • Data validation - when you click Apply button time range is validated. If invalid data is provided, then appropriate input field is marked with red color and time filter window will not be closed.

Time Filter

Cluster Widgets

High Availability

Displays the Manager’s status. In the event that there is one or more cluster on the Manager, shows the cluster-connected nodes. There is no click-through actions available from this widget.

list-nodes-in-cluster-2

Node Widgets

Nodes List

Displays a list of the existing nodes related to the blueprint topology. The type, containing node, connection, number of instances, and groups of which the node is part are displayed.

The nodes are listed by name. When you select a node, either by clicking its name in the table or by clicking it in the Topology pane, additional data about the node’s instances are displayed.

nodes-list

Nodes Statistics

Displays the number of node instances, according to their states. node-statistics

Miscellaneous Widgets

Number of Deployments/Plugins/Servers

Displays indicators that provide the total number of deployments, plugins and servers on the Manager.

deployments-plugins-servers

Plugins List

Displays a list of plugins and enables their management.

plugins-list

Secrets Store Management

Displays a list of secrets and enables their management. In the widget, you can hover your cursor over the eye icon to display the value of the secret.

Caution

Any user who has access to the Secrets Store Management widget can view the value of the secrets.

secrets-store

Snapshots List

Displays a list of snapshots of the Manager. This widget is only available to admin users.

When restoring snapshots, a specific process must be followed, relating to whether you want to use your existing VM or create a new one. For more information, click here.

snapshots-list

Tenant Management

Displays a list of tenants on the Manager and enables tenant management. This widget is only available to admin users.

tenants-list

Show Topology

Displays the topology of a blueprint or deployment.

show-topology

User Group Management

Displays the list of user groups and enables their management. This widget is only available to admin users.

manage-usergroups

User Management

Displays the list of users and enables their management. This widget is only available to admin users.

manage-users

Button Widgets

Blueprint action buttons

Displays buttons for displaying the creating a deployment or deleting a blueprint dialog.

blueprint-actions

Opens the specified URL in a separate tab. You can define the name that appears on the button.

Configuration

Specify the URL to open when the button is clicked.

button-link

Deployment Action Buttons

Displays buttons for displaying the execute a workflow, update a deployment, and delete a deployment dialogs.

deployment-actions

New Deployment Button

Displays a button for displaying the creating a deployment dialog.

create-new-deployment