Virtual Devices

This section describes how to create and use virtual devices in SL1.

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 ().

What is a Virtual Device?

A virtual device is a container for collected data. A virtual device can be used when you want to:

• Monitor a device or application that doesn't support TCP/IP, SNMP, or both. The device's data can be pushed to SL1 via another method (for example, email) and stored in a virtual device.
• Monitor multiple SNMP agents on a single device. In such a case, one of the SNMP agents (for example, a hardware agent) can be associated with the device and another SNMP agent (for example, an agent that monitors a software application) can be associated with a virtual device.
• Isolate and monitor specific parameters separately from their originating device. For example, you might want to monitor a database and keep its data separate from the hardware data you are collecting from the host device.

Defining a Virtual Device

Before you create a virtual device, you must ensure that SL1 includes a device class for virtual devices. These device classes must have a device category of "virtual" and a collection type of "virtual". If SL1 does not include such a device class, you must define one on the Device Class Editor page (System > Customize > Device Classes).

1. • Device Name. Enter the name of the virtual device. This name can be any combination of alphanumeric characters, up to 32 characters in length. 

   • Organization. Select the organization you want to associate with the virtual device.

   • Device Class. Select the device class you want to associate with the virtual device. Only device classes with a collection type of "virtual" appear in the list.

   • Collector Group. Select the collector group to which you want to assign the virtual device.

2. Click Create.

Creating a Virtual Device from the Device Manager Page

To create a virtual device from the Device Manager page:

3. Go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).
4. Click the Actions menu and then select Create Virtual Device. The Create Virtual Device modal appears.
5. Supply a value in each of the following fields:

• Device Name. Name of the virtual device. Can be any combination of alphanumeric characters, up to 32 characters in length. 
• Organization. Organization to associate with the virtual device. Select from the drop-down list of all organizations in SL1.
• Device Class. The device class to associate with the virtual device. Select from the drop-down list of device classes. Only device classes with a device category of "virtual" and a collection type of "virtual" appear in the list.
• Collector. Specifies which instance of SL1 will perform auto-discovery and gather data from the device. Can also specify a "virtual" poller. Select from the drop-down list of all collectors in SL1.

6. Click Add.

Directing Data to a Virtual Device

After defining a virtual device, you must tell SL1 which data to store in the virtual device.

• For data that is pushed to SL1, you can define the log data that you want to collect and redirect to the virtual device.
• For data that is collected via SNMP or TCP/IP, you can manually associate a Dynamic Application with the device to ensure that data collected by the Dynamic Application is stored in the virtual device.

Redirecting Log Data to a Virtual Device

SL1 enables you to redirect log entries from one IP-based device to another IP-based device, or from an IP-based device to a virtual device.

This is perhaps most useful for devices that do not support TCP/IP. Using a redirect, SL1 can push data from a device that does not support TCP/IP to another device that does, and then collect the data from the device that does support TCP/IP.

In this scenario, you can create a virtual device in SL1 to represent the device that does not support TCP/IP. You can then move the data from the TCP/IP device that is monitored by SL1 to the virtual device in SL1.

The Redirects tab of the Device Investigator (or the Redirect Policy Editor page in the Device Administration panel) allows you to move data and log entries generated by inbound SNMP trap, syslog, or email messages from the TCP/IP device to the virtual device.

To redirect data from one IP-based device to another IP-based device or a virtual device:

1. From the Devices page, click the name of the virtual or IP-based device to which you want to redirect data to open the Device Investigator for that device, and then click the Redirects tab.

   Alternatively, you can do this in the classic SL1 user interface by going to the Redirect Policy Editor page in the Device Administration panel. To do so, go to the Device Manager page Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface), find the device to which you want to direct data, click its wrench icon (), and then click the Redirects tab.

2. To move SNMP trap, syslog, or email log messages from an IP-based device to the current device, provide values in each of the following fields:

   • Source Device. This is the TCP/IP device from which you want to redirect log messages. Data from this device will be moved to the current device. Select from a drop-down list of all IP-based devices discovered by SL1.

   • Expression Match. A regular expression used to locate the log entry to redirect. This can be any combination of alphanumeric and multi-byte characters, up to 64 characters in length. SL1's expression matching is case-sensitive. For details on the regular-expression syntax allowed by SL1, see http://www.python.org/doc/howto/ .

   • Active State. Specifies whether or not SL1 will execute the redirection policy. The choices are:

     • Enable. SL1 will execute the redirection policy.

     • Disable. SL1 will not execute the redirection policy.

3. Click Save.
4. You can repeat steps 2 and 3 to redirect data from more than one device or from more than one type of log message.

Aligning a Dynamic Application with a Virtual Device

You can associate data that is collected by a Dynamic Application with a virtual device. Any data collected by the Dynamic Application will be stored in the virtual device.

You cannot align SNMP Dynamic Applications with a virtual device. You can align all other types of Dynamic Applications with a virtual device.

Aligning a Dynamic Application with a Virtual Device from the Device Administration Panel

To align a Dynamic Application with a device from the Device Administration panel:

1. Go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).
2. Find the device you want to associate with a Dynamic Application and then click its wrench icon (). The Device Administration panel appears.
3. In the Device Administration panel, click the Collections tab.
4. In the Dynamic Application Collections page, click the [Action] menu and select Add Dynamic Application.
5. The Dynamic Application Alignment modal page appears.
6. To associate an additional Dynamic Application with the device, highlight it in the Dynamic Applications field. You can filter the list of Dynamic Applications using the search field above the Dynamic Applications field.
7. After selection a Dynamic Application, you must select a credential. Select a credential in the Credentials field. You can filter the list of credentials using the search field above the Credentials field.

   NOTE: Your organization membership(s) might affect the list of credentials you can see in the Credentials field.

8. Click the [Save] button in the Dynamic Application Alignment modal page to align the Dynamic Application and the credential to the device.
9. SL1 will associate the Dynamic Application with the device and immediately attempt to collect the data specified in the Dynamic Application using the selected credential.
10. After the first, immediate collection, SL1 will collect the data at the frequency defined in the Polling Frequency field in the Application Configuration Editor page for the Dynamic Application.