Deploy OneAgent on SAP Cloud Platform for application-only monitoring

Applications deployed on Cloud Foundry are usually run through technology-specific buildpacks that provide framework and runtime support for applications running on the Cloud Foundry platform. For complete details, see how buildpacks work.

Note: When deployed in application-only mode, OneAgent monitors the memory, disk, CPU, and networking of processes within the container only. Host metrics aren't monitored.

The following guidelines apply to SAP Cloud Platform Cloud Foundry and SAP Cloud Platform Neo.

Get a Dynatrace account from the SAP Application Center

If you don't have a Dynatrace account yet, you can get one from the SAP Application Center. This step needs to be done for both Cloud Foundry and Neo environments.

  1. Click Buy Now to initiate the purchase order in the SAP Application Center.

  2. Select your preferred license model and click Continue.

  3. Select the region closest to your SAP Cloud Platform environment, review the order details information, and click Continue.

  4. Provide your billing details and click Continue.

  5. Review, confirm, and place the order.

  6. Click Go to MyApps and check your inbox for an email from Dynatrace that includes your account information and instructions.

  7. Follow the instructions in the email from Dynatrace.

Get credentials

Generate an API token and a PaaS token in your Dynatrace environment.
Make sure you have the Access problem and event feed, metrics, and topology switch enabled for the API token.

Set up SAP Cloud Platform Cloud Foundry environment

SAP Cloud Platform Cloud Foundry hosts a number of buildpacks. You can use these guidelines with the following buildpack integrations:

The SAP Java Buildpack is maintained by SAP. If you experience issues with the SAP Java Buildpack, please refer to component BC-XS-JAV and issue a ticket at SAP Support Portal. The other buildpacks listed above are maintained by the Cloud Foundry Foundation on GitHub. If you experience issues with the integration of Dynatrace into these buildpacks, please get in touch with Dynatrace ONE.

Create a user-provided service in your SAP Cloud Platform Cloud Foundry environment

Create a single service instance for Dynatrace with the name dynatrace as a substring. You can use the cf CLI or directly create a user-provided service with the SAP Cloud Platform Cockpit.

You need to provide a valid JSON object that contains at least the environmentid and apitoken from the previous step. For Dynatrace Managed, you also need to add the apiurl parameter specifying the API endpoint of your Dynatrace Server. For example:

Dynatrace SaaS

{
	"environmentid": "YOUR_ENVIRONMENTID",
	"apitoken": "YOUR_API_TOKEN",
	"tag:SAP CP": "",
	"tag:Region": "Frankfurt"
}

Dynatrace Managed

{
	"environmentid": "YOUR_ENVIRONMENTID",
	"apitoken": "YOUR_API_TOKEN",
	"tag:SAP CP": "",
	"tag:Region": "Frankfurt",
	"apiurl": "https://<YourManagedServerURL>/e/<environmentID>/api"
}

Bind the Dynatrace service to your application

You can bind the created Dynatrace service to your application in your manifest.yml file. If your application is already started, you need to restage it.

See the example below for pushing a Java application:

---
applications:
- name: spring-music
  memory: 768M
  instances: 1
  host: spring-music-somerandomstring
  path: spring-music.war
  buildpack: sap_java_buildpack
services:
  - dynatrace-service

Monitor your SAP Cloud Platform Neo Java applications with Dynatrace

SAP provides an Agent Activation for Dynatrace which allows you to connect your Neo Java applications to your Dynatrace SaaS monitoring environment.

SAP Cloud Platform Neo Agent Activation

Have your Dynatrace environment ID and a generated PaaS token ready.

SAP Agent activation for Dynatrace

After restarting your Java applications deployed to SAP Cloud Platform Neo, you’ll receive the full range of application and service monitoring visibility that Dynatrace provides (for example, Smartscape and service-level insights with Service flow). If you experience issues with the setup of the Agent Activation for Dynatrace, please refer to component BC-NEO-MON-APM and issue a ticket at SAP Support Portal. If you experience issues with Dynatrace please get in touch with Dynatrace ONE