A general performance settings monitoring plugin on the RavenDB database. It uses system commands to obtain the general performance settings for the database. For more information visit the following webpage: http://pandorafms.com/index.php?sec=Library&sec2=repository&lng=es&action=view_PUI&id_PUI=606

1. Pandora FMS
Raven DB Plugin
Administrator Manual

2. Index
1. INTRODUCTION............................................................................................................................2
2. COMPATIBILITY MATRIX............................................................................................................3
3. MODULES GENERATED BY THE PLUGIN...............................................................................3
4. PREREQUISITES............................................................................................................................4
5. Plugin Configuration........................................................................................................................4
6. Plugin Execution..............................................................................................................................5
Page 2

3. 1. INTRODUCTION
This document's main objective is the description of the RavenDB monitoring procedures on
Windows-based systems.
To extract information this plugin uses:
• Specif system commands with no need to install libraries or third party tools.
• Visual basic scripting language
2. COMPATIBILITY MATRIX
The compatibility matrix for RavenDB monitoring plugin is:
Systems where it has been tested • RavenDB 2.5.2874
Systems where it should work • RavenDB 2.5.2874 or above
3. MODULES GENERATED BY THE PLUGIN
This plugin returns 12 modules. All of them display valuable status information. You can fix
thresholds manually to determine whether something is in a warning/critical or operative condition.
• RavenDB_Server_Process_Running: Informs if the process is active
• RavenDB_Server_Process_PID: Shows the PID of the process
• RavenDB_Server_Process_Memory_Usage: Shows the memory usage for the process .
• RavenDB_Server_Process_CPU_Usage_Percentage: Shows the porcentage of cpu use for
the process.
Page 3

4. • RavenDB_Server_Process_Sessions: Returns the number of Sessions for the Process
• RavenDB_Server_Process_Session_Name: Returns the specific session name for the
process
• RavenDB_Database_Number: Returns the number of Databases created in Raven DB
• RavenDB_Database_Size: Shows the Database size.
• RavenDB_Uptime: Returns the uptime for the Raven DB
• <Database>_Documents: Returns the amount of documents in the database where:
• <Database> is the name for every single one of them.
• <Database>_Requests_Per_Second: Returns the number of request per second for the
databases
• <Database>_Concurrent_Requests: Returns the number of concurrent requests for the
database.
4. PREREQUISITES
The Raven DB plugin uses Windows commands to obtain data.
The prerequisites for this monitoring to work correctly are the following:
• RavenDB must be installed
• A Pandora FMS agent must be installed
• In order to use RavenDB management studio Microsoft Silverlight must be installed.
5. PLUGIN CONFIGURATION
This plugin is prepared to function with the latest version of RavenDB (2.5.2874). This version can
be downloaded from the following link: http://hibernatingrhinos.com/downloads/RavenDB/2874.
Once the download is complete the files must be extracted in the following folder: c:RavenDB-
Build-2874. Once done you need to access that folder and execute Start.cmd
To install the plugin in Pandora, you need to copy it to the following folder: C:Program Files
(x86)pandora_agentutil. Once done edit the pandora agent configuration file located in:
C:Program Files (x86)pandora_agentpandora_agent.conf and add the following line:
module_plugin cscript.exe //B "%ProgramFiles%Pandora_AgentutilRavenDB_Plugin.vbs
Page 4

5. 6. PLUGIN EXECUTION
If everything is working fine you should be able to see the following image with all the modules
created.
Page 5