Smartscape - Google Cloud Platform

Latest Dynatrace
Reference

Defines preconfigured Smartscape entities for Google Cloud assets from Cloud Asset Inventory. All entity types use the GCP_* prefix.

Query

Get an overview of all GCP entities.

smartscapeNodes "GCP_*"
| summarize by:type, count()

GCP resource fields

Attribute	Type	Description	Examples
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.asset.type`	string	experimental Display name: `GCP asset type` The asset type available in Google Cloud Asset Inventory. These include resource types, policy types, and runtime information types.	`sqladmin.googleapis.com/Instance`; `k8s.io/ServiceAccount`; `iam.googleapis.com/Role`
`gcp.location`	string	resource stable Display name: `GCP location` Region or zone where GCP resource instance is running.	`europe-west3-c`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`gcp.resource.name`	string	resource stable Display name: `GCP resource name` The globally unique resource name in Google Cloud Platform convention.	`//cloudfunctions.googleapis.com/projects/gcp-example-project/locations/us-central1/functions/examplefunction`
`gcp.resource.type`	string	resource stable Display name: `GCP resource type` The name of a monitored resource type available in Google Cloud Monitoring and Logging.	`cloudsql_database`
`gcp.zone`	string	resource stable Display name: `GCP zone` A zone is a subset of a region. Each region has three or more zones.	`europe-west3-c`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

ID giving fields

The Smartscape ID for a given entity is calculated based on the Google asset cloudname of the Google Cloud resource, unique, immutable identifier defined in https://docs.cloud.google.com/asset-inventory/docs/asset-names

Goglc Cloudobject

The gcp.object field contains the configuration of the latest version of Google Cloud asset inveotry asset, as JSON string.

Google Cloud tags and labels

All Google CLoud labels of an entity are captured automatically and available via the tags:gcp_labels and additionally via the tags field. E.g. to access the CREATED_BY tag you can use tags[CREATED_BY]. In addition to labels, entities are also enriched with GCP tags via the tags:gcp_tags field (also accesible with tags field where tags and labels are merged)

Permission fields

All Google Cloudentities support the following fields to set up permissions:

gcp.project.id
dt.security_context

Google Cloud Project

Smartscape node name: gcp.project.id

Smartscape node type: GCP_PROJECT

Dynatrace entity for a Google Cloud project, the top-level organizational entity for resources, billing, and IAM.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_PROJECT".

smartscapeNodes "GCP_PROJECT"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

GCP entity fields

Contains the fields shared by all GCP entities.

Attribute	Type	Description	Examples
`gcp.state`	string	experimental Display name: `GCP state` The provisioning state of the instance	`PROVISIONING`; `STAGING`; `RUNNING`; `PENDING_STOP`; `STOPPING`; `TERMINATED`; `REPAIRING`; `SUSPENDING`; `SUSPENDED`
`gcp.object`	string	experimental Display name: `GCP object` The full JSON payload of the resource as returned by the Google Cloud Asset Inventory API (the `resource` portion of the asset, including `data` and any supplementary configuration).
`gcp.properties.version`	string	experimental Display name: `GCP properties version` The gcp.object json content version	`v1`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Project fields

Attribute	Type	Description	Examples
`gcp.project.number`	string	experimental Display name: `GCP project number` The project number is a unique numeric identifier for a project.	`123456789012`
`gcp.project.name`	string	experimental Display name: `GCP project name` The human-readable name for the project.	`My Project`
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Region

Smartscape node name: gcp.region

Smartscape node type: GCP_REGION

Dynatrace entity for a Google Cloud region, a geographic area that contains one or more zones.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_REGION".

smartscapeNodes "GCP_REGION"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Region fields

Attribute	Type	Description	Examples
`status`	string	experimental Display name: `Status` Status of the region.	`UP`
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Zone

Smartscape node name: gcp.zone

Smartscape node type: GCP_ZONE

Dynatrace entity for a Google Cloud zone, a deployment area within a region.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_ZONE".

smartscapeNodes "GCP_ZONE"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

GCP entity fields

Contains the fields shared by all GCP entities.

Attribute	Type	Description	Examples
`gcp.state`	string	experimental Display name: `GCP state` The provisioning state of the instance	`PROVISIONING`; `STAGING`; `RUNNING`; `PENDING_STOP`; `STOPPING`; `TERMINATED`; `REPAIRING`; `SUSPENDING`; `SUSPENDED`
`gcp.object`	string	experimental Display name: `GCP object` The full JSON payload of the resource as returned by the Google Cloud Asset Inventory API (the `resource` portion of the asset, including `data` and any supplementary configuration).
`gcp.properties.version`	string	experimental Display name: `GCP properties version` The gcp.object json content version	`v1`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Zone fields

