Service Graph Connector for Observability - Dynatrace SaaS properties

  • Release version: Australia
  • Updated July 7, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Service Graph Connector for Observability - Dynatrace SaaS properties

    The Service Graph Connector for Observability - Dynatrace SaaS allows ServiceNow customers to integrate Dynatrace data into their CMDB by configuring various connection and system properties. These properties control how data is fetched, processed, and maintained in ServiceNow, enabling customers to tailor connector behavior for optimal performance and data accuracy.

    Show full answer Show less

    Connection Properties

    Connection properties manage the interaction between ServiceNow and Dynatrace APIs, influencing data retrieval, relationship creation, and CI lifecycle management. Key configurable properties include:

    • datafetchflowactiontimeoutms: Sets the maximum execution time (default 10 minutes) for fetching Dynatrace data to prevent long-running operations.
    • initialdynatracedatafetchdays: Defines the number of days of historical data fetched during initial synchronization (default 7 days).
    • servicetoservicerelationshipsenabled: Enables or disables creation of upstream/downstream service relationships between Dynatrace Service CIs (default true).
    • appendtenantidtoservicename: Controls whether the Dynatrace tenant ID is appended to service names for uniqueness across multiple connections (default false).
    • dynatraceapibatchsize: Sets the maximum records per API request to balance payload size and call frequency (default 50).
    • dynatraceclassicconnectionaliassysid: Supports one-time cleanup of stale process CIs from the Dynatrace Classic connector; leave empty to skip.
    • segmentid: Filters imported entities by a specified Dynatrace segment ID; if empty, all entities are imported.
    • ciretirementthresholddays: Specifies how many days to wait before soft-retiring CIs no longer reported by Dynatrace (default 35 days).

    These properties are accessible via the Service Graph Connection Properties related list under the connector's connection record in ServiceNow.

    System Property

    A system property modifies the import behavior for unmatched Dynatrace processes:

    • sndynatracesaas.createUnmatchedApplicationCIs: When set to true (default), unmatched running process records are imported into the Applications table, ensuring comprehensive visibility of running processes even if they do not directly match existing CIs.

    This property can be managed in the System Properties table within ServiceNow.

    Practical Benefits for ServiceNow Customers

    By configuring these properties, customers can control data synchronization scope and performance, maintain accurate service relationships, manage CI lifecycle effectively, and ensure unique identification of services across multiple Dynatrace tenants. Additionally, the cleanup option helps maintain CMDB hygiene when migrating from older connectors.

    Service Graph Connector for Observability - Dynatrace SaaS properties control the behavior of the connector.

    Connection properties

    These connection properties are available for the Service Graph Connector for Observability - Dynatrace SaaS.
    Note:
    To open the Service Graph Connection Properties [sn_cmdb_int_util_service_graph_connection_property] table for the connector, navigate to All > Service Graph Connectors > Observability - Dynatrace SaaS > Connections and select the connection name. The connection properties are displayed in the Service Graph Connection Properties related list.
    Table 1. Connection properties for Service Graph Connector for Observability - Dynatrace SaaS
    Property Description

    data_fetch_flow_action_timeout_ms

    		 Maximum time (in milliseconds) allowed for the connection’s Fetch Dynatrace SaaS Data flow designer action to run while calling Dynatrace API endpoints and loading results into ServiceNow source tables. If the action exceeds this limit, execution is terminated to prevent long‑running or stalled runs.

    Default value: 600000 (10 minutes)

    initial_dynatrace_data_fetch_days

    		 Specify the number of days for which data is fetched from Dynatrace when the connection runs for the first time or when last_run_datetime is empty.

    Default value: 7

    service_to_service_relationships_enabled

    		 Set this property to true to create upstream and downstream relationships between Dynatrace Service CIs (service-to-service).

    When this property is set to false, upstream and downstream service-to-service relationships aren't created for the connection.

    Default value: true

    append_tenant_id_to_service_name

    		 Set this property to true to append the Dynatrace tenant ID to the Calculated Service names to maintain unique names across multiple Dynatrace connections.

    When this property is set to false, Calculated Service names are created without the Dynatrace tenant ID.

    Default value: false

    dynatrace_api_batch_size

    		 Specify the maximum number of records to be returned per Dynatrace API request. This property controls pagination for Dynatrace data fetch operations.

    Lower values might reduce the payload size but increase the number of API calls, while higher values might improve performance but increase the payload size.

    Default value: 50

    dynatrace_classic_connection_alias_sys_id

    		 Connection alias sys_id from the Dynatrace Classic connector (SGO-Dynatrace). When this property is set, the connector performs a one-time cleanup of stale process CIs originally created by the classic connector.

    Leave the value field empty to skip classic migration cleanup.

    Default value: empty

    segment_id

    		 Specify the Dynatrace segment ID to be used for filtering entities. When a value is specified, only entities that belong to the specified segment are imported.
    Note:
    Only one segment ID can be specified.

    If no value is specified, no segment filter is applied, and all entities are imported.

    Default value: empty

    ci_retirement_threshold_days

    		 Number of days to wait before retiring a CI that is no longer reported by Dynatrace. Configuration items that aren't seen for longer than this period are soft‑retired by setting their operational status to non‑operational.

    Default value: 35 days

    System property

    The following system property is available for the Service Graph Connector for Observability - Dynatrace SaaS.
    Note:
    To open the System Properties [sys_properties] table, enter sys_properties.list in the navigation filter.
    Table 2. System property for Service Graph Connector for Observability - Dynatrace SaaS
    Property Description

    sn_dynatrace_saas.createUnmatchedApplicationCIs

    		 Set this property to true to import all the unmatched running process records into the Applications table.
    • Type: string
    • Default value: true
    • Location: System Property [sys_properties] table