The SCOM task tile allows you to run SCOM tasks and display up to date in-depth data in SquaredUp DS without adding the data to your Data Warehouse.
Running tasks in the tile allows you to show the results of a SCOM task in a tile on a dashboard or perspective. Tasks in the SCOM Task run every time the dashboard refreshes (by default every minute).
What are SCOM tasks?
SCOM tasks are tasks that can be executed for SCOM objects, for example displaying the object's account settings. The tasks in SquaredUp DS are similar to the tasks you find on the tasks pane in the SCOM console.
The results of SCOM tasks can help you to provide additional context or delegate information that usually requires specialist knowledge or privileges, which may help in resolving or understanding an issue. For example, you can use the SCOM Task tile for a CPU alert to list the processes running, or for a security alert to display which users are currently logged on.
Will SCOM tasks run on Open Access dashboards?
SCOM tasks can't be run on Open Access dashboards, because Open Access is unauthenticated. Users will see the error MISSING_SCOM_PERMISSION.
Add a new tile to a dashboard and choose the SCOM Task tile.
Choose the visualization for your SCOM Task tile:
Use the Raw option when the results are returned as text.
Use the Grid option when the returned data is in the form of a table, such as CSV, JSON, PowerShell list or PowerShell Table. The resulting data will then be formatted into columns, which you can edit, hide, reorder etc. See How to use the Grid Designer.
Scope: Here you define the scope for the task. You have to pick one single object for this tile, as here a SCOM task can only be run for one specific object. On a dashboard, you can just search for the object by starting to enter the name of the object into the search box. On a perspective, you have different scope options.
Note: If you never used a perspective, you should read Working with perspectives before scoping tiles on perspectives.
The power of perspectives is that tiles on a perspective can use a dynamic scope. A dynamic scope considers the currently viewed object. A dynamic scope consists of two different states:
the configuration of the scope in the tile (for example, "consider child objects of type logical disk for the currently viewed object")
the actual resolved scope that depends on which object you are currently viewing ("this object has 5 child objects of type logical disk")
After configuring the dynamic scope once in the tile, you'll get different results depending how the scope is resolved on the different objects you are viewing.
This object
The dynamic scope will be the resolved to the object that is currently viewed.
Relative objects
The dynamic scope will be resolved to relative objects (parents or children) of the object that is currently viewed.
At the top, you'll see the name of the object you are currently looking at. Now you can choose if you want to pick parents or children of that object, and if this parent or child relation should be considered only one level up or down the SCOM model or through all levels.
Class: Here you pick the class of the objects you want to select. If you leave this field empty, the scope falls back to the "this object" scope. Note: You will only see groups and classes that the object you are currently looking at is a member of. Tip: If you want to pick objects of any class, enter the SCOM base class logical entity in the class field. Tip: If you want to find out what classes the object you are interested in belongs to, you can go to the Monitored Entity perspective of that object. You'll see all the classes the object belongs to listed there.
Criteria: You can narrow the selection of objects of a particular class down further by entering criteria for those objects. For more help see How to use criteria when scoping objects. Tip: If you want to find out what properties you can base your criteria on, you can go to the Monitored Entity perspective of the object you are interested in. You'll see all the properties for criteria listed there.
.
Note for SCOM task tiles:
You have to pick one single object for SCOM task tiles since the task has to be run for one specific object. If you pick the scope option relative objects, you need to narrow the scope down to one object with the help of a class and criteria.
Other specific objects
Gives you the normal, non-dynamic scope options you are used to when scoping tiles on dashboards. This means the tile will not dynamically adapt it's content to the currently viewed object, it will always show data for the static object picked here.
Since the power of perspectives is that their tiles can show data for different objects depending on what object is currently being viewed, you should only select this option when you are sure that there is no relationship between the desired scope and the currently viewed object.
Task config: Here you choose the task you want to run.
Some tasks let you override parameters, for example the time until the task runs into a timeout. Which parameters are available depends on the task.
Task execution interval: By default tasks run when the dashboard is opened or refreshes. To change this select custom interval and specify a time in minutes. Click apply changes (execute).
Only for Grids: Configure the settings.
Task return format
Task output: A preview of the return data of the task.
Format: You can choose between csv, json, and powershell list or table for displaying your return data. It depends on the data of the task which option you should choose to improve the formatting. For example, if you are running a PowerShell script, you should select powershell table to get the best result.
Skip lines: If you want to skip displaying some lines from the return data you can define this here.
Grid columns
Grid columns opens the grid designer, where you can show or hide columns, change the order of columns, edit column names or add custom columns.
Allows you to turn the graph item(s) into links. You can either enter plain text to create a fixed link (URL always stays the same) or use dynamic properties to create a dynamic link.
Dynamic links make use of dynamic properties which are inserted as part of the URL. This creates a template URL that will be resolved to an actual URL based on the items properties.
For example, if you want to link to tickets in your ticket system and the format of the URL for tickets in your system is https://www.my-system/ticket-123, where 123 is the ticket ID, you can use the dynamic property that contains the ticket ID and enter the dynamic URL https://www.my-system/ticket-{{ticketID}}.
For scalars, you can only use the dynamic property value in dynamic links, which means the link changes when the value of the scalar changes. Since a scalar is just one item, it would also make sense to use a fixed link, for example the link to the website of which you are displaying the response time.
For status icon or bars and the rows of a grid, you usually want to use a dynamic link since you get multiple items or rows that represent different things. You can use any of the dynamic properties the mustache picker offers you.
Dynamic mustache properties and values you need to change according to your instance are highlighted in bold.
You can choose between showing or hiding the header for all columns.
Expand rows automatically
Activate this checkbox if you want the row height to expand automatically based on the row content, for example if your grid uses increased text size, images, emojis etc.
Click done to save the tile.
The tile now shows data according to your settings.
The SCOM Task tile can be used on a dashboard or a perspective. This walkthrough shows you how to add a SCOM Task tile to an existing perspective.
In SquaredUp DS browse or search for a server.
Open the Network perspective.
Click on the edit button at the top right of the screen to go into edit mode.
Click on an orange plus button to add a new tile, and select the SCOM Task tile.
Edit the title by overwriting the placeholder value New tile with your own title.
Click on On-Demand Task (Raw).
Leave the scope section as it is.
In the task config section click on the task to execute drop down list and select IPConfig.
Click apply changes (execute). The task is run and you should see the data returned.
Click done.
Click on an orange plus button to add another new tile, and select the SCOM Task tile.
Edit the title by overwriting the placeholder value New tile with your own title.
Click on On-Demand Task (Grid).
Leave the scope section as it is.
In the task config section click on the task to execute drop down list and select Get Netstat CSV (Data on Demand).
Click apply changes (execute). The task is run and you should see the data returned.
In the task return format leave csv selected.
In the grid columns section you can re-order, rename or even hide columns that you don't wish to see. For more information see How to use the Grid Designer.
The community Data on Demand management pack contains many useful tasks for getting data from your systems. For example, VADA uses the NetStat task from the Data on Demand management pack to get the information about which machines are connected to the server you're interested in.
The Data on Demand management pack is released by SquaredUp (free and open source), and it comes installed with SquaredUp DS as a recommended Discovery Source. You can check its status and if it needs to be updated directly in SquaredUp DS.
Go to the right-hand menu ☰ > System > EAM.
You find the necessary MPs under Core Libraries and the recommended MPs under Discovery Sources. If you're looking for additional Discovery Sources, click the all button in the Discovery Sources section. Note: You'll only find necessary MPs (Core Libraries) and recommended and additional Discovery Sources here. Other MPs (optional MPs) that you have added to the SCOM console won't be displayed on this page. Meaning of the icons:
A green icon indicates that the MP is installed and up to date.
A yellow icon indicates that action is required because an MP is missing or needs an update. Hover over the icon to find out more.
(only for Discovery Sources) A gray icon indicates that VADA would be capable of discovering these objects, but the MP(s) needed for it are not installed.
A blue icon indicates that a 3rd-party MP is out of date, it is not possible for SquaredUp DS to update it automatically with the Import button, but the updated version is available from the 3rd party's website.
If any MPs are missing or need an update, you see an Import button in the section. Clicking the Import button will automatically re-install the missing MPs and update outdated MPs. Note: The Import button is only available for necessary and recommended MPs. Additional Discovery Sources and optional MPs need to be added to the SCOM console manually.
PowerShell monitoring management pack
When the Data on Demand management pack doesn't have a task for your need, you can use the PowerShell Monitoring management pack to author your own task from any existing PowerShell script.
You can download the PowerShell Monitoring management pack here:
The webinar below (30 mins) covers using the SCOM Task tile, including a demo of using the PowerShell Monitoring management pack to display folder disk usage:
For a more in-depth look at the PowerShell Monitoring management pack take a look at the PowerShell Monitoring MP webinar (60 mins):
If the results don't change when you reload the dashboard, the interval for the tile is probably set to a longer time and you are looking at the cached results during the interval time.
The interval enables you to limit how often a task gets executed in SquaredUp DS. For example, you might want to run a task less frequently.
How does the interval affect how often tasks are run in SquaredUp DS?
By default, a task will be executed every time the dashboard refreshes (every minute). If you set the interval to 10 mins, you create a 10 min cache for your task results and your task won't run until the last fetched results are 10 mins old.
The interval is not a schedule, it does not trigger a task execution every 10 mins. Tasks will only be executed when the dashboard is reloaded and the results in the cache are older than the interval (10 mins in this example). The cache is valid for all users, which means if another user opens the same dashboard and the task has been executed 5 mins ago, they see the cached results immediately but have to wait for 5 mins to see fresh results.
Can multiple tiles share the same cache?
SCOM Task (Grid) and SCOM Task (Raw) tiles with the same SCOM task configuration (same SCOM Task, same scope, same overrides, same interval etc.) can share the same cache.
A green icon indicates that the MP is installed and up to date.
A yellow icon indicates that action is required because an MP is missing or needs an update. Hover over the icon to find out more.
(only for Discovery Sources) A gray icon indicates that VADA would be capable of discovering these objects, but the MP(s) needed for it are not installed.
A blue icon indicates that a 3rd-party MP is out of date, it is not possible for SquaredUp DS to update it automatically with the Import button, but the updated version is available from the 3rd party's website.