How to update/install extensions with Smartscape 2.0 for SaaS Classic

MilanNinkovic — Fri, 19 Jun 2026 13:20:40 GMT

Summary

With the introduction of Smartscape on Grail, newer versions of some Dynatrace extensions depend on capabilities that are not available in SaaS environments that haven’t been migrated to Grail yet.

Due to this breaking change:

First time installation will produce error, as it will try to install latest version from the tenant
Its not possible to update to the latest version before migration

👉 In such cases, installing an earlier (compatible) extension version is a valid workaround.

Problem

You may need this approach if:

Your environment is Dynatrace SaaS (non-Grail / Classic)
The extension version you are trying to use explicitly requires:
- Smartscape on Grail
- Grail-based topology or entity model
- Logs on Openpipeline

You observe error messages such as:

Validation errors for asset {"configScope":"logs","assetType":"Group"}: {"error":{"code":400,"message":"Constraints violated.","details":{"constraintViolations":[{"path":"builtin:openpipeline.logs.ingest-sources/0","message":"Feature not enabled","parameterLocation":"PAYLOAD_BODY"}]}}} {"error":{"code":400,"message":"Constraints violated.","details":{"constraintViolations":[{"path":"builtin:openpipeline.logs.pipelines/0","message":"Feature not enabled","parameterLocation":"PAYLOAD_BODY"}]}}}

Validation errors for asset OpenPipeline: OpenPipeline settings migration is not finished

Workaround

1. Identify the Working Version

Check extension release notes (This change will be marked as Breaking change in release notes with text similar as one on the picture below)
One version below the version with breaking changes will be the one that you need to install

2. Install older version by calling the API

If the version is available on the tenant, you can install it by calling the API.

See the endpoint documentation here: Add extension to environment (Playground).

You will need the fully qualified name of the extension (see above) and the version you want to install.

Note: If you receive an error like this: Registered versions of com.dynatrace.extension does not contain the requested version 1.2.3., then double-check the values for any typos or whitespace. If there are no typos, continue with below option instead, as the extension version is most likely not available on the tenant.

3. Upload the Extension Manually

If the version is not available on the tenant/it is not possible to install it through API, then please follow these steps:

Get the extension package file you want to upload. One way to obtain it is through the Dynatrace Hub (Official Site). Navigate to the release notes for the desired version and download the package file:
Go to Dynatrace Hub and select Upload extension. See the SaaS instructions — the same process applies to the classic environment:
Select the ZIP file and upload the extension.

Long-Term Recommendation

This workaround is temporary.

👉 The correct long-term solution is:

Migrate the environment to Smartscape on Grail
Upgrade to the latest supported extension version

article How to update/install extensions with Smartscape 2.0 for SaaS Classic in Troubleshooting