5 minute readApplies to: v4

How to use the Alerts tile

Overview

The Alerts tile allows you to view alerts on your dashboards and perspectives. This document describes how to get started with the Alerts tile.

For more information about Azure Alerts see Overview of alerts in Microsoft Azure.

Alerts tile types

The Alerts 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.

Alerts tile

After selecting the Alerts tile you will get the choice of tiles.

Alerts list

Alerts List button

The Alerts list shows a list of alerts, and you can add alerts tiles to any dashboard or perspective. The list can be filtered by alert state, severity, monitor condition or monitor service.

Alerts list

You can drilldown from an alert on the Alerts list, to view that alert's drilldown page in SquaredUp. From there the view in portal button at the top right of the page, allows you to link to the Azure portal to view the alert.

Alerts list

Alerts Donut

Alerts Donut button

The Donut tile shows a summary of the number of alerts either by severity, alert state or monitor condition.

Alerts Donut Severity

Clicking on a donut segment or on the key shows a list of alerts with that severity, alert state or monitor condition.

Alerts tile options

Scope

The scope section allows you to define what is shown.

For more information see How to scope tiles

Timeframe

When adding and editing the tile you can choose either use page timeframe or specific timeframe.

The Alerts tile timeframe shows a maximum time period of last 30 days. This is because Azure only stores 30 days worth of Alerts data.

For more information see How to use Timeframe option.

Filters

The filter section allows you to control which alerts are shown by the tile.

For more information about Azure Alerts see Overview of alerts in Microsoft Azure.

Sort

For Alert lists the sort section allows you to change how the list is sorted, for example by last modified, monitor condition, name, severity or time raised.

Limit

This section is for changing how many alerts are shown by the list tile.

Columns

The columns section allows you to show the column titles, rename titles, sort and hide columns in the Alert list.

The severity column cannot be renamed because the column name is not shown due to the narrow column width.

Grouping

When configuring the Alerts Donut tile the grouping section allows you to select whether the donut shows by severity, alert state or monitor condition.

Alerts Donut Monitor Condition

Display

The display section for the Alerts Donut tile allows you to change the size of the donut, and show or hide the legend.

Known Issues

Blank drilldown page after clicking on an alert in SquaredUp

If you have upgraded from v4.4 to v4.5 you will not have the pre-populated Alert drilldown perspectives. You can populate the drilldown page by creating two new perspectives as described below.

  1. Drilldown by clicking on an alert in an Alert list.
  2. Click the small grey plus button to add a new perspective.
  3. Click on the Edit JSON button

    Alerts Donut Monitor Condition

  4. Copy the JSON below and paste it into the JSON box, overwriting everything already there.

    {  
    	"content": {
        	"_type": "layout/list",
    	    "contents": [
    			{
        			"_type": "layout/column",
    	    		"columns": [
    		    		{
    			    		"contents": [
    				    		{
    					    		"_type": "layout/list",
    						    	"contents": [
    							    	{
    								    	"_type": "tile/azure-structure",
        									"config": {},
    	    								"description": "",
    		    							"title": "Structure"
    			    					}
    				    			]
    					    	}
    			    		],
    				    	"width": 47.914
    			    	},
    				    {
    						"contents": [
        						{
    	    						"_type": "layout/list",
    		    					"contents": [
    			    					{
    				    					"_type": "tile/azure-monitoralert-properties",
    					    				"config": {},
    						    			"description": "",
    							    		"title": "Monitor"
    								    }
    								]
        						}
    	    				],
    		    			"width": 52.085
    			    	}
    				]
        		},
    	    	{
    		    	"_type": "tile/text",
    				"config": {
        				"display": {
    	    				"contentTemplate": "<pre class='u-text-normal'>{{properties.essentials.description}}</pre>"
    		    		}
    			    },
    				"description": "",
        			"title": "Description"
    	    	},
    		    {
    				"_type": "tile/azure-monitoralert-history",
        			"config": {
    	    			"display": {
    		    			"autohide": true,
    			    		"columnOverrides": {},
    				    	"columns": [
    					    	"comments",
    							"description",
        						"modificationEvent",
    	    					"oldValue",
    		    				"newValue",
    			    			"modifiedAt",
    				    		"modifiedBy"
    					    ],
    						"customColumns": {},
        					"rowLink": "",
    	    				"showHeaders": true
    		    		}
    			    },
    				"description": "",
        			"title": "History"
    	    	},
    		    {
    				"_type": "tile/azure-monitoralert-smart-group",
        			"config": {
    	    			"display": {
    		    			"columns": [
    			    			"severity",
    				    		"name",
    					    	"targetResourceGroup",
    							"targetResourceName",
        						"targetResourceType",
    	    					"startDateTime",
    		    				"alertState"
    			    		]
    				    },
    					"source": {
        					"alertStates": [],
    	    				"limit": 250,
    		    			"monitorConditions": [],
    			    		"monitorServices": [],
    				    	"severities": [],
    					    "timeframe": {
    						    "range": "last30days",
    							"type": "fixed"
        					}
    	    			}
    		    	},
    			    "description": "",
    				"title": "Smart Group"
        		}
    	    ]
    	}, 
    	"id": "43e1362a-8cef-4bce-8ac9-f7de0f46242c",
    	"match": {
    		"type": "azure/alert"
    	},
    	"name": "Alert",
    	"rank": -1000,
    	"derivedFrom": "00000000-0000-0000-0000-000000000000",
    	"createdFromReference": {
    		"packId": "ddb53c1e-ffe4-40ad-bdc2-22b0bcad5e30",
    		"itemId": "b09678cb-6312-402b-8acd-f956d30ea2ac",
    		"packversion": "1.0"
    	}
    }
  5. Click the apply changes button below the Perspective JSON box.
  6. Publish the perspective.
  7. Click the small grey plus button to add another new perspective.
  8. Copy the JSON below and paste it into the JSON box, overwriting everything already there.

    {
    	"content": {
    		"_type": "layout/list",
    		"contents": [
    			{
    				"_type": "layout/column",
    				"columns": [
    					{
    						"contents": [
    							{
    								"_type": "layout/list",
    								"contents": [
    									{
    										"_type": "tile/object-properties",
    										"config": {
    											"display": {
    												"path": "properties.context"
    											}
    										},
    										"description": "",
    										"title": ""
    									}
    								]
    							}
    						],
    						"width": 100
    					}
    				]
    			}
    		]
    	},
    	"id": "3248ba18-bc23-4d91-99b0-3574eaf1ce20",
    	"match": {
    		"type": "azure/alert"
    	},
    	"name": "Context",
    	"rank": -2000,
    	"derivedFrom": "00000000-0000-0000-0000-000000000000",
    	"createdFromReference": {
    		"packId": "ddb53c1e-ffe4-40ad-bdc2-22b0bcad5e30",
    		"itemId": "74bf5348-261d-41e8-8cb3-08e97bdba809",
    		"packversion": "1.0"
    	}
    }
  9. Go back to your Alerts list tile, and click on another alert to check that the Alert and Context perspectives are shown.

How to scope tiles

How to use Timeframe option

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