- 6 minutes to read

Configuring the Nodinite RabbitMQ Monitoring Agent

This guide teaches how to configure the Nodinite Nodinite RabbitMQ Monitoring Agent.

Note: The Monitoring and the remote configuration is available if you first install and create the initial Monitoring Agent Configuration for the Nodinite RabbitMQ Monitoring Agent. First-time users start here.

RabbitMQ Categories

The following Categories exists and settings and monitor behaviour may be further customized:

categories

Remote Configuration

As a Nodinite Administrator, click on the 'Configuration' button to open a modal to configure the agent:

RemoteConfiguration
Click the 'Configuration' button to open a modal to configure the agent

Many specific configurations can also be made directly on the Resource using the Action button if the Monitor View has the use of Remote Actions feature enabled.

You must be a Nodinite Administrator, to Manage the collection of 'RabbitMQ' configurations.

Resources per host will be grouped by Application and then by Category using the value from the Name text field. Read more about Applications here:

png_ApplicationFilter

Add RabbitMQ monitoring configuration

The RabbitMQ tab holds an array with one or more RabbitMQ monitoring configuration entries.
png_RemoteConfigurationAddQueueManagers
Add a new RabbitMQ monitoring configuration. Perform the steps from within the 'RabbitMQ' tab

  • Press the Add button to add one (or more) log file monitoring configurations:
    EmptyAccordion
    Example of a new empty RabbitMQ monitoring configuration, 1 accordion per entry

  • Repeat this step for each of your RabbitMQ monitoring configurations to monitor with Nodinite

Basic tab

Click the Accordion to expand the configuration, then you can manage the content of the configuration.

BasicTab

For each configuration, the following properties can be set:

  • Enable Monitoring - When checked, the resources from this monitoring configuration are actively monitored
  • Display name - Display name for this monitoring configuration (Application name)
  • Description - User-friendly short description for this monitoring configuration
  • API Uri - Address to the management URI (e.g. http://localhost:15672/api)

Disk tab

Next, You need to enter some monitoring thresholds for the disk usage, available in the Disk tab:

The disk monitoring thresholds can be either global or specific. The global settings are used for the evaluation of the nodes' disk space used, if not a specific setting has been set.

png_DiskTab

Disk monitoring is evaluated on the amount of free space left, before reaching the RabbitMQ disk limit.

  • Evaluation Type

Evaluation Type

The different disk related evaluation options are:

  • None - No disk monitoring

  • Fixed - Disk monitoring according to the specified values
    evaluationtypes

  • Early Warning threshold (MB)

  • Early Error threshold (MB)

Disk Limits

Specific Settings

Same properties to set as the global, but the specific settings has precedence over the global settings.

specific

Memory

Next, You need to enter some monitoring thresholds for the memory usage, available in the Memory tab:

The memory monitoring thresholds can be either global or specific. The global settings are used for the evaluation of the nodes' memory space used, if not a specific setting has been set.

png_MemoryTab

Memory is evaluated on the amount of free memory left, before reaching the RabbitMQ memory limit.

  • Evaluation Type
    evaluationtypes

Evaluation Type

The different memory related evaluation options are:

  • None - Memory space is not generally evaluated (only for specific configured nodes).
  • Fixed
    • Early Warning threshold (MB)
    • Early Error threshold (MB)
      fixed memory
  • Percent - Disk is evaluated on the amount of free memory left in percent of the RabbitMQ memory limit.
    percent memory

Specific Settings

Same properties to set as the global, but the specific settings has precedence over the global settings.

specific

Queues tab

Next, You need to enter some monitoring thresholds for the monitored queues , available in the Queues tab:

The queue monitoring thresholds can be either global or specific. The global settings are used for the evaluation of the queues, if not a specific setting has been set.

queues
The queue monitoring tab

  • Count Evaluation Type - The type of monitoring evaluation to use, based on the queue depth

    • None
    • Fixed
    • Percent
    • Which comes first
  • Warning Time Span

  • Error Time Span

  • Exclude filter

Count Evaluation Type

Different evaluation options exists:
evaluationtypes

None

Queue is not evaluated on Fixed or Percent (only time).

Fixed

Queue is evaluated on the number of messages

  • Warning Count
  • Error Count

fixed

Percent

Queue is evaluated on the number of messages in percent of total allowed (Quota Evaluation).

  • Warning Limit %
  • Error Limit %

percent

Which comes first

Queue is evaluated on both Fixed and Percent, Whichever happens to Come First.

WhichComesFirst

Warning Time Span

  • Warning Time Span The longest allowed time span before Warning alert is raised should be in the following format (days.hours:minutes:seconds e.g. 7.12:30:59).

NOTE: Format is days.hours:minutes:seconds e.g. 7.12:30:59

Error Time Span

  • Error Time Span The longest allowed time span before Error alert is raised should be in the following format (days.hours:minutes:seconds e.g. 7.12:30:59).

NOTE: Format is days.hours:minutes:seconds e.g. 7.12:30:59

Exclude filter

Queues can be excluded using a RegEx based filter. There can be multiple filters defined.

Example resource filter: Remove all queues that starts with the underscore letter '_'

^[_].*

filter

Specific Settings

Same properties to set as global but the specific settings has precedence over global settings.

specific

Authentication tab

Next, You need to enter some details for connecting with the RabbitMQ API, available in the Authentication tab:

Authentication tab

  • User name - User name to authenticate connection with Broker
  • Password - password for user

Settings tab

From within the Settings tab, you provide some details that determine the operation behaviour of the Nodinite RabbitMQ Monitoring Agent.

  • Environment
  • Debug
  • Culture Information

Settings Tab

Environment

Part of the common features shared with all Monitoring Agents, there is an option to set the name of the target Environment, for example, TEST, QA, PROD.

Debug

Part of the common features shared with all Monitoring Agents, there is an option to set the Debug flag for additional file logging that can be enabled/disabled as needed. Default is unchecked.

Culture Information

The Culture Information setting determines how time-based data from this agent is presented in the Web Client/Web API.

Save

You must click Save for changes to be written to the agent and take effect.
Save and Close buttons

NOTE: The delay in presenting the new evaluated state depends on the synchronisation interval set for the monitoring agent. Click the Sync Now button to force an immediate synchronisation.

Save and close, save, and close the dialogue.
Cancel, close the dialogue without saving any changes.


Add RabbitMQ Monitoring Agent Configuration

After the successful installation of the Nodinite RabbitMQ Monitoring Agent, you must provide Nodinite with some connection details so the Monitoring Service knows there's a new guy in town.

No monitoring or other configuration of the Nodinite RabbitMQ Monitoring Agent can be performed before the steps outlined below has been executed.

Configuration Steps

  1. Add and configure a new Monitoring Agent Configuration

    • Connection information is available in the README.txt file in the installation folder

  2. Use the Remote Configuration feature to configure the agent. Detailed at the beginning of this user guide.

  3. Create one or more self-service enabled Monitor Views that include the selected Resources provided by the Nodinite RabbitMQ Monitoring Agent according to business needs.

  4. Fine-tune specific settings directly on Resources using Remote Actions


Next Step

Add or manage a Monitoring Agent Configuration
Add or manage Monitor View
Update

Install RabbitMQ Monitoring Agent
Monitoring Agents
Applications