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
Attribute
Type
Description
Examples
event.categorystring
stable
Use to augment
Use to augment
event.kind and event.type fields with an additional level of Business Event classification criteria.checkoutevent.idstring
stable
Uniquely identifies the event within the
Uniquely identifies the event within the
event.provider realm (event.provider and event.id should define a unique identification critera for the event).5547782627070661074_1647601320000event.kindstring
stable
Gives high-level information about what kind of information the event contains, without being specific to the contents of the event. Helps to determine the record type of a raw event. 1
Tags:
Gives high-level information about what kind of information the event contains, without being specific to the contents of the event. Helps to determine the record type of a raw event. 1
Tags:
permissionBIZ_EVENTevent.providerstring
www.easytrade.comevent.typestring
com.easytrade.purchasetimestamptimestamp
stable
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
16498225201231231231
Automatically and unconditionally set to value BIZ_EVENT.
2
If not set, automatically set to value unknown
3
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"
Attribute
Type
Description
Examples
carbon.emissionsdouble
experimental
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.
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.intensitydouble
experimental
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.
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_updatetimestamp
experimental
Timestamp of the last update known from the carbon intensity value.
Timestamp of the last update known from the carbon intensity value.
carbon.intensity.originstring
experimental
Origin of the value of carbon intensity used on calculations.
Origin of the value of carbon intensity used on calculations.
global; provider; customcloud.providerstring
experimental
Name of the cloud provider.
Name of the cloud provider.
alibaba_cloudcloud.regionstring
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1dt.entity.hoststring
stable
An entity ID of an entity of type HOST.
Tags:
An entity ID of an entity of type HOST.
Tags:
entity-idHOST-E0D8F94D9065F24Fenergy.measurement.computingdouble
experimental
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.
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.coolingdouble
experimental
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.
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.cpuarray
experimental
Array of energy estimations (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional. Contains multiple values on multiprocessor systems.
Array of energy estimations (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional. Contains multiple values on multiprocessor systems.
energy.measurement.cpu_unknownboolean
experimental
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.
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.gpudouble
experimental
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.
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.iodouble
experimental
Estimation of the energy (Wh) consumed by storage in a host based on storage utilization metrics. Value is optional.
Estimation of the energy (Wh) consumed by storage in a host based on storage utilization metrics. Value is optional.
energy.measurement.memorydouble
experimental
Estimation of the energy (Wh) consumed by memory in a host based on memory utilization metrics. Value is optional.
Estimation of the energy (Wh) consumed by memory in a host based on memory utilization metrics. Value is optional.
energy.measurement.missing_metricsstring
experimental
Optional list of missing infrastructure utilization metrics
Optional list of missing infrastructure utilization metrics
io; networkenergy.measurement.networkdouble
experimental
Estimation of the energy (Wh) consumed by network in a host based on network utilization metrics. Value is optional.
Estimation of the energy (Wh) consumed by network in a host based on network utilization metrics. Value is optional.
energy.measurement.totaldouble
experimental
Total amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting or other.
Total amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting or other.
energy.puedouble
experimental
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.
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.58energy.pue.originstring
experimental
Origin of Power Usage Effectiveness (PUE) value.
Origin of Power Usage Effectiveness (PUE) value.
global; aws; gcp; azure; customevent.endstring
stable
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000event.idstring
stable
Uniquely identifies the event within the
Uniquely identifies the event within the
event.provider realm (event.provider and event.id should define a unique identification critera for the event).5547782627070661074_1647601320000event.providerstring
dynatrace.biz.carbonevent.startstring
stable
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000event.typestring
stable
High level, domain specific classification criteria for the event. For a carbon bizevent, this value must be
Tags:
High level, domain specific classification criteria for the event. For a carbon bizevent, this value must be
carbon.measurement 2Tags:
permissioncarbon.measurementsystem.modelstring
experimental
The system model of the instrumented host. The value is optional as it is not always available
The system model of the instrumented host. The value is optional as it is not always available
t3.medium; m5.large; Dell Precision 5540system.processor.modelstring
experimental
System processor model of the instrumented host.
System processor model of the instrumented host.
Intel(R) Xeon(R) Platinum 8175M CPU @ 2.50GHz; Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHztimestamptimestamp
stable
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
1649822520123123123utilization.cpu.averagearray
experimental
Array of averages of CPU usage metric from the host used in the calculation. Values are optional as a bizevent can be ingested directly with energy consumption from a device that doesn't require energy estimation from utilization metrics.
Array of averages of CPU usage metric from the host used in the calculation. Values are 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.averagedouble
experimental
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.
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.averagedouble
experimental
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.
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.averagedouble
experimental
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.
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.
1
If not set, automatically set to value unknown
2
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"
Attribute
Type
Description
Examples
cloud.providerstring
experimental
Name of the cloud provider.
Name of the cloud provider.
alibaba_cloudcloud.regionstring
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1cost.currencystring
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
EURcost.totaldouble
experimental
Total cost based on public price list from instrumented resource.
Total cost based on public price list from instrumented resource.
0.384dt.entity.hoststring
stable
An entity ID of an entity of type HOST.
Tags:
An entity ID of an entity of type HOST.
Tags:
entity-idHOST-E0D8F94D9065F24Fevent.endstring
stable
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123event.idstring
stable
Unique identifier string of an event, is stable across multiple refreshes and updates.
Unique identifier string of an event, is stable across multiple refreshes and updates.
5547782627070661074_1647601320000event.providerstring
stable
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
Tags:
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:
permissiondynatrace.biz.carbonevent.startstring
stable
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123event.typestring
stable
High level, domain specific classification criteria for the event. In this type of event, it should be
Tags:
High level, domain specific classification criteria for the event. In this type of event, it should be
cost.list.spend.Tags:
permissioncost.list.spendprice.currencystring
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USDprice.totaldouble
experimental
Total cost per hour of the resource based on public price list.
Total cost per hour of the resource based on public price list.
0.384resource.categorystring
experimental
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance; faas; ec2; storageresource.instance.cpu_coreslong
experimental
Number of CPU cores on instance price list
Number of CPU cores on instance price list
4resource.instance.memory_totallong
experimental
(Optional) Total memory of the instance on price list, expressed in bytes.
(Optional) Total memory of the instance on price list, expressed in bytes.
454555resource.instance.os_typestring
experimental
Type of operating system in the instance on price list
Type of operating system in the instance on price list
Linux; Windowsresource.instance.typestring
experimental
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
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.largetimestamptimestamp
stable
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
16498225201231231231
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"
Attribute
Type
Description
Examples
cloud.providerstring
experimental
Name of the cloud provider.
Name of the cloud provider.
alibaba_cloudcloud.regionstring
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1event.idstring
stable
Uniquely identifies the event within the
Uniquely identifies the event within the
event.provider realm (event.provider and event.id should define a unique identification critera for the event).5547782627070661074_1647601320000event.providerstring
stable
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
Tags:
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:
permissiondynatrace.biz.carbon; othercloud.price.list.scriptevent.typestring
stable
High level, domain specific classification criteria for the event. In this type of event, it should be
Tags:
High level, domain specific classification criteria for the event. In this type of event, it should be
cost.list.price.Tags:
permissioncost.list.priceprice.currencystring
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USDprice.totaldouble
experimental
Total cost per hour of the resource based on public price list.
Total cost per hour of the resource based on public price list.
0.384resource.categorystring
experimental
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance; faas; ec2; storageresource.instance.cpu_coreslong
experimental
Number of CPU cores on instance price list
Number of CPU cores on instance price list
4resource.instance.memory_totallong
experimental
(Optional) Total memory of the instance on price list, expressed in bytes.
(Optional) Total memory of the instance on price list, expressed in bytes.
454555resource.instance.os_typestring
experimental
Type of operating system in the instance on price list
Type of operating system in the instance on price list
Linux; Windowsresource.instance.typestring
experimental
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
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.largetimestamptimestamp
stable
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
The time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. If no original timestamp is available, it will be populated at ingest time. Required for all events. In case of a correlated event (e.g. 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.
16498225201231231231
If not set, automatically set to value unknown