Discover Logical Systems Through SNMP Context
You can discover logical systems on physical devices using the SNMP context name using one of the following methods:
The method you use is dependent on the target device.
Automatic Discovery of Logical Systems
Out of the box,
DX NetOps Performance Managementdiscovers the Check Point Virtual Firewalls logical system. You can add vendor certifications for other logical systems.
Follow these steps:
- Create an SNMPv3 profile to discover the physical parent devices.For more information, see SNMP Profiles.
- Associate theContext Systemmetric family to a monitoring profile that is attached to the device that hosts the logical systems.For more information, see Configure Monitoring Profiles.
- Wait for discovery to complete.The logical system are automatically discovered.Logical systems have the same IP address as the parent device. However, each logical system has its own context name. The data collector polls the data for the logical system (such as the CPU, Memory, and Interfaces) under the context name.
Manual Discovery of Logical Systems
You can manually discover logical systems on physical devices using the SNMP profile's context name using REST. For Juniper SRX devices with logical systems, use this method.
Verify the Prerequisites
Before making the REST call, verify that you have the following information:
- The tenant item ID.This is the item ID for the tenant,tenant-item-id.You can get the tenant item ID by issuing the following GET call from a REST client editor or HTTP tool with a connection to the data aggregator. This call retrieves information about the tenant, including the tenant item ID:http://da-host:8581/rest/tenants
- The item ID of the parent device.This is the item ID the parent device,parent-item-id. This ID corresponds to where you want to discover devices.You can get the item ID for the parent device from theItem IDfield that is on theDetailstab of theMonitored Devicespage.For more information about how to view this page, see Manage Devices.
- The context name.This is the context name of the logical system that is associated with (at the same IP as) the parent device.You can get the context name for the logical system from the parent system configuration.
Create an Item for a Logical System using a REST Call
You can have the data aggregator create an item for the logical system that has a context name associated with the parent device using a REST call. The data aggregator discovers and monitors the logical system as a manageable device at the same IP of the parent device using this context name.
Follow these steps:
- From a REST client, issue the following call with thePUTmethod:http://<da-host>/rest/tenant/<tenant-item-id>/devices/subsystems
REST Body:<SubSystemCommInfo version="1.0.0"> <ParentDeviceItemID><parent-item-id></ParentDeviceItemID> <ContextName><context-name></ContextName> <ContextNameUsage><context-name-usage></ContextNameUsage> </SubSystemCommInfo>Example REST Body:<SubSystemCommInfo version="1.0.0"> <ParentDeviceItemID>7776</ParentDeviceItemID> <ContextName>LSYS1/</ContextName> <ContextNameUsage>PREFIX</ContextNameUsage> </SubSystemCommInfo>In this example, the community string for the parent device's SNMP v2c profile is public, and the logical system's context name isLSYS1/. Set theContextNameUsageparameter toPREFIXto useLSYS1/publicas the full community string for the logical system. Set the parameter toSUFFIXto usepublicLSYS1/as the full community string for the logical system.
- da-hostis the hostname of the data aggregator host.
- tenant-item-idis the ID for the tenant.
- parent-item-idis the item ID of the parent device for the logical system that you want to create.
- context-nameis the name of the logical system that is associated with (at the same IP as) the parent device.
- (Parent devices that use SNMP v1 or SNMP v2c profiles only)context-name-usagedefines the usage for the context name.Values:PREFIX and SUFFIX
- Wait approximately one minute.The item for the logical system is created. The data aggregator discovers and monitors the logical system as a manageable device at the same IP of the parent device using this context name.