Plugin Integrations
Plugins are a great way to monitor your entire stack and keep track of data that matters the most. Choose from our ready-to-install plugin integrations or build your own.
- How it works
- Plugin template configuration
- 100+ plugin integrations
- Build your own plugin
- Inventory dashboard
- Set thresholds
- AppLogs integration
- Licensing
- Troubleshooting Tips
How it Works
A Windows/Linux monitoring agent is required to install and add the plugins in Site24x7. Once the agent is successfully installed, it will execute the plugin script added in the agent directory and push the output to the Site24x7 data center. The resulting data can be viewed in the Site24x7 web client.
Plugin Template Configuration
What is a plugin template?
A plugin template is where the attributes to be monitored are defined. Every plugin added for monitoring will have a template associated with it.
Example: mysql.py file consisting of attributes like slow queries, reads, writes etc.
What is the need for a plugin template?
The Site24x7 server monitoring agent recognizes the plugin output only if it is as JSON output. Thus, it is essential to define them in a template, so that the agent picks it for monitoring. You can edit an existing plugin template and re-define the units for your attributes. It is important to note that any change done to an existing template will require the plugin version to be incremented. Know under what conditions you have to change the plugin version.
What is a plugin monitor?
A plugin monitor will be created in the Site24x7 web client under Server > Plugins. This monitor will use the plugin template and monitor the attributes defined in it.
Example: The mysql.py template installed in 'n' number of servers will create 'n' number of MySQL plugin monitors
100+ Plugin Integrations
Site24x7 provides ready-to-install 100+ plugin integrations including MySQL, WebLogic, GlassFish, Tomcat, Apache, and Nagios to monitor your applications, databases, load balancers, message brokers, caches and more.
If you don't find what you're looking for, build your own plugin.
Build your Own Plugin
You can also build your own plugin using Python or Shell for Linux and Batch, PowerShell, VB, and DLL for Windows.
Checks before you start building your own plugin:
- Ensure the executed plugin script returns a valid JSON data.
- Make sure the required dependency modules are installed. Know what modules have to be installed for each plugin.
- Check if the plugin is placed rightly under the agent's plugin directory.
- Make sure the name of the file and the folder name, both are identical.
- Ensure the plugin version is incremented for every new plugin template created. Under what conditions should I change my plugin version?
Inventory Dashboard
You can view the installation status of your plugins, their associated server monitors, poll interval, versions, and more in the Inventory Dashboard. Go to Server > Plugin Integrations > Inventory Dashboard to view all your plugin monitors in one place.
Set Thresholds
Once a plugin monitor is added, associate a threshold and availability profile to help the alarms engine decide if a specific resource has to be declared critical or down.
AppLogs integration
In order to analyze your application logs and identify the exact root cause of the issues, you can make configuration changes by adding logs_enabled, log_type_name, and log_file_path to the plugin configuration file.
A log_type_name defines the format in which an application writes logs. Site24x7 supports more than 30 different log types. Additionally, you can also create custom log types.
Example:
log_type_name="MySQL Error"
log_file_path="/var/mysql/log/error.txt"
In the plugin script, add logs_enabled, log_type_name, log_file_path under the dictionary name "applog" as:
"applog": {
logs_enabled ="true"
log_type_name="MySQL Error"
log_file_path="/var/mysql/log/error.txt"
}
Note that you need to enable the AppLogs at account and server levels to perform these changes.
Steps to enable AppLogs:
- Log in to Site24x7.
- To enable AppLogs at account level, go to Admin > AppLogs > Settings. Configure Yes to collect the application logs from the servers using AppLogs.
- To enable AppLogs at server level, go to Server > Server Monitor > Servers. Select the Server Monitor, navigate to the AppLogs tab, and click on Enable AppLogs.
Licensing
The first plugin added for a server monitor is free. After that, each plugin monitor is considered as a basic monitor. Each plugin can have upto 50 attributes.
Troubleshooting Tips
- Possible reasons why my Linux plugin has not been added to my Site24x7 account
- Possible reasons why my Windows plugin is not added to my account
- Why is my MySQL plugin not getting added to Site24x7?
- Possible reasons why your Nagios plugin is not working
- What happens if I delete a plugin monitor from the Site24x7 web client?
- Under what cases does a plugin monitor move to the Ignored List?
For the complete list of articles, refer our knowledge base for plugin integrations.
Related Articles
- Build your own plugin: Windows | Linux
- Error handling messages for plugins
- Add a server monitor
- Server monitoring architecture
- IT Automation