Once you have your gateway setup with a gateway ID and a token, it's time to add equipment to Critical Labs to monitor. Before you begin, make sure your gateway is on the same network as the equipment that you want to monitor and is not blocked from seeing equipment by firewalls.
Finding Equipment with SNMP
Equipment that supports SNMP v1, v2c, or v3 can sometimes be discovered by the gateway if you have the correct security credentials. For instance, to discover a device that speaks SNMP v2c, you would need to know the proper community string (like a password) that is configured on the device. If you do not know this, consult with your network administrator or with the equipment manufacturer. The gateway will automatically try a few commonly known community strings, such as "public".
Login to https://criticallabs.com and select your company. Then open the menu in the top righthand corner and select "Equipment".
Next, select the gateway that you have just setup from the "Gateways" list. If you don't see your gateway in the list, then give it a few minutes to report. If it doesn't show up within 5 minutes, then your gateway is probably not setup correctly.
Clicking on your gateway will open an "Equipment" screen that will give details about the gateway, including when it last reported and when the system expects it to report again. On the righthand side, there will be an empty list of equipment and a "Find Equipment" button.
Click the "Find Equipment" button.
This will take you to the "Find Equipment" screen. Before your gateway can discover new equipment on your network, it has to report on its normal reporting cycle. A note at the top of the page will tell you when the next report will happen. You can speed this up by logging into the gateway's web interface. To learn more, check out this guide: https://criticallabs.zendesk.com/hc/en-us/articles/360019372594-Using-the-Gateway-User-Interface
Once the gateway has checked-in, it will be put into "listen" mode, where it will listen for commands from the web application.
From there, enter the SNMP credentials and click "Find Equipment". The gateway will then take several seconds and attempt to discover devices on the network with the credentials that you gave it. The gateway will return with a list of devices that it has found on the network. If you don't see a piece of equipment that you were expecting to see, you may have the wrong credentials or the equipment may not be configured to speak SNMP to outside devices. See this section of articles for help in preparing equipment to be discovered by the gateway:https://criticallabs.zendesk.com/hc/en-us/articles/360020898854-Why-can-t-my-Gateway-see-my-equipment-.
The gateway will return with a list of discovered equipment:
Creating Templates for Equipment
Our system runs on a library of equipment templates that speeds up the connection process. These templates contain the available SNMP OIDs on a piece of equipment and provide other information, such as a name, a unit, and sensible thresholds for alarming on a particular range of values.
When you discover a new piece of equipment, you should first check to see if a library already exists for said equipment by doing a quick search in a new window under 'Libraries'. If you need to create a new a new library that doesn't exist, then navigate to the "Equipment" screen of your gateway and select the "SNMP Walk" button.
When adding a template, do your best to be descriptive with sensor names and units. This template is what the system uses to import future pieces of equipment into the system, and a sloppy template will lead to problems importing equipment down the road. Remember, you only have to create this template once, so make it count!
You should now be at the "SNMP Walk" screen.
Uploading a MIB
A MIB is a document provided by an equipment's manufacturer that describes the points available on a given piece of equipment. Having a MIB can help you see human readable values for a sensor, such as "lowVoltageIndicator" instead of an ugly "22.214.171.124.126.96.36.199". This will greatly cut down on the amount of time spent figuring out which points are what on your piece of equipment, so if you have a MIB for your equipment, we highly recommend uploading it. If you upload the same MIB twice, the latest uploaded MIB will replace the old one. You can upload multiple MIBs at once.
Once you have any relevant MIBs uploaded, it's time to figure out what sensors your piece of equipment supports.
You may have to wait for the gateway to report again before "listening" mode is enabled. Once the gateway is listening, you will first do a check to make sure it can connect to the equipment. Enter the IP address and the community string of the equipment, along with the correct SNMP version and select "Check for Equipment". If an SNMP walk has been completed in the past, you will see the "See Previous Walk" button appear. This button allows you to use the results from a previous walk to create the template, or you can opt to perform a new walk.
If you selected "Check for Equipment", the gateway will send out a network request to verify connectivity. If it is successful, you will see the "Equipment Info" box appear.
Click "Find Sensors". The gateway will spend several seconds walking through your piece of equipment to see what's there. It will then return a list of points that it found. If you used a MIB, then these points probably have descriptive names. If you didn't then you'll get a list of OIDs (object identifiers).
At this point, take some time and clean up the sensor names and add any missing units. By default, the system will import all of the discovered sensors into the equipment template. Feel free to uncheck any sensors that shouldn't be added to the template. Critical Labs cannot process string(text) values off of equipment, so please do not add sensors that return string values.
The system will do its best to guess the model and manufacturer of the equipment, but you may need to edit those values a bit to make them more descriptive.
When you have cleaned up your sensors, make sure to scroll all the way to the bottom of the page and enter the model name and manufacturer for the library. Do your best to be as specific as possible. Models should have names like "GXT3 3000RT120" instead of just "GXT3". Then click "Save". Critical Labs will then create your equipment template and import your piece of equipment into Critical Labs.
Note that you can update your equipment templates. When you update the name or unit of a sensor in an equipment template, monitored pieces of equipment will still show the OLD name and unit. If you change the OID, then connected pieces of equipment will use the NEW OID.
The system will not allow you to delete a sensor in an equipment template that is actively being used by a monitored piece of equipment.
Once you've imported all the pieces of equipment that you'd like to, then you can click the back button. You should now see a list of all of the equipment that you just imported. Critical Labs is now ready to start collecting data from these pieces of equipment.
You can click on a piece of equipment to see details about the equipment, including the sensors that Critical Labs is actively monitoring.