Business Analytics
Business events
An event is an action or occurrence that takes place within a system or a service, such as when a customer completes a satisfaction survey or when a user selects a subscribe button. The system produces a signal when an event occurs. An event becomes a business event when it generates business-grade data. Dynatrace prioritizes business events separately from observability data to ensure business-grade data.
Query
Bizevents can be queried in Grail with the following query:
fetch bizevents
event.category
Use to augment
event.kind
and event.type
fields with an additional level of Business Event classification criteria.checkout
event.id
Uniquely identifies the event within the
event.provider
realm (event.provider
and event.id
should define a unique identification critera for the event).5547782627070661074_1647601320000
event.kind
Gives high-level information about what kind of information the event contains without being specific to the contents of the event. It helps to determine the record type of a raw event. 1
Tags:
permission
BIZ_EVENT
event.provider
www.easytrade.com
event.type
com.easytrade.purchase
timestamp
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when the source created it. If no original timestamp is available, it will be populated at ingest time and required for all events. In the case of a correlated event (for example, ITIL events), this time could be different from the event.start time, as this time represents the actual timestamp when the "update" for the event was created.
1649822520123123123
Automatically and unconditionally set to value BIZ_EVENT
.
If not set, automatically set to value unknown
If not set, automatically set to value unknown
Carbon business events
Carbon business events contains carbon dioxide emissions (in grams) and energy consumption (Wh) that are calculated for hosts that are set up and monitored with OneAgent. Energy calculations are based on observed infrastructure metrics. The events are generated every hour by Carbon Impact app through an automation (Workflow).
Other sources of emissions data can be ingested as business event following this schema to make it consumable by Carbon Impact app.
Query
Carbon bizevents can be queried in Grail with the following query:
fetch bizevents| filter event.type == "carbon.measurement"
carbon.emissions
Total emissions in grams of CO₂ equivalent generated by the energy consumption estimations including not only computing but also datacenter cooling, lighting and other consumptions.
carbon.intensity
Value of carbon intensity (the number of grams of carbon dioxide (CO₂) that it takes to make one unit of electricity a kilowatt per hour (kW/hour)) defined in watt/hour to CO₂ equivalent grams used to transform energy estimation in emissions.
carbon.intensity.last_update
Date of the last update known from the carbon intensity value.
1970-01-01T00:00:00.000Z
carbon.intensity.origin
Origin of the value of carbon intensity used on calculations.
global
; provider
; custom
; geographical
cloud.provider
Name of the cloud provider.
alibaba_cloud
cloud.region
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
dt.entity.host
An entity ID of an entity of type HOST.
Tags:
entity-id
HOST-E0D8F94D9065F24F
energy.measurement.computing
Deprecated, do not use it! Use
energy.measurement.machine
instead.energy.measurement.cooling
Deprecated, do not use it! Use
energy.measurement.infrastructure_overhead
instead.energy.measurement.cpu
Energy estimation (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional.
energy.measurement.cpu_unknown
Inform that estimation of CPU energy consumption was done with an average CPU if the system.processor.model Thermal Design Power (TDP) value is not registered in the app.
energy.measurement.gpu
Estimation of the energy (Wh) consumed by GPU in a host extracted from GPU energy metrics. Value is optional in case the host doesn't have GPU or there aren't GPU energy metrics available.
energy.measurement.infrastructure_overhead
Total amount of energy in Wh estimated for the energy consumption estimated for data center cooling, lighting or other consumptions, not including computing energy consumption.
energy.measurement.io
Estimation of the energy (Wh) consumed by storage in a host based on storage utilization metrics. Value is optional.
energy.measurement.machine
Total amount of energy in Wh estimated only for the computing part, not including other energy consumption from data center cooling, lighting or other consumptions not related to compute.
energy.measurement.memory
Estimation of the energy (Wh) consumed by memory in a host based on memory utilization metrics. Value is optional.
energy.measurement.missing_metrics
Optional list of missing infrastructure utilization metrics
io
; network
energy.measurement.network
Estimation of the energy (Wh) consumed by network in a host based on network utilization metrics. Value is optional.
energy.measurement.total
Total amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting or other.
energy.pue
Power Usage Effectiveness (PUE) value used on the calculation to include data center cooling, lighting and other consumptions to the total energy estimated for compute.
1.58
energy.pue.origin
Origin of Power Usage Effectiveness (PUE) value.
global
; aws
; gcp
; azure
; custom
event.end
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.id
Uniquely identifies the event within the
event.provider
realm (event.provider
and event.id
should define a unique identification critera for the event).5547782627070661074_1647601320000
event.provider
dynatrace.biz.carbon
event.start
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.type
High level, domain specific classification criteria for the event. For a carbon bizevent, this value must be
carbon.measurement
2Tags:
permission
carbon.measurement
system.model
The system model of the instrumented host. The value is optional as it is not always available
t3.medium
; m5.large
; Dell Precision 5540
system.processor.model
System processor model of the instrumented host.
Intel(R) Xeon(R) Platinum 8175M CPU @ 2.50GHz
; Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz
timestamp
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when the source created it. If no original timestamp is available, it will be populated at ingest time and required for all events. In the case of a correlated event (for example, ITIL events), this time could be different from the event.start time, as this time represents the actual timestamp when the "update" for the event was created.
1649822520123123123
utilization.cpu.average
Average of CPU usage metric from the host used in the calculation. Value is optional as a bizevent can be ingested directly with energy consumption from a device that doesn't require energy estimation from utilization metrics.
0.52
utilization.io.average
Average of storage usage metric from the host used in the calculation. Value is optional as a bizevent can be ingested directly with energy consumption from a device that doesn't require energy estimation from utilization metrics or maybe this metric is missing.
utilization.memory.average
Average of memory usage metric from the host used in the calculation. Value is optional as a bizevent can be ingested directly with energy consumption from a device that doesn't require energy estimation from utilization metrics.
utilization.network.average
Average of network usage metric from the host used in the calculation. Value is optional as a bizevent can be ingested directly with energy consumption from a device that doesn't require energy estimation from utilization metrics or maybe this metric is missing.
If not set, automatically set to value unknown
If not set, automatically set to value unknown
Price list business events
Price list business events contains public price list from vendors or estimated price list for on-premise instances to allow calculation of price list cost of instances that are monitored by OneAgent. The events are generated every hour by Carbon Impact app through an automation (Workflow).
Query
Bizevents can be queried in Grail with the following query:
fetch bizevents| filter event.type == "cost.list.price"
cloud.provider
Name of the cloud provider.
alibaba_cloud
cloud.region
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
event.id
Uniquely identifies the event within the
event.provider
realm (event.provider
and event.id
should define a unique identification critera for the event).5547782627070661074_1647601320000
event.provider
The domain specific identification of the event originating component. In the case that they are price list values of instances in cloud vendors generated by Carbon Impact app, it must be
dynatrace.biz.carbon
. For data ingested directly from other sources, description of new source can be included in this attribute. 1Tags:
permission
dynatrace.biz.carbon
; othercloud.price.list.script
event.type
High level, domain specific classification criteria for the event. In this type of event, it should be
cost.list.price
.Tags:
permission
cost.list.price
price.currency
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USD
price.total
Total cost per hour of the resource based on public price list.
0.384
resource.category
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance
; faas
; ec2
; storage
resource.instance.cpu_cores
Number of CPU cores on instance price list
4
resource.instance.memory_total
(Optional) Total memory of the instance on price list, expressed in bytes.
454555
resource.instance.os_type
Type of operating system in the instance on price list
Linux
; Windows
resource.instance.type
AWS, GCE or Azure machine-type, retrieved from instance metadata service. In Semantic Dictionary this attribute appears in dt.entity.host in system.model value
m5.large
timestamp
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when the source created it. If no original timestamp is available, it will be populated at ingest time and required for all events. In the case of a correlated event (for example, ITIL events), this time could be different from the event.start time, as this time represents the actual timestamp when the "update" for the event was created.
1649822520123123123
If not set, automatically set to value unknown
Price list hourly costs business events
Price list hourly costs business events contains the result of calculating the public price list cost of resources monitored by OneAgent. The events are generated every hour by Carbon Impact app through an automation (Workflow).
Query
Bizevents for the price list hourly costs can be queried in Grail with the following query:
fetch bizevents| filter event.type == "cost.list.spend"
cloud.provider
Name of the cloud provider.
alibaba_cloud
cloud.region
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
cost.currency
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
EUR
cost.total
Total cost based on public price list from instrumented resource.
0.384
dt.entity.host
An entity ID of an entity of type HOST.
Tags:
entity-id
HOST-E0D8F94D9065F24F
event.end
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123
event.id
Unique identifier string of an event, is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.provider
The domain specific identification of the event originating component. In the case that they are price list values of instances in cloud vendors generated by Carbon Impact app, it must be
dynatrace.biz.carbon
. For data ingested directly from other sources, description of new source can be included in this attribute. 1Tags:
permission
dynatrace.biz.carbon
event.start
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123
event.type
High level, domain specific classification criteria for the event. In this type of event, it should be
cost.list.spend
.Tags:
permission
cost.list.spend
price.currency
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USD
price.total
Total cost per hour of the resource based on public price list.
0.384
resource.category
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance
; faas
; ec2
; storage
resource.instance.cpu_cores
Number of CPU cores on instance price list
4
resource.instance.memory_total
(Optional) Total memory of the instance on price list, expressed in bytes.
454555
resource.instance.os_type
Type of operating system in the instance on price list
Linux
; Windows
resource.instance.type
AWS, GCE or Azure machine-type, retrieved from instance metadata service. In Semantic Dictionary this attribute appears in dt.entity.host in system.model value
m5.large
timestamp
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when the source created it. If no original timestamp is available, it will be populated at ingest time and required for all events. In the case of a correlated event (for example, ITIL events), this time could be different from the event.start time, as this time represents the actual timestamp when the "update" for the event was created.
1649822520123123123
If not set, automatically set to value unknown