Settings API - Capture business events with OneAgent schema table

Capture business events with OneAgent (builtin:bizevents.http.outgoing)

OneAgent can capture business events from outgoing HTTP requests. To activate this feature, add capture rules below.

Capture rules tell OneAgent to capture business events when specific webservices or endpoints are called. A capture rule consists of trigger rules, mandatory business event information (e.g. type and provider) and optional event data fields. A trigger defines the criteria that, when met, cause a business event to be captured (e.g. endpoint “/api/buy” is called). By adding event data fields to your business event, you can extract data directly from the incoming request payload. To limit the scope of a capture rule to a certain Host-Group or Host, create the rule directly in the Host-Group or Host setting screen.

Learn more by visiting our documentation.

Schema IDSchema groupsScope
builtin:bizevents.http.outgoing
  • group:business-analytics.business-events-sources
  • group:business-analytics
HOST - Host
HOST_GROUP - Host Group
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:bizevents.http.outgoing
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:bizevents.http.outgoing
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:bizevents.http.outgoing

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Enabled
enabled
boolean-required
Rule name
ruleName
text-required
Triggers
triggers
Set<MatcherComplex>

Define conditions to trigger business events from incoming web requests. Triggers are connected by AND logic per capture rule. If you set multiple trigger rules, all of them need to be fulfilled to capture a business event.

required
Event meta data
event
EventComplex-required
The MatcherComplex object
PropertyTypeDescriptionRequired
sourceDataSourceComplex-required
Operator
type
enum
  • EQUALS
  • N_EQUALS
  • STARTS_WITH
  • N_STARTS_WITH
  • ENDS_WITH
  • N_ENDS_WITH
  • CONTAINS
  • N_CONTAINS
  • EXISTS
  • N_EXISTS
required
Value
value
text-required
Case sensitive
caseSensitive
boolean-required
The EventComplex object
PropertyTypeDescriptionRequired
providerEventAttributeComplex

Event provider

required
typeEventAttributeComplex

Event type

required
categoryEventCategoryAttributeComplex

Event category

required
Event data
data
Set<EventDataFieldComplex>

Additional attributes for the business event.

required
The DataSourceComplex object
PropertyTypeDescriptionRequired
Data source
dataSource
enum
  • request.path
  • request.url
  • request.method
  • request.headers
  • request.parameters
  • request.body
  • response.body
  • response.headers
  • response.statusCode
required
Path
path
text

See our documentation

required
The EventAttributeComplex object
PropertyTypeDescriptionRequired
Data source
sourceType
enum
  • request.path
  • request.url
  • request.method
  • request.headers
  • request.parameters
  • request.body
  • response.body
  • response.headers
  • response.statusCode
  • constant.string
required
Fixed value
source
text-required
Path
path
text

See our documentation

required
The EventCategoryAttributeComplex object
PropertyTypeDescriptionRequired
Data source
sourceType
enum
  • request.path
  • request.url
  • request.method
  • request.headers
  • request.parameters
  • request.body
  • response.body
  • response.headers
  • response.statusCode
  • constant.string
required
Fixed value
source
text-required
Path
path
text

See our documentation

required
The EventDataFieldComplex object
PropertyTypeDescriptionRequired
Field name
name
text

Field name to be added to data.

required
sourceEventDataAttributeComplex-required
The EventDataAttributeComplex object
PropertyTypeDescriptionRequired
Data source
sourceType
enum
  • request.path
  • request.url
  • request.method
  • request.headers
  • request.parameters
  • request.body
  • response.body
  • response.headers
  • response.statusCode
  • constant.string
required
Fixed value
source
text-required
Path
path
text

See our documentation

required