Cisco: Meraki [API] PowerPack PowerPack Release Notes, version 108

Version 108 of the Cisco: Meraki [API] PowerPack has been updated to use API-based polling, and includes updates to several Dynamic Applications and addresses a number of issues.

  • Minimum Required SL1 Version: 8.14.0

Before You Install or Upgrade

Ensure that you are running version 8.14.0 or later of SL1 before installing Cisco: Meraki [API] version 108.

For details on upgrading SL1, see the appropriate Release Notes.

Installing or Upgrading the PowerPack

To install or upgrade to Version 108 of the Cisco: Meraki [API] PowerPack, perform the following steps:

IMPORTANT: When upgrading to the Cisco: Meraki [API] PowerPack version 108, customers that have the version 107 Limited Availability release will need to perform the following steps for collection to work:

  1. Locate the Cisco Meraki physical device and click its bar graph icon ().
  2. In the Device Summary page, click the Events tab.
  3. Locate all the events labeled "Cisco: Meraki Cloud Controller discovered as a component of organization...", select their checkbox(es) and click the Del button to delete the events.
  4. After the events are deleted, the "Cisco: Meraki Cloud Controller Creation" run book action will run automatically and collection will work.
  1. Familiarize yourself with the Known Issues for this release.
  1. If you have not done so already, upgrade your system to the Minimum Required SL1 Version: 8.14.0 or later release.
  2. If you are upgrading a version of the PowerPack earlier than version 106, ScienceLogic does not guarantee the success of the upgrade.
  1. Download Version 108 of the Cisco: Meraki [API] PowerPack from the Support Site to a local computer.
  2. Go to the PowerPack Manager page (System > Manage > PowerPacks). Click the Actions menu and choose Import PowerPack. When prompted, import Version 108 of the Cisco: Meraki [API] PowerPack.
  3. After importing the PowerPack, you will be prompted to install the PowerPack. Click the Install button to install the PowerPack.

After installing the PowerPack, you must disable the "Data Collection: Async Dynamic App Collection" process prior to discovering your Meraki system. If you later decide to delete all Meraki devices and re-enable this process on your ScienceLogic system, you must first log in to the ScienceLogic Database Server or Data Collector to delete any asynchronous processes that are already queued up. Failing to do so can cause the system to stop all collections. For more information, see the Monitoring Cisco Meraki (API) manual.

After upgrading the PowerPack, it is recommended to delete all SNMP Dynamic Applications as SNMP items in the PowerPack have been removed or disabled.

Features

Version 108 of the Cisco: Meraki [API]  PowerPack includes the following features:

  • Dynamic Applications to discover and monitor Cisco Meraki devices

  • Device Classes for each type of Meraki component device SL1 monitors
  • Event Policies that are triggered when Meraki component devices meet certain status criteria

  • Sample Credentials for discovering Cisco Meraki devices:
  • A SOAP/XML Credential for users who connect to the Meraki API through a third-party proxy server
  • A SOAP/XML Credential for users who want to discover only select devices
  • A Basic/Snippet Credential for users who do not fall into either of the two above categories

  • Run Book Action and Automation policies that perform the following actions:
  • Create a Meraki Cloud Controller virtual device during discovery
  • Vanish devices and child devices

The PowerPack includes some Event Policies that can generate events in SL1 based on emails SL1 receives from Cisco Meraki. To enable SL1 to generate these events from email, you must first configure your Meraki devices to send email to SL1 using certain formatting rules. You must then configure SL1 to generate events from the inbound Meraki emails. For instructions, see the Monitoring Cisco Meraki (API) manual.

The email Event Policies included in the PowerPack each have an expiry delay setting that specifies the amount of time after which an active event is automatically cleared from SL1 if the event has not reoccurred. However, SL1 clearing an event for reaching its expiry delay setting does not mean that the initial condition that caused the event has been resolved.

Enhancements and Issues Addressed

