IN THIS ARTICLE:
- Introduction to Instance Properties
- Understanding Property Hierarchies
- Assigning Properties to Instances
Introduction to Instance Properties
Instance properties are sets of key-value pairs that store static data about an instance. Instance level properties (ILPs) can be used to group instances or they can be used within Groovy Complex Datapoint calculations. Commonly collected instance properties include:
- Serial numbers for each FRU discovered in a switch chassis, or drives in a storage system
- Metadata for each VM hosted by a Hypervisor (CPU Count, Memory Allocation, virtual NIC count, guest OS, etc.)
- Port speed for each network interface
Understanding Property Hierarchies
In LogicMonitor, properties cascade from the root account level all the way down to instances. This means that when you view the properties for an instance, you are also viewing the properties that have been previously set and passed down for that instance's parent device or device groups, as well as for the global LogicMonitor account. Properties set at the deepest level in the device tree trump properties set higher up (e.g. properties set at the instance level override properties set at the device level). For more information on property hierarchies, see Device Properties.
Assigning Properties to Instances
As discussed in the following sections, properties can be auto-assigned or manually assigned to instances.
Auto-assignment of Instance Properties
Most commonly, properties are auto-assigned to instances as part of the Active Discovery process, which programmatically collects instance-specific metadata. For more information on this process and the instance information it gathers, see What Is Active Discovery?.
Manual Assignment of Instance Properties
For instance-specific metadata that isn't available programmatically (e.g. a custom bandwidth or speed on an interface), users can manually assign properties to instances.
To manually assign instance properties:
- Navigate to the Devices page.
- From the device tree, either:
- Open the Info tab for the instance to which you would like to assign one or more properties and click the gear icon or…
- …if the instance belongs to a multi-instance DataSource or an instance group, you can optionally open the Instances tab for the DataSource or group and click the gear icon that corresponds to the instance to which you would like to assign one or more properties.
- From the Manage dialog that displays, click the + icon in the Properties section to enter a property name and corresponding value.
Note: You can enter a brand new property name here or, if your goal is to override an existing property that has cascaded down from a parent device or from the global LogicMonitor account, you can enter that property's name here along with the new value.
- Click Save to save the new property. Click Save again to exit out of the Manage dialog.