To connect your Cloud Foundry foundations to Dynatrace, follow the steps below.
Set up Cloud Foundry integration
1. Install an ActiveGate
To connect your Cloud Foundry foundations to Dynatrace and use the Cloud Foundry overview page as well as the automatic detection of your Cloud Foundry organizations in addition to other Cloud Foundry process properties like
application ID, and
instance index you need to install an ActiveGate.
Note: The Cloud Foundry overview page requires an ActiveGate (version 1.155+) in combination with Dynatrace OneAgent version 1.155+ and Dynatrace Server version 1.156+. You can leverage the automatic detection of your Cloud Foundry organizations with ActiveGate version 1.151+ in combination with Dynatrace OneAgent 1.151+ and Dynatrace Server version 1.152+.
2. Connect your Cloud Foundry foundations through the product settings
We recommend that you use a Cloud Foundry admin read-only account for connecting your Cloud Foundry foundation to Dynatrace. Such an admin read-only account can view almost all Cloud Controller API resources but it's not permitted to modify them. To create such an account, run the following commands:
uaac user add ReadOnlyUser -p SecretPassword --emails email@example.com uaac member add cloud_controller.admin_read_only ReadOnlyUser uaac member add scim.read ReadOnlyUser
Dynatrace queries the following endpoints to detect organizations, spaces, and applications associated with your connected Cloud Foundry foundation:
Dynatrace will query the following Cloud Foundry API endpoints to detect the organization property and attach it to related process groups:
To connect your Cloud Foundry foundation
- Go to Settings > Cloud and virtualization > Cloud Foundry.
- Click Connect new foundation.
- Type in your Cloud Foundry API target URL, your Authentication endpoint, your Cloud Foundry Username, and Password.
For environments with proxies or self-signed certificates as well as for ActiveGate versions 1.151 or 1.153, you need to adapt the configuration of your ActiveGate. You'll find details for environments with proxies or self-signed certificates on the ActiveGate configuration page. Following configuration, don't forget to restart the ActiveGate service.
Configuration for ActiveGate versions 1.151 or 1.153
To enable the detection of the
Cloud Foundry organization property within a version 1.151 or version 1.153 ActiveGate configuration, you need to adapt your
custom.properties file by adding the following set of parameters:
[cloudfoundry_monitoring] cloudfoundry_monitoring_enabled = true cloudfoundry_oauth_client_id = cf cloudfoundry_oauth_client_user = cf cloudfoundry_oauth_client_password =
Note: Dynatrace supports querying of up to 100 organizations per Cloud Foundry foundation with ActiveGate versions 1.151 and 1.153.