• Home
  • Extend Dynatrace
  • Extensions

Extensions

Dynatrace extension framework upgrade notice

Starting with Dynatrace OneAgent and ActiveGate version 1.231, we are upgrading the Extension Framework (also referred to as the plugins framework) from Python 3.6 to Python 3.8.

  • Consequences: Some Dynatrace extensions running in your environment may stop working and require redeployment of a new version prepared for Python 3.8.
  • Symptoms:
    • No data is provided for affected metrics on dashboards, alerts, and custom device pages populated by the affected extension metrics.
    • Extension logs display errors. Most often this will manifest itself as Python ModuleNotFoundError in the PluginAgent log.
    • Sometimes the Python virtual machine crashes.
  • Impact: This issue affects only those extensions that use native libraries called from Python code distributed with the extension.
Extension-specific advisory
ExtensionWhat to do
  • Citrix Virtual Apps and Desktops
  • IBM DataPower
  • IBM DB2 LUW
  • IBM i
  • IBM MQ
  • Juniper Networks
  • Microsoft SQL Server (MSSQL - remote monitoring)
  • SAP HANA Database
  1. In the Dynatrace menu, go to Hub.
  2. Find and select one of the extensions listed to the left.
  3. On the extension details page, select Download to download the extension ZIP file to your machine. If there are operating system options, be sure to select the correct download for your deployment.
  4. Deploy the extension per the instructions on the corresponding documentation page. (In the list to the left, select the name of the extension.)

For assistance, please contact a Dynatrace ONE product specialist by selecting the chat button in the upper-right corner of the Dynatrace menu bar.

All out-of-the-box built-in extensions

No action required. Extensions distributed with OneAgent will be updated automatically to work with Python 3.8 together with the Python upgrade.

Custom extensions

To learn about upgrading custom Dynatrace extensions from Python 3.6 to Python 3.8, see Upgrade custom Dynatrace extensions from Python 3.6 to Python 3.8.

  • If you can install OneAgent on a host, use OneAgent extensions.
  • If you need to monitor a remote technology where OneAgent installation isn't an option, use ActiveGate extensions.
  • If you simply want to monitor a Java application that exposes MBeans, use JMX/PMI extensions.

OneAgent extensions

With OneAgent extensions, you can extend OneAgent monitoring to any OneAgent-detected processes that expose an interface (for example, processes that are served over HTTP—databases, applications, and load balancers). Extensions run within a OneAgent and fully integrate new-technology monitoring into Dynatrace Smartscape and problem detection. You need some Python expertise to develop OneAgent extensions. For more information, see OneAgent extensions.

ActiveGate extensions

With ActiveGate extensions, you can extend Dynatrace monitoring to any remote technology that exposes an interface, where OneAgent installation isn't an option. For example, PaaS technologies, network devices, or cloud technologies. ActiveGate extensions (aka Remote Plugins) are executed on ActiveGate and can acquire metrics and topology from remote sources, fully integrating new-technology monitoring into Dynatrace Smartscape and problem detection. You need some Python expertise to develop ActiveGate extensions. For more information, see Introduction to ActiveGate extensions.

Extension SDK

The Extension SDK is a versatile solution that enables you to monitor any custom technology that exposes an interface. Develop and deploy your extensions. Dynatrace can seamlessly integrate your custom-technology monitoring data into relevant analysis views, taking full advantage of all your favorite Dynatrace features and AI-driven root cause analysis.

Introduction

OneAgent extensions

  • OneAgent extension lifecycle
  • OneAgent extensions tutorial

ActiveGate extensions

  • Introduction to ActiveGate extensions
  • ActiveGate extension capabilities
  • ActiveGate extensions tutorial

Develop your ActiveGate extensions

Development

  • Extension SDK commands
  • Install extension SDK
  • Install ActiveGate plugin module
  • Extensions How-tos
  • How to use external Python packages

Troubleshooting

  • ActiveGate plugin module performance
  • Troubleshoot extensions
  • Extension simulator
  • Extensions limitations
  • ActiveGate extension FAQs

ActiveGate extensions reference

Python reference

  • Process snapshot

JSON reference

  • Extension JSON explained
  • Extension JSON reference

Dynatrace API

  • Extensions API - GET all extensions
  • Extensions API - GET an extension
  • Extensions API - GET states of an extension
  • Extensions API - POST an extension .zip file
  • Extensions API - GET extension .zip file
  • Extensions API - DELETE extension .zip file
  • Extensions API - GET all extension's instances
  • Extensions API - GET an extension's instance
  • Extensions API - POST a new extension's instance
  • Extensions API - PUT an extension's instance
  • Extensions API - DELETE an extension instance
  • Extensions API - GET global configuration
  • Extensions API - PUT global configuration
  • Extensions API - GET all ActiveGate extension modules
  • Extensions API - GET available hosts