Deploy OneAgent on SAP Cloud Platform for application-only monitoring

SAP Cloud Platform is an enterprise platform-as-a-service (enterprise PaaS) that provides comprehensive application development services and capabilities, which allow for building, extending, and integrating business applications in the cloud. SAP Cloud Platform provides different environments:

  • Cloud Foundry
  • Neo
  • ABAP

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

Get a Dynatrace account from the SAP App Center

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

  1. Click the Buy Now button to initiate the purchase order in the SAP App 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. You're almost there! 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.

Generate PaaS token

In your Dynatrace environment, get your environment ID (your environment ID is the string of characters at the beginning of the URL you use to access your Dynatrace environment), and generate a PaaS token for the SAP Cloud Platform.

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 support 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 Support.

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'll need to provide a valid JSON object that contains at least the environmentid and apitoken from the previous step. For Dynatrace Managed, you'll 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 either bind the created Dynatrace service to your application in your manifest.yml file prior to pushing your app or you can bind the service to your app and restage the application afterwards.

If you're pushing a Java application, the manifest could look like the following example:

- name: spring-music
  memory: 768M
  instances: 1
  host: spring-music-somerandomstring
  path: spring-music.war
  buildpack: sap_java_buildpack
  - 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. For more information, see What is the Agent Activation for Dynatrace.

SAP Cloud Platform Neo Agent Activation

Please 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 support 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 Support