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" 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 a "Cisco: Tetration - Example" sample credential 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 create and run a discovery session that will discover a Cisco Tetration device:

  1. Go to the Devices page () or the Discovery Session page (Devices > Discovery Sessions) and click the Add Devices button.
  2. Click the Unguided Network Discovery Workflow button. Additional information about that requirements for discovery appears in the General Information pane to the right.

    3. Unguided Network Discovery Workflow

  3. Click Select. The Add Devices page appears.
  4. Complete the following fields:
  • Discovery Session Name. Type a unique name for this discovery session. This name is displayed in the list of discovery sessions on the Discovery Session tab.
  • Description.Optional. Type a short description of the discovery session. You can use the test in this description to search for the discovery session on the Discovery Session tab.
  • Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices.
  1. Click Next. The Credentials page of the Add Devices wizard appears.
  2. On the Credentials page, locate and select the Basic/Snippet credential you created for Cisco Tetration appliances.
  3. Click Next. The Discovery Sessionpage of the Add Devices wizard appears.
  4. Complete the following fields:
  • List of IP/Hostnames. Type the IP address for the Cisco Tetration appliance.
  • Which collector will monitor these devices?. Required. Select an existing collector to monitor the discovered devices.
  • Run after save. Select this option to run this discovery session as soon as you save the session.
  • Advanced options. Click the down arrow () to complete the following fields:
    • Discover Non-SNMP. Enable this setting.
    • Model Devices. Enable this setting.
    • Select Device Template. If you configured a Cisco Tetration device template, select it here. Otherwise, leave the default selection.
  1. If you enabled the Run after save option, click the Save and Run button. The discovery session will run and the Discovery Logs page will display any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page will include a link to the Device Investigator page for the discovered device.
  2. If you did not enable the Run after save option, click the Save and Close button. The Discovery Session page (Devices > Discovery Sessions) will display the new discovery session.

Discovering Cisco Tetration Analytics Devices in the SL1 Classic User Interface

To monitor Cisco Tetration Analytics devices in the classic user interface, 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 in the classic user interface:

  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.