Document toolboxDocument toolbox

Configuring Dynatrace Log Connection in PowerConnect (PowerConnect ABAP 8.X)

Owned by Iegor Titov
Last updated: May 16, 2024

Once a valid license for PowerConnect is applied, a setup wizard will open to add configuration for a Dynatrace tenant that will receive the data from the ABAP agent. In case SSL has not been configured, please interrupt the wizard at this point and configure the SSL connection in SAP. You can restart the wizard later by navigating to Administrator → Connection Setup → Upload Wizard from the PowerConnect control panel

 

  • In the initial dialog please select “Dynatrace Log”.

    • Dynatrace Log receives data from PowerConnect using an HTTPs Log ingest endpoint. The connection required the API token, which must be configured using the Dynatrace Web interface. More information can be found in the official Dynatrace documentation.

  • Click “Next.”

  • Enter a unique name for the endpoint and click “Create.”

    • PowerConnect allows you to configure multiple endpoints for different Dynatrace tenants. A unique name is recommended to allow for ease of recognition.

  • A new window will appear to configure the endpoint. Beside the connection name, please provide:

    • Hostname in http-format

      • This will be the domain/address of the server with the following formatting: “https://<dynatrace_server>:443”

    • Network Proxy settings (if applicable). This will be done if the internal network hosting your SAP system does not typically allow connections outside the network.

      • Check “Use Proxy” to activate

      • Provide the Host for the proxy server in a “<host_address>:<port>” format.

      • Fill in the Username and Password for the account.

    • Token

      • This is a character string that can be obtained from the Dynatrace Web UI (Access token).

  • Test the connection by clicking on the leftmost button on the bottom-right corner of the configuration window.

  • Otherwise click on the green check to confirm the configuration.

  • Once the connection is confirmed, you will be returned to the wizard. Save the endpoint configuration by pressing “Next.”

  • You now can assign the connection to a connection group. If there isn’t any, no action is required.

  • Set it to Active. PowerConnect will not transmit data using an inactive upload object.

  • Press Next.

The connection is now configured. You can either create an additional endpoint or finish the wizard.

Notes for SSL Deployment

  • Please ensure you follow the guide Using SSL encryption between Dynatrace and SAP

  • The configuration in SAP for the host must either be

    1. A fully qualified hostname, or

    2. It must match the CN (Common Name) or the SAN (Subject Alternate Name) in the SSL certificate attached to the endpoint port

If you are not sure how SSL chain verification works, check with someone in your organization who manages SSL certificates.

  • If you see sslv3 errors in the SMICM log then check SAP note 510007 - Additional considerations for setting up SSL on Application Server ABAP and ensure your profile parameter ssl/client_ciphersuites is set to disable all SSL cipher suites except TLS 1.1 and higher.

    • This is a system wide change and impacts all SSL connects using TLS 1.0 or older, as Dynatrace does not allow them to be used any more. If SAP attempts to use an older cipher suite, Dynatrace will refuse the connection.

First Time Setup - Final Steps

Start background jobs

After configuring an initial connection, configure the user to start the background jobs. This is mandatory to run PowerConnect. There are three different types of job:

  • Check Job: Performs clean up activities and internal checks to ensure other jobs up and running.

  • Extractor Job: Extracts data from the different sources within the SAP system.

  • Uploader Job: Transmits the extracted data to Dynatrace.

→ This step actually can be skipped easily. Jobs must be started manually from the control panel in program /BNWVS/MAIN then. Please refer to the Data Extraction User Guide to understand how the jobs can be started manually from the control panel.

Set-up e-mail notification

The last prompt is regarding notification emails from PowerConnect.

  • Provide a valid e-mail address that gets the necessary attention needed for notification mails.

  • Press the green check.

Basic configuration is finished. The batch jobs should begin automatically, collecting data and sending it to Dynatrace using the configured connection.

If you use SAP HANA as database it is necessary to apply certain database scripts as described here.