Overview

LogicMonitor offers out-of-the-box monitoring for the VMware VeloCloud platform. Our monitoring suite uses the VeloCloud Orchestrator API and SNMP to query the VeloCloud resource for a wide variety of health and performance metrics.

Compatibility

As of October 2020, LogicMonitor’s VMware VeloCloud package is known to be compatible with VeloCloud Orchestrator API:

  • Version 3.2.2 through version 4.0.0

As VMware releases newer versions of VeloCloud Orchestrator API, LogicMonitor will test and extend coverage as necessary.

Setup Requirements

Add Resources Into Monitoring

Add your VMware VeloCloud Orchestrator host into monitoring. The resource hostname is used to build URLs for API queries and should be formatted vcoX.velocloud.net to match the device’s respective portal in VeloCloud. For more information on adding resources into monitoring, see Adding Devices.

Obtain Credentials

LogicMonitor must provide the appropriate credentials in order to successfully access the VeloCloud resource’s data. These credentials must belong to an enterprise user account in VeloCloud that has been assigned the following minimum privileges:

Role Description
Read-only for edge and enterprise The VeloCloud Orchestrator API Programmer’s Guide allows for custom roles to be created as a composition of privileges.

Assign Properties to Resources

The following custom properties must be set on the VMware VeloCloud resource within LogicMonitor. For more information on setting properties, see Resource and Instance Properties.

Property Value
velo.user REST API username
velo.pass REST API password
Various SNMP credentials

(the properties required to establish SNMP credentials vary)
Only required for the VeloCloud System Stats DataSource. The properties required to establish SNMP credentials vary depending on the SNMP version being used. See Defining Authentication Credentials for details.
system.categories A value of “VeloCloudAPI” will be automatically added by the addCategory_VeloCloudAPI PropertySource

Import LogicModules

From the LogicMonitor public repository, import all VMware VeloCloud 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

Automated Instance Grouping

DataSources in this suite assign instance-level properties that can be used for instance grouping if desired. By default, these DataSources are not set to automatically create instance level groups during Active Discovery, but the following table highlights a few common instance-level grouping options that you can implement if desired.

Group By Instance Level Property
Edge name auto.velocloud.edgename
ISP auto.velocloud.isp
Interface auto.velocloud.interface

For more information on updating DataSource configurations for the purpose of enabling automated instance grouping, see Instance Groups.

Automated Instance Deletion

By default, the DataSources in this suite are not set to auto delete instances so that users can maintain historical data for SLA purposes. However, if this is not your preference, you can update this Active Discovery setting to automatically remove edges and links that are no longer active, as outlined in What Is Active Discovery?.

Troubleshooting

The modules in this package are designed with a debug mode embedded in the scripts. If issues occur, turn on debug mode in the script by setting the variable debug to “true” to get more information in the output when testing the script in the Collector Debug Facility. For more information on testing scripts in the Collector Debug Facility, see Script Troubleshooting.

LogicModules in Package

LogicMonitor’s package for VMware VeloCloud 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_VeloCloudAPI PropertySource Checks that credentials for VeloCloud Orchestrator API are present and working and assigns a value of “VeloCloudAPI” to the system.categories property.
VeloCloud Edge Health DataSource Reports health of individual edges.
VeloCloud Edge Link Health DataSource Reports health of individual links grouped by edge.
VeloCloud Edge Link Metrics DataSource Reports link network utilization metrics for all active links; a link is considered to be active if an edge has reported any activity for it in the last 24 hours.
VeloCloud Edge Link Event Quality DataSource Reports link quality scores for voice, video, and transactional events as well as metrics.
VeloCloud System Stats DataSource Gathers CPU and memory utilization metrics for VeloCloud edges via SNMP.

The DataSources in this package do not include predefined datapoint thresholds (that is, no alerts will trigger based on collected data). This is because the technology owner has not provided KPIs that can be reliably extended to the majority of users. If you’d like to receive alerts for collected data, you’ll need to manually create custom thresholds, as discussed in Tuning Static Thresholds for Datapoints.

In this Article: