Try it free

System event models

  • Latest Dynatrace
  • Reference

System events are used to store details about executed queries, auditing events, billing events and more. In order to query system events, you need the storage:system:read permission.

Query

Query system events.

fetch dt.system.events

AI Function Standard Call billing usage

Model describing a billing usage event for AI Function Standard Calls. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for AI Function Standard Calls.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Function Standard Call"
| dedup event.id

Analyze billing usage of AI Function Standard Calls by tool and caller type.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Function Standard Call"
| dedup event.id
| summarize billed_invocations = sum(billed_invocations), by: {tool, caller.type}

Analyze billing usage of AI Function Standard Calls by app and tool.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Function Standard Call"
| dedup event.id
| summarize billed_invocations = sum(billed_invocations), by: {caller.app.id, tool}
| sort billed_invocations desc

AI Function Standard Call billing usage fields

AttributeTypeDescriptionExamples
billed_invocationslongstable
Number of billed invocations. Unit is 1/4 GiB * min
8
caller.app.idstringstable
The entity/app invoking the function or not set when not invoked by an app.
dynatrace.hub
caller.service.idstringstable
The service invoking the function or not set when not invoked by a service.
DI_ENGINE
caller.typestringexperimental
The type of caller that invoked the GenAI skill.
API; MCP; INTERNAL
conversation_idstringexperimental
A UUID identifying a conversation across multiple messages.
55239b04-8f8d-4e26-88fa-f75357a626a2
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
AI Function Standard Call
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
session_idstringexperimental
UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection.
cf45e99d-43c2-466f-a455-ab37cf942a54
timestamptimestampstable
Display name: 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
toolstringexperimental
The name of the MCP server tool or AI function tool that was invoked.
execute-dql
tool.categorystringexperimental
The category of the invoked tool.
standard
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system
workflow.execution.idstringstable
The unique identifier of a workflow execution as UUID.
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
workflow.idstringstable
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141

AI Units billing usage

Model describing a billing usage event for AI Units. Billing usage events are stored in the dt.system.events table. Unlike the AI Function Standard Call, this event tracks billable quantity instead of a flat invocation count.

Query

Analyze billing usage events for AI Units.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Units"
| dedup event.id

Analyze billable quantity of AI Units by tool and caller type.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Units"
| dedup event.id
| summarize total_quantity = sum(usage.quantity.billable), by: {tool, caller.type}

Analyze billable quantity of AI Units by app and tool.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AI Units"
| dedup event.id
| summarize total_quantity = sum(usage.quantity.billable), by: {caller.app.id, tool}
| sort total_quantity desc

AI Units billing usage fields

AttributeTypeDescriptionExamples
caller.app.idstringstable
The entity/app invoking the function or not set when not invoked by an app.
dynatrace.hub
caller.service.idstringstable
The service invoking the function or not set when not invoked by a service.
DI_ENGINE
caller.typestringexperimental
The type of caller that invoked the GenAI skill.
API; MCP; INTERNAL
conversation_idstringexperimental
A UUID identifying a conversation across multiple messages.
55239b04-8f8d-4e26-88fa-f75357a626a2
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
AI Units
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
session_idstringexperimental
UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection.
cf45e99d-43c2-466f-a455-ab37cf942a54
timestamptimestampstable
Display name: 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
toolstringexperimental
The name of the MCP server tool or AI function tool that was invoked.
create-dql
tool.categorystringexperimental
The category of the invoked tool.
ai
usage.quantity.billabledoubleexperimental
Billable quantity of AI units, adjusted by a variable weight factor. See pricing documentation for estimated weight values by use case.
3.0; 8.0; 30.0
usage.unitstringexperimental
Billing unit for an AI unit charge.
Units
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system
workflow.execution.idstringstable
The unique identifier of a workflow execution as UUID.
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
workflow.idstringstable
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141

Analyzer execution event

Analyzer execution events track all executions of analyzers.

Query

List all analyzer executions.

fetch dt.system.events
| filter event.kind == "ANALYZER_EXECUTION_EVENT"

List all analyzer executions that failed.

fetch dt.system.events, from:now()-24h
| filter event.kind == "ANALYZER_EXECUTION_EVENT"
| filter dt.analyzer.result_status == "FAILED"

Chart the number of result records for each task and user.

fetch dt.system.events
| filter event.kind == "ANALYZER_EXECUTION_EVENT"
| fieldsRename dt.settings.object_id = dt.task.id
| makeTimeseries result_records = sum(dt.analyzer.result_records), by:{dt.settings.object_id, user.id}

Analyzer execution event fields

AttributeTypeDescriptionExamples
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
dt.analyzer.analysis_timeframe.endtimestampexperimental
End time (UNIX Epoch time in nanoseconds) of the analysis timeframe specified in the general parameters of the analyzer input.
2025-08-01T11:55:00.000000000+02:00
dt.analyzer.analysis_timeframe.starttimestampexperimental
Start time (UNIX Epoch time in nanoseconds) of the analysis timeframe specified in the general parameters of the analyzer input.
2025-08-01T13:56:00.000000000+02:00
dt.analyzer.error_messagesstring[]experimental
Errors that occurred during analysis.
['"Maximum number of concurrent queries per tenant reached."']
dt.analyzer.execution.endtimestampexperimental
Time (UNIX Epoch time in nanoseconds) when the analyzer execution stopped.
2025-08-01T11:55:01.000000000+02:00
dt.analyzer.execution.starttimestampexperimental
Time (UNIX Epoch time in nanoseconds) when the analyzer execution started.
2025-08-01T11:55:00.000000000+02:00
dt.analyzer.namestringexperimental
Name of the executed analyzer.
dt.statistics.anomaly_detection.StaticThresholdAnomalyDetectionAnalyzer
dt.analyzer.result_recordslongexperimental
Number of output records from analysis.
0; 42; 100000
dt.analyzer.result_statusstringexperimental
Indicates whether the analyzer was successfully executed.
SUCCESSFUL; SUCCESSFUL_WITH_WARNINGS; FAILED
dt.analyzer.warning_messagesstring[]experimental
Warnings that occurred during analysis.
['"Your result has been limited because the maximum bytes (100000000) were reached."']
dt.task.failure_reasonstringexperimental
Explains why dt.task.result_status is FAILED.
Analyzer execution failed
dt.task.groupstringexperimental
Group of the executed task. Tasks that share the same group usually share the same source.
builtin:davis.anomaly-detectors
dt.task.idstringexperimental
Identifier of the executed task.
vu9U3hXa3q0AAAABAB9idWlsdGluOmRhdmlzLmFub21hbHktZGV0ZWN0b3JzAAZ0ZW5hbnQABnRlbmFudAAkOWMxODdhMzYtYTJhNC0zZDY3LThiMGEtNTYwOTljYjM4Yzg4vu9U3hXa3q0
dt.task.namestringexperimental
Name of the executed task.
Response time degradation alert
dt.task.result_statusstringexperimental
Indicates whether the task was successfully executed. CANCELED indicates the task could not succeed within the given time budget.
SUCCESS; FAILED; CANCELED
dt.task.scheduling_expressionstringexperimental
Expression that defines the concrete task schedule. The expression syntax depends on the selected dt.task.scheduling_type.
PT1M; PT10M
dt.task.scheduling_typestringexperimental
Scheduling method used for the task.
FIXED_DELAY; FIXED_RATE
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
ANALYZER_EXECUTION_EVENT
timestamptimestampstable
Display name: 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
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Anomaly Detector status event

The Anomaly Detector status events are used for Davis anomaly detection. They track errors and warnings during the execution of an anomaly detector. Examples:

  • Query runs into a timeout
  • Query fails as unauthorized
  • Query result is truncated as the scanned bytes limit was reached
  • …

Query

Analyze anomaly detectors status events.

fetch dt.system.events
| filter event.kind == "ANOMALY_DETECTOR_STATUS_EVENT"

Anomaly Detector status event fields

AttributeTypeDescriptionExamples
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
davis.anomaly_detector.messagestringexperimental
Additional details about the anomaly detector status
Maximum number of concurrent queries per tenant reached.
davis.anomaly_detector.statusstringexperimental
Severity of an anomaly detector status
ERROR; WARNING
dt.settings.object_idstringexperimental
Display name: Settings object ID
The object ID of a settings value. This corresponds to the 'objectId' field/parameter in the Settings API.
vu9U3hXa3q0AAAABACFidWlsdGluOnJ1bS51c2VyLWV4cGVyaWVuY2Utc2NvcmUABnRlbmFudAAGdGVuYW50ACRhMzZmYmYwMy00NDY1LTNlNTYtOTZiOS1kOWMzOGQ3MzU1NmO-71TeFdrerQ
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
ANOMALY_DETECTOR_STATUS_EVENT
timestamptimestampstable
Display name: 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

AppEngine Functions - Small billing usage

Model describing a billing usage event of function invocations. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AppEngine Functions - Small"
| dedup event.id

Analyze billing usage of function invocations by their respective workflow ID.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AppEngine Functions - Small"
| dedup event.id
| filter isNotNull(workflow.id)
| summarize billed_invocations = sum(billed_invocations), by:{workflow.id}

Analyze billing usage of function invocations by the app and function that caused them.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "AppEngine Functions - Small"
| filterOut isNull(dt.app.id) or isNull(function.id)
| summarize billed_invocations = sum(billed_invocations), by:{dt.app.id, function.id}
| sort billed_invocations desc

AppEngine Functions - Small billing usage fields

AttributeTypeDescriptionExamples
billed_invocationslongstable
Number of billed invocations. Unit is 1/4 GiB * min
8
caller.app.idstringstable
The entity/app invoking the function or not set when not invoked by an app.
dynatrace.hub
caller.service.idstringstable
The service invoking the function or not set when not invoked by a service.
AUTOMATION_ENGINE
dt.app.idstringresource stable
Display name: Dynatrace app ID
The unique application identifier. Dynatrace apps are prefixed with 'dynatrace.', custom apps are prefixed with 'my.'.
dynatrace.notebooks; my.awesome.app
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
AppEngine Functions - Small
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
function.duration_seclongstable
Duration of the function call in seconds. Measures not the actual execution time but the duration in the function proxy including network roundtrip to the Runtime. If the duration is bigger than the maximum allowed duration (which may happen due to technical reasons) the reported value is set to the maximum allowed duration.
60
function.execution_idstringstable
If the execution of a resumable function last for more than 2 minutes, there will be multiple BILLING_USAGE_EVENTs created for that execution, which will have the same value in this field. It can therefore be used to join BILLING_USAGE_EVENTs for long running function invocations.
1bfa32fa-679e-4ac9-b683-2d2cdd4b6314
function.idstringstable
The unique identifier of a function containing the app id and function id in the form of {app.id}.{function.id}. Missing for adhoc executions.
myapp.test/path/myfunction
function.memory_miblongstable
Runtime memory in MiB. Some of the memory is not available to the javascript code, because it is needed by the runtime itself.
128
function.typestringstable
The identifier defining the function type.
STANDARD; ACTION; AD_HOC
timestamptimestampstable
Display name: 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
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system
workflow.execution.idstringstable
The unique identifier of a workflow execution as UUID.
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
workflow.idstringstable
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
AppEngine Functions - SmallAppEngine Functions - Small

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

function.type MUST be one of the following:

ValueDescription
AD_HOCAdhoc function execution
STANDARDApp function execution
ACTIONApp function execution, but function is defined as an Action in the app manifest

Audit event

For every API access, Dynatrace stores an audit event in the dt.system.events table. Additionally, the Audit Event allows to attach an arbitrary key/value map with string keys and string values to the event. Keys are prefixed with "details." during serialization.

Query

Analyze audit events stored in the system event bucket.

fetch dt.system.events
| filter event.kind == "AUDIT_EVENT"

Audit event fields

AttributeTypeDescriptionExamples
authentication.client.idstringexperimental
Display name: Authentication client ID
The OAuth2 client id if of type 'CLIENT_CREDENTIALS'.
dt0s02.UZCK6ENL.2YQ2A3DZUEISRJSUU5544J3SC3TMPXSEEMNA5HK7RW54SJ6XKLYGMWJNKL7B2DNH
authentication.grant.typestringexperimental
Display name: Authentication grant type
The grant type used during OAuth2 authentication.
AUTHORIZATION_CODE; CLIENT_CREDENTIALS
authentication.tokenstringexperimental
Display name: Authentication token
The public token identifier of authentication.type 'TOKEN'.
dt0c01.AM4SEYKIBROBEJ2N3HAXZ4IX
authentication.typestringexperimental
Display name: Authentication type
The method of authentication.
OAUTH2
dt.app.functionstringresource experimental
The unique ID of the Dynatrace application function associated with the audit event in case the audited action was performed by a Dynatrace application function.
api/slack-send-message; api/shell-indicator
dt.app.idstringresource stable
Display name: Dynatrace app ID
The unique ID of the Dynatrace application associated with the audit event in case the audited action was performed by a Dynatrace application (either originating from the browser or a serverless function). Dynatrace applications are prefixed with 'dynatrace.' and custom apps are prefixed with 'my.'. If the ID is null, the audited action was not performed by a Dynatrace application, for example, a REST request coming from a customer script.
dynatrace.dashboards; dynatrace.notebooks; my.experimental.app
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
AUDIT_EVENT
event.outcomestringstable
Display name: Event outcome
Denotes whether the event represents a success or a failure from the perspective of the entity that produced the event (for example an HTTP response code).
200; success; failure
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
API_GATEWAY
event.reasonstringstable
Display name: Event reason
Describes why a certain event.outcome was set. Typically, this is some form of error description in the case of a failure.
user is missing permission "logs.read"
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
POST; PUT; GET
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
origin.addressstringexperimental
Display name: Origin address
Source IP address of the request associated with this event. Must be set if origin.type is 'REST', must not be set otherwise.
10.11.12.13
origin.sessionstringexperimental
Display name: Origin session
The ID of the browser session (if present) associated with the event.
node0hfznc
origin.typestringexperimental
Display name: Origin type
Origin type of the request associated with this event.
REST; LOCAL
origin.x_forwarded_forstringexperimental
Display name: Origin x-forwarded-for
The verbatim value of the X-Forwarded-For HTTP request header (if present) of the request associated with the event.
1.2.3.4
request.sourcestringstable
In case of a REST call audit event, this field contains the request source.
BROWSER; DT_SERVERLESS; OTHER
resourcestringstable
Generic reference to a resource like a REST resource URL or a settings ID.
/service/resource; 1234567890
timestamptimestampstable
Display name: 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
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system
user.namestringexperimental
Display name: User name
in the context of audit events, the name of the user is always the email address of the user.
albert.einstein@patent.office
user.organizationstringexperimental
Display name: User organization
Organization the user belongs to.
DYNATRACE; CUSTOMER; PARTNER

Automation Workflow billing usage

Model describing a billing usage event of automation workflows. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for AutomationEngine workflows.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Automation Workflow"

Automation Workflow billing usage fields

AttributeTypeDescriptionExamples
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.endstringstable
Display name: Event end
The event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.startstringstable
Display name: Event start
The event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format).
16481073970000
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Automation Workflow
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
workflow.actorstringstable
The entity executing the workflow as UUID.
b22a50a0-2540-4f29-9452-bc330322fb1e
workflow.created_attimestampstable
The time when the workflow was created.
1649822520123123123
workflow.descriptionstringstable
The description of the workflow.
This is a test workflow
workflow.idstringstable
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
workflow.is_privatestringstable
The boolean identifier denoting the visibility of the workflow.
true; false
workflow.ownerstringstable
The entity owning the workflow as UUID.
f1358516-8136-4634-9012-d2e3dfee38dc
workflow.titlestringstable
The title of the workflow.
Test Workflow
workflow.trigger_typestringstable
The identifier that describes the trigger of the workflow.
schedule; manual
workflow.updated_bystringstable
The entity updating the workflow last.
f1358516-8136-4634-9012-d2e3dfee38dc

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Automation WorkflowAutomation Workflow

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

AutomationEngine action execution event

Model describing an AutomationEngine action execution event. Action execution events are stored in the dt.system.events table.

Query

AutomationEngine action execution state change.

fetch dt.system.events
| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="ACTION_EXECUTION"

AutomationEngine action execution event fields

AttributeTypeDescriptionExamples
dt.automation_engine.action.appstringexperimental
Display name: Action app
The app ID of the app containing the executed action.
dynatrace.automations
dt.automation_engine.action.functionstringexperimental
Display name: Action function name
Name of the function implementing the action.
task_1
dt.automation_engine.action_execution.idstringexperimental
Display name: Action execution ID
The unique identifier of a action execution as UUID.
23e7b55a-884f-4497-8ad6-8d49d52b4348
dt.automation_engine.action_execution.loop.indexlongexperimental
Display name: Action execution loop index
Loop index of the action execution.
dt.automation_engine.action_execution.retry.countlongexperimental
Display name: Action execution retry count
Retry count of the action execution.
dt.automation_engine.is_draftbooleanexperimental
Display name: Workflow is draft
Indicates whether the triggered workflow execution is based on a workflow draft.
true; false
dt.automation_engine.is_task_testbooleanexperimental
Display name: Is task test
Indicates that the task execution or action execution belongs to a task test run of a single target task, rather than a regular workflow execution.
true; false
dt.automation_engine.root_workflow.idstringexperimental
Display name: Root workflow ID
The unique identifier of the root workflow.
e6388e3a-9db2-4226-9327-2ba86eaf12f7
dt.automation_engine.root_workflow_execution.idstringexperimental
Display name: Root workflow execution ID
The unique identifier of the execution of the root workflow. 1
a641fb59-4627-44cd-abaf-b68d86455a5b
dt.automation_engine.statestringexperimental
Display name: Execution state
The state of an execution. Values depend on type of execution (workflow-, task-, or action execution).
RUNNING; SUCCESS; ERROR
dt.automation_engine.state.is_finalbooleanexperimental
Display name: Execution state is final
Indicates if dt.automation_engine.state is a final and immutable state or if further processing will happen.
true; false
dt.automation_engine.state_infostringexperimental
Display name: Execution state info
Additional info about current state of execution. Typically holds error details.
ERROR
dt.automation_engine.task.namestringexperimental
Display name: Task name
The identifier of a task within a workflow.
task_1
dt.automation_engine.workflow.idstringexperimental
Display name: Workflow ID
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
dt.automation_engine.workflow.titlestringexperimental
Display name: Workflow title
The title of the workflow.
My Workflow
dt.automation_engine.workflow_execution.idstringexperimental
Display name: Workflow execution ID
The unique identifier of a workflow execution as UUID. 2
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
durationdurationstable
Display name: Duration
The difference between start_time and end_time in nanoseconds.
42
end_timetimestampstable
Display name: End time
End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time.
1649822520123123165
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
WORKFLOW_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
AUTOMATION_ENGINE
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
ACTION_EXECUTION
start_timetimestampstable
Display name: Start time
Start time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time.
1649822520123123123
timestamptimestampstable
Display name: 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
1

Absent for task test runs, which have no root workflow execution.

2

Absent for task test runs, which have no workflow execution.

Values

event.kind MUST be one of the following:

ValueDescription
WORKFLOW_EVENTEvent in context of a workflow

event.provider MUST be one of the following:

ValueDescription
AUTOMATION_ENGINEEvent produced by AutomationEngine

event.type MUST be one of the following:

ValueDescription
ACTION_EXECUTIONTask execution state change event

dt.automation_engine.state MUST be one of the following:

ValueDescription
RUNNINGAction execution started.
SUCCESSAction execution finished successfully.
ERRORAction execution failed.

AutomationEngine task execution event

Model describing an AutomationEngine task execution event. Task execution events are stored in the dt.system.events table.

Query

AutomationEngine task execution state change.

fetch dt.system.events
| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="TASK_EXECUTION"

AutomationEngine task execution event fields

AttributeTypeDescriptionExamples
dt.automation_engine.is_draftbooleanexperimental
Display name: Workflow is draft
Indicates whether the triggered workflow execution is based on a workflow draft.
true; false
dt.automation_engine.is_task_testbooleanexperimental
Display name: Is task test
Indicates that the task execution or action execution belongs to a task test run of a single target task, rather than a regular workflow execution.
true; false
dt.automation_engine.root_workflow.idstringexperimental
Display name: Root workflow ID
The unique identifier of the root workflow.
e6388e3a-9db2-4226-9327-2ba86eaf12f7
dt.automation_engine.root_workflow_execution.idstringexperimental
Display name: Root workflow execution ID
The unique identifier of the execution of the root workflow. 1
a641fb59-4627-44cd-abaf-b68d86455a5b
dt.automation_engine.statestringexperimental
Display name: Execution state
The state of an execution. Values depend on type of execution (workflow-, task-, or action execution).
RUNNING; SUCCESS; ERROR
dt.automation_engine.state.is_finalbooleanexperimental
Display name: Execution state is final
Indicates if dt.automation_engine.state is a final and immutable state or if further processing will happen.
true; false
dt.automation_engine.state_infostringexperimental
Display name: Execution state info
Additional info about current state of execution. Typically holds error details.
ERROR
dt.automation_engine.task.namestringexperimental
Display name: Task name
The identifier of a task within a workflow.
task_1
dt.automation_engine.test_task_execution.actorstringexperimental
Display name: Task test actor
The unique identifier of the actor the task test ran as.
e622afae-ccc7-4fb5-acc5-13b32e827bbe
dt.automation_engine.test_task_execution.trigger.user.idstringexperimental
Display name: Task test trigger user ID
The unique identifier of the user who triggered the task test.
dad18fa7-3c11-40a1-b760-1d8281bb5dcc
dt.automation_engine.workflow.idstringexperimental
Display name: Workflow ID
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
dt.automation_engine.workflow.titlestringexperimental
Display name: Workflow title
The title of the workflow.
My Workflow
dt.automation_engine.workflow_execution.idstringexperimental
Display name: Workflow execution ID
The unique identifier of a workflow execution as UUID. 2
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
durationdurationstable
Display name: Duration
The difference between start_time and end_time in nanoseconds.
42
end_timetimestampstable
Display name: End time
End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time.
1649822520123123165
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
WORKFLOW_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
AUTOMATION_ENGINE
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
TASK_EXECUTION
start_timetimestampstable
Display name: Start time
Start time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time.
1649822520123123123
timestamptimestampstable
Display name: 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
1

Absent for task test runs, which have no root workflow execution.

2

Absent for task test runs, which have no workflow execution.

Values

event.kind MUST be one of the following:

ValueDescription
WORKFLOW_EVENTEvent in context of a workflow

event.provider MUST be one of the following:

ValueDescription
AUTOMATION_ENGINEEvent produced by AutomationEngine

event.type MUST be one of the following:

ValueDescription
TASK_EXECUTIONTask execution state change event

dt.automation_engine.state MUST be one of the following:

ValueDescription
SKIPPEDTask skipped due to task conditions evaluation or task is disabled.
DISCARDEDTask discarded due to predecessor task conditions evaluation.
WAITINGTask waiting due to e.g. task option configuration.
RUNNINGTask execution has running action execution.
SUCCESSTask execution finished successfully.
CANCELLEDTask execution cancelled manually/by API request.
ERRORTask execution finished due to at least one failed action execution and no retries configured/left to process.

AutomationEngine workflow execution event

Model describing an AutomationEngine workflow execution event. Workflow execution events are stored in the dt.system.events table.

Query

AutomationEngine workflow execution state change.

fetch dt.system.events
| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="WORKFLOW_EXECUTION"

AutomationEngine workflow execution event fields

AttributeTypeDescriptionExamples
dt.automation_engine.is_draftbooleanexperimental
Display name: Workflow is draft
Indicates whether the triggered workflow execution is based on a workflow draft.
true; false
dt.automation_engine.root_workflow.idstringexperimental
Display name: Root workflow ID
The unique identifier of the root workflow.
e6388e3a-9db2-4226-9327-2ba86eaf12f7
dt.automation_engine.root_workflow_execution.idstringexperimental
Display name: Root workflow execution ID
The unique identifier of the execution of the root workflow.
a641fb59-4627-44cd-abaf-b68d86455a5b
dt.automation_engine.statestringexperimental
Display name: Execution state
The state of an execution. Values depend on type of execution (workflow-, task-, or action execution).
RUNNING; SUCCESS; ERROR
dt.automation_engine.state.is_finalbooleanexperimental
Display name: Execution state is final
Indicates if dt.automation_engine.state is a final and immutable state or if further processing will happen.
true; false
dt.automation_engine.state_infostringexperimental
Display name: Execution state info
Additional info about current state of execution. Typically holds error details.
ERROR
dt.automation_engine.workflow.idstringexperimental
Display name: Workflow ID
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
dt.automation_engine.workflow.last_execution_state_flipbooleanexperimental
Display name: Workflow last execution state flip
Indicates if the workflow execution state has changed since the last execution, ignoring draft executions. Always false for draft executions.
true; false
dt.automation_engine.workflow.titlestringexperimental
Display name: Workflow title
The title of the workflow.
My Workflow
dt.automation_engine.workflow.typestringexperimental
Display name: Workflow type
Workflow type, either SIMPLE or STANDARD, where SIMPLE comes with restrictions.
SIMPLE; STANDARD
dt.automation_engine.workflow_execution.actorstringexperimental
Display name: Workflow actor
The unique identifier of the actor as defined in the workflow.
e622afae-ccc7-4fb5-acc5-13b32e827bbe
dt.automation_engine.workflow_execution.idstringexperimental
Display name: Workflow execution ID
The unique identifier of a workflow execution as UUID.
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
dt.automation_engine.workflow_execution.trigger.event.idstringexperimental
Display name: Trigger event ID
Unique identifier string (event.id) of the event that triggered the workflow execution. Only set for event-triggered executions.
5547782627070661074_1647601320000
dt.automation_engine.workflow_execution.trigger.event.timestamptimestampexperimental
Display name: Trigger event timestamp
The timestamp of the event that triggered the workflow execution.
1.72852206e18
dt.automation_engine.workflow_execution.trigger.typestringexperimental
Display name: Workflow trigger type
The identifier that describes the trigger of the workflow.
Schedule; Event; Workflow; Manual
dt.automation_engine.workflow_execution.trigger.user.idstringexperimental
Display name: Trigger user ID
The unique identifier of the user who triggered the workflow execution manually/via API.
dad18fa7-3c11-40a1-b760-1d8281bb5dcc
dt.automation_engine.workflow_execution.trigger.workflow_execution.idstringexperimental
Display name: Trigger workflow execution ID
The unique identifier of the workflow that triggered the workflow execution.
737a248b-d1cb-49a4-bf08-7d4c37dbfb1e
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
durationdurationstable
Display name: Duration
The difference between start_time and end_time in nanoseconds.
42
end_timetimestampstable
Display name: End time
End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time.
1649822520123123165
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
WORKFLOW_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
AUTOMATION_ENGINE
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
WORKFLOW_EXECUTION
start_timetimestampstable
Display name: Start time
Start time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time.
1649822520123123123
timestamptimestampstable
Display name: 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

Values

event.kind MUST be one of the following:

ValueDescription
WORKFLOW_EVENTEvent in context of a workflow

event.provider MUST be one of the following:

ValueDescription
AUTOMATION_ENGINEEvent produced by AutomationEngine

event.type MUST be one of the following:

ValueDescription
WORKFLOW_EXECUTIONWorkflow execution state change event

dt.automation_engine.state MUST be one of the following:

ValueDescription
RUNNINGWorkflow execution started.
SUCCESSWorkflow execution finished successfully.
ERRORWorkflow execution failed due to at least one branch with a failed task without an on error successor.
CANCELLEDWorkflow execution cancelled manually/by API request.

AutomationEngine workflow lifecycle event

Model describing an AutomationEngine workflow lifecycle event. Workflow lifecycle events are stored in the dt.system.events table.

Query

AutomationEngine workflow lifecycle events.

fetch dt.system.events
| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and in(event.type, array("WORKFLOW_CREATED", "WORKFLOW_UPDATED", "WORKFLOW_DELETED", "WORKFLOW_TRASHED"))

AutomationEngine workflow lifecycle event fields

AttributeTypeDescriptionExamples
dt.automation_engine.workflow.idstringexperimental
Display name: Workflow ID
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
dt.automation_engine.workflow.titlestringexperimental
Display name: Workflow title
The title of the workflow.
My Workflow
dt.automation_engine.workflow.versionlongexperimental
Display name: Workflow version
The version of the workflow.
1; 42
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
WORKFLOW_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
AUTOMATION_ENGINE
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
WORKFLOW_CREATED; ACTION_EXECUTION; WORKFLOW_THROTTLED
timestamptimestampstable
Display name: 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
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Values

event.kind MUST be one of the following:

ValueDescription
WORKFLOW_EVENTEvent in context of a workflow

event.provider MUST be one of the following:

ValueDescription
AUTOMATION_ENGINEEvent produced by AutomationEngine

event.type MUST be one of the following:

ValueDescription
WORKFLOW_CREATEDWorkflow created event
WORKFLOW_UPDATEDWorkflow updated event
WORKFLOW_DELETEDWorkflow permanently deleted event
WORKFLOW_TRASHEDWorkflow moved to trash event

AutomationEngine workflow throttle event

Model describing an AutomationEngine workflow throttle event. Workflow throttle events are stored in the dt.system.events table.

Query

AutomationEngine workflow throttle events.

fetch dt.system.events
| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="WORKFLOW_THROTTLED"

AutomationEngine workflow throttle event fields

AttributeTypeDescriptionExamples
dt.automation_engine.throttle.limitlongexperimental
Display name: Workflow execution throttle limit
The workflow execution per hour limit that has been reached.
1000
dt.automation_engine.workflow.idstringexperimental
Display name: Workflow ID
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141
dt.automation_engine.workflow.titlestringexperimental
Display name: Workflow title
The title of the workflow.
My Workflow
end_timetimestampstable
Display name: End time
End time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time.
1649822520123123165
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
WORKFLOW_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
AUTOMATION_ENGINE
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
WORKFLOW_THROTTLED
timestamptimestampstable
Display name: 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

Values

event.kind MUST be one of the following:

ValueDescription
WORKFLOW_EVENTEvent in context of a workflow

event.provider MUST be one of the following:

ValueDescription
AUTOMATION_ENGINEEvent produced by AutomationEngine

event.type MUST be one of the following:

ValueDescription
WORKFLOW_THROTTLEDWorkflow throttled event

Browser Monitor or Clickpath billing usage

Model describing a billing usage event for "Browser Monitor or Clickpath". Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Browser Monitor or Clickpath" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Browser Monitor or Clickpath"
| dedup event.id

Browser Monitor or Clickpath billing usage fields

AttributeTypeDescriptionExamples
billed_synthetic_action_countlongexperimental
The number of synthetic actions which trigger a web request that includes a page load, navigation event, or action that triggers an XHR or Fetch request. Scroll downs, keystrokes, or clicks that don't trigger web requests aren't counted as such actions. This is the billable unit related to the rate card of this capability.
10
dt.entity.synthetic_teststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.browser_monitor instead.
Display name: Synthetic test
An entity ID of an entity of type SYNTHETIC_TEST.
Tags: entity-id
SYNTHETIC_TEST-A140F3B85BCCBD1A
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.browser_monitorsmartscapeIdresource stable
Display name: Browser monitor ID
Smartscape ID referencing a browser monitor entity.
Tags: smartscape-id
BROWSER_MONITOR-A140F3B85BCCBD1A
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Browser Monitor or Clickpath
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Browser Monitor or ClickpathBrowser Monitor or Clickpath

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Classic Feature Tracking event

Classic Feature Tracking events capture usage and compatibility of Dynatrace Classic features across your environment. They help administrators understand which classic features are actively used and which items are compatible with Latest Dynatrace.

Two types of events are defined:

  • CLASSIC_USAGE—records an individual use of a classic feature, such as opening an app or calling a classic API endpoint.
  • COMPATIBILITY—a pass/fail compatibility check for a specific item against Latest Dynatrace requirements.

Events do not include personal data or detailed payload content. Only data necessary for usage analysis or compatibility review is reported.

Query

Retrieve all Classic Feature Tracking events.

fetch dt.system.events
| filter event.kind == "CLASSIC_TRACKING_EVENT"

Count classic feature usage events per feature area.

fetch dt.system.events
| filter event.kind == "CLASSIC_TRACKING_EVENT"
| filter event.type == "CLASSIC_USAGE"
| summarize usages=count(), by: { classic.feature }
| sort usages desc

List all items requiring attention, with their reasons and guidance links.

fetch dt.system.events
| filter event.kind == "CLASSIC_TRACKING_EVENT"
| filter event.type == "COMPATIBILITY"
| filter classic.is_ready == false
| fields classic.feature, classic.object_id, classic.object_name, classic.reason, classic.action.url

Classic Tracking event fields

Classic Feature Tracking event attributes

AttributeTypeDescriptionExamples
audit.identitystringstable
Display name: Audit identity
Present for CLASSIC_USAGE events. The anonymized identifier of the user or API token that triggered the usage. Must not include personal data beyond a pseudonymous identifier.
b5998ff1-26fd-4aec-80c4-6c59633b5d66; dt0c01.EXAMPLE
classic.action.urlstringexperimental
Present for COMPATIBILITY events. Optional link to documentation or guidance for resolving the issue described in classic.reason.
https://docs.dynatrace.com/docs/oneagent/upgrade; https://dt.com/hub/extensions/upgrade
classic.contextstringexperimental
Present for CLASSIC_USAGE events. Optional additional detail such as a query string or user agent. Must not include personal data or sensitive payload content.
Mozilla/5.0 (compatible; DynatraceBot)
classic.featurestringexperimental
The classic feature or capability that was used or configured. Identifies the product area, for example "Dashboards Classic", "Management Zone", "Extension v2", or "OneAgent".
Dashboards Classic; Management Zone; Extension v2; OneAgent
classic.is_readybooleanexperimental
Present for COMPATIBILITY events. true if the item is compatible with Latest Dynatrace; false if action is required.
true; false
classic.object_idstringexperimental
For CLASSIC_USAGE events: the specific object that was accessed, such as a dashboard ID or API endpoint path. For COMPATIBILITY events: the identifier of the item being assessed, such as an extension ID, host ID, or integration name.
57f8bbf5-f05a-435c-b77c-1003c6b9ddd9; /api/v2/entities; host-1a2b3c4d; my-extension-v2
classic.object_namestringexperimental
Present for COMPATIBILITY events. Optional human-readable name of the item identified by classic.object_id.
Frontend Team MZ; My Auto-tag Rule
classic.reasonstringexperimental
Present for COMPATIBILITY events when classic.is_ready is false. Explains why the item requires attention.
OneAgent version 1.325 below required 1.331; Extension major version too low; Unsupported configuration type
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
CLASSIC_TRACKING_EVENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
CLASSIC_USAGE; COMPATIBILITY
timestamptimestampstable
Display name: 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

Code Monitoring billing usage

Model describing a billing usage event of Code Monitoring. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the Code Monitoring capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Code Monitoring"
| dedup event.id

Code Monitoring billing usage fields

AttributeTypeDescriptionExamples
application_only_typestringexperimental
Identifier of the app-only containerization type.
unknown; kubernetes; azure; gcp; aws; cloudfoundry
aws.account.idstringresource stable
Display name: AWS account ID
The 12-digit number, such as 123456789012, that uniquely identifies an AWS account.
Tags: permission primary-field
123456789012
azure.subscriptionstringresource stable
Display name: Azure subscription
An Azure subscription is a logical container used to provision resources in Azure.
Tags: permission primary-field
27e9b03f-04d2-2b69-b327-32f433f7ed21
billed_container_hoursdoubleexperimental
The number of code monitoring container hours consumed by the host.
0.25; 0.5; 1.0
cloudfoundry.application.idstringresource experimental
Display name: Cloud Foundry application ID
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Code Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
gcp.project.idstringresource stable
Display name: GCP project ID
Identifier of the GCP project associated with this resource.
Tags: permission primary-field
dynatrace-gcp-extension
k8s.cluster.uidstringresource stable
Display name: Kubernetes cluster UID
A pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
k8s.namespace.namestringresource stable
Display name: Kubernetes namespace name
The name of the namespace that the pod is running in.
Tags: permission primary-field
default; kube-system
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Code MonitoringCode Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Data Egress billing usage

Model describing a billing usage event for data egress. Billing usage events are stored in the dt.system.events table.

Query

Retrieves billing usage events related to the "Data Egress" capability and returns only unique events by removing duplicates based on event.id.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Data Egress"
| dedup event.id

Charts how Data Egress usage evolves by summing billed bytes and grouping the usage by forwarding data type.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Data Egress"
| makeTimeseries usage_bytes = sum(billed_bytes), by:{dt.openpipeline.forwarding.datatype}

Calculates the total Data Egress usage by summing billed bytes and grouping the result by forwarding configuration.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Data Egress"
| summarize total_usage_bytes = sum(billed_bytes), by:{dt.openpipeline.forwarding.config_id}

Data Egress billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.openpipeline.forwarding.config_idstringresource experimental
Display name: OpenPipeline forwarding config ID
ID of the forwarding configuration in OpenPipeline.
v00zu89AAABADJidWlsdGluOmh5cGVyc2NhbGVyLWF1dGhlbnRpY2F0aW9uLmNvpb25zLmF3cwAGdGVuYW50AGZ7ZW5hbnQAJDNlOTM1YmE3LTkzODUtMzczZS1hMWJiLW9uioQwNDFmNzIyMb7vVN4V2t6t
dt.openpipeline.forwarding.datatypestringresource experimental
Display name: OpenPipeline forwarding datatype
Forwarded datatype
Logs
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Data Egress
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2025-01-01T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLIMA Usage Tracker Service

event.type MUST be one of the following:

ValueDescription
Data EgressData Egress

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Data deletion events

Dynatrace stores a data deletion event for each segment that got rewritten in the dt.system.events table.

Query

Analyze data deletion events.

fetch dt.system.events
| filter event.kind == "DATA_DELETION_EVENT"

Data deletion event fields

AttributeTypeDescriptionExamples
bucketstringexperimental
A Dynatrace Grail bucket name.
default_logs; default_events
client.api_versionstringstable
The REST API version used by the client to perform the request.
1
deletion_endlongexperimental
End of a particular deletion.
1649822520123123123
deletion_idstringexperimental
Internal deletion request UUID.
c454347c-0ba9-4bd3-870e-d06dc1657f71
deletion_startlongexperimental
Start of a particular deletion.
1649822520123123123
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
environmentstringexperimental
A Dynatrace environment/tenant ID.
umsaywsjuo
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
DATA_DELETION_EVENT
failure_reasonstringexperimental
Additional information if query execution has 'FAILED'.
QUEUE_TIMEOUT; THROTTLED
query_stringstringexperimental
The query string.
fetch bizevents, from:-30m | limit 1
rewritten_byteslongexperimental
The number of rewritten bytes in the context of record deletion.
1113359256
statusstringexperimental
The outcome of the query.
SUCCEEDED
task.idstringexperimental
Deletion task UUID returned by API.
b5998ff1-26fd-4aec-80c4-6c59633b5d66
timestamptimestampstable
Display name: 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
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system
versionstringresource deprecatedUsed in Extension Framework 2.0
Display name: SNMP version
The SNMP version.
SNMPv3

Database Monitoring billing usage

Model describing a billing usage event for the Database Monitoring capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the Database Monitoring capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Database Monitoring"
| dedup event.id

Summarize total database instance hours per monitored database instance.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Database Monitoring"
| dedup event.id
| summarize total_instance_hours = sum(`database-instance-hours`), by: { dt.smartscape_source.id, dt.smartscape_source.type }
| sort total_instance_hours desc

Show top monitored database instances by unique query count.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Database Monitoring"
| dedup event.id
| summarize total_queries = sum(database_queries), by: { dt.smartscape_source.id, dt.smartscape_source.type }
| sort total_queries desc

Database Monitoring billing usage fields

AttributeTypeDescriptionExamples
database-instance-hoursdoubleexperimental
Database instance hours consumed during the usage window. Each 1,000 unique queries count as 0.25 hours, with a minimum of 0.25 hours per window.
0.25; 0.5; 1.0
database_querieslongexperimental
Count of unique database queries executed during the 15-minute usage window.
500; 1001; 5000
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape_source.idsmartscapeIdresource stable
Display name: Smartscape source ID
The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the Smartscape storage. 1
Tags: smartscape-id
DB_INSTANCE_POSTGRES-0000000000000001
dt.smartscape_source.typestringstable
Display name: Smartscape source type
The entity type of the entity whose identifier is held in dt.smartscape_source.id.
DB_INSTANCE_POSTGRES
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Database Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
1

The value of this field will be based on the value of one of the dt.smartscape.<type> fields. That means that the dt.smartscape_source.id and dt.smartscape.<type> fields will both be set to the same ID.

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLima Usage Tracker

event.type MUST be one of the following:

ValueDescription
Database MonitoringDatabase Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Digital Experience Monitoring - Query billing usage

Model describing a billing usage event of a Digital Experience Monitoring query execution. Billing usage events are stored in the dt.system.events table.

Query

Retrieves billing usage events related to the Digital Experience Monitoring - Query capability and returns only unique events by removing duplicates based on event.id.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Query"
| dedup event.id

Charts how Digital Experience Monitoring - Query usage evolves by summing billed bytes and grouping the result by usage.bucket.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Query"
| dedup event.id
| makeTimeseries usage_bytes = sum(billed_bytes), by:{usage.bucket}

Calculates the total Digital Experience Monitoring - Query usage by summing billed bytes and grouping the result by usage.bucket.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Query"
| dedup event.id
| summarize total_usage_bytes = sum(billed_bytes), by:{usage.bucket}

Digital Experience Monitoring - Query billing usage fields

AttributeTypeDescriptionExamples
action_typestringstable
Indicates if the query was executed to fetch records or to delete them.
QUERY; DELETION
billed_byteslongstable
The number of bytes that will be billed.
1113359256
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.client_contextstringstable
Contains all available client.context information. For example, a combination of <app>:<function> or structured JSON.
dynatrace.automations:execute-dql-query; {"dt.task.id": "<task-id>", "dt.task.group": "builtin:davis.anomaly-detectors", "dt.analyzer.query_type": "DEFAULT", "dt.analyzer.execution_id": "<execution-id>"}
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
client.workflow_contextstringstable
Contains information about the invoked workflow. For example, the workflow.id.
8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.billing.categorystringstable
Display name for usage details.
User events; User sessions; Synthetic events; Synthetic user events; Synthetic user sessions
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Digital Experience Monitoring - Query
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
query_idstringstable
The UUID identifying a particular query.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_startlongstable
Query start time.
1683012271413
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_synthetic_events; default_bm_synthetic_events; default_hm_synthetic_events; default_synthetic_detailed_events; default_synthetic_user_events; default_synthetic_user_sessions
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLIMA Usage Tracker Service

event.type MUST be one of the following:

ValueDescription
Digital Experience Monitoring - QueryDigital Experience Monitoring Query Execution

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Digital Experience Monitoring - Retain billing usage

Model describing the billing usage event for retention of DEM events per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Retrieves billing usage events related to the Digital Experience Monitoring - Retain capability and returns only unique events by removing duplicates based on event.id.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Retain"
| dedup event.id

Charts how Digital Experience Monitoring - Retain usage evolves by summing billed bytes and grouping the result by usage.bucket.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Retain"
| dedup event.id
| makeTimeseries usage_bytes = sum(billed_bytes), by:{usage.bucket}

Calculates the total Digital Experience Monitoring - Retain usage by summing billed bytes and grouping the result by usage.bucket.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT"
| filter event.type == "Digital Experience Monitoring - Retain"
| dedup event.id
| summarize total_usage_bytes = sum(billed_bytes), by:{usage.bucket}

Digital Experience Monitoring - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.billing.categorystringstable
Display name for usage details.
User events; User sessions; Synthetic events; Synthetic user events; Synthetic user sessions
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Digital Experience Monitoring - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_synthetic_detailed_events; default_bm_synthetic_events; default_synthetic_user_sessions; default_synthetic_user_events; default_user_events; default_user_sessions

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Digital Experience Monitoring - RetainDigital Experience Monitoring - Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Dynatrace self-monitoring event

Events that are generated by Dynatrace components with self-monitoring information (health, status, unexpected situations)

Dynatrace self-monitoring event fields

AttributeTypeDescriptionExamples
contentstringexperimental
Unstructured content of the record. It should contain a human-readable message. Often it is the raw version of a record read from a source.
No keepalive from datasource statsd. Restarting
dt.active_gate.group.namestringresource experimental
Display name: ActiveGate group name
The name of a group that the ActiveGate instance belongs to.
GdanskLab
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.event.keystringexperimental
Preregistered event key for self-monitoring events whitelisting.
extension.status; extension.engine.eec_status
dt.extension.config.idstringresource experimental
Display name: Extension configuration ID
Extension's monitoring configuration identifier.
vu9U3hXa3q0AAAABAAtleHQ6ZXh0LTA0MAAIYWdfZ3JvdXAAA0FHMQAkMjY2YTIyM2YtZDgxYi0zNTNjLThlYzctYzk2YzliZjg4OGQ3vu9U3hXa3q0
dt.extension.dsstringresource experimental
Display name: Extension data source
Name of the data source.
SNMPTrap
dt.extension.namestringresource experimental
Display name: Extension name
Name of the extension.
com.snmptrap.generic
dt.extension.statusstringresource experimental
Display name: Extension status
The status of the component reporting a self-monitoring event.
AUTHENTICATION_ERROR
dt.source_entitystringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape_source.id instead.
Display name: Source entity
The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the classic entity storage. 1
Tags: entity-id
HOST-E0D8F94D9065F24F; PROCESS_GROUP_INSTANCE-E0D8F94D9065F24F
log.sourcestringstable
Display name: Log source
Human-readable attribute that identifies a log stream. 2
Tags: permission
dsfm; isfm
timestamptimestampstable
Display name: 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
1

The value of this field will be based on the value of one of the dt.entity.<type> fields. This means that the dt.source_entity and dt.entity.<type> fields will both be set to the same ID.

2

Can contain, for example, a file path, standard output, or an URI etc., depending on the log stream type. The value should be stable for one logical source (for example, not affected by log file rotation digits).

Events - Ingest & Process billing usage

Model describing a billing usage event of ingest for events. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Events - Ingest & Process" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Events - Ingest & Process"
| dedup event.id

Events - Ingest & Process billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.billing.categorystringstable
Display name for usage details.
Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Events - Ingest & Process
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_davis_custom_events
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Events - Ingest & ProcessEvents - Ingest & Process

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Events - Query billing usage

Model describing a billing usage event of a events query execution. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Events - Query"

Events - Query billing usage fields

AttributeTypeDescriptionExamples
action_typestringstable
Indicates if the query was executed to fetch records or to delete them.
QUERY; DELETION
billed_byteslongstable
The number of bytes that will be billed.
1113359256
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.client_contextstringstable
Contains all available client.context information. For example, a combination of <app>:<function> or structured JSON.
dynatrace.automations:execute-dql-query; {"dt.task.id": "<task-id>", "dt.task.group": "builtin:davis.anomaly-detectors", "dt.analyzer.query_type": "DEFAULT", "dt.analyzer.execution_id": "<execution-id>"}
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
client.workflow_contextstringstable
Contains information about the invoked workflow. For example, the workflow.id.
8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.billing.categorystringstable
Display name for usage details.
Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Events - Query
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
query_idstringstable
The UUID identifying a particular query.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_startlongstable
Query start time.
1683012271413
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_bizevents; default_davis_custom_events
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLIMA Usage Tracker Service

event.type MUST be one of the following:

ValueDescription
Events - QueryEvents Query Execution

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Events - Retain billing usage

Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Events - Retain"

Events - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.billing.categorystringstable
Display name for usage details.
Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Event - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_bizevents; default_davis_custom_events

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Events - RetainEvents Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Files - Ingest & Process billing usage

Model describing a billing usage event of ingest for files. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Files - Ingest & Process" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Ingest & Process"
| dedup event.id

View total billed bytes for the "Files - Ingest & Process" capability, broken down by product.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Ingest & Process"
| summarize sum(billed_bytes), by: dt.cost.product

View total billed bytes for the "Files - Ingest & Process" capability, broken down by cost center.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Ingest & Process"
| summarize sum(billed_bytes), by: dt.cost.costcenter

Files - Ingest & Process billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Files - Ingest & Process
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Files - Ingest & ProcessFiles - Ingest & Process

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Files - Query billing usage

Model describing a billing usage event of a files query execution. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Query"

Files - Query billing usage fields

AttributeTypeDescriptionExamples
action_typestringstable
Indicates if the query was executed to fetch records or to delete them.
QUERY; DELETION
billed_byteslongstable
The number of bytes that will be billed.
1113359256
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.client_contextstringstable
Contains all available client.context information. For example, a combination of <app>:<function> or structured JSON.
dynatrace.automations:execute-dql-query; {"dt.task.id": "<task-id>", "dt.task.group": "builtin:davis.anomaly-detectors", "dt.analyzer.query_type": "DEFAULT", "dt.analyzer.execution_id": "<execution-id>"}
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
client.workflow_contextstringstable
Contains information about the invoked workflow. For example, the workflow.id.
8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Files - Query
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
query_idstringstable
The UUID identifying a particular query.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_startlongstable
Query start time.
1683012271413
timestamptimestampstable
Display name: 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
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Files - Retain billing usage

Model describing the billing usage event for the retention of files. Billing usage events are stored in the dt.system.events table.

Query

Fetch Files - Retain billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Retain"
| dedup event.id

Files - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterrecord[]resource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
[{'key': 'my-cost-center', 'billed_bytes': '1048576'}]
dt.cost.productrecord[]resource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
[{'key': 'my-product', 'billed_bytes': '1048576'}]
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Files - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
file.categorystringstable
Contains the value of the File Category.
Custom files
timestamptimestampstable
Display name: 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

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Files - RetainFiles Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Foundation & Discovery billing usage

Model describing a billing usage event for the Foundation & Discovery DPS capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage for Foundation & Discovery on 15-minute billing intervals.

Note that complete usage for events is displayed only for Dynatrace versions 1.312+. Earlier versions will display partial usage.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Foundation & Discovery"
| dedup event.id

Foundation & Discovery billing usage fields

AttributeTypeDescriptionExamples
billed_host_hoursdoublestable
How many host hours of the capability have been consumed by the host.
2.0
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Foundation & Discovery
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Foundation & DiscoveryFoundation & Discovery

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Full-Stack Monitoring billing usage

Model describing a billing usage event for the Full-Stack Monitoring DPS capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage for Full-Stack Monitoring on 15-minute billing intervals.

Note that complete usage for events is displayed only for Dynatrace versions 1.312+. Earlier versions will display partial usage.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Full-Stack Monitoring"
| dedup event.id

Full-Stack Monitoring billing usage fields

AttributeTypeDescriptionExamples
billed_gibibyte_hoursdoublestable
How many gibibyte hours of the capability has been consumed by the host
16.02
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Full-Stack Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Full-Stack MonitoringFull-Stack Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

GenAI event

GenAI events are emitted when a GenAI skill is invoked or feedback is provided. They provide tracking data for skill usage and user feedback. Examples:

  • What skills were used
  • Was positive or negative feedback provided
  • How long did the skill execution take
  • …

Query

Retrieve all GenAI events.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"

Count of GenAI skill invocations.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "GenAI Skill Invocation"
| summarize count()

Count the GenAI invocations per skill.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "GenAI Skill Invocation"
| summarize invocations=count(), by: skill

Count of the GenAI feedback type per skill.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "GenAI Feedback"
| summarize count(), by: {feedback.type, skill}

