SCOM Insight – Configuration

From Pendlenet Docs
Revision as of 18:15, 20 November 2018 by Gary (talk | contribs) (Web.config)

Back to SCOM InsightBack to SCOM Insight

Objects on the dashboard

SCOM Insight uses groups in SCOM to determine which objects to present. These groups may be configured as you wish, to either statically or dynamically include whatever objects you would like to present.

In SCOM Insight, the structure is:

Page → Sections on page → Tiles (within sections)

This corresponds, in SCOM, to the this group structure:

Group → Sub-group → Objects to be displayed

For example, the default page's group is SCOM Insight: Default, and it contains sub-groups that define the sections on the page and the tiles that they contain. By default, this looks like:

The default groups

The three groups are:

  1. 1 Distributed Applications, which is dynamically populated with the distributed applications in your management group; and the prefix 1 indicates to SCOM Insight that this is the first section on the page;
  2. 2 Websites, which is dynamically populated with the websites; with the prefix 2, as it's the second section on the page; and
  3. 3 Computers, which contains the computers and is displayed as the third section.

This default set-up looks something like:

SCOM Insight - Demo 2.png

These sub-groups can be fully customised. For example:

  • they can contain any objects you would like to be displayed – simply change their group membership;
  • they can be renamed;
  • their positions can be altered, by changing the numerical prefix (e.g. renaming 2 Websites to 4 Websites);
  • they can be deleted; and
  • groups can be added, which would add sections to the page.

To make any changes, amend the groups in the SCOM console.

All groups must be saved in the SCOM Insight (Views) management pack.

New pages

After configuring the homepage dashboard, you may want to create new pages to display additional objects. For example, you could display websites, grouped by environment, on a second page. To do this, create a new group structure, e.g.:

Environments groups

Populate the four groups, Production, Pre-Production, UAT, and Dev, which will become the new sections on the page, with the objects that you wish to be displayed.

The new page will be accessible at /?group=Environments. For example, if your site is configured as, the new page will be

You may create as many pages as you require.

A custom logo can be added to the dashboard; for example:

SCOM Insight - Tile view with logo.png

To add a logo:

  1. Save the logo, in either JPEG or PNG format, to C:\ProgramData\Pendlenet\SCOM Insight\Custom\Images\.
  2. In the Web.config file (located in C:\Program Files\Pendlenet\SCOM Insight\):
    1. Set CustomLogoFile to the name of your logo file, e.g. Logo.png:
      <add key="CustomLogoFile" value="Logo.png" />
    2. If required, change CustomLogoHorizontalPosition to set the position of the logo. The valid settings are: Left, Centre and Right.
    3. By default, the logo is shown only on the tile view. If you would like it to be displayed on the alerts view as well, set CustomLogoShowOnAlertView to true.


The Web.config file contains the following configurable settings:

Key Description
ScomManagementServer The SCOM management server from which information should be retrieved.
ScomUpdateIntervalSeconds The interval between polls of SCOM. You may reduce this value to provide more frequent updates in SCOM Insight, but it will increase the load on your management server.
PageCycleIntervalSeconds The interval between rotations of the carousel view (/carousel; see How to use).
RootLevelGroupsIncludeRegex A regular expression to determine the top-level SCOM groups that provide the group configuration (see group configuration).
EntitiesExcludeRegex A regular expression to determine the names of objects that are included in the SCOM groups but which are to be excluded from the dashboard, e.g. any object containing the word Deprecated: (?i)Deprecated.
RootLevelGroupDefault The name of the top-level SCOM group that is used to define the homepage configuration (see group configuration).
EntityDisplayNameExcludesSubGroupName Indicates whether the names presented by SCOM Insight for the objects contained in the SCOM groups are to exclude the name of the containing group, if the entity name contains the group name.
For example, if the group is called Production and the contained entities are called Site A Production and Site B Production, and this key is set to true, then the dashboard will show the names of the entities as Site A and Site B.
HideSubGroupNames Specifies whether tile section group names should be hidden on the tile view. This is the heading that appears above a group of tiles.
AlertNameExcludesRegex A regular expression to specify any portion of an alert name that is not to be shown. For example, to exclude Test from an alert with the name Monitor A Test, this key should have the value (Test)$.
Specifies the thresholds for the highlighting of state change alerts on the dashboard. The first threshold is used for the flashing border highlight, and the second for the solid border highlight.
For example, if both thresholds are 600 seconds, a new alert state will cause the tile border to flash for 10 minutes, then be solid for 10 minutes, before returning to normal.
NumberOfTileColumns Controls the standard number of tiles that can be present in a row. If tiles are added, and this value is exceeded for a row, the tiles will wrap on to the next row.
CapitaliseComputerNames Enabled by default, this setting causes computer names to be capitalised across the application, for consistency.
ComputerTilesNameExcludesDomainNamesCSV A comma-separated list of domain names that are not to be shown on the tiles that represent computers/servers. When populated with a list of your internal domains, this property will reduce FQDNs to individual computer names, so that they more easily fit onto tiles.
TileSpecificAlertView Enabled by default, this setting causes clicked-on tiles to load a view of the alerts particular to that tile. The full alerts view can still be accessed via /alerts.
CustomLogoFile This is the filename of a custom logo to be shown at the top of the dashboard. The supported file formats are JPEG and PNG. Save the file in C:\ProgramData\Pendlenet\SCOM Insight\Custom\Images.
CustomLogoScreenWidthPercent Used when CustomLogoFile has been set, this setting specifies the width of the logo in the browser, as a percentage.
CustomLogoHorizontalPosition Used when CustomLogoFile has been set, this setting specifies the horizontal position of the logo, which can be Left, Centre (or Center), or Right.
CustomLogoShowOnAlertView Used when CustomLogoFile has been set and disabled by default, this setting determines whether the logo is displayed on the alerts view.

