Scanning extra SNMP data with custom OID scanning

Custom OID scanning is a feature introduced in Lansweeper 7.0. If you are using an older Lansweeper release, you will need to update by following the instructions in this knowledge base article.
Not all Lansweeper licenses support custom OID scanning. If your particular license does not support this feature, please visit this page for more information.

SNMP is one of the protocols through which Lansweeper can retrieve data from network devices like printers, switches, routers etc. By default, Lansweeper retrieves various properties from these devices via SNMP. This includes basic details like serial number and description, but also more advanced details like interface and printer toner information. A device that has been successfully scanned via SNMP can be identified by the device OID listed in its Summary tab.

In addition to this, the custom OID scanning feature allows you to retrieve any other information that is stored in an SNMP OID on the device. Custom OID scanning lets you specify one or more OIDs to be scanned for a specific group of devices, giving you the ability to gather even more device data. Any device that has been successfully scanned via SNMP can be scanned further via custom OID scanning.

scanned custom OID data

To scan specific OIDs of an SNMP enabled device, do the following:

  1. Gather the OIDs you'd like to scan. This can be done by finding OIDs online, through MIB browsers or through vendor documentation.
  2. Make sure your user role includes the Access Data Selection permission. If it doesn't, you won't be able to access the custom OID scanning configuration. More information on configuring website access and specifying who has what permissions can be found in this knowledge base article.
  3. Browse to the following section of the web console: Scanning\Custom OID Scanning
    Custom OID Scanning menu
  4. Hit the Add Target button at the top of the page. Alternatively, from Lansweeper 7.1 onward, you can import OIDs from or export them to another Lansweeper installation. Import/export instructions can be found in this knowledge base article.
    adding a custom OID scanning target
  5. From the Type dropdown in the resulting popup, select the collection of assets you want to retrieve the OID data for. You can retrieve the OID data for a single asset, assets in a specific static or dynamic asset group, assets of a specific type, assets in a specific IP range or assets in a specific asset report from the Reports menu.
  6. Depending on what you selected before, choose your specific asset, group, asset type, IP range or report.
  7. Optionally, submit manufacturer and/or model.
    If you leave these fields empty, the OIDs will be scanned for all assets specified as target. If you fill in one or both of these fields, OIDs will only be scanned for the specified manufacturer/model within the target. Keep in mind that, if you fill in the fields, what you submit must match what is listed as manufacturer/model on the device's asset page. This can either be the scanned manufacturer/model or what was manually overwritten. What you see listed on the asset page is the correct value to submit in the OID scanning configuration. If the manufacturer/model submitted in your OID configuration does not match what is listed on the asset page, no data will be scanned.
  8. Make sure the Enabled checkbox is ticked.
  9. Optionally, tick Delete On Rescan. This is a cleanup option to prevent old OID data from being left behind on asset pages. If ticked, Lansweeper will first delete the OID data associated with the target upon rescanning a specific device. It will then rescan the OID data and add fresh data to the device.
  10. Optionally, submit a description for your OID scanning target. This can be anything you want and is only displayed in your OID scanning configuration.
  11. Submit your label and OID. The label can be anything you want and is displayed next to scanned data on asset pages. Hit Ok.
    custom OID scanning configuration
  12. Make sure your devices are submitted for scheduled scans under Scanning\Scanning Targets, as custom OID data will be retrieved the next time the assets are scanned. You can of course manually rescan assets as well by using the Rescan buttons in asset overviews or on individual asset pages.
  13. View scanned data in the Scanned OIDs tab of individual asset pages, by clicking on a label of a submitted OID or through built-in or custom reports in the Reports menu.
    scanned custom OID data
    custom OID data reports

Related Articles