Troubleshooting for Linux plugins

Possible reasons why my Linux plugin has not been added to my Site24x7 account

There may be instances when a Linux plugin monitor does not get added successfully to your Site24x7 account. 

Here are some frequently encountered errors, their reasons, and solutions you can implement to troubleshoot these instances and add the plugin successfully.

Error 
Reason
Solution
/opt/site24x7/../plugins/../ <plugin_name>.py:  not found

Incorrect Python path in the plugin (.py) script.

e.g. /bin/sh: 1: /opt/site24x7/monagent/plugins/ /elasticsearchnodes/ elasticsearchnodes.py:  not found

Follow this article to update the correct Python path in the .py plugin script. 
Error message not configured
The error message is not configured.
Within the plugin script, capture the exception as an error for instances when it's unable to collect metrics.
Plugin not registered due to configuration error
Configuration error while adding a plugin monitor, and then plugin is moved to the Ignored List.
Fix the configuration error(s) in the respective plugin script. Then, follow the steps in this link to re-add the plugin from the Ignored List.
Unauthorized access
Authentication credentials are configured incorrectly. 
Configure the authentication credentials correctly in the config section of a plugin file or in the .cfg file. 
Plugin monitor not displayed
When the plugin script does not contain at least one numeric attribute, the plugin monitor does not get displayed in the Site24x7 web client.
Ensure that the plugin script contains at least one numeric attribute to successfully add a plugin for monitoring.
No attributes found while registering the plugin
Any application that is down will not be registered as a plugin since no attributes can be collected for monitoring.
Ensure that the application that you are adding a plugin for is up and running during registration.
Plugin name exceeds the character limit
Plugin file naming convention is incorrect. The plugin file name should not exceed 30 characters.
The file name should not exceed 30 characters. The file name and the folder name should contain only alphanumeric characters and the special character underscore (_) without any spacing between them.

If you did not encounter any of the above errors, see other common plugin installation errors and their solutions here.

If you are still unable to add the plugin to your account, reach out to support@site24x7.com with the name of your plugin monitor and the error message that appears.

Related Documentation:

    • Related Articles

    • Validating sender email using DKIM authentication

      What is DKIM? DomainKeys Identified Mail (DKIM) is an advanced authentication method used widely by email service providers to verify the email from the point of its origin by validating the email sender. It allows the email senders to authenticate ...