Attribute	Type	Description	Examples
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`gcp.zone`	string	resource stable Display name: `GCP zone` A zone is a subset of a region. Each region has three or more zones.	`europe-west3-c`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Zone relationships

Type	Target type	Kind	Description
`belongs_to`	`GCP_REGION`	static	stable This is similar to an aggregation in UML. It is a many-to-many relationship without existential properties (the destination is not composed of the sources).

Smartscape - Google Cloud Platform

Latest Dynatrace
Reference

Defines preconfigured Smartscape entities for Google Cloud assets from Cloud Asset Inventory. All entity types use the GCP_* prefix.

Query

Get an overview of all GCP entities.

smartscapeNodes "GCP_*"
| summarize by:type, count()

GCP resource fields

Attribute	Type	Description	Examples
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.asset.type`	string	experimental Display name: `GCP asset type` The asset type available in Google Cloud Asset Inventory. These include resource types, policy types, and runtime information types.	`sqladmin.googleapis.com/Instance`; `k8s.io/ServiceAccount`; `iam.googleapis.com/Role`
`gcp.location`	string	resource stable Display name: `GCP location` Region or zone where GCP resource instance is running.	`europe-west3-c`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`gcp.resource.name`	string	resource stable Display name: `GCP resource name` The globally unique resource name in Google Cloud Platform convention.	`//cloudfunctions.googleapis.com/projects/gcp-example-project/locations/us-central1/functions/examplefunction`
`gcp.resource.type`	string	resource stable Display name: `GCP resource type` The name of a monitored resource type available in Google Cloud Monitoring and Logging.	`cloudsql_database`
`gcp.zone`	string	resource stable Display name: `GCP zone` A zone is a subset of a region. Each region has three or more zones.	`europe-west3-c`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

ID giving fields

Goglc Cloudobject

The gcp.object field contains the configuration of the latest version of Google Cloud asset inveotry asset, as JSON string.

Google Cloud tags and labels

Permission fields

All Google Cloudentities support the following fields to set up permissions:

gcp.project.id
dt.security_context

Google Cloud Project

Smartscape node name: gcp.project.id

Smartscape node type: GCP_PROJECT

Dynatrace entity for a Google Cloud project, the top-level organizational entity for resources, billing, and IAM.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_PROJECT".

smartscapeNodes "GCP_PROJECT"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

GCP entity fields

Contains the fields shared by all GCP entities.

Attribute	Type	Description	Examples
`gcp.state`	string	experimental Display name: `GCP state` The provisioning state of the instance	`PROVISIONING`; `STAGING`; `RUNNING`; `PENDING_STOP`; `STOPPING`; `TERMINATED`; `REPAIRING`; `SUSPENDING`; `SUSPENDED`
`gcp.object`	string	experimental Display name: `GCP object` The full JSON payload of the resource as returned by the Google Cloud Asset Inventory API (the `resource` portion of the asset, including `data` and any supplementary configuration).
`gcp.properties.version`	string	experimental Display name: `GCP properties version` The gcp.object json content version	`v1`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Project fields

