Overview

Cisco HyperFlex is a hyper-converged infrastructure platform. With LogicMonitor’s Cisco HyperFlex package, which leverages the Cisco HyperFlex REST API, you can monitor a large number of HyperFlex operations, as outlined in the LogicModules in Package section of this support article.

Compatibility

LogicMonitor’s Cisco HyperFlex package is compatible with all Cisco HyperFlex products/services that comply with the following prerequisites:

  • At minimum, version 2.5 of the HyperFlex Data Platform is required (LogicMonitor has verified compatibility through version 4.0, but it is likely that later versions are also compatible; contact us if you have any questions about a particular version’s coverage)
  • Valid credentials for HyperFlex Connect
  • HyperFlex Connect or Cluster Management IP address is required

Setup Requirements

Add Devices Into Monitoring

Add your Cisco HyperFlex resources into monitoring if they have not yet been added. For more information on adding resources into monitoring, see Adding Devices.

Obtain API Credentials and Store as Custom Properties

To use the HyperFlex REST APIs, you must first authenticate an API client and obtain a valid access token. Steps to authenticate and obtain a valid access token, and to manage the lifecycle of access tokens (refresh, validate and revoke) can be found in the Cisco HyperFlex REST API Getting Started Guide.

LogicMonitor must be able to provide these API credentials in order to successfully access the resource. Once a Cisco HyperFlex API client and token (password) are established, the following properties must be set on the Cisco HyperFlex resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.

Property

Description

esx.user Cisco HyperFlex REST API username
esx.pass Cisco HyperFlex REST API password

Import LogicModules

From the LogicMonitor repository, import all Cisco HyperFlex LogicModules, which are listed in the LogicModules in Package section of this support article. Once the LogicModules are imported, the addCategory_CiscoHyperFlex PropertySource will assign “CiscoHyperFlex” as a value to the system.categories property for all applicable devices and the suite of Cisco HyperFlex DataSources will automatically begin collecting data.

Troubleshooting

DataSources will print error messages to the console when present. These errors can be seen in the output when manually polling data (from the Raw Data tab that displays from the Resources page for each DataSource). DataSources are designed to handle errors gracefully and will attempt to grab any available data even when errors occur.

LogicModules in Package

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

Display Name

Type

Description

addCategory_CiscoHyperFlex PropertySource Discovers Cisco HyperFlex hosts and adds a system category of “CiscoHyperFlex”.
Cisco_HyperFlex_Info PropertySource Collects various details of Cisco HyperFlex host metadata.
Uptime DataSource DataSource provides information regarding Cisco HyperFlex device uptime. Displays uptime/downtime in seconds.
Status DataSource DataSource provides information regarding Cisco HyperFlex device operational and storage platform resiliency status.
Hypervisor Controller VMS DataSource DataSource determines metrics regarding Cisco HyperFlex Hypervisor Controller Virtual Machines. Data includes the state and role of the Virtual Machine as well as the memory and disks available.
Hypervisor VMS DataSource DataSource determines metrics for Cisco HyperFlex Hypervisor Virtual Machines. Data includes the state of the Virtual Machine and the Guest OS, the overall available and consumed storage, and an indicator if the Virtual Machine was created via a template.
Nodes DataSource DataSource monitors relevant metrics for Cisco HyperFlex Nodes. Data includes various node states and a count of disks associated with the node.
Jobs DataSource Displays each recent job discovered on the Cisco HyperFlex device. Metrics include the job’s status, elapse time, overall step status, and associated categories.
Hypervisor Hosts DataSource Determines the health of Cisco HyperFlex Hypervisor Hosts. Data includes the host status, role, and lockdown mode.
Hypervisor Disks DataSource DataSource displays information regarding Cisco HyperFlex Hypervisor Disks including status, type, and capacity.
Statistics DataSource DataSource provides information regarding Cisco HyperFlex device operational and storage platform resiliency status.
Health DataSource DataSource provides information and data regarding Cisco HyperFlex device health status and ability of the HX storage cluster to tolerate failures.
Events DataSource DataSource provides information regarding Cisco HyperFlex cluster events, including category and severity counts.
Disks DataSource DataSource provides information about all disks in a specific Cluster ID. Monitored data includes the disk type, usage, state, total/used storage, and blacklist count.
Details DataSource Reports details associated with this cluster. Information includes the cluster type, zone, number of nodes on or offline, access policy, all-flash, and auto-healing.
Datastores DataSource DataSource collects information on Cisco HyperFlex Datastores including details regarding statuses, accessibility, capacity, and mirrors.
Capability DataSource DataSource provides information regarding cluster encryption and replication support.

When setting static datapoint thresholds on the various metrics tracked by this package, 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.

In this Article: