Migrate a classic Dynatrace connection to the Dynatrace SaaS connector

task australia Updated Sep 10, 2026 1 min read sgc-dynatrace-saas-migration-task.md
Raw file servicenow.com

Copy the sys_id of your classic Dynatrace connection alias into a property in your Dynatrace SaaS connection to enable the cleanup of stale Process CIs from the classic connector.

Before you begin

Role required: admin

About this task

For additional information about migrating to the Service Graph Connector for Observability - Dynatrace SaaS, see the New Service Graph Connector for Observability – Dynatrace SaaS article on the ServiceNow Community site.

Procedure

  1. Copy the sys_id of your classic Dynatrace connection alias.

    1. Navigate to All > Service Graph Connectors > Dynatrace Observability > Connections.

    2. Select the active connection record.

    3. On the form, locate the Connection Alias field.

    4. Open the record, select and hold (or right-click) the header, and then select Copy sys_id.

      Save the sys_id value for use in step 2.d.

  2. Add the sys_id of the classic Dynatrace connection alias to the Dynatrace SaaS connection.

    1. Navigate to All > Service Graph Connectors > Dynatrace SaaS > Connections.

    2. Open the Dynatrace SaaS connection record that corresponds to the classic Dynatrace connection record.

    3. From the Service Graph Connection Properties related list, select the dynatrace_classic_connection_alias_sys_id connection property.

    4. Enter the sys_id that you copied in step 1.d into the Value field.

    5. Save the record.

      Note: If no value is specified in the Value field of the dynatrace_classic_connection_alias_sys_id connection property, stale Process CIs from the classic connector aren't cleaned up.

Result

The SGO-Dynatrace Classic Migration Cleanup scheduled import job of the Service Graph Connector for Observability - Dynatrace SaaS runs with the next scheduled execution. Using the sys_id of the classic Dynatrace connection alias, the Process CIs that are exclusively owned by the classic connector are identified and soft-retired automatically (operational_status is set to 2 or Non-Operational).

The SGO-Dynatrace Classic Migration Cleanup scheduled import runs only once. This scheduled import is automatically deactivated after the first successful run.

Search documentation
Search document titles and file paths on the australia branch