7 minute readApplies to: v4

How to use the Status tile

The Status tile allows you to show resources, resource groups and subscriptions, and any health states.

Overview

The Status tile button (along with several other tiles) displays a little plus up the top right. This indicates that there are more tiles available from this one button.

Status tile with +

After selecting the Status tile you will get the choice of the following tiles:

  • Resources Icons, Blocks or Donut
  • Resource groups Icons or Blocks
  • Subscriptions Icons or Blocks

See What is an Azure Resource?

Status Icons

Status Icons Grouped By Type

Status Blocks

Status Block Tile Complete

Status Donut

Status Donut Tile Complete

Scope

The scope section allows you to define what is shown.

For more information see How to scope tiles.

Sort

Sort allows you to change the order of the results displayed, and group them by characteristics.

Status Group By

Label and Sublabel

These options allow you to change the label and sublabel of the results.

The default label is the name and the default sublabel is the resource summary which shows the type | resource group | size | location.

Custom labelling

Using the custom option you can create your own advanced label to specify exactly how you want the results to be displayed (using both static text and dynamic properties) to ensure that the results always make sense.

Custom labels use Mustache syntax to insert properties. If you're familiar with mustache, you can specify advanced labels that can transform properties prior to displaying them (such as showing only a portion of text, converting a number or reformatting a date).

For example you can use the javascript split method to separate properties into substrings to make the result more readable.

You can edit the creation date:

{{properties.creationDate}}

To become:

{{properties.creationDate.split('T')[0]}}

This removes the timestamp just leaving the date the resource was created as the sublabel:

Custom Sublabel

The mustache helper

When specifying a mustache for a custom label, clicking the {{}} button or typing {{ brings up a helpful picker which shows all the properties of your selected resource, along with sample values.

Once the mustache helper is displayed, the list of properties will automatically filter based on what you type, allowing you to quickly find a property using a partial name or likely term. Clicking an item in the list will automatically insert that property into your label and complete the mustache.

Property names are case-sensitive and should be written as they appear in the mustache helper (e.g. {{resourceGroup}} not {{ResourceGroup}}).

Walkthrough: Using the Status Icon tile to show all virtual machines within a resource group

This walkthrough shows you how to add a Status Resources Icon tile to a dashboard.

  1. In SquaredUp navigate to where you'd like the dashboard to be created. Hover over the + button and click dashboard.
  2. Give the dashboard a title, by replacing the text that says New Dashboard.

    The dashboard is saved as you go along so there's no need to save your changes. You can find your dashboard by clicking on the right-hand menu ☰ > system > unpublished.

  3. A new tile has already been added to the dashboard. Edit the title by overwriting the placeholder value New tile with your own title.
  4. The tile selector will already be open. Click Status.
  5. Click on the Resources (Icons) button to create a Status Resources Icons tile.

    Status Resources Icons button

  6. Next we need to scope the tile. In the scope section select resource group then start to type the name of a resource group, and then click on correct group from the results.

    Icons for the resources in this resource group should appear. You could stop here, but we'll continue to configure the tile.

  7. In the sort section click group by, then type. This will group your resources by type.

    Status Group By

  8. Make a note of one of the types returned in the results.
  9. Click on the scope section again, tick filter by type and start typing the name of one of the resources types, for example virtual machines, then select it from the list. This scope the tile to only show resources of that type.

    Scope Filter By Type

  10. Once you've filtered the scope to only show resources of a particular type you'll probably want to change the sort to group by something other than type. Click on the sort section and click on location. The tile will now show all the virtual machines in the selected resource group by location.

    The label and sublabel sections allow you to edit the labels displayed if you wish to.

  11. In the label section we're going to use the custom option, to create a custom label which is particularly useful to get the label to fit within the block when using a large font size. Click on custom, then click on the mustache {{}} helper button on the right to show the custom label dropdown list:

    Status Label

  12. The dropdown list shows all the options available along with an example value. In this walkthrough we are going to select properties.hardwareProfile.vmSize. This will then appear next to the original label in the label template box, and you can edit it as required, for example to add spaces and bracket as below:

    Status Label Template

  13. In the sublabel section click on custom then click on the mustache {{}} helper button on the right to show the custom label dropdown list. For example, you might like to select properties.storageProfile.osDisk.diskSizeGB to show the disk size and then type GB disk afterwards as below:

    {{properties.storageProfile.osDisk.diskSizeGB}}GB disk

  14. Click done.

    Status Icons

Walkthrough: Creating a high impact dashboard to show all resources of the same type across resource groups

This walkthrough shows you how to add a Status Resources Blocks tile to a dashboard.

  1. In SquaredUp navigate to where you'd like the dashboard to be created. Hover over the + button and click dashboard.
  2. Give the dashboard a title, by replacing the text that says New Dashboard.
  3. A new tile has already been added to the dashboard. Edit the title by overwriting the placeholder value New tile with your own title.
  4. The tile selector will already be open. Click Status.
  5. Click on the Resources (Blocks) button to create a Status Resources Icons tile.

    Status Resources Blocks button

  6. Next we need to scope the tile. In the scope section select type then start to type the name of a type, such as virtual machines, and then click on correct type from the results.

    Scope Type

    Blocks for the resources of this type should appear. You could stop here, but we'll continue to configure the tile.

  7. In the sort section click group by, then health state. This will group your resources by health state.

    Scope Sort

  8. The blocks section allows you to change the size and layout of the blocks, by changing the columns, height and font size.
  9. Leave the label section as it is for now.
  10. In the sublabel section click on custom then click on the mustache {{}} helper button on the right. Select location from the custom label dropdown list
  11. Click done.

    Status Block Tile Complete

Hints and Tips

How to change from a single column list to a multiple column view of your Status icons

You can toggle between list, column and tile views using the toggle zoom button at the top right of the tile:

Status icon list view

Wikipedia: Mustache template system

Ractive 0.7 Mustache extensions

Regular Expression

Squared Up Ltd. (c) 2020Report an issue with this article