The following enhancements and addressed issues are included in version 108 of the Cisco: Meraki [API] PowerPack:

  • The PowerPack has been updated to use API-based polling. SNMP items in the PowerPack have been removed or disabled. Customers upgrading are encouraged to delete all SNMP elements from this PowerPack as they may be forcibly removed in the future.
  • Support for pagination of API responses was added to the PowerPack. Collections such as device discovery are no longer limited to the number of objects returned in a single page of Meraki API responses.
  • All event policies in the PowerPack were updated to use API-based Dynamic Applications.
  • All Dynamic Applications in the PowerPack now have the Collector Affinity set to Root device collector by default.
  • The "Cisco: Meraki Interface Performance [API]" Dynamic Application was removed from the PowerPack.
  • SNMP collection objects have been removed from the "Cisco: Meraki Device Configuration [API]" Dynamic Application.
  • Support was added to the SOAP/XML credential to connect to a proxy using http or https protocol. (Case: 00188477)
  • The following Run Book Actions were removed from the PowerPack:
  • Cisco: Meraki Cred Lookup
  • Cisco: Meraki Cred Write
  • Cisco: Meraki SNMP Cred Lookup
  • The following event policies were added to the PowerPack:
  •  Meraki API exceeded the rate limit
  • Meraki API did not return retry header
  • The "Cisco: Meraki [API] (Basic/Snippet) Credential tester" and "Cisco: Meraki [API] (SOAP/XML) Credential tester" credential tests were added to the PowerPack.
  • The "Cisco: Meraki SNMPv3 Update" Run Book Policy was removed from the PowerPack.
  • The "Cisco: Meraki [API] Network Uplink Loss below threshold" alert and "Cisco: Meraki [API] Network Uplink Loss below threshold" event policy were added to the "Cisco: Meraki Uplink Performance [API]" Dynamic Application.
  • The following collection objects were added to the "Cisco: Meraki Device Configuration [API]" Dynamic Application:
  • Firmware
  • Using Cellular Failover
  • WAN 1 IP
  • WAN 2 IP
  • The following alerts were added to the "Cisco: Meraki Device Configuration [API]" Dynamic Application:
  • Cisco: Meraki Cellular Failover Enabled
  • Cisco: Meraki Cellular Failover No Longer Enabled
  • A new icon was added to the device classes in the PowerPack.
  • The "Cisco: Meraki Device Offline" alert object was renamed to "Cisco: Meraki Device Status Changed" in the "Cisco: Meraki Device Configuration [API]" Dynamic Application.
  • The "Meraki Cellular Gateway Network" device class was added to the PowerPack.
  • The poll frequency of the "Cisco: Meraki Request Manager [API]" Dynamic Application was increased from 1 minute to 5 minutes.
  • The "Cisco: Meraki Network Discovery [API]" Dynamic Application was updated to address issues with selective discovery.
  • The "Cisco: Meraki Cloud Controller Creation [API]" Dynamic Application was updated to address an issue in which Run Book Actions were not executing in version 106 of the PowerPack.
  • The "Cisco: Meraki Uplink Performance [API]" Dynamic Application was updated to not trigger an alert for uplinks with a null value.
  • The "Cisco: Meraki Uplink Performance [API]" Dynamic Application was updated to display the uplink name and the serial number to support networks with two uplink devices.
  • An issue was addressed in the "Cisco: Meraki Component Counts [API]" Dynamic Application in which it would not collect data for networks that did not have child devices.

Known Issues

The following known issues affect version 108 of the Cisco: Meraki [API] PowerPack:

  • If a device's model name shares the same first 5 characters as another device, that device will be assigned the same device class.
  • The Meraki API may not always send a "retry header". If this occurs the PowerPack does not retry the API call which will result in a gap in data when it occurs. This will be addressed in a future version of the PowerPack.
  • If a Cisco Meraki device name includes a special character, the device name will appear in hexadecimal values in the Device Components page.
  • The Meraki Cloud Controller will not be modeled after discovery if the Meraki organization has an apostrophe in its name.
  • Due to a limitation in the number of requests that Meraki can handle per second, data collection gaps might occur when monitoring larger scale systems.
  • Because there is no way to tag organizations, the PowerPack has no way of filtering out particular organizations during discovery. Therefore, the PowerPack will discover every organization that the API key returns.