OneAgent and ActiveGate version 1.299 are the last versions supporting OneAgent and ActiveGate Extensions 1.0 framework. You can continue using Extensions 1.0 if you stay at OneAgent or ActiveGate version 1.299. Note that this means you'll be using an unsupported Python version 3.8. We strongly recommend migrating your extensions to the latest Extensions 2.0 framework.
For more information, see General guidance and how to migrate.
We provide you with a Extension SDK free of charge. You don't need a special license to develop and deploy your own custom extensions. Alternatively, you can have one of the Dynatrace partners develop the extension for you, in which case your license fee depends on your contract. Whichever approach you take, after you successfully deploy and start using your extension, you'll be charged for the custom metrics your extension reports.
Dynatrace doesn't propagate ActiveGate extensions automatically. You need to upload the extension package to Dynatrace Server and to each ActiveGate you want to run it on. Each extension should be placed unpacked in its own folder in plugin_deployment
directory in the installation directory. By default, /opt/dynatrace/remotepluginmodule/plugin_deployment
on Linux or C:\Program Files\dynatrace\remotepluginmodule\plugin_deployment
on Windows.
Remember, you have to upload the extension to each ActiveGate that will run it and your Dynatrace Server.
For more information, see Deploy an extension
Open the Process Group details view of a technology, expand Properties section and look for the technology in the Main technology property.
Add this value to technologies
field in your plugin.json
file. For more information, see extension metadata in json file
The extension logs are saved by default in
/var/lib/dynatrace/remotepluginmodule/log/remoteplugin
on Linux or
%PROGRAMDATA%\Dynatrace\remotepluginmodule\log\remoteplugin
on Windows
For more information, see logging.
To start extension development you need to install python3
, pip3
and pluginSDK
. For more information, see Extensions hands-on
See External libraries.