This section documents the entity types related to Dynatrace fleet management infrastructure. These entities represent monitoring agents, ActiveGates, Zremotes and Synthetic execution engines.
Query
Count ONEAGENT and SYNTHETIC_ENGINE entities by type.
smartscapeNodes ONEAGENT
|append [smartscapeNodes"SYNTHETIC_ENGINE"]
|summarizeby:type, count()
Load all ACTIVEGATE entities.
smartscapeNodes ACTIVEGATE
Combined report of all ActiveGate-derived node types sorted by version.
The following base fields are used for all entities.
Attribute
Type
Description
Examples
id
smartscapeId
stable Display name: ID A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.
<type>-017198AD253CBD63
id_classic
string
deprecated Display name: Classic ID The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the id field instead, which is the Smartscape ID.
<type>-017198AD253CBD63
name
string
stable Display name: Name The entity name.
localhost; easyTravel; product-catalog
type
string
stable Display name: Type The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stable Display name: Tags A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, release or name). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via tags:context field. Note that rule-based tags do not exist in the new model.
stable Display name: Lifetime The lifetime of the entity. This is a record with two nested fields: start and end, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.
stable Display name: References Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.
resourcestable Display name: DT security context The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission
[]
ActiveGate fields
Fields common to ActiveGate and any ActiveGate-derived node.
Attribute
Type
Description
Examples
dt.active_gate.version
string
experimental ActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimental Identifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimental Timestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimental Addresses (IPs or FQDNs) at which this ActiveGate instance can be reached directly, without going through a load balancer or proxy.
['10.0.0.5', '2001:db8::1', 'ag-node-1.internal']
load_balancer_addresses
string[]
experimental Addresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.
OneAgent entity. Represents OneAgent as a monitoring infrastructure component.
Base entity fields
The following base fields are used for all entities.
Attribute
Type
Description
Examples
id
smartscapeId
stable Display name: ID A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.
<type>-017198AD253CBD63
id_classic
string
deprecated Display name: Classic ID The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the id field instead, which is the Smartscape ID.
<type>-017198AD253CBD63
name
string
stable Display name: Name The entity name.
localhost; easyTravel; product-catalog
type
string
stable Display name: Type The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stable Display name: Tags A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, release or name). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via tags:context field. Note that rule-based tags do not exist in the new model.
stable Display name: Lifetime The lifetime of the entity. This is a record with two nested fields: start and end, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.
stable Display name: References Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.
resourcestable Display name: DT security context The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission
[]
OneAgent fields
Attribute
Type
Description
Examples
dt.agent.module.version
string
resourcestable Display name: OneAgent module version OneAgent full module version.
1.269.17.20221117-132428
dt.agent.monitoring_mode
string
resourceexperimental Display name: OneAgent monitoring mode Monitoring Mode in which the OneAgent module operates.
DISCOVERY
dt.smartscape_source.sender
string
experimental Indicates the source agent that created the Smartscape node. Possible values include OS agent, z/OS agent, or technology-specific code module agents running standalone.
dynatrace_codemodule
dt.network_zone.id
string
resourceexperimental Display name: Network zone ID The ID of the network zone. See Dynatrace Documentation
vpc-123
dt.agent.monitoring_mode MUST be one of the following:
Value
Description
Display name
DISCOVERY
Discovery monitoring mode provides basic metrics enabling you to discover your hosts and processes and learn the potential to extend your monitoring.
Discovery
FULL_STACK
Full stack monitoring mode includes application performance, user experience data, code-level visbility and PurePath insights, as well as everything that is included in Infrastructure monitoring mode.
Full Stack
INFRASTRUCTURE
Infrastructure monitoring mode includes topology discovery, detailed health and performance monitoring of your host, and enables Network monitoring, Log monitoring and Extensions.
Infrastructure
dt.smartscape_source.sender MUST be one of the following:
Value
Description
dynatrace_codemodule
An agent with a particular technology running as a standalone.
dynatrace_osagent
OS agent
dynatrace_zagent
z/OS agent
OneAgent k8s fields
Attribute
Type
Description
Examples
k8s.cluster.name
string
resourcestable Display name: Kubernetes cluster name The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: permissionprimary-field
unguard-dev; acme-prod10
OneAgent relationships
Relationships of OneAgent entity.
Type
Target type
Kind
Description
monitors
HOST
static
experimental Defines monitoring relationship, where the source monitors the destination. Examples: A synthetic monitor monitors a frontend. A synthetic monitor or OneAgent monitors a host.
Synthetic Engine
Smartscape node name: dt.active_gate.name
Smartscape node type: SYNTHETIC_ENGINE
Synthetic Engine entity. Represents Synthetic Engine as a part of synthetic monitoring infrastructure component.
Query
Load all SYNTHETIC_ENGINE entities.
smartscapeNodes SYNTHETIC_ENGINE
Base entity fields
The following base fields are used for all entities.
Attribute
Type
Description
Examples
id
smartscapeId
stable Display name: ID A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.
<type>-017198AD253CBD63
id_classic
string
deprecated Display name: Classic ID The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the id field instead, which is the Smartscape ID.
<type>-017198AD253CBD63
name
string
stable Display name: Name The entity name.
localhost; easyTravel; product-catalog
type
string
stable Display name: Type The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stable Display name: Tags A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, release or name). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via tags:context field. Note that rule-based tags do not exist in the new model.
stable Display name: Lifetime The lifetime of the entity. This is a record with two nested fields: start and end, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.
stable Display name: References Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.
resourcestable Display name: DT security context The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission
[]
ActiveGate fields
Fields common to ActiveGate and any ActiveGate-derived node.
Attribute
Type
Description
Examples
dt.active_gate.version
string
experimental ActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimental Identifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimental Timestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimental Addresses (IPs or FQDNs) at which this ActiveGate instance can be reached directly, without going through a load balancer or proxy.
['10.0.0.5', '2001:db8::1', 'ag-node-1.internal']
load_balancer_addresses
string[]
experimental Addresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.
experimental Display name: Browser name Browser name.
Chrome; Chromium
browser.version
string
experimental Display name: Browser version Browser version.
131.0.6778.204
Relationships
Synthetic Engine relationships
Type
Target type
Kind
Description
belongs_to
SYNTHETIC_LOCATION
static
stable This is similar to an aggregation in UML. It is a many-to-many relationship without existential properties (the destination is not composed of the sources).
ZREMOTE
Smartscape node name: dt.active_gate.name
Smartscape node type: ZREMOTE
ZRemote monitoring IBM Z Mainframe
Query
Load all ZREMOTE entities.
smartscapeNodes ZREMOTE
Load ZREMOTE entities in a specific network zone.
smartscapeNodes ZREMOTE
|filter dt.network_zone.id == "mainframe_zone"
Combined report of all ActiveGate-derived node types sorted by version.
The following base fields are used for all entities.
Attribute
Type
Description
Examples
id
smartscapeId
stable Display name: ID A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.
<type>-017198AD253CBD63
id_classic
string
deprecated Display name: Classic ID The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the id field instead, which is the Smartscape ID.
<type>-017198AD253CBD63
name
string
stable Display name: Name The entity name.
localhost; easyTravel; product-catalog
type
string
stable Display name: Type The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stable Display name: Tags A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, release or name). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via tags:context field. Note that rule-based tags do not exist in the new model.
stable Display name: Lifetime The lifetime of the entity. This is a record with two nested fields: start and end, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.
stable Display name: References Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.
resourcestable Display name: DT security context The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission
[]
ActiveGate fields
Fields common to ActiveGate and any ActiveGate-derived node.
Attribute
Type
Description
Examples
dt.active_gate.version
string
experimental ActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimental Identifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimental Timestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimental Addresses (IPs or FQDNs) at which this ActiveGate instance can be reached directly, without going through a load balancer or proxy.
['10.0.0.5', '2001:db8::1', 'ag-node-1.internal']
load_balancer_addresses
string[]
experimental Addresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.