Parameters for Dynatrace integration with Google Kubernetes Engine (GKE)

Before running the installation script for Dynatrace integration with Google Kubernetes Engine (GKE), you need to set the required values in values.yaml, which is located in helm-deployment-package/dynatrace-gcp-function. You can also customize other optional values. See below for the complete list of parameters available for this integration.

Parameters for metrics and logs ingestion (deployment type: all)

Parameter name Description Default value
gcpProjectId The GCP project ID where the Dynatrace GCP function should be deployed. Use the GCP project of log Sink Pub/Sub subscription. For details, see Set up generic log ingestion. Your current project ID
deploymentType Set to 'all'. all
dynatraceAccessKey Your Dynatrace API token with the required permissions according to your selected deployment. For details, see Dynatrace requirements.
activeGate.dynatracePaasToken Your PaaS token. For details, see Dynatrace requirements.
dynatraceUrl Your Dynatrace environment endpoint. For details, see Dynatrace requirements.
logsSubscriptionId The ID of your log Sink Pub/Sub subscription. For details, see Set up generic log ingestion.

Optional additional parameters for metrics and logs ingestion

optional

Parameter name Description Default value
activeGate.useExisting Set to true if you choose to use an existing ActiveGate to ingest logs. For details, see Dynatrace requirements. false
dynatraceLogIngestUrl Your ActiveGate endpoint used to ingest logs to Dynatrace. For details, see Dynatrace requirements.
requireValidCertificate If set to true, Dynatrace requires the SSL certificate of your Dynatrace environment. true
selfMonitoringEnabled Send custom metrics to GCP to quickly diagnose if dynatrace-gcp-function processes and sends metrics/logs to Dynatrace properly. false
dockerImage Dynatrace GCP function docker image. We recommend using the default value, but you can adapt it if needed. dynatrace/dynatrace-gcp-function
logIngestContentMaxLength The maximum content length of a log event. Should be the same as or lower than the setting on your Dynatrace environment. 8192
logIngestAttributeValueMaxLength The maximum length of the log event attribute value. If it exceeds the server limit, content will be truncated. 250
logIngestRequestMaxEvents The maximum number of log events in a single payload to the logs ingestion endpoint. If it exceeds the server limit, payload will be rejected with code 413. 5000
logIngestRequestMaxSize The maximum size in bytes of a single payload to the logs ingestion endpoint. If it exceeds the server limit, payload will be rejected with code 413. 1048576
logIngestEventMaxAgeSeconds Determines the maximum age of a forwarded log event. Should be the same as or lower than the setting on your Dynatrace environment. 86400
printMetricIngestInput If set to true, the function outputs the lines of metrics to stdout. false
serviceUsageBooking Service usage booking is used for metrics and determines a caller-specified project for quota and billing purposes. If set to source, monitoring API calls are booked in the project where the Kubernetes container is running. If set to destination, monitoring API calls are booked in the project that is monitored. For details, see Monitor multiple GCP projects - Step 4. source
useProxy Depending on the value you set for this flag, the function will use the following proxy settings: Dynatrace (set to DT_ONLY), GCP API (set to GCP_ONLY), or both (set to ALL). By default, proxy settings are not used.
httpProxy The proxy HTTP address; use this flag in conjunction with USE_PROXY.
httpsProxy The proxy HTTPS address; use this flag in conjunction with USE_PROXY.
importDashboards Import predefined dashboards for selected services. true
importAlerts Import predefined alerting rules for selected services. true
gcpServicesYaml Configuration file for GCP services.
queryInterval Metrics polling interval in minutes. Allowed values: 1 - 6 3

Parameters for metrics-only ingestion (deployment type: metrics)

Parameter name Description Default value
deploymentType Set to 'metrics'. all
dynatraceAccessKey Your Dynatrace API token with the required permissions according to your selected deployment. For details, see Dynatrace requirements.
dynatraceUrl Your Dynatrace environment endpoint. For details, see Dynatrace requirements.

Optional additional parameters for metrics-only ingestion

optional

Parameter name Description Default value
requireValidCertificate If set to true, Dynatrace requires the SSL certificate of your Dynatrace environment. true
selfMonitoringEnabled Send custom metrics to GCP to quickly diagnose if dynatrace-gcp-function processes and sends metrics/logs to Dynatrace properly. false
dockerImage Dynatrace GCP function docker image. We recommend using the default value, but you can adapt it if needed. dynatrace/dynatrace-gcp-function
printMetricIngestInput If set to true, the function outputs the lines of metrics to stdout. false
serviceUsageBooking Service usage booking is used for metrics and determines a caller-specified project for quota and billing purposes. If set to source, monitoring API calls are booked in the project where the Kubernetes container is running. If set to destination, monitoring API calls are booked in the project that is monitored. For details, see Monitor multiple GCP projects - Step 4. source
useProxy Depending on the value you set for this flag, the function will use the following proxy settings: Dynatrace (set to DT_ONLY), GCP API (set to GCP_ONLY), or both (set to ALL). By default, proxy settings are not used.
httpProxy The proxy HTTP address; use this flag in conjunction with USE_PROXY.
httpsProxy The proxy HTTPS address; use this flag in conjunction with USE_PROXY.
importDashboards Import predefined dashboards for selected services. true
importAlerts Import predefined alerting rules for selected services. true
gcpServicesYaml Configuration file for GCP services.
queryInterval Metrics polling interval in minutes. Allowed values: 1 - 6 3

Parameters for logs-only ingestion (deployment type: logs)

Parameter name Description Default value
gcpProjectId The GCP project ID where the Dynatrace GCP function should be deployed. Use the GCP project of log Sink Pub/Sub subscription. For details, see Set up generic log ingestion. Your current project ID
deploymentType Set to 'logs'. all
dynatraceAccessKey Your Dynatrace API token with the required permissions according to your selected deployment. For details, see Dynatrace requirements.
activeGate.dynatracePaasToken Your PaaS token. For details, see Dynatrace requirements.
dynatraceUrl Your Dynatrace environment endpoint. For details, see Dynatrace requirements.
logsSubscriptionId The ID of your log Sink Pub/Sub subscription. For details, see Set up generic log ingestion.

Optional additional parameters for logs-only ingestion

optional

Parameter name Description Default value
activeGate.useExisting Set to true if you choose to use an existing ActiveGate to ingest logs. For details, see Dynatrace requirements. false
dynatraceLogIngestUrl Your ActiveGate endpoint used to ingest logs to Dynatrace. For details, see Dynatrace requirements.
requireValidCertificate If set to true, Dynatrace requires the SSL certificate of your Dynatrace environment. true
selfMonitoringEnabled Send custom metrics to GCP to quickly diagnose if dynatrace-gcp-function processes and sends metrics/logs to Dynatrace properly. false
dockerImage Dynatrace GCP function docker image. We recommend using the default value, but you can adapt it if needed. dynatrace/dynatrace-gcp-function
logIngestContentMaxLength The maximum content length of a log event. Should be the same as or lower than the setting on your Dynatrace environment. 8192
logIngestAttributeValueMaxLength The maximum length of the log event attribute value. If it exceeds server limit, content will be truncated. 250
logIngestRequestMaxEvents The maximum number of log events in a single payload to the logs ingestion endpoint. If it exceeds the server limit, payload will be rejected with code 413. 5000
logIngestRequestMaxSize The maximum size in bytes of a single payload to the logs ingestion endpoint. If it exceeds the server limit, payload will be rejected with code 413. 1048576
logIngestEventMaxAgeSeconds Determines the maximum age of a forwarded log event. Should be the same as or lower than the setting on your Dynatrace environment. 86400