Install extension SDK

The extension SDK provides you with all the resources and means necessary to develop your own extensions. To get started with the extension SDK, follow the steps below.

Download

  1. In Dynatrace, go to Settings > Monitoring > Monitored technologies.
  2. Select Add new technology monitoring > Add ActiveGate extension or Add OneAgent extension > Download Extension SDK.

You'll use the same extension SDK for both, OneAgent and ActiveGate extensions.

Extract the downloaded ZIP file. It contains docs, examples, and the whl file that's required for installation (for example, plugin_sdk-1.156.0.20181003.61122-py3-none-any.whl).

Installation

You need the following to install the SDK:

  • ActiveGate extensions Environment ActiveGate version 1.175+ installed in the default mode
  • Python 3.8 with PIP installed.

To install your downloaded SDK use:

pip3 install plugin_sdk-version.whl

For example:

pip3 install plugin_sdk-1.156.0.20181003.61122-py3-none-any.whl

Deployment

Once you've written your extension, you can use the SDK to build it and upload it to the server. If you want to simply validate your plugin.json file type:

plugin_sdk build_plugin --no_upload

If you want to upload your extension to the server, type:

plugin_sdk upload_plugin -t yourtoken

For your extension development, you can also use the extension simulator.

Troubleshooting

If after deploying your extension the results are different from your expectations, check troubleshooting to find out what went wrong.

Configuration

Following successful deployment, you should see your extension ready for configuration.

Development

The Extensions how-to topics will guide you through the key concepts of extension development with examples and working code snippets to facilitate your own extension development.