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

    • Troubleshoot connection errors in the MySQL plugin

      When configuring the MySQL plugin, you may encounter the following errors: Error : Connection Error - This error typically indicates that there is a problem establishing a connection to the database. Sometimes, this message is supplemented with an ...

    • Troubleshoot the "pymysql module not found" error when installing the MySQL plugin

      If you're encountering the pymysql module not found error, it likely means that the pymysql Python library is not installed on the server. pymysql is a Python package that provides a way to interact with MySQL databases using Python code and is used ...

    • Possible reasons for website unavailability

      Site24x7 monitors the availability of your website by sending an HTTP request to the webserver and checks the status code of the returned response. A 200 OK success response indicates that the website is available. We will consider a website ...

    • What are the dependency modules to be installed while adding a plugin?

      Please find below the list of plugins with their required dependency modules: MySQL - pymysql Redis - redis Postgres - psycopg2 Memcached - memcached MongoDB - pymongo DB2 - ibm_db StatsD - statsd iNode - psutil Twilio - twilio Supervisord - ...

    • How to view perfmon counters in Windows?

      To monitor specific Windows performance (perfmon) counters with Site24x7's plugin integration, you need to get the names of the performance counters from the Windows Performance Monitor on your server. Follow the steps below to get the names of the ...