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 or higher) in combination with Dynatrace OneAgent version 1.155 or higher and Dynatrace Server version 1.156 or higher. You can leverage the automatic detection of your Cloud Foundry organizations with ActiveGate version 1.151 or higher in combination with Dynatrace OneAgent 1.151 or higher and Dynatrace Server version 1.152 or higher.
To enable the detection of the
Cloud Foundry organization property within your v1.151 and v1.153 ActiveGate configuration, you need to adapt your
custom.properties file by adding the following configuration:
[cloudfoundry_monitoring] cloudfoundry_monitoring_enabled = true cloudfoundry_oauth_client_id = cf cloudfoundry_oauth_client_user = cf cloudfoundry_oauth_client_password =
Following restart of the ActiveGate service, you can connect your Cloud Foundry foundation.
Please note, Dynatrace supports querying of up to 100 organizations per Cloud Foundry foundation with ActiveGate versions 1.151 and 1.153. Also, adapting the configuration of your ActiveGate is only necessary for ActiveGate versions 1.151 and 1.153.
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.
Note: 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 firstname.lastname@example.org 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:
Once you've connected your Cloud Foundry foundation you can benefit from the new Cloud Foundry overview page which complements Cloud Foundry metrics collected by Dynatrace OneAgent at the process and host levels with additional metadata and metrics pulled from the Cloud Foundry API.
You can further create management zones that represent your Cloud Foundry organizations, including any associated applications that are hosted by these organizations. You can also define auto-tagging rules based on the
Cloud Foundry organization property (for example, to tag all processes and services related to an application living in a specific Cloud Foundry organization). Further, you can apply naming schemes to entities like hosts, process groups, and services that are based on the
Cloud Foundry organization property.