Deploy an ActiveGate plugin

When you complete your plugin development, make sure that your plugin.json file is valid and has all mandatory fields defined. Pay special attention to the source section, where you must define:

  • package, which equates to your Python plugin filename,
  • className, which equates to the class name in your plugin,
  • install_requires, which lists the external dependencies that your plugin requires.
Example source section
"source": {
    "package": "demo_plugin",
    "className": "DemoPlugin",
    "install_requires": ["requests>=2.6.0"]

Place all the plugin files in one directory and ensure that you've installed the ActiveGate plugin module on the ActiveGate where you want to deploy your plugin.

There are two ways to upload and deploy your plugin: using the Plugin SDK, or using the Dynatrace web UI.

Deploy via Plugin SDK

Install the ActiveGate plugin module, navigate to the directory with the plugin files and run the following command:

oneagent_upload_plugin -t yourtoken

What happens:

  • Your plugin is uploaded to the environment to which the ActiveGate is connected.
  • Your plugin is saved in a directory accessible to the ActiveGate plugin module.

Manual deployment

You can also deploy your plugin manually and upload it via the Dynatrace web UI.

  1. Copy the folder with your plugin files to plugin_deployment folder. By default, it's located in:

    • Linux: /opt/dynatrace/remotepluginmodule/plugin_deployment
    • Windows: C:\Program Files\dynatrace\remotepluginmodule\plugin_deployment
  2. Upload the plugin to your environment using the Dynatrace web UI. Go to Settings > Monitored technologies > Custom plugins. There you can either use the Upload ActiveGate plugin button directly (in the Update plugins section) or you can navigate to Settings > Monitored technologies > Add new technology monitoring > Add ActiveGate plugin and use the Upload Plugin button. In both cases, you have to select the plugin.json file or the zipped folder that contains all the plugin files that were prepared earlier. Upload Remote Custom Plugin By UI Add ActiveGate plugin button Upload Custom Remote Plugin Last Step

Plugin deployed

Following successful deployment, you should see your plugin ready for configuration in the Dynatrace web UI in Settings > Monitored technologies > Custom plugins tab. Uploaded ActiveGate Plugin