How to create a new MongoDB agent (4231076)

Foglight for MongoDB provides a graphic, intuitive method for creating and configuring agents, which can be used instead of Foglight’s default method for creating agents and editing their properties using the Agent Status dashboard. Foglight for MongoDB allows running a wizard that provides a common entry point for adding database instances and then configuring these instances for monitoring.

Foglight for MongoDB provides a graphic, intuitive method for creating and configuring agents, which can be used instead of Foglight’s default method for creating agents and editing their properties using the Agent Status dashboard. Foglight for MongoDB allows running a wizard that provides a common entry point for adding database instances and then configuring these instances for monitoring.

Using the Agent Installer Wizard

1. On the navigation panel, click Databases.
2. Click the MongoDB box in the Databases View, and then click Monitor.

   

3. The Agent Installer Wizard dialog box appears.
4. The first card - Agent Deployment – has two fields:
   1. Agent Name – Provide a name for the agent that will be created. This is not canonical and should be representative of the database instance that this agent will monitor.
   2. Agent Manager - Choose the agent manager on which the agent should run. Considerations for this may include physical or virtual locality to the monitored instance, allocated resources, or grouping with other agents of the same type or monitored environment. If the agent package has not been deployed to this Agent Manager yet, it will be installed when the first agent of this type is created.
5. The second card – Agent Properties – requires a basic set of parameters for connecting to and monitoring the database instance. A full explanation of these properties is available in the Agent Properties.
6. The third card – Agent Summary – displays a review of the configuration that will be created and an option allowing the agent to be activated after creation. If the configuration looks good, click the Finish button to start the process.
7. When the process completes, a results screen will appear showing the results of agent creation. If the agent was not created, follow the instructions on the results screen. If successful, the database instance should appear in the Databases table within a few minutes.  

Note: If the agent was created successfully but data is not appearing, go to the Dashboards | Administration | Agents | Agent Status page and click the icon in the Log File column for the agent you created. In most cases, the reason for the failure will be obvious. You can also refer to the Foglight for MongoDB Installation and Troubleshooting document for common errors and solutions. If the solution requires reconfiguring the agent properties, follow steps 3-7 of the Using the Agent Status Dashboard section. 

1. If the MongoDB agent package has never been deployed to the FglAM that will be used to host the agent, this must be done before an agent has been created. You can use the Deploy Agent Package button on the Agent Status or Agent Managers page to perform this.

   

    

2. Click the Create Agent button

   

   and follow the instructions for the cards:

    

   1. Host Selector - Choose the Agent Manager on which the agent should run. Considerations for this may include physical or virtual locality to the monitored instance, allocated resources, or grouping with other agents of the same type or monitored environment.
   2. Agent Type and Instance Name – Select the MongoDBAgent type. Then, select the Specify Name radio button and provide a name for the agent that will be created. This is not canonical and should be representative of the database instance that this agent will monitor.

3. Summary – Click Finish.

4. Once the agent has been created, click the checkbox next to the MongoDB agent.

5. Click the Edit Properties button.

6. Select Modify the default properties for this agent.

7. Edit the agent properties  for the MongoDB agent instance:

   • Database Connections
   • Log
   • Options

8. Click the Activate button.