• Home
  • Deploy Dynatrace
  • Set up Dynatrace on cloud platforms
  • Google Cloud Platform
  • Integrations
  • End-to-end guide for monitoring GCP services integrating Operations Suite
  • Migrate to GCP integration version 1.0

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.

List of services with custom topology
  • 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.

Note: 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

  1. Find out what release version you're using.

    plaintext
    helm ls -n dynatrace
  2. Uninstall the release.

    Note: Be sure to replace <release-name> with the release name from the previous output.

    plaintext
    helm uninstall <release-name> -n dynatrace
  1. Uninstall the release.
bash
wget https://raw.githubusercontent.com/dynatrace-oss/dynatrace-gcp-monitor/master/scripts/uninstall.sh -O uninstall.sh ; chmod a+x uninstall.sh ; ./uninstall.sh
  1. Remove the activation-config.yaml service configuration file.

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.

List of dimension changes
Old dimension nameNew dimension name
project_idgcp.project.id
regiongcp.region
zonegcp.region
instance_idgcp.instance.id
autoscaler_idgcp.instance.id
model_idgcp.instance.id
queue_idgcp.instance.id
device_registry_idgcp.instance.id
job_idgcp.instance.id
version_idgcp.instance.id
database_idgcp.instance.id
volume_idgcp.instance.id
router_idgcp.instance.id
instance_group_idgcp.instance.id
interconnectgcp.instance.id
attachmentgcp.instance.id
volume_idgcp.instance.id
snapshot_idgcp.instance.id
subscription_idgcp.instance.id
topic_idgcp.instance.id
key_idgcp.instance.id
worker_idgcp.instance.id
agent_idgcp.instance.id
gateway_idgcp.instance.id
namegcp.instance.name
autoscaler_namegcp.instance.name
environment_namegcp.instance.name
cluster_name gcp.instance.namegcp.instance.name
function_name gcp.instance.namegcp.instance.name
revision_namegcp.instance.name
job_namegcp.instance.name
instance_namegcp.instance.name
domain_namegcp.instance.name
table_namegcp.instance.name
firewall_namegcp.instance.name
bucket_namegcp.instance.name
container_namegcp.instance.name
url_map_namegcp.instance.name
instance_group_namegcp.instance.name
load_balancer_namegcp.instance.name
canonical_service_namegcp.instance.name
node_namegcp.instance.name
pod_namegcp.instance.name
broker_namegcp.instance.name
revision_namegcp.instance.name
trigger_namegcp.instance.name
fqdngcp.instance.name
target_domain_namegcp.instance.name
gateway_namegcp.instance.name
policy_namegcp.instance.name
proxy_namegcp.instance.name
load_balancer_namegcp.instance.name
backend_target_namegcp.instance.name
connector_namegcp.instance.name
gateway_namegcp.instance.name
  • To update dimensions for dashboards
    1. In the Dynatrace menu, go to Dashboards.
    2. Select the dashboard for which you want to update dimensions, and then select More (…) > Configure.
    3. Select Dashboard JSON.
    4. In the "splitBy" section, replace the old dimensions with the new values as determined from the list of dimension changes.
    5. 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

    1. In the Dynatrace menu, go to Settings.
    2. In Anomaly detection, select Metric events.
    3. Select the event for which you want to update dimensions.
    4. 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.
    5. Select Save changes.
  • To update dimensions for management zones

    1. In the Dynatrace menu, go to Settings.
    2. In Preferences, select Management zones.
    3. Select Edit for the management zone for which you want to update dimensions.
    4. Select Edit to edit an existing rule.
    5. In Conditions, edit the DIMENSION value according to the List of dimension changes.
    6. Select Save changes.
Related topics
  • Set up Dynatrace on Google Cloud Platform

    Monitor Google Cloud Platform with Dynatrace.