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
stableDisplay name: IDA 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
deprecatedDisplay name: Classic IDThe 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
stableDisplay name: NameThe entity name.
localhost; easyTravel; product-catalog
type
string
stableDisplay name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stableDisplay name: TagsA 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.
stableDisplay name: LifetimeThe 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.
stableDisplay name: ReferencesProvides 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.
resourcestableDisplay name: DT security contextThe 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
experimentalActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimentalIdentifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimentalTimestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimentalAddresses (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[]
experimentalAddresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.
experimentalInforms if ActiveGate is running in a containerised environment.
true
is_fips
boolean
experimentalInforms if ActiveGate is running in FIPS compliance mode.
false
dt.active_gate.id
string
resourceexperimentalDisplay name: ActiveGate IDHexadecimal identifier of the ActiveGate prefixed with 0x
0xef3d21c3
dt.active_gate.group.name
string
resourceexperimentalDisplay name: ActiveGate group nameThe name of a group that the ActiveGate instance belongs to.
GdanskLab
dt.network_zone.id
string
resourceexperimentalDisplay name: Network zone IDThe ID of the network zone. See Dynatrace Documentation
vpc-123
os.architecture
string
resourceexperimentalDisplay name: OS architectureArchitecture of the CPU, discovered from the operating system.
X86
os.type
string
resourceexperimentalDisplay name: OS typeType of discovered operating system.
LINUX; WINDOWS
os.version
string
resourcestableDisplay name: OS versionThe complete OS version, including patch, build, and other information.
15.3.1; Ubuntu 16.04.7 LTS (Xenial Xerus) (kernel 4.15.0-206-generic); Windows Server 2022 Datacenter 21H2 2009, ver. 10.0.20348
Remote Extensions fields
Basic properties of a Remote Extensions deployment used for monitoring.
Attribute
Type
Description
Examples
dt.remote_extensions.version
string
experimentalRemote Extensions controller version.
1.331.17.20221117-132428
OneAgent
Smartscape node name: host.name
Smartscape node type: ONEAGENT
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
stableDisplay name: IDA 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
deprecatedDisplay name: Classic IDThe 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
stableDisplay name: NameThe entity name.
localhost; easyTravel; product-catalog
type
string
stableDisplay name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stableDisplay name: TagsA 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.
stableDisplay name: LifetimeThe 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.
stableDisplay name: ReferencesProvides 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.
resourcestableDisplay name: DT security contextThe 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
resourcestableDisplay name: OneAgent module versionOneAgent full module version.
1.269.17.20221117-132428
dt.agent.monitoring_mode
string
resourceexperimentalDisplay name: OneAgent monitoring modeMonitoring Mode in which the OneAgent module operates.
DISCOVERY
dt.smartscape_source.sender
string
experimentalIndicates 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
resourceexperimentalDisplay name: Network zone IDThe 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
resourcestableDisplay name: Kubernetes cluster nameThe 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
experimentalDefines 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
stableDisplay name: IDA 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
deprecatedDisplay name: Classic IDThe 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
stableDisplay name: NameThe entity name.
localhost; easyTravel; product-catalog
type
string
stableDisplay name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stableDisplay name: TagsA 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.
stableDisplay name: LifetimeThe 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.
stableDisplay name: ReferencesProvides 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.
resourcestableDisplay name: DT security contextThe 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
experimentalActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimentalIdentifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimentalTimestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimentalAddresses (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[]
experimentalAddresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.
stableThis 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
stableDisplay name: IDA 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
deprecatedDisplay name: Classic IDThe 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
stableDisplay name: NameThe entity name.
localhost; easyTravel; product-catalog
type
string
stableDisplay name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity.
TYPE_A
tags
record
stableDisplay name: TagsA 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.
stableDisplay name: LifetimeThe 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.
stableDisplay name: ReferencesProvides 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.
resourcestableDisplay name: DT security contextThe 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
experimentalActiveGate version.
1.339.17.20251117-132428
dt.active_gate.auth_token.id
string
experimentalIdentifier of the ActiveGate auth token.
dt0g02.AY7LR5MH
startup_time
timestamp
experimentalTimestamp when ActiveGate was started up.
1771494246779; 1771844752
addresses
string[]
experimentalAddresses (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[]
experimentalAddresses (IPs or FQDNs) of the load balancer, reverse proxy, or DNS name that fronts this ActiveGate and via which it is reached by clients.