Time series of the GenAI execution duration per skill.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "GenAI Skill Invocation"
| makeTimeseries avg(execution_duration_ms), by: {skill}

Count of MCP initializations.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "MCP Init"
| summarize count()

Count the MCP initializations per client.application_context.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "MCP Init"
| summarize invocations=count(), by: client.application_context

Count of MCP Tool Invocations.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "MCP Tool Invocation"
| summarize count()

Count the MCP Tool Invocations per tool.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "MCP Tool Invocation"
| summarize invocations=count(), by: tool

Count the MCP Tool Invocations for every call of Dynatrace Assist.

fetch dt.system.events
| filter event.kind == "GENAI_EVENT"
| filter event.type == "GenAI Skill Invocation"
| filter skill == "operator"
| fields timestamp, user_input, response, session_id
| join [
fetch dt.system.events
| filter event.type == "MCP Tool Invocation"
], on: {session_id}
| summarize timestamp=takeFirst(timestamp), user_input=takeFirst(user_input), response=takeFirst(response), tool_call_count = count(), by: {session_id}

GenAI event fields

AttributeTypeDescriptionExamples
caller.typestringexperimental
The type of caller that invoked the GenAI skill.
INTERNAL; MCP; API
client.application_contextstringstable
A Dynatrace app ID.
dynatrace.davis.copilot
client.originating_application_contextstringexperimental
Name of the originating application if the conversation started from another app.
dynatrace.davis.problems
conversation_idstringexperimental
A UUID identifying a conversation across multiple messages.
55239b04-8f8d-4e26-88fa-f75357a626a2
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
GENAI_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
DAVIS_COPILOT; MCP_GATEWAY
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
GenAI Skill Invocation; GenAI Feedback; MCP Init; MCP Tool Invocation
execution_duration_mslongdeprecated
The duration of the query in milliseconds.
42
failure_messagestringexperimental
Detailed error message or justification for failure, intended for end users.
Prompt blocked by guardrail.
failure_reasonstringexperimental
Additional information if query execution has 'FAILED'.
BAD_REQUEST_ERROR; CONTENT_FILTER; GUARDRAIL_CHECK_FAILED; SENSITIVE_DATA_DETECTED; INVALID_DQL_GENERATED
feedback.categorystringexperimental
Category of feedback, selected by the user.
error; incomplete; incorrect; misunderstood; other
feedback.textstringexperimental
Unmasked free-text feedback provided by the user.
The answer was not correct.
feedback.typestringexperimental
Type of feedback provided by the user, such as positive or negative.
positive; negative
mcp_client.namestringexperimental
An MCP Client name
Visual Studio Code
mcp_client.versionstringexperimental
An MCP Client version
1.103.1
responsestringexperimental
The response was generated by the skill.
Here are today's errors...
serverstringexperimental
The name of the MCP server that was invoked.
dynatrace-mcp
session_idstringexperimental
UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection.
cf45e99d-43c2-466f-a455-ab37cf942a54
skillstringexperimental
The name of the skill that was executed.
nl2dql; chat; dql2nl; document-search
statusstringexperimental
The outcome of the query.
SUCCEEDED; FAILED; BLOCKED
supplementarystringexperimental
Additional context information was provided for the skill (chat only).
Error details: ...
timestamptimestampstable
Display name: 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
toolstringexperimental
The name of the MCP server tool or AI function tool that was invoked.
nl2dql; dynatrace-conversation; dql2nl; execute-dql
topicstringexperimental
General topic addressed by the user input (for chat events only).
Root cause analysis of Davis problem
user.emailstringstable
Display name: User email
Email of the user.
john.doe@dynatrace.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
b5998ff1-26fd-4aec-80c4-6c59633b5d66
user_inputstringexperimental
The user input was provided for the skill.
Show me errors for today
workflow.execution.idstringstable
The unique identifier of a workflow execution as UUID.
d3ddbb4f-f6cb-4286-be5a-e3a8bca53825
workflow.idstringstable
The unique identifier of a workflow as UUID.
26c0334e-a3e1-4585-8cd8-2d72742fe141

Values

event.type MUST be one of the following:

ValueDescription
GenAi Skill InvocationGenAI skill was invoked.
GenAi Skill FeedbackFeedback for a GenAI skill was provided.

skill MAY be one of the following:

ValueDescription
chatEvents associated with the conversations skill also used in the Davis CoPilot Chat App.
nl2dqlEvents associated with the skill translating natural language into DQL queries.
dql2nlEvents associated with the skill explaining DQL queries in natural text.

status MUST be one of the following:

ValueDescription
SUCCEEDEDSkill invocation succeeded.
FAILEDSkill invocation failed.
BLOCKEDSkill invocation was blocked by guardrail or content filter.

failure_reason MAY be one of the following:

ValueDescription
BAD_REQUEST_ERRORThere was a technical problem.
CONTENT_FILTERContent filter check failed.
GUARDRAIL_CHECK_FAILEDGuardrail check failed.
INVALID_DQL_GENERATEDGenerated DQL was invalid.

feedback.type MUST be one of the following:

ValueDescription
positivePositive feedback.
negativeNegative feedback.

feedback.category MAY be one of the following:

ValueDescription
errorThe execution of the skill did not work.
incompleteThe response was incomplete.
incorrectThe response was incorrect.
misunderstoodThe response misunderstood the question.
otherNo provided feedback category fits.

HTTP Monitor billing usage per HTTP Monitor

Model describing a billing usage event for HTTP Monitor. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "HTTP Monitor" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "HTTP Monitor"
| dedup event.id

HTTP Monitor billing usage per HTTP Monitor fields

AttributeTypeDescriptionExamples
billed_http_request_countlongexperimental
The number of HTTP requests performed. This is the billable unit related to the rate card of this capability.
10
dt.entity.http_checkstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.http_monitor instead.
Display name: HTTP check
An entity ID of an entity of type HTTP_CHECK.
Tags: entity-id
HTTP_CHECK-A140F3B85BCCBD1A
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.http_monitorsmartscapeIdresource stable
Display name: HTTP monitor ID
Smartscape ID referencing an HTTP monitor entity.
Tags: smartscape-id
HTTP_MONITOR-A140F3B85BCCBD1A
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
HTTP Monitor
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
HTTP MonitorHTTP Monitor

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Infrastructure Monitoring billing usage

Model describing a billing usage event for the Infrastructure Monitoring DPS capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage for Infrastructure Monitoring on 15-minute billing intervals.

Note that complete usage for events is displayed only for Dynatrace versions 1.312+. Earlier versions will display partial usage.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Infrastructure Monitoring"
| dedup event.id

Infrastructure Monitoring billing usage fields

AttributeTypeDescriptionExamples
billed_host_hoursdoublestable
How many host hours of the capability have been consumed by the host.
2.0
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Infrastructure Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Infrastructure MonitoringInfrastructure Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Kubernetes Platform Monitoring Billing Usage

Model describing a billing usage event for Kubernetes Platform Monitoring. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Kubernetes Platform Monitoring" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Kubernetes Platform Monitoring"
| dedup event.id

Kubernetes Platform Monitoring Billing Usage fields

AttributeTypeDescriptionExamples
billed_pod_hoursdoublestable
The number of pod-hours billed per namespace in a Kubernetes cluster
8.25
dt.entity.cloud_application_namespacestringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_namespace instead.
Display name: Cloud application namespace
An entity ID of an entity of type CLOUD_APPLICATION_NAMESPACE. A CLOUD_APPLICATION_NAMESPACE is a Kubernetes namespace.
Tags: entity-id
CLOUD_APPLICATION_NAMESPACE-C61324AA70F57BCB
dt.entity.kubernetes_clusterstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead.
Display name: Kubernetes cluster
An entity ID of an entity of type KUBERNETES_CLUSTER.
Tags: entity-id
KUBERNETES_CLUSTER-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.k8s_clustersmartscapeIdresource stable
Display name: Kubernetes cluster ID
A Smartscape ID that can be used to query Kubernetes cluster entities from the Smartscape storage.
Tags: smartscape-id
K8S_CLUSTER-0123456789ABCDEF
dt.smartscape.k8s_namespacesmartscapeIdresource stable
Display name: Kubernetes namespace ID
Smartscape ID referencing a Kubernetes namespace.
Tags: smartscape-id
K8S_NAMESPACE-AABBCCDDEEFF0011
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Kubernetes Platform Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Kubernetes Platform MonitoringKubernetes Platform Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Log Management & Analytics - Ingest & Process billing usage

Model describing a billing usage event for ingest and process of logs. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Log Management & Analytics - Ingest & Process" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Log Management & Analytics - Ingest & Process"
| dedup event.id

Log Management & Analytics - Ingest & Process billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.job.idstringexperimental
Display name: Job ID
Unique identifier of the external log data import job that produced this billing usage event. 1
752942ae-f994-4589-b949-b5ad15290a43
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Log Management & Analytics - Ingest & Process
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_logs
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
1

Only present if logs were imported using an import job.

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Log Management & Analytics - Ingest & ProcessLog Management & Analytics - Ingest & Process

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Log Management & Analytics - Query billing usage

Model describing a billing usage event of a logs query execution. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Log Management & Analytics - Query"

Log Management & Analytics - Query billing usage fields

AttributeTypeDescriptionExamples
action_typestringstable
Indicates if the query was executed to fetch records or to delete them.
QUERY; DELETION
billed_byteslongstable
The number of bytes that will be billed.
1113359256
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.client_contextstringstable
Contains all available client.context information. For example, a combination of <app>:<function> or structured JSON.
dynatrace.automations:execute-dql-query; {"dt.task.id": "<task-id>", "dt.task.group": "builtin:davis.anomaly-detectors", "dt.analyzer.query_type": "DEFAULT", "dt.analyzer.execution_id": "<execution-id>"}
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
client.workflow_contextstringstable
Contains information about the invoked workflow. For example, the workflow.id.
8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Log Management & Analytics - Query
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
query_idstringstable
The UUID identifying a particular query.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_startlongstable
Query start time.
1683012271413
timestamptimestampstable
Display name: 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
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLIMA Usage Tracker Service

event.type MUST be one of the following:

ValueDescription
Log Management & Analytics - QueryLogs Query Execution

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Log Management & Analytics - Retain billing usage

Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Fetch Log Management & Analytics - Retain billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Log Management & Analytics - Retain"

