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 in Grail.
fetch bizevents
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableUse to augment |
|
| string | stableUniquely identifies the event within the |
|
| string | stableGives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. 1Tags: |
|
| string | stableThe domain specific identification of the event originating component. 2Tags: |
|
| string | stableHigh level, domain specific classification criteria for the event. 3Tags: |
|
| timestamp | stableThe 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. |
|
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 containing carbon dioxide emissions (in grams) and energy consumption (in watt-hours) that are calculated per Kubernetes cluster.
Emissions and electricity are based on the standard carbon.measurement events, which are required for Kubernetes estimation to work.
Shows carbon dioxide emissions (in grams) and energy consumption (Wh) that are calculated for all Kubernetes clusters that are set up and monitored with OneAgent.
fetch bizevents| filter event.type == "carbon.measurement.k8s.cluster"
| Attribute | Type | Description | Examples |
|---|---|---|---|
| double | experimentalTotal emissions in grams of CO₂ equivalent generated by the energy consumption estimations including not only computing but also data center cooling, lighting, and other consumptions. | |
| string | resource stableAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: |
|
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste excluding any data center energy overheads. |
|
| double | experimentalTotal amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting, or other consumption. | |
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste. Includes data center cooling, lighting and other consumptions to the total energy wasted. |
|
| string | stableThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableUniquely identifies the event within the |
|
| string | stableThe domain-specific identification of the event originating component. 1Tags: |
|
| string | stableThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableHigh-level, domain-specific classification criteria for the event. For a carbon Kubernetes cluster bizevent, this value must be |
|
| string | resource stable(Optional) The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable.Tags: |
|
| string | experimentalType of the monitoring mode reported by Dynatrace. |
|
| timestamp | stableThe 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. |
|
If not set, automatically set to value unknown
If not set, automatically set to value unknown
Carbon business events containing carbon dioxide emissions (in grams) and energy consumption (in watt-hours) that are calculated per Kubernetes namespace.
Emissions and electricity are based on the standard carbon.measurement events, which are required for Kubernetes estimation to work.
Shows carbon dioxide emissions (in grams) and energy consumption (Wh) that are calculated for all Kubernetes namespaces that are set up and monitored with OneAgent.
fetch bizevents| filter event.type == "carbon.measurement.k8s.namespace"
| Attribute | Type | Description | Examples |
|---|---|---|---|
| double | experimentalTotal emissions in grams of CO₂ equivalent generated by the energy consumption estimations including not only computing but also data center cooling, lighting, and other consumptions. | |
| string | resource stableAn entity ID of an entity of type CLOUD_APPLICATION_NAMESPACE. A CLOUD_APPLICATION_NAMESPACE is a Kubernetes namespace.Tags: |
|
| string | resource stableAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: |
|
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste excluding any data center energy overheads. |
|
| double | experimentalTotal amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting, or other consumption. | |
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste. Includes data center cooling, lighting and other consumptions to the total energy wasted. |
|
| string | stableThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableUniquely identifies the event within the |
|
| string | stableThe domain-specific identification of the event originating component. 1Tags: |
|
| string | stableThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableHigh-level, domain-specific classification criteria for the event. For a carbon Kubernetes namespace bizevent, this value must be |
|
| string | resource stable(Optional) The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable.Tags: |
|
| string | resource stableThe name of the namespace that the pod is running in.Tags: |
|
| string | experimentalType of the monitoring mode reported by Dynatrace. |
|
| timestamp | stableThe 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. |
|
If not set, automatically set to value unknown
If not set, automatically set to value unknown
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.
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 |
|---|---|---|---|
| double | experimentalTotal emissions in grams of CO₂ equivalent generated by the energy consumption estimations including not only computing but also data center cooling, lighting, and other consumptions. | |
| double | experimentalValue 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. | |
| string | experimentalDate of the last update known from the carbon intensity value. |
|
| string | experimentalOrigin of the value of carbon intensity used on calculations. |
|
| string | resource experimentalName of the cloud provider. |
|
| string | resource stableIdentifier of the cloud vendor's data center geographic region. |
|
| string | resource stableAn entity ID of an entity of type HOST.Tags: |
|
| double | experimentalCPU idle threshold setting (in percentage) in effect at the time of event ingestion. |
|
| string | experimentalAlgorithm variant used for carbon estimation. |
|
| double | deprecatedDeprecated, do not use it! Use | |
| double | deprecatedDeprecated, do not use it! Use | |
| double | experimentalEnergy estimation (Wh) consumed by CPUs in a host based on CPU utilization metrics. Value is optional. | |
| boolean | experimentalInform 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. | |
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste excluding any data center energy overheads. |
|
| double | experimentalEstimation 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. | |
| double | experimentalTotal amount of energy in Wh estimated for the energy consumption estimated for data center cooling, lighting or other consumptions, not including computing energy consumption. | |
| double | experimentalEstimation of the energy (Wh) consumed by storage in a host based on storage utilization metrics. Value is optional. | |
| double | experimentalTotal 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. | |
| double | experimentalEstimation of the energy (Wh) consumed by memory in a host based on memory utilization metrics. Value is optional. | |
| string | experimentalOptional list of missing infrastructure utilization metrics |
|
| double | experimentalEstimation of the energy (Wh) consumed by network in a host based on network utilization metrics. Value is optional. | |
| double | experimentalTotal amount of energy in Wh estimated for the energy consumption estimated for compute and for data center cooling, lighting, or other consumption. | |
| double | experimentalEnergy wasted (Wh) based on CPU utilization waste. Includes data center cooling, lighting and other consumptions to the total energy wasted. |
|
| double | experimentalPower Usage Effectiveness (PUE) value used on the calculation to include data center cooling, lighting and other consumptions to the total energy estimated for compute. |
|
| string | experimentalDate of the last update to |
|
| string | experimentalOrigin of Power Usage Effectiveness (PUE) value. |
|
| string | stableThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableUniquely identifies the event within the |
|
| string | stableThe domain specific identification of the event originating component. 1Tags: |
|
| string | stableThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableHigh level, domain specific classification criteria for the event. For a carbon bizevent, this value must be |
|
| string | experimentalWhat kind of trigger is used to execute estimation. |
|
| double | experimentalThe total size of disk storage accessible to a host in bytes. | |
| double | experimentalThe total amount of random access memory detected in a host by OneAgent. | |
| string | experimentalThe system model of the instrumented host. The value is optional as it is not always available |
|
| string | experimentalSystem processor model of the instrumented host. |
|
| timestamp | stableThe 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. |
|
| double | experimentalAverage 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. |
|
| double | **deprecatedReplaced with | |
| double | **deprecatedReplaced with | |
| double | **deprecatedDeprecated. Use | |
| double | experimentalThe sum of private download and upload of a host in Bytes per second (B/s), i.e. to network interface cards without public IPs. | |
| double | experimentalThe sum of public download and upload of a host in Bytes per second (B/s), i.e. to network interface cards with public IPs. | |
| double | experimentalThe sum of download and upload of a host in Bytes per second (B/s) averaged out over the duration of a carbon event. |
If not set, automatically set to value unknown
If not set, automatically set to value unknown
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).
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 |
|---|---|---|---|
| string | resource experimentalName of the cloud provider. |
|
| string | resource stableIdentifier of the cloud vendor's data center geographic region. |
|
| string | stableUniquely identifies the event within the |
|
| string | stableThe 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 |
|
| string | stableHigh level, domain specific classification criteria for the event. In this type of event, it should be |
|
| string | experimentalThree letter code of currency used on the total hourly cost of the instance, following ISO 4217. |
|
| double | experimentalTotal cost per hour of the resource based on public price list. |
|
| string | experimentalCategory of the resource extracted from public price list of cloud vendor. Its value is optional. |
|
| long | experimentalNumber of CPU cores on instance price list |
|
| long | experimental(Optional) Total memory of the instance on price list, expressed in bytes. |
|
| string | experimentalType of operating system in the instance on price list |
|
| string | experimentalAWS, GCE or Azure machine-type, retrieved from instance metadata service. In Semantic Dictionary this attribute appears in dt.entity.host in system.model value |
|
| timestamp | stableThe 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. |
|
If not set, automatically set to value unknown
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).
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 |
|---|---|---|---|
| string | resource experimentalName of the cloud provider. |
|
| string | resource stableIdentifier of the cloud vendor's data center geographic region. |
|
| string | experimentalThree letter code of currency used on the total hourly cost of the instance, following ISO 4217. |
|
| double | experimentalTotal cost based on public price list from instrumented resource. |
|
| string | resource stableAn entity ID of an entity of type HOST.Tags: |
|
| string | stableThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableUnique identifier string of an event; is stable across multiple refreshes and updates. |
|
| string | stableThe 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 |
|
| string | stableThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableHigh level, domain specific classification criteria for the event. In this type of event, it should be |
|
| string | experimentalThree letter code of currency used on the total hourly cost of the instance, following ISO 4217. |
|
| double | experimentalTotal cost per hour of the resource based on public price list. |
|
| string | experimentalCategory of the resource extracted from public price list of cloud vendor. Its value is optional. |
|
| long | experimentalNumber of CPU cores on instance price list |
|
| long | experimental(Optional) Total memory of the instance on price list, expressed in bytes. |
|
| string | experimentalType of operating system in the instance on price list |
|
| string | experimentalAWS, GCE or Azure machine-type, retrieved from instance metadata service. In Semantic Dictionary this attribute appears in dt.entity.host in system.model value |
|
| timestamp | stableThe 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. |
|
If not set, automatically set to value unknown
Real billing costs events contains the real billing cost data ingested from cloud vendors. Every event is a line of the invoices ingested, and events are generated every hour for daily data, and once a day for monthly data.
Shows all the line items of real billing cost data in USD from cloud providers
fetch bizevents| filter event.type == "cost.real.spend"
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | resource stableIdentifier referring to the availability zone within a cloud vendor's region. |
|
| string | resource experimentalName of the cloud provider. |
|
| string | resource stableIdentifier of the cloud vendor's data center geographic region. |
|
| string | stableThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableUnique identifier string of an event; is stable across multiple refreshes and updates. |
|
| string | stableThe 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 |
|
| string | stableThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableHigh level, domain specific classification criteria for the event. In this type of event, it should be |
|
| string | experimentalProvider-assigned identifier for a physically separated and isolated area within a region that provides high availability and fault tolerance. Availability Zone is commonly used for scenarios like analyzing cross-zone data transfer usage and the corresponding cost based on where resources are deployed. |
|
| double | experimentalA charge serving as the basis for invoicing, inclusive of all reduced rates and discounts while excluding the amortization of upfront charges (one-time or recurring). |
|
| string | experimentalThe identifier assigned to a billing account by the provider. |
|
| string | experimentalThe display name assigned to a billing account. |
|
| string | experimentalRepresents the currency that a charge was billed in. |
|
| string | experimentalThe exclusive end date and time of a billing period. |
|
| string | experimentalThe inclusive start date and time of a billing period. |
|
| string | experimentalA provider-assigned identifier for a capacity reservation. Capacity reservations are used to ensure that resources are available when needed. |
|
| string | experimentalThe status of a capacity reservation. |
|
| string | experimentalThe category of the charge. |
|
| string | experimentalThe class of the charge. |
|
| string | experimentalA description of the charge. |
|
| string | experimentalThe frequency of the charge. |
|
| string | experimentalThe end date and time of the charge period. |
|
| string | experimentalThe start date and time of the charge period. |
|
| string | experimentalThe category of the commitment discount. |
|
| string | experimentalA provider-assigned identifier for a commitment discount. |
|
| string | experimentalThe name of the commitment discount. |
|
| double | experimentalThe quantity of the commitment discount. |
|
| string | experimentalThe status of the commitment discount. |
|
| string | experimentalThe type of the commitment discount. |
|
| string | experimentalThe unit of the commitment discount. |
|
| double | experimentalThe quantity of resources consumed. |
|
| string | experimentalThe unit of the consumed quantity. |
|
| double | experimentalThe cost agreed upon in a contract for a specific service or resource. This cost is typically used in scenarios where there are long-term agreements or commitments with a service provider. |
|
| double | experimentalThe unit price agreed upon in a contract for a specific service or resource. |
|
| double | experimentalThe effective cost after applying discounts and credits. |
|
| string | experimentalThe entity that issued the invoice. |
|
| double | experimentalThe list cost of a service or resource before any discounts or credits are applied. |
|
| double | experimentalThe list unit price of a service or resource before any discounts or credits are applied. |
|
| string | experimentalThe category of the pricing. |
|
| double | experimentalThe quantity of the pricing. |
|
| string | experimentalThe unit of the pricing quantity. |
|
| string | experimentalThe provider of the service or resource. |
|
| string | experimentalThe publisher of the service or resource. |
|
| string | experimentalA provider-assigned identifier for a region. |
|
| string | experimentalThe name of the region. |
|
| string | experimentalA provider-assigned identifier for a resource. |
|
| string | experimentalThe name of the resource. |
|
| string | experimentalThe type of the resource. |
|
| string | experimentalThe category of the service. |
|
| string | experimentalThe name of the service. |
|
| string | experimentalThe subcategory of the service. |
|
| string | experimentalA provider-assigned identifier for a SKU (Stock Keeping Unit). |
|
| string | experimentalThe meter associated with the SKU. |
|
| string | experimentalThe price details associated with the SKU. |
|
| string | experimentalA provider-assigned identifier for the SKU price. |
|
| string | experimentalA provider-assigned identifier for a sub-account. |
|
| string | experimentalThe name of the sub-account. |
|
| string | experimentalThe set of tags assigned to tag sources that account for potential provider-defined or user-defined tag evaluations. |
|
| string | experimentalThe version of the focus specification |
|
| string | experimentalPrice total granularity. |
|
| timestamp | stableThe 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. |
|
If not set, automatically set to value unknown