This article only applies to Squared Up Version 2.0. If you're looking for help with Squared Up Version 3.0, please visit our new knowledge base

Overview

This article explains how to find the SCOM IDs when configuring a KPI section as described in How to configure a KPI section using the Dashboard Designer


A KPI section is made up of two elements, a health state (a monitor), and a chart (a performanceRule):


These elements are identified by a SCOM ID. Different OS versions can have different SCOM IDs for similar hosted component types, because they are provided by different management packs.

How to use Squared Up to find these SCOM IDs

It is important that the monitor and object both target the same object.  By browsing Squared Up and locating both the monitorId and ruleId on the same page you can be sure they target the same object.


1. In Squared Up browse to a server, e.g. server1

2. Click 'show all' on the right next to 'Hosted Components':

3. Locate the performance graph you are interested in:

Only favourite metrics are shown in the 'Hosted Components'. If the performance graph you are interested in is not shown you may just know the object you targeting when creating the rule, or see similar metrics and then see the metric you want at the next step after clicking on the right target/hosted component. Favourite metrics can be set clicking the star next to the metric from the server 'View Performance' page.

4. Click on the relevant hosted component, for example to go to the Microsoft Windows Server 2008 R2 Datacenter page:


5. Under the heading 'Health state', click 'show all monitors' and identify the monitor you are interested in:

Make sure the monitor is in use (i.e. green or red) and not 'not in use' 

6. Click on the monitor. Copy the monitorId shown in the resulting url, e.g monitorId=<SCOM ID> for example:

http://localhost/SquaredUpv2/config/monitor?monitorId=2f9b40b7-f6ae-9dbe-862a-2a102fe12fbc

7. Click back one page, for example to go to the Microsoft Windows Server 2008 R2 Datacenter page. This must be the same page where you clicked 'show all monitors' and clicked on the monitor.

8. Look in the 'Performance' section for the graph you need:


9. In the Performance section click on the graph (rule) you are interested in. Copy the ruleId shown in the resulting url, e.g ruleId=<SCOM ID> for example: 


http://localhost/SquaredUpv2/performance/graph?objectId=8555e1b8-a4c8-0a93-ae04-6e6265334cd7&ruleId=ce3533de-d58c-a1fd-ce0c-f00cd2ed84a2&timeframe=Last12Hours


Create and Configure the KPI Section

With these two SCOM IDs (monitor and rule), please follow the procedure in How to configure a KPI section using the Dashboard Designer to configure a KPI section with these two SCOM IDs.


For example:


[

{

                      "displayName": "Memory",

                      "comment": "Memory for Windows Server 2008 / 2008 R2 Full Operating System",

                      "monitor": "2f9b40b7-f6ae-9dbe-862a-2a102fe12fbc",

                      "performanceRule": "ce3533de-d58c-a1fd-ce0c-f00cd2ed84a2",

                      "performanceLabel": "%"

                      }

]


Add a KPI section to the existing JSON script

If you find that a new Management Pack has added monitors or rules for particular objects you may need to add an additional section to your KPI JSON script, using a comma as shown below.  It is better to add a section than change existing sections which might already be in use for some objects.

  

[
                      {

                      "displayName": "Memory",

                      "comment": "Memory for Windows Server 2012 / 2012 R2 Full Operating System",

                      "monitor": "941a0f86-e0da-6cd2-5676-fef32dcc191b",

                      "performanceRule": "4a2efcfb-6edb-b222-ed26-cda636795502",

                      "performanceLabel": "%"

                      },

                      {

                      "displayName": "Memory",

                      "comment": "Additional Memory section for Windows Server 2008 / 2008 R2 Full Operating System, added by CA 23/3/16",

                      "monitor": "2f9b40b7-f6ae-9dbe-862a-2a102fe12fbc",

                      "performanceRule": "ce3533de-d58c-a1fd-ce0c-f00cd2ed84a2",

                      "performanceLabel": "%"

                      }
]

  


For the KPI information to be shown, the monitor and rule must target the same object, in this example 'Microsoft Windows Server 2008 R2 Datacenter'. If both the monitor and the rule appear on the same page under 'Health State' and 'Performance' (not Hosted Components) respectively, then they target the same object:


See also:

Troubleshooting KPI dashboards

How to configure a KPI section using the Dashboard Designer