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.category
string
stable
Use to augment event.kind and event.type fields with an additional level of Business Event classification criteria.
checkout
event.id
string
stable
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
string
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: permission
BIZ_EVENT
event.provider
string
stable
The domain specific identification of the event originating component. 2
Tags: permission
www.easytrade.com
event.type
string
stable
High level, domain specific classification criteria for the event. 3
Tags: permission
com.easytrade.purchase
timestamp
timestamp
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.
1649822520123123123
1

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.emissions
double
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.
carbon.intensity
double
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.
carbon.intensity.last_update
string
experimental
Date of the last update known from the carbon intensity value.
1970-01-01T00:00:00.000Z
carbon.intensity.origin
string
experimental
Origin of the value of carbon intensity used on calculations.
global; provider; custom; geographical
cloud.provider
string
experimental
Name of the cloud provider.
alibaba_cloud
cloud.region
string
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
dt.entity.host
string
stable
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
energy.measurement.algorithm
string
experimental
Algorithm variant used for carbon estimation.
standard; standard-networkByScope
energy.measurement.computing
double
deprecated
Deprecated, do not use it! Use energy.measurement.machine instead.
energy.measurement.cooling
double
deprecated
Deprecated, do not use it! Use energy.measurement.infrastructure_overhead instead.
energy.measurement.cpu
double
experimental
Energy estimation (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional.
energy.measurement.cpu_unknown
boolean
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.
energy.measurement.gpu
double
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.
energy.measurement.infrastructure_overhead
double
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.
energy.measurement.io
double
experimental
Estimation of the energy (Wh) consumed by storage in a host based on storage utilization metrics. Value is optional.
energy.measurement.machine
double
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.
energy.measurement.memory
double
experimental
Estimation of the energy (Wh) consumed by memory in a host based on memory utilization metrics. Value is optional.
energy.measurement.missing_metrics
string
experimental
Optional list of missing infrastructure utilization metrics
io; network
energy.measurement.network
double
experimental
Estimation of the energy (Wh) consumed by network in a host based on network utilization metrics. Value is optional.
energy.measurement.total
double
experimental
Total amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting or other.
energy.pue
double
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.
1.58
energy.pue.last_update
string
experimental
Date of the last update to energy.pue.
1970-01-01T00:00:00.000Z
energy.pue.origin
string
experimental
Origin of Power Usage Effectiveness (PUE) value.
global; aws; gcp; azure; custom
event.end
string
stable
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.id
string
stable
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
string
stable
The domain specific identification of the event originating component. 1
Tags: permission
dynatrace.biz.carbon
event.start
string
stable
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.type
string
stable
High level, domain specific classification criteria for the event. For a carbon bizevent, this value must be carbon.measurement 2
Tags: permission
carbon.measurement
execution.method
string
experimental
What kind of trigger is used to execute estimation.
workflow-v2; workflow-v3; actions-v4
host.disk.size
double
experimental
The total size of disk storage accessible to a host in bytes.
host.memoryTotal
double
experimental
The total amount of random access memory detected in a host by OneAgent.
system.model
string
experimental
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
string
experimental
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
timestamp
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.
1649822520123123123
utilization.cpu.average
double
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.
0.52
utilization.io.average
double
deprecated
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.average
double
deprecated
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.average
double
deprecated
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.average
double
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.
utilization.networkPublic.average
double
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.
utilization.networkTotal.average
double
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.
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.provider
string
experimental
Name of the cloud provider.
alibaba_cloud
cloud.region
string
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
event.id
string
stable
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
string
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 dynatrace.biz.carbon. For data ingested directly from other sources, description of new source can be included in this attribute. 1
Tags: permission
dynatrace.biz.carbon; othercloud.price.list.script
event.type
string
stable
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
string
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USD
price.total
double
experimental
Total cost per hour of the resource based on public price list.
0.384
resource.category
string
experimental
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance; faas; ec2; storage
resource.instance.cpu_cores
long
experimental
Number of CPU cores on instance price list
4
resource.instance.memory_total
long
experimental
(Optional) Total memory of the instance on price list, expressed in bytes.
454555
resource.instance.os_type
string
experimental
Type of operating system in the instance on price list
Linux; Windows
resource.instance.type
string
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
m5.large
timestamp
timestamp
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.
1649822520123123123
1

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.provider
string
experimental
Name of the cloud provider.
alibaba_cloud
cloud.region
string
stable
Identifier referring to a geographic region of a cloud vendor's datacenter.
us-east-1
cost.currency
string
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
EUR
cost.total
double
experimental
Total cost based on public price list from instrumented resource.
0.384
dt.entity.host
string
stable
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
event.end
string
stable
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123
event.id
string
stable
Unique identifier string of an event, is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.provider
string
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 dynatrace.biz.carbon. For data ingested directly from other sources, description of new source can be included in this attribute. 1
Tags: permission
dynatrace.biz.carbon
event.start
string
stable
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
1649822520123123123
event.type
string
stable
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
string
experimental
Three letter code of currency used on the total hourly cost of the instance, following ISO 4217.
USD
price.total
double
experimental
Total cost per hour of the resource based on public price list.
0.384
resource.category
string
experimental
Category of the resource extracted from public price list of cloud vendor. Its value is optional.
instance; faas; ec2; storage
resource.instance.cpu_cores
long
experimental
Number of CPU cores on instance price list
4
resource.instance.memory_total
long
experimental
(Optional) Total memory of the instance on price list, expressed in bytes.
454555
resource.instance.os_type
string
experimental
Type of operating system in the instance on price list
Linux; Windows
resource.instance.type
string
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
m5.large
timestamp
timestamp
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.
1649822520123123123
1

If not set, automatically set to value unknown