Migrate to GCP integration version 1.0
Dynatrace version 1.230+
The new version of the GCP integration (v.1.0) uses Extensions 2.0 and introduces custom topology for a number of GCP services.
Google Compute Engine
Google Cloud Storage
Google Cloud Functions
Google Cloud Run
Google App Engine
Google Cloud Tasks
Google Cloud SQL
Google Cloud Datastore
Google Load Balancing
Google Cloud NAT Gateway
Google Filestore
Google Kubernetes Engine
Google Pub/Sub
Google Pub/Sub Lite
Google Memorystore
Google Spanner
Note that your existing metric dimension names will change when you switch to GCP integration using Dynatrace Extensions 2.0. Dimension name changes affect all configured managements zones, custom alerts, and custom dashboards in your environment. To restore proper functionality for these entities, please follow the instructions below.
Upgrading existing dynatrace-gcp-monitor installations from earlier versions is not supported. You need to first delete your existing deployment and then install the GCP integration v.1.0. For instructions, see below.
Delete existing deployment
Remove dashboards and/or alerts
Install new GCP deployment
Update dimensions
Delete existing deployment
-
Find out what release version you're using.
1helm ls -n dynatrace -
Uninstall the release.
Be sure to replace
<release-name>with the release name from the previous output.1helm uninstall <release-name> -n dynatrace
Remove dashboards and/or alerts
You need to manually remove any dashboards or alerts created manually during the previous installation.
Install new GCP deployment
To install the new GCP deployment, see Set up the Dynatrace GCP metric and log integration (v.1.0) on a new GKE Autopilot cluster.
Update dimensions
If you created your own dashboards, alerts, or management zones based on GCP metrics, you need to manually update the dimensions according to the list below in order to get links for entities.
| Old dimension name | New dimension name |
|---|---|
project_id | gcp.project.id |
region | gcp.region |
zone | gcp.region |
instance_id | gcp.instance.id |
autoscaler_id | gcp.instance.id |
model_id | gcp.instance.id |
queue_id | gcp.instance.id |
device_registry_id | gcp.instance.id |
job_id | gcp.instance.id |
version_id | gcp.instance.id |
database_id | gcp.instance.id |
volume_id | gcp.instance.id |
router_id | gcp.instance.id |
instance_group_id | gcp.instance.id |
interconnect | gcp.instance.id |
attachment | gcp.instance.id |
volume_id | gcp.instance.id |
snapshot_id | gcp.instance.id |
subscription_id | gcp.instance.id |
topic_id | gcp.instance.id |
key_id | gcp.instance.id |
worker_id | gcp.instance.id |
agent_id | gcp.instance.id |
gateway_id | gcp.instance.id |
name | gcp.instance.name |
autoscaler_name | gcp.instance.name |
environment_name | gcp.instance.name |
cluster_name gcp.instance.name | gcp.instance.name |
function_name gcp.instance.name | gcp.instance.name |
revision_name | gcp.instance.name |
job_name | gcp.instance.name |
instance_name | gcp.instance.name |
domain_name | gcp.instance.name |
table_name | gcp.instance.name |
firewall_name | gcp.instance.name |
bucket_name | gcp.instance.name |
container_name | gcp.instance.name |
url_map_name | gcp.instance.name |
instance_group_name | gcp.instance.name |
load_balancer_name | gcp.instance.name |
canonical_service_name | gcp.instance.name |
node_name | gcp.instance.name |
pod_name | gcp.instance.name |
broker_name | gcp.instance.name |
revision_name | gcp.instance.name |
trigger_name | gcp.instance.name |
fqdn | gcp.instance.name |
target_domain_name | gcp.instance.name |
gateway_name | gcp.instance.name |
policy_name | gcp.instance.name |
proxy_name | gcp.instance.name |
load_balancer_name | gcp.instance.name |
backend_target_name | gcp.instance.name |
connector_name | gcp.instance.name |
gateway_name | gcp.instance.name |
- To update dimensions for dashboards
- In the Dynatrace menu, go to Dashboards.
- Select the dashboard for which you want to update dimensions, and then select More (…) > Configure.
- Select Dashboard JSON.
- In the
"splitBy"section, replace the old dimensions with the new values as determined from the list of dimension changes. - Select Save changes.
Alternatively, you can replace the dimensions by configuring each dashboard tile of a selected dashboard in Data explorer.
-
To update dimensions for alerts
- In the Dynatrace menu, go to Settings.
- In Anomaly detection, select Metric events.
Select the event for which you want to update dimensions.
- In the Add dimension filter field, select the new dimension keys and enter the corresponding dimension values as determined from the list of dimension changes.
- Select Save changes.
-
To update dimensions for management zones
- In the Dynatrace menu, go to Settings.
- In Preferences, select Management zones.
- Select Edit for the management zone for which you want to update dimensions.
- Select Edit to edit an existing rule.
- In Conditions, edit the
DIMENSIONvalue according to the List of dimension changes. - Select Save changes.