Attribute	Type	Description	Examples
`gcp.project.number`	string	experimental Display name: `GCP project number` The project number is a unique numeric identifier for a project.	`123456789012`
`gcp.project.name`	string	experimental Display name: `GCP project name` The human-readable name for the project.	`My Project`
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.project.id`	string	resource stable Display name: `GCP project ID` Identifier of the GCP project associated with this resource. Tags: `permission` `primary-field`	`dynatrace-gcp-extension`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Region

Smartscape node name: gcp.region

Smartscape node type: GCP_REGION

Dynatrace entity for a Google Cloud region, a geographic area that contains one or more zones.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_REGION".

smartscapeNodes "GCP_REGION"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Region fields

Attribute	Type	Description	Examples
`status`	string	experimental Display name: `Status` Status of the region.	`UP`
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Zone

Smartscape node name: gcp.zone

Smartscape node type: GCP_ZONE

Dynatrace entity for a Google Cloud zone, a deployment area within a region.

Query

Fetch all smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_ZONE".

smartscapeNodes "GCP_ZONE"

Base entity fields

The following base fields are used for all entities.

Attribute	Type	Description	Examples
`id`	smartscapeId	stable Display name: `ID` A Smartscape ID consists of two components: an UPPER_CASE entity type and a random 16-character hexadecimal unique identifier, separated by a dash. Use Smartscape conversion functions when working with strings that represent Smartscape IDs.	`<type>-017198AD253CBD63`
`id_classic`	string	deprecated Display name: `Classic ID` The entity ID that was used in the classic entity store. This ID is present in old monitoring data. Not all entities have this ID, and it is not generated for new entities. Use the `id` field instead, which is the Smartscape ID.	`<type>-017198AD253CBD63`
`name`	string	stable Display name: `Name` The entity name.	`localhost`; `easyTravel`; `product-catalog`
`type`	string	stable Display name: `Type` The entity type. UPPER_SNAKE_CASE string that represents the type of the entity.	`TYPE_A`
`tags`	record	stable Display name: `Tags` A consolidated record that aggregates all tag values originating from different contexts. Each nested field within tags represents a specific key (for example, `release` or `name`). The value of each nested field is the tag value from one or multiple contexts. Tags for specific context can be queried via `tags:context` field. Note that rule-based tags do not exist in the new model.	`tags[tag_key-1] = [context_A_tag_val-1, context_B_tag_val-1]`; `tags[tag_key-2] = context_C_tag_val-1`; `tags:context_A[tag_key-1] = context_A_tag_val-1`
`lifetime`	timeframe	stable Display name: `Lifetime` The lifetime of the entity. This is a record with two nested fields: `start` and `end`, which represent the time when the entity was first and last observed, respectively. Each time an entity is updated, the end time is updated to the current time.	`{ start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z }`
`references`	record	stable Display name: `References` Provides access to static edges pointing to other entities. In this record each nested field represents a relationship type and target type, and the value is an array of target smartscape IDs. This field is hidden by default but can be added using the fieldsAdd command.	`{ references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] }`
`dt.security_context`	string[]	resource stable Display name: `DT security context` The security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: `permission`	`[]`

GCP entity fields

Contains the fields shared by all GCP entities.

Attribute	Type	Description	Examples
`gcp.state`	string	experimental Display name: `GCP state` The provisioning state of the instance	`PROVISIONING`; `STAGING`; `RUNNING`; `PENDING_STOP`; `STOPPING`; `TERMINATED`; `REPAIRING`; `SUSPENDING`; `SUSPENDED`
`gcp.object`	string	experimental Display name: `GCP object` The full JSON payload of the resource as returned by the Google Cloud Asset Inventory API (the `resource` portion of the asset, including `data` and any supplementary configuration).
`gcp.properties.version`	string	experimental Display name: `GCP properties version` The gcp.object json content version	`v1`
`gcp.organization.id`	string	resource experimental Display name: `GCP organization ID` Unique, immutable identifier assigned to an organization resource.	`123456789012`

Cloud entity fields

Fields that are provided by all Cloud workloads.

Attribute	Type	Description	Examples
`cloud.acquisition.status`	string	experimental Display name: `Cloud acquisition status` The status of Smartscape nodes data acquisition by Data Acquisition Conroller `OK` - node is consistent `DELETED` - node was deleted in the cloud platform `ERROR` - there was an error acquiring node, but the node was upserted `INCOMPLETE` - there was an error acquiring node child resource (ie. EC2 Instance, with no EBS volumes due to missing permissions) , but the node was upserted.	`OK`; `DELETED`; `ERROR`; `INCOMPLETE`

Google Cloud Zone fields

Attribute	Type	Description	Examples
`cloud.provider`	string	resource stable Display name: `Cloud provider` Name of the cloud provider.	`alibaba_cloud`
`gcp.region`	string	resource stable Display name: `GCP region` A region is a specific geographical location where you can host your resources. Tags: `primary-field`	`europe-west3`
`gcp.zone`	string	resource stable Display name: `GCP zone` A zone is a subset of a region. Each region has three or more zones.	`europe-west3-c`

cloud.provider has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value	Description	Display name
`alibaba_cloud`	Alibaba Cloud	Alibaba Cloud
`aws`	Amazon Web Services	AWS
`azure`	Microsoft Azure	Azure
`gcp`	Google Cloud Platform	GCP
`heroku`	Heroku Platform as a Service	Heroku
`ibm_cloud`	IBM Cloud	IBM Cloud
`tencent_cloud`	Tencent Cloud	Tencent Cloud

Google Cloud Zone relationships

Type	Target type	Kind	Description
`belongs_to`	`GCP_REGION`	static	stable This is similar to an aggregation in UML. It is a many-to-many relationship without existential properties (the destination is not composed of the sources).