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):
You can run tasks directly from a dashboard or perspective just by clicking a button. Tasks that are executed via a button only run when the button is clicked.
On perspectives, you can run any task that is available for that object with the task button at the top of the perspective.
Go to the object you want to run the task for and choose any of the available perspectives.
Click on the task button at the top of the perspective. Now a dropdown menu with all available tasks opens.
Choose the task you want to run from the dropdown menu.
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.
If you want to override parameters for the task, click add under override parameters and enter your settings.
Click execute to run the task. A new sections opens and displays the result of the task. The results are visible until you close the section or leave the page.
On dashboards and perspectives, you can create an action button for a specific task.
Action buttons are customized buttons that you can add at the top of a dashboard or perspective.
For dashboards: Go to the dashboard where you want to add the action button. For perspectives: If you want to add the action button to a specific perspective, go to an object that contains the perspective and choose this perspective. If you want to add the action button to all perspectives of a specific class of objects, go to an object that is a member of this class.
Click on the edit button to go into edit mode.
Click on the Edit actions button.
Under Actions, click on the add button.
Enter a name for your new action button.
Select the type of action you want to create:
Open an internal link An internal link within your SquaredUp DS instance. For example, when you want to link from an object's perspective to a dashboard that is relevant for that object.Internal links use only the part of the URL that comes after .../SquaredUpv[version number]/. For example, if the full URL to a dashboard is https://mysquaredup.com/SquaredUp/page/dashboard-enterprise-applications, you need to use /page/dashboard-enterprise-applications.
Open a web link A link to any URL. For example, when you have a dashboard for monitoring a website or application, you can add a link to that website or application. Web links have to include the http:// or https:// prefix. These links will open in a new tab by default.
Execute a SCOM task You can run a SCOM task on an object.
If you selected the action type "task": For dashboards: Enter the object you want to run the task on. While you are typing, you'll get suggestions for matching objects. Then select the task you want to run from the dropdown.
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.
For perspectives: Select the task you want to run for the object you are currently viewing.
Take care to add task buttons to a relevant perspective so the button doesn't appear for objects where it will not run. For example, if you add the Display Server Statistics task to a button on the Monitored Entity perspective then it will show for all objects, but when if you try to run it when you are viewing an application you will get a task failed error message because server statistics cannot be shown for an application.
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.
Only for perspectives: Decide when the action button will be shown. "only show when this perspective is selected": If you leave the checkbox activated, the action button will be visible only on this one perspective. If you deactivate the checkbox, the action button will be visible on all perspectives for all objects of the same class as the object you are currently viewing.
Click done to save the action button.
You can add more buttons or click done to finish adding buttons.
Click publish to make the changes live. You can now see your newly added action button. For task action buttons: All users with the correct SCOM access will be able to run the task with the action button. Clicking the button will display the results of the task at the top of the page. The results stay there until you close them or go to another page.
5 minute Video
This 5 minute video 'Dashboard actions' describes how to create and edit actions on a dashboard or perspective:
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.
