Requirements to write a Windows plugin using DLL
Please make sure the following requirements are met to successfully write a Windows plugin using DLL:- Plugin must be written in C# (.NET framework 3.0 and above)
- The output of the script should be in JSON format
- Mandatory variables to be present in a class:
- Version: When there is any change in the version, the Site24x7 data center updates the template and creates a new template for that version. The default value is 1. If any change is done in the plugin, user must increment the version by 1. version should be whole numbers only. E.g. 1,2,3
- Heartbeat: Alerts the plugin as down, when no data is received from the plugin by the Site24x7 data center. Value for heartbeat should be either true or false. By default, the value for heartbeat is true
- The properties Version, DisplayName and Heartbeat will return a string object
- Mandatory functions to be present in a class:
- The class file must have DataCollect() method which will return a Directory<string, object>
- Optional variables to be present in a class:
- DisplayName: name of the monitor as displayed in the web client. For eg: if you create a plugin called "Site24x7 user", your plugin class should have a display name whose return value must be "Site24x7 user"
- The class file can also have a Units() method, a key value pair with keys as the name of the attributes monitored in the plugin and the values as their respective units. This will return a Directory<string, object>
- msg : The configured error message would show up in the Site24x7 web client if the monitor is down. This attribute should be placed parallel to the data attribute
To know more on how to write a Windows plugin using DLL and view a sample plugin file,
refer here.
Related Articles
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 ...
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 ...
How to uninstall the Site24x7 Windows Server Monitoring Agent
Method 1: To uninstall the Site24x7 Windows Server Monitoring Agent, click the link below: https://staticdownloads.site24x7.com/server/Site24x7WindowsAgentUninstall.zip Unzip and execute the Uninstall.bat file in the Command Prompt as an ...
What happens if I delete a plugin monitor from the Site24x7 web client?
Once the user chooses to delete a plugin monitor, this will be communicated to the agent and it will stop data collection. But, the plugin script file will remain in the plugins directory For Windows - <Installation ...