Configuring Cisco Tetration Analytics Monitoring

Download this manual as a PDF file

Use the following menu options to navigate the SL1 user interface:

  • To view a pop-out list of menu options, click the menu icon ().
  • To view a page containing all of the menu options, click the Advanced menu icon ().

The following sections describe how to configure and discover Cisco Tetration Analytics devices for monitoring by SL1 using the "Cisco: Tetration" PowerPack:

Configuring Cisco Tetration Analytics for Monitoring

Before you can use SL1 to monitor Cisco Tetration Analytics, you must first generate a Tetration Analytics API key and secret password. You will then use this API key and secret password to create a Basic/Snippet credential that enables SL1 to communicate with and monitor Tetration Analytics clusters.

To configure Cisco Tetration Analytics for monitoring:

  1. Log in to the Cisco Tetration Analytics web interface with a site_admin or customer_support account.
  2. Go to Settings > API Keys, and then click Create API Key.

  1. Type a Description and select the checkbox of the appropriate API key capability.

  1. Click Create.

  1. The API key appears. Copy and save the key value.

API keys are visible only to the user that created them.

  1. The secret password appears. Copy and save the password value.

The secret password value appears only once and cannot be recovered. If you forget or lose the password value, you must generate a new API key with a different password value.

Creating a Basic/Snippet Credential for Cisco Tetration Analytics

To monitor Cisco Tetration Analytics in SL1, you must configure a Basic/Snippet credential that SL1 can use to discover and communicate with Tetration Analytics clusters.

The "Cisco: Tetration" PowerPack includes an example credential (Cisco: Tetration - Example) that you can use to create a Basic/Snippet credential for monitoring Tetration Analytics.

NOTE: If you are using an SL1 system prior to version 11.1.0, the new user interface does not include the Duplicate option for sample credential(s). ScienceLogic recommends that you use the classic user interface and the Save As button to create new credentials from sample credentials. This will prevent you from overwriting the sample credential(s).

To configure a credential for Cisco Tetration Analytics:

  1. Go to the Credentials page (Manage > Credentials).
  2. Locate the Cisco: Tetration - Example sample credential, click its Actions icon () and select Duplicate. A copy of the credential, called Cisco: Tetration - Example copy appears.
  3. Click the Actions icon () for the Cisco: Tetration - Example copy credential and select Edit/Test. The Edit Credential modal page appears:

  1. Supply values in the following fields:
  • Credential Name. Type a new name for the credential.
  • Hostname/IP. Type "http://%D".
  • Username. Type the Tetration Analytics API key you previously generated.
  • Password. Type the Tetration Analytics API secret password you previously generated.
  1. Click the Save As button.

If you would like to test your credential using the Credential Tester panel, click Save & Test. For detailed instructions on using the Credential Tester panel, see the Testing a Credential section.

Creating a Basic/Snippet Credential for Cisco Tetration Analytics in the SL1 Classic User Interface

To monitor Cisco Tetration Analytics in SL1, you must configure a Basic/Snippet credential that SL1 can use to discover and communicate with Tetration Analytics clusters.

The "Cisco: Tetration" PowerPack includes an example credential (Cisco: Tetration - Example) that you can use to create a Basic/Snippet credential for monitoring Tetration Analytics.

To configure a credential for Cisco Tetration Analytics:

  1. Go to the Credential Management page (System > Manage > Credentials).
  2. Click the wrench icon () for Cisco: Tetration - Example. The Credential Editor page appears.
  3. Supply values in the following fields:
  • Credential Name. Type a new name for the credential.
  • Hostname/IP. Type "http://%D".
  • Username. Type the Tetration Analytics API key you previously generated.
  • Password. Type the Tetration Analytics API secret password you previously generated.
  1. Click the Save As button.

Discovering Cisco Tetration Analytics Devices

To monitor Cisco Tetration Analytics devices, you must run a discovery session to discover the Tetration Analytics clusters that SL1 will use as the root devices for monitoring the devices.

Several minutes after the discovery session has completed, the Dynamic Applications in the "Cisco: Tetration" PowerPack should automatically align to the cluster root devices and then discover, model, and monitor the remaining component devices.

To discover the Tetration Analytics clusters that you want to monitor:

  1. Go to the Discovery Control Panel page (System > Manage > Classic Discovery or System > Manage > Discovery in the classic user interface).
  2. In the Discovery Control Panel, click the Create button. The Discovery Session Editor page appears.
  3. In the Discovery Session Editor page, define values in the following fields:
  • IP Address/Hostname Discovery List. Enter the IP address(es) or hostname(s) for the cluster root device(s) you want to discover.
  • Other Credentials. Select the Basic/Snippet credential you created for the device clusters.
  • Discover Non-SNMP. Select this checkbox.
  1. Optionally, you can enter values in the other fields on this page. For more information about the other fields on this page, see the Discovery & Credentials section.
  2. Click the Save button to save the discovery session and then close the Discovery Session Editor window.
  3. The discovery session you created appears at the top of the Discovery Control Panel page. Click its lightning-bolt icon () to run the discovery session.
  4. The Discovery Session window appears. When the cluster root device(s) are discovered, you can click the device icon () to view the Device Properties page for each device.

Viewing Cisco Tetration Analytics Component Devices

In addition to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface), you can view Cisco Tetration Analytics component devices in the following places in the user interface:

  • The Device View modal page (click the bar-graph icon [] for a device, then click the Topology tab) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-clicking any of the devices listed reloads the page to make the selected device the primary device.

  • The Device Components page (Devices > Device Components) displays a list of all root devices and component devices discovered by SL1 in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the Tetration Analytics component devices, find the Tetration Analytics cluster device and click its plus icon (+):

  • The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map, go to the Component Map page and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Views.