Log Management & Analytics - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterrecord[]resource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
[{'key': 'costcenter-1', 'billed_bytes': '123'}, {'key': 'costcenter-2', 'billed_bytes': '456'}, {'key': 'unassigned', 'billed_bytes': '789'}]
dt.cost.productrecord[]resource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
[{'key': 'product-1', 'billed_bytes': '123'}, {'key': 'product-2', 'billed_bytes': '456'}, {'key': 'unassigned', 'billed_bytes': '789'}]
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Log Management & Analytics - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage log bucket name.
default_logs

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Log Management & Analytics - RetainLogs Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Log Management & Analytics - Retain with Included Queries billing usage

Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Fetch Log Management & Analytics - Retain with Included Queries usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Log Management & Analytics - Retain with Included Queries"

Log Management & Analytics - Retain with Included Queries billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.cost.costcenterrecord[]resource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
[{'key': 'costcenter-1', 'billed_bytes': '123'}, {'key': 'costcenter-2', 'billed_bytes': '456'}, {'key': 'unassigned', 'billed_bytes': '789'}]
dt.cost.productrecord[]resource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
[{'key': 'product-1', 'billed_bytes': '123'}, {'key': 'product-2', 'billed_bytes': '456'}, {'key': 'unassigned', 'billed_bytes': '789'}]
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074qi_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Log Management & Analytics - Retain with Included Queries
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage log bucket name.
default_logs

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Log Management and Analytics - Retain with Included QueriesRetain with Included Queries

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Mainframe Monitoring billing usage

Model describing a billing usage event for Mainframe Monitoring. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Mainframe Monitoring" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Mainframe Monitoring"
| dedup event.id

Mainframe Monitoring billing usage fields

AttributeTypeDescriptionExamples
billed_msu_hoursdoublestable
The number of msu-hours billed for the mainframe host.
8.25
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Mainframe Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Mainframe MonitoringMainframe Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Metrics - Ingest & Process billing usage

Model describing a billing usage event of ingest & process for metrics. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Metrics - Ingest & Process"

Metrics - Ingest & Process billing usage fields

AttributeTypeDescriptionExamples
data_pointslongstable
The number of billable metrics data points.
1500
dt.cost.costcenterrecord[]resource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
[{'key': 'costcenter-1', 'data_points': '250'}, {'key': 'costcenter-2', 'data_points': '500'}, {'key': 'unassigned', 'data_points': '750'}]
dt.cost.productrecord[]resource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
[{'key': 'product-1', 'data_points': '500'}, {'key': 'product-2', 'data_points': '500'}, {'key': 'unassigned', 'data_points': '500'}]
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Metrics - Ingest & Process
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
metric.typestringstable
Display name: Metric type
Identifies the type of metric and therefore the timeseries rollup functions it supports.
summary_stats
monitoring_sourcestringstable
Monitoring source that originally reported the data. See 'dt.system.monitoring_source'.
fullstack_host
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage metrics bucket name.
default_metrics
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Metrics - Ingest & ProcessMetrics - Ingest & Process

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Metrics - Retain billing usage

Model describing the billing usage event for retention of metrics per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Fetch Metrics Retain billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Metrics - Retain"

Metrics - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Metrics - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage metric bucket name.
default_metrics

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Metrics - RetainMetrics Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Query execution events

Dynatrace stores a query execution event for each query that got executed in the dt.system.events table.

Query

Analyze query execution events.

fetch dt.system.events
| filter event.kind == "QUERY_EXECUTION_EVENT"

The amount of succeeded queries.

fetch dt.system.events
| filter event.kind == "QUERY_EXECUTION_EVENT"
| filter status == "SUCCEEDED"
| summarize countDistinct(query_id)

The amount of failed queries.

fetch dt.system.events
| filter event.kind == "QUERY_EXECUTION_EVENT"
| summarize sum(failed_count)

Analyze query execution events for federated analytics (external datastore) queries.

fetch dt.system.events
| filter event.kind == "QUERY_EXECUTION_EVENT" and event.type == "DATASTORE"

Query execution event fields

AttributeTypeDescriptionExamples
analysis_timeframe.endtimestampexperimental
End time of query analysis timeframe.
2023-05-22T13:15:57.416654000
analysis_timeframe.starttimestampexperimental
Start time of query analysis timeframe.
2023-05-22T11:15:57.416654000
bucketstringexperimental
A Dynatrace Grail bucket name.
default_logs; default_events
client.api_versionstringstable
The REST API version used by the client to perform the request.
1
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
datastorestringexperimental
Name of the external datastore that was scanned.
s3-datastore
delivered_recordslongexperimental
The number of records returned by the query. Might differ from actual number of records delivered to the client due to the additional response size limits (max result bytes, max result records, etc.).
1000
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
environmentstringexperimental
A Dynatrace environment/tenant ID.
umsaywsjuo
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
QUERY_EXECUTION_EVENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
DATASTORE; TABLE; FILES
execution_duration_mslongdeprecated
The duration of the query in milliseconds.
123
failed_countlongexperimental
Number of failed queries represented by the record. failed_count > 1 represents cases like 'failure_reason=THROTTLED' with individual queries aggregated into a single record.
1; 321
failure_reasonstringexperimental
Additional information if query execution has 'FAILED'.
QUEUE_TIMEOUT; THROTTLED
flagsstring[]experimental
Advisory flags attached to the query result by the query execution engine.
['CLASSIC_ENTITY_MIGRATION_ADVISED']
listed_objectslongexperimental
Number of objects returned by the external datastore's list API.
98
matched_records_ratiodoubleexperimental
The ratio of records that matched the query filter conditions out of the total number of scanned records. A value of 1.0 means all scanned records matched; 0.0 means none matched.
0.42
query_endlongstable
Query end time. For aggregated events the query end time may be zero and not reflect the exact end time.
1683012271413
query_idstringstable
The UUID identifying a particular query. For aggregated events this field is null.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_poolstringexperimental
The resource pool of the query.
DASHBOARDS
query_queue_time_mslongdeprecated
The time query spent in queued state (in milliseconds).
456
query_startlongstable
Query start time. For failed queries the start time may be aggregated and not reflect the exact start time but rather the aggregation time.
1683012271413
query_stringstringexperimental
The query string. For aggregated events this field is null.
fetch bizevents, from:-30m | limit 1
sampling_ratiolongexperimental
The sampling ratio of the executed query.
1
scanned_byteslongexperimental
The number of scanned bytes.
1113359256
scanned_data_pointslongexperimental
Number of scanned data points for metric queries.
20
scanned_objectslongexperimental
Number of objects actually retrieved/scanned in the external datastore.
50
scanned_recordslongexperimental
The number of scanned records.
9209037
statusstringexperimental
The outcome of the query.
SUCCEEDED
tablestringexperimental
A Dynatrace Grail table name.
logs; metrics
timestamptimestampstable
Display name: 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
userstringexperimental
The user ID that triggered the query. For aggregated events this field is null.
b5998ff1-26fd-4aec-80c4-6c59633b5d66
user.emailstringstable
Display name: User email
The user email that triggered the query. For aggregated events this field is null.
john.doe@dynatrace.com
user.idstringstable
Display name: User ID
The user UUID that triggered the query. For aggregated events this field is null.
b5998ff1-26fd-4aec-80c4-6c59633b5d66
versionstringresource deprecatedUsed in Extension Framework 2.0
Display name: SNMP version
The record version
1

Values

failure_reason MUST be one of the following:

ValueDescription
QUEUE_TIMEOUTQuery timed out before execution due to resource or tenant quota limit.
THROTTLEDQuery was rejected due to too many queries waiting in the queue. Reported either as records with full details or as aggregated batches with limited metadata.
INVALID_QUERYQuery cannot be parsed due to a syntax error.
PARSING_LIMITQuery cannot be parsed because it exceeds the complexity limit of the parser.
PARSING_FAILEDQuery cannot be parsed due to an internal error.
EXECUTION_FAILEDExecution of the submitted query failed because of internal an error.
INSUFFICIENT_PERMISSIONSQuery cannot be executed because the requester doesn't have permissions to a queried table.
EXECUTION_TIMEOUTQuery execution was canceled because it exceeded the allowed running time.
MEMORY_LIMITQuery execution was canceled because the memory usage limit was exceeded.
DISK_LIMITQuery execution was canceled because the disk space limit was exceeded.
FUNCTION_LIMITQuery execution was canceled because the user-defined functions limit was exceeded.
RECORD_SIZE_LIMITQuery execution was canceled because the record size limit was exceeded.
TABLE_SIZE_LIMITQuery execution was canceled because the table size limit was exceeded.
FAILIF_CONDITIONQuery execution was canceled because the condition of a failIf command was met.

Real User Monitoring Property billing usage by application

Model describing a billing usage event for Real User Monitoring Property. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Real User Monitoring Property" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Real User Monitoring Property"
| dedup event.id

Real User Monitoring Property billing usage by application fields

AttributeTypeDescriptionExamples
billed_property_sessionslongexperimental
User action and session properties counted by application.
8
device.typestringresource stable
The type of the device.
mobile
dt.entity.applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Application
The ME ID of a web application.
Tags: entity-id
APPLICATION-DC92E74A7A844E6E
dt.entity.device_applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Device application
The ME ID of a device application.
DEVICE_APPLICATION-EA8A8751A60D5BCE8
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Real User Monitoring Property
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Real User Monitoring PropertyReal User Monitoring Property

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Real User Monitoring billing usage by application

Model describing a billing usage event for Real User Monitoring. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Real User Monitoring" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Real User Monitoring"
| dedup event.id

Real User Monitoring billing usage by application fields

AttributeTypeDescriptionExamples
billed_sessionslongexperimental
Session count without Session Replay counted by application.
8
device.typestringresource stable
The type of the device.
mobile
dt.entity.applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Application
The ME ID of a web application.
Tags: entity-id
APPLICATION-DC92E74A7A844E6E
dt.entity.device_applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Device application
The ME ID of a device application.
DEVICE_APPLICATION-EA8A8751A60D5BCE8
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Real User Monitoring
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Real User MonitoringReal User Monitoring

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Real User Monitoring with Session Replay billing usage by application

Model describing a billing usage event for Real User Monitoring with Session Replay. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Real User Monitoring with Session Replay" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Real User Monitoring with Session Replay"
| dedup event.id

Real User Monitoring with Session Replay billing usage by application fields

AttributeTypeDescriptionExamples
billed_replay_sessionslongexperimental
Session count with Session Replay counted by application.
8
device.typestringresource stable
The type of the device.
mobile
dt.entity.applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Application
The ME ID of a web application.
Tags: entity-id
APPLICATION-DC92E74A7A844E6E
dt.entity.device_applicationstringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.
Display name: Device application
The ME ID of a device application.
DEVICE_APPLICATION-EA8A8751A60D5BCE8
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Real User Monitoring with Session Replay
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Real User Monitoring with Session ReplayReal User Monitoring with Session Replay

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Runtime Application Protection billing usage

