Adding Resource Instances

Last updated on 13 September, 2024

When a DataSource is applied to a Resource, LogicMonitor attempts to discover instances of the DataSource to monitor. Some DataSources will only have on instance to monitor for each resource (such as ping). Other DataSources can monitor multiple instances for each resource (such as disks, server volumes, interfaces, and so on).

When a single-instance DataSource is applied to the resource, the instance is added automatically and data collection begins immediately. For multi-instance DataSources, you can use Active Discovery to automatically detect and add new instances.

Running Active Discovery to Add Instances

Active Discovery (AD) runs automatically for multi-instance DataSources that have it enabled. When AD runs, LogicMonitor looks for components that match the DataSource and creates an instance for each component. AD runs on a schedule that is configured when you create the DataSource. If you don’t want to wait for the next scheduled AD run at add a new instance into monitoring, you can manually run AD from the Resources page.

To manually initiative AD:

  1. Navigate to the Resources page and select the resource you want to add instances to.
  2. Click Manage Resource Options, and then select Run Active Discovery.

AD will run for all multi-instance DataSources that are applied to the selected resource and have AD enabled.

Note: Active Discovery will also run on PropertySource configurations that are applied to the selected resource.

When AD completes, you will see the discovered instances listed under the selected resource in the tree.

Manually Adding Instances

If you do not have Active Discovery enabled for a multi-instance DataSource, you can manually add new instances to monitoring. An example of a multi-instance DataSource for which it may be appropriate to not enable Active Discovery (AD) is one that applies to an application that runs on a different port per device, and the list of ports is not exclusive to the application. In this case, it may be most efficient to manually add an instance of the application, specifying the port.

To manually add an instance into monitoring:

  1. Navigate to the Resources page and select the resource you want to add instances to.
  2. Click Manage Resource Options, and then select Add Monitored Instance.
  3. In the Wizard, complete the following configurations:
    • DataSource – (Required) Select the DataSource you are adding a monitored instance to. This field provides matching suggestions as you type. Only multi-instance DataSources that have been applied to the current resource and do not have Active Discovery enabled will be available for selection.
    • Name – (Required) Enter the name for the instance. Instance names are limited to 255 characters.
    • Wildvalue – (Required) Enter the wildcard value, which will be used by the DataSource to query and match the instance. For Example, the value could be a specific port of SNMP OID index. Wildcard values are limited to 1024 characters. The following ASCII characters are not valid values: what space, :, =, \, and #. The # character is a valid wildvalue, but it can break AD. You can replace these invalid ASCII characters with an underscore.
    • Description – Enter a description for the instance.
    • Group – (Required) Select the instance group to organize your instance into. This field provides matching suggestions as you type. Choosing @default will add the instance to the default Ungrouped group.
  4. Click Save.

Note: You’ll see the new instance added to the tree under the selected Resource.

In This Article