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:
  • Automatically
    Use this method to automatically discover logical systems on physical devices using the SNMP context name.
  • Manually
    Use this method if the device
    does not
    provide the logical system context name through SNMP.
The method you use is dependent on the target device.
Automatic Discovery of Logical Systems
Out of the box,
DX NetOps Performance Management
discovers the Check Point Virtual Firewalls logical system. You can add vendor certifications for other logical systems.
Follow these steps:
  1. Create an SNMPv3 profile to discover the physical parent devices.
    For more information, see SNMP Profiles.
  2. Associate the
    Context System
    metric family to a monitoring profile that is attached to the device that hosts the logical systems.
    For more information, see Configure Monitoring Profiles.
  3. 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 the
    Item ID
    field that is on the
    Details
    tab of the
    Monitored Devices
    page.
    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:
  1. From a REST client, issue the following call with the
    PUT
    method:
    http://
    <da-host>
    /rest/tenant/
    <tenant-item-id>
    /devices/subsystems
    • da-host
      is the hostname of the data aggregator host.
    • tenant-item-id
      is the ID for the tenant.
    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 is
    LSYS1/
    . Set the
    ContextNameUsage
    parameter to
    PREFIX
    to use
    LSYS1/public
    as the full community string for the logical system. Set the parameter to
    SUFFIX
    to use
    publicLSYS1/
    as the full community string for the logical system.
    • parent-item-id
      is the item ID of the parent device for the logical system that you want to create.
    • context-name
      is 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-usage
      defines the usage for the context name.
      Values:
      PREFIX and SUFFIX
  2. 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.