Business event capture

To get started with business events, you first need to define the scope of the data you want to capture. The approach you use depends on the source of the business events.

There are four sources for business events.

Get business events via OneAgent

OneAgent version 1.253+

To capture business events using OneAgent, you need to first enable the feature.

Configuration requires one or more capture rules that consist of triggers, mandatory data fields, and optional event data fields.

The table below contains examples of mandatory (event.type, event.provider) and optional (event.category) data fields.

Supported technologies

Supported technologies for data extraction from HTTP requests are listed in the tables below.

Data extraction from incoming HTTP requests

Data extraction from outgoing HTTP requests

Capturing variants

This feature is available for OneAgent version 1.307+ on Webserver and .NET. For all other technologies, apply the technology support table.

Define how incoming business events should be parsed based on their content-type.

To access the default configuration, Search for Capturing variants and select it.

Those settings apply on the global level and are therefore used for all deployed agents on supported technologies.

Configure business event sources on OneAgent

OneAgent version 1.253+

To configure business event sources on OneAgent

Example of data extraction from JSON payloads

The following table shows additional examples of how to extract data from JSON payloads.

Examples of data extraction from XML payloads

The extraction of data from XML payloads works with the same syntax as for JSON.

Example 1: Extracting attributes and values from basic XML

<LogoutRequest id=”102030AF”>
      <accountId>100</accountId>
</LogoutRequest>

Example 2: Extracting attributes and values from XML with namespaces

<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <Tagh1 xmlns="http://tempuri.org/">
         <Tagh2 cusType="A" xmlns:a="http://schemas.datacontract.org/ex" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:Code i:nil="true" />
            <a:Name>MyCustomer1</a:Name>
            <a:TotalValue>45</a:TotalValue>
         </Tagh2>
      </Tagh1>
   </s:Body>
</s:Envelope>

Examples of data capture from requests and responses

Data capture from requests and responses is available for both JSON and XML.

The following table shows examples of how to extract data from requests and is based on the JSON payload example above.

Get business events from RUM

Business events are available for all Dynatrace RUM technologies (web RUM, mobile RUM, and OpenKit). RUM business events can be obtained by leveraging a dedicated method of the RUM JavaScript, OneAgent for mobile, or OpenKit.

Check the sections below for instructions on how to report business events for different platforms.

RUM JavaScript

Android

iOS

Cordova¹

Xamarin

Flutter

.NET MAUI

React Native

OpenKit

let attributes = {
    "event.name": "Confirmed Booking",
    "page": "booking-confirmation",
    "product": "Danube Anna Hotel",
    "amount": 358.35,
    "currency": "USD",
    "reviewScore": 4.8,
    "arrivalDate": "2022-11-05",
    "departureDate": "2022-11-15",
    "journeyDuration": 10,
    "adultTravelers": 2,
    "childrenTravelers": 0
};

dynatrace.sendBizEvent('com.easytravel.funnel.booking-finished', attributes);

Log to Business events

Use OpenPipeline to convert incoming logs to business events. This is useful if logs contain business-relevant information or no other ingest path for business events is available.

See the following log example to get started:

{

"content": "{\"user\": \"009494\", \"ordervalue\": 1000}"

}