Deploy the Dynatrace GCP metric integration in GCP Cloud Function
As an alternative to the main deployment, that provides Google Cloud Platform monitoring for both metrics and logs, and where the deployment takes place in a GKE cluster, you can choose to set up monitoring for metrics only, in GCP Cloud Function. Note that the GCP Cloud Function deployment isn't recommended for large environments and doesn't support log forwarding. In this scenario, you will be able run the deployment script either in Google Cloud Shell or in bash. After installation, you'll get metrics, dashboards, and alerts for your configured services in Dynatrace.
For other deployment options, see Alternative deployment scenarios.
This page describes how to deploy version 1.0 of the Dynatrace GCP integration in GCP Cloud Function.
- If you already have an earlier version of the GCP Function installed, you need to migrate.
Prerequisites
Tools
You can deploy the Dynatrace GCP integration in Google Cloud Shell or in bash.
If you use bash, you need to install
GCP permissions
Running the deployment script requires a list of permissions. You need to create a custom role and use it to deploy dynatrace-gcp-function
.
To create a custom role
-
Create a YAML file named
dynatrace-gcp-function-cloud-function-deployment-role.yaml
with the following content: -
Run the command below, replacing
<your_project_ID>
with the project ID where you want to deploy the Dynatrace integration.gcloud iam roles create dynatrace_function.cloud_function_deployment --project=<your_project_ID> --file=dynatrace-gcp-function-cloud-function-deployment-role.yaml
Note: Be sure to add this role to your GCP user. For details, see Grant or revoke a single role.
Dynatrace permissions
Create an API token and enable the following permissions:
- API v1:
- Read configuration
- Write configuration
- API v2:
- Ingest metrics
- Read extensions
- Write extensions
- Read extension monitoring configurations
- Write extension monitoring configurations
- Read extension environment configurations
- Write extension environment configurations
Dynatrace URL
Determine the URL for your environment.
- For Dynatrace SaaS:
https://<your-environment-id>.live.dynatrace.com/
- For Dynatrace Managed:
https://<your-domain>/e/<your-environment-id>/
Note: To determine <your-environment-id>
, see environment ID.
Install
You can deploy the Dynatrace GCP integration in Google Cloud Shell or in bash. To set up integration, follow the instructions below.
Note: For bash deployment, be sure to restart the console and initialize Cloud SDK before you start installation. To initialize Cloud SDK, run
gcloud init
1. Download the deployment package
wget -q "https://github.com/dynatrace-oss/dynatrace-gcp-function/releases/latest/download/function-deployment-package.zip" -O function-deployment-package.zip; unzip function-deployment-package.zip; chmod a+x *.sh
2. Configure deployment
-
Adjust the parameters in the
activation-config.yaml
file from the deployment package. -
Choose which services you want Dynatrace to monitor.
By default, the GCP integration starts monitoring a series of selected services. Uncomment any additional services you want Dynatrace to monitor in the activation-config.yaml
file.
Note: For DDU consumption information, see Monitoring consumption.
3. Run the deployment script
./setup.sh
Note: The script may ask you for confirmations during deployment. For CI/CD purposes, you can add the -d
option to make the script noninteractive.
After deploying the integration, you can see metrics from monitored services. If you want to add services to monitoring, see Change deployment settings below.
Verify installation
To check whether installation was successful
- In your Google Cloud console, go to Cloud Functions and make sure that
dynatrace-gcp-function
is there. - Select the newly deployed GCP Function and go to Logs to make sure there are no error messages.
Enable alerting
To activate alerting, you need to enable custom events for alerting in Dynatrace.
To enable custom events
- In the Dynatrace menu, go to Settings.
- In Anomaly detection, select Custom events for alerting.
- Filter for GCP alerts and turn on On/Off for the alerts you want to activate.
View enabled services
To find the list of currently enabled services, go to Cloud Function in your GCP console, and check the ACTIVATION_CONFIG
environment variable.
Change deployment settings
To add or remove services, or to update parameters, you need to redeploy the integration.
- Apply your changes to
activation-config.yaml
.
Note: Be sure to use the same value for the FUNCTION_NAME
parameter as before.
Troubleshoot
To investigate potential deployment and connectivity issues
- Verify installation
- Enable self-monitoring optional
- Check the
dynatrace_gcp_<date_time>.log
log file created during the installation process.
- This file will be created each time the installation script runs.
- The debug information won't contain sensitive data such as the Dynatrace access key.
- If you are contacting Dynatrace ONE:
- Make sure to provide the
dynatrace_gcp_<date_time>.log
log file described in the previous step. - Provide version information.
- For issues during installation, check the
version.txt
file. - For issues during runtime, check function logs.
- For issues during installation, check the
- Make sure to provide the
Uninstall
- Go to your installation directory and run the command below.
./uninstall.sh
- To remove all monitoring assets (dashboards, alerts, etc) from Dynatrace, you need to remove all GCP extensions.
To remove an extension
- In the Dynatrace menu, go to Extensions and search for the GCP extensions.
- Select an extension you want to remove, and then select the trash icon in the Actions column to remove it.
Repeat the procedure until you remove all GCP extensions.
Monitoring consumption
All cloud services consume DDUs. The amount of DDU consumption per service instance depends on the number of monitored metrics and their dimensions (each metric dimension results in the ingestion of 1 data point; 1 data point consumes 0.001 DDUs). For details, see Extending Dynatrace (Davis data units).