Back to ITRS Internal Only FAQ

Internal documentation only

This page has been marked as draft.

[INTERNAL] MongoDb troubleshooting

Now ITRS has integration toolkit with MongoDB, and I am going to write a troubleshooting guide here. As MongoDB is free, you can obtain it easily and try it out.

MongoDB is also new to me, so, this guide is a very basic one which should help you get started.

Basic installation of MongoDB with toolkit:

First, you need to have a MongoDB on your side. I installed one on Linux as the Integration tool is based on Linux.

How to install and run MongoDB on Fedora.

Once you have MongoDB started:

MongoDB Toolkit Integration package

1. Load the MongodbMonitoring.xml as one of your Gateway includes.

2. The environment section has the the default setting:

When you encounter an error (do not panic):

1. Try running the Sampler script directly from the netprobe folder and see if you get the same error as in AC2

Some errors I encountered:

Database cannot have reserved characters:

The error indicates that the a special character is being used. This is a bug on MongoDb that is fixed on v3.4.12 or v3.6 .

https://stackoverflow.com/questions/48048255/mlab-connect-error-database-name-cannot-have-reserved-characters-for-mongodb

As the MongoDB I am using is v3.4.11, I have to modify the toolkit Sampler script without / after $(MONGODB_CONNECTION) and without $(MONGODB_DB) . However, the drawback of this, is you cannot pick which DB you are connecting to. The best, is advice customer upgrade MongoDB.

Connection failed:

Netprobe is installed in the same server,

is using the same hostname and connection… why it still fails?

First, check if there is any authentication being set in MonoDB, our toolkit integration does not use username/password. Therefore, you need to amend the script for specific user/password.

MongoDB authentication

Second, your MongoDB may not accept connection other than some specific IP:

cat /etc/mongod.conf

Change it to the desired value.

For more info: https://docs.mongodb.com/manual/reference/configuration-options/

Stop and Start MongoDB service and make it effective

Existing Jira:

COL-8380 - MongoDB monitoring integration to support MongoDB version 5.x and newer

COL-9554 - [MongoDB integration] Support secure connections to MongoDB instance

More error coming…?

Related downloads Copied

• geneos-integration-mongodb-4.6.0.zip