In addition, the <connectionStrings> section contains the database connection string, which you will need to change if the SCOM Insight database is moved. This key takes the form of standard SQL Server connections strings.

The following are advanced settings that you probably won't have cause to change:

Key Description
ScomConfigurationManagementPackName Specifies the system name of the management pack that contains the SCOM groups used in the configuration of the SCOM Insight (see New pages).
ScomDataIsValidAgeSeconds Specifies the age the information in SCOM Insight's database can reach before being considered stale, after which point, a warning message is displayed on each page. This threshold may be reached if, for example, SCOM is unavailable.
ScomDataStateNoDataValidAgeSeconds Specifies how long must pass before an object's health state is considered valid when it is in the state No Data. This health state occurs when there is no information for the state, e.g. when a distributed application contains no valid objects, or when a distributed application exits maintenance mode. If a distributed application has a state of No Data within this threshold, the previous health state is considered to be the current one. This helps to prevent No Data states being presented to on the dashboard unnecessarily, e.g. when exiting maintenance mode, before the health roll-up calculation has completed, which can take a few minutes.
ScomDataCacheIsValidAgeSeconds Specifies the age at which the SCOM data cache, which is maintained between import cycles, will be cleared and refreshed. The cache is used to temporarily store certain objects and relationships that rarely change, in order to improve the performance of the import process. It isn't usually necessary to alter this value, as the data import process examines the last-changed time of each object and dynamically flushes the cache where appropriate.
ImportBatchDataRetentionAgeDays A minor setting, specifying the length of time that data is retained in the scom.ImportBatch table before being groomed. This does not affect functionality.
AllowPreviousVersionsToImportFromScom Indicates that previous versions of SCOM Insight may be allowed to import data from SCOM. By default, only the current version of the application can import data. This is to ensure that, in a web farm, when an upgrade of the application takes place, an old version can't process an import or write to the database. If, however, a version downgrade takes place, it may become necessary to adjust this parameter.
NumberOfTileColumnsBuffer Defines, relative to NumberOfTileColumns, any additional tiles that may be allowed on a row. This is intended to be used as a buffer, where one row contains additional tiles, but you don't want to affect the width of the tiles in other groups on a page; e.g. on a page that contains two groups of six tiles, and where the first group is to have one tile added, but increasing the standard number of tiles to seven isn't desirable because it would leave a gap in the second group, set this parameter to 1, which would allow seven tiles in the first row of the first group, appropriately sized, and leave the second group unaffected.
AudioNotificationFile Defines the path to the file used when audio notifications are enabled.
TitleCaseCorrectionExceptionsRegex A regular expression to determine the title strings, such as alert titles, that shouldn't automatically be corrected to title case. This includes, for example, short words such as on and in.
NumberOfTilesBeforeStaticGrid Specifies the number of tiles that will be presented before switching to static mode. In static mode, the tiles have a fixed position and can't be moved. This parameter defaults to 100 and is helpful in increasing performance of the view, where a large number of tiles are presented.
SnowInDecember Specifies whether snow is shown in December.
This may be overridden in the browser by the ?mode=scrooge parameter.
SnowInDecemberInKioskMode Specifies whether snow is shown in December when in kiosk mode.
This may be overridden in the browser by the ?mode=scrooge parameter.
CustomLogoMaxWidthAndHeightPixels Used when CustomLogoFile has been set, this setting specifies the maximum size of the logo (in either width or height) that is presented in the browser. This is used to ensure that large images are scaled-down, for efficiency.

Web farm

SCOM Insight can be deployed to a web farm, i.e. to multiple web servers. This approach may be used to provide fault tolerance and/or additional capacity. You may install SCOM Insight to as many web servers as required. The application's nodes will negotiate so that only one connects to the SCOM management server to import data, thereby maintaining the load on your SCOM infrastructure at a constant level.

A single back-end database must be used, although this may be on a SQL Server cluster or in an Always On availability group.

The web garden feature of IIS, where an application pool creates more than one process, is not currently supported.