This section documents the set of preconfigured Kubernetes entities. In addition to that, Dynatrace Extensions and other sources may add additional Entities based on Kubernetes objects, which are not described here.
In general each entity represents a single resource in the Kubernetes API. There are two exceptions of this rule: K8S_CLUSTER (which has no representation) and CONTAINER (which is modeled as part of a Pod within the Kubernetes API).
Naming convention
All Kubernetes entity types are prefixed with K8S_*.
The type must be the same as the Kubernetes object kind in uppercase, e.g. K8S_MYTYPE for a Kubernetes object with kind: MyType.
The name field follows the same convention just in lowercase and with a dot separator, e.g. k8s.mytype.name for a Kubernetes object with kind: MyType.
Query
Get an overview of all K8S entities.
smartscapeNodes"K8S_*"
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
ID giving fields
The Smartscape ID for Kubernetes entities will be calculated based on the resource name or UID.
The k8s.object field
The JSON payload of a Kubernetes resource is stored as string in the k8s.object field. The parse command can be used to efficiently filter for details within the JSON payload. As a best practice, to improve the query performance, you can exclude the field from your queries using the fieldsRemove command, if it is not needed.
Note: Some details will be filtered out in order to reduce the size of the field.
Kubernetes labels and annotations
Kubernetes labels and annotations for a given resource are exposed via the tags:k8s.labels and tags:k8s.annotations fields, and can be accessed via tags[__key__]. For example, to access the my_label label, you can use tags[my_label]; the example.com/annotation annotation can be accessed via tags[`example.com/annotation`].
Permission fields
All Kubernetes entities support the following fields to set up permissions:
k8s.cluster.name
k8s.namespace.name
dt.security_context
Migration
Smartscape entities contain an id_classic field pointing to corresponding entities in the classic entity storage.
Kubernetes DynaKube
Smartscape node name: k8s.dynakube.name
Smartscape node type: K8S_DYNAKUBE
This entity represents a Kubernetes DynaKube object.
Query
Fetch all Smartscape nodes from the smartscape.node table and filter for the entity type "K8S_DYNAKUBE".
smartscapeNodes"K8S_DYNAKUBE"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.dynakube.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes DynaKube fields
Attribute
Type
Description
Examples
k8s.dynakube.name
string
resourceexperimentalDisplay name: Kubernetes DynaKube nameName of the DynaKube.
my-dynakube
Kubernetes DynaKube relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
belongs_to
K8S_CUSTOMRESOURCEDEFINITION
static
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).
Kubernetes EdgeConnect
Smartscape node name: k8s.edgeconnect.name
Smartscape node type: K8S_EDGECONNECT
This entity represents a Kubernetes EdgeConnect object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_EDGECONNECT".
smartscapeNodes"K8S_EDGECONNECT"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.edgeconnect.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes EdgeConnect fields
Attribute
Type
Description
Examples
k8s.edgeconnect.name
string
resourceexperimentalDisplay name: Kubernetes EdgeConnect nameName of the EdgeConnect.
my-edgeconnect
Kubernetes EdgeConnect relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
belongs_to
K8S_CUSTOMRESOURCEDEFINITION
static
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).
Kubernetes cluster
Smartscape node name: k8s.cluster.name
Smartscape node type: K8S_CLUSTER
This entity represents a Kubernetes cluster object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_CLUSTER".
smartscapeNodes"K8S_CLUSTER"
Fetch all Kubernetes Smartscape nodes and count them per cluster name and type
// query all entities where type starts with K8S_
// this gives you a list of your different Kubernetes objects represented in Dynatrace
smartscapeNodes"K8S_*"
// count entities per cluster and type
|summarize count(), by: {k8s.cluster.name, type}
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid
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
[]
Kubernetes configuration fields
Attribute
Type
Description
Examples
k8s.cluster.version
string
experimentalDisplay name: Kubernetes cluster versionVersion of the Kubernetes cluster.
v1.29.1-eks-b9c9ed7
k8s.cluster.distribution
string
experimentalDisplay name: Kubernetes cluster distributionThe name of the Kubernetes distribution.
EKS; AKS; GKE; OpenShift
Kubernetes cluster 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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes config map
Smartscape node name: k8s.configmap.name
Smartscape node type: K8S_CONFIGMAP
This entity represents a Kubernetes config map object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_CONFIGMAP".
smartscapeNodes"K8S_CONFIGMAP"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.configmap.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes config map fields
Attribute
Type
Description
Examples
k8s.configmap.name
string
resourceexperimentalDisplay name: Kubernetes ConfigMap nameName of the ConfigMap.
my-configmap
Kubernetes config map relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
Kubernetes cron job
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_CRONJOB
This entity represents a Kubernetes cron job object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_CRONJOB".
smartscapeNodes"K8S_CRONJOB"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes cron job fields
Attribute
Type
Description
Examples
k8s.cronjob.name
string
resourceexperimentalDisplay name: Kubernetes CronJob nameName of the CronJob.
my-cronjob
Kubernetes cron job relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
This entity represents a Kubernetes custom resource definition object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_CUSTOMRESOURCEDEFINITION".
smartscapeNodes"K8S_CUSTOMRESOURCEDEFINITION"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.customresourcedefinition.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes custom resource definition fields
Attribute
Type
Description
Examples
k8s.customresourcedefinition.name
string
resourceexperimentalDisplay name: Kubernetes CustomResourceDefinition nameName of the CustomResourceDefinition.
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).
Kubernetes daemon set
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_DAEMONSET
This entity represents a Kubernetes daemon set object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_DAEMONSET".
smartscapeNodes"K8S_DAEMONSET"
Find all workloads that are missing liveness/readiness probes.
// query all workloads across all Kubernetes clusters
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes daemon set fields
Attribute
Type
Description
Examples
k8s.daemonset.name
string
resourceexperimentalDisplay name: Kubernetes DaemonSet nameName of the DaemonSet.
my-daemonset
Kubernetes daemon set relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
Kubernetes deployment
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_DEPLOYMENT
This entity represents a Kubernetes deployment object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_DEPLOYMENT".
smartscapeNodes"K8S_DEPLOYMENT"
Query and parse the YAML of a Kubernetes deployment object.
// query Kubernetes workloads of type deployment
smartscapeNodes"K8S_DEPLOYMENT"
// parse the yaml (json)
|parse k8s.object, "JSON:k8s.object"
// only show configuration of first deployment
|limit1
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes deployment fields
Attribute
Type
Description
Examples
k8s.deployment.name
string
resourceexperimentalDisplay name: Kubernetes Deployment nameName of the Deployment.
my-deployment
Kubernetes deployment relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
Kubernetes deployment config
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_DEPLOYMENTCONFIG
This entity represents a Kubernetes (OpenShift) deployment config object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_DEPLOYMENTCONFIG".
smartscapeNodes"K8S_DEPLOYMENTCONFIG"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes deployment config fields
Attribute
Type
Description
Examples
k8s.deploymentconfig.name
string
resourceexperimentalDisplay name: Kubernetes DeploymentConfig nameName of the DeploymentConfig.
my-deploymentconfig
Kubernetes deployment config relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
This entity represents a Kubernetes horizontal pod autoscaler object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_HORIZONTALPODAUTOSCALER".
smartscapeNodes"K8S_HORIZONTALPODAUTOSCALER"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.horizontalpodautoscaler.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes horizontal pod autoscaler fields
Attribute
Type
Description
Examples
k8s.horizontalpodautoscaler.name
string
resourceexperimentalDisplay name: Kubernetes HorizontalPodAutoscaler nameName of the HorizontalPodAutoscaler.
my-horizontalpodautoscaler
Kubernetes horizontal pod autoscaler relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
uses
K8S_DEPLOYMENT
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_STATEFULSET
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_REPLICASET
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_REPLICATIONCONTROLLER
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_DEPLOYMENTCONFIG
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
Kubernetes ingress
Smartscape node name: k8s.ingress.name
Smartscape node type: K8S_INGRESS
This entity represents a Kubernetes ingress object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_INGRESS".
smartscapeNodes"K8S_INGRESS"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.ingress.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes ingress fields
Attribute
Type
Description
Examples
k8s.ingress.name
string
resourceexperimentalDisplay name: Kubernetes Ingress nameName of the Ingress.
my-ingress
Kubernetes ingress relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
routes_to
K8S_SERVICE
static
stableDefine network route to the instance Examples: EC2 route table routes to EC2 NAT Gateway EC2 VPC Peering Connection routes to VPC
Kubernetes job
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_JOB
This entity represents a Kubernetes job object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_JOB".
smartscapeNodes"K8S_JOB"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes job fields
Attribute
Type
Description
Examples
k8s.job.name
string
resourceexperimentalDisplay name: Kubernetes Job nameName of the Job.
my-job
Kubernetes job relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
is_part_of
K8S_CRONJOB
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
Kubernetes namespace
Smartscape node name: k8s.namespace.name
Smartscape node type: K8S_NAMESPACE
This entity represents a Kubernetes namespace object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_NAMESPACE".
smartscapeNodes"K8S_NAMESPACE"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes namespace relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
Kubernetes network policy
Smartscape node name: k8s.networkpolicy.name
Smartscape node type: K8S_NETWORKPOLICY
This entity represents a Kubernetes network policy object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_NETWORKPOLICY".
smartscapeNodes"K8S_NETWORKPOLICY"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.networkpolicy.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes network policy fields
Attribute
Type
Description
Examples
k8s.networkpolicy.name
string
resourceexperimentalDisplay name: Kubernetes NetworkPolicy nameName of the NetworkPolicy.
my-networkpolicy
Kubernetes network policy relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
Kubernetes node
Smartscape node name: k8s.node.name
Smartscape node type: K8S_NODE
This entity represents a Kubernetes node object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_NODE.
smartscapeNodes"K8S_NODE"
Query all unschedulable Kubernetes nodes across all Kubernetes clusters.
// query all k8s nodes
smartscapeNodes K8S_NODE
// parse the yaml (json)
|parse k8s.object, "JSON:object"
// drop unused fields
|fieldsKeep k8s.node.name, object
// extract the json-path object.spec.taints into a separate column
|fieldsAdd taints = object[spec][taints]
// expand into separate entry (row) per taint; (3 taints on one node, results in 3 rows)
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.node.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes node fields
Attribute
Type
Description
Examples
k8s.node.name
string
resourcestableDisplay name: Kubernetes node nameName of the node.
cluster-pool-1-c3c7423d-azth
Kubernetes node relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
runs_on
HOST
static
stableDefines a "vertical" relation of an entity running on some other entity. It does not imply any composition or aggregation but only a looser association between the entities. One entity can run on multiple other entities. Examples: Service running on a POD, a CONTAINER or a HOST.
Kubernetes persistent volume
Smartscape node name: k8s.persistentvolume.name
Smartscape node type: K8S_PERSISTENTVOLUME
This entity represents a Kubernetes persistent volume object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_PERSISTENTVOLUME".
smartscapeNodes"K8S_PERSISTENTVOLUME"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.persistentvolume.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes persistent volume fields
Attribute
Type
Description
Examples
k8s.persistentvolume.name
string
resourceexperimentalDisplay name: Kubernetes PersistentVolume nameName of the PersistentVolume.
my-persistentvolume
Kubernetes persistent volume relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
is_attached_to
K8S_PERSISTENTVOLUMECLAIM
static
stableIs (typically) exclusively attached to the instance (1-many)
This entity represents a Kubernetes persistent volume claim object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_PERSISTENTVOLUMECLAIM".
smartscapeNodes"K8S_PERSISTENTVOLUMECLAIM"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.persistentvolumeclaim.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes persistent volume claim fields
Attribute
Type
Description
Examples
k8s.persistentvolumeclaim.name
string
resourceexperimentalDisplay name: Kubernetes PersistentVolumeClaim nameName of the PersistentVolumeClaim.
my-persistentvolumeclaim
Kubernetes persistent volume claim relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
uses
K8S_PERSISTENTVOLUME
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
Kubernetes pod
Smartscape node name: k8s.pod.name
Smartscape node type: K8S_POD
This entity represents a Kubernetes pod object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_POD".
smartscapeNodes K8S_POD
Find container image versions that violate best practices. Display any application container image that does not pin the SHA digest of a specific container image version.
Find namespaces running outdated or "latest" container images. Display namespaces that run Alpine image <= v3 or MySQL <= 5.7, or use the :latest image-tag.
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.pod.uid
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes pod fields
Attribute
Type
Description
Examples
k8s.node.name
string
resourcestableDisplay name: Kubernetes node nameName of the node.
cluster-pool-1-c3c7423d-azth
k8s.pod.name
string
resourcestableDisplay name: Kubernetes pod nameThe name of the pod.
checkoutservice-7895755b94-mzs5m
k8s.pod.uid
string
resourcestableDisplay name: Kubernetes pod UIDThe UID of the pod.
275ecb36-5aa8-4c2a-9c47-d8bb681b9aff
k8s.pod.phase
string
resourceexperimentalThe pod phase is a simple status showing where a Pod is in its lifecycle.
Failed; Pending; Running; Succeeded; Unknown
k8s.pod.deletion_timestamp
timestamp
resourceexperimentalThe RFC 3339 date and time at which the Pod will be deleted.
2026-04-01T10:15:30Z
k8s.pod.phase MUST be one of the following:
Value
Description
Failed
At least one container terminated with an error (non-zero exit code).
Pending
Pod is created but not yet running.
Running
Pod is scheduled on a node and at least one container is running.
Succeeded
All containers finished successfully (exit code 0) and won’t restart.
Unknown
Pod state cannot be determined (usually communication issue with node).
Kubernetes pod relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
runs_on
K8S_NODE
static
stableDefines a "vertical" relation of an entity running on some other entity. It does not imply any composition or aggregation but only a looser association between the entities. One entity can run on multiple other entities. Examples: Service running on a POD, a CONTAINER or a HOST.
is_part_of
K8S_REPLICASET
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_DEPLOYMENT
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_STATEFULSET
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_DAEMONSET
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_JOB
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_CRONJOB
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_REPLICATIONCONTROLLER
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
is_part_of
K8S_DEPLOYMENTCONFIG
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
uses
K8S_PERSISTENTVOLUMECLAIM
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_CONFIGMAP
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
uses
K8S_SECRET
static
stableSimilar to is_attached_to but in the opposite direction. Examples: EC2 Instance uses DHCP options, Auto Scaling Group uses EC2 Launch Template
Kubernetes replica set
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_REPLICASET
This entity represents a Kubernetes replica set object.
Query
Fetch all Smartscape nodes from the smartscape.nodessmartscape.nodes table and filter for the entity type "K8S_REPLICASET".
smartscapeNodes"K8S_REPLICASET"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes replica set fields
Attribute
Type
Description
Examples
k8s.replicaset.name
string
resourceexperimentalDisplay name: Kubernetes ReplicaSet nameName of the ReplicaSet.
my-replicaset
Kubernetes replica set relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
is_part_of
K8S_DEPLOYMENT
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
Kubernetes replication controller
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_REPLICATIONCONTROLLER
This entity represents a Kubernetes replication controller object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_REPLICATIONCONTROLLER".
smartscapeNodes"K8S_REPLICATIONCONTROLLER"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes replication controller fields
Attribute
Type
Description
Examples
k8s.replicationcontroller.name
string
resourceexperimentalDisplay name: Kubernetes ReplicationController nameName of the ReplicationController.
my-replicationcontroller
Kubernetes replication controller relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
is_part_of
K8S_DEPLOYMENTCONFIG
static
stableDefines if the instance is part of a cluster, similar to a composition in UML. The source (child) cannot exist without the destination (parent).
Kubernetes secret
Smartscape node name: k8s.secret.name
Smartscape node type: K8S_SECRET
This entity represents a Kubernetes secret object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_SECRET".
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.secret.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes secret fields
Attribute
Type
Description
Examples
k8s.secret.name
string
resourceexperimentalDisplay name: Kubernetes Secret nameName of the Secret.
my-secret
Kubernetes secret relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
Kubernetes service
Smartscape node name: k8s.service.name
Smartscape node type: K8S_SERVICE
This entity represents a Kubernetes service object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_SERVICE".
smartscapeNodes"K8S_SERVICE"
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.service.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes service fields
Attribute
Type
Description
Examples
k8s.service.name
string
resourcestableDisplay name: Kubernetes service nameThe name of the Kubernetes service.
my-service
Kubernetes service relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).
routes_to
K8S_POD
static
stableDefine network route to the instance Examples: EC2 route table routes to EC2 NAT Gateway EC2 VPC Peering Connection routes to VPC
Kubernetes stateful set
Smartscape node name: k8s.workload.name
Smartscape node type: K8S_STATEFULSET
This entity represents a Kubernetes stateful set object.
Query
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "K8S_STATEFULSET".
smartscapeNodes"K8S_STATEFULSET"
Find all deployments and statefulsets that do not have a certain annotation set.
// query all entities
smartscapeNodes"*"
// filter for only Kubernetes statefulsets and deployments
// sort namespaces by top number of violating workloads
|sort num_workloads desc
// only show top 10
|limit10
ID input
The ID is calculated based on the following fields in the defined order: k8s.cluster.uid, k8s.namespace.name, k8s.workload.kind, k8s.workload.name
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
[]
Kubernetes entity fields
Fields that are provided by all Kubernetes entities.
Attribute
Type
Description
Examples
k8s.object
string
experimentalDisplay name: Kubernetes objectThe full JSON content of any Kubernetes object.
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
k8s.cluster.uid
string
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
Kubernetes namespaced entity fields
Fields that are provided by all Kubernetes entities that exist in a Kubernetes namespace.
Attribute
Type
Description
Examples
k8s.namespace.name
string
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
Kubernetes workload fields
Fields that are provided by all Kubernetes workloads.
Attribute
Type
Description
Examples
k8s.workload.kind
string
resourcestableDisplay name: Kubernetes workload kindThe type of the workload. The value is the Kubernetes object kind of the workload in lowercase.
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
Kubernetes stateful set fields
Attribute
Type
Description
Examples
k8s.statefulset.name
string
resourceexperimentalDisplay name: Kubernetes StatefulSet nameName of the StatefulSet.
my-statefulset
Kubernetes stateful set relationships
Type
Target type
Kind
Description
belongs_to
K8S_CLUSTER
static
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).
belongs_to
K8S_NAMESPACE
static
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).