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 system events.
fetch dt.system.events
Model describing a billing usage event for AI Function Standard Calls. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_invocations | long | stable Number of billed invocations. Unit is 1/4 GiB * min | 8 |
caller.app.id | string | stable The entity/app invoking the function or not set when not invoked by an app. | dynatrace.hub |
caller.service.id | string | stable The service invoking the function or not set when not invoked by a service. | DI_ENGINE |
caller.type | string | experimental The type of caller that invoked the GenAI skill. | API; MCP; INTERNAL |
conversation_id | string | experimental A UUID identifying a conversation across multiple messages. | 55239b04-8f8d-4e26-88fa-f75357a626a2 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | AI Function Standard Call |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
session_id | string | experimental UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection. | cf45e99d-43c2-466f-a455-ab37cf942a54 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
tool | string | experimental The name of the MCP server tool or AI function tool that was invoked. | execute-dql |
tool.category | string | experimental The category of the invoked tool. | standard |
user.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique 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.id | string | stable The unique identifier of a workflow execution as UUID. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
workflow.id | string | stable The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
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.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
caller.app.id | string | stable The entity/app invoking the function or not set when not invoked by an app. | dynatrace.hub |
caller.service.id | string | stable The service invoking the function or not set when not invoked by a service. | DI_ENGINE |
caller.type | string | experimental The type of caller that invoked the GenAI skill. | API; MCP; INTERNAL |
conversation_id | string | experimental A UUID identifying a conversation across multiple messages. | 55239b04-8f8d-4e26-88fa-f75357a626a2 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | AI Units |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
session_id | string | experimental UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection. | cf45e99d-43c2-466f-a455-ab37cf942a54 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
tool | string | experimental The name of the MCP server tool or AI function tool that was invoked. | create-dql |
tool.category | string | experimental The category of the invoked tool. | ai |
usage.quantity.billable | double | experimental 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.unit | string | experimental Billing unit for an AI unit charge. | Units |
user.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique 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.id | string | stable The unique identifier of a workflow execution as UUID. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
workflow.id | string | stable The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
Analyzer execution events track all executions of analyzers.
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}
| Attribute | Type | Description | Examples |
|---|---|---|---|
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.function_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
dt.analyzer.analysis_timeframe.end | timestamp | experimental 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.start | timestamp | experimental 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_messages | string[] | experimental Errors that occurred during analysis. | ['"Maximum number of concurrent queries per tenant reached."'] |
dt.analyzer.execution.end | timestamp | experimental Time (UNIX Epoch time in nanoseconds) when the analyzer execution stopped. | 2025-08-01T11:55:01.000000000+02:00 |
dt.analyzer.execution.start | timestamp | experimental Time (UNIX Epoch time in nanoseconds) when the analyzer execution started. | 2025-08-01T11:55:00.000000000+02:00 |
dt.analyzer.name | string | experimental Name of the executed analyzer. | dt.statistics.anomaly_detection.StaticThresholdAnomalyDetectionAnalyzer |
dt.analyzer.result_records | long | experimental Number of output records from analysis. | 0; 42; 100000 |
dt.analyzer.result_status | string | experimental Indicates whether the analyzer was successfully executed. | SUCCESSFUL; SUCCESSFUL_WITH_WARNINGS; FAILED |
dt.analyzer.warning_messages | string[] | experimental Warnings that occurred during analysis. | ['"Your result has been limited because the maximum bytes (100000000) were reached."'] |
dt.task.failure_reason | string | experimental Explains why dt.task.result_status is FAILED. | Analyzer execution failed |
dt.task.group | string | experimental Group of the executed task. Tasks that share the same group usually share the same source. | builtin:davis.anomaly-detectors |
dt.task.id | string | experimental Identifier of the executed task. | vu9U3hXa3q0AAAABAB9idWlsdGluOmRhdmlzLmFub21hbHktZGV0ZWN0b3JzAAZ0ZW5hbnQABnRlbmFudAAkOWMxODdhMzYtYTJhNC0zZDY3LThiMGEtNTYwOTljYjM4Yzg4vu9U3hXa3q0 |
dt.task.name | string | experimental Name of the executed task. | Response time degradation alert |
dt.task.result_status | string | experimental 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_expression | string | experimental Expression that defines the concrete task schedule. The expression syntax depends on the selected dt.task.scheduling_type. | PT1M; PT10M |
dt.task.scheduling_type | string | experimental Scheduling method used for the task. | FIXED_DELAY; FIXED_RATE |
event.kind | string | stable Display name: Event kindGives 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 |
timestamp | timestamp | stable Display name: TimestampThe 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.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
The Anomaly Detector status events are used for Davis anomaly detection. They track errors and warnings during the execution of an anomaly detector. Examples:
Analyze anomaly detectors status events.
fetch dt.system.events| filter event.kind == "ANOMALY_DETECTOR_STATUS_EVENT"
| Attribute | Type | Description | Examples |
|---|---|---|---|
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
davis.anomaly_detector.message | string | experimental Additional details about the anomaly detector status | Maximum number of concurrent queries per tenant reached. |
davis.anomaly_detector.status | string | experimental Severity of an anomaly detector status | ERROR; WARNING |
dt.settings.object_id | string | experimental Display name: Settings object IDThe object ID of a settings value. This corresponds to the 'objectId' field/parameter in the Settings API. | vu9U3hXa3q0AAAABACFidWlsdGluOnJ1bS51c2VyLWV4cGVyaWVuY2Utc2NvcmUABnRlbmFudAAGdGVuYW50ACRhMzZmYmYwMy00NDY1LTNlNTYtOTZiOS1kOWMzOGQ3MzU1NmO-71TeFdrerQ |
event.kind | string | stable Display name: Event kindGives 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 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
Model describing a billing usage event of function invocations. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_invocations | long | stable Number of billed invocations. Unit is 1/4 GiB * min | 8 |
caller.app.id | string | stable The entity/app invoking the function or not set when not invoked by an app. | dynatrace.hub |
caller.service.id | string | stable The service invoking the function or not set when not invoked by a service. | AUTOMATION_ENGINE |
dt.app.id | string | resource stable Display name: Dynatrace app IDThe unique application identifier. Dynatrace apps are prefixed with 'dynatrace.', custom apps are prefixed with 'my.'. | dynatrace.notebooks; my.awesome.app |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | AppEngine Functions - Small |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
function.duration_sec | long | stable 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_id | string | stable 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.id | string | stable 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_mib | long | stable 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.type | string | stable The identifier defining the function type. | STANDARD; ACTION; AD_HOC |
timestamp | timestamp | stable Display name: TimestampThe 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique 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.id | string | stable The unique identifier of a workflow execution as UUID. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
workflow.id | string | stable The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
AppEngine Functions - Small | AppEngine Functions - Small |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
function.type MUST be one of the following:
| Value | Description |
|---|---|
AD_HOC | Adhoc function execution |
STANDARD | App function execution |
ACTION | App function execution, but function is defined as an Action in the app manifest |
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.
Analyze audit events stored in the system event bucket.
fetch dt.system.events| filter event.kind == "AUDIT_EVENT"
| Attribute | Type | Description | Examples |
|---|---|---|---|
authentication.client.id | string | experimental Display name: Authentication client IDThe OAuth2 client id if of type 'CLIENT_CREDENTIALS'. | dt0s02.UZCK6ENL.2YQ2A3DZUEISRJSUU5544J3SC3TMPXSEEMNA5HK7RW54SJ6XKLYGMWJNKL7B2DNH |
authentication.grant.type | string | experimental Display name: Authentication grant typeThe grant type used during OAuth2 authentication. | AUTHORIZATION_CODE; CLIENT_CREDENTIALS |
authentication.token | string | experimental Display name: Authentication tokenThe public token identifier of authentication.type 'TOKEN'. | dt0c01.AM4SEYKIBROBEJ2N3HAXZ4IX |
authentication.type | string | experimental Display name: Authentication typeThe method of authentication. | OAUTH2 |
dt.app.function | string | resource 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.id | string | resource stable Display name: Dynatrace app IDThe 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_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.outcome | string | stable Display name: Event outcomeDenotes 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | API_GATEWAY |
event.reason | string | stable Display name: Event reasonDescribes 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.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | POST; PUT; GET |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
origin.address | string | experimental Display name: Origin addressSource 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.session | string | experimental Display name: Origin sessionThe ID of the browser session (if present) associated with the event. | node0hfznc |
origin.type | string | experimental Display name: Origin typeOrigin type of the request associated with this event. | REST; LOCAL |
origin.x_forwarded_for | string | experimental Display name: Origin x-forwarded-forThe verbatim value of the X-Forwarded-For HTTP request header (if present) of the request associated with the event. | 1.2.3.4 |
request.source | string | stable In case of a REST call audit event, this field contains the request source. | BROWSER; DT_SERVERLESS; OTHER |
resource | string | stable Generic reference to a resource like a REST resource URL or a settings ID. | /service/resource; 1234567890 |
timestamp | timestamp | stable Display name: TimestampThe 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.id | string | stable Display name: User IDUnique 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.name | string | experimental Display name: User namein the context of audit events, the name of the user is always the email address of the user. | albert.einstein@patent.office |
user.organization | string | experimental Display name: User organizationOrganization the user belongs to. | DYNATRACE; CUSTOMER; PARTNER |
Model describing a billing usage event of automation workflows. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events for AutomationEngine workflows.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Automation Workflow"
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.end | string | stable Display name: Event endThe event end timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). | 16481073970000 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.start | string | stable Display name: Event startThe event start timestamp in UTC (given in Grail preferred Linux timestamp nano precision format). | 16481073970000 |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Automation Workflow |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.actor | string | stable The entity executing the workflow as UUID. | b22a50a0-2540-4f29-9452-bc330322fb1e |
workflow.created_at | timestamp | stable The time when the workflow was created. | 1649822520123123123 |
workflow.description | string | stable The description of the workflow. | This is a test workflow |
workflow.id | string | stable The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
workflow.is_private | string | stable The boolean identifier denoting the visibility of the workflow. | true; false |
workflow.owner | string | stable The entity owning the workflow as UUID. | f1358516-8136-4634-9012-d2e3dfee38dc |
workflow.title | string | stable The title of the workflow. | Test Workflow |
workflow.trigger_type | string | stable The identifier that describes the trigger of the workflow. | schedule; manual |
workflow.updated_by | string | stable The entity updating the workflow last. | f1358516-8136-4634-9012-d2e3dfee38dc |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Automation Workflow | Automation Workflow |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing an AutomationEngine action execution event. Action execution events are stored in the dt.system.events table.
AutomationEngine action execution state change.
fetch dt.system.events| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="ACTION_EXECUTION"
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.automation_engine.action.app | string | experimental Display name: Action appThe app ID of the app containing the executed action. | dynatrace.automations |
dt.automation_engine.action.function | string | experimental Display name: Action function nameName of the function implementing the action. | task_1 |
dt.automation_engine.action_execution.id | string | experimental Display name: Action execution IDThe unique identifier of a action execution as UUID. | 23e7b55a-884f-4497-8ad6-8d49d52b4348 |
dt.automation_engine.action_execution.loop.index | long | experimental Display name: Action execution loop indexLoop index of the action execution. | |
dt.automation_engine.action_execution.retry.count | long | experimental Display name: Action execution retry countRetry count of the action execution. | |
dt.automation_engine.is_draft | boolean | experimental Display name: Workflow is draftIndicates whether the triggered workflow execution is based on a workflow draft. | true; false |
dt.automation_engine.is_task_test | boolean | experimental Display name: Is task testIndicates 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.id | string | experimental Display name: Root workflow IDThe unique identifier of the root workflow. | e6388e3a-9db2-4226-9327-2ba86eaf12f7 |
dt.automation_engine.root_workflow_execution.id | string | experimental Display name: Root workflow execution IDThe unique identifier of the execution of the root workflow. 1 | a641fb59-4627-44cd-abaf-b68d86455a5b |
dt.automation_engine.state | string | experimental Display name: Execution stateThe state of an execution. Values depend on type of execution (workflow-, task-, or action execution). | RUNNING; SUCCESS; ERROR |
dt.automation_engine.state.is_final | boolean | experimental Display name: Execution state is finalIndicates if dt.automation_engine.state is a final and immutable state or if further processing will happen. | true; false |
dt.automation_engine.state_info | string | experimental Display name: Execution state infoAdditional info about current state of execution. Typically holds error details. | ERROR |
dt.automation_engine.task.name | string | experimental Display name: Task nameThe identifier of a task within a workflow. | task_1 |
dt.automation_engine.workflow.id | string | experimental Display name: Workflow IDThe unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.title | string | experimental Display name: Workflow titleThe title of the workflow. | My Workflow |
dt.automation_engine.workflow_execution.id | string | experimental Display name: Workflow execution IDThe unique identifier of a workflow execution as UUID. 2 | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
duration | duration | stable Display name: DurationThe difference between start_time and end_time in nanoseconds. | 42 |
end_time | timestamp | stable Display name: End timeEnd time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time. | 1649822520123123165 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | AUTOMATION_ENGINE |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | ACTION_EXECUTION |
start_time | timestamp | stable Display name: Start timeStart time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time. | 1649822520123123123 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
Absent for task test runs, which have no root workflow execution.
Absent for task test runs, which have no workflow execution.
event.kind MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EVENT | Event in context of a workflow |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
AUTOMATION_ENGINE | Event produced by AutomationEngine |
event.type MUST be one of the following:
| Value | Description |
|---|---|
ACTION_EXECUTION | Task execution state change event |
dt.automation_engine.state MUST be one of the following:
| Value | Description |
|---|---|
RUNNING | Action execution started. |
SUCCESS | Action execution finished successfully. |
ERROR | Action execution failed. |
Model describing an AutomationEngine task execution event. Task execution events are stored in the dt.system.events table.
AutomationEngine task execution state change.
fetch dt.system.events| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="TASK_EXECUTION"
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.automation_engine.is_draft | boolean | experimental Display name: Workflow is draftIndicates whether the triggered workflow execution is based on a workflow draft. | true; false |
dt.automation_engine.is_task_test | boolean | experimental Display name: Is task testIndicates 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.id | string | experimental Display name: Root workflow IDThe unique identifier of the root workflow. | e6388e3a-9db2-4226-9327-2ba86eaf12f7 |
dt.automation_engine.root_workflow_execution.id | string | experimental Display name: Root workflow execution IDThe unique identifier of the execution of the root workflow. 1 | a641fb59-4627-44cd-abaf-b68d86455a5b |
dt.automation_engine.state | string | experimental Display name: Execution stateThe state of an execution. Values depend on type of execution (workflow-, task-, or action execution). | RUNNING; SUCCESS; ERROR |
dt.automation_engine.state.is_final | boolean | experimental Display name: Execution state is finalIndicates if dt.automation_engine.state is a final and immutable state or if further processing will happen. | true; false |
dt.automation_engine.state_info | string | experimental Display name: Execution state infoAdditional info about current state of execution. Typically holds error details. | ERROR |
dt.automation_engine.task.name | string | experimental Display name: Task nameThe identifier of a task within a workflow. | task_1 |
dt.automation_engine.test_task_execution.actor | string | experimental Display name: Task test actorThe unique identifier of the actor the task test ran as. | e622afae-ccc7-4fb5-acc5-13b32e827bbe |
dt.automation_engine.test_task_execution.trigger.user.id | string | experimental Display name: Task test trigger user IDThe unique identifier of the user who triggered the task test. | dad18fa7-3c11-40a1-b760-1d8281bb5dcc |
dt.automation_engine.workflow.id | string | experimental Display name: Workflow IDThe unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.title | string | experimental Display name: Workflow titleThe title of the workflow. | My Workflow |
dt.automation_engine.workflow_execution.id | string | experimental Display name: Workflow execution IDThe unique identifier of a workflow execution as UUID. 2 | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
duration | duration | stable Display name: DurationThe difference between start_time and end_time in nanoseconds. | 42 |
end_time | timestamp | stable Display name: End timeEnd time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time. | 1649822520123123165 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | AUTOMATION_ENGINE |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | TASK_EXECUTION |
start_time | timestamp | stable Display name: Start timeStart time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time. | 1649822520123123123 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
Absent for task test runs, which have no root workflow execution.
Absent for task test runs, which have no workflow execution.
event.kind MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EVENT | Event in context of a workflow |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
AUTOMATION_ENGINE | Event produced by AutomationEngine |
event.type MUST be one of the following:
| Value | Description |
|---|---|
TASK_EXECUTION | Task execution state change event |
dt.automation_engine.state MUST be one of the following:
| Value | Description |
|---|---|
SKIPPED | Task skipped due to task conditions evaluation or task is disabled. |
DISCARDED | Task discarded due to predecessor task conditions evaluation. |
WAITING | Task waiting due to e.g. task option configuration. |
RUNNING | Task execution has running action execution. |
SUCCESS | Task execution finished successfully. |
CANCELLED | Task execution cancelled manually/by API request. |
ERROR | Task execution finished due to at least one failed action execution and no retries configured/left to process. |
Model describing an AutomationEngine workflow execution event. Workflow execution events are stored in the dt.system.events table.
AutomationEngine workflow execution state change.
fetch dt.system.events| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="WORKFLOW_EXECUTION"
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.automation_engine.is_draft | boolean | experimental Display name: Workflow is draftIndicates whether the triggered workflow execution is based on a workflow draft. | true; false |
dt.automation_engine.root_workflow.id | string | experimental Display name: Root workflow IDThe unique identifier of the root workflow. | e6388e3a-9db2-4226-9327-2ba86eaf12f7 |
dt.automation_engine.root_workflow_execution.id | string | experimental Display name: Root workflow execution IDThe unique identifier of the execution of the root workflow. | a641fb59-4627-44cd-abaf-b68d86455a5b |
dt.automation_engine.state | string | experimental Display name: Execution stateThe state of an execution. Values depend on type of execution (workflow-, task-, or action execution). | RUNNING; SUCCESS; ERROR |
dt.automation_engine.state.is_final | boolean | experimental Display name: Execution state is finalIndicates if dt.automation_engine.state is a final and immutable state or if further processing will happen. | true; false |
dt.automation_engine.state_info | string | experimental Display name: Execution state infoAdditional info about current state of execution. Typically holds error details. | ERROR |
dt.automation_engine.workflow.id | string | experimental Display name: Workflow IDThe unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.last_execution_state_flip | boolean | experimental Display name: Workflow last execution state flipIndicates 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.title | string | experimental Display name: Workflow titleThe title of the workflow. | My Workflow |
dt.automation_engine.workflow.type | string | experimental Display name: Workflow typeWorkflow type, either SIMPLE or STANDARD, where SIMPLE comes with restrictions. | SIMPLE; STANDARD |
dt.automation_engine.workflow_execution.actor | string | experimental Display name: Workflow actorThe unique identifier of the actor as defined in the workflow. | e622afae-ccc7-4fb5-acc5-13b32e827bbe |
dt.automation_engine.workflow_execution.id | string | experimental Display name: Workflow execution IDThe unique identifier of a workflow execution as UUID. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
dt.automation_engine.workflow_execution.trigger.event.id | string | experimental Display name: Trigger event IDUnique 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.timestamp | timestamp | experimental Display name: Trigger event timestampThe timestamp of the event that triggered the workflow execution. | 1.72852206e18 |
dt.automation_engine.workflow_execution.trigger.type | string | experimental Display name: Workflow trigger typeThe identifier that describes the trigger of the workflow. | Schedule; Event; Workflow; Manual |
dt.automation_engine.workflow_execution.trigger.user.id | string | experimental Display name: Trigger user IDThe 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.id | string | experimental Display name: Trigger workflow execution IDThe unique identifier of the workflow that triggered the workflow execution. | 737a248b-d1cb-49a4-bf08-7d4c37dbfb1e |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
duration | duration | stable Display name: DurationThe difference between start_time and end_time in nanoseconds. | 42 |
end_time | timestamp | stable Display name: End timeEnd time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time. | 1649822520123123165 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | AUTOMATION_ENGINE |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | WORKFLOW_EXECUTION |
start_time | timestamp | stable Display name: Start timeStart time of a data point. Value is a UNIX Epoch time in nanoseconds and less than or equal to the end_time. | 1649822520123123123 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EVENT | Event in context of a workflow |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
AUTOMATION_ENGINE | Event produced by AutomationEngine |
event.type MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EXECUTION | Workflow execution state change event |
dt.automation_engine.state MUST be one of the following:
| Value | Description |
|---|---|
RUNNING | Workflow execution started. |
SUCCESS | Workflow execution finished successfully. |
ERROR | Workflow execution failed due to at least one branch with a failed task without an on error successor. |
CANCELLED | Workflow execution cancelled manually/by API request. |
Model describing an AutomationEngine workflow lifecycle event. Workflow lifecycle events are stored in the dt.system.events table.
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"))
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.automation_engine.workflow.id | string | experimental Display name: Workflow IDThe unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.title | string | experimental Display name: Workflow titleThe title of the workflow. | My Workflow |
dt.automation_engine.workflow.version | long | experimental Display name: Workflow versionThe version of the workflow. | 1; 42 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | AUTOMATION_ENGINE |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | WORKFLOW_CREATED; ACTION_EXECUTION; WORKFLOW_THROTTLED |
timestamp | timestamp | stable Display name: TimestampThe 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.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EVENT | Event in context of a workflow |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
AUTOMATION_ENGINE | Event produced by AutomationEngine |
event.type MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_CREATED | Workflow created event |
WORKFLOW_UPDATED | Workflow updated event |
WORKFLOW_DELETED | Workflow permanently deleted event |
WORKFLOW_TRASHED | Workflow moved to trash event |
Model describing an AutomationEngine workflow throttle event. Workflow throttle events are stored in the dt.system.events table.
AutomationEngine workflow throttle events.
fetch dt.system.events| filter event.kind == "WORKFLOW_EVENT" and event.provider == "AUTOMATION_ENGINE" and event.type =="WORKFLOW_THROTTLED"
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.automation_engine.throttle.limit | long | experimental Display name: Workflow execution throttle limitThe workflow execution per hour limit that has been reached. | 1000 |
dt.automation_engine.workflow.id | string | experimental Display name: Workflow IDThe unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
dt.automation_engine.workflow.title | string | experimental Display name: Workflow titleThe title of the workflow. | My Workflow |
end_time | timestamp | stable Display name: End timeEnd time of a data point. Value is a UNIX Epoch time in nanoseconds and greater than or equal to the start_time. | 1649822520123123165 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | AUTOMATION_ENGINE |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | WORKFLOW_THROTTLED |
timestamp | timestamp | stable Display name: TimestampThe 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 |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_EVENT | Event in context of a workflow |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
AUTOMATION_ENGINE | Event produced by AutomationEngine |
event.type MUST be one of the following:
| Value | Description |
|---|---|
WORKFLOW_THROTTLED | Workflow throttled event |
Model describing a billing usage event for "Browser Monitor or Clickpath". Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_synthetic_action_count | long | experimental 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_test | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.browser_monitor instead.Display name: Synthetic testAn entity ID of an entity of type SYNTHETIC_TEST. Tags: entity-id | SYNTHETIC_TEST-A140F3B85BCCBD1A |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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_monitor | smartscapeId | resource stable Display name: Browser monitor IDSmartscape ID referencing a browser monitor entity. Tags: smartscape-id | BROWSER_MONITOR-A140F3B85BCCBD1A |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Browser Monitor or Clickpath |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Browser Monitor or Clickpath | Browser Monitor or Clickpath |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage 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:
Events do not include personal data or detailed payload content. Only data necessary for usage analysis or compatibility review is reported.
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 Feature Tracking event attributes
| Attribute | Type | Description | Examples |
|---|---|---|---|
audit.identity | string | stable Display name: Audit identityPresent 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.url | string | experimental 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.context | string | experimental 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.feature | string | experimental 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_ready | boolean | experimental Present for COMPATIBILITY events. true if the item is compatible with Latest Dynatrace; false if action is required. | true; false |
classic.object_id | string | experimental 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_name | string | experimental Present for COMPATIBILITY events. Optional human-readable name of the item identified by classic.object_id. | Frontend Team MZ; My Auto-tag Rule |
classic.reason | string | experimental 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.kind | string | stable Display name: Event kindGives 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.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | CLASSIC_USAGE; COMPATIBILITY |
timestamp | timestamp | stable Display name: TimestampThe 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 |
Model describing a billing usage event of Code Monitoring. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
application_only_type | string | experimental Identifier of the app-only containerization type. | unknown; kubernetes; azure; gcp; aws; cloudfoundry |
aws.account.id | string | resource stable Display name: AWS account IDThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: permission primary-field | 123456789012 |
azure.subscription | string | resource stable Display name: Azure subscriptionAn Azure subscription is a logical container used to provision resources in Azure. Tags: permission primary-field | 27e9b03f-04d2-2b69-b327-32f433f7ed21 |
billed_container_hours | double | experimental The number of code monitoring container hours consumed by the host. | 0.25; 0.5; 1.0 |
cloudfoundry.application.id | string | resource experimental Display name: Cloud Foundry application ID | |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Code Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
gcp.project.id | string | resource stable Display name: GCP project IDIdentifier of the GCP project associated with this resource. Tags: permission primary-field | dynatrace-gcp-extension |
k8s.cluster.uid | string | resource stable Display name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace. | 1c7a24c7-ff51-46e0-bcc9-c52637ceec57 |
k8s.namespace.name | string | resource stable Display name: Kubernetes namespace nameThe name of the namespace that the pod is running in. Tags: permission primary-field | default; kube-system |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Code Monitoring | Code Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for data egress. Billing usage events are stored in the dt.system.events table.
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}
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.openpipeline.forwarding.config_id | string | resource experimental Display name: OpenPipeline forwarding config IDID of the forwarding configuration in OpenPipeline. | v00zu89AAABADJidWlsdGluOmh5cGVyc2NhbGVyLWF1dGhlbnRpY2F0aW9uLmNvpb25zLmF3cwAGdGVuYW50AGZ7ZW5hbnQAJDNlOTM1YmE3LTkzODUtMzczZS1hMWJiLW9uioQwNDFmNzIyMb7vVN4V2t6t |
dt.openpipeline.forwarding.datatype | string | resource experimental Display name: OpenPipeline forwarding datatypeForwarded datatype | Logs |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Data Egress |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2025-01-01T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | LIMA Usage Tracker Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Data Egress | Data Egress |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Dynatrace stores a data deletion event for each segment that got rewritten in the dt.system.events table.
Analyze data deletion events.
fetch dt.system.events| filter event.kind == "DATA_DELETION_EVENT"
| Attribute | Type | Description | Examples |
|---|---|---|---|
bucket | string | experimental A Dynatrace Grail bucket name. | default_logs; default_events |
client.api_version | string | stable The REST API version used by the client to perform the request. | 1 |
deletion_end | long | experimental End of a particular deletion. | 1649822520123123123 |
deletion_id | string | experimental Internal deletion request UUID. | c454347c-0ba9-4bd3-870e-d06dc1657f71 |
deletion_start | long | experimental Start of a particular deletion. | 1649822520123123123 |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | |
environment | string | experimental A Dynatrace environment/tenant ID. | umsaywsjuo |
event.kind | string | stable Display name: Event kindGives 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_reason | string | experimental Additional information if query execution has 'FAILED'. | QUEUE_TIMEOUT; THROTTLED |
query_string | string | experimental The query string. | fetch bizevents, from:-30m | limit 1 |
rewritten_bytes | long | experimental The number of rewritten bytes in the context of record deletion. | 1113359256 |
status | string | experimental The outcome of the query. | SUCCEEDED |
task.id | string | experimental Deletion task UUID returned by API. | b5998ff1-26fd-4aec-80c4-6c59633b5d66 |
timestamp | timestamp | stable Display name: TimestampThe 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
version | string | resource deprecatedUsed in Extension Framework 2.0 Display name: SNMP versionThe SNMP version. | SNMPv3 |
Model describing a billing usage event for the Database Monitoring capability. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
database-instance-hours | double | experimental 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_queries | long | experimental Count of unique database queries executed during the 15-minute usage window. | 500; 1001; 5000 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.id | smartscapeId | resource stable Display name: Smartscape source IDThe 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.type | string | stable Display name: Smartscape source typeThe entity type of the entity whose identifier is held in dt.smartscape_source.id. | DB_INSTANCE_POSTGRES |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Database Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
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.
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | Lima Usage Tracker |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Database Monitoring | Database Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of a Digital Experience Monitoring query execution. Billing usage events are stored in the dt.system.events table.
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}
| Attribute | Type | Description | Examples |
|---|---|---|---|
action_type | string | stable Indicates if the query was executed to fetch records or to delete them. | QUERY; DELETION |
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.client_context | string | stable 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_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
client.workflow_context | string | stable Contains information about the invoked workflow. For example, the workflow.id. | 8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.category | string | stable Display name for usage details. | User events; User sessions; Synthetic events; Synthetic user events; Synthetic user sessions |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Digital Experience Monitoring - Query |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
query_id | string | stable The UUID identifying a particular query. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_start | long | stable Query start time. | 1683012271413 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | LIMA Usage Tracker Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Digital Experience Monitoring - Query | Digital Experience Monitoring Query Execution |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
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.
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}
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.category | string | stable Display name for usage details. | User events; User sessions; Synthetic events; Synthetic user events; Synthetic user sessions |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Digital Experience Monitoring - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable 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 |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Digital Experience Monitoring - Retain | Digital Experience Monitoring - Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Events that are generated by Dynatrace components with self-monitoring information (health, status, unexpected situations)
| Attribute | Type | Description | Examples |
|---|---|---|---|
content | string | experimental 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.name | string | resource experimental Display name: ActiveGate group nameThe name of a group that the ActiveGate instance belongs to. | GdanskLab |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.event.key | string | experimental Preregistered event key for self-monitoring events whitelisting. | extension.status; extension.engine.eec_status |
dt.extension.config.id | string | resource experimental Display name: Extension configuration IDExtension's monitoring configuration identifier. | vu9U3hXa3q0AAAABAAtleHQ6ZXh0LTA0MAAIYWdfZ3JvdXAAA0FHMQAkMjY2YTIyM2YtZDgxYi0zNTNjLThlYzctYzk2YzliZjg4OGQ3vu9U3hXa3q0 |
dt.extension.ds | string | resource experimental Display name: Extension data sourceName of the data source. | SNMPTrap |
dt.extension.name | string | resource experimental Display name: Extension nameName of the extension. | com.snmptrap.generic |
dt.extension.status | string | resource experimental Display name: Extension statusThe status of the component reporting a self-monitoring event. | AUTHENTICATION_ERROR |
dt.source_entity | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape_source.id instead.Display name: Source entityThe 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.source | string | stable Display name: Log sourceHuman-readable attribute that identifies a log stream. 2 Tags: permission | dsfm; isfm |
timestamp | timestamp | stable Display name: TimestampThe 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 |
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.
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).
Model describing a billing usage event of ingest for events. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.category | string | stable Display name for usage details. | Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Events - Ingest & Process |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.bucket | string | stable A Dynatrace Grail usage event bucket name. | default_davis_custom_events |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Events - Ingest & Process | Events - Ingest & Process |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of a events query execution. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Events - Query"
| Attribute | Type | Description | Examples |
|---|---|---|---|
action_type | string | stable Indicates if the query was executed to fetch records or to delete them. | QUERY; DELETION |
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.client_context | string | stable 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_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
client.workflow_context | string | stable Contains information about the invoked workflow. For example, the workflow.id. | 8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.category | string | stable Display name for usage details. | Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Events - Query |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
query_id | string | stable The UUID identifying a particular query. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_start | long | stable Query start time. | 1683012271413 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage event bucket name. | default_bizevents; default_davis_custom_events |
user.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | LIMA Usage Tracker Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Events - Query | Events Query Execution |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Events - Retain"
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.category | string | stable Display name for usage details. | Business events; Custom Davis & Kubernetes events; Kubernetes warning events; Davis AI problems; Security events |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Event - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage event bucket name. | default_bizevents; default_davis_custom_events |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Events - Retain | Events Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of ingest for files. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Files - Ingest & Process |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Files - Ingest & Process | Files - Ingest & Process |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of a files query execution. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Query"
| Attribute | Type | Description | Examples |
|---|---|---|---|
action_type | string | stable Indicates if the query was executed to fetch records or to delete them. | QUERY; DELETION |
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.client_context | string | stable 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_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
client.workflow_context | string | stable Contains information about the invoked workflow. For example, the workflow.id. | 8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Files - Query |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
query_id | string | stable The UUID identifying a particular query. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_start | long | stable Query start time. | 1683012271413 |
timestamp | timestamp | stable Display name: TimestampThe 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
Model describing the billing usage event for the retention of files. Billing usage events are stored in the dt.system.events table.
Fetch Files - Retain billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Files - Retain"| dedup event.id
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | record[] | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | [{'key': 'my-cost-center', 'billed_bytes': '1048576'}] |
dt.cost.product | record[] | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | [{'key': 'my-product', 'billed_bytes': '1048576'}] |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Files - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
file.category | string | stable Contains the value of the File Category. | Custom files |
timestamp | timestamp | stable Display name: TimestampThe 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 |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Files - Retain | Files Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for the Foundation & Discovery DPS capability.
Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_host_hours | double | stable How many host hours of the capability have been consumed by the host. | 2.0 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Foundation & Discovery |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Foundation & Discovery | Foundation & Discovery |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for the Full-Stack Monitoring DPS capability.
Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_gibibyte_hours | double | stable How many gibibyte hours of the capability has been consumed by the host | 16.02 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Full-Stack Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Full-Stack Monitoring | Full-Stack Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage 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:
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}
| Attribute | Type | Description | Examples |
|---|---|---|---|
caller.type | string | experimental The type of caller that invoked the GenAI skill. | INTERNAL; MCP; API |
client.application_context | string | stable A Dynatrace app ID. | dynatrace.davis.copilot |
client.originating_application_context | string | experimental Name of the originating application if the conversation started from another app. | dynatrace.davis.problems |
conversation_id | string | experimental A UUID identifying a conversation across multiple messages. | 55239b04-8f8d-4e26-88fa-f75357a626a2 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | DAVIS_COPILOT; MCP_GATEWAY |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | GenAI Skill Invocation; GenAI Feedback; MCP Init; MCP Tool Invocation |
execution_duration_ms | long | deprecated The duration of the query in milliseconds. | 42 |
failure_message | string | experimental Detailed error message or justification for failure, intended for end users. | Prompt blocked by guardrail. |
failure_reason | string | experimental Additional information if query execution has 'FAILED'. | BAD_REQUEST_ERROR; CONTENT_FILTER; GUARDRAIL_CHECK_FAILED; SENSITIVE_DATA_DETECTED; INVALID_DQL_GENERATED |
feedback.category | string | experimental Category of feedback, selected by the user. | error; incomplete; incorrect; misunderstood; other |
feedback.text | string | experimental Unmasked free-text feedback provided by the user. | The answer was not correct. |
feedback.type | string | experimental Type of feedback provided by the user, such as positive or negative. | positive; negative |
mcp_client.name | string | experimental An MCP Client name | Visual Studio Code |
mcp_client.version | string | experimental An MCP Client version | 1.103.1 |
response | string | experimental The response was generated by the skill. | Here are today's errors... |
server | string | experimental The name of the MCP server that was invoked. | dynatrace-mcp |
session_id | string | experimental UUID of the MCP protocol session; created at client connection and spans all messages exchanged during that connection. | cf45e99d-43c2-466f-a455-ab37cf942a54 |
skill | string | experimental The name of the skill that was executed. | nl2dql; chat; dql2nl; document-search |
status | string | experimental The outcome of the query. | SUCCEEDED; FAILED; BLOCKED |
supplementary | string | experimental Additional context information was provided for the skill (chat only). | Error details: ... |
timestamp | timestamp | stable Display name: TimestampThe 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 |
tool | string | experimental The name of the MCP server tool or AI function tool that was invoked. | nl2dql; dynatrace-conversation; dql2nl; execute-dql |
topic | string | experimental General topic addressed by the user input (for chat events only). | Root cause analysis of Davis problem |
user.email | string | stable Display name: User emailEmail of the user. | john.doe@dynatrace.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | b5998ff1-26fd-4aec-80c4-6c59633b5d66 |
user_input | string | experimental The user input was provided for the skill. | Show me errors for today |
workflow.execution.id | string | stable The unique identifier of a workflow execution as UUID. | d3ddbb4f-f6cb-4286-be5a-e3a8bca53825 |
workflow.id | string | stable The unique identifier of a workflow as UUID. | 26c0334e-a3e1-4585-8cd8-2d72742fe141 |
event.type MUST be one of the following:
| Value | Description |
|---|---|
GenAi Skill Invocation | GenAI skill was invoked. |
GenAi Skill Feedback | Feedback for a GenAI skill was provided. |
skill MAY be one of the following:
| Value | Description |
|---|---|
chat | Events associated with the conversations skill also used in the Davis CoPilot Chat App. |
nl2dql | Events associated with the skill translating natural language into DQL queries. |
dql2nl | Events associated with the skill explaining DQL queries in natural text. |
status MUST be one of the following:
| Value | Description |
|---|---|
SUCCEEDED | Skill invocation succeeded. |
FAILED | Skill invocation failed. |
BLOCKED | Skill invocation was blocked by guardrail or content filter. |
failure_reason MAY be one of the following:
| Value | Description |
|---|---|
BAD_REQUEST_ERROR | There was a technical problem. |
CONTENT_FILTER | Content filter check failed. |
GUARDRAIL_CHECK_FAILED | Guardrail check failed. |
INVALID_DQL_GENERATED | Generated DQL was invalid. |
feedback.type MUST be one of the following:
| Value | Description |
|---|---|
positive | Positive feedback. |
negative | Negative feedback. |
feedback.category MAY be one of the following:
| Value | Description |
|---|---|
error | The execution of the skill did not work. |
incomplete | The response was incomplete. |
incorrect | The response was incorrect. |
misunderstood | The response misunderstood the question. |
other | No provided feedback category fits. |
Model describing a billing usage event for HTTP Monitor. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_http_request_count | long | experimental The number of HTTP requests performed. This is the billable unit related to the rate card of this capability. | 10 |
dt.entity.http_check | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.http_monitor instead.Display name: HTTP checkAn entity ID of an entity of type HTTP_CHECK. Tags: entity-id | HTTP_CHECK-A140F3B85BCCBD1A |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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_monitor | smartscapeId | resource stable Display name: HTTP monitor IDSmartscape ID referencing an HTTP monitor entity. Tags: smartscape-id | HTTP_MONITOR-A140F3B85BCCBD1A |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | HTTP Monitor |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
HTTP Monitor | HTTP Monitor |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for the Infrastructure Monitoring DPS capability.
Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_host_hours | double | stable How many host hours of the capability have been consumed by the host. | 2.0 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Infrastructure Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Infrastructure Monitoring | Infrastructure Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Kubernetes Platform Monitoring. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_pod_hours | double | stable The number of pod-hours billed per namespace in a Kubernetes cluster | 8.25 |
dt.entity.cloud_application_namespace | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_namespace instead.Display name: Cloud application namespaceAn 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_cluster | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead.Display name: Kubernetes clusterAn entity ID of an entity of type KUBERNETES_CLUSTER. Tags: entity-id | KUBERNETES_CLUSTER-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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_cluster | smartscapeId | resource stable Display name: Kubernetes cluster IDA Smartscape ID that can be used to query Kubernetes cluster entities from the Smartscape storage. Tags: smartscape-id | K8S_CLUSTER-0123456789ABCDEF |
dt.smartscape.k8s_namespace | smartscapeId | resource stable Display name: Kubernetes namespace IDSmartscape ID referencing a Kubernetes namespace. Tags: smartscape-id | K8S_NAMESPACE-AABBCCDDEEFF0011 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Kubernetes Platform Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Kubernetes Platform Monitoring | Kubernetes Platform Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for ingest and process of logs. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.job.id | string | experimental Display name: Job IDUnique identifier of the external log data import job that produced this billing usage event. 1 | 752942ae-f994-4589-b949-b5ad15290a43 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Log Management & Analytics - Ingest & Process |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.bucket | string | stable A Dynatrace Grail usage event bucket name. | default_logs |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
Only present if logs were imported using an import job.
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Log Management & Analytics - Ingest & Process | Log Management & Analytics - Ingest & Process |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of a logs query execution. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Log Management & Analytics - Query"
| Attribute | Type | Description | Examples |
|---|---|---|---|
action_type | string | stable Indicates if the query was executed to fetch records or to delete them. | QUERY; DELETION |
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.client_context | string | stable 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_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
client.workflow_context | string | stable Contains information about the invoked workflow. For example, the workflow.id. | 8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Log Management & Analytics - Query |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
query_id | string | stable The UUID identifying a particular query. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_start | long | stable Query start time. | 1683012271413 |
timestamp | timestamp | stable Display name: TimestampThe 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | LIMA Usage Tracker Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Log Management & Analytics - Query | Logs Query Execution |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.
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"
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | record[] | resource stable Display name: Cost centerCan 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.product | record[] | resource stable Display name: Cost productCan 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Log Management & Analytics - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage log bucket name. | default_logs |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Log Management & Analytics - Retain | Logs Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.
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"
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.cost.costcenter | record[] | resource stable Display name: Cost centerCan 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.product | record[] | resource stable Display name: Cost productCan 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074qi_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Log Management & Analytics - Retain with Included Queries |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage log bucket name. | default_logs |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Log Management and Analytics - Retain with Included Queries | Retain with Included Queries |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Mainframe Monitoring. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_msu_hours | double | stable The number of msu-hours billed for the mainframe host. | 8.25 |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Mainframe Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Mainframe Monitoring | Mainframe Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event of ingest & process for metrics. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Metrics - Ingest & Process"
| Attribute | Type | Description | Examples |
|---|---|---|---|
data_points | long | stable The number of billable metrics data points. | 1500 |
dt.cost.costcenter | record[] | resource stable Display name: Cost centerCan 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.product | record[] | resource stable Display name: Cost productCan 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Metrics - Ingest & Process |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
metric.type | string | stable Display name: Metric typeIdentifies the type of metric and therefore the timeseries rollup functions it supports. | summary_stats |
monitoring_source | string | stable Monitoring source that originally reported the data. See 'dt.system.monitoring_source'. | fullstack_host |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage metrics bucket name. | default_metrics |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Metrics - Ingest & Process | Metrics - Ingest & Process |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing the billing usage event for retention of metrics per Grail bucket. Billing usage events are stored in the dt.system.events table.
Fetch Metrics Retain billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Metrics - Retain"
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Metrics - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage metric bucket name. | default_metrics |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Metrics - Retain | Metrics Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Dynatrace stores a query execution event for each query that got executed in the dt.system.events table.
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"
| Attribute | Type | Description | Examples |
|---|---|---|---|
analysis_timeframe.end | timestamp | experimental End time of query analysis timeframe. | 2023-05-22T13:15:57.416654000 |
analysis_timeframe.start | timestamp | experimental Start time of query analysis timeframe. | 2023-05-22T11:15:57.416654000 |
bucket | string | experimental A Dynatrace Grail bucket name. | default_logs; default_events |
client.api_version | string | stable The REST API version used by the client to perform the request. | 1 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.function_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
datastore | string | experimental Name of the external datastore that was scanned. | s3-datastore |
delivered_records | long | experimental 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_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | |
environment | string | experimental A Dynatrace environment/tenant ID. | umsaywsjuo |
event.kind | string | stable Display name: Event kindGives 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.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | DATASTORE; TABLE; FILES |
execution_duration_ms | long | deprecated The duration of the query in milliseconds. | 123 |
failed_count | long | experimental 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_reason | string | experimental Additional information if query execution has 'FAILED'. | QUEUE_TIMEOUT; THROTTLED |
flags | string[] | experimental Advisory flags attached to the query result by the query execution engine. | ['CLASSIC_ENTITY_MIGRATION_ADVISED'] |
listed_objects | long | experimental Number of objects returned by the external datastore's list API. | 98 |
matched_records_ratio | double | experimental 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_end | long | stable Query end time. For aggregated events the query end time may be zero and not reflect the exact end time. | 1683012271413 |
query_id | string | stable The UUID identifying a particular query. For aggregated events this field is null. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_pool | string | experimental The resource pool of the query. | DASHBOARDS |
query_queue_time_ms | long | deprecated The time query spent in queued state (in milliseconds). | 456 |
query_start | long | stable 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_string | string | experimental The query string. For aggregated events this field is null. | fetch bizevents, from:-30m | limit 1 |
sampling_ratio | long | experimental The sampling ratio of the executed query. | 1 |
scanned_bytes | long | experimental The number of scanned bytes. | 1113359256 |
scanned_data_points | long | experimental Number of scanned data points for metric queries. | 20 |
scanned_objects | long | experimental Number of objects actually retrieved/scanned in the external datastore. | 50 |
scanned_records | long | experimental The number of scanned records. | 9209037 |
status | string | experimental The outcome of the query. | SUCCEEDED |
table | string | experimental A Dynatrace Grail table name. | logs; metrics |
timestamp | timestamp | stable Display name: TimestampThe 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 | string | experimental The user ID that triggered the query. For aggregated events this field is null. | b5998ff1-26fd-4aec-80c4-6c59633b5d66 |
user.email | string | stable Display name: User emailThe user email that triggered the query. For aggregated events this field is null. | john.doe@dynatrace.com |
user.id | string | stable Display name: User IDThe user UUID that triggered the query. For aggregated events this field is null. | b5998ff1-26fd-4aec-80c4-6c59633b5d66 |
version | string | resource deprecatedUsed in Extension Framework 2.0 Display name: SNMP versionThe record version | 1 |
failure_reason MUST be one of the following:
| Value | Description |
|---|---|
QUEUE_TIMEOUT | Query timed out before execution due to resource or tenant quota limit. |
THROTTLED | Query 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_QUERY | Query cannot be parsed due to a syntax error. |
PARSING_LIMIT | Query cannot be parsed because it exceeds the complexity limit of the parser. |
PARSING_FAILED | Query cannot be parsed due to an internal error. |
EXECUTION_FAILED | Execution of the submitted query failed because of internal an error. |
INSUFFICIENT_PERMISSIONS | Query cannot be executed because the requester doesn't have permissions to a queried table. |
EXECUTION_TIMEOUT | Query execution was canceled because it exceeded the allowed running time. |
MEMORY_LIMIT | Query execution was canceled because the memory usage limit was exceeded. |
DISK_LIMIT | Query execution was canceled because the disk space limit was exceeded. |
FUNCTION_LIMIT | Query execution was canceled because the user-defined functions limit was exceeded. |
RECORD_SIZE_LIMIT | Query execution was canceled because the record size limit was exceeded. |
TABLE_SIZE_LIMIT | Query execution was canceled because the table size limit was exceeded. |
FAILIF_CONDITION | Query execution was canceled because the condition of a failIf command was met. |
Model describing a billing usage event for Real User Monitoring Property. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_property_sessions | long | experimental User action and session properties counted by application. | 8 |
device.type | string | resource stable The type of the device. | mobile |
dt.entity.application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: ApplicationThe ME ID of a web application. Tags: entity-id | APPLICATION-DC92E74A7A844E6E |
dt.entity.device_application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: Device applicationThe ME ID of a device application. | DEVICE_APPLICATION-EA8A8751A60D5BCE8 |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Real User Monitoring Property |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Real User Monitoring Property | Real User Monitoring Property |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Real User Monitoring. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_sessions | long | experimental Session count without Session Replay counted by application. | 8 |
device.type | string | resource stable The type of the device. | mobile |
dt.entity.application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: ApplicationThe ME ID of a web application. Tags: entity-id | APPLICATION-DC92E74A7A844E6E |
dt.entity.device_application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: Device applicationThe ME ID of a device application. | DEVICE_APPLICATION-EA8A8751A60D5BCE8 |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Real User Monitoring |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Real User Monitoring | Real User Monitoring |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Real User Monitoring with Session Replay. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_replay_sessions | long | experimental Session count with Session Replay counted by application. | 8 |
device.type | string | resource stable The type of the device. | mobile |
dt.entity.application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: ApplicationThe ME ID of a web application. Tags: entity-id | APPLICATION-DC92E74A7A844E6E |
dt.entity.device_application | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.frontend instead.Display name: Device applicationThe ME ID of a device application. | DEVICE_APPLICATION-EA8A8751A60D5BCE8 |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Real User Monitoring with Session Replay |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Real User Monitoring with Session Replay | Real User Monitoring with Session Replay |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for the Runtime Application Protection DPS capability.
Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_gibibyte_hours | double | stable How many gibibyte hours of the capability has been consumed by the host | 16.02 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Runtime Application Protection |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Runtime Application Protection | Runtime Application Protection |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for the Runtime Vulnerability Analytics DPS capability.
Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_gibibyte_hours | double | stable How many gibibyte hours of the capability has been consumed by the host | 16.02 |
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.entity.host | string | resource deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.host instead.Display name: HostAn entity ID of an entity of type HOST. Tags: entity-id | HOST-E0D8F94D9065F24F |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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.host | smartscapeId | resource stable Display name: Host IDSmartscape ID referencing a host entity. Tags: smartscape-id | HOST-A1B2C3D4E5F67890 |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Runtime Vulnerability Analytics |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Runtime Vulnerability Protection | Runtime Vulnerability Protection |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Security Posture Management. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe 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_cluster | smartscapeId | resource stable Display name: Kubernetes cluster IDA Smartscape ID that can be used to query Kubernetes cluster entities from the Smartscape storage. Tags: smartscape-id | K8S_CLUSTER-0123456789ABCDEF |
dt.smartscape_source.id | smartscapeId | resource stable Display name: Smartscape source IDThe 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.type | string | stable Display name: Smartscape source typeThe entity type of the entity whose identifier is held in dt.smartscape_source.id. | K8S_CLUSTER; AWS_LAMBDA_FUNCTION |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Security Posture Management |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 2.0.0 |
k8s.cluster.name | string | resource stable Display name: Kubernetes cluster nameThe user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: permission primary-field | unguard-dev; acme-prod10 |
timestamp | timestamp | stable Display name: TimestampThe 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 |
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.
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Security Posture Management | Security Posture Management |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for Third-Party Synthetic API Ingestion. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_test_result_ingestion_count | long | experimental 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_test | string | resource deprecatedThis field is deprecated and will be removed in the future. Display name: External synthetic testAn entity ID of an entity of type EXTERNAL_SYNTHETIC_TEST. Tags: entity-id | EXTERNAL_SYNTHETIC_TEST-A140F3B85BCCBD1A |
dt.openpipeline.pipelines | string[] | resource experimental Display name: OpenPipeline pipelinesCollects 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.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Third-Party Synthetic API Ingestion |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Third-Party Synthetic API Ingestion | Third-Party Synthetic API Ingestion |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing a billing usage event for ingest and process of traces. Billing usage events are stored in the dt.system.events table.
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
| Attribute | Type | Description | Examples |
|---|---|---|---|
dt.cost.costcenter | string | resource stable Display name: Cost centerCan be used to assign usage to a Cost Center. | Team A |
dt.cost.product | string | resource stable Display name: Cost productCan be used to assign usage to a Product or Application ID. | Product A |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_CLIENT |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Traces - Ingest & Process |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
ingested_bytes | long | experimental The size in bytes of ingested spans. | 1113359256 |
ingested_spans | long | experimental The number of ingested spans. | 1113359256 |
licensing_type | string | experimental The origin/type of the ingested spans. | fullstack-adaptive |
timestamp | timestamp | stable Display name: TimestampStart time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
usage.bucket | string | stable A Dynatrace Grail usage event bucket name. | default_metrics |
usage.end | timestamp | stable End time of the usage timeframe (exclusive). | 2023-05-22T11:30:00.000000Z |
usage.start | timestamp | stable Start time of the usage timeframe (inclusive). | 2023-05-22T11:15:00.000000Z |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_CLIENT | LIMA Client Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Traces - Ingest & Process | Traces - Ingest & Process |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
licensing_type MUST be one of the following:
| Value | Description |
|---|---|
fullstack-adaptive | The ingested_bytes origins from an ATM aware fullstack source. |
fullstack-fixed-rate | The ingested_bytes origins from an ATM unaware fullstack source. |
otlp-trace-ingest | The ingested_bytes origins from the "OTLP Trace Ingest API". |
serverless | The ingested_bytes origins from a serverless source. |
Model describing a billing usage event of a traces query execution. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Traces - Query"
| Attribute | Type | Description | Examples |
|---|---|---|---|
action_type | string | stable Indicates if the query was executed to fetch records or to delete them. | QUERY; DELETION |
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
client.application_context | string | stable A Dynatrace app ID. | local-dev-mode; dynatrace.notebooks; my.biz.carbon |
client.client_context | string | stable 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_context | string | stable Name of the function that executed the query. | api/execute-dql-query; my/function |
client.internal_service_context | string | experimental A string that identifies the Dynatrace service that triggered the query. | dt.davis.datadriver |
client.source | string | stable Dynatrace application that executed the query. | https://tenant.apps.dynatracelabs.com/ui/notebook/a0321331-795c-43e7-87cd-890e4bfa8a09 |
client.workflow_context | string | stable Contains information about the invoked workflow. For example, the workflow.id. | 8a9c9ceb-7eb3-4e88-8c4b-681f8d52eb32 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_TRACKER |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Traces - Query |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
query_id | string | stable The UUID identifying a particular query. | e68e5cc8-c31e-4e57-90d7-c6dde20b19d5 |
query_start | long | stable Query start time. | 1683012271413 |
timestamp | timestamp | stable Display name: TimestampThe 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.email | string | stable Display name: User emailEmail of the user. | user@mail.com |
user.id | string | stable Display name: User IDUnique UUID of a human user. If the system itself has to be represented, the constant 'system' is used. | 35ba9499-f87c-4047-962c-14dc32e255e5; system |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_TRACKER | LIMA Usage Tracker Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Traces - Query | Traces Query Execution |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
Model describing the billing usage event for retention of events per Grail bucket. Billing usage events are stored in the dt.system.events table.
Analyze billing usage events.
fetch dt.system.events| filter event.kind == "BILLING_USAGE_EVENT" and event.type == "Traces - Retain"
| Attribute | Type | Description | Examples |
|---|---|---|---|
billed_bytes | long | stable The number of bytes that will be billed. | 1113359256 |
dt.openpipeline.source | string | resource experimental Display name: OpenPipeline ingest sourceIdentifies the source (such as API endpoints or OneAgent) used for ingesting the record into OpenPipeline. | /platform/ingest/v1/events; oneagent |
dt.security_context | string | resource stable Display name: DT security contextThe security context is used in access permissions to limit the visibility. Learn more about the Dynatrace permission model Tags: permission | BILLING_USAGE_EVENT |
event.id | string | stable Display name: Event IDUnique identifier string of an event; is stable across multiple refreshes and updates. | 5547782627070661074_1647601320000 |
event.kind | string | stable Display name: Event kindGives 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.provider | string | stable Display name: Event providerSource of the event, for example, the name of the component or system that generated the event. Tags: permission | LIMA_USAGE_STREAM |
event.type | string | stable Display name: Event typeThe unique type identifier of a given event. Tags: permission | Traces - Retain |
event.version | string | stable Display name: Event versionDescribes the version of the event. | 1.0.0 |
timestamp | timestamp | stable Display name: TimestampThe 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.bucket | string | stable A Dynatrace Grail usage span bucket name. | default_spans |
event.kind MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |
event.provider MUST be one of the following:
| Value | Description |
|---|---|
LIMA_USAGE_STREAM | LIMA Usage Stream Service |
event.type MUST be one of the following:
| Value | Description |
|---|---|
Traces - Retain | Traces Retain |
dt.security_context MUST be one of the following:
| Value | Description |
|---|---|
BILLING_USAGE_EVENT | Billing usage event |