Configure Realtime Streaming

Use the Realtime Streaming pane of the AppMon Server Settings to configure real time feeds for AppMon and Dynatrace streaming capability.

AppMon 2018 March

Configure Dynatrace environments

Use this tab to manage Dynatrace environments used in AppMon to stream monitoring data from AppMon to a Dynatrace environment. This integration gives AppMon users complete visibility into their AppMon metrics within Dynatrace dashboards. All your important AppMon metrics can be charted and visualized using the standard set of Dynatrace dashboard tiles.

The integration from AppMon to Dynatrace relies on unique character strings to identify a Dynatrace monitoring environment.

Dynatrace identifies each environment to monitor with a unique character string known as an environment ID (also known as a tenant ID in Dynatrace SaaS). The Dynatrace API relies on environment IDs to ensure that it pulls monitoring data from and pushes relevant external events to the correct Dynatrace environments.

To stream Dynatrace monitoring data to AppMon, you must create and authenticate a connection to each Dynatrace environment used to stream monitoring data to AppMon.

Within Dynatrace SaaS, your Dynatrace environment ID, is included at the beginning of your Dynatrace environment´s URL.

Generate a Dynatrace API access token

Authentication is achieved via a user-generated access key (available in your Dynatrace environment settings). Log into your Dynatrace environment and click Settings > Integration > Dynatrace API. Click Generate token, then enter a unique string (Tenant name) and click Generate to generate a new access token.

See Why do I need an access token and an environment ID? in Dynatrace help for more information.

Add Dynatrace environment IDs in AppMon for data streaming

In the Dynatrace Tenants tab, complete the following: Tenant Name: This is the name of the Dynatrace monitoring environment ID for the environment used to pull monitoring data. In Dynatrace, click the account icon in the upper right corner to view your available environments.

Dynatrace URL: This is the URL for the Dynatrace environment from which you want to stream data. Whether using Dynatrace SaaS or Dynatrace Managed, the URL value includes the environment ID.

API Token: This is the token generated when you generate a Dynatrace API access token (see the above section). In Dynatrace, you can click Settings > Integration > Dynatrace API, find the desired API token from the list, and click Edit to see the token. Click Copy in the Generated token field to copy the token, then switch to AppMon and paste the token into this field.

Configure the PureLytics Stream

To configure AppMon to stream PureLytics data, you enable the PureLytics stream, specify your elasticsearch endpoint and other AppMon Server Settings for realtime streaming, then enable the PureLytics stream for each System Profile for which you want to export data.

  1. Open Realtime Streaming in the AppMon Client Settings (Settings > Dynatrace Server > Realtime Streaming > PureLytics Stream).

  2. Check Configure PureLytics Stream.

  3. Choose the target you want to stream the JSON documents to. You can either stream them to an Elasticsearch Cluster or stream them to an generic HTTP endpoint using the same Elasticsearch bulk format.

  4. Enter the URL to your Elasticsearch cluster or generic HTTP endpoint (REST port) in the URL field. The PureLytics Stream appends /_bulk to the entered URL).

  5. Optionally select Allow untrusted SLL if you want to use HTTPS and use unofficial certificates.

  6. Use Dispatch Interval(s) and Queue Size to set the amount of data sent with every bulk request and the interval between the requests. A request is sent when the internal document queue hits the size specified in Queue Size and/or after the amount of time specified in Dispatch Interval(s) has passed (Dispatch Interval). Request size is approximately the number of documents* times 2 kB. * This** depends heavily on factors such as configured Business Transactions and resource timings.

  7. Click OK.

  8. Open the System Profile Preferences dialog box and click the General tab.

  9. Select the PureLytics Stream checkbox and click OK.

Configure the Business Transaction feed

Perform the basic setup for the Business Transaction export in the Server Settings > Realtime Streaming > Business Transactions Feed.

Configure Business Transactions Feed
Configure Business Transactions Feed

Select Enable Real Time Business Transactions Feed, then provide the required information for the feed.

  • URL: Specify the URL to which the Business Transaction data is posted.
  • Allow untrusted SSL: Export to servers without checking the certificate.
  • HTTP Authentication: Enable basic authentication
  • Test connection: Validate the connection settings.
  • Bulk Size: Set the number of Business Transaction results to be included in one request. There is a timeout of one minute, so a request might actually contain fewer Business Transaction results than specified here.

Business Transaction-specific setup

Enable data export for a specific Business Transaction through the Business Transaction Editor. Go to System Profile Preferences > Business Transactions, then select the Business Transaction and click Edit; or click Create for a new Business Transaction.

Select Export Results via HTTP. Two additional check boxes appear. Select the additional data to export: PurePath reference and/or Performance data.

Business Transactions created for multidimensional analysis can contain many different splittings or split measures that result in many groups, possibly with single values such as a transaction ID. In this situation, make sure Store results in Performance Warehouse is not selected. The data would be unsuitable for charting and would only burden your Performance Warehouse unnecessarily. Also remove any splitting option restrictions, to collect all values.