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
Query bizevents in Grail.
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. It 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. It 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 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.
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.
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
Shows carbon dioxide emissions (in grams) and energy consumption (Wh) that are calculated for all hosts that are set up and monitored with OneAgent.
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_updatestring
experimental
Date of the last update known from the carbon intensity value.
Date of the last update known from the carbon intensity value.
1970-01-01T00:00:00.000Zcarbon.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; custom; geographicalcloud.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.algorithmstring
experimental
Algorithm variant used for carbon estimation.
Algorithm variant used for carbon estimation.
standard; standard-networkByScopeenergy.measurement.computingdouble
deprecated
Deprecated, do not use it! Use
Deprecated, do not use it! Use
energy.measurement.machine instead.energy.measurement.coolingdouble
deprecated
Deprecated, do not use it! Use
Deprecated, do not use it! Use
energy.measurement.infrastructure_overhead instead.energy.measurement.cpudouble
experimental
Energy estimation (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional.
Energy estimation (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional.
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.infrastructure_overheaddouble
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.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.machinedouble
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.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.last_updatestring
experimental
Date of the last update to
Date of the last update to
energy.pue.1970-01-01T00:00:00.000Zenergy.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.measurementexecution.methodstring
experimental
What kind of trigger is used to execute estimation.
What kind of trigger is used to execute estimation.
workflow-v2; workflow-v3; actions-v4host.disk.sizedouble
experimental
The total size of disk storage accessible to a host in bytes.
The total size of disk storage accessible to a host in bytes.
host.memoryTotaldouble
experimental
The total amount of random access memory detected in a host by OneAgent.
The total amount of random access memory detected in a host by OneAgent.
system.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 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.
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.
1649822520123123123utilization.cpu.averagedouble
experimental
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.
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.52utilization.io.averagedouble
deprecated
Replaced with
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.
Replaced with
host.disk.size attribute, which more accurately reflects the role of disk storage in the carbon calculation.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
deprecated
Replaced with
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.
Replaced with
host.memoryTotal attribute, which more accurately reflects the role of memory in the carbon calculation.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
deprecated
Deprecated. Use
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.
Deprecated. Use
utilization.networkTotal.average instead.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.
utilization.networkPrivate.averagedouble
experimental
The sum of private download and upload of a host in Bytes per second (B/s), i.e. to network interface cards without public IPs.
The sum of private download and upload of a host in Bytes per second (B/s), i.e. to network interface cards without public IPs.
utilization.networkPublic.averagedouble
experimental
The sum of public download and upload of a host in Bytes per second (B/s), i.e. to network interface cards with public IPs.
The sum of public download and upload of a host in Bytes per second (B/s), i.e. to network interface cards with public IPs.
utilization.networkTotal.averagedouble
experimental
The sum of download and upload of a host in Bytes per second (B/s) averaged out over the duration of a carbon event.
The sum of download and upload of a host in Bytes per second (B/s) averaged out over the duration of a carbon event.
1
If not set, automatically set to value unknown
2
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
Shows the public price list from vendors or estimated price list for on-premise instances.
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 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.
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.
16498225201231231231
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
Shows the costs of resources monitored by OneAgent calculated using public prices of the cloud provider.
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 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.
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.
16498225201231231231
If not set, automatically set to value unknown