Defines preconfigured Smartscape entities for Google Cloud assets from Cloud Asset Inventory. All entity types use the GCP_* prefix.
Get an overview of all GCP entities.
smartscapeNodes "GCP_*"| summarize by:type, count()
| Attribute | Type | Description | Examples |
|---|---|---|---|
cloud.provider | string | resource stable Display name: Cloud providerName of the cloud provider. | alibaba_cloud |
gcp.asset.type | string | experimental Display name: GCP asset typeThe 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 locationRegion or zone where GCP resource instance is running. | europe-west3-c |
gcp.project.id | string | resource stable Display name: GCP project IDIdentifier of the GCP project associated with this resource. Tags: permission primary-field | dynatrace-gcp-extension |
gcp.region | string | resource stable Display name: GCP regionA 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 nameThe 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 typeThe name of a monitored resource type available in Google Cloud Monitoring and Logging. | cloudsql_database |
gcp.zone | string | resource stable Display name: GCP zoneA 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 |
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
The gcp.object field contains the configuration of the latest version of Google Cloud asset inveotry asset, as JSON string.
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)
All Google Cloudentities support the following fields to set up permissions:
gcp.project.iddt.security_contextSmartscape 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.
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_PROJECT".
smartscapeNodes "GCP_PROJECT"
The following base fields are used for all entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
id | smartscapeId | stable Display 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 | deprecated Display 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 | stable Display name: NameThe entity name. | localhost; easyTravel; product-catalog |
type | string | stable Display name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity. Tags: permission | TYPE_A |
tags | record | stable Display 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. | 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: 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. | { start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z } |
references | record | stable Display 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. | { references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] } |
dt.security_context | string[] | resource stable Display name: DT security contextThe security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission | [] |
Contains the fields shared by all GCP entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
gcp.state | string | experimental Display name: GCP stateThe provisioning state of the instance | PROVISIONING; STAGING; RUNNING; PENDING_STOP; STOPPING; TERMINATED; REPAIRING; SUSPENDING; SUSPENDED |
gcp.object | string | experimental Display name: GCP objectThe 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 versionThe gcp.object json content version | v1 |
gcp.organization.id | string | resource experimental Display name: GCP organization IDUnique, immutable identifier assigned to an organization resource. | 123456789012 |
Fields that are provided by all Cloud workloads.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cloud.acquisition.status | string | experimental Display name: Cloud acquisition statusThe status of Smartscape nodes data acquisition by Data Acquisition Controller: OK —node is consistent; DELETED —node was deleted in the cloud platform; ERROR —there was an error acquiring the node, but the node was upserted; INCOMPLETE —there was an error acquiring the node child resource (for example an EC2 instance with no EBS volumes due to missing permissions), but the node was upserted. | OK; DELETED; ERROR; INCOMPLETE |
| Attribute | Type | Description | Examples |
|---|---|---|---|
gcp.project.number | string | experimental Display name: GCP project numberThe project number is a unique numeric identifier for a project. | 123456789012 |
gcp.project.name | string | experimental Display name: GCP project nameThe human-readable name for the project. | My Project |
cloud.provider | string | resource stable Display name: Cloud providerName of the cloud provider. | alibaba_cloud |
gcp.project.id | string | resource stable Display name: GCP project IDIdentifier 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 IDUnique, 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 |
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.
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_REGION".
smartscapeNodes "GCP_REGION"
The following base fields are used for all entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
id | smartscapeId | stable Display 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 | deprecated Display 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 | stable Display name: NameThe entity name. | localhost; easyTravel; product-catalog |
type | string | stable Display name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity. Tags: permission | TYPE_A |
tags | record | stable Display 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. | 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: 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. | { start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z } |
references | record | stable Display 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. | { references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] } |
dt.security_context | string[] | resource stable Display name: DT security contextThe security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission | [] |
Fields that are provided by all Cloud workloads.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cloud.acquisition.status | string | experimental Display name: Cloud acquisition statusThe status of Smartscape nodes data acquisition by Data Acquisition Controller: OK —node is consistent; DELETED —node was deleted in the cloud platform; ERROR —there was an error acquiring the node, but the node was upserted; INCOMPLETE —there was an error acquiring the node child resource (for example an EC2 instance with no EBS volumes due to missing permissions), but the node was upserted. | OK; DELETED; ERROR; INCOMPLETE |
| Attribute | Type | Description | Examples |
|---|---|---|---|
status | string | experimental Display name: StatusStatus of the region. | UP |
cloud.provider | string | resource stable Display name: Cloud providerName of the cloud provider. | alibaba_cloud |
gcp.region | string | resource stable Display name: GCP regionA 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 |
Smartscape node name: gcp.zone
Smartscape node type: GCP_ZONE
Dynatrace entity for a Google Cloud zone, a deployment area within a region.
Fetch all Smartscape nodes from the smartscape.nodes table and filter for the entity type "GCP_ZONE".
smartscapeNodes "GCP_ZONE"
The following base fields are used for all entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
id | smartscapeId | stable Display 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 | deprecated Display 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 | stable Display name: NameThe entity name. | localhost; easyTravel; product-catalog |
type | string | stable Display name: TypeThe entity type. UPPER_SNAKE_CASE string that represents the type of the entity. Tags: permission | TYPE_A |
tags | record | stable Display 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. | 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: 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. | { start: 2022-07-06T13:36:00.808Z, end: 2024-04-11T06:56:01.204Z } |
references | record | stable Display 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. | { references[runs_on.host] : [HOST-C251A1173C2B4B39,HOST-0E9038C7C4409D69], references[runs_on.container] : [CONTAINER-68A08967EF4F675B] } |
dt.security_context | string[] | resource stable Display name: DT security contextThe security contexts associated with the entity. For Smartscape entities, this field is always an array. Tags: permission | [] |
Contains the fields shared by all GCP entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
gcp.state | string | experimental Display name: GCP stateThe provisioning state of the instance | PROVISIONING; STAGING; RUNNING; PENDING_STOP; STOPPING; TERMINATED; REPAIRING; SUSPENDING; SUSPENDED |
gcp.object | string | experimental Display name: GCP objectThe 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 versionThe gcp.object json content version | v1 |
gcp.organization.id | string | resource experimental Display name: GCP organization IDUnique, immutable identifier assigned to an organization resource. | 123456789012 |
Fields that are provided by all Cloud workloads.
| Attribute | Type | Description | Examples |
|---|---|---|---|
cloud.acquisition.status | string | experimental Display name: Cloud acquisition statusThe status of Smartscape nodes data acquisition by Data Acquisition Controller: OK —node is consistent; DELETED —node was deleted in the cloud platform; ERROR —there was an error acquiring the node, but the node was upserted; INCOMPLETE —there was an error acquiring the node child resource (for example an EC2 instance with no EBS volumes due to missing permissions), but the node was upserted. | OK; DELETED; ERROR; INCOMPLETE |
| Attribute | Type | Description | Examples |
|---|---|---|---|
cloud.provider | string | resource stable Display name: Cloud providerName of the cloud provider. | alibaba_cloud |
gcp.region | string | resource stable Display name: GCP regionA 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 zoneA 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 |
| 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). |