SNMP (Simple Network Management Protocol) will allow you to manually add assets via IP, manually add OIDs to monitor, and alert when the desired thresholds are breached. You will need to know the IP of the address of the network device you wish to monitor as well as the specific OID(s) and the value type of those OIDs.
Table of Contents
To get started, head to the Assets tab. Your SNMP assets will be listed with your main assets page and you will have the option to filter by SNMP devices or utilize the asset columns to sort.
Blue column headers are sortable and you can customize the headers by selecting the 'Customize' button at the top left of the page.
Adding a New SNMP Asset
To create a new SNMP asset,
- Head to the Assets & RMM page.
- In the upper right, click New Asset.
- In the right hand CREATE ASSET MANUALLY section, click the Asset Type dropdown and select the asset type.
- There will be eight Asset types listed by default: Access Point, Firewall, NAS, Printer, Router, Switch, UPS, and Unmanaged Computer. To create new SNMP Asset types, in the upper right, click the Modify Asset Types button. Learn more about adding and editing asset types.
- Fill in the Asset fields.
- Click Create Asset.
Once the device has been created, it will look like a standard manual asset.
- To enable SNMP on the device, in the upper right, click Edit.
- Next, click the SNMP Details tab.
- Check the SNMP Enabled box.
- Enter the SNMP information.
Hostname / IP: This is the hostname or IP address of the network asset.
Port: This is the port the SNMP asset listens on for SNMP-related traffic. This defaults to port 161.
Monitoring Agent: Allows you to choose from a list of the customer's Syncro devices that will act as the polling apparatus for this network asset, monitoring the desired OIDs. The green circle indicates that the asset is online.
SNMP Version: This notes which SNMP version the network asset is operating under—v1 or v2.
Community: Allows you to adjust the security parameters for the SNMP Community string to allow access to the device.
- If you want to be alerted if the device went offline, enter the maximum number of minutes it can no longer talk to the Monitoring Agent before it sends an alert. You can check the Auto-resolve alert when clear box to automatically dismiss the alert. Note that if the Monitoring Agent goes offline, it will not trigger the alert. The monitoring device must be online for the offline alert to trigger.
- Once the asset information has been filled out, click Save Changes to save the details.
Adding an OID Monitor
You can add OIDs on a one-off basis to an SNMP asset. If using a Custom OID Monitor, any OIDs added here would need to be manually added into any other SNMP asset if you wish to monitor them on other assets.
Select 'Add Custom Monitor' to create a new OID Monitor:
Monitor Name: The friendly name given to the OID for easier identification
Unit Name (optional): The name of the unit being monitored
Object Identifier (OID): The actual OID (e.g. “.22.214.171.124.126.96.36.199.188.8.131.52.1”)
Value Type: This defines the type of value the OID will return (string or number).
Threshold Modifier: This field conditionally populates based on what the Value Type is set to (ex: equal to, does not equal, contains, does not contain, etc.)
Threshold Value: This is the value that will check the polled results after applying the threshold modifier.
Threshold Duration: The threshold must be breached for this duration before alerting. Monitors are checked every 60 seconds.
Duration Units: The unit of time specified in the threshold duration (minutes, hours days).
Append Custom Message to Alert Body: Allows you to add a custom message to the body of the alert
Auto-resolve alert when clear: Automatically clears the alert once it has been resolved
NOTE: If the monitoring device is offline, it will not trigger any OID monitoring alerts on any attached SNMP Assets.
OID Status Indicator
When the OID is found, you will see a green checkmark. If you hover over the checkmark, you will see the value that is present:
When the OID is found, but no value is present, you will see a red exclamation point.
Adding an OID Recipe to the Asset
Alternatively, you can add an OID recipe to the SNMP device based on the SNMP device type that is set. An OID recipe is a group of OID monitors that can be applied to all different kinds of SNMP assets of the same asset type.
Enabling SNMP on an Existing Asset
- To enable SNMP on an existing asset, head to the Assets & RMM page.
- In the upper right, click Edit.
- Next, click the SNMP Details tab.
- Check the SNMP Enabled box.
- Fill in the asset information.
- When finished, click Save Changes.
When you return to the asset detail page, you will now see a section for Monitored Object Identifiers (OIDS).
Monitored Object Identifiers (OIDS)
This section will show each OID being monitored for the network device. The refresh button will trigger a recheck of the displayed OID values:
On the far left of the table, you will see a status indicator. A green checkmark means the status is within the limits of the threshold. A red exclamation means it has exceeded the limits of the threshold.
Next, you will see the OID's friendly name, the last polled value, and the unit type if applicable. The last column will denote the threshold given to the OID in order to throw an alert.
The monitoring tab will let you see all RMM alerts that have been generated from the OIDs for the SNMP asset. You can choose to view the alert, create a ticket, or mute the alert:
OID Monitor Recipes
To view your OID Recipes head to the Assets & RMM main page and click View > OID Recipes.
From the OID Monitor Recipes page you can create a new recipe or edit, clone, generate a public link or delete a recipe.
Creating a New OID Monitor Recipe
On the OID Monitor Recipes page, click the New OID Monitor Recipe button.
Give the OID Recipe a name and select the Asset Type to determine the type of asset the recipe is for. (Note: Only Asset Types that are the same as the recipe will be available to the use on an SNMP Asset).
Then you can add multiple monitors to the recipe and added custom messages to the alert body. Once all the monitors have been added, click Create OID Recipe to save the recipe to apply to SNMP assets.
Editing an Existing Recipe
From the edit page, you can view the assets that have the recipe applied, edit or delete monitors, and add new monitors to the recipe.
When saving changes, you will have two options:
Save Changes: This will save the changes and apply them when adding this OID Recipe to any new network device, but will not override settings for any devices already using it.
Save changes and Apply to Existing Devices: This will save the changes, and then override any network device that currently utilizes this recipe with the updated values.
OID Recipe Sharing
On the OID Recipes list page, when you click the “three-dot menu” > Generate Public Link, you can generate a public link to share with other Syncro users.
When a recipe has been shared, you will see the option to directly click to the public link in a new tab or to copy the public link to your clipboard:
These links can be used to share recipes with other Syncro users.
I can't get any OID monitors to work when adding them to an SNMP device.
If you can't get any OID monitors to work, try using SNMP walk to make sure the monitoring device can reach the SNMP device via the hostname/IP supplied.