toni-moreno / snmpcollector

A full featured Generic SNMP data collector with Web Administration Interface for InfluxDB
MIT License
286 stars 53 forks source link

Installation Guide? #527

Open gsexton opened 1 year ago

gsexton commented 1 year ago

Is there an Installation/Configuration Guide for SNMP Collector? It seems like I'm supposed to know how to use it somehow without any instruction.

I've installed it, and got the Web UI running. I've looked at the Wiki, and after the first page, nothing seems useful. What do I do next? Looking at the logs, I see "[device] STATS SEND NOT CONNECTED".

If there were a guide that says:

that would be helpful. FWIW, I've used MRTG for years, and I've run InfluxDB w/ Grafana in a couple of instances and written my own influx collectors, so I'm not really hopeless.

George

jensenja commented 1 year ago

Hi George,

As far as configuration goes, I'd recommend checking out the examples on the Wiki, specifically Cisco Catalyst - for me this gave the best "end-to-end" configuration example, which I was then able to easily adapt for my own environment via some experimentation.

For installation, I'm very biased towards Docker for software services running on servers nowadays.

I'm happy to try to answer any additional questions you might have.

sbengo commented 1 year ago

Hi @gsexton , you are totally right!

There is no "Getting Started" entry on wiki so I underestand that for new users, even if they have experience with InfluxDB, its not easy to configure an e2e case. I will try to find a slot to create a basic entry

As @jensenja said (thanks!), the examples section can be a good start point to see how to configure all the needed "objects" to be able to start gathering metrics from the devices.

Feel free to ask whatever you need

Thanks, Regards!

gsexton commented 1 year ago

@jensenja and @sbengo It would be more helpful if the Cisco Catalyst sample content remotely resembled the current software. It just doesn't. As an example, basic metrics shows "Indexed" : ifName. That just isn't shown. Also, for datatype, the software's been changed to have a Counter64 Cooked.

Also, I'm now getting 404's out of the user interface and can't use it. I tried using wget and get a straight 404.

Finally, I went through the cisco catalyst thing, with a standard switch and I get a variety of errors:

Device not connected. [measurement] STATS SEND NOT CONNECTED device=ipaddress Error in influx point building:point without fields is unsupported.

I can see looking at the influxdb that no data is getting recorded (db shows no series, measurements, or shards).

This stuff just doesn't work....

gsexton commented 1 year ago

I was able get rid of the 404. I ran the npm run build:prod again, and that seemed to fix that. I noticed the public dir was missing. I certainly didn't do rm -rf public to make it go away...

Where I'm at now, is on Runtime | List, I have 1 Activd, Warning 1 device trying to connect.

I can use the test connection on influxdb and snmp device and they work.

Logs show:

Got basic system info snmp.Sysinfo{SysDescr:\"Router OS....."

followed by

STATS SEND NOT CONNECTED

The snmpcollector.log shows:

Reseting Influxstats for DB LocalInflux Reseting Influxstats for DUMMY DB

gsexton commented 1 year ago

OK, I think I've made some headway. In the measurements field, I needed to set the Get Mode to indexed. I can now see entries populating in influxdb. Hopefully, I can figure the rest out without any help.

sbengo commented 1 year ago

Sorry for the late answer @gsexton .

Thats it, the measurement is the way to create the unique tags to be able to identify each entry of a SNMP table. The measurement creates the needed map (<tag>:<index OID>) to be able to identify the metrics, so the result of the index should be the same as the linked metrics. The different measurement types are documented on the Wiki.

As @jensenja said, we have some examples to help you understand how it works (I recommend to see the Catalyst and the CPU Cores if you want to have a look how the multiindex measurement works. The QoS is the most complex one)

Thanks, Regards!