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"}]}}}
or
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