Model describing a billing usage event for the Runtime Application Protection DPS capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage for Runtime Application Protection on 15-minute billing intervals.

Note that complete usage for events is displayed only for Dynatrace versions 1.312+. Earlier versions will display partial usage.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Runtime Application Protection"
| dedup event.id

Runtime Application Protection billing usage fields

AttributeTypeDescriptionExamples
billed_gibibyte_hoursdoublestable
How many gibibyte hours of the capability has been consumed by the host
16.02
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Runtime Application Protection
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Runtime Application ProtectionRuntime Application Protection

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Runtime Vulnerability Analytics billing usage

Model describing a billing usage event for the Runtime Vulnerability Analytics DPS capability. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage for Runtime Vulnerability Analytics on 15-minute billing intervals.

Note that complete usage for events is displayed only for Dynatrace versions 1.312+. Earlier versions will display partial usage.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Runtime Vulnerability Analytics"
| dedup event.id

Runtime Vulnerability Analytics billing usage fields

AttributeTypeDescriptionExamples
billed_gibibyte_hoursdoublestable
How many gibibyte hours of the capability has been consumed by the host
16.02
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.entity.hoststringresource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.
Display name: Host
An entity ID of an entity of type HOST.
Tags: entity-id
HOST-E0D8F94D9065F24F
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.hostsmartscapeIdresource stable
Display name: Host ID
Smartscape ID referencing a host entity.
Tags: smartscape-id
HOST-A1B2C3D4E5F67890
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Runtime Vulnerability Analytics
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
timestamptimestampstable
Display name: 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
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Runtime Vulnerability ProtectionRuntime Vulnerability Protection

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Security Posture Management billing usage

Model describing a billing usage event for Security Posture Management. Billing usage events are stored in the dt.system.events table.

Query

Analyze usage events for the "Security Posture Management" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Security Posture Management"
| dedup event.id

Analyze Security Posture Management billing usage events for a specific Kubernetes cluster.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Security Posture Management"
| filter k8s.cluster.name == "my-cluster"
| dedup event.id

Analyze Security Posture Management billing usage in the last 24 hours grouped by Smartscape source entity to identify which entities drive the most usage.

fetch dt.system.events, from:now()-24h
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Security Posture Management"
| dedup event.id
| summarize billed_host_hours = count(), by: {dt.smartscape_source.id, dt.smartscape_source.type, k8s.cluster.name}
| sort billed_host_hours desc

Security Posture Management billing usage fields

AttributeTypeDescriptionExamples
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
dt.smartscape.k8s_clustersmartscapeIdresource stable
Display name: Kubernetes cluster ID
A Smartscape ID that can be used to query Kubernetes cluster entities from the Smartscape storage.
Tags: smartscape-id
K8S_CLUSTER-0123456789ABCDEF
dt.smartscape_source.idsmartscapeIdresource stable
Display name: Smartscape source ID
The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the Smartscape storage. 1
Tags: smartscape-id
K8S_CLUSTER-E0D8F94D9065F24F; AWS_LAMBDA_FUNCTION-E0D8F94D9065F24F
dt.smartscape_source.typestringstable
Display name: Smartscape source type
The entity type of the entity whose identifier is held in dt.smartscape_source.id.
K8S_CLUSTER; AWS_LAMBDA_FUNCTION
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Security Posture Management
event.versionstringstable
Display name: Event version
Describes the version of the event.
2.0.0
k8s.cluster.namestringresource stable
Display name: Kubernetes cluster name
The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable.
Tags: permission primary-field
unguard-dev; acme-prod10
timestamptimestampstable
Display name: 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
1

The value of this field will be based on the value of one of the dt.smartscape.<type> fields. That means that the dt.smartscape_source.id and dt.smartscape.<type> fields will both be set to the same ID.

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Security Posture ManagementSecurity Posture Management

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Third-Party Synthetic API Ingestion billing usage per external browser monitor

Model describing a billing usage event for Third-Party Synthetic API Ingestion. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Third-Party Synthetic API Ingestion" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Third-Party Synthetic API Ingestion"
| dedup event.id

Third-Party Synthetic API Ingestion billing usage per external browser monitor fields

AttributeTypeDescriptionExamples
billed_test_result_ingestion_countlongexperimental
The number of synthetic test results pushed into Dynatrace with Synthetic 3rd party API. This is the billable unit related to the rate card of this capability.
10
dt.entity.external_synthetic_teststringresource deprecatedThis field is deprecated and will be removed in the future.
Display name: External synthetic test
An entity ID of an entity of type EXTERNAL_SYNTHETIC_TEST.
Tags: entity-id
EXTERNAL_SYNTHETIC_TEST-A140F3B85BCCBD1A
dt.openpipeline.pipelinesstring[]resource experimental
Display name: OpenPipeline pipelines
Collects the identifiers of all pipelines through which a record has passed during the ingestion process in OpenPipeline, providing a complete trace of its journey.
['logs:default']; ['logs:pipeline_haproxy_2656', 'bizevents:default']
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Third-Party Synthetic API Ingestion
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Third-Party Synthetic API IngestionThird-Party Synthetic API Ingestion

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Traces - Ingest & Process billing usage

Model describing a billing usage event for ingest and process of traces. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events for the "Traces - Ingest & Process" capability.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Traces - Ingest & Process"
| dedup event.id

Traces - Ingest & Process billing usage fields

AttributeTypeDescriptionExamples
dt.cost.costcenterstringresource stable
Display name: Cost center
Can be used to assign usage to a Cost Center.
Team A
dt.cost.productstringresource stable
Display name: Cost product
Can be used to assign usage to a Product or Application ID.
Product A
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_CLIENT
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Traces - Ingest & Process
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
ingested_byteslongexperimental
The size in bytes of ingested spans.
1113359256
ingested_spanslongexperimental
The number of ingested spans.
1113359256
licensing_typestringexperimental
The origin/type of the ingested spans.
fullstack-adaptive
timestamptimestampstable
Display name: Timestamp
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z
usage.bucketstringstable
A Dynatrace Grail usage event bucket name.
default_metrics
usage.endtimestampstable
End time of the usage timeframe (exclusive).
2023-05-22T11:30:00.000000Z
usage.starttimestampstable
Start time of the usage timeframe (inclusive).
2023-05-22T11:15:00.000000Z

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_CLIENTLIMA Client Service

event.type MUST be one of the following:

ValueDescription
Traces - Ingest & ProcessTraces - Ingest & Process

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

licensing_type MUST be one of the following:

ValueDescription
fullstack-adaptiveThe ingested_bytes origins from an ATM aware fullstack source.
fullstack-fixed-rateThe ingested_bytes origins from an ATM unaware fullstack source.
otlp-trace-ingestThe ingested_bytes origins from the "OTLP Trace Ingest API".
serverlessThe ingested_bytes origins from a serverless source.

Traces - Query billing usage

Model describing a billing usage event of a traces query execution. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Traces - Query"

Traces - Query billing usage fields

AttributeTypeDescriptionExamples
action_typestringstable
Indicates if the query was executed to fetch records or to delete them.
QUERY; DELETION
billed_byteslongstable
The number of bytes that will be billed.
1113359256
client.application_contextstringstable
A Dynatrace app ID.
local-dev-mode; dynatrace.notebooks; my.biz.carbon
client.client_contextstringstable
Contains all available client.context information. For example, a combination of <app>:<function> or structured JSON.
dynatrace.automations:execute-dql-query; {"dt.task.id": "<task-id>", "dt.task.group": "builtin:davis.anomaly-detectors", "dt.analyzer.query_type": "DEFAULT", "dt.analyzer.execution_id": "<execution-id>"}
client.function_contextstringstable
Name of the function that executed the query.
api/execute-dql-query; my/function
client.internal_service_contextstringexperimental
A string that identifies the Dynatrace service that triggered the query.
dt.davis.datadriver
client.sourcestringstable
Dynatrace application that executed the query.
https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09
client.workflow_contextstringstable
Contains information about the invoked workflow. For example, the workflow.id.
8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_TRACKER
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Traces - Query
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
query_idstringstable
The UUID identifying a particular query.
e68e5cc8-c31e-4e57-90d7-c6dde20b19d5
query_startlongstable
Query start time.
1683012271413
timestamptimestampstable
Display name: 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
user.emailstringstable
Display name: User email
Email of the user.
user@mail.com
user.idstringstable
Display name: User ID
Unique UUID of a human user. If the system itself has to be represented, the constant 'system' is used.
35ba9499-f87c-4047-962c-14dc32e255e5; system

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_TRACKERLIMA Usage Tracker Service

event.type MUST be one of the following:

ValueDescription
Traces - QueryTraces Query Execution

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

Traces - Retain billing usage

Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.

Query

Analyze billing usage events.

fetch dt.system.events
| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Traces - Retain"

Traces - Retain billing usage fields

AttributeTypeDescriptionExamples
billed_byteslongstable
The number of bytes that will be billed.
1113359256
dt.openpipeline.sourcestringresource experimental
Display name: OpenPipeline ingest source
Identifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline.
/platform/ingest/v1/events; oneagent
dt.security_contextstringresource stable
Display name: DT security context
The security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model
Tags: permission
BILLING_USAGE_EVENT
event.idstringstable
Display name: Event ID
Unique identifier string of an event; is stable across multiple refreshes and updates.
5547782627070661074_1647601320000
event.kindstringstable
Display name: Event kind
Gives 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.
Tags: permission
BILLING_USAGE_EVENT
event.providerstringstable
Display name: Event provider
Source of the event, for example, the name of the component or system that generated the event.
Tags: permission
LIMA_USAGE_STREAM
event.typestringstable
Display name: Event type
The unique type identifier of a given event.
Tags: permission
Traces - Retain
event.versionstringstable
Display name: Event version
Describes the version of the event.
1.0.0
timestamptimestampstable
Display name: 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
usage.bucketstringstable
A Dynatrace Grail usage span bucket name.
default_spans

Values

event.kind MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event

event.provider MUST be one of the following:

ValueDescription
LIMA_USAGE_STREAMLIMA Usage Stream Service

event.type MUST be one of the following:

ValueDescription
Traces - RetainTraces Retain

dt.security_context MUST be one of the following:

ValueDescription
BILLING_USAGE_EVENTBilling usage event