Cisco Intersight Monitoring

Overview

LogicMonitor offers built-in monitoring coverage for Cisco Intersight and, along with it, additional Cisco HyperFlex monitoring. Specifically, the Cisco Intersight monitoring package focuses on alarms, security advisories, and licenses, while also offering insight into the unique features for HyperFlex clusters (such as capacity runway estimation) that Intersight enables.

Cisco Intersight’s REST API is used extensively by this package. For more information on this API, refer to Cisco Intersight RESTful API.

Compatibility

As of August 2020, LogicMonitor’s Cisco Intersight package is known to be compatible with:

• Version 1 of the Intersight REST API

Setup Requirements

Satisfy Dependencies

• Requires LogicMonitor Collector version 28.606 or higher as this monitoring package harnesses modern authentication protocols included in this version.
• The LogicMonitor Collector must be allowed to access https://{ACCOUNTID}.intersight.com.
• Cisco Intersight must be running under an Essentials tier license or greater.

Add Resources Into Monitoring

Add an Intersight host into monitoring. Since this is a service and there is no physical resource to add into monitoring, you’ll need to manually create a new resource. Name your resource using the URL of the Intersight service (for example, https://{ACCOUNTID}.intersight.com). For more information on manually adding resources into monitoring, see Adding Devices.

Obtain Credentials

LogicMonitor must provide the appropriate credentials in order to successfully access the Intersight API’s data. These credentials must belong to an Essentials or higher licensed Intersight portal and consist of API key data.

An API key must be created and downloaded from https://intersight.com/an/settings/api-keys/. This API key ID (and secret) must then be entered as properties on the resource in LogicMonitor, as discussed in the next section.

Assign Properties to Resources

The following custom properties must be set on the Cisco ISE resource within LogicMonitor. You have the option of providing the API key secret via a reference to a file or as text, depending on your security requirements.

For more information on setting properties on resources in LogicMonitor, see Resource and Instance Properties.

Property	Value
cisco.intersight.account.id	The account ID that is available from the Settings|Account Details page within the Intersight UI.
cisco.intersight.key.id	The API key ID obtained in the above section.
cisco.intersight.secret.location	The location of the API key file on disk (for example ../keys/intersight.txt). This property is not required if the cisco.intersight.secret.key property is set.
cisco.intersight.secret.key	The full text contents of the exported API key file. This property is not required if the cisco.intersight.secret.location property is set.
system.categories	CiscoIntersight (this value should be automatically added by the addCategory_CiscoIntersight PropertySource, but can be manually added if necessary).

Import LogicModules

From the LogicMonitor public repository, import all Cisco Intersight LogicModules, which are listed in the LogicModules in Package section of this support article. If these LogicModules are already present, ensure you have the most recent versions.

Once the LogicModules are imported (assuming all previous setup requirements have been met), data collection will automatically commence.​

Considerations/Warnings

Expiration of the Intersight Essentials license will prevent API access to report on further issues—including issues related to license expirations. The Intersight package warns of expiration (14 days and 7 days in advance), but once the license expires, LogicMonitor is limited on what it can offer in terms of automated diagnostics.

Troubleshooting

Consistent HTTP failures during Active Discovery or data collection, which can be seen using the Test Script buttons that are available in the DataSource definition, usually hint at a firewall or DNS issue. Try and confirm that the Collector assigned to the Intersight resource can access the Intersight portal for your account before contacting support.

LogicModules in Package

LogicMonitor’s package for Cisco Intersight consists of the following LogicModules. For full coverage, ensure that all of these LogicModules are imported into your LogicMonitor platform.

Display Name	Type	Description
addCategory_CiscoIntersight	PropertySource	Identifies if the resource is a Cisco Intersight resource and assigns the value of “CiscoIntersight” to the system.categories property.
Cisco Intersight Licenses	DataSource	License information and expiry times for Cisco Intersight.
Cisco Intersight Hyperflex Clusters	DataSource	Cluster information for HyperFlex on Cisco Intersight. Includes Intersight metrics like capacity runway.
Cisco Intersight Hyperflex Alarms	Eventsource	Returns HyperFlex alarms for Cisco Intersight.
Cisco Intersight Security Advisories	Eventsource	Returns all security adversities for Cisco Intersight.

When setting static datapoint thresholds on the various metrics tracked by this package’s DataSources, LogicMonitor follows the technology owner’s best practice KPI recommendations. If necessary, we encourage you to adjust these predefined thresholds to meet the unique needs of your environment. For more information on tuning datapoint thresholds, see Tuning Static Thresholds for Datapoints.